@glassly/engine 0.1.0-dev.1 → 0.1.0-dev.100

package/build/services/GestureDotsService.d.ts

@@ -0,0 +1,40 @@
+declare class GestureDotsService {
+    private started;
+    private flash;
+    private flashTimer;
+    /** Finger currently on the touch bar (tap_start..tap_end; the CFW forwards holds as these edges). */
+    private held;
+    /**
+     * The CFW's tap_then_hold fired during this press (discrete recognition
+     * event; the tap_end that follows on release is what clears it).
+     */
+    private holdRecognized;
+    /** Whether the indicator scene currently has anything on it (needs a clear when the flash ends). */
+    private visible;
+    private unsubs;
+    start(): void;
+    stop(): void;
+    private enabled;
+    /**
+     * Flash a gesture on the indicator. Other gesture names are ignored. The
+     * device-event router calls this after the CFW dashboard had its chance to
+     * consume the gesture, so dashboard navigation does not flash.
+     */
+    noteGesture(gestureName: string): void;
+    /**
+     * Paint or clear the indicator. Nothing is drawn while anything else is on
+     * the glasses (miniapp frame or system screen) or when no gesture was just
+     * received. The top-right anchor resolves against the device's real canvas,
+     * so no size math here.
+     *
+     * Between flashes the element STAYS in the scene with the blank glyph:
+     * removing it would tear down the firmware image container and rebuild the
+     * page on every flash (a rebuild storm on stock firmware). Only disabling
+     * the setting removes the element outright.
+     */
+    private render;
+}
+declare const gestureDotsService: GestureDotsService;
+export default gestureDotsService;
+export { GestureDotsService };
+//# sourceMappingURL=GestureDotsService.d.ts.map

package/build/services/GestureDotsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureDotsService.d.ts","sourceRoot":"","sources":["../../src/services/GestureDotsService.ts"],"names":[],"mappings":"AA2BA,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,UAAU,CAAsB;IACxC,qGAAqG;IACrG,OAAO,CAAC,IAAI,CAAQ;IACpB;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAQ;IAC9B,oGAAoG;IACpG,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAwB;IAEtC,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,OAAO;IAIf;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAyCtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM;CA6Bf;AAED,QAAA,MAAM,kBAAkB,oBAA2B,CAAA;AACnD,eAAe,kBAAkB,CAAA;AACjC,OAAO,EAAC,kBAAkB,EAAC,CAAA"}

package/build/services/GestureDotsService.js

@@ -0,0 +1,167 @@
+/**
+ * Gesture dots — a debug indicator that flashes a small glyph top-right on the
+ * glasses when a touch gesture arrives, while nothing else is on the display:
+ * a filled circle for a single tap, an arrow for a swipe (cleared after a
+ * short pulse), a bullseye while a CFW tap-then-hold is held. 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.
+ *
+ * The glyphs are pre-baked images (not text): the stock firmware's builtin
+ * font has no ●/↑/↓, and a single image element with a stable id and box maps
+ * to ONE re-used firmware image container — flash and idle swap its bytes
+ * (data-only update, no page rebuild) instead of creating/removing containers.
+ */
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { BgTimer } from "../utils/timers";
+import { GESTURE_DOT_GLYPHS, GESTURE_DOT_GLYPH_SIZE } from "./gestureDotGlyphs";
+import localDisplayManager from "./LocalDisplayManager";
+import sceneRenderer from "./SceneRenderer";
+const DOTS_APP_ID = "system.gesture-dots";
+/** How long a gesture stays on the indicator. */
+const GESTURE_FLASH_MS = 700;
+const MARGIN_X = 16;
+const MARGIN_TOP = 10;
+class GestureDotsService {
+    started = false;
+    flash = null;
+    flashTimer = null;
+    /** Finger currently on the touch bar (tap_start..tap_end; the CFW forwards holds as these edges). */
+    held = false;
+    /**
+     * The CFW's tap_then_hold fired during this press (discrete recognition
+     * event; the tap_end that follows on release is what clears it).
+     */
+    holdRecognized = false;
+    /** Whether the indicator scene currently has anything on it (needs a clear when the flash ends). */
+    visible = false;
+    unsubs = [];
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.unsubs.push(
+        // The indicator owns the screen only while it is empty: drop our
+        // retained state when something else takes over, and clear any
+        // leftover flash when the display empties again.
+        localDisplayManager.onActiveDisplayChange((active) => {
+            if (active)
+                this.visible = false;
+            else
+                this.render();
+        }));
+    }
+    stop() {
+        for (const unsub of this.unsubs)
+            unsub();
+        this.unsubs = [];
+        if (this.flashTimer !== null)
+            BgTimer.clearTimeout(this.flashTimer);
+        this.flashTimer = null;
+        this.flash = null;
+        this.held = false;
+        this.holdRecognized = false;
+        this.visible = false;
+        this.started = false;
+        sceneRenderer.clearApp(DOTS_APP_ID);
+    }
+    enabled() {
+        return useSettingsStore.getState().getSetting(SETTINGS.gesture_dots.key) === true;
+    }
+    /**
+     * Flash a gesture on the indicator. Other gesture names are ignored. The
+     * device-event router calls this after the CFW dashboard had its chance to
+     * consume the gesture, so dashboard navigation does not flash.
+     */
+    noteGesture(gestureName) {
+        if (!this.started || !this.enabled())
+            return;
+        // Tap edges show a steady circle for as long as the finger is down (on
+        // CFW these arrive for holds: ET_LONG/ET_REL forwarded as
+        // tap_start/tap_end), with no timer — tap_end clears it.
+        if (gestureName === "tap_start" || gestureName === "tap_end") {
+            const held = gestureName === "tap_start";
+            if (this.held === held)
+                return;
+            this.held = held;
+            if (!held)
+                this.holdRecognized = false;
+            this.render();
+            return;
+        }
+        // CFW tap-then-hold (the stock Menu gesture): swap the steady dot for the
+        // bullseye until release. Recognition arrives mid-press, but set held too
+        // in case the tap_start edge was missed — the release edge still clears.
+        if (gestureName === "tap_then_hold") {
+            this.held = true;
+            this.holdRecognized = true;
+            this.render();
+            return;
+        }
+        const flash = gestureName === "single_tap"
+            ? "dot"
+            : gestureName === "swipe_up"
+                ? "up"
+                : gestureName === "swipe_down"
+                    ? "down"
+                    : null;
+        if (!flash)
+            return;
+        this.flash = flash;
+        if (this.flashTimer !== null)
+            BgTimer.clearTimeout(this.flashTimer);
+        this.flashTimer = BgTimer.setTimeout(() => {
+            this.flashTimer = null;
+            this.flash = null;
+            this.render();
+        }, GESTURE_FLASH_MS);
+        this.render();
+    }
+    /**
+     * Paint or clear the indicator. Nothing is drawn while anything else is on
+     * the glasses (miniapp frame or system screen) or when no gesture was just
+     * received. The top-right anchor resolves against the device's real canvas,
+     * so no size math here.
+     *
+     * Between flashes the element STAYS in the scene with the blank glyph:
+     * removing it would tear down the firmware image container and rebuild the
+     * page on every flash (a rebuild storm on stock firmware). Only disabling
+     * the setting removes the element outright.
+     */
+    render() {
+        if (!this.started)
+            return;
+        if (localDisplayManager.hasActiveDisplay())
+            return;
+        const shown = this.flash ?? (this.held ? (this.holdRecognized ? "hold" : "dot") : null);
+        if (!this.enabled()) {
+            if (this.visible) {
+                this.visible = false;
+                sceneRenderer.emitScene(DOTS_APP_ID, "main", []);
+            }
+            return;
+        }
+        if (!shown && !this.visible)
+            return;
+        const elements = [
+            {
+                type: "image",
+                id: "gesture-dot",
+                box: {
+                    x: MARGIN_X,
+                    y: MARGIN_TOP,
+                    w: GESTURE_DOT_GLYPH_SIZE,
+                    h: GESTURE_DOT_GLYPH_SIZE,
+                    anchor: "top-right",
+                },
+                data: GESTURE_DOT_GLYPHS[shown ?? "blank"],
+            },
+        ];
+        this.visible = true;
+        sceneRenderer.emitScene(DOTS_APP_ID, "main", elements);
+    }
+}
+const gestureDotsService = new GestureDotsService();
+export default gestureDotsService;
+export { GestureDotsService };
+//# sourceMappingURL=GestureDotsService.js.map

package/build/services/GestureDotsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GestureDotsService.js","sourceRoot":"","sources":["../../src/services/GestureDotsService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Gesture dots — a debug indicator that flashes a small glyph top-right on the\n * glasses when a touch gesture arrives, while nothing else is on the display:\n * a filled circle for a single tap, an arrow for a swipe (cleared after a\n * short pulse), a bullseye while a CFW tap-then-hold is held. Extracted from\n * the CFW dashboard service; it renders through\n * the ordinary scene pipeline, so it works on any positioning device (stock\n * G2 included), and is gated by the gesture_dots debug setting.\n *\n * The glyphs are pre-baked images (not text): the stock firmware's builtin\n * font has no ●/↑/↓, and a single image element with a stable id and box maps\n * to ONE re-used firmware image container — flash and idle swap its bytes\n * (data-only update, no page rebuild) instead of creating/removing containers.\n */\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport type {SceneElementInput} from \"../utils/display/scene\"\nimport {BgTimer} from \"../utils/timers\"\nimport {GESTURE_DOT_GLYPHS, GESTURE_DOT_GLYPH_SIZE, type GestureDotGlyph} from \"./gestureDotGlyphs\"\nimport localDisplayManager from \"./LocalDisplayManager\"\nimport sceneRenderer from \"./SceneRenderer\"\n\nconst DOTS_APP_ID = \"system.gesture-dots\"\n/** How long a gesture stays on the indicator. */\nconst GESTURE_FLASH_MS = 700\nconst MARGIN_X = 16\nconst MARGIN_TOP = 10\n\nclass GestureDotsService {\n  private started = false\n  private flash: GestureDotGlyph | null = null\n  private flashTimer: number | null = null\n  /** Finger currently on the touch bar (tap_start..tap_end; the CFW forwards holds as these edges). */\n  private held = false\n  /**\n   * The CFW's tap_then_hold fired during this press (discrete recognition\n   * event; the tap_end that follows on release is what clears it).\n   */\n  private holdRecognized = false\n  /** Whether the indicator scene currently has anything on it (needs a clear when the flash ends). */\n  private visible = false\n  private unsubs: Array<() => void> = []\n\n  start(): void {\n    if (this.started) return\n    this.started = true\n    this.unsubs.push(\n      // The indicator owns the screen only while it is empty: drop our\n      // retained state when something else takes over, and clear any\n      // leftover flash when the display empties again.\n      localDisplayManager.onActiveDisplayChange((active) => {\n        if (active) this.visible = false\n        else this.render()\n      }),\n    )\n  }\n\n  stop(): void {\n    for (const unsub of this.unsubs) unsub()\n    this.unsubs = []\n    if (this.flashTimer !== null) BgTimer.clearTimeout(this.flashTimer)\n    this.flashTimer = null\n    this.flash = null\n    this.held = false\n    this.holdRecognized = false\n    this.visible = false\n    this.started = false\n    sceneRenderer.clearApp(DOTS_APP_ID)\n  }\n\n  private enabled(): boolean {\n    return useSettingsStore.getState().getSetting(SETTINGS.gesture_dots.key) === true\n  }\n\n  /**\n   * Flash a gesture on the indicator. Other gesture names are ignored. The\n   * device-event router calls this after the CFW dashboard had its chance to\n   * consume the gesture, so dashboard navigation does not flash.\n   */\n  noteGesture(gestureName: string): void {\n    if (!this.started || !this.enabled()) return\n    // Tap edges show a steady circle for as long as the finger is down (on\n    // CFW these arrive for holds: ET_LONG/ET_REL forwarded as\n    // tap_start/tap_end), with no timer — tap_end clears it.\n    if (gestureName === \"tap_start\" || gestureName === \"tap_end\") {\n      const held = gestureName === \"tap_start\"\n      if (this.held === held) return\n      this.held = held\n      if (!held) this.holdRecognized = false\n      this.render()\n      return\n    }\n    // CFW tap-then-hold (the stock Menu gesture): swap the steady dot for the\n    // bullseye until release. Recognition arrives mid-press, but set held too\n    // in case the tap_start edge was missed — the release edge still clears.\n    if (gestureName === \"tap_then_hold\") {\n      this.held = true\n      this.holdRecognized = true\n      this.render()\n      return\n    }\n    const flash: GestureDotGlyph | null =\n      gestureName === \"single_tap\"\n        ? \"dot\"\n        : gestureName === \"swipe_up\"\n          ? \"up\"\n          : gestureName === \"swipe_down\"\n            ? \"down\"\n            : null\n    if (!flash) return\n    this.flash = flash\n    if (this.flashTimer !== null) BgTimer.clearTimeout(this.flashTimer)\n    this.flashTimer = BgTimer.setTimeout(() => {\n      this.flashTimer = null\n      this.flash = null\n      this.render()\n    }, GESTURE_FLASH_MS)\n    this.render()\n  }\n\n  /**\n   * Paint or clear the indicator. Nothing is drawn while anything else is on\n   * the glasses (miniapp frame or system screen) or when no gesture was just\n   * received. The top-right anchor resolves against the device's real canvas,\n   * so no size math here.\n   *\n   * Between flashes the element STAYS in the scene with the blank glyph:\n   * removing it would tear down the firmware image container and rebuild the\n   * page on every flash (a rebuild storm on stock firmware). Only disabling\n   * the setting removes the element outright.\n   */\n  private render(): void {\n    if (!this.started) return\n    if (localDisplayManager.hasActiveDisplay()) return\n    const shown = this.flash ?? (this.held ? (this.holdRecognized ? \"hold\" : \"dot\") : null)\n    if (!this.enabled()) {\n      if (this.visible) {\n        this.visible = false\n        sceneRenderer.emitScene(DOTS_APP_ID, \"main\", [])\n      }\n      return\n    }\n    if (!shown && !this.visible) return\n    const elements: SceneElementInput[] = [\n      {\n        type: \"image\",\n        id: \"gesture-dot\",\n        box: {\n          x: MARGIN_X,\n          y: MARGIN_TOP,\n          w: GESTURE_DOT_GLYPH_SIZE,\n          h: GESTURE_DOT_GLYPH_SIZE,\n          anchor: \"top-right\",\n        },\n        data: GESTURE_DOT_GLYPHS[shown ?? \"blank\"],\n      },\n    ]\n    this.visible = true\n    sceneRenderer.emitScene(DOTS_APP_ID, \"main\", elements)\n  }\n}\n\nconst gestureDotsService = new GestureDotsService()\nexport default gestureDotsService\nexport {GestureDotsService}\n"]}

package/build/services/GlassesStatusProjection.d.ts

@@ -1,3 +1,17 @@
-export declare function startGlassesStatusProjection(): void;
+/**
+ * Glasses status projection — engine-owned. Subscribes to the native bluetooth-sdk
+ * status events and projects them into the engine device stores, so engine's own
+ * services (which react to those stores) work for ANY host — not just the first-party
+ * Glassly app, where this used to live in MantleManager.
+ *
+ * This is the INBOUND mirror of GlassesSettingsSync: that pushes the settings store
+ * OUT to the device; this pulls device status IN to the stores. It's the feed that
+ * the rest of the engine runtime depends on (MicStateCoordinator, the settings-sync
+ * on-connect trigger, the facade read-models all read these stores).
+ *
+ * Started by `engine.start()`. Idempotent.
+ */
+import { type PublicGlassesStatus } from "@glassly/bluetooth-sdk";
+export declare function startGlassesStatusProjection(forwarder?: (status: Partial<PublicGlassesStatus>) => void): Promise<void>;
 export declare function stopGlassesStatusProjection(): void;
 //# sourceMappingURL=GlassesStatusProjection.d.ts.map

package/build/services/GlassesStatusProjection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlassesStatusProjection.d.ts","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"AAqBA,wBAAgB,4BAA4B,IAAI,IAAI,CA6CnD;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}
+{"version":3,"file":"GlassesStatusProjection.d.ts","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAqB,EAAC,KAAK,mBAAmB,EAAC,MAAM,wBAAwB,CAAA;AAS7E,wBAAgB,4BAA4B,CAC1C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,KAAK,IAAI,GACzD,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAMlD"}

package/build/services/GlassesStatusProjection.js

@@ -11,19 +11,22 @@
  *
  * Started by `engine.start()`. Idempotent.
  */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import BluetoothSdk from "@glassly/bluetooth-sdk";
 import { useCoreStore } from "../stores/core";
 import { useGlassesStore } from "../stores/glasses";
-import localMiniappRuntime from "./LocalMiniappRuntime";
 let unsubs = [];
 let projectionRunId = 0;
-export function startGlassesStatusProjection() {
+let glassesStatusForwarder = null;
+let hydrationPromise = null;
+export function startGlassesStatusProjection(forwarder) {
+    if (forwarder)
+        glassesStatusForwarder = forwarder;
     if (unsubs.length)
-        return;
+        return hydrationPromise ?? Promise.resolve();
     const runId = ++projectionRunId;
     let bluetoothEventSeen = false;
     let glassesEventSeen = false;
-    void BluetoothSdk.getBluetoothStatus()
+    const bluetoothHydration = BluetoothSdk.getBluetoothStatus()
         .then((status) => {
         if (runId !== projectionRunId || bluetoothEventSeen)
             return;
@@ -32,7 +35,7 @@ export function startGlassesStatusProjection() {
         .catch((error) => {
         console.warn("GlassesStatusProjection: getBluetoothStatus failed", error);
     });
-    void BluetoothSdk.getGlassesStatus()
+    const glassesHydration = BluetoothSdk.getGlassesStatus()
         .then((status) => {
         if (runId !== projectionRunId || glassesEventSeen)
             return;
@@ -42,24 +45,28 @@ export function startGlassesStatusProjection() {
         console.warn("GlassesStatusProjection: getGlassesStatus failed", error);
     });
     // Bluetooth-adapter status -> core store.
-    unsubs.push(BluetoothSdk.onBluetoothStatus((changed) => {
+    unsubs.push(BluetoothSdk.subscribeBluetoothStatus((changed) => {
         bluetoothEventSeen = true;
         useCoreStore.getState().setCoreInfo(changed);
     }));
-    // Glasses status -> glasses store (+ forward to local miniapps; clear any stale
-    // OTA-available flag on disconnect).
-    unsubs.push(BluetoothSdk.onGlassesStatus((changed) => {
+    // Glasses status -> glasses store (+ optional full-runtime forwarding to local
+    // miniapps; clear any stale OTA-available flag on disconnect).
+    unsubs.push(BluetoothSdk.subscribeGlassesStatus((changed) => {
         glassesEventSeen = true;
         useGlassesStore.getState().setGlassesInfo(changed);
-        localMiniappRuntime.forwardEvent("glasses_connection_state", changed);
+        glassesStatusForwarder?.(changed);
         if (changed.connection?.state === "disconnected") {
             useGlassesStore.getState().setOtaUpdateAvailable(null);
         }
     }));
+    hydrationPromise = Promise.allSettled([bluetoothHydration, glassesHydration]).then(() => undefined);
+    return hydrationPromise;
 }
 export function stopGlassesStatusProjection() {
     projectionRunId++;
     unsubs.forEach((unsub) => unsub());
     unsubs = [];
+    glassesStatusForwarder = null;
+    hydrationPromise = null;
 }
 //# sourceMappingURL=GlassesStatusProjection.js.map

package/build/services/GlassesStatusProjection.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlassesStatusProjection.js","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,YAAY,MAAM,iCAAiC,CAAA;AAC1D,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AAEvD,IAAI,MAAM,GAAsB,EAAE,CAAA;AAClC,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,MAAM,UAAU,4BAA4B;IAC1C,IAAI,MAAM,CAAC,MAAM;QAAE,OAAM;IAEzB,MAAM,KAAK,GAAG,EAAE,eAAe,CAAA;IAC/B,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAE5B,KAAK,YAAY,CAAC,kBAAkB,EAAE;SACnC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,KAAK,KAAK,eAAe,IAAI,kBAAkB;YAAE,OAAM;QAC3D,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEJ,KAAK,YAAY,CAAC,gBAAgB,EAAE;SACjC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,KAAK,KAAK,eAAe,IAAI,gBAAgB;YAAE,OAAM;QACzD,eAAe,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEJ,0CAA0C;IAC1C,MAAM,CAAC,IAAI,CACT,YAAY,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,EAAE;QACzC,kBAAkB,GAAG,IAAI,CAAA;QACzB,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC,CAAC,CACH,CAAA;IAED,gFAAgF;IAChF,qCAAqC;IACrC,MAAM,CAAC,IAAI,CACT,YAAY,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,EAAE;QACvC,gBAAgB,GAAG,IAAI,CAAA;QACvB,eAAe,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAClD,mBAAmB,CAAC,YAAY,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAA;QACrE,IAAI,OAAO,CAAC,UAAU,EAAE,KAAK,KAAK,cAAc,EAAE,CAAC;YACjD,eAAe,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,eAAe,EAAE,CAAA;IACjB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAA;IAClC,MAAM,GAAG,EAAE,CAAA;AACb,CAAC","sourcesContent":["/**\n * Glasses status projection — engine-owned. Subscribes to the native bluetooth-sdk\n * status events and projects them into the engine device stores, so engine's own\n * services (which react to those stores) work for ANY host — not just the first-party\n * Glassly app, where this used to live in MantleManager.\n *\n * This is the INBOUND mirror of GlassesSettingsSync: that pushes the settings store\n * OUT to the device; this pulls device status IN to the stores. It's the feed that\n * the rest of the engine runtime depends on (MicStateCoordinator, the settings-sync\n * on-connect trigger, the facade read-models all read these stores).\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport localMiniappRuntime from \"./LocalMiniappRuntime\"\n\nlet unsubs: Array<() => void> = []\nlet projectionRunId = 0\n\nexport function startGlassesStatusProjection(): void {\n  if (unsubs.length) return\n\n  const runId = ++projectionRunId\n  let bluetoothEventSeen = false\n  let glassesEventSeen = false\n\n  void BluetoothSdk.getBluetoothStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || bluetoothEventSeen) return\n      useCoreStore.getState().setCoreInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getBluetoothStatus failed\", error)\n    })\n\n  void BluetoothSdk.getGlassesStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || glassesEventSeen) return\n      useGlassesStore.getState().setGlassesInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getGlassesStatus failed\", error)\n    })\n\n  // Bluetooth-adapter status -> core store.\n  unsubs.push(\n    BluetoothSdk.onBluetoothStatus((changed) => {\n      bluetoothEventSeen = true\n      useCoreStore.getState().setCoreInfo(changed)\n    }),\n  )\n\n  // Glasses status -> glasses store (+ forward to local miniapps; clear any stale\n  // OTA-available flag on disconnect).\n  unsubs.push(\n    BluetoothSdk.onGlassesStatus((changed) => {\n      glassesEventSeen = true\n      useGlassesStore.getState().setGlassesInfo(changed)\n      localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed)\n      if (changed.connection?.state === \"disconnected\") {\n        useGlassesStore.getState().setOtaUpdateAvailable(null)\n      }\n    }),\n  )\n}\n\nexport function stopGlassesStatusProjection(): void {\n  projectionRunId++\n  unsubs.forEach((unsub) => unsub())\n  unsubs = []\n}\n"]}
+{"version":3,"file":"GlassesStatusProjection.js","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Glasses status projection — engine-owned. Subscribes to the native bluetooth-sdk\n * status events and projects them into the engine device stores, so engine's own\n * services (which react to those stores) work for ANY host — not just the first-party\n * Glassly app, where this used to live in MantleManager.\n *\n * This is the INBOUND mirror of GlassesSettingsSync: that pushes the settings store\n * OUT to the device; this pulls device status IN to the stores. It's the feed that\n * the rest of the engine runtime depends on (MicStateCoordinator, the settings-sync\n * on-connect trigger, the facade read-models all read these stores).\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport BluetoothSdk, {type PublicGlassesStatus} from \"@glassly/bluetooth-sdk\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\n\nlet unsubs: Array<() => void> = []\nlet projectionRunId = 0\nlet glassesStatusForwarder: ((status: Partial<PublicGlassesStatus>) => void) | null = null\nlet hydrationPromise: Promise<void> | null = null\n\nexport function startGlassesStatusProjection(\n  forwarder?: (status: Partial<PublicGlassesStatus>) => void,\n): Promise<void> {\n  if (forwarder) glassesStatusForwarder = forwarder\n  if (unsubs.length) return hydrationPromise ?? Promise.resolve()\n\n  const runId = ++projectionRunId\n  let bluetoothEventSeen = false\n  let glassesEventSeen = false\n\n  const bluetoothHydration = BluetoothSdk.getBluetoothStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || bluetoothEventSeen) return\n      useCoreStore.getState().setCoreInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getBluetoothStatus failed\", error)\n    })\n\n  const glassesHydration = BluetoothSdk.getGlassesStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || glassesEventSeen) return\n      useGlassesStore.getState().setGlassesInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getGlassesStatus failed\", error)\n    })\n\n  // Bluetooth-adapter status -> core store.\n  unsubs.push(\n    BluetoothSdk.subscribeBluetoothStatus((changed) => {\n      bluetoothEventSeen = true\n      useCoreStore.getState().setCoreInfo(changed)\n    }),\n  )\n\n  // Glasses status -> glasses store (+ optional full-runtime forwarding to local\n  // miniapps; clear any stale OTA-available flag on disconnect).\n  unsubs.push(\n    BluetoothSdk.subscribeGlassesStatus((changed) => {\n      glassesEventSeen = true\n      useGlassesStore.getState().setGlassesInfo(changed)\n      glassesStatusForwarder?.(changed)\n      if (changed.connection?.state === \"disconnected\") {\n        useGlassesStore.getState().setOtaUpdateAvailable(null)\n      }\n    }),\n  )\n\n  hydrationPromise = Promise.allSettled([bluetoothHydration, glassesHydration]).then(() => undefined)\n  return hydrationPromise\n}\n\nexport function stopGlassesStatusProjection(): void {\n  projectionRunId++\n  unsubs.forEach((unsub) => unsub())\n  unsubs = []\n  glassesStatusForwarder = null\n  hydrationPromise = null\n}\n"]}

package/build/services/HotspotOtaTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HotspotOtaTransport.d.ts","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAML,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAA;AAIhC,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,CAAA;AAEzG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,eAAe,CAAA;IACtB,QAAQ,CAAC,EAAE,2BAA2B,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B,gCAAgC,GAChC,sBAAsB,GACtB,qBAAqB,GACrB,uBAAuB,CAAA;AAE3B,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,IAAI,EAAE,mBAAmB;gBAAzB,IAAI,EAAE,mBAAmB,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED,yFAAyF;AACzF,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,qBAAqB,CAAQ;IACrC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,eAAe,CAA6B;IAE9C,OAAO,CACX,WAAW,EAAE,4BAA4B,EACzC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAClD,OAAO,CAAC,MAAM,CAAC;IAuElB,gGAAgG;YAClF,2BAA2B;IAczC,OAAO,CAAC,mBAAmB,CAa1B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA4BhC;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}
+{"version":3,"file":"HotspotOtaTransport.d.ts","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAML,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAA;AAIhC,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,CAAA;AAEzG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,eAAe,CAAA;IACtB,QAAQ,CAAC,EAAE,2BAA2B,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B,gCAAgC,GAChC,sBAAsB,GACtB,qBAAqB,GACrB,uBAAuB,CAAA;AAE3B,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,IAAI,EAAE,mBAAmB;gBAAzB,IAAI,EAAE,mBAAmB,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED,yFAAyF;AACzF,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,qBAAqB,CAAQ;IACrC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,eAAe,CAA6B;IAE9C,OAAO,CACX,WAAW,EAAE,4BAA4B,EACzC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAClD,OAAO,CAAC,MAAM,CAAC;IAuElB,gGAAgG;YAClF,2BAA2B;IAczC,OAAO,CAAC,mBAAmB,CAa1B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA4BhC;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}

package/build/services/HotspotOtaTransport.js

@@ -1,4 +1,5 @@
-import BluetoothSdk, { isEnabledHotspotStatus, OtaServer } from "@glassly/bluetooth-sdk/internal";
+import BluetoothSdk, { isEnabledHotspotStatus } from "@glassly/bluetooth-sdk";
+import { otaServer } from "@glassly/bluetooth-sdk/ota-transport";
 // One coordinator selects the native Android or iOS staging implementation at runtime.
 // eslint-disable-next-line react-native/split-platform-components
 import { PermissionsAndroid, Platform } from "react-native";
@@ -49,7 +50,7 @@ class HotspotOtaTransport {
             let localAddress = scopedAddress;
             if (Platform.OS === "ios") {
                 try {
-                    localAddress = await OtaServer.waitForWifiAddress(hotspot.localIp, 15_000);
+                    localAddress = await otaServer.waitForWifiAddress(hotspot.localIp, 15_000);
                 }
                 catch (error) {
                     throw new HotspotOtaTransportError("hotspot_join_failed", error instanceof Error ? error.message : String(error));
@@ -58,10 +59,10 @@ class HotspotOtaTransport {
             const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]));
             // Start exactly one native listener to learn its selected port, then atomically replace
             // the placeholder with the immutable rewritten manifest before ota_start is sent.
-            const server = await OtaServer.startOtaServer("{}", artifactPaths, localAddress);
+            const server = await otaServer.start("{}", artifactPaths, localAddress);
             this.serverStarted = true;
             const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl);
-            const published = await OtaServer.startOtaServer(manifest, artifactPaths, server.host);
+            const published = await otaServer.start(manifest, artifactPaths, server.host);
             if (published.manifestUrl !== server.manifestUrl) {
                 throw new Error("Local OTA server endpoint changed while publishing the manifest");
             }
@@ -98,12 +99,12 @@ class HotspotOtaTransport {
         }
     }
     downloadIosArtifact = async (entry, destination, onProgress) => {
-        const subscription = OtaServer.addListener("artifactDownloadProgress", (event) => {
+        const subscription = otaServer.onArtifactDownloadProgress((event) => {
             if (event.destination === destination)
                 onProgress?.(event.bytesWritten, event.contentLength);
         });
         try {
-            return await OtaServer.downloadArtifact(entry.url, destination);
+            return await otaServer.downloadArtifact(entry.url, destination);
         }
         finally {
             subscription.remove();
@@ -124,7 +125,7 @@ class HotspotOtaTransport {
                 }
             }
             if (this.serverStarted)
-                await OtaServer.stopOtaServer().catch(() => { });
+                await otaServer.stop().catch(() => { });
             if (this.localNetworkConnected)
                 await localNetworkTransport.disconnect().catch(() => { });
             await cleanupArtifacts().catch(() => { });

package/build/services/HotspotOtaTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"HotspotOtaTransport.js","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {isEnabledHotspotStatus, OtaServer} from \"@glassly/bluetooth-sdk/internal\"\n// One coordinator selects the native Android or iOS staging implementation at runtime.\n// eslint-disable-next-line react-native/split-platform-components\nimport {PermissionsAndroid, Platform} from \"react-native\"\nimport type {OtaCheckCurrentGlassesResult} from \"./OtaUpdateCheckService\"\nimport {\n  cleanupArtifacts,\n  OtaArtifactError,\n  planArtifacts,\n  prepareArtifacts,\n  rewriteManifestForLocalServer,\n  type OtaArtifactDownloadProgress,\n  type PreparedOtaArtifact,\n} from \"./OtaArtifactDownloader\"\nimport {disableHotspotWithRetry} from \"./HotspotShutdown\"\nimport {localNetworkTransport} from \"./asg/localNetworkTransport\"\n\nexport type HotspotOtaPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\n\nexport type HotspotOtaProgress = {\n  phase: HotspotOtaPhase\n  artifact?: OtaArtifactDownloadProgress\n}\n\nexport type HotspotOtaErrorCode =\n  | \"hotspot_wifi_permission_denied\"\n  | \"hotspot_start_failed\"\n  | \"hotspot_join_failed\"\n  | \"hotspot_server_failed\"\n\nexport class HotspotOtaTransportError extends Error {\n  constructor(\n    public readonly code: HotspotOtaErrorCode,\n    message: string,\n  ) {\n    super(message)\n    this.name = \"HotspotOtaTransportError\"\n  }\n}\n\n/** Owns the single phone-side endpoint and network lease for one hotspot OTA attempt. */\nclass HotspotOtaTransport {\n  private active = false\n  private prepared: PreparedOtaArtifact[] = []\n  private hotspotRequested = false\n  private localNetworkConnected = false\n  private serverStarted = false\n  private teardownPromise: Promise<void> | null = null\n\n  async prepare(\n    checkResult: OtaCheckCurrentGlassesResult,\n    onProgress?: (progress: HotspotOtaProgress) => void,\n  ): Promise<string> {\n    if (this.teardownPromise) await this.teardownPromise\n    if (this.active) {\n      throw new Error(\"A hotspot OTA transport is already active\")\n    }\n    if (!checkResult.manifestBody) {\n      throw new Error(\"The selected OTA check has no manifest body\")\n    }\n\n    let phase: HotspotOtaPhase = \"downloading\"\n    try {\n      await this.ensureAndroidWifiPermission()\n      onProgress?.({phase: \"downloading\"})\n      this.prepared = await prepareArtifacts(\n        planArtifacts(checkResult),\n        (artifact) => onProgress?.({phase: \"downloading\", artifact}),\n        Platform.OS === \"ios\" ? this.downloadIosArtifact : undefined,\n      )\n\n      phase = \"starting_hotspot\"\n      onProgress?.({phase: \"starting_hotspot\"})\n      this.hotspotRequested = true\n      const hotspot = await BluetoothSdk.setHotspotState(true)\n      if (!isEnabledHotspotStatus(hotspot)) {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", \"Mentra Live did not return hotspot credentials\")\n      }\n      phase = \"joining_hotspot\"\n      onProgress?.({phase: \"joining_hotspot\"})\n      const scopedAddress = await localNetworkTransport.connect(hotspot.ssid, hotspot.password)\n      this.localNetworkConnected = true\n      let localAddress = scopedAddress\n      if (Platform.OS === \"ios\") {\n        try {\n          localAddress = await OtaServer.waitForWifiAddress(hotspot.localIp, 15_000)\n        } catch (error) {\n          throw new HotspotOtaTransportError(\n            \"hotspot_join_failed\",\n            error instanceof Error ? error.message : String(error),\n          )\n        }\n      }\n      const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]))\n      // Start exactly one native listener to learn its selected port, then atomically replace\n      // the placeholder with the immutable rewritten manifest before ota_start is sent.\n      const server = await OtaServer.startOtaServer(\"{}\", artifactPaths, localAddress)\n      this.serverStarted = true\n      const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl)\n      const published = await OtaServer.startOtaServer(manifest, artifactPaths, server.host)\n      if (published.manifestUrl !== server.manifestUrl) {\n        throw new Error(\"Local OTA server endpoint changed while publishing the manifest\")\n      }\n      this.active = true\n      onProgress?.({phase: \"serving\"})\n      return published.manifestUrl\n    } catch (error) {\n      const joined = this.localNetworkConnected\n      await this.teardown()\n      if (error instanceof OtaArtifactError || error instanceof HotspotOtaTransportError) {\n        throw error\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      if (phase === \"starting_hotspot\") {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", message)\n      }\n      if (phase === \"joining_hotspot\" && !joined) {\n        throw new HotspotOtaTransportError(\"hotspot_join_failed\", message)\n      }\n      throw new HotspotOtaTransportError(\"hotspot_server_failed\", message)\n    }\n  }\n\n  /** Android 13+ requires the nearby-WiFi runtime grant before WifiNetworkSpecifier is usable. */\n  private async ensureAndroidWifiPermission(): Promise<void> {\n    if (Platform.OS !== \"android\") return\n\n    const permission = PermissionsAndroid.PERMISSIONS.NEARBY_WIFI_DEVICES\n    if (await PermissionsAndroid.check(permission)) return\n    const result = await PermissionsAndroid.request(permission)\n    if (result !== PermissionsAndroid.RESULTS.GRANTED) {\n      throw new HotspotOtaTransportError(\n        \"hotspot_wifi_permission_denied\",\n        \"Nearby devices permission is required to connect to the glasses hotspot\",\n      )\n    }\n  }\n\n  private downloadIosArtifact = async (\n    entry: {url: string},\n    destination: string,\n    onProgress?: (bytesWritten: number, contentLength: number) => void,\n  ): Promise<{statusCode: number}> => {\n    const subscription = OtaServer.addListener(\"artifactDownloadProgress\", (event) => {\n      if (event.destination === destination) onProgress?.(event.bytesWritten, event.contentLength)\n    })\n    try {\n      return await OtaServer.downloadArtifact(entry.url, destination)\n    } finally {\n      subscription.remove()\n    }\n  }\n\n  async teardown(): Promise<void> {\n    if (this.teardownPromise) return this.teardownPromise\n    this.teardownPromise = (async () => {\n      if (this.hotspotRequested) {\n        const hotspotStopped = await disableHotspotWithRetry(() => BluetoothSdk.setHotspotState(false), {\n          // A completed APK step has just replaced ASG. Let the new command path\n          // settle before asking it to tear down the SystemUI-owned access point.\n          initialDelayMs: this.serverStarted ? 750 : 0,\n        })\n        if (!hotspotStopped) {\n          console.warn(\"[OTA_PROGRESS] glasses hotspot shutdown was not confirmed after bounded retries\")\n        }\n      }\n      if (this.serverStarted) await OtaServer.stopOtaServer().catch(() => {})\n      if (this.localNetworkConnected) await localNetworkTransport.disconnect().catch(() => {})\n      await cleanupArtifacts().catch(() => {})\n      this.prepared = []\n      this.active = false\n      this.serverStarted = false\n      this.localNetworkConnected = false\n      this.hotspotRequested = false\n    })()\n    try {\n      await this.teardownPromise\n    } finally {\n      this.teardownPromise = null\n    }\n  }\n}\n\nexport const hotspotOtaTransport = new HotspotOtaTransport()\n"]}
+{"version":3,"file":"HotspotOtaTransport.js","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {isEnabledHotspotStatus} from \"@glassly/bluetooth-sdk\"\nimport {otaServer} from \"@glassly/bluetooth-sdk/ota-transport\"\n// One coordinator selects the native Android or iOS staging implementation at runtime.\n// eslint-disable-next-line react-native/split-platform-components\nimport {PermissionsAndroid, Platform} from \"react-native\"\nimport type {OtaCheckCurrentGlassesResult} from \"./OtaUpdateCheckService\"\nimport {\n  cleanupArtifacts,\n  OtaArtifactError,\n  planArtifacts,\n  prepareArtifacts,\n  rewriteManifestForLocalServer,\n  type OtaArtifactDownloadProgress,\n  type PreparedOtaArtifact,\n} from \"./OtaArtifactDownloader\"\nimport {disableHotspotWithRetry} from \"./HotspotShutdown\"\nimport {localNetworkTransport} from \"./asg/localNetworkTransport\"\n\nexport type HotspotOtaPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\n\nexport type HotspotOtaProgress = {\n  phase: HotspotOtaPhase\n  artifact?: OtaArtifactDownloadProgress\n}\n\nexport type HotspotOtaErrorCode =\n  | \"hotspot_wifi_permission_denied\"\n  | \"hotspot_start_failed\"\n  | \"hotspot_join_failed\"\n  | \"hotspot_server_failed\"\n\nexport class HotspotOtaTransportError extends Error {\n  constructor(\n    public readonly code: HotspotOtaErrorCode,\n    message: string,\n  ) {\n    super(message)\n    this.name = \"HotspotOtaTransportError\"\n  }\n}\n\n/** Owns the single phone-side endpoint and network lease for one hotspot OTA attempt. */\nclass HotspotOtaTransport {\n  private active = false\n  private prepared: PreparedOtaArtifact[] = []\n  private hotspotRequested = false\n  private localNetworkConnected = false\n  private serverStarted = false\n  private teardownPromise: Promise<void> | null = null\n\n  async prepare(\n    checkResult: OtaCheckCurrentGlassesResult,\n    onProgress?: (progress: HotspotOtaProgress) => void,\n  ): Promise<string> {\n    if (this.teardownPromise) await this.teardownPromise\n    if (this.active) {\n      throw new Error(\"A hotspot OTA transport is already active\")\n    }\n    if (!checkResult.manifestBody) {\n      throw new Error(\"The selected OTA check has no manifest body\")\n    }\n\n    let phase: HotspotOtaPhase = \"downloading\"\n    try {\n      await this.ensureAndroidWifiPermission()\n      onProgress?.({phase: \"downloading\"})\n      this.prepared = await prepareArtifacts(\n        planArtifacts(checkResult),\n        (artifact) => onProgress?.({phase: \"downloading\", artifact}),\n        Platform.OS === \"ios\" ? this.downloadIosArtifact : undefined,\n      )\n\n      phase = \"starting_hotspot\"\n      onProgress?.({phase: \"starting_hotspot\"})\n      this.hotspotRequested = true\n      const hotspot = await BluetoothSdk.setHotspotState(true)\n      if (!isEnabledHotspotStatus(hotspot)) {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", \"Mentra Live did not return hotspot credentials\")\n      }\n      phase = \"joining_hotspot\"\n      onProgress?.({phase: \"joining_hotspot\"})\n      const scopedAddress = await localNetworkTransport.connect(hotspot.ssid, hotspot.password)\n      this.localNetworkConnected = true\n      let localAddress = scopedAddress\n      if (Platform.OS === \"ios\") {\n        try {\n          localAddress = await otaServer.waitForWifiAddress(hotspot.localIp, 15_000)\n        } catch (error) {\n          throw new HotspotOtaTransportError(\n            \"hotspot_join_failed\",\n            error instanceof Error ? error.message : String(error),\n          )\n        }\n      }\n      const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]))\n      // Start exactly one native listener to learn its selected port, then atomically replace\n      // the placeholder with the immutable rewritten manifest before ota_start is sent.\n      const server = await otaServer.start(\"{}\", artifactPaths, localAddress)\n      this.serverStarted = true\n      const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl)\n      const published = await otaServer.start(manifest, artifactPaths, server.host)\n      if (published.manifestUrl !== server.manifestUrl) {\n        throw new Error(\"Local OTA server endpoint changed while publishing the manifest\")\n      }\n      this.active = true\n      onProgress?.({phase: \"serving\"})\n      return published.manifestUrl\n    } catch (error) {\n      const joined = this.localNetworkConnected\n      await this.teardown()\n      if (error instanceof OtaArtifactError || error instanceof HotspotOtaTransportError) {\n        throw error\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      if (phase === \"starting_hotspot\") {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", message)\n      }\n      if (phase === \"joining_hotspot\" && !joined) {\n        throw new HotspotOtaTransportError(\"hotspot_join_failed\", message)\n      }\n      throw new HotspotOtaTransportError(\"hotspot_server_failed\", message)\n    }\n  }\n\n  /** Android 13+ requires the nearby-WiFi runtime grant before WifiNetworkSpecifier is usable. */\n  private async ensureAndroidWifiPermission(): Promise<void> {\n    if (Platform.OS !== \"android\") return\n\n    const permission = PermissionsAndroid.PERMISSIONS.NEARBY_WIFI_DEVICES\n    if (await PermissionsAndroid.check(permission)) return\n    const result = await PermissionsAndroid.request(permission)\n    if (result !== PermissionsAndroid.RESULTS.GRANTED) {\n      throw new HotspotOtaTransportError(\n        \"hotspot_wifi_permission_denied\",\n        \"Nearby devices permission is required to connect to the glasses hotspot\",\n      )\n    }\n  }\n\n  private downloadIosArtifact = async (\n    entry: {url: string},\n    destination: string,\n    onProgress?: (bytesWritten: number, contentLength: number) => void,\n  ): Promise<{statusCode: number}> => {\n    const subscription = otaServer.onArtifactDownloadProgress((event) => {\n      if (event.destination === destination) onProgress?.(event.bytesWritten, event.contentLength)\n    })\n    try {\n      return await otaServer.downloadArtifact(entry.url, destination)\n    } finally {\n      subscription.remove()\n    }\n  }\n\n  async teardown(): Promise<void> {\n    if (this.teardownPromise) return this.teardownPromise\n    this.teardownPromise = (async () => {\n      if (this.hotspotRequested) {\n        const hotspotStopped = await disableHotspotWithRetry(() => BluetoothSdk.setHotspotState(false), {\n          // A completed APK step has just replaced ASG. Let the new command path\n          // settle before asking it to tear down the SystemUI-owned access point.\n          initialDelayMs: this.serverStarted ? 750 : 0,\n        })\n        if (!hotspotStopped) {\n          console.warn(\"[OTA_PROGRESS] glasses hotspot shutdown was not confirmed after bounded retries\")\n        }\n      }\n      if (this.serverStarted) await otaServer.stop().catch(() => {})\n      if (this.localNetworkConnected) await localNetworkTransport.disconnect().catch(() => {})\n      await cleanupArtifacts().catch(() => {})\n      this.prepared = []\n      this.active = false\n      this.serverStarted = false\n      this.localNetworkConnected = false\n      this.hotspotRequested = false\n    })()\n    try {\n      await this.teardownPromise\n    } finally {\n      this.teardownPromise = null\n    }\n  }\n}\n\nexport const hotspotOtaTransport = new HotspotOtaTransport()\n"]}

package/build/services/LocalDisplayManager.d.ts

@@ -2,8 +2,8 @@
  * LocalDisplayManager
  *
  * Phone-side arbiter for display requests originating from LOCAL miniapps
- * (the @glassly/miniapp SDK). Mirrors the user-facing behavior of the cloud
- * DisplayManager for the features that matter on the phone:
+ * (the @glassly/miniapp SDK). Preserves the retired cloud display manager's
+ * user-facing behavior for the features that matter on the phone:
  *
  *   - boot message ("Starting <AppName>…") with a bounded window
  *   - durationMs auto-clear
@@ -49,10 +49,22 @@ declare class LocalDisplayManager {
     private static instance;
     private coreApp;
     private coreAppDisplay;
-    private currentDisplay;
+    private _currentDisplay;
     private backgroundLock;
+    /** Fired when the display transitions between empty and occupied (any package, system screens included). */
+    private activeDisplayListeners;
+    private get currentDisplay();
+    private set currentDisplay(value);
+    /** True while anything (miniapp or system screen) is on the glasses display. */
+    hasActiveDisplay(): boolean;
+    /** Subscribe to empty↔occupied display transitions. Returns an unsubscribe. */
+    onActiveDisplayChange(listener: (active: boolean) => void): () => void;
     private bootingApp;
     private bootQueue;
+    /** While true the dashboard owns the glasses: main frames are retained but not sent. */
+    private dashboardActive;
+    /** Miniapp whose visible frame is temporarily covered by an OS exit notice. */
+    private exitingApp;
     private expiryTimerId;
     /** Reconnect-replay subscription state (attachToRuntime). */
     private runtimeAttached;
@@ -82,12 +94,51 @@ declare class LocalDisplayManager {
      * miniapp is foreground.
      */
     onCoreAppChange(packageName: string | null): void;
+    /**
+     * The package that currently owns the glasses screen, for gesture-claim
+     * arbitration (see LocalMiniappRuntime.foregroundClaimsGesture). This is
+     * glasses ownership, not the phone's Compositor foreground: a background
+     * miniapp rendering to the glasses with the phone pocketed is the owner.
+     *
+     * The live frame's owner wins; a background app that holds the display lock
+     * but has no frame up right now (between renders) still counts. System
+     * frames (boot, notices) own nothing claimable. Returns null when the
+     * glasses are idle.
+     */
+    getGestureOwner(): string | null;
+    /**
+     * The miniapp whose frame is visibly on the glasses right now.
+     *
+     * Unlike getGestureOwner(), this deliberately does not fall back to a
+     * background display lock: a lock holder with no live frame is not visible
+     * and therefore must not be closed by the system double-tap gesture.
+     */
+    getVisibleMiniappPackageName(): string | null;
+    /**
+     * Cover the currently visible miniapp with a persistent system exit notice.
+     * While it is up, miniapp display traffic is held off so a streaming app
+     * cannot immediately overwrite the notice. The caller completes the normal
+     * stop flow and then calls finishMiniappExit(); onUnmount does the same as a
+     * safety net.
+     */
+    beginMiniappExit(packageName: string, text: string): boolean;
+    /** Remove an exit notice and resume the display state normal app teardown leaves behind. */
+    finishMiniappExit(packageName: string): void;
+    /** Cancel the handoff and put back the frame the exit notice covered. */
+    cancelMiniappExit(packageName: string): void;
     /** Report-safe ownership snapshot for incident diagnostics. */
     getDiagnosticSnapshot(): Record<string, unknown>;
     /**
      * A local miniapp is going away. Clean up all state associated with it.
      */
     onUnmount(packageName: string): void;
+    /**
+     * Dashboard cover state. On deactivate the retained main frame repaints
+     * (scenes replay create-based; legacy re-sends), or the glasses clear.
+     */
+    setDashboardActive(active: boolean): void;
+    /** Dashboard renderers only; bypasses arbitration and main ownership state. */
+    renderDashboard(packageName: string, payload: DisplayPayload): void;
     /**
      * A miniapp requested a display. Routes through boot queue, arbitration,
      * and throttle. This is the only public entry point for miniapp display
@@ -120,6 +171,7 @@ declare class LocalDisplayManager {
      */
     private sendScene;
     private sendToNative;
+    private pushToNative;
     private handleExpiry;
     private tryRestoreCoreDisplay;
     private sendClear;

package/build/services/LocalDisplayManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalDisplayManager.d.ts","sourceRoot":"","sources":["../../src/services/LocalDisplayManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LocalDisplayManager.d.ts","sourceRoot":"","sources":["../../src/services/LocalDisplayManager.ts"],"names":[],"mappings":"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"}