@glassly/engine 0.1.0-dev.0

package/build/services/DevServerBridge.js

@@ -0,0 +1,296 @@
+/**
+ * DevServerBridge — phone-side WebSocket connection to a `glassly-miniapp dev`
+ * sidecar running on a developer's laptop.
+ *
+ * Multiplexed over a single WebSocket per dev miniapp:
+ *   laptop → phone : {type: "reload"}                 → trigger WebView.reload()
+ *   phone  → laptop: {type: "log", level, args, ...}  → forwarded console calls
+ *
+ * Lifecycle: `connect(packageName, devUrl, devPort)` is called from
+ * MiniappHost.mountDev once the dev applet is mounted. `disconnect(packageName)`
+ * is called from MiniappHost.unmount. Reconnect with exponential backoff on
+ * unexpected close — the dev server is the developer's laptop and may bounce.
+ *
+ * Outgoing logs are buffered in a small ring while disconnected; flushed on
+ * reconnect. This catches early-startup logs the developer would otherwise
+ * miss when re-launching the dev server.
+ */
+const LOG_TAG = "DEV_SERVER_BRIDGE";
+const PROTOCOL_VERSION = "glassly-dev/1";
+const HELLO_TIMEOUT_MS = 1_000;
+const BACKOFF_MIN_MS = 1_000;
+const BACKOFF_MAX_MS = 30_000;
+const RING_BUFFER_MAX_ENTRIES = 100;
+const RING_BUFFER_MAX_BYTES = 32 * 1024;
+class DevServerBridge {
+    entries = new Map();
+    globalReloadHandler = null;
+    globalRespawnBackgroundHandler = null;
+    /**
+     * Register a global reload handler. MiniappHost calls this once at boot. The
+     * bridge invokes the handler with the offending packageName whenever a
+     * reload signal is received.
+     */
+    onReload(handler) {
+        this.globalReloadHandler = handler;
+    }
+    /**
+     * Register a global background-respawn handler. Fires when the dev
+     * server sends `{type: "respawn-bg"}` — emitted on filesystem changes
+     * under `src/background/`. The host (JSRouter via the
+     * bootstrap) should kill + respawn the JSContext to pick up the
+     * change. WebView reload is separate (see `onReload`).
+     */
+    onRespawnBackground(handler) {
+        this.globalRespawnBackgroundHandler = handler;
+    }
+    /** Clear the background-respawn handler when the miniapp engine is stopped. */
+    clearRespawnBackgroundHandler() {
+        this.globalRespawnBackgroundHandler = null;
+    }
+    /** Open (or re-open) a bridge to the given dev server. */
+    connect(packageName, devHostUrl, devPort) {
+        const url = this.buildWsUrl(devHostUrl, devPort);
+        let entry = this.entries.get(packageName);
+        if (entry) {
+            // Already have an entry; if the URL changed (e.g. LAN IP shifted), close
+            // and rebuild.
+            if (entry.url === url && (entry.state === "connecting" || entry.state === "connected"))
+                return;
+            this.teardownEntry(entry);
+        }
+        entry = {
+            state: "idle",
+            ws: null,
+            url,
+            attempts: 0,
+            ringBuffer: [],
+            ringBytes: 0,
+            reloadHandler: null,
+            reconnectTimer: null,
+        };
+        this.entries.set(packageName, entry);
+        this.openSocket(packageName, entry);
+    }
+    /** Close a bridge for good. Called from MiniappHost.unmount. */
+    disconnect(packageName) {
+        const entry = this.entries.get(packageName);
+        if (!entry)
+            return;
+        entry.state = "closed";
+        this.teardownEntry(entry);
+        this.entries.delete(packageName);
+    }
+    /**
+     * Forward a `log` envelope to the connected dev sidecar. Called from
+     * the JSContext side (`JSRouter.__log` handler) AND the WebView
+     * side (`UIRouter.routeFromWebView` for `type:"log"` frames).
+     *
+     * `source` distinguishes the two halves so the CLI can prefix lines
+     * `[UI]` vs `[GlasslyJS]`. Logs are silently dropped when no bridge
+     * exists for the package (no `glassly-miniapp dev` running) and
+     * buffered in the per-bridge ring while disconnected.
+     */
+    forwardLog(packageName, level, args, timestamp, source) {
+        const entry = this.entries.get(packageName);
+        if (!entry)
+            return;
+        const message = JSON.stringify({ type: "log", level, args, packageName, timestamp, source });
+        if (entry.state === "connected" && entry.ws) {
+            try {
+                entry.ws.send(message);
+                return;
+            }
+            catch {
+                // Fall through to buffer.
+            }
+        }
+        this.bufferLog(entry, { packageName, level, args, timestamp, source, size: message.length });
+    }
+    // -----------------------------------------------------------------------
+    buildWsUrl(devHostUrl, devPort) {
+        let host;
+        try {
+            const parsed = new URL(devHostUrl);
+            host = parsed.hostname;
+        }
+        catch {
+            // devHostUrl might already be just an IP; best-effort.
+            host = devHostUrl
+                .replace(/^https?:\/\//, "")
+                .split(":")[0]
+                .split("/")[0];
+        }
+        return `ws://${host}:${devPort}/__glassly_dev`;
+    }
+    openSocket(packageName, entry) {
+        if (entry.state === "closed")
+            return;
+        entry.state = "connecting";
+        const ws = new WebSocket(entry.url);
+        entry.ws = ws;
+        let helloTimer = null;
+        let helloAcked = false;
+        const teardown = (reason) => {
+            if (helloTimer) {
+                clearTimeout(helloTimer);
+                helloTimer = null;
+            }
+            try {
+                ws.close();
+            }
+            catch {
+                /* ignore */
+            }
+            if (entry.state === "closed")
+                return;
+            entry.state = "disconnected";
+            entry.ws = null;
+            entry.attempts++;
+            console.log(`${LOG_TAG}: ${packageName} disconnected (${reason}); reconnect in ${this.backoffMs(entry.attempts)}ms`);
+            this.scheduleReconnect(packageName, entry);
+        };
+        ws.onopen = () => {
+            // Send hello; wait for hello-ack to confirm we hit the right server.
+            try {
+                ws.send(JSON.stringify({ type: "hello", protocol: PROTOCOL_VERSION }));
+            }
+            catch {
+                teardown("hello send failed");
+                return;
+            }
+            helloTimer = setTimeout(() => {
+                if (!helloAcked) {
+                    teardown("hello-ack timeout");
+                }
+            }, HELLO_TIMEOUT_MS);
+        };
+        ws.onmessage = (ev) => {
+            const data = typeof ev.data === "string" ? ev.data : null;
+            if (!data)
+                return;
+            let parsed = null;
+            try {
+                parsed = JSON.parse(data);
+            }
+            catch {
+                return;
+            }
+            if (!parsed)
+                return;
+            if (parsed.type === "hello-ack") {
+                if (parsed.protocol !== PROTOCOL_VERSION) {
+                    teardown(`protocol mismatch: server sent ${parsed.protocol}, expected ${PROTOCOL_VERSION}`);
+                    return;
+                }
+                helloAcked = true;
+                if (helloTimer) {
+                    clearTimeout(helloTimer);
+                    helloTimer = null;
+                }
+                entry.state = "connected";
+                entry.attempts = 0;
+                console.log(`${LOG_TAG}: ${packageName} connected to ${entry.url}`);
+                this.flushRingBuffer(packageName, entry);
+                return;
+            }
+            if (parsed.type === "reload") {
+                console.log(`${LOG_TAG}: ${packageName} received reload signal`);
+                this.globalReloadHandler?.(packageName);
+                return;
+            }
+            // Two-layer dev signal: filesystem changes under src/background/
+            // trigger a full JSContext kill + respawn (not just a WebView
+            // reload). The host's JSRouter listens here.
+            if (parsed.type === "respawn-bg") {
+                console.log(`${LOG_TAG}: ${packageName} received respawn-bg signal`);
+                this.globalRespawnBackgroundHandler?.(packageName);
+                return;
+            }
+        };
+        ws.onerror = () => {
+            // onclose follows; defer all teardown to that path so we don't double-fire.
+        };
+        ws.onclose = () => {
+            teardown(helloAcked ? "ws closed" : "ws closed before hello-ack");
+        };
+    }
+    scheduleReconnect(packageName, entry) {
+        if (entry.state === "closed")
+            return;
+        if (entry.reconnectTimer)
+            clearTimeout(entry.reconnectTimer);
+        const delay = this.backoffMs(entry.attempts);
+        entry.reconnectTimer = setTimeout(() => {
+            entry.reconnectTimer = null;
+            // Verify still alive and still in the bridge map.
+            const current = this.entries.get(packageName);
+            if (!current || current !== entry || entry.state === "closed")
+                return;
+            this.openSocket(packageName, entry);
+        }, delay);
+    }
+    backoffMs(attempts) {
+        const exp = Math.min(BACKOFF_MAX_MS, BACKOFF_MIN_MS * Math.pow(2, Math.max(0, attempts - 1)));
+        const jitter = exp * (0.8 + Math.random() * 0.4);
+        return Math.round(jitter);
+    }
+    bufferLog(entry, log) {
+        entry.ringBuffer.push(log);
+        entry.ringBytes += log.size;
+        while (entry.ringBuffer.length > RING_BUFFER_MAX_ENTRIES || entry.ringBytes > RING_BUFFER_MAX_BYTES) {
+            const dropped = entry.ringBuffer.shift();
+            if (dropped)
+                entry.ringBytes -= dropped.size;
+            if (entry.ringBuffer.length === 0) {
+                entry.ringBytes = 0;
+                break;
+            }
+        }
+    }
+    flushRingBuffer(packageName, entry) {
+        if (entry.ringBuffer.length === 0)
+            return;
+        const buffered = entry.ringBuffer;
+        entry.ringBuffer = [];
+        entry.ringBytes = 0;
+        if (!entry.ws)
+            return;
+        for (const log of buffered) {
+            try {
+                entry.ws.send(JSON.stringify({
+                    type: "log",
+                    level: log.level,
+                    args: log.args,
+                    packageName: log.packageName,
+                    timestamp: log.timestamp,
+                    source: log.source,
+                }));
+            }
+            catch {
+                // Re-buffer on failure and bail.
+                entry.ringBuffer.unshift(log);
+                entry.ringBytes += log.size;
+                return;
+            }
+        }
+    }
+    teardownEntry(entry) {
+        if (entry.reconnectTimer) {
+            clearTimeout(entry.reconnectTimer);
+            entry.reconnectTimer = null;
+        }
+        if (entry.ws) {
+            try {
+                entry.ws.close();
+            }
+            catch {
+                /* ignore */
+            }
+            entry.ws = null;
+        }
+    }
+}
+const devServerBridge = new DevServerBridge();
+export default devServerBridge;
+//# sourceMappingURL=DevServerBridge.js.map

package/build/services/DevServerBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServerBridge.js","sourceRoot":"","sources":["../../src/services/DevServerBridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DevServerBridge — phone-side WebSocket connection to a `glassly-miniapp dev`\n * sidecar running on a developer's laptop.\n *\n * Multiplexed over a single WebSocket per dev miniapp:\n *   laptop → phone : {type: \"reload\"}                 → trigger WebView.reload()\n *   phone  → laptop: {type: \"log\", level, args, ...}  → forwarded console calls\n *\n * Lifecycle: `connect(packageName, devUrl, devPort)` is called from\n * MiniappHost.mountDev once the dev applet is mounted. `disconnect(packageName)`\n * is called from MiniappHost.unmount. Reconnect with exponential backoff on\n * unexpected close — the dev server is the developer's laptop and may bounce.\n *\n * Outgoing logs are buffered in a small ring while disconnected; flushed on\n * reconnect. This catches early-startup logs the developer would otherwise\n * miss when re-launching the dev server.\n */\n\nconst LOG_TAG = \"DEV_SERVER_BRIDGE\"\nconst PROTOCOL_VERSION = \"glassly-dev/1\"\nconst HELLO_TIMEOUT_MS = 1_000\nconst BACKOFF_MIN_MS = 1_000\nconst BACKOFF_MAX_MS = 30_000\nconst RING_BUFFER_MAX_ENTRIES = 100\nconst RING_BUFFER_MAX_BYTES = 32 * 1024\n\ntype State = \"idle\" | \"connecting\" | \"connected\" | \"disconnected\" | \"closed\"\n\ninterface BufferedLog {\n  packageName: string\n  level: string\n  args: unknown[]\n  timestamp: number\n  /** \"ui\" = WebView, \"background\" = JSContext. Stamped at capture time. */\n  source: \"ui\" | \"background\"\n  size: number\n}\n\ninterface BridgeEntry {\n  state: State\n  ws: WebSocket | null\n  url: string\n  attempts: number\n  ringBuffer: BufferedLog[]\n  ringBytes: number\n  reloadHandler: ((packageName: string) => void) | null\n  reconnectTimer: ReturnType<typeof setTimeout> | null\n}\n\nclass DevServerBridge {\n  private entries = new Map<string, BridgeEntry>()\n  private globalReloadHandler: ((packageName: string) => void) | null = null\n  private globalRespawnBackgroundHandler: ((packageName: string) => void) | null = null\n\n  /**\n   * Register a global reload handler. MiniappHost calls this once at boot. The\n   * bridge invokes the handler with the offending packageName whenever a\n   * reload signal is received.\n   */\n  public onReload(handler: (packageName: string) => void): void {\n    this.globalReloadHandler = handler\n  }\n\n  /**\n   * Register a global background-respawn handler. Fires when the dev\n   * server sends `{type: \"respawn-bg\"}` — emitted on filesystem changes\n   * under `src/background/`. The host (JSRouter via the\n   * bootstrap) should kill + respawn the JSContext to pick up the\n   * change. WebView reload is separate (see `onReload`).\n   */\n  public onRespawnBackground(handler: ((packageName: string) => void) | null): void {\n    this.globalRespawnBackgroundHandler = handler\n  }\n\n  /** Clear the background-respawn handler when the miniapp engine is stopped. */\n  public clearRespawnBackgroundHandler(): void {\n    this.globalRespawnBackgroundHandler = null\n  }\n\n  /** Open (or re-open) a bridge to the given dev server. */\n  public connect(packageName: string, devHostUrl: string, devPort: number): void {\n    const url = this.buildWsUrl(devHostUrl, devPort)\n    let entry = this.entries.get(packageName)\n    if (entry) {\n      // Already have an entry; if the URL changed (e.g. LAN IP shifted), close\n      // and rebuild.\n      if (entry.url === url && (entry.state === \"connecting\" || entry.state === \"connected\")) return\n      this.teardownEntry(entry)\n    }\n    entry = {\n      state: \"idle\",\n      ws: null,\n      url,\n      attempts: 0,\n      ringBuffer: [],\n      ringBytes: 0,\n      reloadHandler: null,\n      reconnectTimer: null,\n    }\n    this.entries.set(packageName, entry)\n    this.openSocket(packageName, entry)\n  }\n\n  /** Close a bridge for good. Called from MiniappHost.unmount. */\n  public disconnect(packageName: string): void {\n    const entry = this.entries.get(packageName)\n    if (!entry) return\n    entry.state = \"closed\"\n    this.teardownEntry(entry)\n    this.entries.delete(packageName)\n  }\n\n  /**\n   * Forward a `log` envelope to the connected dev sidecar. Called from\n   * the JSContext side (`JSRouter.__log` handler) AND the WebView\n   * side (`UIRouter.routeFromWebView` for `type:\"log\"` frames).\n   *\n   * `source` distinguishes the two halves so the CLI can prefix lines\n   * `[UI]` vs `[GlasslyJS]`. Logs are silently dropped when no bridge\n   * exists for the package (no `glassly-miniapp dev` running) and\n   * buffered in the per-bridge ring while disconnected.\n   */\n  public forwardLog(\n    packageName: string,\n    level: string,\n    args: unknown[],\n    timestamp: number,\n    source: \"ui\" | \"background\",\n  ): void {\n    const entry = this.entries.get(packageName)\n    if (!entry) return\n    const message = JSON.stringify({type: \"log\", level, args, packageName, timestamp, source})\n    if (entry.state === \"connected\" && entry.ws) {\n      try {\n        entry.ws.send(message)\n        return\n      } catch {\n        // Fall through to buffer.\n      }\n    }\n    this.bufferLog(entry, {packageName, level, args, timestamp, source, size: message.length})\n  }\n\n  // -----------------------------------------------------------------------\n\n  private buildWsUrl(devHostUrl: string, devPort: number): string {\n    let host: string\n    try {\n      const parsed = new URL(devHostUrl)\n      host = parsed.hostname\n    } catch {\n      // devHostUrl might already be just an IP; best-effort.\n      host = devHostUrl\n        .replace(/^https?:\\/\\//, \"\")\n        .split(\":\")[0]\n        .split(\"/\")[0]\n    }\n    return `ws://${host}:${devPort}/__glassly_dev`\n  }\n\n  private openSocket(packageName: string, entry: BridgeEntry): void {\n    if (entry.state === \"closed\") return\n    entry.state = \"connecting\"\n    const ws = new WebSocket(entry.url)\n    entry.ws = ws\n\n    let helloTimer: ReturnType<typeof setTimeout> | null = null\n    let helloAcked = false\n\n    const teardown = (reason: string): void => {\n      if (helloTimer) {\n        clearTimeout(helloTimer)\n        helloTimer = null\n      }\n      try {\n        ws.close()\n      } catch {\n        /* ignore */\n      }\n      if (entry.state === \"closed\") return\n      entry.state = \"disconnected\"\n      entry.ws = null\n      entry.attempts++\n      console.log(\n        `${LOG_TAG}: ${packageName} disconnected (${reason}); reconnect in ${this.backoffMs(entry.attempts)}ms`,\n      )\n      this.scheduleReconnect(packageName, entry)\n    }\n\n    ws.onopen = () => {\n      // Send hello; wait for hello-ack to confirm we hit the right server.\n      try {\n        ws.send(JSON.stringify({type: \"hello\", protocol: PROTOCOL_VERSION}))\n      } catch {\n        teardown(\"hello send failed\")\n        return\n      }\n      helloTimer = setTimeout(() => {\n        if (!helloAcked) {\n          teardown(\"hello-ack timeout\")\n        }\n      }, HELLO_TIMEOUT_MS)\n    }\n\n    ws.onmessage = (ev) => {\n      const data = typeof ev.data === \"string\" ? ev.data : null\n      if (!data) return\n      let parsed: {type?: string; protocol?: string} | null = null\n      try {\n        parsed = JSON.parse(data)\n      } catch {\n        return\n      }\n      if (!parsed) return\n\n      if (parsed.type === \"hello-ack\") {\n        if (parsed.protocol !== PROTOCOL_VERSION) {\n          teardown(`protocol mismatch: server sent ${parsed.protocol}, expected ${PROTOCOL_VERSION}`)\n          return\n        }\n        helloAcked = true\n        if (helloTimer) {\n          clearTimeout(helloTimer)\n          helloTimer = null\n        }\n        entry.state = \"connected\"\n        entry.attempts = 0\n        console.log(`${LOG_TAG}: ${packageName} connected to ${entry.url}`)\n        this.flushRingBuffer(packageName, entry)\n        return\n      }\n\n      if (parsed.type === \"reload\") {\n        console.log(`${LOG_TAG}: ${packageName} received reload signal`)\n        this.globalReloadHandler?.(packageName)\n        return\n      }\n\n      // Two-layer dev signal: filesystem changes under src/background/\n      // trigger a full JSContext kill + respawn (not just a WebView\n      // reload). The host's JSRouter listens here.\n      if (parsed.type === \"respawn-bg\") {\n        console.log(`${LOG_TAG}: ${packageName} received respawn-bg signal`)\n        this.globalRespawnBackgroundHandler?.(packageName)\n        return\n      }\n    }\n\n    ws.onerror = () => {\n      // onclose follows; defer all teardown to that path so we don't double-fire.\n    }\n\n    ws.onclose = () => {\n      teardown(helloAcked ? \"ws closed\" : \"ws closed before hello-ack\")\n    }\n  }\n\n  private scheduleReconnect(packageName: string, entry: BridgeEntry): void {\n    if (entry.state === \"closed\") return\n    if (entry.reconnectTimer) clearTimeout(entry.reconnectTimer)\n    const delay = this.backoffMs(entry.attempts)\n    entry.reconnectTimer = setTimeout(() => {\n      entry.reconnectTimer = null\n      // Verify still alive and still in the bridge map.\n      const current = this.entries.get(packageName)\n      if (!current || current !== entry || entry.state === \"closed\") return\n      this.openSocket(packageName, entry)\n    }, delay)\n  }\n\n  private backoffMs(attempts: number): number {\n    const exp = Math.min(BACKOFF_MAX_MS, BACKOFF_MIN_MS * Math.pow(2, Math.max(0, attempts - 1)))\n    const jitter = exp * (0.8 + Math.random() * 0.4)\n    return Math.round(jitter)\n  }\n\n  private bufferLog(entry: BridgeEntry, log: BufferedLog): void {\n    entry.ringBuffer.push(log)\n    entry.ringBytes += log.size\n    while (entry.ringBuffer.length > RING_BUFFER_MAX_ENTRIES || entry.ringBytes > RING_BUFFER_MAX_BYTES) {\n      const dropped = entry.ringBuffer.shift()\n      if (dropped) entry.ringBytes -= dropped.size\n      if (entry.ringBuffer.length === 0) {\n        entry.ringBytes = 0\n        break\n      }\n    }\n  }\n\n  private flushRingBuffer(packageName: string, entry: BridgeEntry): void {\n    if (entry.ringBuffer.length === 0) return\n    const buffered = entry.ringBuffer\n    entry.ringBuffer = []\n    entry.ringBytes = 0\n    if (!entry.ws) return\n    for (const log of buffered) {\n      try {\n        entry.ws.send(\n          JSON.stringify({\n            type: \"log\",\n            level: log.level,\n            args: log.args,\n            packageName: log.packageName,\n            timestamp: log.timestamp,\n            source: log.source,\n          }),\n        )\n      } catch {\n        // Re-buffer on failure and bail.\n        entry.ringBuffer.unshift(log)\n        entry.ringBytes += log.size\n        return\n      }\n    }\n  }\n\n  private teardownEntry(entry: BridgeEntry): void {\n    if (entry.reconnectTimer) {\n      clearTimeout(entry.reconnectTimer)\n      entry.reconnectTimer = null\n    }\n    if (entry.ws) {\n      try {\n        entry.ws.close()\n      } catch {\n        /* ignore */\n      }\n      entry.ws = null\n    }\n  }\n}\n\nconst devServerBridge = new DevServerBridge()\nexport default devServerBridge\n"]}

package/build/services/DeviceEventRouter.d.ts

@@ -0,0 +1,3 @@
+export declare function startDeviceEventRouter(): void;
+export declare function stopDeviceEventRouter(): void;
+//# sourceMappingURL=DeviceEventRouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceEventRouter.d.ts","sourceRoot":"","sources":["../../src/services/DeviceEventRouter.ts"],"names":[],"mappings":"AAqCA,wBAAgB,sBAAsB,IAAI,IAAI,CA+N7C;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/build/services/DeviceEventRouter.js

@@ -0,0 +1,214 @@
+/**
+ * Device-event router — engine-owned. Subscribes to the inbound native BLE/device
+ * events and routes them into the engine runtime: device stores, the process event
+ * bus, the photo/stream coordinators, and local miniapps (via forwardEvent).
+ *
+ * Why this exists: engine owns the stores, coordinators, miniapp runtime, and facades,
+ * but it never *subscribed to the device* for most events — the host MantleManager was
+ * still the event router the whole runtime secretly depended on. So a bare OEM that
+ * imported engine + called engine.start() got a connected runtime with almost no device
+ * data flowing in (no miniapp input, dead gallery sync, starved coordinators). This
+ * service moves those inbound bridges into engine so ANY host gets them.
+ *
+ * Scope: the engine legs only. The Cloud V1 relays that used to live beside them in
+ * MantleManager (touch→cloud, the cloud-SDK stream/photo legs, etc.) were deleted with
+ * Cloud V1 app end-of-life.
+ *
+ * Started by `engine.start()`. Idempotent.
+ */
+import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import { shallow } from "zustand/shallow";
+import localMiniappRuntime from "./LocalMiniappRuntime";
+import localSttFallbackCoordinator from "./LocalSttFallbackCoordinator";
+import nativeNavigationService from "./NativeNavigationService";
+import speakerLabelResolver from "./SpeakerLabelResolver";
+import { phonePhotoCoordinator } from "./PhonePhotoCoordinator";
+import { phoneStreamCoordinator } from "./PhoneStreamCoordinator";
+import { isGlassesConnected } from "./GlassesReadiness";
+import { useGlassesStore } from "../stores/glasses";
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { useAppStatusStore } from "../stores/apps";
+import { retirePendingSelectionOnPromotion } from "./PairingIdentity";
+import GlobalEventEmitter from "../utils/GlobalEventEmitter";
+import { asgCameraApi } from "./asg/asgCameraApi";
+let subs = [];
+export function startDeviceEventRouter() {
+    if (subs.length)
+        return;
+    // --- device state → engine stores ---
+    // Standalone WiFi status → glasses store.
+    subs.push(BluetoothSdk.addListener("wifi_status_change", (event) => {
+        const { type: _type, ...wifi } = event;
+        useGlassesStore.getState().setGlassesInfo({ wifi });
+    }));
+    // Forward glasses Wi-Fi to miniapps (session.glasses.onWifi) from the STORE — the
+    // single source of truth — so every path converges here: wifi_status_change,
+    // onGlassesStatus, and BLE disconnect. Effective connectivity requires the glasses
+    // to be connected AND on Wi-Fi, so a disconnect correctly flips `connected` false.
+    subs.push({
+        remove: useGlassesStore.subscribe((s) => {
+            const connected = isGlassesConnected(s.connection) && s.wifi.state === "connected";
+            return {
+                connected,
+                ssid: s.wifi.state === "connected" ? s.wifi.ssid : undefined,
+                localIp: s.wifi.state === "connected" ? s.wifi.localIp : undefined,
+            };
+        }, (wifi) => localMiniappRuntime.forwardEvent("glasses_wifi", wifi), { equalityFn: shallow }),
+    });
+    // Incremental battery status → glasses store + local miniapps.
+    subs.push(BluetoothSdk.addListener("battery_status", (event) => {
+        const state = useGlassesStore.getState();
+        state.setBatteryInfo(event.level, event.charging, state.caseBatteryLevel, state.caseCharging);
+        localMiniappRuntime.forwardEvent("glasses_battery_update", {
+            type: "glasses_battery_update",
+            level: event.level,
+            charging: event.charging,
+            timestamp: event.timestamp ?? Date.now(),
+        });
+    }));
+    // Hotspot status → glasses store + event bus. engine's own gallerySyncService listens
+    // on the bus for these, so without this bridge engine's gallery sync is dead.
+    subs.push(BluetoothSdk.addListener("hotspot_status_change", (event) => {
+        const enabled = event.state === "enabled";
+        const ssid = enabled ? event.ssid : "";
+        const password = enabled ? event.password : "";
+        const localIp = enabled ? event.localIp : "";
+        useGlassesStore.getState().setHotspotInfo(enabled, ssid, password, localIp);
+        // Always retarget the ASG camera client: on disable (or an event with no
+        // IP) fall back to the localhost default so later calls fail fast instead
+        // of hitting the previous network's stale glasses IP.
+        asgCameraApi.setServer(localIp || "localhost", 8089);
+        GlobalEventEmitter.emit("hotspot_status_change", { enabled, ssid, password, local_ip: localIp });
+    }));
+    subs.push(BluetoothSdk.addListener("hotspot_error", (event) => {
+        GlobalEventEmitter.emit("hotspot_error", { error_message: event.errorMessage, timestamp: event.timestamp });
+    }));
+    // Glasses gallery content counts → event bus (consumed by gallerySyncService).
+    subs.push(BluetoothSdk.addListener("gallery_status", (event) => {
+        GlobalEventEmitter.emit("gallery_status", {
+            photos: event.photos,
+            videos: event.videos,
+            total: event.total,
+            has_content: event.hasContent,
+            camera_busy: event.cameraBusy,
+        });
+    }));
+    // Hardware-originated setting changes (user changes a setting ON the glasses) → store.
+    // The inbound complement to GlassesSettingsSync (which only pushes store→device).
+    subs.push(BluetoothSdk.addListener("save_setting", async (event) => {
+        const settings = useSettingsStore.getState();
+        // Damp the relay: native re-echoes some settings unconditionally (e.g.
+        // the identity block at every handleDeviceReady) — a same-value echo
+        // must not become a store write (persistence churn + change-push noise).
+        if (settings.getSetting(event.key) !== event.value) {
+            await settings.setSetting(event.key, event.value);
+        }
+        // Two-phase identity: a promoted default retires the pending selection
+        // marker. The rule lives with PairingIdentity (a no-op for other keys).
+        await retirePendingSelectionOnPromotion(event.key, event.value);
+    }));
+    // --- coordinators (owns()-gated) ---
+    // Phone-owned photo errors settle the in-flight long-poll fast (vs. timeout).
+    // Non-owned photo responses used to forward to the Cloud V1 photo pipeline via
+    // restComms; that relay was removed with Cloud V1 app end-of-life, so they drop.
+    // Wire v2 sends a short 4-hex BLE requestId; the coordinator maps it back to
+    // the cloud requestId (resolveCloudRequestId) before ownership checks.
+    subs.push(BluetoothSdk.addListener("photo_response", (event) => {
+        const cloudRequestId = event.requestId ? phonePhotoCoordinator.resolveCloudRequestId(event.requestId) : "";
+        if (cloudRequestId && phonePhotoCoordinator.owns(cloudRequestId)) {
+            if (event.state === "error") {
+                phonePhotoCoordinator.handlePhotoError(event.requestId ?? cloudRequestId, event.errorCode ?? "GLASSES_ERROR", event.errorMessage ?? "Glasses reported an error");
+            }
+        }
+    }));
+    // Phone-owned stream status / keep-alive → the stream coordinator. The Cloud V1 relay
+    // for non-owned streams was removed with Cloud V1 app end-of-life.
+    subs.push(BluetoothSdk.addListener("stream_status", (event) => {
+        if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {
+            phoneStreamCoordinator.handleGlassesStatus(event);
+        }
+    }));
+    subs.push(BluetoothSdk.addListener("keep_alive_ack", (event) => {
+        if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {
+            phoneStreamCoordinator.handleKeepAliveAck(event);
+        }
+    }));
+    // --- device input → local miniapps (forwardEvent is subscriber-gated; a no-op when
+    // no miniapp listens). The v1 SocketComms cloud legs for these were removed with
+    // the Cloud V1 ripout. ---
+    subs.push(BluetoothSdk.addListener("button_press", (event) => {
+        localMiniappRuntime.forwardEvent("button_press", event);
+    }));
+    subs.push(BluetoothSdk.addListener("touch_event", (event) => {
+        localMiniappRuntime.forwardEvent("touch_event", event);
+        // Double-tap policy, moved out of the native G2 handlers: open the native
+        // dashboard when the setting is on, else toggle head-up. Native only
+        // reports the gesture now.
+        if (event.gestureName === "double_tap") {
+            const useNativeDashboard = useSettingsStore.getState().getSetting(SETTINGS.use_native_dashboard.key) !== false;
+            if (useNativeDashboard) {
+                // The modal nav UI owns the screen; showDashboard would fight it.
+                if (!nativeNavigationService.isActive) {
+                    void Promise.resolve(BluetoothSdk.showDashboard()).catch((err) => {
+                        console.error("DeviceEventRouter: showDashboard failed:", err);
+                    });
+                }
+            }
+            else {
+                void Promise.resolve(BluetoothSdk.toggleHeadUp()).catch((err) => {
+                    console.error("DeviceEventRouter: toggleHeadUp failed:", err);
+                });
+            }
+        }
+    }));
+    // G2 IMU accelerometer — payload already matches the miniapp AccelData shape.
+    subs.push(BluetoothSdk.addListener("accel_event", (event) => {
+        localMiniappRuntime.forwardEvent("accel_event", {
+            x: event.x,
+            y: event.y,
+            z: event.z,
+            timestamp: typeof event.timestamp === "number" ? event.timestamp : Date.now(),
+        });
+    }));
+    // Head position — translate native {up:boolean} → SDK {position:"up"|"down"}.
+    subs.push(BluetoothSdk.addListener("head_up", (event) => {
+        localMiniappRuntime.forwardEvent("head_up", { position: event.up ? "up" : "down", timestamp: Date.now() });
+    }));
+    // On-device STT transcripts → local miniapps only while the local engine is
+    // active (cloud fallback or an explicit forceLocal subscription). The runtime
+    // filters mixed local/cloud delivery per miniapp to avoid double-delivery.
+    // forwardEvent is subscriber-gated — a no-op when no miniapp listens.
+    // (Was MantleManager.handle_local_transcription; its offline-captions display branch
+    // went away with the pseudo captions renderer.)
+    subs.push(BluetoothSdk.addListener("local_transcription", (event) => {
+        if (!localSttFallbackCoordinator.isActive())
+            return;
+        const lang = event.transcribeLanguage ?? localSttFallbackCoordinator.getActiveLanguage() ?? "en-US";
+        // Native stamps resolvedSpeakerId when the voice matched the enrolled
+        // profile; surface that as `isUser` (the native join has no
+        // confident-other signal, so unmatched stays unannotated).
+        localMiniappRuntime.forwardEvent(`transcription:${lang}`, speakerLabelResolver.annotateLocalTranscript(event), "local");
+    }));
+    // --- glasses swipe-menu app launcher (G2) ---
+    subs.push(BluetoothSdk.addListener("miniapp_selected", (event) => {
+        const packageName = event.packageName;
+        if (!packageName)
+            return;
+        const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName);
+        if (!app)
+            return;
+        // Toggle: stop if running, else start.
+        if (app.running) {
+            useAppStatusStore.getState().stop(packageName);
+        }
+        else {
+            useAppStatusStore.getState().start(app, { skipNavigation: true });
+        }
+    }));
+}
+export function stopDeviceEventRouter() {
+    for (const sub of subs)
+        sub.remove();
+    subs = [];
+}
+//# sourceMappingURL=DeviceEventRouter.js.map

package/build/services/DeviceEventRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceEventRouter.js","sourceRoot":"","sources":["../../src/services/DeviceEventRouter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Device-event router — engine-owned. Subscribes to the inbound native BLE/device\n * events and routes them into the engine runtime: device stores, the process event\n * bus, the photo/stream coordinators, and local miniapps (via forwardEvent).\n *\n * Why this exists: engine owns the stores, coordinators, miniapp runtime, and facades,\n * but it never *subscribed to the device* for most events — the host MantleManager was\n * still the event router the whole runtime secretly depended on. So a bare OEM that\n * imported engine + called engine.start() got a connected runtime with almost no device\n * data flowing in (no miniapp input, dead gallery sync, starved coordinators). This\n * service moves those inbound bridges into engine so ANY host gets them.\n *\n * Scope: the engine legs only. The Cloud V1 relays that used to live beside them in\n * MantleManager (touch→cloud, the cloud-SDK stream/photo legs, etc.) were deleted with\n * Cloud V1 app end-of-life.\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {shallow} from \"zustand/shallow\"\n\nimport localMiniappRuntime from \"./LocalMiniappRuntime\"\nimport localSttFallbackCoordinator from \"./LocalSttFallbackCoordinator\"\nimport nativeNavigationService from \"./NativeNavigationService\"\nimport speakerLabelResolver from \"./SpeakerLabelResolver\"\nimport {phonePhotoCoordinator} from \"./PhonePhotoCoordinator\"\nimport {phoneStreamCoordinator} from \"./PhoneStreamCoordinator\"\nimport {isGlassesConnected} from \"./GlassesReadiness\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {retirePendingSelectionOnPromotion} from \"./PairingIdentity\"\nimport GlobalEventEmitter from \"../utils/GlobalEventEmitter\"\nimport {asgCameraApi} from \"./asg/asgCameraApi\"\n\nlet subs: Array<{remove: () => void}> = []\n\nexport function startDeviceEventRouter(): void {\n  if (subs.length) return\n\n  // --- device state → engine stores ---\n\n  // Standalone WiFi status → glasses store.\n  subs.push(\n    BluetoothSdk.addListener(\"wifi_status_change\", (event) => {\n      const {type: _type, ...wifi} = event\n      useGlassesStore.getState().setGlassesInfo({wifi})\n    }),\n  )\n\n  // Forward glasses Wi-Fi to miniapps (session.glasses.onWifi) from the STORE — the\n  // single source of truth — so every path converges here: wifi_status_change,\n  // onGlassesStatus, and BLE disconnect. Effective connectivity requires the glasses\n  // to be connected AND on Wi-Fi, so a disconnect correctly flips `connected` false.\n  subs.push({\n    remove: useGlassesStore.subscribe(\n      (s) => {\n        const connected = isGlassesConnected(s.connection) && s.wifi.state === \"connected\"\n        return {\n          connected,\n          ssid: s.wifi.state === \"connected\" ? s.wifi.ssid : undefined,\n          localIp: s.wifi.state === \"connected\" ? s.wifi.localIp : undefined,\n        }\n      },\n      (wifi) => localMiniappRuntime.forwardEvent(\"glasses_wifi\", wifi),\n      {equalityFn: shallow},\n    ),\n  })\n\n  // Incremental battery status → glasses store + local miniapps.\n  subs.push(\n    BluetoothSdk.addListener(\"battery_status\", (event) => {\n      const state = useGlassesStore.getState()\n      state.setBatteryInfo(event.level, event.charging, state.caseBatteryLevel, state.caseCharging)\n      localMiniappRuntime.forwardEvent(\"glasses_battery_update\", {\n        type: \"glasses_battery_update\",\n        level: event.level,\n        charging: event.charging,\n        timestamp: event.timestamp ?? Date.now(),\n      })\n    }),\n  )\n\n  // Hotspot status → glasses store + event bus. engine's own gallerySyncService listens\n  // on the bus for these, so without this bridge engine's gallery sync is dead.\n  subs.push(\n    BluetoothSdk.addListener(\"hotspot_status_change\", (event) => {\n      const enabled = event.state === \"enabled\"\n      const ssid = enabled ? event.ssid : \"\"\n      const password = enabled ? event.password : \"\"\n      const localIp = enabled ? event.localIp : \"\"\n      useGlassesStore.getState().setHotspotInfo(enabled, ssid, password, localIp)\n      // Always retarget the ASG camera client: on disable (or an event with no\n      // IP) fall back to the localhost default so later calls fail fast instead\n      // of hitting the previous network's stale glasses IP.\n      asgCameraApi.setServer(localIp || \"localhost\", 8089)\n      GlobalEventEmitter.emit(\"hotspot_status_change\", {enabled, ssid, password, local_ip: localIp})\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"hotspot_error\", (event) => {\n      GlobalEventEmitter.emit(\"hotspot_error\", {error_message: event.errorMessage, timestamp: event.timestamp})\n    }),\n  )\n\n  // Glasses gallery content counts → event bus (consumed by gallerySyncService).\n  subs.push(\n    BluetoothSdk.addListener(\"gallery_status\", (event) => {\n      GlobalEventEmitter.emit(\"gallery_status\", {\n        photos: event.photos,\n        videos: event.videos,\n        total: event.total,\n        has_content: event.hasContent,\n        camera_busy: event.cameraBusy,\n      })\n    }),\n  )\n\n  // Hardware-originated setting changes (user changes a setting ON the glasses) → store.\n  // The inbound complement to GlassesSettingsSync (which only pushes store→device).\n  subs.push(\n    BluetoothSdk.addListener(\"save_setting\", async (event) => {\n      const settings = useSettingsStore.getState()\n      // Damp the relay: native re-echoes some settings unconditionally (e.g.\n      // the identity block at every handleDeviceReady) — a same-value echo\n      // must not become a store write (persistence churn + change-push noise).\n      if (settings.getSetting(event.key) !== event.value) {\n        await settings.setSetting(event.key, event.value)\n      }\n      // Two-phase identity: a promoted default retires the pending selection\n      // marker. The rule lives with PairingIdentity (a no-op for other keys).\n      await retirePendingSelectionOnPromotion(event.key, event.value)\n    }),\n  )\n\n  // --- coordinators (owns()-gated) ---\n\n  // Phone-owned photo errors settle the in-flight long-poll fast (vs. timeout).\n  // Non-owned photo responses used to forward to the Cloud V1 photo pipeline via\n  // restComms; that relay was removed with Cloud V1 app end-of-life, so they drop.\n  // Wire v2 sends a short 4-hex BLE requestId; the coordinator maps it back to\n  // the cloud requestId (resolveCloudRequestId) before ownership checks.\n  subs.push(\n    BluetoothSdk.addListener(\"photo_response\", (event) => {\n      const cloudRequestId = event.requestId ? phonePhotoCoordinator.resolveCloudRequestId(event.requestId) : \"\"\n      if (cloudRequestId && phonePhotoCoordinator.owns(cloudRequestId)) {\n        if (event.state === \"error\") {\n          phonePhotoCoordinator.handlePhotoError(\n            event.requestId ?? cloudRequestId,\n            event.errorCode ?? \"GLASSES_ERROR\",\n            event.errorMessage ?? \"Glasses reported an error\",\n          )\n        }\n      }\n    }),\n  )\n\n  // Phone-owned stream status / keep-alive → the stream coordinator. The Cloud V1 relay\n  // for non-owned streams was removed with Cloud V1 app end-of-life.\n  subs.push(\n    BluetoothSdk.addListener(\"stream_status\", (event) => {\n      if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {\n        phoneStreamCoordinator.handleGlassesStatus(event)\n      }\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"keep_alive_ack\", (event) => {\n      if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {\n        phoneStreamCoordinator.handleKeepAliveAck(event)\n      }\n    }),\n  )\n\n  // --- device input → local miniapps (forwardEvent is subscriber-gated; a no-op when\n  // no miniapp listens). The v1 SocketComms cloud legs for these were removed with\n  // the Cloud V1 ripout. ---\n\n  subs.push(\n    BluetoothSdk.addListener(\"button_press\", (event) => {\n      localMiniappRuntime.forwardEvent(\"button_press\", event)\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"touch_event\", (event) => {\n      localMiniappRuntime.forwardEvent(\"touch_event\", event)\n      // Double-tap policy, moved out of the native G2 handlers: open the native\n      // dashboard when the setting is on, else toggle head-up. Native only\n      // reports the gesture now.\n      if (event.gestureName === \"double_tap\") {\n        const useNativeDashboard =\n          useSettingsStore.getState().getSetting(SETTINGS.use_native_dashboard.key) !== false\n        if (useNativeDashboard) {\n          // The modal nav UI owns the screen; showDashboard would fight it.\n          if (!nativeNavigationService.isActive) {\n            void Promise.resolve(BluetoothSdk.showDashboard()).catch((err) => {\n              console.error(\"DeviceEventRouter: showDashboard failed:\", err)\n            })\n          }\n        } else {\n          void Promise.resolve(BluetoothSdk.toggleHeadUp()).catch((err) => {\n            console.error(\"DeviceEventRouter: toggleHeadUp failed:\", err)\n          })\n        }\n      }\n    }),\n  )\n  // G2 IMU accelerometer — payload already matches the miniapp AccelData shape.\n  subs.push(\n    BluetoothSdk.addListener(\"accel_event\", (event) => {\n      localMiniappRuntime.forwardEvent(\"accel_event\", {\n        x: event.x,\n        y: event.y,\n        z: event.z,\n        timestamp: typeof event.timestamp === \"number\" ? event.timestamp : Date.now(),\n      })\n    }),\n  )\n  // Head position — translate native {up:boolean} → SDK {position:\"up\"|\"down\"}.\n  subs.push(\n    BluetoothSdk.addListener(\"head_up\", (event) => {\n      localMiniappRuntime.forwardEvent(\"head_up\", {position: event.up ? \"up\" : \"down\", timestamp: Date.now()})\n    }),\n  )\n  // On-device STT transcripts → local miniapps only while the local engine is\n  // active (cloud fallback or an explicit forceLocal subscription). The runtime\n  // filters mixed local/cloud delivery per miniapp to avoid double-delivery.\n  // forwardEvent is subscriber-gated — a no-op when no miniapp listens.\n  // (Was MantleManager.handle_local_transcription; its offline-captions display branch\n  // went away with the pseudo captions renderer.)\n  subs.push(\n    BluetoothSdk.addListener(\"local_transcription\", (event) => {\n      if (!localSttFallbackCoordinator.isActive()) return\n      const lang = event.transcribeLanguage ?? localSttFallbackCoordinator.getActiveLanguage() ?? \"en-US\"\n      // Native stamps resolvedSpeakerId when the voice matched the enrolled\n      // profile; surface that as `isUser` (the native join has no\n      // confident-other signal, so unmatched stays unannotated).\n      localMiniappRuntime.forwardEvent(\n        `transcription:${lang}`,\n        speakerLabelResolver.annotateLocalTranscript(event),\n        \"local\",\n      )\n    }),\n  )\n\n  // --- glasses swipe-menu app launcher (G2) ---\n  subs.push(\n    BluetoothSdk.addListener(\"miniapp_selected\", (event) => {\n      const packageName = event.packageName as string\n      if (!packageName) return\n      const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName)\n      if (!app) return\n      // Toggle: stop if running, else start.\n      if (app.running) {\n        useAppStatusStore.getState().stop(packageName)\n      } else {\n        useAppStatusStore.getState().start(app, {skipNavigation: true})\n      }\n    }),\n  )\n}\n\nexport function stopDeviceEventRouter(): void {\n  for (const sub of subs) sub.remove()\n  subs = []\n}\n"]}

package/build/services/DeviceStoreHydration.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Seed the native DeviceStore from the persisted settings. Single-flight: the
+ * first caller runs it, everyone else awaits the same promise. On failure the
+ * current awaiters see the rejection (and fail open — the pre-guard behavior,
+ * where the connect calls' own error handling was the last line of defense),
+ * and the memo clears so a LATER read can retry and heal.
+ */
+export declare function hydrateDeviceStore(): Promise<void>;
+/**
+ * Test-only: clear the hydration memo so each test starts from an unhydrated
+ * store instead of inheriting whichever hydration a previous test ran.
+ */
+export declare function resetDeviceStoreHydrationForTests(): void;
+/**
+ * Whether the SDK holds an actual default DEVICE to reconnect to — the
+ * hydration-aware two-state read. Distinct from the `default_wearable`
+ * setting (a model string that pending/orphaned states can hold without any
+ * paired device): `connectDefault()` throws without a device.
+ * Rejects if hydration failed; callers fail open.
+ */
+export declare function hasDefaultDevice(): Promise<boolean>;
+/**
+ * Boot repair for the orphaned-identity population: a persisted
+ * `default_wearable` whose native default device does not exist after a
+ * completed hydration. Two-phase writes stop NEW orphans from forming
+ * (identity is only promoted at pairing success); this demotes the ones
+ * already in the field — selection-time writes abandoned before pairing
+ * succeeded, and identity resurrected from the server before it stopped
+ * syncing — down to `pending_wearable`, which the host renders as a
+ * finish-pairing card instead of a connect button that would throw
+ * "Set a default glasses device before calling connectDefault".
+ *
+ * Runs after hydration on every start; converges because a demoted default
+ * can't re-trip the condition. Skips while the link layer is busy or
+ * connected (an in-flight pairing owns the identity right now).
+ */
+export declare function demoteOrphanedDefaultWearable(): Promise<void>;
+//# sourceMappingURL=DeviceStoreHydration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceStoreHydration.d.ts","sourceRoot":"","sources":["../../src/services/DeviceStoreHydration.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBlD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BnE"}