@glassly/engine 0.3.3-beta.633 → 0.3.3-beta.654

package/src/services/gestureDotGlyphs.ts

@@ -4,7 +4,7 @@
  */
 export const GESTURE_DOT_GLYPH_SIZE = 24
 
-export type GestureDotGlyph = "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "blank"
+export type GestureDotGlyph = "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "holdRing" | "blank"
 
 export const GESTURE_DOT_GLYPHS: Record<GestureDotGlyph, string> = {
   dot: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAALklEQVR4nM2QsQ0AAAjC/P/pmrhqZ+xIF6DqBQyWbwO3gduAmKjQuj7QL/ETEzQmMptl7Q9NBAAAAABJRU5ErkJggg==",
@@ -16,5 +16,6 @@ export const GESTURE_DOT_GLYPHS: Record<GestureDotGlyph, string> = {
   left: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAI0lEQVR4nGNgoCv4j0sch8RAiTP8RwPESOAwajDI4JKgGQAAKO05x7DqJxIAAAAASUVORK5CYII=",
   right: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIElEQVR4nGNgoDf4j1NiMMn8RwOEJYizZKDEcQc7bQAAS7w5x+ro2lsAAAAASUVORK5CYII=",
   hold: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAR0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKl0Z0Lof7DKbgMhBpQCZzOxedBHEGCMxAJBTXhKGRAA9hFMQEANr7jHQU9fO0AAAAASUVORK5CYII=",
+  holdRing: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAQ0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKlMd2IVQNMaEAlcDoXnwdxBAnOQCQU1ISjEIvjsYhiAgAo9KdZzePY3AAAAABJRU5ErkJggg==",
   blank: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAD0lEQVR4nGNgGAWjgPoAAAJYAAGgxYwDAAAAAElFTkSuQmCC",
 }

package/src/stores/glasses.ts

@@ -146,6 +146,7 @@ const initialState: GlassesStore = {
   sceneVector: false,
   sceneSettle: false,
   volumeGate: false,
+  firmwareUpdateAvailable: false,
   // wifi info
   wifi: {state: "disconnected"},
   wifiStatusKnown: false,

package/src/stores/settings.ts

@@ -612,11 +612,11 @@ export const SETTINGS: Record<string, Setting> = {
     persist: true,
   },
   // G2 Glassly CFW microphone volume gate (revision 40+): the temples stop
-  // streaming audio while nothing reaches the threshold. Off until the user
-  // turns it on; shown only when the connected firmware reports the capability.
+  // streaming audio while nothing reaches the threshold. Default on; shown only
+  // when the connected firmware reports the capability.
   volume_gate_enabled: {
     key: "volume_gate_enabled",
-    defaultValue: () => false,
+    defaultValue: () => true,
     writable: true,
     saveOnServer: true,
     persist: true,
@@ -632,7 +632,7 @@ export const SETTINGS: Record<string, Setting> = {
   // Quiet time before the gate closes.
   volume_gate_hold_ms: {
     key: "volume_gate_hold_ms",
-    defaultValue: () => 3000,
+    defaultValue: () => 5000,
     writable: true,
     saveOnServer: true,
     persist: true,
@@ -640,7 +640,7 @@ export const SETTINGS: Record<string, Setting> = {
   // Minimum time the gate stays open once sound opens it.
   volume_gate_min_open_ms: {
     key: "volume_gate_min_open_ms",
-    defaultValue: () => 2000,
+    defaultValue: () => 10000,
     writable: true,
     saveOnServer: true,
     persist: true,

package/src/types/capabilities/even-realities-g2.ts

@@ -42,7 +42,7 @@ export const evenRealitiesG2: Capabilities = {
     // envelope). Pathological sizes needing more than the 4-container pool are
     // dropped SGC-side with a log.
     shapes: ["rect"], // bordered empty container ≈ rect
-    intensityLevels: 2,
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/types/capabilities/mentra-display.ts

@@ -39,7 +39,7 @@ export const mentraDisplay: Capabilities = {
     maxImageElements: 4, // firmware BITMAP pool ids 10-13
     maxImagePx: {width: 200, height: 200}, // CANVAS_IMAGE_MAX_I1_BYTES / NAV_IMAGE_MAX_W/H
     shapes: ["rect"], // bordered empty TEXTBOX ≈ rect (no shape primitive)
-    intensityLevels: 2, // 1-bpp panel today
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/types/capabilities/rayneo-io.ts

@@ -39,7 +39,7 @@ export const rayneoIO: Capabilities = {
     canPosition: true,
     maxTextElements: 6,
     maxImageElements: 4,
-    intensityLevels: 2,
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/utils/timers/index.ts

@@ -1,2 +1 @@
-import {BgTimer, throttle, debounce} from "./timers"
-export {BgTimer, throttle, debounce}
+export {BgTimer} from "./timers"

package/src/utils/timers/timers.ts

@@ -1,203 +1,128 @@
-// BgTimer — background-safe timers for the engine.
+// BgTimer: every engine timer (miniapp liveness watchdog, display expiries,
+// boot windows, token refresh) goes through here. Android pauses plain JS
+// timers while the app is backgrounded, so on a device these run on the
+// native react-native-nitro-bg-timer instead. iOS needs that package at
+// >= 0.2.0: earlier versions cleared each timer right after scheduling it
+// (https://github.com/tconns/react-native-nitro-bg-timer/issues/2).
 //
-// Everything timing-critical in the engine runs through this class: the
-// miniapp liveness watchdog, display durationMs expiries, boot windows,
-// auth-token refresh. On Android, React Native PAUSES plain JS timers while
-// the app is backgrounded, so those features only keep working in the
-// background when the native implementation (react-native-nitro-bg-timer)
-// is active.
+// Dev and release behave the same; there is no env switch. A missing native
+// module falls back to JS timers so the foreground keeps working, and says so
+// once, loudly: a quiet fallback already cost a day of phantom "zombie
+// miniapp" bugs (OS-1790). Never downgrade that report to a warning.
 //
-// Who actually gets native timers:
-//   - Android, dev AND release: always attempted — dev must match production
-//     background behavior. There is no opt-in/opt-out env var. If the native
-//     module is unavailable (a dev client whose binary predates it, or a
-//     broken release binary), the failure is LOUD: a console.error with the
-//     remediation, plus a blocking dev alert. The JS-timer fallback still
-//     engages so foreground behavior keeps working, but backgrounded
-//     behavior is broken until the native rebuild — the error says exactly
-//     that. (A silent dev fallback previously cost a full debugging day of
-//     phantom "zombie miniapp" bugs; see OS-1790.)
-//   - iOS: never, dev or prod — the package is disabled pending
-//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
-//     suspends the whole process in background anyway, so background timing
-//     there is handled by native per-device queues, not JS timers.
-//
-// react-native is loaded lazily, not imported. Every engine service runs its
-// timers through this module, and the engine's bun test suites load those
-// services in a plain JS runtime that cannot parse react-native's Flow
-// source. A static import would force every such suite to mock this module;
-// with the lazy load, a runtime without react-native simply gets the JS
-// timers, which is the correct answer there anyway.
+// react-native and the nitro packages are require()d lazily. The engine's bun
+// suites run services in a plain JS runtime that cannot parse react-native;
+// there the native lookup finds no platform and JS timers are the right answer.
+
+type TimerApi = {
+  setTimeout(callback: () => void, delay: number): number
+  clearTimeout(id: number): void
+  setInterval(callback: () => void, delay: number): number
+  clearInterval(id: number): void
+}
 
 type ReactNativeSubset = {
   Platform: {OS: string}
-  Alert?: {alert: (title: string, message?: string) => void}
+  Alert?: {alert(title: string, message?: string): void}
 }
 
-let reactNative: ReactNativeSubset | null | undefined
+const TIMER_METHODS = ["setTimeout", "clearTimeout", "setInterval", "clearInterval"] as const
 
-function getReactNative(): ReactNativeSubset | null {
-  if (reactNative !== undefined) {
-    return reactNative
-  }
-  try {
-    reactNative = require("react-native") as ReactNativeSubset
-  } catch {
-    reactNative = null
-  }
-  return reactNative
+const jsTimers: TimerApi = {
+  setTimeout: (callback, delay) => setTimeout(callback, delay) as unknown as number,
+  clearTimeout: (id) => clearTimeout(id),
+  setInterval: (callback, delay) => setInterval(callback, delay) as unknown as number,
+  clearInterval: (id) => clearInterval(id),
 }
 
-function isDev(): boolean {
-  return typeof __DEV__ !== "undefined" && __DEV__
-}
+let reactNative: ReactNativeSubset | null | undefined
+// undefined = not looked up yet, null = unavailable (JS timers from here on).
+let nativeTimers: TimerApi | null | undefined
+let reported = false
 
-type NitroTimerApi = {
-  setInterval: (callback: () => void, delay: number) => number
-  clearInterval: (intervalId: number) => void
-  setTimeout: (callback: () => void, delay: number) => number
-  clearTimeout: (timeoutId: number) => void
+function loadReactNative(): ReactNativeSubset | null {
+  if (reactNative === undefined) {
+    try {
+      reactNative = require("react-native") as ReactNativeSubset
+    } catch {
+      reactNative = null
+    }
+  }
+  return reactNative
 }
 
-let nitroTimer: NitroTimerApi | null | undefined
-let nitroDisabled = false
-let failedLoud = false
-
-/**
- * The native background timer is unavailable — say so ONCE, loudly, with the
- * remediation. The JS-timer fallback keeps foreground behavior working, but
- * everything timing-driven freezes while the app is backgrounded, which
- * presents as phantom miniapp bugs (frozen captions, missed wake words,
- * watchdog kills on resume). A quiet warning here has already cost a full
- * debugging day; never downgrade this to console.warn.
- */
-function failUnavailable(reason: string) {
-  if (failedLoud) {
-    return
-  }
-  failedLoud = true
+function reportUnavailable(reason: string): void {
+  if (reported) return
+  reported = true
+  const rn = loadReactNative()
+  const platform = rn?.Platform.OS === "ios" ? "ios" : "android"
   const message =
     `BgTimer: native background timer unavailable (${reason}). ` +
-    "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+    `Backgrounded behavior IS BROKEN until you rebuild the app: run \`bun ${platform}\`. ` +
     "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded."
   console.error(message)
-  if (isDev()) {
-    // A stale dev client may ALSO show the library's own require-time red box
-    // (bridgeless LogBox surfaces it even though we catch below) — this alert
-    // is the actionable one: it names the fix.
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    // A stale dev client may also red-box inside the library itself; this
+    // alert is the one that names the fix.
     try {
-      getReactNative()?.Alert?.alert("Background timers unavailable", message)
+      rn?.Alert?.alert("Background timers unavailable", message)
     } catch {
-      /* Alert not available (tests / headless) — the console.error stands. */
+      // Headless runtime: the console.error stands.
     }
   }
 }
 
-function getNitroTimer(): NitroTimerApi | null {
-  if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
+function loadNativeTimers(): TimerApi | null {
+  if (nativeTimers !== undefined) return nativeTimers
+  const platform = loadReactNative()?.Platform.OS
+  if (platform !== "android" && platform !== "ios") {
+    nativeTimers = null
     return null
   }
-
-  if (nitroTimer !== undefined) {
-    return nitroTimer
-  }
-
   try {
     const {isRuntimeAlive} = require("react-native-nitro-modules") as {isRuntimeAlive?: () => boolean}
-    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
-      nitroTimer = null
-      failUnavailable("nitro runtime is not alive")
-      return nitroTimer
+    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) throw new Error("nitro runtime is not alive")
+    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: Partial<TimerApi>}
+    for (const method of TIMER_METHODS) {
+      if (typeof BackgroundTimer?.[method] !== "function") throw new Error(`BackgroundTimer.${method} missing`)
     }
-
-    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: NitroTimerApi}
-    nitroTimer =
-      BackgroundTimer &&
-      typeof BackgroundTimer.setTimeout === "function" &&
-      typeof BackgroundTimer.setInterval === "function" &&
-      typeof BackgroundTimer.clearTimeout === "function" &&
-      typeof BackgroundTimer.clearInterval === "function"
-        ? BackgroundTimer
-        : null
-  } catch {
-    nitroTimer = null
-    nitroDisabled = true
-  }
-
-  if (!nitroTimer) {
-    failUnavailable("react-native-nitro-bg-timer failed to load")
+    nativeTimers = BackgroundTimer as TimerApi
+  } catch (error) {
+    nativeTimers = null
+    reportUnavailable(error instanceof Error ? error.message : String(error))
   }
-  return nitroTimer
+  return nativeTimers
 }
 
-function withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {
-  const api = getNitroTimer()
-  if (!api) {
-    return fallback()
-  }
+// A native call that throws mid-session is new information: drop to JS timers
+// and announce again.
+function call<T>(run: (timers: TimerApi) => T): T {
+  const native = loadNativeTimers()
+  if (!native) return run(jsTimers)
   try {
-    return run(api)
+    return run(native)
   } catch (error) {
-    nitroDisabled = true
-    nitroTimer = null
-    failedLoud = false // a mid-session failure is new information — re-announce
-    failUnavailable(`nitro timer call threw: ${String(error)}`)
-    return fallback()
+    nativeTimers = null
+    reported = false
+    reportUnavailable(`native timer call threw: ${String(error)}`)
+    return run(jsTimers)
   }
 }
 
 export class BgTimer {
-  static setInterval(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setInterval(callback, delay),
-      () => setInterval(callback, delay) as unknown as number,
-    )
-  }
-
-  static clearInterval(intervalId: number): void {
-    withNitro(
-      (api) => api.clearInterval(intervalId),
-      () => clearInterval(intervalId),
-    )
-  }
-
   static setTimeout(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setTimeout(callback, delay),
-      () => setTimeout(callback, delay) as unknown as number,
-    )
+    return call((timers) => timers.setTimeout(callback, delay))
   }
 
-  static clearTimeout(timeoutId: number): void {
-    withNitro(
-      (api) => api.clearTimeout(timeoutId),
-      () => clearTimeout(timeoutId),
-    )
+  static clearTimeout(id: number): void {
+    call((timers) => timers.clearTimeout(id))
   }
-}
 
-export function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let lastCalled = 0
-
-  return (...args: Parameters<T>) => {
-    const now = Date.now()
-    if (now - lastCalled >= ms) {
-      lastCalled = now
-      fn(...args)
-    }
+  static setInterval(callback: () => void, delay: number): number {
+    return call((timers) => timers.setInterval(callback, delay))
   }
-}
 
-export function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let timeoutId: number | null = null
-
-  return (...args: Parameters<T>) => {
-    if (timeoutId) {
-      BgTimer.clearTimeout(timeoutId)
-    }
-    timeoutId = BgTimer.setTimeout(() => {
-      fn(...args)
-      timeoutId = null
-    }, ms)
+  static clearInterval(id: number): void {
+    call((timers) => timers.clearInterval(id))
   }
 }