@mentra/engine 0.1.0-beta.0 → 0.1.0-dev.1

package/src/facades/miniapps.ts

@@ -9,6 +9,7 @@
  * `<WebView>` wired to them. This facade is the lifecycle half.
  */
 import {useAppStatusStore} from "../stores/apps"
+import localMiniappRuntime from "../services/LocalMiniappRuntime"
 import type {ClientApp} from "../types"
 
 type AppsState = ReturnType<typeof useAppStatusStore.getState>
@@ -29,6 +30,12 @@ export const miniapps = {
     })
   },
 
+  /** Miniapps actively subscribed to Mentra Live hardware-button events. */
+  buttonPressSubscribers: (): string[] => localMiniappRuntime.getButtonPressSubscribers(),
+  /** Observe the active Mentra Live hardware-button subscriber set. */
+  onButtonPressSubscribersChanged: (cb: (packageNames: string[]) => void): (() => void) =>
+    localMiniappRuntime.onButtonPressSubscribersChanged(cb),
+
   /** Re-fetch the installed-app list from the backend. */
   refresh: () => useAppStatusStore.getState().refresh(),
   /** Start (foreground) a miniapp. */

package/src/facades/ota.ts

@@ -1,8 +1,8 @@
 /**
  * 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.
+ * exposes the snapshot + change subscriptions behind the shared OTA flow exported by
+ * `@mentra/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.
  *
  * Availability checks live in engine. Install orchestration lives in engine too:
  * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host
@@ -11,8 +11,10 @@
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
 import type {OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo} from "@mentra/bluetooth-sdk/internal"
 import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
-import {getAsgOtaVersionUrl} from "../services/asgOtaVersionUrl"
+import {resolveOtaManifestUrl} from "../services/otaManifestUrl"
 import {otaInstallCoordinator, type OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
+import {startGlassesStatusProjection} from "../services/GlassesStatusProjection"
+import {startOtaService} from "../services/OtaService"
 import {
   checkCurrentGlassesForUpdate,
   type OtaCheckCurrentGlassesOptions,
@@ -26,9 +28,10 @@ function projectSnapshot() {
     buildNumber: s.buildNumber || null,
     mtkFirmwareVersion: s.mtkFirmwareVersion || null,
     besFirmwareVersion: s.besFirmwareVersion || null,
+    hotspotOtaVersion: s.hotspotOtaVersion ?? 0,
     wifiConnected: s.wifi.state === "connected",
     wifiStatusKnown: s.wifiStatusKnown,
-    manifestUrl: getAsgOtaVersionUrl(s.otaVersionUrl, s.buildNumber),
+    manifestUrl: resolveOtaManifestUrl(s.otaVersionUrl, s.buildNumber),
     updateAvailable: s.otaUpdateAvailable,
     status: s.otaStatus,
     legacyProgress: s.otaProgress,
@@ -50,6 +53,16 @@ export type {
 
 export const ota = {
   // --- actions ---
+  /**
+   * Start the device-status and OTA projections without starting the authenticated
+   * cloud/miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.
+   * Idempotent and safe when the full engine runtime is already running.
+   */
+  initialize: async () => {
+    const hydrated = startGlassesStatusProjection()
+    startOtaService()
+    await hydrated
+  },
   /**
    * 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
@@ -115,6 +128,8 @@ export const ota = {
    * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.
    */
   installSession: {
+    /** Select Wi-Fi or capability-gated hotspot transport for this checked manifest. */
+    prepare: (result: OtaCheckCurrentGlassesResult) => otaInstallCoordinator.prepare(result),
     /** 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. */

package/src/facades/pairing.ts

@@ -291,25 +291,29 @@ export const pairing = {
       await BluetoothSdk.stopScan()
       return
     }
-    await BluetoothSdk.disconnect()
     if (projectPairingIdentity().kind === "paired") {
       // The persisted settings describe a COMPLETE pairing: restore it to
       // native (the attempt's connect-by-name overwrote the native
       // device_name; and if native somehow lost its default entirely, this
       // repairs the divergence instead of forgetting a real pairing).
       console.log("PairingIdentity: abandonAttempt — preserving pairing; attempt cancelled, native identity re-seeded")
+      await BluetoothSdk.disconnect()
       await pushAllBluetoothSettings()
-    } else if (nativeHasDefault) {
+      return
+    }
+    if (nativeHasDefault) {
       // Mid-relay: native promoted and its echoes are still landing — the
       // incomplete JS snapshot must not be pushed over the fresher native
       // identity (the on-connect replay's race). Native holds the truth.
       console.log("PairingIdentity: abandonAttempt — preserving pairing; JS identity mid-relay, native kept as-is")
-    } else {
-      // Forgetting requires CONSENSUS: no native default AND no complete
-      // persisted pairing — a genuinely partial attempt.
-      console.log("PairingIdentity: abandonAttempt — no pairing on either layer; forgetting the partial attempt")
-      await BluetoothSdk.forget()
+      await BluetoothSdk.disconnect()
+      return
     }
+    // Partial attempt: forget owns teardown. Do NOT disconnect() first — that
+    // nulls the MentraLive SGC and used to skip Classic removeBond, leaving
+    // IBRT ACL up so glasses never re-advertise for the next scan.
+    console.log("PairingIdentity: abandonAttempt — no pairing on either layer; forgetting the partial attempt")
+    await BluetoothSdk.forget()
   },
 
   /** Subscribe to pairing failures; returns an unsubscribe. */

package/src/facades/phoneNotifications.ts

@@ -3,25 +3,16 @@
  * notifications to the glasses, with a per-app blocklist. Android-only (the
  * NotificationListenerService); the getters return sensible defaults on iOS.
  *
- * Enabled-state + blocklist are engine settings (auto-synced to the native
- * listener); the installed-apps list + the listener permission are CrustModule.
+ * The per-app blocklist is an engine setting (auto-synced to the native
+ * listener); the installed-apps list + listener permission are CrustModule.
+ * Capture itself is controlled only by Android notification access and the
+ * hidden operational kill switch.
  */
 import {Platform} from "react-native"
 import CrustModule from "@mentra/crust"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
 
 export const phoneNotifications = {
-  /** Is phone-notification forwarding enabled? (false on iOS) */
-  enabled: (): boolean => {
-    if (Platform.OS !== "android") return false
-    return useSettingsStore.getState().getSetting(SETTINGS.notifications_enabled.key) ?? true
-  },
-  /** Enable/disable phone-notification forwarding. (no-op on iOS) */
-  setEnabled: (enabled: boolean) => {
-    if (Platform.OS !== "android") return
-    return useSettingsStore.getState().setSetting(SETTINGS.notifications_enabled.key, enabled)
-  },
-
   /** The phone's installed apps (package, name, icon). (empty on iOS) */
   installedApps: (): Promise<Array<{packageName: string; appName: string; icon: string | null}>> => {
     if (Platform.OS !== "android") return Promise.resolve([])

package/src/index.ts

@@ -32,6 +32,8 @@ export type {
   IslandConfigValues,
   IslandAnalytics,
   IslandUiSeams,
+  ScanQrOptions,
+  ScanQrResult,
   SubjectTokenType,
 } from "./runtime/bootstrap"
 
@@ -91,7 +93,6 @@ export {
   DOWNLOAD_STUCK_TIMEOUT_MS,
   MTK_INSTALL_TIMEOUT_MS,
   GLOBAL_OTA_TIMEOUT_MS,
-  POST_APK_OTA_START_DELAY_MS,
   PING_INTERVAL_MS,
   QUERY_REPLY_TIMEOUT_MS,
   OtaProgressMessages,
@@ -106,6 +107,24 @@ export type {
   OtaSnapshot,
   OtaInstallSnapshot,
 } from "./facades/ota"
+export {
+  beginOtaAutoChain,
+  clearOtaAutoChainReconnectWait,
+  isOtaAutoChainActive,
+  otaAutoChainFingerprint,
+  otaAutoChainReconnectWaitRemaining,
+  stopOtaAutoChain,
+  tryAdvanceOtaAutoChain,
+  MAX_OTA_AUTO_CHAIN_PASSES,
+  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,
+} from "./services/OtaAutoChain"
+export type {OtaAutoChainAdvanceResult} from "./services/OtaAutoChain"
+export {
+  BES_INSTALL_RESTART_MESSAGE,
+  getOtaErrorMessage,
+  shouldRequireGlassesRebootForBesFailure,
+  shouldShowChangeWifiForOtaDownloadFailure,
+} from "./services/OtaErrorMapping"
 
 // Gallery read models: engine.gallery.onNotice payload types, the media
 // permission helper + display-name derivation host gallery UI uses, and the
@@ -153,7 +172,12 @@ export {
 } from "./stores/apps"
 
 // Pure dev-miniapp launch-route decision (registration itself is internal).
-export {decideDevLaunchRoute, type DevLaunchResult, type DevManifest} from "./utils/devMiniappLaunch"
+export {
+  decideDevLaunchRoute,
+  type DecideDevLaunchOptions,
+  type DevLaunchResult,
+  type DevManifest,
+} from "./utils/devMiniappLaunch"
 export {HardwareCompatibility, type CompatibilityResult} from "./utils/hardware"
 export {BgTimer, throttle, debounce} from "./utils/timers"
 

package/src/internal.ts

@@ -30,6 +30,7 @@ export {
   getDevAppAttestation,
   DEV_APP_PACKAGE_NAME,
   type DevAppRecord,
+  type MiniappReleaseIdentity,
 } from "./services/AppRegistry"
 export {default as displayProcessor} from "./services/DisplayProcessor"
 export {default as localDisplayManager, type DisplayPayload} from "./services/LocalDisplayManager"
@@ -93,7 +94,7 @@ export {phoneLocationService, stopPhoneLocation} from "./services/PhoneLocationS
 // Clock-skew fix commands (BLE writes) used by OTA + gallery sync.
 export {fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo} from "./services/glassesClockSync"
 // OTA manifest-URL resolution (dev-override/legacy-build/env/prod).
-export {getAsgOtaVersionUrl} from "./services/asgOtaVersionUrl"
+export {resolveOtaManifestUrl} from "./services/otaManifestUrl"
 // Flat OTA check helpers (network + BLE state). Host usage is a tracked
 // burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().
 export {