@mentra/engine 0.1.0-beta.0

package/build/facades/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"AA+DA,iBAAS,oBAAoB;;;;;;;;;;;EAkB5B;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE9E,eAAO,MAAM,GAAG;IACd,+CAA+C;qBAChC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAIhD,0EAA0E;yBACrD;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAkBtD,8EAA8E;0BAC1D,IAAI;IAExB,iFAAiF;uBAChE,MAAM;IACvB;;;OAGG;2BACkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK5C;;;;;;;;;OASG;0BAEI,MAAM,SACJ,MAAM,KACZ,OAAO,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IAqCtF,qEAAqE;yBAClD,wBAAwB;IAE3C,gFAAgF;0BAC1D,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAmBhF,CAAA"}

package/build/facades/dev.js

@@ -0,0 +1,189 @@
+/**
+ * dev facade — `engine.dev`: developer/debug surface over engine-owned state.
+ * Backend/cloud URL overrides read+write the engine settings store; the cloud
+ * URL setters reconnect the engine-owned cloud client onto the new endpoints;
+ *
+ * NOTE: the dev-time endpoint *resolution* (Metro-host auto-detect, env defaults)
+ * still lives host-side in `@/services/cloudClient` during the migration; this
+ * facade manages the explicit overrides + reconnect.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { isGlassesReady } from "../services/GlassesReadiness";
+import { useCloudClientStatusStore } from "../stores/cloudClientStatus";
+import { useConnectionStore } from "../stores/connection";
+import { useCoreStore } from "../stores/core";
+import { useGlassesStore } from "../stores/glasses";
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+import { cloudClientService } from "../services/CloudClientService";
+import { getConfigValues } from "../runtime/bootstrap";
+import { decideDevLaunchRoute } from "../utils/devMiniappLaunch";
+import { registerDevApp, DEV_APP_PACKAGE_NAME } from "../services/AppRegistry";
+import { useAppStatusStore } from "../stores/apps";
+/**
+ * Reconnect the cloud client onto the current cloud-URL overrides. Explicit
+ * partial overrides merge over the boot-resolved config (which carries the
+ * host's Metro/env URL resolution); both empty clears the live override.
+ */
+function applyCloudUrlReconnect(urls = currentCloudUrlOverrides()) {
+    const resolved = resolveCloudUrlReconnectTarget(urls);
+    if (resolved === undefined) {
+        cloudClientService.reconnect(null);
+    }
+    else if (resolved) {
+        cloudClientService.reconnect(resolved);
+    }
+    else {
+        console.warn("engine.dev.setCloudUrls: partial cloud override missing boot-resolved sibling endpoint");
+    }
+}
+function currentCloudUrlOverrides() {
+    const s = useSettingsStore.getState();
+    return {
+        core: trimSetting(s.getSetting(SETTINGS.cloud_core_url.key)),
+        runtime: trimSetting(s.getSetting(SETTINGS.cloud_runtime_url.key)),
+    };
+}
+function resolveCloudUrlReconnectTarget(urls) {
+    const core = trimSetting(urls.core);
+    const runtime = trimSetting(urls.runtime);
+    if (!core && !runtime)
+        return undefined;
+    const config = getConfigValues();
+    const resolvedCore = core || config.coreUrl?.trim();
+    const resolvedRuntime = runtime || config.runtimeUrl?.trim();
+    return resolvedCore && resolvedRuntime ? { core: resolvedCore, runtime: resolvedRuntime } : null;
+}
+function trimSetting(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function projectRuntimeStatus() {
+    const core = useCoreStore.getState();
+    const glasses = useGlassesStore.getState();
+    const connection = useConnectionStore.getState();
+    const cloudClient = useCloudClientStatusStore.getState();
+    return {
+        searching: core.searching,
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        micRanking: [...core.micRanking],
+        currentMic: core.currentMic,
+        systemMicUnavailable: core.systemMicUnavailable,
+        glassesConnected: glasses.connection.state === "connected",
+        glassesFullyBooted: isGlassesReady(glasses.connection),
+        bluetoothClassicConnected: glasses.bluetoothClassicConnected,
+        coreStatus: connection.status,
+        cloudClientStatus: cloudClient.status,
+        cloudClientAudioTransport: cloudClient.audioTransport,
+    };
+}
+export const dev = {
+    /** The cloud-v2 core/runtime URL overrides. */
+    cloudUrls: () => {
+        const s = useSettingsStore.getState();
+        return { core: s.getSetting(SETTINGS.cloud_core_url.key), runtime: s.getSetting(SETTINGS.cloud_runtime_url.key) };
+    },
+    /** Override the cloud-v2 URLs and reconnect the live client onto them. */
+    setCloudUrls: (urls) => {
+        const next = { ...currentCloudUrlOverrides(), ...urls };
+        const resolved = resolveCloudUrlReconnectTarget(next);
+        if (resolved === null) {
+            console.warn("engine.dev.setCloudUrls: ignoring partial cloud override without a resolvable sibling endpoint");
+            return;
+        }
+        const s = useSettingsStore.getState();
+        if (urls.core !== undefined)
+            s.setSetting(SETTINGS.cloud_core_url.key, urls.core);
+        if (urls.runtime !== undefined)
+            s.setSetting(SETTINGS.cloud_runtime_url.key, urls.runtime);
+        if (resolved === undefined) {
+            cloudClientService.reconnect(null);
+        }
+        else {
+            cloudClientService.reconnect(resolved);
+        }
+    },
+    /** Tear down + rebuild the live cloud client (the dev "reconnect" button). */
+    reconnectCloud: () => applyCloudUrlReconnect(),
+    /** Current native (BLE-process) memory usage in MB — a dev/diagnostics gauge. */
+    getMemoryMB: () => BluetoothSdk.getMemoryMB(),
+    /**
+     * Phone-side bluetooth runtime snapshot (the core store read-model: scan/mic/
+     * search state) — the diagnostics/data-export surface. Shallow copy.
+     */
+    bluetoothStatus: () => {
+        const { setCoreInfo: _setCoreInfo, reset: _reset, ...state } = useCoreStore.getState();
+        return { ...state };
+    },
+    /**
+     * Side-load a miniapp being served from a dev machine (the `mentra dev` / CLI
+     * flow) by its URL: probes `<url>/miniapp.json`, and on a reachable manifest
+     * registers it under its manifest package so it appears in `engine.miniapps`
+     * and can coexist with other dev miniapps. This is the OEM-host equivalent
+     * of the first-party
+     * developer-URL screen — the registration itself is engine-internal, so a
+     * host reaches it here rather than the internal registry. Rendering still
+     * flows through the normal display path once the miniapp is started.
+     */
+    loadDevMiniapp: async (url, name) => {
+        const devUrl = url.trim().replace(/\/+$/, "");
+        if (!devUrl)
+            return { ok: false, error: "empty url" };
+        const result = await decideDevLaunchRoute("", devUrl);
+        if (result.decision !== "live") {
+            return { ok: false, error: "dev server unreachable, or no miniapp.json served there" };
+        }
+        const manifest = result.manifest;
+        // The `mentra-miniapp dev` server puts the hot-reload/log sidecar on the
+        // user port PLUS ONE — same convention as the first-party developer-URL
+        // screen's deriveDevPort.
+        let devPort;
+        try {
+            const parsed = Number(new URL(devUrl).port);
+            devPort = Number.isFinite(parsed) && parsed > 0 ? parsed + 1 : undefined;
+        }
+        catch {
+            devPort = undefined;
+        }
+        const appName = name ?? manifest.name ?? "Dev Miniapp";
+        const packageName = manifest.packageName ?? DEV_APP_PACKAGE_NAME;
+        const existing = useAppStatusStore.getState().apps.find((app) => app.packageName === packageName);
+        if (existing?.running)
+            await useAppStatusStore.getState().stop(packageName);
+        await registerDevApp({
+            packageName,
+            name: appName,
+            iconUrl: manifest.icon ? new URL(manifest.icon, `${devUrl}/`).toString() : `${devUrl}/icon.png`,
+            devUrl,
+            devPort,
+            type: manifest.type,
+            permissions: manifest.permissions,
+            hardwareRequirements: manifest.hardwareRequirements,
+            actions: manifest.actions,
+        });
+        await useAppStatusStore.getState().refresh();
+        return { ok: true, packageName, name: appName };
+    },
+    /** Current engine runtime status for engine-owned debug surfaces. */
+    runtimeStatus: () => projectRuntimeStatus(),
+    /** Subscribe to the projected engine runtime status; returns an unsubscribe. */
+    onRuntimeStatus: (cb) => {
+        let last = JSON.stringify(projectRuntimeStatus());
+        const notify = () => {
+            const snap = projectRuntimeStatus();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        };
+        const unsubscribers = [
+            useCoreStore.subscribe(notify),
+            useGlassesStore.subscribe(notify),
+            useConnectionStore.subscribe(notify),
+            useCloudClientStatusStore.subscribe(notify),
+        ];
+        return () => {
+            unsubscribers.forEach((unsubscribe) => unsubscribe());
+        };
+    },
+};
+//# sourceMappingURL=dev.js.map

package/build/facades/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * dev facade — `engine.dev`: developer/debug surface over engine-owned state.\n * Backend/cloud URL overrides read+write the engine settings store; the cloud\n * URL setters reconnect the engine-owned cloud client onto the new endpoints;\n *\n * NOTE: the dev-time endpoint *resolution* (Metro-host auto-detect, env defaults)\n * still lives host-side in `@/services/cloudClient` during the migration; this\n * facade manages the explicit overrides + reconnect.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {isGlassesReady} from \"../services/GlassesReadiness\"\nimport {useCloudClientStatusStore} from \"../stores/cloudClientStatus\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {getConfigValues} from \"../runtime/bootstrap\"\nimport {decideDevLaunchRoute} from \"../utils/devMiniappLaunch\"\nimport {registerDevApp, DEV_APP_PACKAGE_NAME, type DevAppRecord} from \"../services/AppRegistry\"\nimport {useAppStatusStore} from \"../stores/apps\"\n\ntype CloudUrlOverrides = {core?: string; runtime?: string}\n\n/**\n * Reconnect the cloud client onto the current cloud-URL overrides. Explicit\n * partial overrides merge over the boot-resolved config (which carries the\n * host's Metro/env URL resolution); both empty clears the live override.\n */\nfunction applyCloudUrlReconnect(urls: CloudUrlOverrides = currentCloudUrlOverrides()): void {\n  const resolved = resolveCloudUrlReconnectTarget(urls)\n  if (resolved === undefined) {\n    cloudClientService.reconnect(null)\n  } else if (resolved) {\n    cloudClientService.reconnect(resolved)\n  } else {\n    console.warn(\"engine.dev.setCloudUrls: partial cloud override missing boot-resolved sibling endpoint\")\n  }\n}\n\nfunction currentCloudUrlOverrides(): CloudUrlOverrides {\n  const s = useSettingsStore.getState()\n  return {\n    core: trimSetting(s.getSetting(SETTINGS.cloud_core_url.key)),\n    runtime: trimSetting(s.getSetting(SETTINGS.cloud_runtime_url.key)),\n  }\n}\n\nfunction resolveCloudUrlReconnectTarget(urls: CloudUrlOverrides): {core: string; runtime: string} | null | undefined {\n  const core = trimSetting(urls.core)\n  const runtime = trimSetting(urls.runtime)\n  if (!core && !runtime) return undefined\n\n  const config = getConfigValues()\n  const resolvedCore = core || config.coreUrl?.trim()\n  const resolvedRuntime = runtime || config.runtimeUrl?.trim()\n  return resolvedCore && resolvedRuntime ? {core: resolvedCore, runtime: resolvedRuntime} : null\n}\n\nfunction trimSetting(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined\n}\n\nfunction projectRuntimeStatus() {\n  const core = useCoreStore.getState()\n  const glasses = useGlassesStore.getState()\n  const connection = useConnectionStore.getState()\n  const cloudClient = useCloudClientStatusStore.getState()\n  return {\n    searching: core.searching,\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    micRanking: [...core.micRanking],\n    currentMic: core.currentMic,\n    systemMicUnavailable: core.systemMicUnavailable,\n    glassesConnected: glasses.connection.state === \"connected\",\n    glassesFullyBooted: isGlassesReady(glasses.connection),\n    bluetoothClassicConnected: glasses.bluetoothClassicConnected,\n    coreStatus: connection.status,\n    cloudClientStatus: cloudClient.status,\n    cloudClientAudioTransport: cloudClient.audioTransport,\n  }\n}\n\nexport type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>\n\nexport const dev = {\n  /** The cloud-v2 core/runtime URL overrides. */\n  cloudUrls: (): {core?: string; runtime?: string} => {\n    const s = useSettingsStore.getState()\n    return {core: s.getSetting(SETTINGS.cloud_core_url.key), runtime: s.getSetting(SETTINGS.cloud_runtime_url.key)}\n  },\n  /** Override the cloud-v2 URLs and reconnect the live client onto them. */\n  setCloudUrls: (urls: {core?: string; runtime?: string}) => {\n    const next = {...currentCloudUrlOverrides(), ...urls}\n    const resolved = resolveCloudUrlReconnectTarget(next)\n    if (resolved === null) {\n      console.warn(\"engine.dev.setCloudUrls: ignoring partial cloud override without a resolvable sibling endpoint\")\n      return\n    }\n\n    const s = useSettingsStore.getState()\n    if (urls.core !== undefined) s.setSetting(SETTINGS.cloud_core_url.key, urls.core)\n    if (urls.runtime !== undefined) s.setSetting(SETTINGS.cloud_runtime_url.key, urls.runtime)\n    if (resolved === undefined) {\n      cloudClientService.reconnect(null)\n    } else {\n      cloudClientService.reconnect(resolved)\n    }\n  },\n\n  /** Tear down + rebuild the live cloud client (the dev \"reconnect\" button). */\n  reconnectCloud: (): void => applyCloudUrlReconnect(),\n\n  /** Current native (BLE-process) memory usage in MB — a dev/diagnostics gauge. */\n  getMemoryMB: (): number => BluetoothSdk.getMemoryMB(),\n  /**\n   * Phone-side bluetooth runtime snapshot (the core store read-model: scan/mic/\n   * search state) — the diagnostics/data-export surface. Shallow copy.\n   */\n  bluetoothStatus: (): Record<string, unknown> => {\n    const {setCoreInfo: _setCoreInfo, reset: _reset, ...state} = useCoreStore.getState()\n    return {...state}\n  },\n\n  /**\n   * Side-load a miniapp being served from a dev machine (the `mentra dev` / CLI\n   * flow) by its URL: probes `<url>/miniapp.json`, and on a reachable manifest\n   * registers it under its manifest package so it appears in `engine.miniapps`\n   * and can coexist with other dev miniapps. This is the OEM-host equivalent\n   * of the first-party\n   * developer-URL screen — the registration itself is engine-internal, so a\n   * host reaches it here rather than the internal registry. Rendering still\n   * flows through the normal display path once the miniapp is started.\n   */\n  loadDevMiniapp: async (\n    url: string,\n    name?: string,\n  ): Promise<{ok: true; packageName: string; name: string} | {ok: false; error: string}> => {\n    const devUrl = url.trim().replace(/\\/+$/, \"\")\n    if (!devUrl) return {ok: false, error: \"empty url\"}\n    const result = await decideDevLaunchRoute(\"\", devUrl)\n    if (result.decision !== \"live\") {\n      return {ok: false, error: \"dev server unreachable, or no miniapp.json served there\"}\n    }\n    const manifest = result.manifest\n    // The `mentra-miniapp dev` server puts the hot-reload/log sidecar on the\n    // user port PLUS ONE — same convention as the first-party developer-URL\n    // screen's deriveDevPort.\n    let devPort: number | undefined\n    try {\n      const parsed = Number(new URL(devUrl).port)\n      devPort = Number.isFinite(parsed) && parsed > 0 ? parsed + 1 : undefined\n    } catch {\n      devPort = undefined\n    }\n    const appName = name ?? manifest.name ?? \"Dev Miniapp\"\n    const packageName = (manifest.packageName as string | undefined) ?? DEV_APP_PACKAGE_NAME\n    const existing = useAppStatusStore.getState().apps.find((app) => app.packageName === packageName)\n    if (existing?.running) await useAppStatusStore.getState().stop(packageName)\n    await registerDevApp({\n      packageName,\n      name: appName,\n      iconUrl: manifest.icon ? new URL(manifest.icon, `${devUrl}/`).toString() : `${devUrl}/icon.png`,\n      devUrl,\n      devPort,\n      type: manifest.type as DevAppRecord[\"type\"],\n      permissions: manifest.permissions as DevAppRecord[\"permissions\"],\n      hardwareRequirements: manifest.hardwareRequirements as DevAppRecord[\"hardwareRequirements\"],\n      actions: manifest.actions as DevAppRecord[\"actions\"],\n    })\n    await useAppStatusStore.getState().refresh()\n    return {ok: true, packageName, name: appName}\n  },\n\n  /** Current engine runtime status for engine-owned debug surfaces. */\n  runtimeStatus: (): DevRuntimeStatusSnapshot => projectRuntimeStatus(),\n\n  /** Subscribe to the projected engine runtime status; returns an unsubscribe. */\n  onRuntimeStatus: (cb: (status: DevRuntimeStatusSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectRuntimeStatus())\n    const notify = () => {\n      const snap = projectRuntimeStatus()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    }\n    const unsubscribers = [\n      useCoreStore.subscribe(notify),\n      useGlassesStore.subscribe(notify),\n      useConnectionStore.subscribe(notify),\n      useCloudClientStatusStore.subscribe(notify),\n    ]\n    return () => {\n      unsubscribers.forEach((unsubscribe) => unsubscribe())\n    }\n  },\n}\n"]}

package/build/facades/display.d.ts

@@ -0,0 +1,21 @@
+/**
+ * display facade — `engine.display`: the host/OEM display surface. `mirror`
+ * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the
+ * glasses display for dev tools and escape-hatch use (normal rendering goes through
+ * the engine DisplayProcessor / layout system, not these).
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+export declare const display: {
+    /** Mirrored-view read-model (current/onMirror/view/setView). */
+    mirror: {
+        current(): import("./displayMirror").DisplayMirrorEvent;
+        onMirror(cb: (event: import("./displayMirror").DisplayMirrorEvent) => void): () => void;
+        view(): string;
+        setView(view: "main" | "dashboard"): void;
+    };
+    /** Write raw text to the glasses display at (x, y) with a font size. */
+    text: (text: string, x?: number | undefined, y?: number | undefined, size?: number | undefined) => Promise<void>;
+    /** Clear the glasses display. */
+    clear: () => Promise<void>;
+};
+//# sourceMappingURL=display.d.ts.map

package/build/facades/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AAGzD,eAAO,MAAM,OAAO;IAClB,gEAAgE;;;;;;;IAEhE,wEAAwE;;IAExE,iCAAiC;iBACtB,OAAO,CAAC,IAAI,CAAC;CACzB,CAAA"}

package/build/facades/display.js

@@ -0,0 +1,17 @@
+/**
+ * display facade — `engine.display`: the host/OEM display surface. `mirror`
+ * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the
+ * glasses display for dev tools and escape-hatch use (normal rendering goes through
+ * the engine DisplayProcessor / layout system, not these).
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { displayMirror } from "./displayMirror";
+export const display = {
+    /** Mirrored-view read-model (current/onMirror/view/setView). */
+    mirror: displayMirror,
+    /** Write raw text to the glasses display at (x, y) with a font size. */
+    text: (...args) => BluetoothSdk.displayText(...args),
+    /** Clear the glasses display. */
+    clear: () => BluetoothSdk.clearDisplay(),
+};
+//# sourceMappingURL=display.js.map

package/build/facades/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AACzD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gEAAgE;IAChE,MAAM,EAAE,aAAa;IACrB,wEAAwE;IACxE,IAAI,EAAE,CAAC,GAAG,IAAiD,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjG,iCAAiC;IACjC,KAAK,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE;CACxD,CAAA","sourcesContent":["/**\n * display facade — `engine.display`: the host/OEM display surface. `mirror`\n * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the\n * glasses display for dev tools and escape-hatch use (normal rendering goes through\n * the engine DisplayProcessor / layout system, not these).\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {displayMirror} from \"./displayMirror\"\n\nexport const display = {\n  /** Mirrored-view read-model (current/onMirror/view/setView). */\n  mirror: displayMirror,\n  /** Write raw text to the glasses display at (x, y) with a font size. */\n  text: (...args: Parameters<typeof BluetoothSdk.displayText>) => BluetoothSdk.displayText(...args),\n  /** Clear the glasses display. */\n  clear: (): Promise<void> => BluetoothSdk.clearDisplay(),\n}\n"]}

package/build/facades/displayMirror.d.ts

@@ -0,0 +1,15 @@
+export type DisplayMirrorEvent = Record<string, unknown> & {
+    view?: string;
+    layout?: any;
+};
+export declare const displayMirror: {
+    /** The display event currently shown on the previewed view (snapshot). */
+    current(): DisplayMirrorEvent;
+    /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+    onMirror(cb: (event: DisplayMirrorEvent) => void): () => void;
+    /** Which view is previewed — the main screen or the dashboard. */
+    view(): string;
+    /** Switch the previewed view between `"main"` and `"dashboard"`. */
+    setView(view: "main" | "dashboard"): void;
+};
+//# sourceMappingURL=displayMirror.d.ts.map

package/build/facades/displayMirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayMirror.d.ts","sourceRoot":"","sources":["../../src/facades/displayMirror.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAC,CAAA;AAExF,eAAO,MAAM,aAAa;IACxB,0EAA0E;eAC/D,kBAAkB;IAK7B,mFAAmF;iBACtE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI7D,kEAAkE;YAC1D,MAAM;IAGd,oEAAoE;kBACtD,MAAM,GAAG,WAAW,GAAG,IAAI;CAG1C,CAAA"}

package/build/facades/displayMirror.js

@@ -0,0 +1,29 @@
+/**
+ * glasses display mirror — the typed read facade over the (now engine-owned)
+ * display store, for a phone-side preview of the glasses screen
+ * (`engine.display.mirror`). The store is fed by the display paths
+ * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the
+ * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is
+ * also exposed as `engine.displayStore` (the Mentra-app escape hatch).
+ */
+import { useDisplayStore } from "../stores/display";
+export const displayMirror = {
+    /** The display event currently shown on the previewed view (snapshot). */
+    current() {
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        return { ...useDisplayStore.getState().currentEvent };
+    },
+    /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+    onMirror(cb) {
+        return useDisplayStore.subscribe((s) => s.currentEvent, cb);
+    },
+    /** Which view is previewed — the main screen or the dashboard. */
+    view() {
+        return useDisplayStore.getState().view;
+    },
+    /** Switch the previewed view between `"main"` and `"dashboard"`. */
+    setView(view) {
+        useDisplayStore.getState().setView(view);
+    },
+};
+//# sourceMappingURL=displayMirror.js.map

package/build/facades/displayMirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayMirror.js","sourceRoot":"","sources":["../../src/facades/displayMirror.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AAIjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,0EAA0E;IAC1E,OAAO;QACL,+EAA+E;QAC/E,OAAO,EAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAC,CAAA;IACrD,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,EAAuC;QAC9C,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,kEAAkE;IAClE,IAAI;QACF,OAAO,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAA;IACxC,CAAC;IACD,oEAAoE;IACpE,OAAO,CAAC,IAA0B;QAChC,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC;CACF,CAAA","sourcesContent":["/**\n * glasses display mirror — the typed read facade over the (now engine-owned)\n * display store, for a phone-side preview of the glasses screen\n * (`engine.display.mirror`). The store is fed by the display paths\n * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the\n * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is\n * also exposed as `engine.displayStore` (the Mentra-app escape hatch).\n */\nimport {useDisplayStore} from \"../stores/display\"\n\nexport type DisplayMirrorEvent = Record<string, unknown> & {view?: string; layout?: any}\n\nexport const displayMirror = {\n  /** The display event currently shown on the previewed view (snapshot). */\n  current(): DisplayMirrorEvent {\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    return {...useDisplayStore.getState().currentEvent}\n  },\n\n  /** Subscribe to changes of the previewed display event; returns an unsubscribe. */\n  onMirror(cb: (event: DisplayMirrorEvent) => void): () => void {\n    return useDisplayStore.subscribe((s) => s.currentEvent, cb)\n  },\n\n  /** Which view is previewed — the main screen or the dashboard. */\n  view(): string {\n    return useDisplayStore.getState().view\n  },\n  /** Switch the previewed view between `\"main\"` and `\"dashboard\"`. */\n  setView(view: \"main\" | \"dashboard\"): void {\n    useDisplayStore.getState().setView(view)\n  },\n}\n"]}

package/build/facades/gallery.d.ts

@@ -0,0 +1,62 @@
+import { type GalleryNotice } from "../services/asg/galleryNotices";
+declare function projectStatus(): {
+    processingFiles: string[];
+    processedFiles: number;
+    isSyncing: boolean;
+    isStarting: boolean;
+    glassesGallery: {
+        photos: number;
+        videos: number;
+        total: number;
+        hasContent: boolean;
+    };
+    queue: {
+        name: string;
+        url: string;
+        download: string;
+        size: number;
+        modified: string | number;
+        mime_type?: string;
+        is_video?: boolean;
+        thumbnail_data?: string;
+        downloaded_at?: number;
+        duration?: number;
+        filePath?: string;
+        thumbnailPath?: string;
+        glassesModel?: string;
+    }[];
+    queueLength: number;
+    queueIndex: number;
+    syncState: import("../stores/gallerySync").SyncState;
+    currentFile: string | null;
+    currentFileProgress: number;
+    completedFiles: number;
+    totalFiles: number;
+    failedFiles: string[];
+};
+export type GallerySyncStatus = ReturnType<typeof projectStatus>;
+export declare const gallery: {
+    /** Snapshot of the current sync state + progress. */
+    status: () => GallerySyncStatus;
+    /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected
+     * status (the gallerySync store mutates many unrelated fields during a sync), so the
+     * host only re-renders when the projection actually changes — matches the other
+     * read-model facades. */
+    onStatus: (cb: (status: GallerySyncStatus) => void) => (() => void);
+    /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */
+    onNotice: (cb: (notice: GalleryNotice) => void) => (() => void);
+    /** Start a gallery sync (the host gates connectivity/permissions first). */
+    sync: () => Promise<void>;
+    /** Cancel an in-progress sync. */
+    cancel: () => Promise<void>;
+    /** Ask glasses to refresh their gallery summary counts. */
+    refreshStatus: () => Promise<void>;
+    /** Remove local files from the current gallery queue after host-owned deletion UI completes. */
+    removeFilesFromQueue: (fileNames: string[]) => void;
+    /** Clear the current gallery sync queue after host-owned bulk deletion completes. */
+    clearQueue: () => void;
+    /** Clear the cached glasses gallery summary when product UI observes disconnect. */
+    clearGlassesGalleryStatus: () => void;
+};
+export {};
+//# sourceMappingURL=gallery.d.ts.map

package/build/facades/gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/facades/gallery.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,aAAa,EAAC,MAAM,gCAAgC,CAAA;AAElF,iBAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBrB;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAClB,qDAAqD;kBACzC,iBAAiB;IAC7B;;;6BAGyB;mBACV,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAUjE,wFAAwF;mBACzE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAE7D,4EAA4E;gBAClE,OAAO,CAAC,IAAI,CAAC;IACvB,kCAAkC;kBACtB,OAAO,CAAC,IAAI,CAAC;IACzB,2DAA2D;yBACxC,OAAO,CAAC,IAAI,CAAC;IAChC,gGAAgG;sCAC9D,MAAM,EAAE,KAAG,IAAI;IACjD,qFAAqF;sBACrE,IAAI;IACpB,oFAAoF;qCACrD,IAAI;CACpC,CAAA"}

package/build/facades/gallery.js

@@ -0,0 +1,61 @@
+/**
+ * gallery facade — `engine.gallery`: the OEM-facing gallery-sync surface. Engine's
+ * gallerySyncService orchestrates the sync (hotspot → wifi → HTTP fetch → process →
+ * store); this facade exposes the projected status + the structured notices the host
+ * renders its own UI from, plus the sync/cancel actions. No host-injected UI — the host
+ * owns all alerts/navigation/i18n (it renders them off `onNotice`).
+ */
+import { useGallerySyncStore, selectSyncProgress, selectIssyncing, selectGlassesGalleryStatus, } from "../stores/gallerySync";
+import { gallerySyncService } from "../services/asg/gallerySyncService";
+import { onGalleryNotice } from "../services/asg/galleryNotices";
+function projectStatus() {
+    const s = useGallerySyncStore.getState();
+    const progress = selectSyncProgress(s);
+    return {
+        ...progress,
+        processingFiles: Array.from(progress.processingFiles),
+        processedFiles: s.processedFiles,
+        isSyncing: selectIssyncing(s),
+        isStarting: gallerySyncService.isSyncStarting(),
+        glassesGallery: selectGlassesGalleryStatus(s),
+        // Copy: the snapshot must not hand callers a mutable reference into the store
+        // (each queue item is copied too — callers must not mutate them in place).
+        queue: s.queue.map((item) => ({ ...item })),
+        queueLength: s.queue.length,
+        queueIndex: s.queueIndex,
+    };
+}
+export const gallery = {
+    /** Snapshot of the current sync state + progress. */
+    status: () => projectStatus(),
+    /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected
+     * status (the gallerySync store mutates many unrelated fields during a sync), so the
+     * host only re-renders when the projection actually changes — matches the other
+     * read-model facades. */
+    onStatus: (cb) => {
+        let last = JSON.stringify(projectStatus());
+        return useGallerySyncStore.subscribe(() => {
+            const status = projectStatus();
+            const serialized = JSON.stringify(status);
+            if (serialized === last)
+                return;
+            last = serialized;
+            cb(status);
+        });
+    },
+    /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */
+    onNotice: (cb) => onGalleryNotice(cb),
+    /** Start a gallery sync (the host gates connectivity/permissions first). */
+    sync: () => gallerySyncService.startSync(),
+    /** Cancel an in-progress sync. */
+    cancel: () => gallerySyncService.cancelSync(),
+    /** Ask glasses to refresh their gallery summary counts. */
+    refreshStatus: () => gallerySyncService.queryGlassesGalleryStatus(),
+    /** Remove local files from the current gallery queue after host-owned deletion UI completes. */
+    removeFilesFromQueue: (fileNames) => useGallerySyncStore.getState().removeFilesFromQueue(fileNames),
+    /** Clear the current gallery sync queue after host-owned bulk deletion completes. */
+    clearQueue: () => useGallerySyncStore.getState().clearQueue(),
+    /** Clear the cached glasses gallery summary when product UI observes disconnect. */
+    clearGlassesGalleryStatus: () => useGallerySyncStore.getState().clearGlassesGalleryStatus(),
+};
+//# sourceMappingURL=gallery.js.map

package/build/facades/gallery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.js","sourceRoot":"","sources":["../../src/facades/gallery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAC,kBAAkB,EAAC,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAC,eAAe,EAAqB,MAAM,gCAAgC,CAAA;AAElF,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAA;IACxC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;IACtC,OAAO;QACL,GAAG,QAAQ;QACX,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QACrD,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;QAC7B,UAAU,EAAE,kBAAkB,CAAC,cAAc,EAAE;QAC/C,cAAc,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAC7C,8EAA8E;QAC9E,2EAA2E;QAC3E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,IAAI,EAAC,CAAC,CAAC;QACzC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QAC3B,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAA;AACH,CAAC;AAID,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,qDAAqD;IACrD,MAAM,EAAE,GAAsB,EAAE,CAAC,aAAa,EAAE;IAChD;;;6BAGyB;IACzB,QAAQ,EAAE,CAAC,EAAuC,EAAgB,EAAE;QAClE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAA;QAC1C,OAAO,mBAAmB,CAAC,SAAS,CAAC,GAAG,EAAE;YACxC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACzC,IAAI,UAAU,KAAK,IAAI;gBAAE,OAAM;YAC/B,IAAI,GAAG,UAAU,CAAA;YACjB,EAAE,CAAC,MAAM,CAAC,CAAA;QACZ,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,wFAAwF;IACxF,QAAQ,EAAE,CAAC,EAAmC,EAAgB,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;IAEpF,4EAA4E;IAC5E,IAAI,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE;IACzD,kCAAkC;IAClC,MAAM,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE;IAC5D,2DAA2D;IAC3D,aAAa,EAAE,GAAkB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,EAAE;IAClF,gGAAgG;IAChG,oBAAoB,EAAE,CAAC,SAAmB,EAAQ,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC;IACnH,qFAAqF;IACrF,UAAU,EAAE,GAAS,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE;IACnE,oFAAoF;IACpF,yBAAyB,EAAE,GAAS,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,yBAAyB,EAAE;CAClG,CAAA","sourcesContent":["/**\n * gallery facade — `engine.gallery`: the OEM-facing gallery-sync surface. Engine's\n * gallerySyncService orchestrates the sync (hotspot → wifi → HTTP fetch → process →\n * store); this facade exposes the projected status + the structured notices the host\n * renders its own UI from, plus the sync/cancel actions. No host-injected UI — the host\n * owns all alerts/navigation/i18n (it renders them off `onNotice`).\n */\nimport {\n  useGallerySyncStore,\n  selectSyncProgress,\n  selectIssyncing,\n  selectGlassesGalleryStatus,\n} from \"../stores/gallerySync\"\nimport {gallerySyncService} from \"../services/asg/gallerySyncService\"\nimport {onGalleryNotice, type GalleryNotice} from \"../services/asg/galleryNotices\"\n\nfunction projectStatus() {\n  const s = useGallerySyncStore.getState()\n  const progress = selectSyncProgress(s)\n  return {\n    ...progress,\n    processingFiles: Array.from(progress.processingFiles),\n    processedFiles: s.processedFiles,\n    isSyncing: selectIssyncing(s),\n    isStarting: gallerySyncService.isSyncStarting(),\n    glassesGallery: selectGlassesGalleryStatus(s),\n    // Copy: the snapshot must not hand callers a mutable reference into the store\n    // (each queue item is copied too — callers must not mutate them in place).\n    queue: s.queue.map((item) => ({...item})),\n    queueLength: s.queue.length,\n    queueIndex: s.queueIndex,\n  }\n}\n\nexport type GallerySyncStatus = ReturnType<typeof projectStatus>\n\nexport const gallery = {\n  /** Snapshot of the current sync state + progress. */\n  status: (): GallerySyncStatus => projectStatus(),\n  /** Subscribe to sync-state changes; returns an unsubscribe. Deduped on the projected\n   * status (the gallerySync store mutates many unrelated fields during a sync), so the\n   * host only re-renders when the projection actually changes — matches the other\n   * read-model facades. */\n  onStatus: (cb: (status: GallerySyncStatus) => void): (() => void) => {\n    let last = JSON.stringify(projectStatus())\n    return useGallerySyncStore.subscribe(() => {\n      const status = projectStatus()\n      const serialized = JSON.stringify(status)\n      if (serialized === last) return\n      last = serialized\n      cb(status)\n    })\n  },\n  /** Subscribe to user-actionable notices (host renders alerts / settings deep-links). */\n  onNotice: (cb: (notice: GalleryNotice) => void): (() => void) => onGalleryNotice(cb),\n\n  /** Start a gallery sync (the host gates connectivity/permissions first). */\n  sync: (): Promise<void> => gallerySyncService.startSync(),\n  /** Cancel an in-progress sync. */\n  cancel: (): Promise<void> => gallerySyncService.cancelSync(),\n  /** Ask glasses to refresh their gallery summary counts. */\n  refreshStatus: (): Promise<void> => gallerySyncService.queryGlassesGalleryStatus(),\n  /** Remove local files from the current gallery queue after host-owned deletion UI completes. */\n  removeFilesFromQueue: (fileNames: string[]): void => useGallerySyncStore.getState().removeFilesFromQueue(fileNames),\n  /** Clear the current gallery sync queue after host-owned bulk deletion completes. */\n  clearQueue: (): void => useGallerySyncStore.getState().clearQueue(),\n  /** Clear the cached glasses gallery summary when product UI observes disconnect. */\n  clearGlassesGalleryStatus: (): void => useGallerySyncStore.getState().clearGlassesGalleryStatus(),\n}\n"]}

package/build/facades/glasses.d.ts

@@ -0,0 +1,141 @@
+/**
+ * glasses facade — the core `engine.glasses.*` surface: connection actions (over
+ * the bluetooth-sdk passthrough), a curated status/info read-model (projected from
+ * the engine-owned glasses store), capabilities (from the model table), and the
+ * discrete input events. The `wifi` sub-facade is nested here.
+ *
+ * Read-models project the raw glasses store into the stable shape OEM UIs consume,
+ * so the device store's field layout doesn't leak into every screen.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import type { ButtonPressEvent, TouchEvent } from "@mentra/bluetooth-sdk/internal";
+declare function projectStatus(): {
+    state: "connecting" | "connected" | "disconnected" | "scanning" | "bonding";
+    fullyBooted: boolean;
+    battery: number;
+    charging: boolean;
+    case: {
+        battery: number;
+        charging: boolean;
+        open: boolean;
+        removed: boolean;
+    };
+    signal: number;
+    micEnabled: boolean;
+    vadEnabled: boolean;
+    btClassic: boolean;
+};
+declare function projectControllerStatus(): {
+    connected: boolean;
+    fullyBooted: boolean;
+    battery: number;
+    signal: number;
+};
+declare function projectInfo(): {
+    model: string;
+    style: string;
+    color: string;
+    bluetoothName: string;
+    firmwareVersion: string;
+    mtkFirmware: string;
+    besFirmware: string;
+    appVersion: string;
+    androidVersion: string;
+    serialNumber: string;
+    buildNumber: string;
+    btMac: string;
+    leftMac: string;
+    rightMac: string;
+    wifi: {
+        state: "disconnected";
+    } | {
+        state: "connected";
+        ssid: string;
+        localIp?: string;
+    };
+};
+export type GlassesStatusSnapshot = ReturnType<typeof projectStatus>;
+export type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>;
+export type GlassesInfoSnapshot = ReturnType<typeof projectInfo>;
+export declare const glasses: {
+    /**
+     * Reconnect the default wearable. Seeds the phone's current device settings to
+     * native first, so they're primed before the connect handshake replays them to
+     * the glasses (this used to be a host-side step before `connectDefault`).
+     */
+    connectDefault: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    forget: () => Promise<void>;
+    /** Connect to a specific (discovered) device. */
+    connect: (device: import("@mentra/bluetooth-sdk").Device, options?: import("@mentra/bluetooth-sdk").ConnectOptions | undefined) => Promise<void>;
+    /** Connect the built-in simulated glasses (dev/testing). */
+    connectSimulated: () => Promise<void>;
+    /** Set a device as the `connectDefault()` target. */
+    setDefault: (device: import("@mentra/bluetooth-sdk").Device | null) => Promise<void>;
+    /**
+     * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
+     * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered
+     * off), `true` when already connected or after kicking off the connect. Never
+     * rejects — the boolean contract holds. The host gates connectivity/permissions
+     * (its UI) before calling.
+     */
+    reconnect: () => Promise<boolean>;
+    /** True when no glasses has ever been paired NOR selected (the pairing-identity
+     * lifecycle is in its `none` state) — e.g. to route a first-run host into the
+     * pairing/onboarding flow. A pending selection is not "first" — the host should
+     * offer finish-pairing (see `engine.pairing.identity()`). */
+    isFirstPairing: () => boolean;
+    /**
+     * True when the SDK has an actual default DEVICE to reconnect to. Distinct from
+     * `default_wearable` (a model string that a pending or orphaned selection can
+     * hold without any paired device): connectDefault() throws without a device, so
+     * hosts should route to the pairing flow when this is false.
+     *
+     * Hydration-aware: awaits the device-store seed internally, so a cold-start
+     * read can't see a false "absent" for genuinely-paired users. Rejects if
+     * hydration failed — callers guarding destructive or routing decisions must
+     * fail open (treat as "has a device").
+     */
+    hasDefaultDevice: () => Promise<boolean>;
+    status: () => GlassesStatusSnapshot;
+    onStatus: (cb: (status: GlassesStatusSnapshot) => void) => (() => void);
+    info: () => GlassesInfoSnapshot;
+    onInfo: (cb: (info: GlassesInfoSnapshot) => void) => (() => void);
+    capabilities: () => import("..").Capabilities;
+    /** Ask the glasses to report fresh firmware/version info (updates the store). */
+    requestVersionInfo: () => Promise<import("@mentra/bluetooth-sdk").VersionInfoResult>;
+    onButtonPress: (cb: (event: ButtonPressEvent) => void) => (() => void);
+    onTouchGesture: (cb: (event: TouchEvent) => void) => (() => void);
+    controller: {
+        connectDefault: () => Promise<void>;
+        disconnect: () => Promise<void>;
+        forget: () => Promise<void>;
+        status: () => ControllerStatusSnapshot;
+        onStatus: (cb: (status: ControllerStatusSnapshot) => void) => (() => void);
+    };
+    audio: {
+        /** Read the glasses' current media volume. */
+        getMediaVolume: () => Promise<import("@mentra/bluetooth-sdk").GlassesMediaVolumeGetResult>;
+        /** Set the glasses' media volume. */
+        setMediaVolume: (level: number) => Promise<import("@mentra/bluetooth-sdk").GlassesMediaVolumeSetResult>;
+        /** Tell native whether THIS app is currently playing audio (for ducking). */
+        setOwnAppPlaying: (playing: boolean) => Promise<void>;
+    };
+    wifi: {
+        scan(): Promise<import("@mentra/bluetooth-sdk").WifiSearchResult[]>;
+        onScanResult(cb: (networks: import("@mentra/bluetooth-sdk").WifiSearchResult[]) => void): () => void;
+        connect(ssid: string, password: string): Promise<void>;
+        forget(ssid: string): Promise<void>;
+        status(): import("@mentra/bluetooth-sdk").WifiStatus;
+        onStatus(cb: (status: import("@mentra/bluetooth-sdk").WifiStatus, previous: import("@mentra/bluetooth-sdk").WifiStatus) => void): () => void;
+    };
+    settings: {
+        get: <T = unknown>(key: string) => T | undefined;
+        set: <T = unknown>(key: string, value: T) => import("typesafe-ts").AsyncResult<void, Error>;
+        onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void) => (() => void);
+        descriptor: (key: string) => import("../stores/settings").Setting;
+        available: () => string[];
+    };
+};
+export {};
+//# sourceMappingURL=glasses.d.ts.map

package/build/facades/glasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AACzD,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAC,MAAM,gCAAgC,CAAA;AAWhF,iBAAS,aAAa;;;;;;;;;;;;;;;EAarB;AAED,iBAAS,uBAAuB;;;;;EAQ/B;AAED,iBAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;EAoBnB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAElB;;;;OAIG;0BACuB,OAAO,CAAC,IAAI,CAAC;sBAIvB,OAAO,CAAC,IAAI,CAAC;kBACjB,OAAO,CAAC,IAAI,CAAC;IACzB,iDAAiD;uIACkB,OAAO,CAAC,IAAI,CAAC;IAIhF,4DAA4D;4BACtC,OAAO,CAAC,IAAI,CAAC;IACnC,qDAAqD;;IAErD;;;;;;OAMG;qBACkB,OAAO,CAAC,OAAO,CAAC;IAarC;;;iEAG6D;0BACzC,OAAO;IAC3B;;;;;;;;;;OAUG;4BACmB,OAAO,CAAC,OAAO,CAAC;kBAG1B,qBAAqB;mBAClB,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;gBAY3D,mBAAmB;iBAChB,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAW/D,iFAAiF;;wBAI7D,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;yBAI/C,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;8BAOzC,OAAO,CAAC,IAAI,CAAC;0BACjB,OAAO,CAAC,IAAI,CAAC;sBACjB,OAAO,CAAC,IAAI,CAAC;sBACb,wBAAwB;uBACrB,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;;QAcxE,8CAA8C;;QAE9C,qCAAqC;gCACb,MAAM;QAC9B,6EAA6E;oCACjD,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;CAMtD,CAAA"}