@mentra/engine 0.1.0-dev.0

package/build/facades/ota.d.ts

@@ -0,0 +1,103 @@
+/**
+ * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's
+ * OtaService projects the glasses' OTA BLE events into the engine store; this facade
+ * exposes the snapshot + change subscriptions the host renders its update prompt and
+ * progress UI from. No host-injected UI — the host owns all alerts/navigation/i18n.
+ *
+ * Availability checks live in engine. Install orchestration lives in engine too:
+ * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host
+ * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import type { OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo } from "@mentra/bluetooth-sdk/internal";
+import { type OtaInstallSnapshot } from "../services/OtaInstallCoordinator";
+import { type OtaCheckCurrentGlassesOptions, type OtaCheckCurrentGlassesResult } from "../services/OtaUpdateCheckService";
+declare function projectSnapshot(): {
+    connected: boolean;
+    buildNumber: string | null;
+    mtkFirmwareVersion: string | null;
+    besFirmwareVersion: string | null;
+    wifiConnected: boolean;
+    wifiStatusKnown: boolean;
+    manifestUrl: string;
+    updateAvailable: OtaUpdateInfo | null;
+    status: OtaStatus | null;
+    legacyProgress: OtaProgress | null;
+    inProgress: boolean;
+    mtkUpdatedThisSession: boolean;
+};
+export type OtaSnapshot = ReturnType<typeof projectSnapshot>;
+export type { OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo, OtaInstallSnapshot, OtaCheckCurrentGlassesOptions, OtaCheckCurrentGlassesResult, };
+export declare const ota: {
+    /**
+     * Start the firmware install with the resolved OTA manifest URL. Progress lands on
+     * `status()`/`onStatus()`. (The host resolves the manifest URL — dev-override/env/prod
+     * resolution stays with the OTA config; the host-side stuck/retry watchdog is its own
+     * resilience layer on top of this command.)
+     */
+    install: (otaVersionUrl?: string | null | undefined) => Promise<import("@mentra/bluetooth-sdk").OtaStartAckEvent>;
+    /**
+     * Keep glasses awake while an OTA session is actively progressing.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    ping: () => Promise<void>;
+    /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */
+    checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => Promise<OtaCheckCurrentGlassesResult>;
+    /** Clear the available-update prompt state. */
+    clearUpdateAvailable: () => void;
+    /** Clear active progress/status before entering a fresh install flow. */
+    clearProgress: () => void;
+    /**
+     * Replace the pending update sequence after an in-flow firmware revalidation.
+     * Kept as a named OTA policy operation so host screens do not mutate the raw
+     * glasses store.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    replacePendingUpdateSequence: (updates: OtaUpdateInfo["updates"]) => OtaUpdateInfo | null;
+    /**
+     * Clear stale build metadata before returning to the update-check screen.
+     * This forces the next version_info event through both the native observable
+     * store and the engine projection after an APK reboot.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    clearBuildNumberForNextCheck: () => void;
+    /**
+     * Mark MTK as already applied during this app session until the glasses reboot/disconnect.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    markMtkUpdatedThisSession: (updated: boolean) => void;
+    /**
+     * The OTA install state machine (unified `ota_status` sessions, build >= 37).
+     * The host progress screen attaches on mount, detaches on unmount, and renders
+     * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.
+     */
+    installSession: {
+        /** Bind the machine to the mounted progress screen. Idempotent per attach/detach cycle. */
+        attach: () => void;
+        /** Unbind on unmount: clears all timers/listeners and resets session state. */
+        detach: () => void;
+        /** Retry after a failure: clear state and re-send ota_start (if connected). */
+        retry: () => void;
+        /** Terminal cleanup for Continue/Done (navigation stays in the screen). */
+        finish: () => void;
+        /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */
+        discard: () => void;
+        /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */
+        snapshot: () => OtaInstallSnapshot;
+        /** Subscribe to install snapshot changes (deduped on projected JSON). Returns an unsubscribe. */
+        onSnapshot: (cb: (snapshot: OtaInstallSnapshot) => void) => (() => void);
+    };
+    /** Current available-update info (versionName/updates/totalSize), or null. */
+    updateAvailable: () => OtaUpdateInfo | null;
+    /** Current OTA install status (stepType/phase/percent/status/error), or null. */
+    status: () => OtaStatus | null;
+    /** Current OTA read model for update prompt/progress screens. */
+    snapshot: () => OtaSnapshot;
+    /** Subscribe to OTA availability changes (info or null when cleared). Returns an unsubscribe. */
+    onUpdateAvailable: (cb: (info: OtaUpdateInfo | null) => void) => (() => void);
+    /** Subscribe to OTA install status changes. Returns an unsubscribe. */
+    onStatus: (cb: (status: OtaStatus | null) => void) => (() => void);
+    /** Subscribe to OTA snapshot changes. Returns an unsubscribe. */
+    onSnapshot: (cb: (snapshot: OtaSnapshot) => void) => (() => void);
+};
+//# sourceMappingURL=ota.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AACzD,OAAO,KAAK,EAAC,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAC,MAAM,gCAAgC,CAAA;AAG5G,OAAO,EAAwB,KAAK,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AAChG,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,eAAe;;;;;;;;;;;;;EAgBvB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,GAC7B,CAAA;AAED,eAAO,MAAM,GAAG;IAEd;;;;;OAKG;;IASH;;;OAGG;;IAEH,sGAAsG;gCAC1E,6BAA6B;IACzD,+CAA+C;;IAE/C,yEAAyE;;IAMzE;;;;;OAKG;4CACqC,aAAa,CAAC,SAAS,CAAC,KAAG,aAAa,GAAG,IAAI;IAQvF;;;;;OAKG;;IAKH;;;OAGG;yCACkC,OAAO;IAE5C;;;;OAIG;;QAED,2FAA2F;;QAE3F,+EAA+E;;QAE/E,+EAA+E;;QAE/E,2EAA2E;;QAE3E,uGAAuG;;QAEvG,qFAAqF;wBACvE,kBAAkB;QAChC,iGAAiG;yBAChF,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAGxE,8EAA8E;2BACzD,aAAa,GAAG,IAAI;IACzC,iFAAiF;kBACrE,SAAS,GAAG,IAAI;IAC5B,iEAAiE;oBACnD,WAAW;IAEzB,iGAAiG;4BACzE,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAU3E,uEAAuE;mBACxD,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAUhE,iEAAiE;qBAChD,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAUhE,CAAA"}

package/build/facades/ota.js

@@ -0,0 +1,156 @@
+/**
+ * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's
+ * OtaService projects the glasses' OTA BLE events into the engine store; this facade
+ * exposes the snapshot + change subscriptions the host renders its update prompt and
+ * progress UI from. No host-injected UI — the host owns all alerts/navigation/i18n.
+ *
+ * Availability checks live in engine. Install orchestration lives in engine too:
+ * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host
+ * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { isGlassesConnected, useGlassesStore } from "../stores/glasses";
+import { getAsgOtaVersionUrl } from "../services/asgOtaVersionUrl";
+import { otaInstallCoordinator } from "../services/OtaInstallCoordinator";
+import { checkCurrentGlassesForUpdate, } from "../services/OtaUpdateCheckService";
+function projectSnapshot() {
+    const s = useGlassesStore.getState();
+    return {
+        connected: isGlassesConnected(s.connection),
+        buildNumber: s.buildNumber || null,
+        mtkFirmwareVersion: s.mtkFirmwareVersion || null,
+        besFirmwareVersion: s.besFirmwareVersion || null,
+        wifiConnected: s.wifi.state === "connected",
+        wifiStatusKnown: s.wifiStatusKnown,
+        manifestUrl: getAsgOtaVersionUrl(s.otaVersionUrl, s.buildNumber),
+        updateAvailable: s.otaUpdateAvailable,
+        status: s.otaStatus,
+        legacyProgress: s.otaProgress,
+        inProgress: s.otaInProgress,
+        mtkUpdatedThisSession: s.mtkUpdatedThisSession,
+    };
+}
+export const ota = {
+    // --- actions ---
+    /**
+     * Start the firmware install with the resolved OTA manifest URL. Progress lands on
+     * `status()`/`onStatus()`. (The host resolves the manifest URL — dev-override/env/prod
+     * resolution stays with the OTA config; the host-side stuck/retry watchdog is its own
+     * resilience layer on top of this command.)
+     */
+    install: (...args) => BluetoothSdk.startOtaUpdate(...args),
+    // Deferred: this facade entry was intended to become the engine-owned retry/check
+    // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it
+    // here would make callers think the rich otaUpdateAvailable read model is refreshed,
+    // while the original view still depends on the host-side manifest compare to build
+    // versionName/updates/totalSize. Keep that behavior unchanged until the whole rich
+    // availability check moves into engine.
+    // retry: () => BluetoothSdk.checkForOtaUpdate(),
+    /**
+     * Keep glasses awake while an OTA session is actively progressing.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    ping: () => BluetoothSdk.ping(),
+    /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */
+    checkForUpdates: (options) => checkCurrentGlassesForUpdate(options),
+    /** Clear the available-update prompt state. */
+    clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),
+    /** Clear active progress/status before entering a fresh install flow. */
+    clearProgress: () => {
+        const store = useGlassesStore.getState();
+        store.setOtaProgress(null);
+        store.setOtaStatus(null);
+    },
+    /**
+     * Replace the pending update sequence after an in-flow firmware revalidation.
+     * Kept as a named OTA policy operation so host screens do not mutate the raw
+     * glasses store.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    replacePendingUpdateSequence: (updates) => {
+        const store = useGlassesStore.getState();
+        const current = store.otaUpdateAvailable;
+        if (!current)
+            return null;
+        const next = { ...current, updates };
+        store.setOtaUpdateAvailable(next);
+        return next;
+    },
+    /**
+     * Clear stale build metadata before returning to the update-check screen.
+     * This forces the next version_info event through both the native observable
+     * store and the engine projection after an APK reboot.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    clearBuildNumberForNextCheck: () => {
+        BluetoothSdk.updateGlasses({ buildNumber: "" });
+        useGlassesStore.getState().setGlassesInfo({ buildNumber: "" });
+    },
+    /**
+     * Mark MTK as already applied during this app session until the glasses reboot/disconnect.
+     * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
+     */
+    markMtkUpdatedThisSession: (updated) => useGlassesStore.getState().setMtkUpdatedThisSession(updated),
+    /**
+     * The OTA install state machine (unified `ota_status` sessions, build >= 37).
+     * The host progress screen attaches on mount, detaches on unmount, and renders
+     * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.
+     */
+    installSession: {
+        /** Bind the machine to the mounted progress screen. Idempotent per attach/detach cycle. */
+        attach: () => otaInstallCoordinator.attach(),
+        /** Unbind on unmount: clears all timers/listeners and resets session state. */
+        detach: () => otaInstallCoordinator.detach(),
+        /** Retry after a failure: clear state and re-send ota_start (if connected). */
+        retry: () => otaInstallCoordinator.retry(),
+        /** Terminal cleanup for Continue/Done (navigation stays in the screen). */
+        finish: () => otaInstallCoordinator.finish(),
+        /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */
+        discard: () => otaInstallCoordinator.discard(),
+        /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */
+        snapshot: () => otaInstallCoordinator.snapshot(),
+        /** Subscribe to install snapshot changes (deduped on projected JSON). Returns an unsubscribe. */
+        onSnapshot: (cb) => otaInstallCoordinator.onSnapshot(cb),
+    },
+    /** Current available-update info (versionName/updates/totalSize), or null. */
+    updateAvailable: () => useGlassesStore.getState().otaUpdateAvailable,
+    /** Current OTA install status (stepType/phase/percent/status/error), or null. */
+    status: () => useGlassesStore.getState().otaStatus,
+    /** Current OTA read model for update prompt/progress screens. */
+    snapshot: () => projectSnapshot(),
+    /** Subscribe to OTA availability changes (info or null when cleared). Returns an unsubscribe. */
+    onUpdateAvailable: (cb) => {
+        let last = useGlassesStore.getState().otaUpdateAvailable;
+        return useGlassesStore.subscribe(() => {
+            const info = useGlassesStore.getState().otaUpdateAvailable;
+            if (info === last)
+                return;
+            last = info;
+            cb(info);
+        });
+    },
+    /** Subscribe to OTA install status changes. Returns an unsubscribe. */
+    onStatus: (cb) => {
+        let last = useGlassesStore.getState().otaStatus;
+        return useGlassesStore.subscribe(() => {
+            const status = useGlassesStore.getState().otaStatus;
+            if (status === last)
+                return;
+            last = status;
+            cb(status);
+        });
+    },
+    /** Subscribe to OTA snapshot changes. Returns an unsubscribe. */
+    onSnapshot: (cb) => {
+        let last = JSON.stringify(projectSnapshot());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectSnapshot();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+};
+//# sourceMappingURL=ota.js.map

package/build/facades/ota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ota.js","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's\n * OtaService projects the glasses' OTA BLE events into the engine store; this facade\n * exposes the snapshot + change subscriptions the host renders its update prompt and\n * progress UI from. No host-injected UI — the host owns all alerts/navigation/i18n.\n *\n * Availability checks live in engine. Install orchestration lives in engine too:\n * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host\n * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo} from \"@mentra/bluetooth-sdk/internal\"\nimport {isGlassesConnected, useGlassesStore} from \"../stores/glasses\"\nimport {getAsgOtaVersionUrl} from \"../services/asgOtaVersionUrl\"\nimport {otaInstallCoordinator, type OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport {\n  checkCurrentGlassesForUpdate,\n  type OtaCheckCurrentGlassesOptions,\n  type OtaCheckCurrentGlassesResult,\n} from \"../services/OtaUpdateCheckService\"\n\nfunction projectSnapshot() {\n  const s = useGlassesStore.getState()\n  return {\n    connected: isGlassesConnected(s.connection),\n    buildNumber: s.buildNumber || null,\n    mtkFirmwareVersion: s.mtkFirmwareVersion || null,\n    besFirmwareVersion: s.besFirmwareVersion || null,\n    wifiConnected: s.wifi.state === \"connected\",\n    wifiStatusKnown: s.wifiStatusKnown,\n    manifestUrl: getAsgOtaVersionUrl(s.otaVersionUrl, s.buildNumber),\n    updateAvailable: s.otaUpdateAvailable,\n    status: s.otaStatus,\n    legacyProgress: s.otaProgress,\n    inProgress: s.otaInProgress,\n    mtkUpdatedThisSession: s.mtkUpdatedThisSession,\n  }\n}\n\nexport type OtaSnapshot = ReturnType<typeof projectSnapshot>\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  OtaInstallSnapshot,\n  OtaCheckCurrentGlassesOptions,\n  OtaCheckCurrentGlassesResult,\n}\n\nexport const ota = {\n  // --- actions ---\n  /**\n   * Start the firmware install with the resolved OTA manifest URL. Progress lands on\n   * `status()`/`onStatus()`. (The host resolves the manifest URL — dev-override/env/prod\n   * resolution stays with the OTA config; the host-side stuck/retry watchdog is its own\n   * resilience layer on top of this command.)\n   */\n  install: (...args: Parameters<typeof BluetoothSdk.startOtaUpdate>) => BluetoothSdk.startOtaUpdate(...args),\n  // Deferred: this facade entry was intended to become the engine-owned retry/check\n  // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it\n  // here would make callers think the rich otaUpdateAvailable read model is refreshed,\n  // while the original view still depends on the host-side manifest compare to build\n  // versionName/updates/totalSize. Keep that behavior unchanged until the whole rich\n  // availability check moves into engine.\n  // retry: () => BluetoothSdk.checkForOtaUpdate(),\n  /**\n   * Keep glasses awake while an OTA session is actively progressing.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  ping: () => BluetoothSdk.ping(),\n  /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */\n  checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => checkCurrentGlassesForUpdate(options),\n  /** Clear the available-update prompt state. */\n  clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),\n  /** Clear active progress/status before entering a fresh install flow. */\n  clearProgress: () => {\n    const store = useGlassesStore.getState()\n    store.setOtaProgress(null)\n    store.setOtaStatus(null)\n  },\n  /**\n   * Replace the pending update sequence after an in-flow firmware revalidation.\n   * Kept as a named OTA policy operation so host screens do not mutate the raw\n   * glasses store.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  replacePendingUpdateSequence: (updates: OtaUpdateInfo[\"updates\"]): OtaUpdateInfo | null => {\n    const store = useGlassesStore.getState()\n    const current = store.otaUpdateAvailable\n    if (!current) return null\n    const next = {...current, updates}\n    store.setOtaUpdateAvailable(next)\n    return next\n  },\n  /**\n   * Clear stale build metadata before returning to the update-check screen.\n   * This forces the next version_info event through both the native observable\n   * store and the engine projection after an APK reboot.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  clearBuildNumberForNextCheck: () => {\n    BluetoothSdk.updateGlasses({buildNumber: \"\"})\n    useGlassesStore.getState().setGlassesInfo({buildNumber: \"\"})\n  },\n  /**\n   * Mark MTK as already applied during this app session until the glasses reboot/disconnect.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  markMtkUpdatedThisSession: (updated: boolean) => useGlassesStore.getState().setMtkUpdatedThisSession(updated),\n\n  /**\n   * The OTA install state machine (unified `ota_status` sessions, build >= 37).\n   * The host progress screen attaches on mount, detaches on unmount, and renders\n   * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.\n   */\n  installSession: {\n    /** Bind the machine to the mounted progress screen. Idempotent per attach/detach cycle. */\n    attach: () => otaInstallCoordinator.attach(),\n    /** Unbind on unmount: clears all timers/listeners and resets session state. */\n    detach: () => otaInstallCoordinator.detach(),\n    /** Retry after a failure: clear state and re-send ota_start (if connected). */\n    retry: () => otaInstallCoordinator.retry(),\n    /** Terminal cleanup for Continue/Done (navigation stays in the screen). */\n    finish: () => otaInstallCoordinator.finish(),\n    /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */\n    discard: () => otaInstallCoordinator.discard(),\n    /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */\n    snapshot: (): OtaInstallSnapshot => otaInstallCoordinator.snapshot(),\n    /** Subscribe to install snapshot changes (deduped on projected JSON). Returns an unsubscribe. */\n    onSnapshot: (cb: (snapshot: OtaInstallSnapshot) => void): (() => void) => otaInstallCoordinator.onSnapshot(cb),\n  },\n\n  /** Current available-update info (versionName/updates/totalSize), or null. */\n  updateAvailable: (): OtaUpdateInfo | null => useGlassesStore.getState().otaUpdateAvailable,\n  /** Current OTA install status (stepType/phase/percent/status/error), or null. */\n  status: (): OtaStatus | null => useGlassesStore.getState().otaStatus,\n  /** Current OTA read model for update prompt/progress screens. */\n  snapshot: (): OtaSnapshot => projectSnapshot(),\n\n  /** Subscribe to OTA availability changes (info or null when cleared). Returns an unsubscribe. */\n  onUpdateAvailable: (cb: (info: OtaUpdateInfo | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaUpdateAvailable\n    return useGlassesStore.subscribe(() => {\n      const info = useGlassesStore.getState().otaUpdateAvailable\n      if (info === last) return\n      last = info\n      cb(info)\n    })\n  },\n\n  /** Subscribe to OTA install status changes. Returns an unsubscribe. */\n  onStatus: (cb: (status: OtaStatus | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaStatus\n    return useGlassesStore.subscribe(() => {\n      const status = useGlassesStore.getState().otaStatus\n      if (status === last) return\n      last = status\n      cb(status)\n    })\n  },\n\n  /** Subscribe to OTA snapshot changes. Returns an unsubscribe. */\n  onSnapshot: (cb: (snapshot: OtaSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectSnapshot())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectSnapshot()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n}\n"]}

package/build/facades/pairing.d.ts

@@ -0,0 +1,114 @@
+import type { ConnectOptions, Device, PairFailureEvent, GlassesNotReadyEvent } from "@mentra/bluetooth-sdk";
+import { useCoreStore } from "../stores/core";
+import { type IdentitySnapshot } from "../services/PairingIdentity";
+import { type AutomaticReportSubmissionStatus } from "../services/AutomaticReportResult";
+export type { IdentitySnapshot } from "../services/PairingIdentity";
+export interface PairingReadyWaitOptions {
+    deviceModel?: string;
+    deviceName?: string;
+    timeoutMs?: number;
+    route?: string;
+    signal?: AbortSignal;
+}
+declare function projectReadiness(): {
+    state: "connecting" | "connected" | "disconnected" | "scanning" | "bonding";
+    connected: boolean;
+    fullyBooted: boolean;
+    bluetoothClassicConnected: boolean;
+    nativeLinkBusy: boolean;
+};
+export type PairingReadinessSnapshot = ReturnType<typeof projectReadiness>;
+export declare function submitPairingBootTimeoutReport(params: {
+    deviceModel?: string;
+    deviceName?: string;
+    showGlassesBooting: boolean;
+    elapsedMs: number;
+    route?: string;
+}): Promise<AutomaticReportSubmissionStatus>;
+declare function waitForReadyDuringPairing(options?: PairingReadyWaitOptions): Promise<boolean>;
+declare function waitForBluetoothClassic(options?: Pick<PairingReadyWaitOptions, "timeoutMs" | "signal">): Promise<boolean>;
+export declare const pairing: {
+    readiness: () => PairingReadinessSnapshot;
+    onReadiness: (cb: (readiness: PairingReadinessSnapshot) => void) => (() => void);
+    /** The identity lifecycle snapshot: none | pending (chosen, never paired) | paired. */
+    identity: () => IdentitySnapshot;
+    /** Subscribe to identity changes; fires only when the projected snapshot changes.
+     * Returns an unsubscribe. */
+    onIdentity: (cb: (identity: IdentitySnapshot) => void) => (() => void);
+    /** Mark the chosen model as the pending selection (the scan-entry write); the
+     * host renders it as a finish-pairing affordance until pairing succeeds. */
+    markPendingSelection: (model: string) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Start scanning for nearby glasses. Results land on `searchResults()`/`onFound()`. */
+    scan: (model: import("@mentra/bluetooth-sdk").DeviceModel) => Promise<void>;
+    /** Whether a scan is currently in progress. */
+    scanning: () => boolean;
+    /** Subscribe to scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */
+    onScanning: (cb: (scanning: boolean) => void) => (() => void);
+    /** Whether a controller scan is currently in progress. */
+    scanningController: () => boolean;
+    /** Subscribe to controller-scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */
+    onScanningController: (cb: (scanning: boolean) => void) => (() => void);
+    /** Whether the phone has another Bluetooth (audio) device connected — the BT Classic pairing hint. */
+    otherBtConnected: () => boolean;
+    /** Subscribe to other-Bluetooth-device-connected changes; fires only when it changes. Returns an unsubscribe. */
+    onOtherBtConnected: (cb: (connected: boolean) => void) => (() => void);
+    /** The current scan results (snapshot). */
+    searchResults: () => {
+        id: string;
+        model: import("@mentra/bluetooth-sdk").DeviceModel;
+        name: string;
+        address?: string;
+        rssi?: number;
+    }[];
+    /** Subscribe to scan-result changes; fires only when they change. Returns an unsubscribe. */
+    onFound: (cb: (results: ReturnType<typeof useCoreStore.getState>["searchResults"]) => void) => (() => void);
+    /**
+     * Pair with (connect to) a discovered device. Two-phase identity: the connect
+     * attempt only marks the device as pending (`saveAsDefault: false` — no eager
+     * default-device write); the native layer promotes it to the default wearable
+     * when pairing actually succeeds (handleDeviceReady), so an abandoned or
+     * failed attempt can't leave a default identity with no paired device behind.
+     */
+    pair: (device: Device, options?: ConnectOptions) => Promise<void>;
+    /** Set a device as the default for subsequent `glasses.connectDefault()`. */
+    setDefault: (device: Device | null) => Promise<void>;
+    /**
+     * Prime the native Bluetooth Classic audio watcher with the picked device.
+     * The iOS Mentra Live flow pairs Classic audio BEFORE any BLE connect
+     * exists, and native detects the pairing by matching the connected audio
+     * route against its device_name — which two-phase identity no longer sets
+     * at selection time. This is native-only routing state (device_name has no
+     * native→JS echo): the phone's persisted identity is untouched, and
+     * promotion still happens only at pairing success.
+     */
+    setBluetoothClassicTarget: (device: Device) => Promise<void>;
+    /**
+     * Abandon an in-flight pairing attempt (back-out, failure retry, conflict
+     * retry) without destroying an existing pairing. The decision comes from the
+     * LIVE hydrated default-device read — never from flow-entry state, because a
+     * pairing can PROMOTE while the flow is open (the glasses finish pairing
+     * even as the user backs out of the UI), and an entry snapshot would forget
+     * that brand-new pairing:
+     * - Default device exists and glasses are connected (nothing in flight — an
+     *   attempt drops the link first): stop the scan, touch nothing else.
+     * - Default device exists with an attempt in flight: cancel it, then re-seed
+     *   the native identity from the phone's persisted settings — the attempt's
+     *   connect-by-name overwrote the native device_name, so a later
+     *   connectDefault() would otherwise target the abandoned device.
+     * - No default device (genuinely unpaired attempt): also forget, clearing
+     *   the partial native pairing state.
+     * The read fails OPEN to "preserve" — a transient failure must never wipe a
+     * real pairing. The `pending_wearable` marker is deliberately left alone —
+     * the host renders it as a finish-pairing affordance.
+     */
+    abandonAttempt: () => Promise<void>;
+    /** Subscribe to pairing failures; returns an unsubscribe. */
+    onPairFailure: (cb: (event: PairFailureEvent) => void) => (() => void);
+    /** Subscribe to glasses-not-ready events during pairing; returns an unsubscribe. */
+    onGlassesNotReady: (cb: (event: GlassesNotReadyEvent) => void) => (() => void);
+    /** Wait for paired glasses to finish booting; engine files the timeout diagnostic. */
+    waitForReady: typeof waitForReadyDuringPairing;
+    /** Wait briefly for Bluetooth Classic to come up after BLE pairing. */
+    waitForBluetoothClassic: typeof waitForBluetoothClassic;
+};
+//# sourceMappingURL=pairing.d.ts.map

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

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