@mentra/engine 3.1.0-dev.21 → 3.1.0-dev.27

package/build/engine.d.ts

@@ -154,8 +154,8 @@ export declare const engine: {
             attach: () => void;
             detach: () => void;
             retry: () => void;
-            finish: () => void;
-            discard: () => void;
+            finish: () => Promise<void>;
+            discard: () => Promise<void>;
             snapshot: () => import(".").OtaInstallSnapshot;
             onSnapshot: (cb: (snapshot: import(".").OtaInstallSnapshot) => void) => (() => void);
         };

package/build/facades/ota.d.ts

@@ -76,10 +76,10 @@ export declare const ota: {
         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;
+        /** Terminal cleanup for Continue/Done, including hotspot route teardown. */
+        finish: () => Promise<void>;
+        /** Abandon an interrupted session: await finish() then drop the session's status/progress. */
+        discard: () => Promise<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. */

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

@@ -1 +1 @@
-{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAC,MAAM,uBAAuB,CAAA;AAGrH,OAAO,EAAwB,KAAK,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AAGhG,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,eAAe;;;;;;;;;;;;;;EAiBvB;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;;;;OAIG;;IAMH;;;;;OAKG;8BACuB,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE;;;OAGG;;IAEH,sGAAsG;gCAC1E,6BAA6B;IACzD,+CAA+C;;IAE/C,yEAAyE;;IAMzE;;;;;OAKG;4CACqC,aAAa,CAAC,SAAS,CAAC,KAAG,aAAa,GAAG,IAAI;IAQvF;;;;;OAKG;;IAIH;;;OAGG;yCACkC,OAAO;IAE5C;;;;OAIG;;QAED,oFAAoF;0BAClE,4BAA4B;QAC9C,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"}
+{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAC,MAAM,uBAAuB,CAAA;AAGrH,OAAO,EAAwB,KAAK,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AAGhG,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,eAAe;;;;;;;;;;;;;;EAiBvB;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;;;;OAIG;;IAMH;;;;;OAKG;8BACuB,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE;;;OAGG;;IAEH,sGAAsG;gCAC1E,6BAA6B;IACzD,+CAA+C;;IAE/C,yEAAyE;;IAMzE;;;;;OAKG;4CACqC,aAAa,CAAC,SAAS,CAAC,KAAG,aAAa,GAAG,IAAI;IAQvF;;;;;OAKG;;IAIH;;;OAGG;yCACkC,OAAO;IAE5C;;;;OAIG;;QAED,oFAAoF;0BAClE,4BAA4B;QAC9C,2FAA2F;;QAE3F,+EAA+E;;QAE/E,+EAA+E;;QAE/E,4EAA4E;;QAE5E,8FAA8F;;QAE9F,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

@@ -117,9 +117,9 @@ export const ota = {
         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). */
+        /** Terminal cleanup for Continue/Done, including hotspot route teardown. */
         finish: () => otaInstallCoordinator.finish(),
-        /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */
+        /** Abandon an interrupted session: await finish() then drop the session's status/progress. */
         discard: () => otaInstallCoordinator.discard(),
         /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */
         snapshot: () => otaInstallCoordinator.snapshot(),

package/build/facades/ota.js.map

@@ -1 +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 behind the shared OTA flow exported by\n * `@mentra/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.\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\"\nimport type {OtaProgress, OtaProgressStatus, OtaStartAckEvent, OtaStatus, OtaUpdateInfo} from \"@mentra/bluetooth-sdk\"\nimport {isGlassesConnected, useGlassesStore} from \"../stores/glasses\"\nimport {resolveOtaManifestUrl} from \"../services/otaManifestUrl\"\nimport {otaInstallCoordinator, type OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport {startGlassesStatusProjection} from \"../services/GlassesStatusProjection\"\nimport {startOtaService} from \"../services/OtaService\"\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    hotspotOtaVersion: s.hotspotOtaVersion ?? 0,\n    wifiConnected: s.wifi.state === \"connected\",\n    wifiStatusKnown: s.wifiStatusKnown,\n    manifestUrl: resolveOtaManifestUrl(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 device-status and OTA projections without starting the authenticated\n   * cloud/miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.\n   * Idempotent and safe when the full engine runtime is already running.\n   */\n  initialize: async () => {\n    const hydrated = startGlassesStatusProjection()\n    startOtaService()\n    await hydrated\n  },\n  /**\n   * Start the firmware install with the resolved OTA manifest URL. Progress lands on\n   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,\n   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own\n   * resilience layer on top of this command.)\n   */\n  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),\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    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    /** Select Wi-Fi or capability-gated hotspot transport for this checked manifest. */\n    prepare: (result: OtaCheckCurrentGlassesResult) => otaInstallCoordinator.prepare(result),\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"]}
+{"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 behind the shared OTA flow exported by\n * `@mentra/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.\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\"\nimport type {OtaProgress, OtaProgressStatus, OtaStartAckEvent, OtaStatus, OtaUpdateInfo} from \"@mentra/bluetooth-sdk\"\nimport {isGlassesConnected, useGlassesStore} from \"../stores/glasses\"\nimport {resolveOtaManifestUrl} from \"../services/otaManifestUrl\"\nimport {otaInstallCoordinator, type OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport {startGlassesStatusProjection} from \"../services/GlassesStatusProjection\"\nimport {startOtaService} from \"../services/OtaService\"\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    hotspotOtaVersion: s.hotspotOtaVersion ?? 0,\n    wifiConnected: s.wifi.state === \"connected\",\n    wifiStatusKnown: s.wifiStatusKnown,\n    manifestUrl: resolveOtaManifestUrl(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 device-status and OTA projections without starting the authenticated\n   * cloud/miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.\n   * Idempotent and safe when the full engine runtime is already running.\n   */\n  initialize: async () => {\n    const hydrated = startGlassesStatusProjection()\n    startOtaService()\n    await hydrated\n  },\n  /**\n   * Start the firmware install with the resolved OTA manifest URL. Progress lands on\n   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,\n   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own\n   * resilience layer on top of this command.)\n   */\n  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),\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    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    /** Select Wi-Fi or capability-gated hotspot transport for this checked manifest. */\n    prepare: (result: OtaCheckCurrentGlassesResult) => otaInstallCoordinator.prepare(result),\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, including hotspot route teardown. */\n    finish: () => otaInstallCoordinator.finish(),\n    /** Abandon an interrupted session: await finish() then 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/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const ENGINE_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.1.0",
-    "releaseIdentity": "3.1.0-dev.21",
-    "releaseSetId": "mentra-3.1.0-dev.21",
-    "sourceCommit": "9a9005b9a48b8491bfe818d6c38c179b17f5d47c",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.21/mentra-live-ota-3.1.0-dev.21.json",
-    "otaManifestSha256": "faa45840c71e996726a8c21a091d833635198570ef7d9045b8e95251d6f564a8"
+    "releaseIdentity": "3.1.0-dev.27",
+    "releaseSetId": "mentra-3.1.0-dev.27",
+    "sourceCommit": "f771dc060925375c40f2abb376a41620a5208580",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.27/mentra-live-ota-3.1.0-dev.27.json",
+    "otaManifestSha256": "ea869252f5ed1ce809b51e8477a05c48859097a3542d22285165546e30f23e45"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,cAAc;IACjC,cAAc,EAAE,qBAAqB;IACrC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,uHAAuH;IACzI,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.1.0\",\n  \"releaseIdentity\": \"3.1.0-dev.21\",\n  \"releaseSetId\": \"mentra-3.1.0-dev.21\",\n  \"sourceCommit\": \"9a9005b9a48b8491bfe818d6c38c179b17f5d47c\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.21/mentra-live-ota-3.1.0-dev.21.json\",\n  \"otaManifestSha256\": \"faa45840c71e996726a8c21a091d833635198570ef7d9045b8e95251d6f564a8\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,cAAc;IACjC,cAAc,EAAE,qBAAqB;IACrC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,uHAAuH;IACzI,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.1.0\",\n  \"releaseIdentity\": \"3.1.0-dev.27\",\n  \"releaseSetId\": \"mentra-3.1.0-dev.27\",\n  \"sourceCommit\": \"f771dc060925375c40f2abb376a41620a5208580\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.27/mentra-live-ota-3.1.0-dev.27.json\",\n  \"otaManifestSha256\": \"ea869252f5ed1ce809b51e8477a05c48859097a3542d22285165546e30f23e45\"\n})\n"]}

package/build/react/useMentraLiveOta.js

@@ -273,11 +273,11 @@ export function useMentraLiveOta(options = {}) {
             autoChainAdvancedRef.current) {
             return;
         }
-        const timeout = setTimeout(() => {
+        const timeout = setTimeout(async () => {
             if (!isOtaAutoChainActive())
                 return;
             autoChainAdvancedRef.current = true;
-            ota.installSession.finish();
+            await ota.installSession.finish();
             returnToCheck();
         }, AUTO_CHAIN_COMPLETE_DELAY_MS);
         return () => clearTimeout(timeout);
@@ -316,7 +316,7 @@ export function useMentraLiveOta(options = {}) {
         onFirmwareRestartingChangeRef.current?.(false, true);
         ota.installSession.retry();
     }, [page]);
-    const finish = useCallback(() => {
+    const finish = useCallback(async () => {
         if (page === "check") {
             onFinishedRef.current?.();
             return;
@@ -326,14 +326,14 @@ export function useMentraLiveOta(options = {}) {
         const requiresGlassesReboot = shouldRequireGlassesRebootForBesFailure(installSnapshot.otaStatus, installSnapshot.otaProgress, installSnapshot.errorMsg);
         if (requiresGlassesReboot)
             stopOtaAutoChain();
-        ota.installSession.finish();
+        await ota.installSession.finish();
         returnToCheck();
     }, [installSnapshot, page, returnToCheck]);
-    const discard = useCallback(() => {
+    const discard = useCallback(async () => {
         if (page !== "progress")
             return;
         stopOtaAutoChain();
-        ota.installSession.discard();
+        await ota.installSession.discard();
         returnToCheck();
     }, [page, returnToCheck]);
     const openWifiSetup = useCallback(() => {

package/build/react/useMentraLiveOta.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMentraLiveOta.js","sourceRoot":"","sources":["../../src/react/useMentraLiveOta.ts"],"names":[],"mappings":"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","sourcesContent":["import {useCallback, useEffect, useMemo, useRef, useState} from \"react\"\n\nimport {ota} from \"../facades/ota\"\nimport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n} from \"../services/OtaAutoChain\"\nimport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"../services/OtaErrorMapping\"\nimport type {OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport type {OtaCheckCurrentGlassesResult} from \"../services/OtaUpdateCheckService\"\nimport {useEngineSnapshot} from \"./useEngineSnapshot\"\n\nexport type MentraLiveOtaFlowPage = \"check\" | \"progress\"\n\nexport type MentraLiveOtaScreen =\n  | \"initializing\"\n  | \"checking\"\n  | \"update_available\"\n  | \"wifi_required\"\n  | \"up_to_date\"\n  | \"dev_build\"\n  | \"check_failed\"\n  | \"update_info_unavailable\"\n  | \"starting\"\n  | \"preparing_hotspot\"\n  | \"updating\"\n  | \"restarting\"\n  | \"verifying\"\n  | \"complete\"\n  | \"failed\"\n  | \"disconnected\"\n\nexport type MentraLiveOtaErrorCode =\n  | \"check_failed\"\n  | \"update_info_unavailable\"\n  | \"install_failed\"\n  | \"bes_restart_required\"\n\nexport type MentraLiveOtaError = {\n  code: MentraLiveOtaErrorCode\n  message: string\n}\n\nexport type MentraLiveOtaTransport = \"wifi\" | \"hotspot\"\nexport type MentraLiveOtaHotspotPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\nexport type MentraLiveOtaInstallPhase = \"download\" | \"install\"\nexport type MentraLiveOtaStep = \"apk\" | \"mtk\" | \"bes\"\n\nexport type MentraLiveOtaState = {\n  screen: MentraLiveOtaScreen\n  connected: boolean\n  transport: MentraLiveOtaTransport | null\n  updateRequired: boolean\n  versionChange: boolean\n  versionChangeConverged: boolean\n  versionChangePhase: \"installing\" | \"restarting\" | \"verifying\" | null\n  wifiConnected: boolean\n  wifiStatusKnown: boolean\n  hotspotSupported: boolean\n  hotspotPhase: MentraLiveOtaHotspotPhase\n  hotspotArtifactPercent: number | null\n  phase: MentraLiveOtaInstallPhase | null\n  step: MentraLiveOtaStep | null\n  currentStep: number | null\n  totalSteps: number | null\n  progress: number | null\n  installingApkOnly: boolean\n  firmwareRestarting: boolean\n  error: MentraLiveOtaError | null\n  canInstall: boolean\n  canRetry: boolean\n  canFinish: boolean\n  canDismiss: boolean\n  canDiscard: boolean\n  canOpenWifiSetup: boolean\n  continueDisabled: boolean\n}\n\nexport type UseMentraLiveOtaOptions = {\n  /** Entry page. `progress` exists for interrupted-session recovery. */\n  initialPage?: MentraLiveOtaFlowPage\n  /** Start Engine's OTA-only projections. Full Engine hosts should pass false. */\n  initializeRuntime?: boolean\n  /** Called after the final check or when an optional update is dismissed. */\n  onFinished?: () => void\n  /** Host-owned Wi-Fi setup for glasses without hotspot OTA support. */\n  onOpenWifiSetup?: () => void\n  /** Lets a host coordinate its connection overlay with OTA firmware restarts. */\n  onFirmwareRestartingChange?: (restarting: boolean, progressActive: boolean) => void\n}\n\nexport type MentraLiveOtaController = {\n  state: MentraLiveOtaState\n  check: () => void\n  retryCheck: () => void\n  install: () => void\n  retryInstall: () => void\n  finish: () => void\n  discard: () => void\n  openWifiSetup: () => void\n}\n\ntype CheckState = \"checking\" | \"update_available\" | \"no_update\" | \"dev_build\" | \"error\"\n\nconst AUTO_CHAIN_NETWORK_RETRY_DELAY_MS = 5000\nconst AUTO_CHAIN_COMPLETE_DELAY_MS = 750\n\nfunction installProgress(snapshot: OtaInstallSnapshot): number | null {\n  if (snapshot.displayState !== \"updating\") return null\n  const {otaStatus} = snapshot\n  const isDownload = otaStatus?.phase === \"download\"\n  const totalSteps = otaStatus?.totalSteps ?? 1\n  const rawPercent = isDownload\n    ? (otaStatus?.stepPercent ?? 0)\n    : totalSteps >= 2\n      ? (otaStatus?.overallPercent ?? 0)\n      : (otaStatus?.stepPercent ?? 0)\n  return Math.min(Math.max(rawPercent, snapshot.mtkInstallStallSimulatedPercent ?? 0, 0), 100)\n}\n\nfunction progressScreen(snapshot: OtaInstallSnapshot): MentraLiveOtaScreen {\n  if (snapshot.versionChangePhase === \"restarting\") return \"restarting\"\n  if (snapshot.versionChangePhase === \"verifying\") return \"verifying\"\n  switch (snapshot.displayState) {\n    case \"starting\":\n      return snapshot.hotspotPhase === \"idle\" || snapshot.hotspotPhase === \"serving\" ? \"starting\" : \"preparing_hotspot\"\n    case \"updating\":\n      return \"updating\"\n    case \"restarting\":\n      return \"restarting\"\n    case \"complete\":\n      return \"complete\"\n    case \"failed\":\n      return \"failed\"\n    default:\n      return \"disconnected\"\n  }\n}\n\n/**\n * Headless Mentra Live OTA flow. Engine owns checking, hotspot staging,\n * APK/MTK/BES sequencing, restart recovery, retries, and verification; the host\n * renders semantic state and invokes these idempotent actions.\n */\nexport function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraLiveOtaController {\n  const {\n    initialPage = \"check\",\n    initializeRuntime = true,\n    onFinished,\n    onFirmwareRestartingChange,\n    onOpenWifiSetup,\n  } = options\n  const otaSnapshot = useEngineSnapshot(ota.snapshot, ota.onSnapshot)\n  const installSnapshot = useEngineSnapshot(ota.installSession.snapshot, ota.installSession.onSnapshot)\n  const [page, setPage] = useState<MentraLiveOtaFlowPage>(initialPage)\n  const [runtimeReady, setRuntimeReady] = useState(!initializeRuntime)\n  const [checkState, setCheckState] = useState<CheckState>(\"checking\")\n  const [isUpdateRequired, setIsUpdateRequired] = useState(true)\n  const [isVersionChange, setIsVersionChange] = useState(false)\n  const [errorKind, setErrorKind] = useState<\"network\" | \"pin_unavailable\">(\"network\")\n  const [updateFingerprint, setUpdateFingerprint] = useState<string | null>(null)\n  const [checkGeneration, setCheckGeneration] = useState(0)\n  const performCheckGenerationRef = useRef(0)\n  const activeCheckKeyRef = useRef<string | null>(null)\n  const checkStartedRef = useRef(false)\n  const checkCompletedRef = useRef(false)\n  const selectedCheckResultRef = useRef<OtaCheckCurrentGlassesResult | null>(null)\n  const autoChainAdvancedRef = useRef(false)\n  const installActionPendingRef = useRef(false)\n  const onFinishedRef = useRef(onFinished)\n  const onOpenWifiSetupRef = useRef(onOpenWifiSetup)\n  const onFirmwareRestartingChangeRef = useRef(onFirmwareRestartingChange)\n  onFinishedRef.current = onFinished\n  onOpenWifiSetupRef.current = onOpenWifiSetup\n  onFirmwareRestartingChangeRef.current = onFirmwareRestartingChange\n\n  useEffect(() => {\n    if (!initializeRuntime) {\n      setRuntimeReady(true)\n      return\n    }\n    let cancelled = false\n    setRuntimeReady(false)\n    void ota.initialize().finally(() => {\n      if (!cancelled) setRuntimeReady(true)\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [initializeRuntime])\n\n  const returnToCheck = useCallback(() => {\n    installActionPendingRef.current = false\n    autoChainAdvancedRef.current = false\n    setPage(\"check\")\n    setCheckGeneration((generation) => generation + 1)\n  }, [])\n\n  const navigateToProgress = useCallback(() => {\n    installActionPendingRef.current = true\n    ota.clearProgress()\n    setPage(\"progress\")\n  }, [])\n\n  useEffect(() => {\n    if (!runtimeReady || page !== \"check\") return\n    const MIN_DISPLAY_TIME_MS = 1100\n    const MAX_WAIT_FOR_VERSION_INFO_MS = 10_000\n    const checkKey = String(checkGeneration)\n    if (activeCheckKeyRef.current !== checkKey) {\n      activeCheckKeyRef.current = checkKey\n      checkStartedRef.current = false\n      checkCompletedRef.current = false\n      selectedCheckResultRef.current = null\n      installActionPendingRef.current = false\n      setCheckState(\"checking\")\n    }\n\n    const myGeneration = ++performCheckGenerationRef.current\n    let cancelled = false\n    let reconnectTimeout: ReturnType<typeof setTimeout> | null = null\n\n    const performCheck = async () => {\n      if (checkCompletedRef.current) return\n      if (!otaSnapshot.connected) {\n        if (isOtaAutoChainActive()) {\n          const remainingMs = otaAutoChainReconnectWaitRemaining()\n          if (remainingMs === null) return\n          reconnectTimeout = setTimeout(() => {\n            if (cancelled || myGeneration !== performCheckGenerationRef.current || ota.snapshot().connected) return\n            stopOtaAutoChain()\n            checkCompletedRef.current = true\n            setCheckState(\"error\")\n          }, remainingMs)\n          return\n        }\n        if (checkStartedRef.current) {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setCheckState(\"error\")\n          return\n        }\n        checkCompletedRef.current = true\n        onFinishedRef.current?.()\n        return\n      }\n\n      clearOtaAutoChainReconnectWait()\n      checkStartedRef.current = true\n      const startTime = Date.now()\n      try {\n        const checkOptions = {\n          waitForBuildNumberMs: MAX_WAIT_FOR_VERSION_INFO_MS,\n          waitForBesVersionMs: 5000,\n          waitForMtkVersionMs: 2000,\n          refreshVersionInfo: true,\n          fixClockBeforeCheck: false,\n        }\n        let result = await ota.checkForUpdates(checkOptions)\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        if (!result.hasCheckCompleted && result.checkFailureReason === \"network\" && isOtaAutoChainActive()) {\n          await new Promise((resolve) => setTimeout(resolve, AUTO_CHAIN_NETWORK_RETRY_DELAY_MS))\n          if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n          result = await ota.checkForUpdates(checkOptions)\n        }\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        selectedCheckResultRef.current = result\n        await new Promise((resolve) => setTimeout(resolve, Math.max(0, MIN_DISPLAY_TIME_MS - (Date.now() - startTime))))\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n\n        if (result.skippedReason === \"disconnected\") {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setCheckState(\"error\")\n          return\n        }\n        if (result.skippedReason === \"missing_build\") {\n          checkCompletedRef.current = true\n          if (isOtaAutoChainActive()) {\n            stopOtaAutoChain()\n            setCheckState(\"error\")\n          } else {\n            onFinishedRef.current?.()\n          }\n          return\n        }\n        if (result.skippedReason === \"dev_build\") {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          ota.clearUpdateAvailable()\n          setCheckState(\"dev_build\")\n          return\n        }\n        if (!result.hasCheckCompleted) {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setErrorKind(result.checkFailureReason === \"pin_unavailable\" ? \"pin_unavailable\" : \"network\")\n          setCheckState(\"error\")\n          return\n        }\n        if (result.updateAvailable && result.updateInfo) {\n          setIsUpdateRequired(result.isRequired)\n          setIsVersionChange(result.updateInfo.isDowngrade === true)\n          const fingerprint = otaAutoChainFingerprint(result)\n          setUpdateFingerprint(fingerprint)\n          if (isOtaAutoChainActive()) {\n            const snapshot = ota.snapshot()\n            if (!snapshot.wifiStatusKnown) return\n            if (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1) {\n              stopOtaAutoChain()\n            } else {\n              const admission = tryAdvanceOtaAutoChain(fingerprint, result.updateInfo.isDowngrade === true)\n              if (admission.advance) {\n                checkCompletedRef.current = true\n                ota.installSession.prepare(result)\n                navigateToProgress()\n                return\n              }\n            }\n          }\n          checkCompletedRef.current = true\n          setCheckState(\"update_available\")\n          return\n        }\n        stopOtaAutoChain()\n        checkCompletedRef.current = true\n        ota.clearUpdateAvailable()\n        setCheckState(\"no_update\")\n      } catch (error) {\n        console.error(\"OTA check failed:\", error)\n        await new Promise((resolve) => setTimeout(resolve, Math.max(0, MIN_DISPLAY_TIME_MS - (Date.now() - startTime))))\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        stopOtaAutoChain()\n        checkCompletedRef.current = true\n        setErrorKind(\"network\")\n        setCheckState(\"error\")\n      }\n    }\n\n    void performCheck()\n    return () => {\n      cancelled = true\n      if (reconnectTimeout) clearTimeout(reconnectTimeout)\n    }\n  }, [checkGeneration, navigateToProgress, otaSnapshot.connected, otaSnapshot.wifiStatusKnown, page, runtimeReady])\n\n  useEffect(() => {\n    if (!runtimeReady || page !== \"progress\") return\n    ota.installSession.attach()\n    return () => ota.installSession.detach()\n  }, [page, runtimeReady])\n\n  const firmwareRestarting =\n    page === \"progress\" &&\n    ((!installSnapshot.connected && installSnapshot.displayState === \"restarting\") ||\n      installSnapshot.versionChangePhase === \"restarting\")\n\n  useEffect(() => {\n    if (page !== \"progress\") return\n    onFirmwareRestartingChangeRef.current?.(firmwareRestarting, true)\n  }, [firmwareRestarting, page])\n\n  useEffect(() => {\n    if (page !== \"progress\") return\n    return () => {\n      onFirmwareRestartingChangeRef.current?.(false, false)\n    }\n  }, [page])\n\n  useEffect(() => {\n    if (\n      page !== \"progress\" ||\n      installSnapshot.displayState !== \"complete\" ||\n      !installSnapshot.connected ||\n      !isOtaAutoChainActive() ||\n      autoChainAdvancedRef.current\n    ) {\n      return\n    }\n    const timeout = setTimeout(() => {\n      if (!isOtaAutoChainActive()) return\n      autoChainAdvancedRef.current = true\n      ota.installSession.finish()\n      returnToCheck()\n    }, AUTO_CHAIN_COMPLETE_DELAY_MS)\n    return () => clearTimeout(timeout)\n  }, [installSnapshot.connected, installSnapshot.displayState, page, returnToCheck])\n\n  const check = useCallback(() => {\n    setPage(\"check\")\n    setCheckState(\"checking\")\n    setCheckGeneration((generation) => generation + 1)\n  }, [])\n\n  const install = useCallback(() => {\n    if (installActionPendingRef.current || page !== \"check\") return\n    const result = selectedCheckResultRef.current\n    if (!result) {\n      setErrorKind(\"network\")\n      setCheckState(\"error\")\n      return\n    }\n    const snapshot = ota.snapshot()\n    if (!snapshot.wifiStatusKnown) {\n      check()\n      return\n    }\n    if (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1) {\n      onOpenWifiSetupRef.current?.()\n      return\n    }\n    ota.installSession.prepare(result)\n    if (updateFingerprint) beginOtaAutoChain(updateFingerprint, isVersionChange)\n    navigateToProgress()\n  }, [check, isVersionChange, navigateToProgress, page, updateFingerprint])\n\n  const retryInstall = useCallback(() => {\n    if (page !== \"progress\") return\n    onFirmwareRestartingChangeRef.current?.(false, true)\n    ota.installSession.retry()\n  }, [page])\n\n  const finish = useCallback(() => {\n    if (page === \"check\") {\n      onFinishedRef.current?.()\n      return\n    }\n    if (installSnapshot.displayState === \"restarting\") stopOtaAutoChain()\n    const requiresGlassesReboot = shouldRequireGlassesRebootForBesFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    if (requiresGlassesReboot) stopOtaAutoChain()\n    ota.installSession.finish()\n    returnToCheck()\n  }, [installSnapshot, page, returnToCheck])\n\n  const discard = useCallback(() => {\n    if (page !== \"progress\") return\n    stopOtaAutoChain()\n    ota.installSession.discard()\n    returnToCheck()\n  }, [page, returnToCheck])\n\n  const openWifiSetup = useCallback(() => {\n    if (page === \"progress\") stopOtaAutoChain()\n    onOpenWifiSetupRef.current?.()\n  }, [page])\n\n  const state = useMemo<MentraLiveOtaState>(() => {\n    const hotspotSupported = otaSnapshot.hotspotOtaVersion === 1\n    const canInstall = otaSnapshot.wifiStatusKnown && (otaSnapshot.wifiConnected || hotspotSupported)\n    if (!runtimeReady) {\n      return {\n        screen: \"initializing\",\n        connected: otaSnapshot.connected,\n        transport: null,\n        updateRequired: isUpdateRequired,\n        versionChange: isVersionChange,\n        versionChangeConverged: false,\n        versionChangePhase: null,\n        wifiConnected: otaSnapshot.wifiConnected,\n        wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n        hotspotSupported,\n        hotspotPhase: \"idle\",\n        hotspotArtifactPercent: null,\n        phase: null,\n        step: null,\n        currentStep: null,\n        totalSteps: null,\n        progress: null,\n        installingApkOnly: false,\n        firmwareRestarting: false,\n        error: null,\n        canInstall: false,\n        canRetry: false,\n        canFinish: false,\n        canDismiss: false,\n        canDiscard: false,\n        canOpenWifiSetup: false,\n        continueDisabled: false,\n      }\n    }\n\n    if (page === \"check\") {\n      const wifiRequired = otaSnapshot.wifiStatusKnown && !otaSnapshot.wifiConnected && !hotspotSupported\n      const screen: MentraLiveOtaScreen =\n        checkState === \"checking\"\n          ? \"checking\"\n          : checkState === \"update_available\"\n            ? wifiRequired\n              ? \"wifi_required\"\n              : \"update_available\"\n            : checkState === \"no_update\"\n              ? \"up_to_date\"\n              : checkState === \"dev_build\"\n                ? \"dev_build\"\n                : errorKind === \"pin_unavailable\"\n                  ? \"update_info_unavailable\"\n                  : \"check_failed\"\n      const error: MentraLiveOtaError | null =\n        screen === \"check_failed\"\n          ? {code: \"check_failed\", message: \"Couldn't check for updates. Please check your connection and try again.\"}\n          : screen === \"update_info_unavailable\"\n            ? {code: \"update_info_unavailable\", message: \"Update information for this app version is unavailable.\"}\n            : null\n      return {\n        screen,\n        connected: otaSnapshot.connected,\n        transport: otaSnapshot.wifiConnected ? \"wifi\" : hotspotSupported ? \"hotspot\" : null,\n        updateRequired: isUpdateRequired,\n        versionChange: isVersionChange,\n        versionChangeConverged: false,\n        versionChangePhase: null,\n        wifiConnected: otaSnapshot.wifiConnected,\n        wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n        hotspotSupported,\n        hotspotPhase: \"idle\",\n        hotspotArtifactPercent: null,\n        phase: null,\n        step: null,\n        currentStep: null,\n        totalSteps: null,\n        progress: null,\n        installingApkOnly: false,\n        firmwareRestarting: false,\n        error,\n        canInstall: screen === \"update_available\" && canInstall,\n        canRetry: screen === \"check_failed\",\n        canFinish: screen === \"up_to_date\" || screen === \"dev_build\" || screen === \"update_info_unavailable\",\n        canDismiss: (screen === \"update_available\" || screen === \"wifi_required\") && !isUpdateRequired,\n        canDiscard: false,\n        canOpenWifiSetup: screen === \"wifi_required\",\n        continueDisabled: false,\n      }\n    }\n\n    const requiresGlassesReboot = shouldRequireGlassesRebootForBesFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    const showChangeWifi = shouldShowChangeWifiForOtaDownloadFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    const displayedError = requiresGlassesReboot\n      ? BES_INSTALL_RESTART_MESSAGE\n      : installSnapshot.errorMsg || getOtaErrorMessage(installSnapshot.otaStatus?.error)\n    const screen = progressScreen(installSnapshot)\n    const error =\n      screen === \"failed\"\n        ? {\n            code: requiresGlassesReboot ? (\"bes_restart_required\" as const) : (\"install_failed\" as const),\n            message: displayedError,\n          }\n        : null\n    const totalSteps = installSnapshot.otaStatus?.totalSteps ?? null\n    return {\n      screen,\n      connected: installSnapshot.connected,\n      transport: installSnapshot.transport,\n      updateRequired: isUpdateRequired,\n      versionChange: installSnapshot.isVersionChange,\n      versionChangeConverged: installSnapshot.versionChangeConverged,\n      versionChangePhase: installSnapshot.versionChangePhase,\n      wifiConnected: otaSnapshot.wifiConnected,\n      wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n      hotspotSupported,\n      hotspotPhase: installSnapshot.hotspotPhase,\n      hotspotArtifactPercent: installSnapshot.hotspotArtifactPercent,\n      phase: installSnapshot.otaStatus?.phase ?? installSnapshot.otaProgress?.stage ?? null,\n      step: installSnapshot.otaStatus?.stepType ?? null,\n      currentStep: installSnapshot.otaStatus?.currentStep ?? null,\n      totalSteps,\n      progress: installProgress(installSnapshot),\n      installingApkOnly:\n        installSnapshot.otaStatus?.stepType === \"apk\" &&\n        installSnapshot.otaStatus.phase === \"install\" &&\n        totalSteps === 1,\n      firmwareRestarting,\n      error,\n      canInstall: false,\n      canRetry: screen === \"failed\" && !requiresGlassesReboot,\n      canFinish: screen === \"complete\" || screen === \"restarting\" || (screen === \"failed\" && requiresGlassesReboot),\n      canDismiss: false,\n      canDiscard: screen === \"disconnected\",\n      canOpenWifiSetup: screen === \"failed\" && showChangeWifi,\n      continueDisabled: installSnapshot.continueButtonDisabled,\n    }\n  }, [\n    checkState,\n    errorKind,\n    firmwareRestarting,\n    installSnapshot,\n    isUpdateRequired,\n    isVersionChange,\n    otaSnapshot,\n    page,\n    runtimeReady,\n  ])\n\n  return useMemo(\n    () => ({state, check, retryCheck: check, install, retryInstall, finish, discard, openWifiSetup}),\n    [check, discard, finish, install, openWifiSetup, retryInstall, state],\n  )\n}\n"]}
+{"version":3,"file":"useMentraLiveOta.js","sourceRoot":"","sources":["../../src/react/useMentraLiveOta.ts"],"names":[],"mappings":"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","sourcesContent":["import {useCallback, useEffect, useMemo, useRef, useState} from \"react\"\n\nimport {ota} from \"../facades/ota\"\nimport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n} from \"../services/OtaAutoChain\"\nimport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"../services/OtaErrorMapping\"\nimport type {OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport type {OtaCheckCurrentGlassesResult} from \"../services/OtaUpdateCheckService\"\nimport {useEngineSnapshot} from \"./useEngineSnapshot\"\n\nexport type MentraLiveOtaFlowPage = \"check\" | \"progress\"\n\nexport type MentraLiveOtaScreen =\n  | \"initializing\"\n  | \"checking\"\n  | \"update_available\"\n  | \"wifi_required\"\n  | \"up_to_date\"\n  | \"dev_build\"\n  | \"check_failed\"\n  | \"update_info_unavailable\"\n  | \"starting\"\n  | \"preparing_hotspot\"\n  | \"updating\"\n  | \"restarting\"\n  | \"verifying\"\n  | \"complete\"\n  | \"failed\"\n  | \"disconnected\"\n\nexport type MentraLiveOtaErrorCode =\n  | \"check_failed\"\n  | \"update_info_unavailable\"\n  | \"install_failed\"\n  | \"bes_restart_required\"\n\nexport type MentraLiveOtaError = {\n  code: MentraLiveOtaErrorCode\n  message: string\n}\n\nexport type MentraLiveOtaTransport = \"wifi\" | \"hotspot\"\nexport type MentraLiveOtaHotspotPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\nexport type MentraLiveOtaInstallPhase = \"download\" | \"install\"\nexport type MentraLiveOtaStep = \"apk\" | \"mtk\" | \"bes\"\n\nexport type MentraLiveOtaState = {\n  screen: MentraLiveOtaScreen\n  connected: boolean\n  transport: MentraLiveOtaTransport | null\n  updateRequired: boolean\n  versionChange: boolean\n  versionChangeConverged: boolean\n  versionChangePhase: \"installing\" | \"restarting\" | \"verifying\" | null\n  wifiConnected: boolean\n  wifiStatusKnown: boolean\n  hotspotSupported: boolean\n  hotspotPhase: MentraLiveOtaHotspotPhase\n  hotspotArtifactPercent: number | null\n  phase: MentraLiveOtaInstallPhase | null\n  step: MentraLiveOtaStep | null\n  currentStep: number | null\n  totalSteps: number | null\n  progress: number | null\n  installingApkOnly: boolean\n  firmwareRestarting: boolean\n  error: MentraLiveOtaError | null\n  canInstall: boolean\n  canRetry: boolean\n  canFinish: boolean\n  canDismiss: boolean\n  canDiscard: boolean\n  canOpenWifiSetup: boolean\n  continueDisabled: boolean\n}\n\nexport type UseMentraLiveOtaOptions = {\n  /** Entry page. `progress` exists for interrupted-session recovery. */\n  initialPage?: MentraLiveOtaFlowPage\n  /** Start Engine's OTA-only projections. Full Engine hosts should pass false. */\n  initializeRuntime?: boolean\n  /** Called after the final check or when an optional update is dismissed. */\n  onFinished?: () => void\n  /** Host-owned Wi-Fi setup for glasses without hotspot OTA support. */\n  onOpenWifiSetup?: () => void\n  /** Lets a host coordinate its connection overlay with OTA firmware restarts. */\n  onFirmwareRestartingChange?: (restarting: boolean, progressActive: boolean) => void\n}\n\nexport type MentraLiveOtaController = {\n  state: MentraLiveOtaState\n  check: () => void\n  retryCheck: () => void\n  install: () => void\n  retryInstall: () => void\n  finish: () => void\n  discard: () => void\n  openWifiSetup: () => void\n}\n\ntype CheckState = \"checking\" | \"update_available\" | \"no_update\" | \"dev_build\" | \"error\"\n\nconst AUTO_CHAIN_NETWORK_RETRY_DELAY_MS = 5000\nconst AUTO_CHAIN_COMPLETE_DELAY_MS = 750\n\nfunction installProgress(snapshot: OtaInstallSnapshot): number | null {\n  if (snapshot.displayState !== \"updating\") return null\n  const {otaStatus} = snapshot\n  const isDownload = otaStatus?.phase === \"download\"\n  const totalSteps = otaStatus?.totalSteps ?? 1\n  const rawPercent = isDownload\n    ? (otaStatus?.stepPercent ?? 0)\n    : totalSteps >= 2\n      ? (otaStatus?.overallPercent ?? 0)\n      : (otaStatus?.stepPercent ?? 0)\n  return Math.min(Math.max(rawPercent, snapshot.mtkInstallStallSimulatedPercent ?? 0, 0), 100)\n}\n\nfunction progressScreen(snapshot: OtaInstallSnapshot): MentraLiveOtaScreen {\n  if (snapshot.versionChangePhase === \"restarting\") return \"restarting\"\n  if (snapshot.versionChangePhase === \"verifying\") return \"verifying\"\n  switch (snapshot.displayState) {\n    case \"starting\":\n      return snapshot.hotspotPhase === \"idle\" || snapshot.hotspotPhase === \"serving\" ? \"starting\" : \"preparing_hotspot\"\n    case \"updating\":\n      return \"updating\"\n    case \"restarting\":\n      return \"restarting\"\n    case \"complete\":\n      return \"complete\"\n    case \"failed\":\n      return \"failed\"\n    default:\n      return \"disconnected\"\n  }\n}\n\n/**\n * Headless Mentra Live OTA flow. Engine owns checking, hotspot staging,\n * APK/MTK/BES sequencing, restart recovery, retries, and verification; the host\n * renders semantic state and invokes these idempotent actions.\n */\nexport function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraLiveOtaController {\n  const {\n    initialPage = \"check\",\n    initializeRuntime = true,\n    onFinished,\n    onFirmwareRestartingChange,\n    onOpenWifiSetup,\n  } = options\n  const otaSnapshot = useEngineSnapshot(ota.snapshot, ota.onSnapshot)\n  const installSnapshot = useEngineSnapshot(ota.installSession.snapshot, ota.installSession.onSnapshot)\n  const [page, setPage] = useState<MentraLiveOtaFlowPage>(initialPage)\n  const [runtimeReady, setRuntimeReady] = useState(!initializeRuntime)\n  const [checkState, setCheckState] = useState<CheckState>(\"checking\")\n  const [isUpdateRequired, setIsUpdateRequired] = useState(true)\n  const [isVersionChange, setIsVersionChange] = useState(false)\n  const [errorKind, setErrorKind] = useState<\"network\" | \"pin_unavailable\">(\"network\")\n  const [updateFingerprint, setUpdateFingerprint] = useState<string | null>(null)\n  const [checkGeneration, setCheckGeneration] = useState(0)\n  const performCheckGenerationRef = useRef(0)\n  const activeCheckKeyRef = useRef<string | null>(null)\n  const checkStartedRef = useRef(false)\n  const checkCompletedRef = useRef(false)\n  const selectedCheckResultRef = useRef<OtaCheckCurrentGlassesResult | null>(null)\n  const autoChainAdvancedRef = useRef(false)\n  const installActionPendingRef = useRef(false)\n  const onFinishedRef = useRef(onFinished)\n  const onOpenWifiSetupRef = useRef(onOpenWifiSetup)\n  const onFirmwareRestartingChangeRef = useRef(onFirmwareRestartingChange)\n  onFinishedRef.current = onFinished\n  onOpenWifiSetupRef.current = onOpenWifiSetup\n  onFirmwareRestartingChangeRef.current = onFirmwareRestartingChange\n\n  useEffect(() => {\n    if (!initializeRuntime) {\n      setRuntimeReady(true)\n      return\n    }\n    let cancelled = false\n    setRuntimeReady(false)\n    void ota.initialize().finally(() => {\n      if (!cancelled) setRuntimeReady(true)\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [initializeRuntime])\n\n  const returnToCheck = useCallback(() => {\n    installActionPendingRef.current = false\n    autoChainAdvancedRef.current = false\n    setPage(\"check\")\n    setCheckGeneration((generation) => generation + 1)\n  }, [])\n\n  const navigateToProgress = useCallback(() => {\n    installActionPendingRef.current = true\n    ota.clearProgress()\n    setPage(\"progress\")\n  }, [])\n\n  useEffect(() => {\n    if (!runtimeReady || page !== \"check\") return\n    const MIN_DISPLAY_TIME_MS = 1100\n    const MAX_WAIT_FOR_VERSION_INFO_MS = 10_000\n    const checkKey = String(checkGeneration)\n    if (activeCheckKeyRef.current !== checkKey) {\n      activeCheckKeyRef.current = checkKey\n      checkStartedRef.current = false\n      checkCompletedRef.current = false\n      selectedCheckResultRef.current = null\n      installActionPendingRef.current = false\n      setCheckState(\"checking\")\n    }\n\n    const myGeneration = ++performCheckGenerationRef.current\n    let cancelled = false\n    let reconnectTimeout: ReturnType<typeof setTimeout> | null = null\n\n    const performCheck = async () => {\n      if (checkCompletedRef.current) return\n      if (!otaSnapshot.connected) {\n        if (isOtaAutoChainActive()) {\n          const remainingMs = otaAutoChainReconnectWaitRemaining()\n          if (remainingMs === null) return\n          reconnectTimeout = setTimeout(() => {\n            if (cancelled || myGeneration !== performCheckGenerationRef.current || ota.snapshot().connected) return\n            stopOtaAutoChain()\n            checkCompletedRef.current = true\n            setCheckState(\"error\")\n          }, remainingMs)\n          return\n        }\n        if (checkStartedRef.current) {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setCheckState(\"error\")\n          return\n        }\n        checkCompletedRef.current = true\n        onFinishedRef.current?.()\n        return\n      }\n\n      clearOtaAutoChainReconnectWait()\n      checkStartedRef.current = true\n      const startTime = Date.now()\n      try {\n        const checkOptions = {\n          waitForBuildNumberMs: MAX_WAIT_FOR_VERSION_INFO_MS,\n          waitForBesVersionMs: 5000,\n          waitForMtkVersionMs: 2000,\n          refreshVersionInfo: true,\n          fixClockBeforeCheck: false,\n        }\n        let result = await ota.checkForUpdates(checkOptions)\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        if (!result.hasCheckCompleted && result.checkFailureReason === \"network\" && isOtaAutoChainActive()) {\n          await new Promise((resolve) => setTimeout(resolve, AUTO_CHAIN_NETWORK_RETRY_DELAY_MS))\n          if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n          result = await ota.checkForUpdates(checkOptions)\n        }\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        selectedCheckResultRef.current = result\n        await new Promise((resolve) => setTimeout(resolve, Math.max(0, MIN_DISPLAY_TIME_MS - (Date.now() - startTime))))\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n\n        if (result.skippedReason === \"disconnected\") {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setCheckState(\"error\")\n          return\n        }\n        if (result.skippedReason === \"missing_build\") {\n          checkCompletedRef.current = true\n          if (isOtaAutoChainActive()) {\n            stopOtaAutoChain()\n            setCheckState(\"error\")\n          } else {\n            onFinishedRef.current?.()\n          }\n          return\n        }\n        if (result.skippedReason === \"dev_build\") {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          ota.clearUpdateAvailable()\n          setCheckState(\"dev_build\")\n          return\n        }\n        if (!result.hasCheckCompleted) {\n          stopOtaAutoChain()\n          checkCompletedRef.current = true\n          setErrorKind(result.checkFailureReason === \"pin_unavailable\" ? \"pin_unavailable\" : \"network\")\n          setCheckState(\"error\")\n          return\n        }\n        if (result.updateAvailable && result.updateInfo) {\n          setIsUpdateRequired(result.isRequired)\n          setIsVersionChange(result.updateInfo.isDowngrade === true)\n          const fingerprint = otaAutoChainFingerprint(result)\n          setUpdateFingerprint(fingerprint)\n          if (isOtaAutoChainActive()) {\n            const snapshot = ota.snapshot()\n            if (!snapshot.wifiStatusKnown) return\n            if (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1) {\n              stopOtaAutoChain()\n            } else {\n              const admission = tryAdvanceOtaAutoChain(fingerprint, result.updateInfo.isDowngrade === true)\n              if (admission.advance) {\n                checkCompletedRef.current = true\n                ota.installSession.prepare(result)\n                navigateToProgress()\n                return\n              }\n            }\n          }\n          checkCompletedRef.current = true\n          setCheckState(\"update_available\")\n          return\n        }\n        stopOtaAutoChain()\n        checkCompletedRef.current = true\n        ota.clearUpdateAvailable()\n        setCheckState(\"no_update\")\n      } catch (error) {\n        console.error(\"OTA check failed:\", error)\n        await new Promise((resolve) => setTimeout(resolve, Math.max(0, MIN_DISPLAY_TIME_MS - (Date.now() - startTime))))\n        if (cancelled || myGeneration !== performCheckGenerationRef.current) return\n        stopOtaAutoChain()\n        checkCompletedRef.current = true\n        setErrorKind(\"network\")\n        setCheckState(\"error\")\n      }\n    }\n\n    void performCheck()\n    return () => {\n      cancelled = true\n      if (reconnectTimeout) clearTimeout(reconnectTimeout)\n    }\n  }, [checkGeneration, navigateToProgress, otaSnapshot.connected, otaSnapshot.wifiStatusKnown, page, runtimeReady])\n\n  useEffect(() => {\n    if (!runtimeReady || page !== \"progress\") return\n    ota.installSession.attach()\n    return () => ota.installSession.detach()\n  }, [page, runtimeReady])\n\n  const firmwareRestarting =\n    page === \"progress\" &&\n    ((!installSnapshot.connected && installSnapshot.displayState === \"restarting\") ||\n      installSnapshot.versionChangePhase === \"restarting\")\n\n  useEffect(() => {\n    if (page !== \"progress\") return\n    onFirmwareRestartingChangeRef.current?.(firmwareRestarting, true)\n  }, [firmwareRestarting, page])\n\n  useEffect(() => {\n    if (page !== \"progress\") return\n    return () => {\n      onFirmwareRestartingChangeRef.current?.(false, false)\n    }\n  }, [page])\n\n  useEffect(() => {\n    if (\n      page !== \"progress\" ||\n      installSnapshot.displayState !== \"complete\" ||\n      !installSnapshot.connected ||\n      !isOtaAutoChainActive() ||\n      autoChainAdvancedRef.current\n    ) {\n      return\n    }\n    const timeout = setTimeout(async () => {\n      if (!isOtaAutoChainActive()) return\n      autoChainAdvancedRef.current = true\n      await ota.installSession.finish()\n      returnToCheck()\n    }, AUTO_CHAIN_COMPLETE_DELAY_MS)\n    return () => clearTimeout(timeout)\n  }, [installSnapshot.connected, installSnapshot.displayState, page, returnToCheck])\n\n  const check = useCallback(() => {\n    setPage(\"check\")\n    setCheckState(\"checking\")\n    setCheckGeneration((generation) => generation + 1)\n  }, [])\n\n  const install = useCallback(() => {\n    if (installActionPendingRef.current || page !== \"check\") return\n    const result = selectedCheckResultRef.current\n    if (!result) {\n      setErrorKind(\"network\")\n      setCheckState(\"error\")\n      return\n    }\n    const snapshot = ota.snapshot()\n    if (!snapshot.wifiStatusKnown) {\n      check()\n      return\n    }\n    if (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1) {\n      onOpenWifiSetupRef.current?.()\n      return\n    }\n    ota.installSession.prepare(result)\n    if (updateFingerprint) beginOtaAutoChain(updateFingerprint, isVersionChange)\n    navigateToProgress()\n  }, [check, isVersionChange, navigateToProgress, page, updateFingerprint])\n\n  const retryInstall = useCallback(() => {\n    if (page !== \"progress\") return\n    onFirmwareRestartingChangeRef.current?.(false, true)\n    ota.installSession.retry()\n  }, [page])\n\n  const finish = useCallback(async () => {\n    if (page === \"check\") {\n      onFinishedRef.current?.()\n      return\n    }\n    if (installSnapshot.displayState === \"restarting\") stopOtaAutoChain()\n    const requiresGlassesReboot = shouldRequireGlassesRebootForBesFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    if (requiresGlassesReboot) stopOtaAutoChain()\n    await ota.installSession.finish()\n    returnToCheck()\n  }, [installSnapshot, page, returnToCheck])\n\n  const discard = useCallback(async () => {\n    if (page !== \"progress\") return\n    stopOtaAutoChain()\n    await ota.installSession.discard()\n    returnToCheck()\n  }, [page, returnToCheck])\n\n  const openWifiSetup = useCallback(() => {\n    if (page === \"progress\") stopOtaAutoChain()\n    onOpenWifiSetupRef.current?.()\n  }, [page])\n\n  const state = useMemo<MentraLiveOtaState>(() => {\n    const hotspotSupported = otaSnapshot.hotspotOtaVersion === 1\n    const canInstall = otaSnapshot.wifiStatusKnown && (otaSnapshot.wifiConnected || hotspotSupported)\n    if (!runtimeReady) {\n      return {\n        screen: \"initializing\",\n        connected: otaSnapshot.connected,\n        transport: null,\n        updateRequired: isUpdateRequired,\n        versionChange: isVersionChange,\n        versionChangeConverged: false,\n        versionChangePhase: null,\n        wifiConnected: otaSnapshot.wifiConnected,\n        wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n        hotspotSupported,\n        hotspotPhase: \"idle\",\n        hotspotArtifactPercent: null,\n        phase: null,\n        step: null,\n        currentStep: null,\n        totalSteps: null,\n        progress: null,\n        installingApkOnly: false,\n        firmwareRestarting: false,\n        error: null,\n        canInstall: false,\n        canRetry: false,\n        canFinish: false,\n        canDismiss: false,\n        canDiscard: false,\n        canOpenWifiSetup: false,\n        continueDisabled: false,\n      }\n    }\n\n    if (page === \"check\") {\n      const wifiRequired = otaSnapshot.wifiStatusKnown && !otaSnapshot.wifiConnected && !hotspotSupported\n      const screen: MentraLiveOtaScreen =\n        checkState === \"checking\"\n          ? \"checking\"\n          : checkState === \"update_available\"\n            ? wifiRequired\n              ? \"wifi_required\"\n              : \"update_available\"\n            : checkState === \"no_update\"\n              ? \"up_to_date\"\n              : checkState === \"dev_build\"\n                ? \"dev_build\"\n                : errorKind === \"pin_unavailable\"\n                  ? \"update_info_unavailable\"\n                  : \"check_failed\"\n      const error: MentraLiveOtaError | null =\n        screen === \"check_failed\"\n          ? {code: \"check_failed\", message: \"Couldn't check for updates. Please check your connection and try again.\"}\n          : screen === \"update_info_unavailable\"\n            ? {code: \"update_info_unavailable\", message: \"Update information for this app version is unavailable.\"}\n            : null\n      return {\n        screen,\n        connected: otaSnapshot.connected,\n        transport: otaSnapshot.wifiConnected ? \"wifi\" : hotspotSupported ? \"hotspot\" : null,\n        updateRequired: isUpdateRequired,\n        versionChange: isVersionChange,\n        versionChangeConverged: false,\n        versionChangePhase: null,\n        wifiConnected: otaSnapshot.wifiConnected,\n        wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n        hotspotSupported,\n        hotspotPhase: \"idle\",\n        hotspotArtifactPercent: null,\n        phase: null,\n        step: null,\n        currentStep: null,\n        totalSteps: null,\n        progress: null,\n        installingApkOnly: false,\n        firmwareRestarting: false,\n        error,\n        canInstall: screen === \"update_available\" && canInstall,\n        canRetry: screen === \"check_failed\",\n        canFinish: screen === \"up_to_date\" || screen === \"dev_build\" || screen === \"update_info_unavailable\",\n        canDismiss: (screen === \"update_available\" || screen === \"wifi_required\") && !isUpdateRequired,\n        canDiscard: false,\n        canOpenWifiSetup: screen === \"wifi_required\",\n        continueDisabled: false,\n      }\n    }\n\n    const requiresGlassesReboot = shouldRequireGlassesRebootForBesFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    const showChangeWifi = shouldShowChangeWifiForOtaDownloadFailure(\n      installSnapshot.otaStatus,\n      installSnapshot.otaProgress,\n      installSnapshot.errorMsg,\n    )\n    const displayedError = requiresGlassesReboot\n      ? BES_INSTALL_RESTART_MESSAGE\n      : installSnapshot.errorMsg || getOtaErrorMessage(installSnapshot.otaStatus?.error)\n    const screen = progressScreen(installSnapshot)\n    const error =\n      screen === \"failed\"\n        ? {\n            code: requiresGlassesReboot ? (\"bes_restart_required\" as const) : (\"install_failed\" as const),\n            message: displayedError,\n          }\n        : null\n    const totalSteps = installSnapshot.otaStatus?.totalSteps ?? null\n    return {\n      screen,\n      connected: installSnapshot.connected,\n      transport: installSnapshot.transport,\n      updateRequired: isUpdateRequired,\n      versionChange: installSnapshot.isVersionChange,\n      versionChangeConverged: installSnapshot.versionChangeConverged,\n      versionChangePhase: installSnapshot.versionChangePhase,\n      wifiConnected: otaSnapshot.wifiConnected,\n      wifiStatusKnown: otaSnapshot.wifiStatusKnown,\n      hotspotSupported,\n      hotspotPhase: installSnapshot.hotspotPhase,\n      hotspotArtifactPercent: installSnapshot.hotspotArtifactPercent,\n      phase: installSnapshot.otaStatus?.phase ?? installSnapshot.otaProgress?.stage ?? null,\n      step: installSnapshot.otaStatus?.stepType ?? null,\n      currentStep: installSnapshot.otaStatus?.currentStep ?? null,\n      totalSteps,\n      progress: installProgress(installSnapshot),\n      installingApkOnly:\n        installSnapshot.otaStatus?.stepType === \"apk\" &&\n        installSnapshot.otaStatus.phase === \"install\" &&\n        totalSteps === 1,\n      firmwareRestarting,\n      error,\n      canInstall: false,\n      canRetry: screen === \"failed\" && !requiresGlassesReboot,\n      canFinish: screen === \"complete\" || screen === \"restarting\" || (screen === \"failed\" && requiresGlassesReboot),\n      canDismiss: false,\n      canDiscard: screen === \"disconnected\",\n      canOpenWifiSetup: screen === \"failed\" && showChangeWifi,\n      continueDisabled: installSnapshot.continueButtonDisabled,\n    }\n  }, [\n    checkState,\n    errorKind,\n    firmwareRestarting,\n    installSnapshot,\n    isUpdateRequired,\n    isVersionChange,\n    otaSnapshot,\n    page,\n    runtimeReady,\n  ])\n\n  return useMemo(\n    () => ({state, check, retryCheck: check, install, retryInstall, finish, discard, openWifiSetup}),\n    [check, discard, finish, install, openWifiSetup, retryInstall, state],\n  )\n}\n"]}

package/build/services/BlobStore.d.ts

@@ -78,6 +78,8 @@ export declare class BlobStore {
     handleOpenRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
     handleRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
     handleCloseRead(packageName: string, payload: Record<string, unknown>, requestId?: string): void;
+    /** Best-effort GC for prepared share handoffs retained in the OS cache. */
+    private cleanupShareCache;
     handleShare(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
     /** Called from LocalMiniappRuntime.unregisterApp — drop this app's in-flight state. */
     onAppGone(packageName: string): void;

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

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

package/build/services/BlobStore.js

@@ -36,8 +36,15 @@ const LOG_TAG = "LocalMiniappRuntime";
 /** Per-app blob quota: 1 GB. */
 export const BLOB_QUOTA_BYTES = 1024 * 1024 * 1024;
 const ROOT_DIR_NAME = "mentra_blobs";
-/** Cache dir root holding short-lived, properly-named copies handed to the OS share sheet (one unique subdir per share). */
+/** Cache dir root holding short-lived, properly-named copies handed to the OS share sheet (one subdir per stored blob). */
 const SHARE_DIR_NAME = "mentra_blob_share";
+/**
+ * Keep prepared share handoffs alive long enough for recipient apps to read
+ * them asynchronously (for example, an email composer attaching the file).
+ * Stale copies are collected before the next share; the OS may evict cache
+ * files sooner under storage pressure.
+ */
+const SHARE_CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 const META_KEY_ROOT = "mentraos_blobmeta_";
 /** Cap md5 computation so we don't block the JS thread hashing a huge file. */
 const MD5_MAX_BYTES = 50 * 1024 * 1024;
@@ -511,6 +518,36 @@ export class BlobStore {
         this.hooks.sendResult(packageName, requestId, true);
     }
     // ---- share ---------------------------------------------------------------
+    /** Best-effort GC for prepared share handoffs retained in the OS cache. */
+    cleanupShareCache(now = Date.now()) {
+        try {
+            const root = new Directory(Paths.cache, SHARE_DIR_NAME);
+            if (!root.exists)
+                return;
+            const cutoff = now - SHARE_CACHE_MAX_AGE_MS;
+            for (const entry of root.list()) {
+                if (!(entry instanceof Directory))
+                    continue;
+                try {
+                    const info = entry.info();
+                    // modificationTime is available on both platforms; creationTime can
+                    // be absent on Android versions before API 26. The directory id
+                    // begins with Date.now().toString(36), which is a final fallback.
+                    const encoded = entry.name.split("-", 1)[0];
+                    const encodedTime = /^[0-9a-z]+$/.test(encoded) ? Number.parseInt(encoded, 36) : Number.NaN;
+                    const timestamp = info.modificationTime ?? info.creationTime ?? encodedTime;
+                    if (Number.isFinite(timestamp) && timestamp < cutoff)
+                        entry.delete();
+                }
+                catch {
+                    // Keep scanning if one cache entry disappears or is unreadable.
+                }
+            }
+        }
+        catch {
+            // Cache cleanup must never prevent a share.
+        }
+    }
     async handleShare(packageName, payload, requestId) {
         const key = payload.key;
         const meta = this.readMeta(packageName, key);
@@ -528,23 +565,35 @@ export class BlobStore {
         // applies to base64/data payloads, not file:// URLs), so sharing `file.uri`
         // directly would hand the recipient a machine-named file. Copy to a temp
         // file that carries the real display name + extension, share that, then
-        // clean it up.
+        // clean it up after the recipient has had time to consume it.
         const shareName = shareFileName(meta);
-        // Copy into a per-share unique subdir so two concurrent shares that resolve
-        // to the same display name can't clobber each other's temp file while
-        // Share.open still references it. The file keeps `shareName` as its basename
-        // so the OS share sheet shows the right name + extension.
+        // Key the cache directory by the immutable stored filename. Repeated or
+        // concurrent shares of the same blob can safely reference the same bytes,
+        // avoiding an extra full-sized cache copy for every share. Different blobs
+        // still get isolated directories even when they use the same display name.
+        // The file keeps `shareName` as its basename so the OS share sheet shows the
+        // right name + extension.
         let tempDir = null;
+        let cacheReady = false;
         try {
-            tempDir = new Directory(Paths.cache, SHARE_DIR_NAME, this.makeId());
-            tempDir.create({ intermediates: true });
+            this.cleanupShareCache();
+            tempDir = new Directory(Paths.cache, SHARE_DIR_NAME, sanitizeSegment(meta.fileName));
+            if (!tempDir.exists)
+                tempDir.create({ intermediates: true });
             const temp = new File(tempDir, shareName);
-            file.copy(temp);
+            if (!temp.exists || temp.size !== meta.bytes) {
+                if (temp.exists)
+                    temp.delete();
+                file.copy(temp);
+            }
+            cacheReady = true;
             await Share.open({
                 url: temp.uri,
                 type: meta.mimeType || OCTET,
                 filename: shareName,
             });
+            // Share.open resolves once the OS accepts the handoff. Recipient apps may
+            // still read the URI asynchronously, so retain this cache copy for GC.
             this.hooks.sendResult(packageName, requestId, true, { success: true });
         }
         catch (error) {
@@ -557,7 +606,11 @@ export class BlobStore {
             }
         }
         finally {
-            if (tempDir) {
+            // Once a reusable cache entry is ready, retain it even if this particular
+            // sheet is cancelled or fails: another concurrent/recent share may still
+            // be reading the same file. Only remove an entry whose preparation did
+            // not finish; ready entries are collected after the retention window.
+            if (tempDir && !cacheReady) {
                 try {
                     if (tempDir.exists)
                         tempDir.delete();