@mentra/engine 0.1.0-beta.0

package/build/facades/glasses.js

@@ -0,0 +1,199 @@
+/**
+ * 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.
+ */
+// Internal btsdk surface — connectSimulated/reconnect/controller live on the full
+// surface, not the public entry. Relative path (the alias doesn't resolve in engine's
+// standalone build); jest moduleNameMapper + tsconfig both resolve it.
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useGlassesStore } from "../stores/glasses";
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+import { hasDefaultDevice } from "../services/DeviceStoreHydration";
+import { projectPairingIdentity } from "../services/PairingIdentity";
+import { isGlassesConnected, isGlassesReady } from "../services/GlassesReadiness";
+import { pushAllBluetoothSettings } from "../services/GlassesSettingsSync";
+import { getModelCapabilities } from "../types";
+import { glassesWifi } from "./glassesWifi";
+import { glassesSettings } from "./glassesSettings";
+function projectStatus() {
+    const s = useGlassesStore.getState();
+    return {
+        state: s.connection.state,
+        fullyBooted: isGlassesReady(s.connection),
+        battery: s.batteryLevel,
+        charging: s.charging,
+        case: { battery: s.caseBatteryLevel, charging: s.caseCharging, open: s.caseOpen, removed: s.caseRemoved },
+        signal: s.signalStrength,
+        micEnabled: s.micEnabled,
+        vadEnabled: s.voiceActivityDetectionEnabled,
+        btClassic: s.bluetoothClassicConnected,
+    };
+}
+function projectControllerStatus() {
+    const s = useGlassesStore.getState();
+    return {
+        connected: s.controllerConnected,
+        fullyBooted: s.controllerFullyBooted,
+        battery: s.controllerBatteryLevel,
+        signal: s.controllerSignalStrength,
+    };
+}
+function projectInfo() {
+    const s = useGlassesStore.getState();
+    return {
+        model: s.deviceModel,
+        style: s.style,
+        color: s.color,
+        bluetoothName: s.bluetoothName,
+        firmwareVersion: s.firmwareVersion,
+        mtkFirmware: s.mtkFirmwareVersion,
+        besFirmware: s.besFirmwareVersion,
+        appVersion: s.appVersion,
+        androidVersion: s.androidVersion,
+        serialNumber: s.serialNumber,
+        buildNumber: s.buildNumber,
+        btMac: s.bluetoothMacAddress,
+        leftMac: s.leftMacAddress,
+        rightMac: s.rightMacAddress,
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        wifi: { ...s.wifi },
+    };
+}
+export const glasses = {
+    // --- connection (bluetooth-sdk passthrough) ---
+    /**
+     * 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: async () => {
+        await pushAllBluetoothSettings();
+        return BluetoothSdk.connectDefault();
+    },
+    disconnect: () => BluetoothSdk.disconnect(),
+    forget: () => BluetoothSdk.forget(),
+    /** Connect to a specific (discovered) device. */
+    connect: async (...args) => {
+        await pushAllBluetoothSettings();
+        return BluetoothSdk.connect(...args);
+    },
+    /** Connect the built-in simulated glasses (dev/testing). */
+    connectSimulated: () => BluetoothSdk.connectSimulated(),
+    /** Set a device as the `connectDefault()` target. */
+    setDefault: (...args) => BluetoothSdk.setDefaultDevice(...args),
+    /**
+     * 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: async () => {
+        const defaultWearable = useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key);
+        if (!defaultWearable)
+            return false;
+        if (isGlassesConnected(useGlassesStore.getState().connection))
+            return true;
+        try {
+            await pushAllBluetoothSettings();
+            await BluetoothSdk.connectDefault();
+        }
+        catch (error) {
+            console.warn("engine.glasses.reconnect failed:", error);
+            return false;
+        }
+        return true;
+    },
+    /** 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: () => projectPairingIdentity().kind === "none",
+    /**
+     * 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: () => hasDefaultDevice(),
+    // --- read-model (projected from the engine-owned glasses store) ---
+    status: () => projectStatus(),
+    onStatus: (cb) => {
+        // Dedupe: the glasses store updates on many fields; only fire when the
+        // projected status snapshot actually changes.
+        let last = JSON.stringify(projectStatus());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectStatus();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    info: () => projectInfo(),
+    onInfo: (cb) => {
+        let last = JSON.stringify(projectInfo());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectInfo();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    capabilities: () => getModelCapabilities(useGlassesStore.getState().deviceModel),
+    /** Ask the glasses to report fresh firmware/version info (updates the store). */
+    requestVersionInfo: () => BluetoothSdk.requestVersionInfo(),
+    // --- discrete input events (passthrough listeners) ---
+    onButtonPress: (cb) => {
+        const sub = BluetoothSdk.addListener("button_press", cb);
+        return () => sub.remove();
+    },
+    onTouchGesture: (cb) => {
+        const sub = BluetoothSdk.addListener("touch_event", cb);
+        return () => sub.remove();
+    },
+    // --- ring controller (optional input device) ---
+    controller: {
+        connectDefault: () => BluetoothSdk.connectDefaultController(),
+        disconnect: () => BluetoothSdk.disconnectController(),
+        forget: () => BluetoothSdk.forgetController(),
+        status: () => projectControllerStatus(),
+        onStatus: (cb) => {
+            let last = JSON.stringify(projectControllerStatus());
+            return useGlassesStore.subscribe(() => {
+                const snap = projectControllerStatus();
+                const key = JSON.stringify(snap);
+                if (key === last)
+                    return;
+                last = key;
+                cb(snap);
+            });
+        },
+    },
+    // --- audio (glasses media-volume + own-app playback hint) ---
+    audio: {
+        /** Read the glasses' current media volume. */
+        getMediaVolume: () => BluetoothSdk.getGlassesMediaVolume(),
+        /** Set the glasses' media volume. */
+        setMediaVolume: (level) => BluetoothSdk.setGlassesMediaVolume(level),
+        /** Tell native whether THIS app is currently playing audio (for ducking). */
+        setOwnAppPlaying: (playing) => BluetoothSdk.setOwnAppAudioPlaying(playing),
+    },
+    // --- sub-facades ---
+    wifi: glassesWifi,
+    settings: glassesSettings,
+};
+//# sourceMappingURL=glasses.js.map

package/build/facades/glasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.js","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,kFAAkF;AAClF,sFAAsF;AACtF,uEAAuE;AACvE,OAAO,YAAY,MAAM,gCAAgC,CAAA;AAEzD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAC,gBAAgB,EAAC,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAC,sBAAsB,EAAC,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAC,kBAAkB,EAAE,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC/E,OAAO,EAAC,wBAAwB,EAAC,MAAM,iCAAiC,CAAA;AACxE,OAAO,EAAC,oBAAoB,EAAmB,MAAM,UAAU,CAAA;AAC/D,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AACzC,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AAEjD,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACpC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;QACzB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC;QACzC,OAAO,EAAE,CAAC,CAAC,YAAY;QACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,EAAC,OAAO,EAAE,CAAC,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAC;QACvG,MAAM,EAAE,CAAC,CAAC,cAAc;QACxB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,6BAA6B;QAC3C,SAAS,EAAE,CAAC,CAAC,yBAAyB;KACvC,CAAA;AACH,CAAC;AAED,SAAS,uBAAuB;IAC9B,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACpC,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,mBAAmB;QAChC,WAAW,EAAE,CAAC,CAAC,qBAAqB;QACpC,OAAO,EAAE,CAAC,CAAC,sBAAsB;QACjC,MAAM,EAAE,CAAC,CAAC,wBAAwB;KACnC,CAAA;AACH,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IACpC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,WAAW;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,WAAW,EAAE,CAAC,CAAC,kBAAkB;QACjC,WAAW,EAAE,CAAC,CAAC,kBAAkB;QACjC,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,KAAK,EAAE,CAAC,CAAC,mBAAmB;QAC5B,OAAO,EAAE,CAAC,CAAC,cAAc;QACzB,QAAQ,EAAE,CAAC,CAAC,eAAe;QAC3B,+EAA+E;QAC/E,IAAI,EAAE,EAAC,GAAG,CAAC,CAAC,IAAI,EAAC;KAClB,CAAA;AACH,CAAC;AAMD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,iDAAiD;IACjD;;;;OAIG;IACH,cAAc,EAAE,KAAK,IAAmB,EAAE;QACxC,MAAM,wBAAwB,EAAE,CAAA;QAChC,OAAO,YAAY,CAAC,cAAc,EAAE,CAAA;IACtC,CAAC;IACD,UAAU,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE;IAC1D,MAAM,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE;IAClD,iDAAiD;IACjD,OAAO,EAAE,KAAK,EAAE,GAAG,IAA6C,EAAiB,EAAE;QACjF,MAAM,wBAAwB,EAAE,CAAA;QAChC,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IACD,4DAA4D;IAC5D,gBAAgB,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE;IACtE,qDAAqD;IACrD,UAAU,EAAE,CAAC,GAAG,IAAsD,EAAE,EAAE,CAAC,YAAY,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACjH;;;;;;OAMG;IACH,SAAS,EAAE,KAAK,IAAsB,EAAE;QACtC,MAAM,eAAe,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;QAC7F,IAAI,CAAC,eAAe;YAAE,OAAO,KAAK,CAAA;QAClC,IAAI,kBAAkB,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAA;QAC1E,IAAI,CAAC;YACH,MAAM,wBAAwB,EAAE,CAAA;YAChC,MAAM,YAAY,CAAC,cAAc,EAAE,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAA;YACvD,OAAO,KAAK,CAAA;QACd,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD;;;iEAG6D;IAC7D,cAAc,EAAE,GAAY,EAAE,CAAC,sBAAsB,EAAE,CAAC,IAAI,KAAK,MAAM;IACvE;;;;;;;;;;OAUG;IACH,gBAAgB,EAAE,GAAqB,EAAE,CAAC,gBAAgB,EAAE;IAE5D,qEAAqE;IACrE,MAAM,EAAE,GAA0B,EAAE,CAAC,aAAa,EAAE;IACpD,QAAQ,EAAE,CAAC,EAA2C,EAAgB,EAAE;QACtE,uEAAuE;QACvE,8CAA8C;QAC9C,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAA;QAC1C,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAA;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,EAAE,GAAwB,EAAE,CAAC,WAAW,EAAE;IAC9C,MAAM,EAAE,CAAC,EAAuC,EAAgB,EAAE;QAChE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;QACxC,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAA;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,YAAY,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,WAA0B,CAAC;IAC/F,iFAAiF;IACjF,kBAAkB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE;IAE3D,wDAAwD;IACxD,aAAa,EAAE,CAAC,EAAqC,EAAgB,EAAE;QACrE,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;QACxD,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IACD,cAAc,EAAE,CAAC,EAA+B,EAAgB,EAAE;QAChE,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;QACvD,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,kDAAkD;IAClD,UAAU,EAAE;QACV,cAAc,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,wBAAwB,EAAE;QAC5E,UAAU,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE;QACpE,MAAM,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE;QAC5D,MAAM,EAAE,GAA6B,EAAE,CAAC,uBAAuB,EAAE;QACjE,QAAQ,EAAE,CAAC,EAA8C,EAAgB,EAAE;YACzE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,EAAE,CAAC,CAAA;YACpD,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,EAAE;gBACpC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAA;gBACtC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;gBAChC,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAM;gBACxB,IAAI,GAAG,GAAG,CAAA;gBACV,EAAE,CAAC,IAAI,CAAC,CAAA;YACV,CAAC,CAAC,CAAA;QACJ,CAAC;KACF;IAED,+DAA+D;IAC/D,KAAK,EAAE;QACL,8CAA8C;QAC9C,cAAc,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,qBAAqB,EAAE;QAC1D,qCAAqC;QACrC,cAAc,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,qBAAqB,CAAC,KAAK,CAAC;QAC5E,6EAA6E;QAC7E,gBAAgB,EAAE,CAAC,OAAgB,EAAiB,EAAE,CAAC,YAAY,CAAC,qBAAqB,CAAC,OAAO,CAAC;KACnG;IAED,sBAAsB;IACtB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;CAC1B,CAAA","sourcesContent":["/**\n * glasses facade — the core `engine.glasses.*` surface: connection actions (over\n * the bluetooth-sdk passthrough), a curated status/info read-model (projected from\n * the engine-owned glasses store), capabilities (from the model table), and the\n * discrete input events. The `wifi` sub-facade is nested here.\n *\n * Read-models project the raw glasses store into the stable shape OEM UIs consume,\n * so the device store's field layout doesn't leak into every screen.\n */\n// Internal btsdk surface — connectSimulated/reconnect/controller live on the full\n// surface, not the public entry. Relative path (the alias doesn't resolve in engine's\n// standalone build); jest moduleNameMapper + tsconfig both resolve it.\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {ButtonPressEvent, TouchEvent} from \"@mentra/bluetooth-sdk/internal\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {hasDefaultDevice} from \"../services/DeviceStoreHydration\"\nimport {projectPairingIdentity} from \"../services/PairingIdentity\"\nimport {isGlassesConnected, isGlassesReady} from \"../services/GlassesReadiness\"\nimport {pushAllBluetoothSettings} from \"../services/GlassesSettingsSync\"\nimport {getModelCapabilities, type DeviceTypes} from \"../types\"\nimport {glassesWifi} from \"./glassesWifi\"\nimport {glassesSettings} from \"./glassesSettings\"\n\nfunction projectStatus() {\n  const s = useGlassesStore.getState()\n  return {\n    state: s.connection.state,\n    fullyBooted: isGlassesReady(s.connection),\n    battery: s.batteryLevel,\n    charging: s.charging,\n    case: {battery: s.caseBatteryLevel, charging: s.caseCharging, open: s.caseOpen, removed: s.caseRemoved},\n    signal: s.signalStrength,\n    micEnabled: s.micEnabled,\n    vadEnabled: s.voiceActivityDetectionEnabled,\n    btClassic: s.bluetoothClassicConnected,\n  }\n}\n\nfunction projectControllerStatus() {\n  const s = useGlassesStore.getState()\n  return {\n    connected: s.controllerConnected,\n    fullyBooted: s.controllerFullyBooted,\n    battery: s.controllerBatteryLevel,\n    signal: s.controllerSignalStrength,\n  }\n}\n\nfunction projectInfo() {\n  const s = useGlassesStore.getState()\n  return {\n    model: s.deviceModel,\n    style: s.style,\n    color: s.color,\n    bluetoothName: s.bluetoothName,\n    firmwareVersion: s.firmwareVersion,\n    mtkFirmware: s.mtkFirmwareVersion,\n    besFirmware: s.besFirmwareVersion,\n    appVersion: s.appVersion,\n    androidVersion: s.androidVersion,\n    serialNumber: s.serialNumber,\n    buildNumber: s.buildNumber,\n    btMac: s.bluetoothMacAddress,\n    leftMac: s.leftMacAddress,\n    rightMac: s.rightMacAddress,\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    wifi: {...s.wifi},\n  }\n}\n\nexport type GlassesStatusSnapshot = ReturnType<typeof projectStatus>\nexport type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>\nexport type GlassesInfoSnapshot = ReturnType<typeof projectInfo>\n\nexport const glasses = {\n  // --- connection (bluetooth-sdk passthrough) ---\n  /**\n   * Reconnect the default wearable. Seeds the phone's current device settings to\n   * native first, so they're primed before the connect handshake replays them to\n   * the glasses (this used to be a host-side step before `connectDefault`).\n   */\n  connectDefault: async (): Promise<void> => {\n    await pushAllBluetoothSettings()\n    return BluetoothSdk.connectDefault()\n  },\n  disconnect: (): Promise<void> => BluetoothSdk.disconnect(),\n  forget: (): Promise<void> => BluetoothSdk.forget(),\n  /** Connect to a specific (discovered) device. */\n  connect: async (...args: Parameters<typeof BluetoothSdk.connect>): Promise<void> => {\n    await pushAllBluetoothSettings()\n    return BluetoothSdk.connect(...args)\n  },\n  /** Connect the built-in simulated glasses (dev/testing). */\n  connectSimulated: (): Promise<void> => BluetoothSdk.connectSimulated(),\n  /** Set a device as the `connectDefault()` target. */\n  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),\n  /**\n   * Reconnect to the saved default glasses. Resolves `false` when there's nothing to\n   * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered\n   * off), `true` when already connected or after kicking off the connect. Never\n   * rejects — the boolean contract holds. The host gates connectivity/permissions\n   * (its UI) before calling.\n   */\n  reconnect: async (): Promise<boolean> => {\n    const defaultWearable = useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key)\n    if (!defaultWearable) return false\n    if (isGlassesConnected(useGlassesStore.getState().connection)) return true\n    try {\n      await pushAllBluetoothSettings()\n      await BluetoothSdk.connectDefault()\n    } catch (error) {\n      console.warn(\"engine.glasses.reconnect failed:\", error)\n      return false\n    }\n    return true\n  },\n  /** True when no glasses has ever been paired NOR selected (the pairing-identity\n   * lifecycle is in its `none` state) — e.g. to route a first-run host into the\n   * pairing/onboarding flow. A pending selection is not \"first\" — the host should\n   * offer finish-pairing (see `engine.pairing.identity()`). */\n  isFirstPairing: (): boolean => projectPairingIdentity().kind === \"none\",\n  /**\n   * True when the SDK has an actual default DEVICE to reconnect to. Distinct from\n   * `default_wearable` (a model string that a pending or orphaned selection can\n   * hold without any paired device): connectDefault() throws without a device, so\n   * hosts should route to the pairing flow when this is false.\n   *\n   * Hydration-aware: awaits the device-store seed internally, so a cold-start\n   * read can't see a false \"absent\" for genuinely-paired users. Rejects if\n   * hydration failed — callers guarding destructive or routing decisions must\n   * fail open (treat as \"has a device\").\n   */\n  hasDefaultDevice: (): Promise<boolean> => hasDefaultDevice(),\n\n  // --- read-model (projected from the engine-owned glasses store) ---\n  status: (): GlassesStatusSnapshot => projectStatus(),\n  onStatus: (cb: (status: GlassesStatusSnapshot) => void): (() => void) => {\n    // Dedupe: the glasses store updates on many fields; only fire when the\n    // projected status snapshot actually changes.\n    let last = JSON.stringify(projectStatus())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectStatus()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n  info: (): GlassesInfoSnapshot => projectInfo(),\n  onInfo: (cb: (info: GlassesInfoSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectInfo())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectInfo()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n  capabilities: () => getModelCapabilities(useGlassesStore.getState().deviceModel as DeviceTypes),\n  /** Ask the glasses to report fresh firmware/version info (updates the store). */\n  requestVersionInfo: () => BluetoothSdk.requestVersionInfo(),\n\n  // --- discrete input events (passthrough listeners) ---\n  onButtonPress: (cb: (event: ButtonPressEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"button_press\", cb)\n    return () => sub.remove()\n  },\n  onTouchGesture: (cb: (event: TouchEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"touch_event\", cb)\n    return () => sub.remove()\n  },\n\n  // --- ring controller (optional input device) ---\n  controller: {\n    connectDefault: (): Promise<void> => BluetoothSdk.connectDefaultController(),\n    disconnect: (): Promise<void> => BluetoothSdk.disconnectController(),\n    forget: (): Promise<void> => BluetoothSdk.forgetController(),\n    status: (): ControllerStatusSnapshot => projectControllerStatus(),\n    onStatus: (cb: (status: ControllerStatusSnapshot) => void): (() => void) => {\n      let last = JSON.stringify(projectControllerStatus())\n      return useGlassesStore.subscribe(() => {\n        const snap = projectControllerStatus()\n        const key = JSON.stringify(snap)\n        if (key === last) return\n        last = key\n        cb(snap)\n      })\n    },\n  },\n\n  // --- audio (glasses media-volume + own-app playback hint) ---\n  audio: {\n    /** Read the glasses' current media volume. */\n    getMediaVolume: () => BluetoothSdk.getGlassesMediaVolume(),\n    /** Set the glasses' media volume. */\n    setMediaVolume: (level: number) => BluetoothSdk.setGlassesMediaVolume(level),\n    /** Tell native whether THIS app is currently playing audio (for ducking). */\n    setOwnAppPlaying: (playing: boolean): Promise<void> => BluetoothSdk.setOwnAppAudioPlaying(playing),\n  },\n\n  // --- sub-facades ---\n  wifi: glassesWifi,\n  settings: glassesSettings,\n}\n"]}

package/build/facades/glassesSettings.d.ts

@@ -0,0 +1,13 @@
+export declare const glassesSettings: {
+    /** Read a device setting by key (object/array values are shallow copies). */
+    get: <T = unknown>(key: string) => T | undefined;
+    /** Write a device setting — persists and auto-syncs to the connected glasses. */
+    set: <T = unknown>(key: string, value: T) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Subscribe to changes for one device-setting key; returns an unsubscribe. */
+    onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void) => (() => void);
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key: string) => import("../stores/settings").Setting;
+    /** The device-setting keys synced to the glasses (excludes internal sync keys). */
+    available: () => string[];
+};
+//# sourceMappingURL=glassesSettings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glassesSettings.d.ts","sourceRoot":"","sources":["../../src/facades/glassesSettings.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,eAAe;IAC1B,6EAA6E;UACvE,CAAC,iBAAiB,MAAM,KAAG,CAAC,GAAG,SAAS;IAE9C,iFAAiF;UAC3E,CAAC,iBAAiB,MAAM,SAAS,CAAC;IACxC,+EAA+E;gBACnE,CAAC,iBAAiB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAEvF,+EAA+E;sBAC7D,MAAM;IACxB,mFAAmF;qBAEpE,MAAM,EAAE;CACxB,CAAA"}

package/build/facades/glassesSettings.js

@@ -0,0 +1,54 @@
+/**
+ * glasses.settings facade — `engine.glasses.settings`: the keyed DEVICE-settings
+ * surface (brightness, head-up angle, dashboard, camera/button, sensing, …). These
+ * are the settings the engine store auto-syncs to the glasses over the bluetooth-sdk
+ * (`BLUETOOTH_SETTING_KEYS`), so `set()` both persists and pushes to the device.
+ *
+ * Distinct from `engine.settings` (user/app prefs): this is scoped to the
+ * hardware-facing keys, minus the internal sync keys (auth/token) that aren't
+ * user-tunable device settings.
+ */
+import { useSettingsStore, SETTINGS, BLUETOOTH_SETTING_KEYS } from "../stores/settings";
+// Keys carried on BLUETOOTH_SETTING_KEYS for the device handshake that are NOT
+// user-tunable settings — auth, device/controller IDENTITY (set by pairing), and
+// internal RUNTIME flags. Kept out of the OEM-facing `available()` surface.
+const INTERNAL_KEYS = new Set([
+    // auth
+    SETTINGS.core_token.key,
+    SETTINGS.auth_email.key,
+    // glasses + controller identity (managed by pairing, not the user)
+    SETTINGS.pending_wearable.key,
+    SETTINGS.default_wearable.key,
+    SETTINGS.device_name.key,
+    SETTINGS.device_address.key,
+    SETTINGS.pending_controller.key,
+    SETTINGS.default_controller.key,
+    SETTINGS.controller_device_name.key,
+    SETTINGS.controller_address.key,
+    // internal runtime flags
+    SETTINGS.local_stt_fallback_active.key,
+]);
+const DEVICE_KEYS = BLUETOOTH_SETTING_KEYS.filter((k) => !INTERNAL_KEYS.has(k));
+// Copy: object/array-valued settings must not hand callers a mutable reference
+// into the store (mutations would bypass persistence + Bluetooth sync).
+function copySettingValue(value) {
+    if (Array.isArray(value))
+        return [...value];
+    if (value && typeof value === "object")
+        return { ...value };
+    return value;
+}
+export const glassesSettings = {
+    /** Read a device setting by key (object/array values are shallow copies). */
+    get: (key) => copySettingValue(useSettingsStore.getState().getSetting(key)),
+    /** Write a device setting — persists and auto-syncs to the connected glasses. */
+    set: (key, value) => useSettingsStore.getState().setSetting(key, value),
+    /** Subscribe to changes for one device-setting key; returns an unsubscribe. */
+    onChanged: (key, cb) => useSettingsStore.subscribe((s) => s.getSetting(key), cb),
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key) => SETTINGS[key],
+    /** The device-setting keys synced to the glasses (excludes internal sync keys). */
+    // Copy: callers must not be able to mutate the module-level key list.
+    available: () => [...DEVICE_KEYS],
+};
+//# sourceMappingURL=glassesSettings.js.map

package/build/facades/glassesSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glassesSettings.js","sourceRoot":"","sources":["../../src/facades/glassesSettings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAE,sBAAsB,EAAC,MAAM,oBAAoB,CAAA;AAErF,+EAA+E;AAC/E,iFAAiF;AACjF,4EAA4E;AAC5E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS;IACpC,OAAO;IACP,QAAQ,CAAC,UAAU,CAAC,GAAG;IACvB,QAAQ,CAAC,UAAU,CAAC,GAAG;IACvB,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,CAAC,GAAG;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,GAAG;IAC7B,QAAQ,CAAC,WAAW,CAAC,GAAG;IACxB,QAAQ,CAAC,cAAc,CAAC,GAAG;IAC3B,QAAQ,CAAC,kBAAkB,CAAC,GAAG;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,GAAG;IAC/B,QAAQ,CAAC,sBAAsB,CAAC,GAAG;IACnC,QAAQ,CAAC,kBAAkB,CAAC,GAAG;IAC/B,yBAAyB;IACzB,QAAQ,CAAC,yBAAyB,CAAC,GAAG;CACvC,CAAC,CAAA;AACF,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AAE/E,+EAA+E;AAC/E,wEAAwE;AACxE,SAAS,gBAAgB,CAAI,KAAQ;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,KAAK,CAAM,CAAA;IAChD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAC,GAAI,KAAgB,EAAM,CAAA;IAC1E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,6EAA6E;IAC7E,GAAG,EAAE,CAAc,GAAW,EAAiB,EAAE,CAC/C,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,CAAkB,CAAC;IAChF,iFAAiF;IACjF,GAAG,EAAE,CAAc,GAAW,EAAE,KAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC;IAC/F,+EAA+E;IAC/E,SAAS,EAAE,CAAc,GAAW,EAAE,EAAkC,EAAgB,EAAE,CACxF,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAkB,EAAE,EAAE,CAAC;IAC3E,+EAA+E;IAC/E,UAAU,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC1C,mFAAmF;IACnF,sEAAsE;IACtE,SAAS,EAAE,GAAa,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC;CAC5C,CAAA","sourcesContent":["/**\n * glasses.settings facade — `engine.glasses.settings`: the keyed DEVICE-settings\n * surface (brightness, head-up angle, dashboard, camera/button, sensing, …). These\n * are the settings the engine store auto-syncs to the glasses over the bluetooth-sdk\n * (`BLUETOOTH_SETTING_KEYS`), so `set()` both persists and pushes to the device.\n *\n * Distinct from `engine.settings` (user/app prefs): this is scoped to the\n * hardware-facing keys, minus the internal sync keys (auth/token) that aren't\n * user-tunable device settings.\n */\nimport {useSettingsStore, SETTINGS, BLUETOOTH_SETTING_KEYS} from \"../stores/settings\"\n\n// Keys carried on BLUETOOTH_SETTING_KEYS for the device handshake that are NOT\n// user-tunable settings — auth, device/controller IDENTITY (set by pairing), and\n// internal RUNTIME flags. Kept out of the OEM-facing `available()` surface.\nconst INTERNAL_KEYS = new Set<string>([\n  // auth\n  SETTINGS.core_token.key,\n  SETTINGS.auth_email.key,\n  // glasses + controller identity (managed by pairing, not the user)\n  SETTINGS.pending_wearable.key,\n  SETTINGS.default_wearable.key,\n  SETTINGS.device_name.key,\n  SETTINGS.device_address.key,\n  SETTINGS.pending_controller.key,\n  SETTINGS.default_controller.key,\n  SETTINGS.controller_device_name.key,\n  SETTINGS.controller_address.key,\n  // internal runtime flags\n  SETTINGS.local_stt_fallback_active.key,\n])\nconst DEVICE_KEYS = BLUETOOTH_SETTING_KEYS.filter((k) => !INTERNAL_KEYS.has(k))\n\n// Copy: object/array-valued settings must not hand callers a mutable reference\n// into the store (mutations would bypass persistence + Bluetooth sync).\nfunction copySettingValue<T>(value: T): T {\n  if (Array.isArray(value)) return [...value] as T\n  if (value && typeof value === \"object\") return {...(value as object)} as T\n  return value\n}\n\nexport const glassesSettings = {\n  /** Read a device setting by key (object/array values are shallow copies). */\n  get: <T = unknown>(key: string): T | undefined =>\n    copySettingValue(useSettingsStore.getState().getSetting(key) as T | undefined),\n  /** Write a device setting — persists and auto-syncs to the connected glasses. */\n  set: <T = unknown>(key: string, value: T) => useSettingsStore.getState().setSetting(key, value),\n  /** Subscribe to changes for one device-setting key; returns an unsubscribe. */\n  onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void): (() => void) =>\n    useSettingsStore.subscribe((s) => s.getSetting(key) as T | undefined, cb),\n  /** The schema descriptor for a key (type, default, options…), or undefined. */\n  descriptor: (key: string) => SETTINGS[key],\n  /** The device-setting keys synced to the glasses (excludes internal sync keys). */\n  // Copy: callers must not be able to mutate the module-level key list.\n  available: (): string[] => [...DEVICE_KEYS],\n}\n"]}

package/build/facades/glassesWifi.d.ts

@@ -0,0 +1,25 @@
+import type { WifiSearchResult, WifiStatus } from "@mentra/bluetooth-sdk";
+export type { WifiSearchResult, WifiStatus };
+export declare const glassesWifi: {
+    /** Scan for nearby wifi networks. Request/response — resolves with the results. */
+    scan(): Promise<WifiSearchResult[]>;
+    /**
+     * Subscribe to streamed scan results: the glasses report networks one by one
+     * while a scan runs, so callers can render them as they arrive instead of
+     * waiting for the final `scan()` result. Returns an unsubscribe.
+     */
+    onScanResult(cb: (networks: WifiSearchResult[]) => void): () => void;
+    /**
+     * Send wifi credentials to the glasses. Resolves on success; rejects with the
+     * bluetooth-sdk coded error (`bluetooth_powered_off`, `request_timeout`, …) on
+     * failure, propagated unchanged for the caller to map.
+     */
+    connect(ssid: string, password: string): Promise<void>;
+    /** Forget a saved network on the glasses. */
+    forget(ssid: string): Promise<void>;
+    /** The glasses' current wifi connection status (snapshot). */
+    status(): WifiStatus;
+    /** Subscribe to wifi-status changes (current, previous); returns an unsubscribe. */
+    onStatus(cb: (status: WifiStatus, previous: WifiStatus) => void): () => void;
+};
+//# sourceMappingURL=glassesWifi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glassesWifi.d.ts","sourceRoot":"","sources":["../../src/facades/glassesWifi.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAA;AAGvE,YAAY,EAAC,gBAAgB,EAAE,UAAU,EAAC,CAAA;AAE1C,eAAO,MAAM,WAAW;IACtB,mFAAmF;YAC3E,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAInC;;;;OAIG;qBACc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAOpE;;;;OAIG;kBACiB,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,6CAA6C;iBAC1B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,8DAA8D;cACpD,UAAU;IAKpB,oFAAoF;iBACvE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAO7E,CAAA"}

package/build/facades/glassesWifi.js

@@ -0,0 +1,57 @@
+/**
+ * glasses.wifi facade — the first typed engine facade over the bluetooth-sdk
+ * passthrough, and the reference pattern the rest of the (A) host API copies.
+ *
+ * A facade wraps the raw `@mentra/bluetooth-sdk` surface into a small, typed,
+ * device-agnostic API (the `doX()` action shape here; `getX()`/`onX()` read-models
+ * come with domains that own their state). The host UI calls `engine.glasses.wifi.*`
+ * instead of importing bluetooth-sdk directly — that's the native-import boundary
+ * the engine is built around.
+ *
+ * `connect()` propagates bluetooth-sdk's coded errors unchanged so callers keep
+ * their existing error mapping. The `status()`/`onStatus()` read-model reads the
+ * glasses-state store engine now owns (wifi status is derived there from the
+ * device's connection info).
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk";
+import { useGlassesStore } from "../stores/glasses";
+export const glassesWifi = {
+    /** Scan for nearby wifi networks. Request/response — resolves with the results. */
+    scan() {
+        return BluetoothSdk.requestWifiScan();
+    },
+    /**
+     * Subscribe to streamed scan results: the glasses report networks one by one
+     * while a scan runs, so callers can render them as they arrive instead of
+     * waiting for the final `scan()` result. Returns an unsubscribe.
+     */
+    onScanResult(cb) {
+        const sub = BluetoothSdk.addListener("wifi_scan_result", (event) => {
+            cb(event.networks);
+        });
+        return () => sub.remove();
+    },
+    /**
+     * Send wifi credentials to the glasses. Resolves on success; rejects with the
+     * bluetooth-sdk coded error (`bluetooth_powered_off`, `request_timeout`, …) on
+     * failure, propagated unchanged for the caller to map.
+     */
+    async connect(ssid, password) {
+        await BluetoothSdk.sendWifiCredentials(ssid, password);
+    },
+    /** Forget a saved network on the glasses. */
+    async forget(ssid) {
+        await BluetoothSdk.forgetWifiNetwork(ssid);
+    },
+    /** The glasses' current wifi connection status (snapshot). */
+    status() {
+        // Copy: the snapshot must not hand callers a mutable reference into the store.
+        return { ...useGlassesStore.getState().wifi };
+    },
+    /** Subscribe to wifi-status changes (current, previous); returns an unsubscribe. */
+    onStatus(cb) {
+        // Copy: like status(), never publish the store's live wifi objects to listeners.
+        return useGlassesStore.subscribe((s) => s.wifi, (wifi, previous) => cb({ ...wifi }, { ...previous }));
+    },
+};
+//# sourceMappingURL=glassesWifi.js.map

package/build/facades/glassesWifi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glassesWifi.js","sourceRoot":"","sources":["../../src/facades/glassesWifi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,YAAY,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AAIjD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,mFAAmF;IACnF,IAAI;QACF,OAAO,YAAY,CAAC,eAAe,EAAE,CAAA;IACvC,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,EAA0C;QACrD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;YACjE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB;QAC1C,MAAM,YAAY,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACxD,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC;IAED,8DAA8D;IAC9D,MAAM;QACJ,+EAA+E;QAC/E,OAAO,EAAC,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAC,CAAA;IAC7C,CAAC;IAED,oFAAoF;IACpF,QAAQ,CAAC,EAAsD;QAC7D,iFAAiF;QACjF,OAAO,eAAe,CAAC,SAAS,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EACb,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAC,GAAG,IAAI,EAAC,EAAE,EAAC,GAAG,QAAQ,EAAC,CAAC,CACjD,CAAA;IACH,CAAC;CACF,CAAA","sourcesContent":["/**\n * glasses.wifi facade — the first typed engine facade over the bluetooth-sdk\n * passthrough, and the reference pattern the rest of the (A) host API copies.\n *\n * A facade wraps the raw `@mentra/bluetooth-sdk` surface into a small, typed,\n * device-agnostic API (the `doX()` action shape here; `getX()`/`onX()` read-models\n * come with domains that own their state). The host UI calls `engine.glasses.wifi.*`\n * instead of importing bluetooth-sdk directly — that's the native-import boundary\n * the engine is built around.\n *\n * `connect()` propagates bluetooth-sdk's coded errors unchanged so callers keep\n * their existing error mapping. The `status()`/`onStatus()` read-model reads the\n * glasses-state store engine now owns (wifi status is derived there from the\n * device's connection info).\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk\"\nimport type {WifiSearchResult, WifiStatus} from \"@mentra/bluetooth-sdk\"\nimport {useGlassesStore} from \"../stores/glasses\"\n\nexport type {WifiSearchResult, WifiStatus}\n\nexport const glassesWifi = {\n  /** Scan for nearby wifi networks. Request/response — resolves with the results. */\n  scan(): Promise<WifiSearchResult[]> {\n    return BluetoothSdk.requestWifiScan()\n  },\n\n  /**\n   * Subscribe to streamed scan results: the glasses report networks one by one\n   * while a scan runs, so callers can render them as they arrive instead of\n   * waiting for the final `scan()` result. Returns an unsubscribe.\n   */\n  onScanResult(cb: (networks: WifiSearchResult[]) => void): () => void {\n    const sub = BluetoothSdk.addListener(\"wifi_scan_result\", (event) => {\n      cb(event.networks)\n    })\n    return () => sub.remove()\n  },\n\n  /**\n   * Send wifi credentials to the glasses. Resolves on success; rejects with the\n   * bluetooth-sdk coded error (`bluetooth_powered_off`, `request_timeout`, …) on\n   * failure, propagated unchanged for the caller to map.\n   */\n  async connect(ssid: string, password: string): Promise<void> {\n    await BluetoothSdk.sendWifiCredentials(ssid, password)\n  },\n\n  /** Forget a saved network on the glasses. */\n  async forget(ssid: string): Promise<void> {\n    await BluetoothSdk.forgetWifiNetwork(ssid)\n  },\n\n  /** The glasses' current wifi connection status (snapshot). */\n  status(): WifiStatus {\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    return {...useGlassesStore.getState().wifi}\n  },\n\n  /** Subscribe to wifi-status changes (current, previous); returns an unsubscribe. */\n  onStatus(cb: (status: WifiStatus, previous: WifiStatus) => void): () => void {\n    // Copy: like status(), never publish the store's live wifi objects to listeners.\n    return useGlassesStore.subscribe(\n      (s) => s.wifi,\n      (wifi, previous) => cb({...wifi}, {...previous}),\n    )\n  },\n}\n"]}

package/build/facades/miniapps.d.ts

@@ -0,0 +1,43 @@
+/**
+ * miniapps facade — `engine.miniapps`: miniapp lifecycle over the engine-owned
+ * apps store. Thin forwarding (args via Parameters<>), so the facade never drifts
+ * from the store's actions.
+ *
+ * The miniapp WebView is a HOST component (engine ships the bridge, not the view) —
+ * the bridge primitives (`buildMiniappGlobalsScript`, `buildMentraUiShim`, the
+ * MentraJS router) are exported from `@mentra/engine` directly; the host mounts a
+ * `<WebView>` wired to them. This facade is the lifecycle half.
+ */
+import { useAppStatusStore } from "../stores/apps";
+import type { ClientApp } from "../types";
+type AppsState = ReturnType<typeof useAppStatusStore.getState>;
+export declare const miniapps: {
+    /** All installed miniapps (snapshot). */
+    list: () => ClientApp[];
+    /** Subscribe to the installed-app set; fires only when it changes. Returns an unsubscribe. */
+    onChanged: (cb: (apps: ClientApp[]) => void) => (() => void);
+    /** Re-fetch the installed-app list from the backend. */
+    refresh: () => Promise<void>;
+    /** Start (foreground) a miniapp. */
+    start: (app: ClientApp, opts?: import("..").StartOptions | undefined) => Promise<boolean>;
+    /** Stop a miniapp. */
+    stop: (packageName: string) => Promise<void>;
+    /** Bring a running miniapp to the foreground. */
+    setForeground: (packageName: string) => Promise<void>;
+    /** Clear the current foreground miniapp. */
+    clearForeground: () => void;
+    /** Stop all running miniapps. */
+    stopAll: () => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Install a miniapp from a bundle URL. */
+    install: (url: string, opts?: {
+        versionOverride?: string;
+    } | undefined) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Uninstall a miniapp. */
+    uninstall: (packageName: string, version?: string | undefined) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Persist a miniapp's captured screenshot (the switcher/card preview). */
+    saveScreenshot: (packageName: string, screenshot: string) => Promise<void>;
+    /** Hide/show a miniapp on the home surfaces. */
+    setHiddenStatus: (packageName: string, status: boolean) => void;
+};
+export {};
+//# sourceMappingURL=miniapps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"miniapps.d.ts","sourceRoot":"","sources":["../../src/facades/miniapps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAEvC,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAA;AAE9D,eAAO,MAAM,QAAQ;IACnB,yCAAyC;gBAE/B,SAAS,EAAE;IACrB,8FAA8F;oBAC9E,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAW1D,wDAAwD;;IAExD,oCAAoC;;IAEpC,sBAAsB;;IAEtB,iDAAiD;;IAGjD,4CAA4C;;IAE5C,iCAAiC;;IAEjC,2CAA2C;;;;IAE3C,2BAA2B;;IAE3B,2EAA2E;;IAG3E,gDAAgD;;CAGjD,CAAA"}

package/build/facades/miniapps.js

@@ -0,0 +1,49 @@
+/**
+ * miniapps facade — `engine.miniapps`: miniapp lifecycle over the engine-owned
+ * apps store. Thin forwarding (args via Parameters<>), so the facade never drifts
+ * from the store's actions.
+ *
+ * The miniapp WebView is a HOST component (engine ships the bridge, not the view) —
+ * the bridge primitives (`buildMiniappGlobalsScript`, `buildMentraUiShim`, the
+ * MentraJS router) are exported from `@mentra/engine` directly; the host mounts a
+ * `<WebView>` wired to them. This facade is the lifecycle half.
+ */
+import { useAppStatusStore } from "../stores/apps";
+export const miniapps = {
+    /** All installed miniapps (snapshot). */
+    // Copy: the snapshot must not hand callers a mutable reference into the store.
+    list: () => [...useAppStatusStore.getState().apps],
+    /** Subscribe to the installed-app set; fires only when it changes. Returns an unsubscribe. */
+    onChanged: (cb) => {
+        let last = JSON.stringify(useAppStatusStore.getState().apps);
+        return useAppStatusStore.subscribe(() => {
+            const apps = useAppStatusStore.getState().apps;
+            const key = JSON.stringify(apps);
+            if (key === last)
+                return;
+            last = key;
+            cb(apps);
+        });
+    },
+    /** Re-fetch the installed-app list from the backend. */
+    refresh: () => useAppStatusStore.getState().refresh(),
+    /** Start (foreground) a miniapp. */
+    start: (...args) => useAppStatusStore.getState().start(...args),
+    /** Stop a miniapp. */
+    stop: (...args) => useAppStatusStore.getState().stop(...args),
+    /** Bring a running miniapp to the foreground. */
+    setForeground: (...args) => useAppStatusStore.getState().setForeground(...args),
+    /** Clear the current foreground miniapp. */
+    clearForeground: () => useAppStatusStore.getState().clearForeground(),
+    /** Stop all running miniapps. */
+    stopAll: () => useAppStatusStore.getState().stopAll(),
+    /** Install a miniapp from a bundle URL. */
+    install: (...args) => useAppStatusStore.getState().install(...args),
+    /** Uninstall a miniapp. */
+    uninstall: (...args) => useAppStatusStore.getState().uninstall(...args),
+    /** Persist a miniapp's captured screenshot (the switcher/card preview). */
+    saveScreenshot: (...args) => useAppStatusStore.getState().saveScreenshot(...args),
+    /** Hide/show a miniapp on the home surfaces. */
+    setHiddenStatus: (...args) => useAppStatusStore.getState().setHiddenStatus(...args),
+};
+//# sourceMappingURL=miniapps.js.map

package/build/facades/miniapps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniapps.js","sourceRoot":"","sources":["../../src/facades/miniapps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAA;AAKhD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,yCAAyC;IACzC,+EAA+E;IAC/E,IAAI,EAAE,GAAgB,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;IAC/D,8FAA8F;IAC9F,SAAS,EAAE,CAAC,EAA+B,EAAgB,EAAE;QAC3D,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAA;QAC5D,OAAO,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE;YACtC,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAA;YAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,wDAAwD;IACxD,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;IACrD,oCAAoC;IACpC,KAAK,EAAE,CAAC,GAAG,IAAoC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC/F,sBAAsB;IACtB,IAAI,EAAE,CAAC,GAAG,IAAmC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5F,iDAAiD;IACjD,aAAa,EAAE,CAAC,GAAG,IAA4C,EAAE,EAAE,CACjE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACrD,4CAA4C;IAC5C,eAAe,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,eAAe,EAAE;IACrE,iCAAiC;IACjC,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;IACrD,2CAA2C;IAC3C,OAAO,EAAE,CAAC,GAAG,IAAsC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACrG,2BAA2B;IAC3B,SAAS,EAAE,CAAC,GAAG,IAAwC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAC3G,2EAA2E;IAC3E,cAAc,EAAE,CAAC,GAAG,IAA6C,EAAE,EAAE,CACnE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACtD,gDAAgD;IAChD,eAAe,EAAE,CAAC,GAAG,IAA8C,EAAE,EAAE,CACrE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;CACxD,CAAA","sourcesContent":["/**\n * miniapps facade — `engine.miniapps`: miniapp lifecycle over the engine-owned\n * apps store. Thin forwarding (args via Parameters<>), so the facade never drifts\n * from the store's actions.\n *\n * The miniapp WebView is a HOST component (engine ships the bridge, not the view) —\n * the bridge primitives (`buildMiniappGlobalsScript`, `buildMentraUiShim`, the\n * MentraJS router) are exported from `@mentra/engine` directly; the host mounts a\n * `<WebView>` wired to them. This facade is the lifecycle half.\n */\nimport {useAppStatusStore} from \"../stores/apps\"\nimport type {ClientApp} from \"../types\"\n\ntype AppsState = ReturnType<typeof useAppStatusStore.getState>\n\nexport const miniapps = {\n  /** All installed miniapps (snapshot). */\n  // Copy: the snapshot must not hand callers a mutable reference into the store.\n  list: (): ClientApp[] => [...useAppStatusStore.getState().apps],\n  /** Subscribe to the installed-app set; fires only when it changes. Returns an unsubscribe. */\n  onChanged: (cb: (apps: ClientApp[]) => void): (() => void) => {\n    let last = JSON.stringify(useAppStatusStore.getState().apps)\n    return useAppStatusStore.subscribe(() => {\n      const apps = useAppStatusStore.getState().apps\n      const key = JSON.stringify(apps)\n      if (key === last) return\n      last = key\n      cb(apps)\n    })\n  },\n\n  /** Re-fetch the installed-app list from the backend. */\n  refresh: () => useAppStatusStore.getState().refresh(),\n  /** Start (foreground) a miniapp. */\n  start: (...args: Parameters<AppsState[\"start\"]>) => useAppStatusStore.getState().start(...args),\n  /** Stop a miniapp. */\n  stop: (...args: Parameters<AppsState[\"stop\"]>) => useAppStatusStore.getState().stop(...args),\n  /** Bring a running miniapp to the foreground. */\n  setForeground: (...args: Parameters<AppsState[\"setForeground\"]>) =>\n    useAppStatusStore.getState().setForeground(...args),\n  /** Clear the current foreground miniapp. */\n  clearForeground: () => useAppStatusStore.getState().clearForeground(),\n  /** Stop all running miniapps. */\n  stopAll: () => useAppStatusStore.getState().stopAll(),\n  /** Install a miniapp from a bundle URL. */\n  install: (...args: Parameters<AppsState[\"install\"]>) => useAppStatusStore.getState().install(...args),\n  /** Uninstall a miniapp. */\n  uninstall: (...args: Parameters<AppsState[\"uninstall\"]>) => useAppStatusStore.getState().uninstall(...args),\n  /** Persist a miniapp's captured screenshot (the switcher/card preview). */\n  saveScreenshot: (...args: Parameters<AppsState[\"saveScreenshot\"]>) =>\n    useAppStatusStore.getState().saveScreenshot(...args),\n  /** Hide/show a miniapp on the home surfaces. */\n  setHiddenStatus: (...args: Parameters<AppsState[\"setHiddenStatus\"]>) =>\n    useAppStatusStore.getState().setHiddenStatus(...args),\n}\n"]}

package/build/facades/notifications.d.ts

@@ -0,0 +1,13 @@
+/**
+ * notifications facade — `engine.notifications`: inbound alerts engine→host. The
+ * OEM subscribes and renders them however it likes (modal, toast, banner). Today:
+ * miniapp crashloop; version-incompatible miniapp and persistent connection loss
+ * land as their detectors are wired into the emitter.
+ */
+import { type IslandNotification } from "../services/NotificationsEmitter";
+export type { IslandNotification, IslandNotificationKind } from "../services/NotificationsEmitter";
+export declare const notifications: {
+    /** Subscribe to engine-raised notifications; returns an unsubscribe. */
+    onNotification: (cb: (notification: IslandNotification) => void) => (() => void);
+};
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/facades/notifications.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAsB,KAAK,kBAAkB,EAAC,MAAM,kCAAkC,CAAA;AAE7F,YAAY,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,kCAAkC,CAAA;AAEhG,eAAO,MAAM,aAAa;IACxB,wEAAwE;yBACnD,CAAC,YAAY,EAAE,kBAAkB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAE/E,CAAA"}

package/build/facades/notifications.js

@@ -0,0 +1,12 @@
+/**
+ * notifications facade — `engine.notifications`: inbound alerts engine→host. The
+ * OEM subscribes and renders them however it likes (modal, toast, banner). Today:
+ * miniapp crashloop; version-incompatible miniapp and persistent connection loss
+ * land as their detectors are wired into the emitter.
+ */
+import { islandNotifications } from "../services/NotificationsEmitter";
+export const notifications = {
+    /** Subscribe to engine-raised notifications; returns an unsubscribe. */
+    onNotification: (cb) => islandNotifications.subscribe(cb),
+};
+//# sourceMappingURL=notifications.js.map

package/build/facades/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/facades/notifications.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAC,mBAAmB,EAA0B,MAAM,kCAAkC,CAAA;AAI7F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,wEAAwE;IACxE,cAAc,EAAE,CAAC,EAA8C,EAAgB,EAAE,CAC/E,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;CACpC,CAAA","sourcesContent":["/**\n * notifications facade — `engine.notifications`: inbound alerts engine→host. The\n * OEM subscribes and renders them however it likes (modal, toast, banner). Today:\n * miniapp crashloop; version-incompatible miniapp and persistent connection loss\n * land as their detectors are wired into the emitter.\n */\nimport {islandNotifications, type IslandNotification} from \"../services/NotificationsEmitter\"\n\nexport type {IslandNotification, IslandNotificationKind} from \"../services/NotificationsEmitter\"\n\nexport const notifications = {\n  /** Subscribe to engine-raised notifications; returns an unsubscribe. */\n  onNotification: (cb: (notification: IslandNotification) => void): (() => void) =>\n    islandNotifications.subscribe(cb),\n}\n"]}