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

package/build/utils/timers/index.js

@@ -1,3 +1,2 @@
-import { BgTimer, throttle, debounce } from "./timers";
-export { BgTimer, throttle, debounce };
+export { BgTimer } from "./timers";
 //# sourceMappingURL=index.js.map

package/build/utils/timers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AACpD,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,CAAA","sourcesContent":["import {BgTimer, throttle, debounce} from \"./timers\"\nexport {BgTimer, throttle, debounce}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,UAAU,CAAA","sourcesContent":["export {BgTimer} from \"./timers\"\n"]}

package/build/utils/timers/timers.d.ts

@@ -1,9 +1,7 @@
 export declare class BgTimer {
-    static setInterval(callback: () => void, delay: number): number;
-    static clearInterval(intervalId: number): void;
     static setTimeout(callback: () => void, delay: number): number;
-    static clearTimeout(timeoutId: number): void;
+    static clearTimeout(id: number): void;
+    static setInterval(callback: () => void, delay: number): number;
+    static clearInterval(id: number): void;
 }
-export declare function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
-export declare function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
 //# sourceMappingURL=timers.d.ts.map

package/build/utils/timers/timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAoJA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AA+GA,qBAAa,OAAO;IAClB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9D,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/D,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGvC"}

package/build/utils/timers/timers.js

@@ -1,164 +1,114 @@
-// 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.
+const TIMER_METHODS = ["setTimeout", "clearTimeout", "setInterval", "clearInterval"];
+const jsTimers = {
+    setTimeout: (callback, delay) => setTimeout(callback, delay),
+    clearTimeout: (id) => clearTimeout(id),
+    setInterval: (callback, delay) => setInterval(callback, delay),
+    clearInterval: (id) => clearInterval(id),
+};
 let reactNative;
-function getReactNative() {
-    if (reactNative !== undefined) {
-        return reactNative;
-    }
-    try {
-        reactNative = require("react-native");
-    }
-    catch {
-        reactNative = null;
+// undefined = not looked up yet, null = unavailable (JS timers from here on).
+let nativeTimers;
+let reported = false;
+function loadReactNative() {
+    if (reactNative === undefined) {
+        try {
+            reactNative = require("react-native");
+        }
+        catch {
+            reactNative = null;
+        }
     }
     return reactNative;
 }
-function isDev() {
-    return typeof __DEV__ !== "undefined" && __DEV__;
-}
-let nitroTimer;
-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) {
-    if (failedLoud) {
+function reportUnavailable(reason) {
+    if (reported)
         return;
-    }
-    failedLoud = true;
+    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() {
-    if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
+function loadNativeTimers() {
+    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");
-        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");
-        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;
+        for (const method of TIMER_METHODS) {
+            if (typeof BackgroundTimer?.[method] !== "function")
+                throw new Error(`BackgroundTimer.${method} missing`);
+        }
+        nativeTimers = BackgroundTimer;
     }
-    if (!nitroTimer) {
-        failUnavailable("react-native-nitro-bg-timer failed to load");
+    catch (error) {
+        nativeTimers = null;
+        reportUnavailable(error instanceof Error ? error.message : String(error));
     }
-    return nitroTimer;
+    return nativeTimers;
 }
-function withNitro(run, fallback) {
-    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(run) {
+    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, delay) {
-        return withNitro((api) => api.setInterval(callback, delay), () => setInterval(callback, delay));
+    static setTimeout(callback, delay) {
+        return call((timers) => timers.setTimeout(callback, delay));
     }
-    static clearInterval(intervalId) {
-        withNitro((api) => api.clearInterval(intervalId), () => clearInterval(intervalId));
+    static clearTimeout(id) {
+        call((timers) => timers.clearTimeout(id));
     }
-    static setTimeout(callback, delay) {
-        return withNitro((api) => api.setTimeout(callback, delay), () => setTimeout(callback, delay));
+    static setInterval(callback, delay) {
+        return call((timers) => timers.setInterval(callback, delay));
     }
-    static clearTimeout(timeoutId) {
-        withNitro((api) => api.clearTimeout(timeoutId), () => clearTimeout(timeoutId));
+    static clearInterval(id) {
+        call((timers) => timers.clearInterval(id));
     }
 }
-export function throttle(fn, ms) {
-    let lastCalled = 0;
-    return (...args) => {
-        const now = Date.now();
-        if (now - lastCalled >= ms) {
-            lastCalled = now;
-            fn(...args);
-        }
-    };
-}
-export function debounce(fn, ms) {
-    let timeoutId = null;
-    return (...args) => {
-        if (timeoutId) {
-            BgTimer.clearTimeout(timeoutId);
-        }
-        timeoutId = BgTimer.setTimeout(() => {
-            fn(...args);
-            timeoutId = null;
-        }, ms);
-    };
-}
 //# sourceMappingURL=timers.js.map

package/build/utils/timers/timers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.3.3-beta.633",
+  "version": "0.3.3-beta.654",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,24 +97,24 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.3.3-beta.633",
-    "@glassly/cloud-client": "0.3.3-beta.633",
-    "@glassly/cloud-protocol": "0.3.3-beta.633",
-    "@glassly/crust": "0.3.3-beta.633",
-    "@glassly/miniapp": "0.3.3-beta.633",
+    "@glassly/bluetooth-sdk": "0.3.3-beta.654",
+    "@glassly/cloud-client": "0.3.3-beta.654",
+    "@glassly/cloud-protocol": "0.3.3-beta.654",
+    "@glassly/crust": "0.3.3-beta.654",
+    "@glassly/miniapp": "0.3.3-beta.654",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.3.3-beta.633"
+    "@glassly/llm-providers": "0.3.3-beta.654"
   },
   "devDependencies": {
     "@glassly/llm-providers": "workspace:*",
     "@types/semver": "^7.7.1",
     "expo-module-scripts": "^56.0.3",
     "expo-modules-core": "^57.0.7",
-    "react-native-nitro-modules": "^0.31.10",
+    "react-native-nitro-modules": "^0.35.10",
     "typescript": "~5.9.2"
   },
   "peerDependencies": {

package/src/facades/glasses.ts

@@ -22,6 +22,7 @@ import type {
 import {useGlassesStore} from "../stores/glasses"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
+import micStateCoordinator from "../services/MicStateCoordinator"
 import {projectPairingIdentity} from "../services/PairingIdentity"
 import {isGlassesConnected, isGlassesReady} from "../services/GlassesReadiness"
 import {pushAllBluetoothSettings} from "../services/GlassesSettingsSync"
@@ -34,6 +35,21 @@ import {getModelCapabilities, type DeviceTypes} from "../types"
 import {glassesWifi} from "./glassesWifi"
 import {glassesSettings} from "./glassesSettings"
 
+/** Floor for the mic level readout; digital silence would otherwise be -Infinity. */
+const MIC_LEVEL_FLOOR_DBFS = -120
+
+/** RMS level of one s16le chunk in dBFS, on the volume gate's 32767 full scale. */
+function pcmLevelDbfs(pcm: ArrayBuffer): number {
+  const samples = new Int16Array(pcm, 0, pcm.byteLength >> 1)
+  if (samples.length === 0) return MIC_LEVEL_FLOOR_DBFS
+  let sumSquares = 0
+  for (let i = 0; i < samples.length; i++) sumSquares += samples[i] * samples[i]
+  const rms = Math.sqrt(sumSquares / samples.length)
+  return Math.max(MIC_LEVEL_FLOOR_DBFS, 20 * Math.log10(rms / 32767))
+}
+
+let micLevelSubscriptions = 0
+
 function projectStatus() {
   const s = useGlassesStore.getState()
   return {
@@ -96,6 +112,7 @@ function projectInfo() {
     sceneCanvasWidth: s.sceneCanvasWidth,
     sceneCanvasHeight: s.sceneCanvasHeight,
     volumeGate: s.volumeGate === true,
+    firmwareUpdateAvailable: s.firmwareUpdateAvailable === true,
     // Copy: the snapshot must not hand callers a mutable reference into the store.
     wifi: {...s.wifi},
   }
@@ -295,7 +312,7 @@ export const glasses = {
     setHand: (hand: "left" | "right"): Promise<void> => BluetoothSdk.neuralBandSetHand(hand),
   },
 
-  // --- audio (glasses media-volume + own-app playback hint) ---
+  // --- audio (glasses media-volume, own-app playback hint, live mic level) ---
   audio: {
     /** Read the glasses' current media volume. */
     getMediaVolume: () => BluetoothSdk.getGlassesMediaVolume(),
@@ -303,6 +320,22 @@ export const glasses = {
     setMediaVolume: (level: number) => BluetoothSdk.setGlassesMediaVolume(level),
     /** Tell native whether THIS app is currently playing audio (for ducking). */
     setOwnAppPlaying: (playing: boolean): Promise<void> => BluetoothSdk.setOwnAppAudioPlaying(playing),
+    /**
+     * Stream the active mic's level in dBFS, one reading per PCM chunk. Holds
+     * raw PCM open while subscribed, so the mic runs with no miniapp listening
+     * (and the G2 volume gate stays open).
+     */
+    onMicLevel: (cb: (dbfs: number) => void): (() => void) => {
+      const owner = `mic_level_${++micLevelSubscriptions}`
+      micStateCoordinator.acquireHostPcm(owner)
+      const sub = BluetoothSdk.addListener("mic_pcm", (event: {pcm: ArrayBuffer}) => {
+        if (event?.pcm) cb(pcmLevelDbfs(event.pcm))
+      })
+      return () => {
+        sub.remove()
+        micStateCoordinator.releaseHostPcm(owner)
+      }
+    },
   },
 
   // --- sub-facades ---

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.3.3",
-  "releaseIdentity": "0.3.3-beta.633",
-  "releaseSetId": "glassly-0.3.3-beta.633",
-  "sourceCommit": "34d49f6f3585d9f0e8e2d28802ae2b70666507a1",
+  "releaseIdentity": "0.3.3-beta.654",
+  "releaseSetId": "glassly-0.3.3-beta.654",
+  "sourceCommit": "9c554ec6e0d33cd235914ccee98e7d39e4fa29e2",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -201,7 +201,7 @@ export {
   type DevManifest,
 } from "./utils/devMiniappLaunch"
 export {HardwareCompatibility, type CompatibilityResult} from "./utils/hardware"
-export {BgTimer, throttle, debounce} from "./utils/timers"
+export {BgTimer} from "./utils/timers"
 // Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).
 export {
   MetaAuthError,

package/src/services/AiTierResolution.ts

@@ -42,7 +42,7 @@ export const TIER_MODEL_OPTIONS: Record<AiTier, TierModelOption[]> = {
   ],
   frontier: [
     {provider: "anthropic", model: "claude-sonnet-5", label: "Claude Sonnet 5"},
-    {provider: "gemini", model: "gemini-3.5-pro", label: "Gemini 3.5 Pro"},
+    {provider: "gemini", model: "gemini-3.1-pro-preview", label: "Gemini 3.1 Pro"},
     {provider: "openai", model: "gpt-5.1", label: "GPT-5.1"},
   ],
 }
@@ -60,6 +60,14 @@ export interface ResolvedTierModel {
   model?: string
 }
 
+/**
+ * Stored dropdown picks for model ids the provider never served, mapped to the
+ * curated replacement. gemini-3.5-pro 404s on generateContent.
+ */
+const RETIRED_MODELS: Record<string, string> = {
+  "gemini-3.5-pro": "gemini-3.1-pro-preview",
+}
+
 /** Coerce an untrusted wire value into a tier; anything else is "balanced". */
 export function normalizeAiTier(value: unknown): AiTier {
   return value === "quick" || value === "frontier" ? value : "balanced"
@@ -71,8 +79,9 @@ export function parseTierSetting(value: unknown): {provider: AiTierProvider; mod
   const sep = value.indexOf(":")
   if (sep <= 0) return null
   const provider = value.slice(0, sep)
-  const model = value.slice(sep + 1).trim()
-  if (!model) return null
+  const stored = value.slice(sep + 1).trim()
+  if (!stored) return null
+  const model = RETIRED_MODELS[stored] ?? stored
   if (provider !== "anthropic" && provider !== "gemini" && provider !== "openai") return null
   return {provider, model}
 }

package/src/services/GestureDotsService.ts

@@ -5,7 +5,8 @@
  * (cleared after a short pulse), a bullseye for a recognized long press.
  * Controllers that report press edges (touch_down … tap_end) show the press
  * itself instead: a dot while pressed, the bullseye once held, cleared at
- * release. The Neural Band's middle finger (index 1) draws the same shapes hollow. Extracted from
+ * release. The Neural Band's middle finger (index 1) draws the same shapes
+ * hollow: a ring for its tap, the bullseye without its center for its hold. Extracted from
  * the CFW dashboard service; it renders through
  * the ordinary scene pipeline, so it works on any positioning device (stock
  * G2 included), and is gated by the gesture_dots debug setting.
@@ -41,7 +42,16 @@ const FLASH_GLYPHS: Record<string, GestureDotGlyph> = {
   swipe_right: "right",
 }
 /** The band's middle finger draws the filled shapes hollow. */
-const MIDDLE_FINGER_GLYPHS: Partial<Record<GestureDotGlyph, GestureDotGlyph>> = {dot: "ring", double: "doubleRing"}
+const MIDDLE_FINGER_GLYPHS: Partial<Record<GestureDotGlyph, GestureDotGlyph>> = {
+  dot: "ring",
+  double: "doubleRing",
+  hold: "holdRing",
+}
+
+/** `glyph` as `finger` draws it: the middle finger's shapes are hollow. */
+function fingerGlyph(glyph: GestureDotGlyph, finger: number): GestureDotGlyph {
+  return finger === 1 ? (MIDDLE_FINGER_GLYPHS[glyph] ?? glyph) : glyph
+}
 
 class GestureDotsService {
   private started = false
@@ -135,12 +145,12 @@ class GestureDotsService {
       if (press) {
         // Both reports describe one press: after touch_down, tap_start means it is held.
         if (gestureName === "touch_down") press.raw = true
-        else if (press.raw) press.glyph = "hold"
+        else if (press.raw) press.glyph = fingerGlyph("hold", finger)
         this.render()
         return
       }
       this.clearFlash()
-      this.presses.set(finger, {raw: gestureName === "touch_down", glyph: finger === 1 ? "ring" : "dot"})
+      this.presses.set(finger, {raw: gestureName === "touch_down", glyph: fingerGlyph("dot", finger)})
       this.render()
       return
     }
@@ -152,14 +162,14 @@ class GestureDotsService {
       return
     }
     const shape = FLASH_GLYPHS[gestureName]
-    const glyph = shape && finger === 1 ? MIDDLE_FINGER_GLYPHS[shape] ?? shape : shape
+    const glyph = shape ? fingerGlyph(shape, finger) : shape
     // The press already showed its own tap and hold; the device's report of
     // them follows after its double-tap window, often after release.
     const shownByPress = gestureName === "single_tap" || gestureName === "long_press"
     if (press?.raw && (!glyph || shownByPress)) {
       // Pinch-and-turn reports do not release a finger. A recognized hold
       // stays visible until tap_end instead of expiring halfway through it.
-      if (gestureName === "long_press") press.glyph = "hold"
+      if (gestureName === "long_press") press.glyph = fingerGlyph("hold", finger)
       this.render()
       return
     }

package/src/services/MicStateCoordinator.ts

@@ -48,6 +48,8 @@ class MicStateCoordinator {
   // Local miniapp requirements (set when miniapps subscribe to audio streams)
   private localWantsPcm = false
   private localWantsLc3 = false
+  // Host screens that read raw PCM themselves (e.g. the Microphone settings level meter)
+  private readonly hostPcmOwners = new Set<string>()
   private configuredVad: boolean | undefined
   private configuredLoudnessGate: boolean | undefined
   private readonly miniappVadOverrides = new Map<string, GateOverride>()
@@ -75,6 +77,21 @@ class MicStateCoordinator {
     this.applyUnion()
   }
 
+  /**
+   * Hold raw PCM open for a host-side consumer, independent of miniapp
+   * subscriptions. Release with `releaseHostPcm` using the same owner.
+   */
+  public acquireHostPcm(owner: string): void {
+    if (this.hostPcmOwners.has(owner)) return
+    this.hostPcmOwners.add(owner)
+    this.applyUnion()
+  }
+
+  public releaseHostPcm(owner: string): void {
+    if (!this.hostPcmOwners.delete(owner)) return
+    this.applyUnion()
+  }
+
   /**
    * Apply a miniapp-owned gate override without changing the OS preference.
    * Overrides are lifecycle-scoped and last-live-owner-wins independently for
@@ -159,7 +176,7 @@ class MicStateCoordinator {
     const vadOverride = this.latestOverride(this.miniappVadOverrides)
     const loudnessOverride = this.latestOverride(this.miniappLoudnessGateOverrides)
 
-    if (this.localWantsPcm) {
+    if (this.wantsPcm()) {
       runtimeSettings.voice_activity_detection_enabled = false
     } else if (vadOverride) {
       runtimeSettings.voice_activity_detection_enabled = vadOverride.enabled
@@ -176,7 +193,7 @@ class MicStateCoordinator {
    * on-device PCM consumers; cloud audio uses LC3 through AudioCloudUplink.
    */
   private applyUnion(): void {
-    const shouldSendPcm = this.localWantsPcm
+    const shouldSendPcm = this.wantsPcm()
     const shouldSendLc3 = this.localWantsLc3
 
     // console.log(
@@ -195,6 +212,10 @@ class MicStateCoordinator {
     flushMicRequirementsPatch(patch)
   }
 
+  private wantsPcm(): boolean {
+    return this.localWantsPcm || this.hostPcmOwners.size > 0
+  }
+
   private rememberConfiguredGates(configured: ConfiguredMicGates): void {
     // null means the connected device intentionally omits that setting.
     // undefined means the caller is not updating the remembered preference.
@@ -225,7 +246,7 @@ class MicStateCoordinator {
 
     // Hardware VAD suppresses silence. Raw-audio consumers need a continuous
     // timeline, so their requirement wins over both OS and miniapp VAD values.
-    if (this.localWantsPcm) patch.voice_activity_detection_enabled = false
+    if (this.wantsPcm()) patch.voice_activity_detection_enabled = false
     else if (vadOverride) patch.voice_activity_detection_enabled = vadOverride.enabled
     else if (this.configuredVad !== undefined) patch.voice_activity_detection_enabled = this.configuredVad
 
@@ -250,6 +271,7 @@ class MicStateCoordinator {
     console.log(`${LOG_TAG}: cleanup()`)
     this.miniappVadOverrides.clear()
     this.miniappLoudnessGateOverrides.clear()
+    this.hostPcmOwners.clear()
     this.reset()
     MicStateCoordinator.instance = null
   }