@mentra/engine 0.1.0-dev.0 → 3.1.0-dev.4

package/build/services/OtaUpdateCheckService.d.ts

@@ -1,4 +1,13 @@
-import type { OtaUpdateInfo } from "@mentra/bluetooth-sdk/internal";
+import type { OtaUpdateInfo } from "@mentra/bluetooth-sdk";
+/**
+ * Phone-side mirror of ASG's `DOWNGRADE_FLOOR_VERSION_CODE`. Set to the versionCode of the first
+ * release shipping the shared media root (the first downgrade-safe build). A non-positive value
+ * means downgrades are disabled, so the phone must NOT offer them — offering a downgrade the
+ * glasses' `DowngradeGate` will refuse leaves the version-change session with no install and the
+ * glasses reporting a bare "complete", which would otherwise present as false success. Keep this
+ * in lockstep with the ASG/recovery constant at release time.
+ */
+export declare const DOWNGRADE_FLOOR_VERSION_CODE = 0;
 export interface VersionInfo {
     versionCode: number;
     versionName: string;
@@ -12,10 +21,12 @@ export interface MtkPatch {
     start_firmware: string;
     end_firmware: string;
     url: string;
+    sha256?: string;
 }
 export interface BesFirmware {
     version: string;
     url: string;
+    sha256?: string;
 }
 export interface VersionJson {
     apps?: {
@@ -37,8 +48,22 @@ export interface OtaCheckResult {
     updates: string[];
     mtkPatch: MtkPatch | null;
     besVersion: string | null;
+    /** True when the pending APK step installs an OLDER build than the glasses currently run. */
+    isApkDowngrade: boolean;
+    /**
+     * Raw manifest JSON (stringified) this check actually fetched, or null when the
+     * fetch failed. Lets change-watchers baseline on exactly what the check saw,
+     * instead of racing it with a second fetch of the same URL.
+     */
+    manifestBody: string | null;
+    /**
+     * Why the check failed, when it did. "network" is retryable (connection/server
+     * trouble); "pin_unavailable" is permanent for this app build (manifest 404/gone,
+     * unparseable, or carrying no valid ASG pin) — the remedy is updating the app.
+     */
+    checkFailureReason?: "network" | "pin_unavailable";
 }
-export type OtaCheckSkippedReason = "disconnected" | "missing_build";
+export type OtaCheckSkippedReason = "disconnected" | "missing_build" | "dev_build";
 export interface OtaCheckCurrentGlassesResult extends OtaCheckResult {
     updateInfo: OtaUpdateInfo | null;
     isRequired: boolean;
@@ -54,12 +79,22 @@ export interface OtaCheckCurrentGlassesOptions {
     waitForMtkVersionMs?: number;
     refreshVersionInfo?: boolean;
     fixClockBeforeCheck?: boolean;
+    /** Downgrade floor override (defaults to DOWNGRADE_FLOOR_VERSION_CODE); for tests. */
+    floorVersionCode?: number;
 }
 export declare function fetchVersionInfo(url: string): Promise<VersionJson | null>;
-export declare function checkVersionUpdateAvailable(currentBuildNumber: string | undefined, versionJson: VersionJson | null): boolean;
+export declare function checkVersionUpdateAvailable(currentBuildNumber: string | undefined, versionJson: VersionJson | null, floorVersionCode?: number): boolean;
+/**
+ * Direction of the pending APK change, or null when the glasses already match the manifest.
+ * Every apps-shaped manifest the phone drives is an exact pin, so both directions are
+ * actionable (mirroring the glasses-side `DowngradeGate`); the ancient top-level manifest
+ * shape stays upgrade-only, and zeroed rescue pins are never actionable.
+ */
+export declare function getApkUpdateDirection(currentBuildNumber: string | undefined, versionJson: VersionJson | null, floorVersionCode?: number): "upgrade" | "downgrade" | null;
 export declare function getLatestVersionInfo(versionJson: VersionJson | null): VersionInfo | null;
 export declare function findMatchingMtkPatch(patches: MtkPatch[] | undefined, currentVersion: string | undefined): MtkPatch | null;
 export declare function checkBesUpdate(besFirmware: BesFirmware | undefined, currentVersion: string | undefined): boolean;
-export declare function checkForOtaUpdate(otaVersionUrl: string, currentBuildNumber: string, currentMtkVersion?: string, currentBesVersion?: string): Promise<OtaCheckResult>;
+export declare function compareVersions(version1: string, version2: string): number;
+export declare function checkForOtaUpdate(otaVersionUrl: string, currentBuildNumber: string, currentMtkVersion?: string, currentBesVersion?: string, floorVersionCode?: number): Promise<OtaCheckResult>;
 export declare function checkCurrentGlassesForUpdate(options?: OtaCheckCurrentGlassesOptions): Promise<OtaCheckCurrentGlassesResult>;
 //# sourceMappingURL=OtaUpdateCheckService.d.ts.map

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

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

package/build/services/OtaUpdateCheckService.js

@@ -1,7 +1,16 @@
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
 import { getGlassesSystemTimeMs, isGlassesConnected, useGlassesStore, waitForGlassesState } from "../stores/glasses";
 import { maybeFixGlassesClockFromVersionInfo } from "./glassesClockSync";
-import { getAsgOtaVersionUrl } from "./asgOtaVersionUrl";
+import { hasConfiguredModernOtaManifestPin, resolveOtaManifestUrl } from "./otaManifestUrl";
+/**
+ * Phone-side mirror of ASG's `DOWNGRADE_FLOOR_VERSION_CODE`. Set to the versionCode of the first
+ * release shipping the shared media root (the first downgrade-safe build). A non-positive value
+ * means downgrades are disabled, so the phone must NOT offer them — offering a downgrade the
+ * glasses' `DowngradeGate` will refuse leaves the version-change session with no install and the
+ * glasses reporting a bare "complete", which would otherwise present as false success. Keep this
+ * in lockstep with the ASG/recovery constant at release time.
+ */
+export const DOWNGRADE_FLOOR_VERSION_CODE = 0;
 function emptyCheckResult(skippedReason) {
     return {
         hasCheckCompleted: false,
@@ -10,6 +19,8 @@ function emptyCheckResult(skippedReason) {
         updates: [],
         mtkPatch: null,
         besVersion: null,
+        isApkDowngrade: false,
+        manifestBody: null,
         updateInfo: null,
         isRequired: true,
         skippedReason,
@@ -18,39 +29,75 @@ function emptyCheckResult(skippedReason) {
 function glassesConnectedNow() {
     return isGlassesConnected(useGlassesStore.getState().connection);
 }
-export async function fetchVersionInfo(url) {
+async function fetchVersionInfoDetailed(url) {
     try {
         const response = await fetch(url);
         if (!response.ok) {
             console.error("Failed to fetch version info:", response.status);
-            return null;
+            // 4xx: the manifest does not exist (or is gone) — permanent for this app
+            // build, retrying cannot help. Everything else is transient server/network
+            // trouble and retryable.
+            return {
+                json: null,
+                failureReason: response.status >= 400 && response.status < 500 ? "pin_unavailable" : "network",
+            };
+        }
+        try {
+            return { json: await response.json() };
+        }
+        catch (parseError) {
+            console.error("OTA: manifest is not valid JSON:", parseError);
+            return { json: null, failureReason: "pin_unavailable" };
         }
-        return await response.json();
     }
     catch (error) {
         console.error("OTA: Error fetching version info:", error);
-        return null;
+        return { json: null, failureReason: "network" };
     }
 }
-export function checkVersionUpdateAvailable(currentBuildNumber, versionJson) {
+export async function fetchVersionInfo(url) {
+    return (await fetchVersionInfoDetailed(url)).json;
+}
+export function checkVersionUpdateAvailable(currentBuildNumber, versionJson, floorVersionCode = DOWNGRADE_FLOOR_VERSION_CODE) {
+    return getApkUpdateDirection(currentBuildNumber, versionJson, floorVersionCode) !== null;
+}
+/**
+ * Direction of the pending APK change, or null when the glasses already match the manifest.
+ * Every apps-shaped manifest the phone drives is an exact pin, so both directions are
+ * actionable (mirroring the glasses-side `DowngradeGate`); the ancient top-level manifest
+ * shape stays upgrade-only, and zeroed rescue pins are never actionable.
+ */
+export function getApkUpdateDirection(currentBuildNumber, versionJson, floorVersionCode = DOWNGRADE_FLOOR_VERSION_CODE) {
     if (!currentBuildNumber || !versionJson) {
-        return false;
+        return null;
     }
     const currentVersion = parseInt(currentBuildNumber, 10);
     if (isNaN(currentVersion)) {
-        return false;
+        return null;
     }
     let serverVersion;
-    if (versionJson.apps?.["com.mentra.asg_client"]) {
-        serverVersion = versionJson.apps["com.mentra.asg_client"].versionCode;
+    let exactPin = false;
+    const appEntry = versionJson.apps?.["com.mentra.asg_client"];
+    if (appEntry) {
+        serverVersion = appEntry.versionCode;
+        exactPin = true;
     }
     else if (versionJson.versionCode) {
         serverVersion = versionJson.versionCode;
     }
     if (!serverVersion || isNaN(serverVersion)) {
-        return false;
+        return null;
+    }
+    if (serverVersion > currentVersion) {
+        return "upgrade";
+    }
+    // Downgrades require an exact pin AND a target at/above the enabled floor. A non-positive floor
+    // disables downgrades entirely, matching ASG's fail-closed DowngradeGate — so the phone never
+    // offers what the glasses would refuse.
+    if (serverVersion < currentVersion && exactPin && floorVersionCode > 0 && serverVersion >= floorVersionCode) {
+        return "downgrade";
     }
-    return serverVersion > currentVersion;
+    return null;
 }
 export function getLatestVersionInfo(versionJson) {
     if (!versionJson) {
@@ -95,7 +142,7 @@ export function checkBesUpdate(besFirmware, currentVersion) {
     }
     return compareVersions(besFirmware.version, currentVersion) > 0;
 }
-function compareVersions(version1, version2) {
+export function compareVersions(version1, version2) {
     if (version1.includes(".") && version2.includes(".")) {
         const parts1 = version1.split(".");
         const parts2 = version2.split(".");
@@ -111,13 +158,53 @@ function compareVersions(version1, version2) {
     }
     return version1.localeCompare(version2);
 }
-export async function checkForOtaUpdate(otaVersionUrl, currentBuildNumber, currentMtkVersion, currentBesVersion) {
+export async function checkForOtaUpdate(otaVersionUrl, currentBuildNumber, currentMtkVersion, currentBesVersion, floorVersionCode = DOWNGRADE_FLOOR_VERSION_CODE) {
     try {
         console.log("OTA: Checking for OTA update - URL: " + otaVersionUrl + ", current build: " + currentBuildNumber);
-        const versionJson = await fetchVersionInfo(otaVersionUrl);
+        const fetched = await fetchVersionInfoDetailed(otaVersionUrl);
+        const versionJson = fetched.json;
+        if (!versionJson) {
+            return {
+                hasCheckCompleted: false,
+                updateAvailable: false,
+                latestVersionInfo: null,
+                updates: [],
+                mtkPatch: null,
+                besVersion: null,
+                isApkDowngrade: false,
+                manifestBody: null,
+                checkFailureReason: fetched.failureReason ?? "network",
+            };
+        }
         const latestVersionInfo = getLatestVersionInfo(versionJson);
-        const apkUpdateAvailable = checkVersionUpdateAvailable(currentBuildNumber, versionJson);
-        console.log(`OTA: APK update available: ${apkUpdateAvailable} (current: ${currentBuildNumber})`);
+        // A manifest whose ASG pin is missing/zeroed cannot verify anything for modern
+        // glasses (zeroed pins are only legitimate in the frozen legacy rescue manifests
+        // that pre-39 glasses are checked against). Report the check as FAILED rather
+        // than silently completing as "up to date" — an unverifiable state must never
+        // present as a verified one.
+        const currentVersionNumber = parseInt(currentBuildNumber, 10);
+        const pinnedEntry = versionJson?.apps?.["com.mentra.asg_client"];
+        const pinnedVersion = pinnedEntry?.versionCode ?? versionJson?.versionCode;
+        if (versionJson &&
+            Number.isFinite(currentVersionNumber) &&
+            currentVersionNumber >= 39 &&
+            !(typeof pinnedVersion === "number" && pinnedVersion > 0)) {
+            console.error(`OTA: manifest at ${otaVersionUrl} has no valid ASG pin (versionCode=${String(pinnedVersion)}) - treating check as failed`);
+            return {
+                hasCheckCompleted: false,
+                updateAvailable: false,
+                latestVersionInfo: null,
+                updates: [],
+                mtkPatch: null,
+                besVersion: null,
+                isApkDowngrade: false,
+                manifestBody: null,
+                checkFailureReason: "pin_unavailable",
+            };
+        }
+        const apkDirection = getApkUpdateDirection(currentBuildNumber, versionJson, floorVersionCode);
+        const apkUpdateAvailable = apkDirection !== null;
+        console.log(`OTA: APK update available: ${apkUpdateAvailable} (current: ${currentBuildNumber}, direction: ${apkDirection ?? "none"})`);
         const mtkPatch = findMatchingMtkPatch(versionJson?.mtk_patches, currentMtkVersion);
         const mtkUpdateAvailable = mtkPatch !== null;
         if (!currentMtkVersion && versionJson?.mtk_patches?.length) {
@@ -141,6 +228,8 @@ export async function checkForOtaUpdate(otaVersionUrl, currentBuildNumber, curre
             updates,
             mtkPatch,
             besVersion: versionJson?.bes_firmware?.version || null,
+            isApkDowngrade: apkDirection === "downgrade",
+            manifestBody: versionJson ? JSON.stringify(versionJson) : null,
         };
     }
     catch (error) {
@@ -152,14 +241,21 @@ export async function checkForOtaUpdate(otaVersionUrl, currentBuildNumber, curre
             updates: [],
             mtkPatch: null,
             besVersion: null,
+            isApkDowngrade: false,
+            manifestBody: null,
+            checkFailureReason: "network",
         };
     }
 }
 export async function checkCurrentGlassesForUpdate(options = {}) {
-    const { waitForBuildNumberMs = 0, waitForBesVersionMs = 5000, waitForMtkVersionMs = 2000, refreshVersionInfo = true, fixClockBeforeCheck = true, } = options;
+    const { waitForBuildNumberMs = 0, waitForBesVersionMs = 5000, waitForMtkVersionMs = 2000, refreshVersionInfo = true, fixClockBeforeCheck = true, floorVersionCode = DOWNGRADE_FLOOR_VERSION_CODE, } = options;
     if (!glassesConnectedNow()) {
         return emptyCheckResult("disconnected");
     }
+    if (!hasConfiguredModernOtaManifestPin()) {
+        console.log("OTA: check skipped - this app or Engine package has no embedded OTA manifest pin");
+        return emptyCheckResult("dev_build");
+    }
     if (refreshVersionInfo) {
         void BluetoothSdk.requestVersionInfo().catch((error) => {
             console.warn("OTA: Failed to request version_info from glasses:", error);
@@ -170,7 +266,10 @@ export async function checkCurrentGlassesForUpdate(options = {}) {
         await waitForGlassesState("buildNumber", (value) => !!value, waitForBuildNumberMs);
         buildNumber = useGlassesStore.getState().buildNumber;
     }
-    if (!buildNumber) {
+    if (!buildNumber || !(parseInt(buildNumber, 10) > 0)) {
+        // Covers absent, non-numeric, and zero build numbers: a glasses version we
+        // cannot parse means nothing is verifiable, so skip rather than ghost an
+        // "up to date" result from a comparison that never really ran.
         return emptyCheckResult("missing_build");
     }
     if (!glassesConnectedNow()) {
@@ -205,8 +304,12 @@ export async function checkCurrentGlassesForUpdate(options = {}) {
             console.warn("OTA: clock fix attempt failed; continuing OTA check", error);
         });
     }
-    const manifestUrl = getAsgOtaVersionUrl(useGlassesStore.getState().otaVersionUrl, buildNumber);
-    const result = await checkForOtaUpdate(manifestUrl, buildNumber, mtkFirmwareVersion, besFirmwareVersion);
+    const manifestUrl = resolveOtaManifestUrl(useGlassesStore.getState().otaVersionUrl, buildNumber);
+    if (!manifestUrl) {
+        console.log("OTA: check skipped - no OTA manifest pin resolved");
+        return emptyCheckResult("dev_build");
+    }
+    const result = await checkForOtaUpdate(manifestUrl, buildNumber, mtkFirmwareVersion, besFirmwareVersion, floorVersionCode);
     if (!result.hasCheckCompleted) {
         return {
             ...result,
@@ -235,6 +338,7 @@ export async function checkCurrentGlassesForUpdate(options = {}) {
             "reporting no update (legacy behavior)");
     }
     const updateAvailable = filteredUpdates.length > 0 && !!result.latestVersionInfo;
+    const isApkDowngrade = result.isApkDowngrade && filteredUpdates.includes("apk");
     const updateInfo = updateAvailable
         ? {
             available: true,
@@ -242,6 +346,8 @@ export async function checkCurrentGlassesForUpdate(options = {}) {
             versionName: result.latestVersionInfo?.versionName || "",
             updates: filteredUpdates,
             totalSize: 0,
+            ...(filteredUpdates.includes("bes") && result.besVersion ? { besVersion: result.besVersion } : {}),
+            isDowngrade: isApkDowngrade,
         }
         : null;
     useGlassesStore.getState().setOtaUpdateAvailable(updateInfo);
@@ -249,8 +355,18 @@ export async function checkCurrentGlassesForUpdate(options = {}) {
         ...result,
         updateAvailable,
         updates: filteredUpdates,
+        isApkDowngrade,
         updateInfo,
-        isRequired: result.latestVersionInfo?.isRequired !== false,
+        // Required-update policy: an EXPLICIT isRequired in the manifest is the
+        // release-engineering escape hatch and wins in both directions. When absent,
+        // upgrades keep the historical forced default, but downgrades are always
+        // skippable — a version change that resets glasses settings must be
+        // declinable unless someone explicitly forced it.
+        isRequired: result.latestVersionInfo?.isRequired === true
+            ? true
+            : result.latestVersionInfo?.isRequired === false
+                ? false
+                : !isApkDowngrade,
         manifestUrl,
         buildNumber,
         mtkFirmwareVersion,

package/build/services/OtaUpdateCheckService.js.map

@@ -1 +1 @@
-{"version":3,"file":"OtaUpdateCheckService.js","sourceRoot":"","sources":["../../src/services/OtaUpdateCheckService.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {OtaUpdateInfo} from \"@mentra/bluetooth-sdk/internal\"\nimport {getGlassesSystemTimeMs, isGlassesConnected, useGlassesStore, waitForGlassesState} from \"../stores/glasses\"\nimport {maybeFixGlassesClockFromVersionInfo} from \"./glassesClockSync\"\nimport {getAsgOtaVersionUrl} from \"./asgOtaVersionUrl\"\n\nexport interface VersionInfo {\n  versionCode: number\n  versionName: string\n  downloadUrl: string\n  apkSize: number\n  sha256: string\n  releaseNotes: string\n  isRequired?: boolean\n}\n\nexport interface MtkPatch {\n  start_firmware: string\n  end_firmware: string\n  url: string\n}\n\nexport interface BesFirmware {\n  version: string\n  url: string\n}\n\nexport interface VersionJson {\n  apps?: {\n    [packageName: string]: VersionInfo\n  }\n  mtk_patches?: MtkPatch[]\n  bes_firmware?: BesFirmware\n  versionCode?: number\n  versionName?: string\n  downloadUrl?: string\n  apkSize?: number\n  sha256?: string\n  releaseNotes?: string\n}\n\nexport interface OtaCheckResult {\n  hasCheckCompleted: boolean\n  updateAvailable: boolean\n  latestVersionInfo: VersionInfo | null\n  updates: string[]\n  mtkPatch: MtkPatch | null\n  besVersion: string | null\n}\n\nexport type OtaCheckSkippedReason = \"disconnected\" | \"missing_build\"\n\nexport interface OtaCheckCurrentGlassesResult extends OtaCheckResult {\n  updateInfo: OtaUpdateInfo | null\n  isRequired: boolean\n  skippedReason?: OtaCheckSkippedReason\n  manifestUrl?: string\n  buildNumber?: string\n  mtkFirmwareVersion?: string\n  besFirmwareVersion?: string\n}\n\nexport interface OtaCheckCurrentGlassesOptions {\n  waitForBuildNumberMs?: number\n  waitForBesVersionMs?: number\n  waitForMtkVersionMs?: number\n  refreshVersionInfo?: boolean\n  fixClockBeforeCheck?: boolean\n}\n\nfunction emptyCheckResult(skippedReason?: OtaCheckSkippedReason): OtaCheckCurrentGlassesResult {\n  return {\n    hasCheckCompleted: false,\n    updateAvailable: false,\n    latestVersionInfo: null,\n    updates: [],\n    mtkPatch: null,\n    besVersion: null,\n    updateInfo: null,\n    isRequired: true,\n    skippedReason,\n  }\n}\n\nfunction glassesConnectedNow(): boolean {\n  return isGlassesConnected(useGlassesStore.getState().connection)\n}\n\nexport async function fetchVersionInfo(url: string): Promise<VersionJson | null> {\n  try {\n    const response = await fetch(url)\n    if (!response.ok) {\n      console.error(\"Failed to fetch version info:\", response.status)\n      return null\n    }\n    return await response.json()\n  } catch (error) {\n    console.error(\"OTA: Error fetching version info:\", error)\n    return null\n  }\n}\n\nexport function checkVersionUpdateAvailable(\n  currentBuildNumber: string | undefined,\n  versionJson: VersionJson | null,\n): boolean {\n  if (!currentBuildNumber || !versionJson) {\n    return false\n  }\n\n  const currentVersion = parseInt(currentBuildNumber, 10)\n  if (isNaN(currentVersion)) {\n    return false\n  }\n\n  let serverVersion: number | undefined\n\n  if (versionJson.apps?.[\"com.mentra.asg_client\"]) {\n    serverVersion = versionJson.apps[\"com.mentra.asg_client\"].versionCode\n  } else if (versionJson.versionCode) {\n    serverVersion = versionJson.versionCode\n  }\n\n  if (!serverVersion || isNaN(serverVersion)) {\n    return false\n  }\n\n  return serverVersion > currentVersion\n}\n\nexport function getLatestVersionInfo(versionJson: VersionJson | null): VersionInfo | null {\n  if (!versionJson) {\n    return null\n  }\n\n  if (versionJson.apps?.[\"com.mentra.asg_client\"]) {\n    return versionJson.apps[\"com.mentra.asg_client\"]\n  }\n\n  if (versionJson.versionCode) {\n    return {\n      versionCode: versionJson.versionCode,\n      versionName: versionJson.versionName || \"\",\n      downloadUrl: versionJson.downloadUrl || \"\",\n      apkSize: versionJson.apkSize || 0,\n      sha256: versionJson.sha256 || \"\",\n      releaseNotes: versionJson.releaseNotes || \"\",\n    }\n  }\n\n  return null\n}\n\nexport function findMatchingMtkPatch(\n  patches: MtkPatch[] | undefined,\n  currentVersion: string | undefined,\n): MtkPatch | null {\n  if (!patches || !currentVersion) {\n    return null\n  }\n\n  return (\n    patches.find((patch) => {\n      if (patch.start_firmware === currentVersion) {\n        return true\n      }\n      const serverDate = patch.start_firmware.includes(\"_\")\n        ? patch.start_firmware.split(\"_\").pop()\n        : patch.start_firmware\n      return serverDate === currentVersion\n    }) || null\n  )\n}\n\nexport function checkBesUpdate(besFirmware: BesFirmware | undefined, currentVersion: string | undefined): boolean {\n  if (!besFirmware) {\n    return false\n  }\n\n  if (!currentVersion) {\n    console.log(`📱 BES current version unknown - assuming update needed (server: ${besFirmware.version})`)\n    return true\n  }\n  return compareVersions(besFirmware.version, currentVersion) > 0\n}\n\nfunction compareVersions(version1: string, version2: string): number {\n  if (version1.includes(\".\") && version2.includes(\".\")) {\n    const parts1 = version1.split(\".\")\n    const parts2 = version2.split(\".\")\n    const maxLen = Math.max(parts1.length, parts2.length)\n\n    for (let i = 0; i < maxLen; i++) {\n      const v1 = i < parts1.length ? parseInt(parts1[i], 10) : 0\n      const v2 = i < parts2.length ? parseInt(parts2[i], 10) : 0\n      if (v1 !== v2) {\n        return v1 - v2\n      }\n    }\n    return 0\n  }\n\n  return version1.localeCompare(version2)\n}\n\nexport async function checkForOtaUpdate(\n  otaVersionUrl: string,\n  currentBuildNumber: string,\n  currentMtkVersion?: string,\n  currentBesVersion?: string,\n): Promise<OtaCheckResult> {\n  try {\n    console.log(\"OTA: Checking for OTA update - URL: \" + otaVersionUrl + \", current build: \" + currentBuildNumber)\n    const versionJson = await fetchVersionInfo(otaVersionUrl)\n    const latestVersionInfo = getLatestVersionInfo(versionJson)\n\n    const apkUpdateAvailable = checkVersionUpdateAvailable(currentBuildNumber, versionJson)\n    console.log(`OTA: APK update available: ${apkUpdateAvailable} (current: ${currentBuildNumber})`)\n\n    const mtkPatch = findMatchingMtkPatch(versionJson?.mtk_patches, currentMtkVersion)\n    const mtkUpdateAvailable = mtkPatch !== null\n    if (!currentMtkVersion && versionJson?.mtk_patches?.length) {\n      console.log(`OTA: MTK current version unknown - skipping MTK patch check`)\n    }\n    console.log(\n      `OTA: MTK patch available: ${mtkUpdateAvailable ? \"yes\" : \"no\"} (current MTK: ${currentMtkVersion || \"unknown\"})`,\n    )\n\n    const besUpdateAvailable = checkBesUpdate(versionJson?.bes_firmware, currentBesVersion)\n    console.log(`OTA: BES update available: ${besUpdateAvailable} (current BES: ${currentBesVersion || \"unknown\"})`)\n\n    const updates: string[] = []\n    if (apkUpdateAvailable) updates.push(\"apk\")\n    if (mtkUpdateAvailable) updates.push(\"mtk\")\n    if (besUpdateAvailable) updates.push(\"bes\")\n\n    console.log(`OTA: OTA check result - updates available: ${updates.length > 0}, updates: [${updates.join(\", \")}]`)\n\n    return {\n      hasCheckCompleted: true,\n      updateAvailable: updates.length > 0,\n      latestVersionInfo,\n      updates,\n      mtkPatch,\n      besVersion: versionJson?.bes_firmware?.version || null,\n    }\n  } catch (error) {\n    console.error(\"Error checking for OTA update:\", error)\n    return {\n      hasCheckCompleted: false,\n      updateAvailable: false,\n      latestVersionInfo: null,\n      updates: [],\n      mtkPatch: null,\n      besVersion: null,\n    }\n  }\n}\n\nexport async function checkCurrentGlassesForUpdate(\n  options: OtaCheckCurrentGlassesOptions = {},\n): Promise<OtaCheckCurrentGlassesResult> {\n  const {\n    waitForBuildNumberMs = 0,\n    waitForBesVersionMs = 5000,\n    waitForMtkVersionMs = 2000,\n    refreshVersionInfo = true,\n    fixClockBeforeCheck = true,\n  } = options\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  if (refreshVersionInfo) {\n    void BluetoothSdk.requestVersionInfo().catch((error) => {\n      console.warn(\"OTA: Failed to request version_info from glasses:\", error)\n    })\n  }\n\n  let buildNumber = useGlassesStore.getState().buildNumber\n  if (!buildNumber && waitForBuildNumberMs > 0) {\n    await waitForGlassesState(\"buildNumber\", (value) => !!value, waitForBuildNumberMs)\n    buildNumber = useGlassesStore.getState().buildNumber\n  }\n\n  if (!buildNumber) {\n    return emptyCheckResult(\"missing_build\")\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  let besFirmwareVersion = useGlassesStore.getState().besFirmwareVersion\n  if (!besFirmwareVersion && waitForBesVersionMs > 0) {\n    console.log(\"OTA: BES version still unknown - waiting up to 5s for it to arrive...\")\n    await waitForGlassesState(\"besFirmwareVersion\", (value) => !!value, waitForBesVersionMs)\n    besFirmwareVersion = useGlassesStore.getState().besFirmwareVersion\n    if (besFirmwareVersion) {\n      console.log(`OTA: BES version arrived: ${besFirmwareVersion}`)\n    } else {\n      console.log(\"OTA: BES version still unknown after extended wait - will assume BES update if published\")\n    }\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  let mtkFirmwareVersion = useGlassesStore.getState().mtkFirmwareVersion\n  if (!mtkFirmwareVersion && waitForMtkVersionMs > 0) {\n    await waitForGlassesState(\"mtkFirmwareVersion\", (value) => !!value, waitForMtkVersionMs)\n    mtkFirmwareVersion = useGlassesStore.getState().mtkFirmwareVersion\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  if (fixClockBeforeCheck) {\n    const systemTimeMs = getGlassesSystemTimeMs()\n    await maybeFixGlassesClockFromVersionInfo(systemTimeMs > 0 ? systemTimeMs : undefined).catch((error) => {\n      console.warn(\"OTA: clock fix attempt failed; continuing OTA check\", error)\n    })\n  }\n\n  const manifestUrl = getAsgOtaVersionUrl(useGlassesStore.getState().otaVersionUrl, buildNumber)\n  const result = await checkForOtaUpdate(manifestUrl, buildNumber, mtkFirmwareVersion, besFirmwareVersion)\n\n  if (!result.hasCheckCompleted) {\n    return {\n      ...result,\n      updateInfo: null,\n      isRequired: true,\n      manifestUrl,\n      buildNumber,\n      mtkFirmwareVersion,\n      besFirmwareVersion,\n    }\n  }\n\n  const mtkUpdatedThisSession = useGlassesStore.getState().mtkUpdatedThisSession\n  let filteredUpdates = result.updates\n  if (mtkUpdatedThisSession && filteredUpdates.includes(\"mtk\")) {\n    console.log(\"OTA: Filtering out MTK - already updated this session (pending reboot)\")\n    filteredUpdates = filteredUpdates.filter((update) => update !== \"mtk\")\n  }\n\n  // Pre-migration parity: an update is only surfaced when the manifest also\n  // carries APK version metadata. A firmware-only manifest (mtk_patches /\n  // bes_firmware with no APK entry) is therefore dropped here — same as the\n  // legacy host check. Loud-log it so the case is visible in the field;\n  // surfacing firmware-only updates is a deliberate behavior change to make\n  // separately, not silently inside the boundary migration.\n  if (filteredUpdates.length > 0 && !result.latestVersionInfo) {\n    console.warn(\n      `OTA: manifest lists updates [${filteredUpdates.join(\", \")}] but has no APK version metadata - ` +\n        \"reporting no update (legacy behavior)\",\n    )\n  }\n  const updateAvailable = filteredUpdates.length > 0 && !!result.latestVersionInfo\n  const updateInfo = updateAvailable\n    ? {\n        available: true,\n        versionCode: result.latestVersionInfo?.versionCode || 0,\n        versionName: result.latestVersionInfo?.versionName || \"\",\n        updates: filteredUpdates,\n        totalSize: 0,\n      }\n    : null\n\n  useGlassesStore.getState().setOtaUpdateAvailable(updateInfo)\n\n  return {\n    ...result,\n    updateAvailable,\n    updates: filteredUpdates,\n    updateInfo,\n    isRequired: result.latestVersionInfo?.isRequired !== false,\n    manifestUrl,\n    buildNumber,\n    mtkFirmwareVersion,\n    besFirmwareVersion,\n  }\n}\n"]}
+{"version":3,"file":"OtaUpdateCheckService.js","sourceRoot":"","sources":["../../src/services/OtaUpdateCheckService.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {OtaUpdateInfo} from \"@mentra/bluetooth-sdk\"\nimport {getGlassesSystemTimeMs, isGlassesConnected, useGlassesStore, waitForGlassesState} from \"../stores/glasses\"\nimport {maybeFixGlassesClockFromVersionInfo} from \"./glassesClockSync\"\nimport {hasConfiguredModernOtaManifestPin, resolveOtaManifestUrl} from \"./otaManifestUrl\"\n\n/**\n * Phone-side mirror of ASG's `DOWNGRADE_FLOOR_VERSION_CODE`. Set to the versionCode of the first\n * release shipping the shared media root (the first downgrade-safe build). A non-positive value\n * means downgrades are disabled, so the phone must NOT offer them — offering a downgrade the\n * glasses' `DowngradeGate` will refuse leaves the version-change session with no install and the\n * glasses reporting a bare \"complete\", which would otherwise present as false success. Keep this\n * in lockstep with the ASG/recovery constant at release time.\n */\nexport const DOWNGRADE_FLOOR_VERSION_CODE = 0\n\nexport interface VersionInfo {\n  versionCode: number\n  versionName: string\n  downloadUrl: string\n  apkSize: number\n  sha256: string\n  releaseNotes: string\n  isRequired?: boolean\n}\n\nexport interface MtkPatch {\n  start_firmware: string\n  end_firmware: string\n  url: string\n  sha256?: string\n}\n\nexport interface BesFirmware {\n  version: string\n  url: string\n  sha256?: string\n}\n\nexport interface VersionJson {\n  apps?: {\n    [packageName: string]: VersionInfo\n  }\n  mtk_patches?: MtkPatch[]\n  bes_firmware?: BesFirmware\n  versionCode?: number\n  versionName?: string\n  downloadUrl?: string\n  apkSize?: number\n  sha256?: string\n  releaseNotes?: string\n}\n\nexport interface OtaCheckResult {\n  hasCheckCompleted: boolean\n  updateAvailable: boolean\n  latestVersionInfo: VersionInfo | null\n  updates: string[]\n  mtkPatch: MtkPatch | null\n  besVersion: string | null\n  /** True when the pending APK step installs an OLDER build than the glasses currently run. */\n  isApkDowngrade: boolean\n  /**\n   * Raw manifest JSON (stringified) this check actually fetched, or null when the\n   * fetch failed. Lets change-watchers baseline on exactly what the check saw,\n   * instead of racing it with a second fetch of the same URL.\n   */\n  manifestBody: string | null\n  /**\n   * Why the check failed, when it did. \"network\" is retryable (connection/server\n   * trouble); \"pin_unavailable\" is permanent for this app build (manifest 404/gone,\n   * unparseable, or carrying no valid ASG pin) — the remedy is updating the app.\n   */\n  checkFailureReason?: \"network\" | \"pin_unavailable\"\n}\n\nexport type OtaCheckSkippedReason = \"disconnected\" | \"missing_build\" | \"dev_build\"\n\nexport interface OtaCheckCurrentGlassesResult extends OtaCheckResult {\n  updateInfo: OtaUpdateInfo | null\n  isRequired: boolean\n  skippedReason?: OtaCheckSkippedReason\n  manifestUrl?: string\n  buildNumber?: string\n  mtkFirmwareVersion?: string\n  besFirmwareVersion?: string\n}\n\nexport interface OtaCheckCurrentGlassesOptions {\n  waitForBuildNumberMs?: number\n  waitForBesVersionMs?: number\n  waitForMtkVersionMs?: number\n  refreshVersionInfo?: boolean\n  fixClockBeforeCheck?: boolean\n  /** Downgrade floor override (defaults to DOWNGRADE_FLOOR_VERSION_CODE); for tests. */\n  floorVersionCode?: number\n}\n\nfunction emptyCheckResult(skippedReason?: OtaCheckSkippedReason): OtaCheckCurrentGlassesResult {\n  return {\n    hasCheckCompleted: false,\n    updateAvailable: false,\n    latestVersionInfo: null,\n    updates: [],\n    mtkPatch: null,\n    besVersion: null,\n    isApkDowngrade: false,\n    manifestBody: null,\n    updateInfo: null,\n    isRequired: true,\n    skippedReason,\n  }\n}\n\nfunction glassesConnectedNow(): boolean {\n  return isGlassesConnected(useGlassesStore.getState().connection)\n}\n\ntype ManifestFetchResult = {json: VersionJson | null; failureReason?: \"network\" | \"pin_unavailable\"}\n\nasync function fetchVersionInfoDetailed(url: string): Promise<ManifestFetchResult> {\n  try {\n    const response = await fetch(url)\n    if (!response.ok) {\n      console.error(\"Failed to fetch version info:\", response.status)\n      // 4xx: the manifest does not exist (or is gone) — permanent for this app\n      // build, retrying cannot help. Everything else is transient server/network\n      // trouble and retryable.\n      return {\n        json: null,\n        failureReason: response.status >= 400 && response.status < 500 ? \"pin_unavailable\" : \"network\",\n      }\n    }\n    try {\n      return {json: await response.json()}\n    } catch (parseError) {\n      console.error(\"OTA: manifest is not valid JSON:\", parseError)\n      return {json: null, failureReason: \"pin_unavailable\"}\n    }\n  } catch (error) {\n    console.error(\"OTA: Error fetching version info:\", error)\n    return {json: null, failureReason: \"network\"}\n  }\n}\n\nexport async function fetchVersionInfo(url: string): Promise<VersionJson | null> {\n  return (await fetchVersionInfoDetailed(url)).json\n}\n\nexport function checkVersionUpdateAvailable(\n  currentBuildNumber: string | undefined,\n  versionJson: VersionJson | null,\n  floorVersionCode: number = DOWNGRADE_FLOOR_VERSION_CODE,\n): boolean {\n  return getApkUpdateDirection(currentBuildNumber, versionJson, floorVersionCode) !== null\n}\n\n/**\n * Direction of the pending APK change, or null when the glasses already match the manifest.\n * Every apps-shaped manifest the phone drives is an exact pin, so both directions are\n * actionable (mirroring the glasses-side `DowngradeGate`); the ancient top-level manifest\n * shape stays upgrade-only, and zeroed rescue pins are never actionable.\n */\nexport function getApkUpdateDirection(\n  currentBuildNumber: string | undefined,\n  versionJson: VersionJson | null,\n  floorVersionCode: number = DOWNGRADE_FLOOR_VERSION_CODE,\n): \"upgrade\" | \"downgrade\" | null {\n  if (!currentBuildNumber || !versionJson) {\n    return null\n  }\n\n  const currentVersion = parseInt(currentBuildNumber, 10)\n  if (isNaN(currentVersion)) {\n    return null\n  }\n\n  let serverVersion: number | undefined\n  let exactPin = false\n\n  const appEntry = versionJson.apps?.[\"com.mentra.asg_client\"]\n  if (appEntry) {\n    serverVersion = appEntry.versionCode\n    exactPin = true\n  } else if (versionJson.versionCode) {\n    serverVersion = versionJson.versionCode\n  }\n\n  if (!serverVersion || isNaN(serverVersion)) {\n    return null\n  }\n\n  if (serverVersion > currentVersion) {\n    return \"upgrade\"\n  }\n  // Downgrades require an exact pin AND a target at/above the enabled floor. A non-positive floor\n  // disables downgrades entirely, matching ASG's fail-closed DowngradeGate — so the phone never\n  // offers what the glasses would refuse.\n  if (serverVersion < currentVersion && exactPin && floorVersionCode > 0 && serverVersion >= floorVersionCode) {\n    return \"downgrade\"\n  }\n  return null\n}\n\nexport function getLatestVersionInfo(versionJson: VersionJson | null): VersionInfo | null {\n  if (!versionJson) {\n    return null\n  }\n\n  if (versionJson.apps?.[\"com.mentra.asg_client\"]) {\n    return versionJson.apps[\"com.mentra.asg_client\"]\n  }\n\n  if (versionJson.versionCode) {\n    return {\n      versionCode: versionJson.versionCode,\n      versionName: versionJson.versionName || \"\",\n      downloadUrl: versionJson.downloadUrl || \"\",\n      apkSize: versionJson.apkSize || 0,\n      sha256: versionJson.sha256 || \"\",\n      releaseNotes: versionJson.releaseNotes || \"\",\n    }\n  }\n\n  return null\n}\n\nexport function findMatchingMtkPatch(\n  patches: MtkPatch[] | undefined,\n  currentVersion: string | undefined,\n): MtkPatch | null {\n  if (!patches || !currentVersion) {\n    return null\n  }\n\n  return (\n    patches.find((patch) => {\n      if (patch.start_firmware === currentVersion) {\n        return true\n      }\n      const serverDate = patch.start_firmware.includes(\"_\")\n        ? patch.start_firmware.split(\"_\").pop()\n        : patch.start_firmware\n      return serverDate === currentVersion\n    }) || null\n  )\n}\n\nexport function checkBesUpdate(besFirmware: BesFirmware | undefined, currentVersion: string | undefined): boolean {\n  if (!besFirmware) {\n    return false\n  }\n\n  if (!currentVersion) {\n    console.log(`📱 BES current version unknown - assuming update needed (server: ${besFirmware.version})`)\n    return true\n  }\n  return compareVersions(besFirmware.version, currentVersion) > 0\n}\n\nexport function compareVersions(version1: string, version2: string): number {\n  if (version1.includes(\".\") && version2.includes(\".\")) {\n    const parts1 = version1.split(\".\")\n    const parts2 = version2.split(\".\")\n    const maxLen = Math.max(parts1.length, parts2.length)\n\n    for (let i = 0; i < maxLen; i++) {\n      const v1 = i < parts1.length ? parseInt(parts1[i], 10) : 0\n      const v2 = i < parts2.length ? parseInt(parts2[i], 10) : 0\n      if (v1 !== v2) {\n        return v1 - v2\n      }\n    }\n    return 0\n  }\n\n  return version1.localeCompare(version2)\n}\n\nexport async function checkForOtaUpdate(\n  otaVersionUrl: string,\n  currentBuildNumber: string,\n  currentMtkVersion?: string,\n  currentBesVersion?: string,\n  floorVersionCode: number = DOWNGRADE_FLOOR_VERSION_CODE,\n): Promise<OtaCheckResult> {\n  try {\n    console.log(\"OTA: Checking for OTA update - URL: \" + otaVersionUrl + \", current build: \" + currentBuildNumber)\n    const fetched = await fetchVersionInfoDetailed(otaVersionUrl)\n    const versionJson = fetched.json\n    if (!versionJson) {\n      return {\n        hasCheckCompleted: false,\n        updateAvailable: false,\n        latestVersionInfo: null,\n        updates: [],\n        mtkPatch: null,\n        besVersion: null,\n        isApkDowngrade: false,\n        manifestBody: null,\n        checkFailureReason: fetched.failureReason ?? \"network\",\n      }\n    }\n    const latestVersionInfo = getLatestVersionInfo(versionJson)\n\n    // A manifest whose ASG pin is missing/zeroed cannot verify anything for modern\n    // glasses (zeroed pins are only legitimate in the frozen legacy rescue manifests\n    // that pre-39 glasses are checked against). Report the check as FAILED rather\n    // than silently completing as \"up to date\" — an unverifiable state must never\n    // present as a verified one.\n    const currentVersionNumber = parseInt(currentBuildNumber, 10)\n    const pinnedEntry = versionJson?.apps?.[\"com.mentra.asg_client\"]\n    const pinnedVersion = pinnedEntry?.versionCode ?? versionJson?.versionCode\n    if (\n      versionJson &&\n      Number.isFinite(currentVersionNumber) &&\n      currentVersionNumber >= 39 &&\n      !(typeof pinnedVersion === \"number\" && pinnedVersion > 0)\n    ) {\n      console.error(\n        `OTA: manifest at ${otaVersionUrl} has no valid ASG pin (versionCode=${String(pinnedVersion)}) - treating check as failed`,\n      )\n      return {\n        hasCheckCompleted: false,\n        updateAvailable: false,\n        latestVersionInfo: null,\n        updates: [],\n        mtkPatch: null,\n        besVersion: null,\n        isApkDowngrade: false,\n        manifestBody: null,\n        checkFailureReason: \"pin_unavailable\",\n      }\n    }\n\n    const apkDirection = getApkUpdateDirection(currentBuildNumber, versionJson, floorVersionCode)\n    const apkUpdateAvailable = apkDirection !== null\n    console.log(\n      `OTA: APK update available: ${apkUpdateAvailable} (current: ${currentBuildNumber}, direction: ${apkDirection ?? \"none\"})`,\n    )\n\n    const mtkPatch = findMatchingMtkPatch(versionJson?.mtk_patches, currentMtkVersion)\n    const mtkUpdateAvailable = mtkPatch !== null\n    if (!currentMtkVersion && versionJson?.mtk_patches?.length) {\n      console.log(`OTA: MTK current version unknown - skipping MTK patch check`)\n    }\n    console.log(\n      `OTA: MTK patch available: ${mtkUpdateAvailable ? \"yes\" : \"no\"} (current MTK: ${currentMtkVersion || \"unknown\"})`,\n    )\n\n    const besUpdateAvailable = checkBesUpdate(versionJson?.bes_firmware, currentBesVersion)\n    console.log(`OTA: BES update available: ${besUpdateAvailable} (current BES: ${currentBesVersion || \"unknown\"})`)\n\n    const updates: string[] = []\n    if (apkUpdateAvailable) updates.push(\"apk\")\n    if (mtkUpdateAvailable) updates.push(\"mtk\")\n    if (besUpdateAvailable) updates.push(\"bes\")\n\n    console.log(`OTA: OTA check result - updates available: ${updates.length > 0}, updates: [${updates.join(\", \")}]`)\n\n    return {\n      hasCheckCompleted: true,\n      updateAvailable: updates.length > 0,\n      latestVersionInfo,\n      updates,\n      mtkPatch,\n      besVersion: versionJson?.bes_firmware?.version || null,\n      isApkDowngrade: apkDirection === \"downgrade\",\n      manifestBody: versionJson ? JSON.stringify(versionJson) : null,\n    }\n  } catch (error) {\n    console.error(\"Error checking for OTA update:\", error)\n    return {\n      hasCheckCompleted: false,\n      updateAvailable: false,\n      latestVersionInfo: null,\n      updates: [],\n      mtkPatch: null,\n      besVersion: null,\n      isApkDowngrade: false,\n      manifestBody: null,\n      checkFailureReason: \"network\",\n    }\n  }\n}\n\nexport async function checkCurrentGlassesForUpdate(\n  options: OtaCheckCurrentGlassesOptions = {},\n): Promise<OtaCheckCurrentGlassesResult> {\n  const {\n    waitForBuildNumberMs = 0,\n    waitForBesVersionMs = 5000,\n    waitForMtkVersionMs = 2000,\n    refreshVersionInfo = true,\n    fixClockBeforeCheck = true,\n    floorVersionCode = DOWNGRADE_FLOOR_VERSION_CODE,\n  } = options\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  if (!hasConfiguredModernOtaManifestPin()) {\n    console.log(\"OTA: check skipped - this app or Engine package has no embedded OTA manifest pin\")\n    return emptyCheckResult(\"dev_build\")\n  }\n\n  if (refreshVersionInfo) {\n    void BluetoothSdk.requestVersionInfo().catch((error) => {\n      console.warn(\"OTA: Failed to request version_info from glasses:\", error)\n    })\n  }\n\n  let buildNumber = useGlassesStore.getState().buildNumber\n  if (!buildNumber && waitForBuildNumberMs > 0) {\n    await waitForGlassesState(\"buildNumber\", (value) => !!value, waitForBuildNumberMs)\n    buildNumber = useGlassesStore.getState().buildNumber\n  }\n\n  if (!buildNumber || !(parseInt(buildNumber, 10) > 0)) {\n    // Covers absent, non-numeric, and zero build numbers: a glasses version we\n    // cannot parse means nothing is verifiable, so skip rather than ghost an\n    // \"up to date\" result from a comparison that never really ran.\n    return emptyCheckResult(\"missing_build\")\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  let besFirmwareVersion = useGlassesStore.getState().besFirmwareVersion\n  if (!besFirmwareVersion && waitForBesVersionMs > 0) {\n    console.log(\"OTA: BES version still unknown - waiting up to 5s for it to arrive...\")\n    await waitForGlassesState(\"besFirmwareVersion\", (value) => !!value, waitForBesVersionMs)\n    besFirmwareVersion = useGlassesStore.getState().besFirmwareVersion\n    if (besFirmwareVersion) {\n      console.log(`OTA: BES version arrived: ${besFirmwareVersion}`)\n    } else {\n      console.log(\"OTA: BES version still unknown after extended wait - will assume BES update if published\")\n    }\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  let mtkFirmwareVersion = useGlassesStore.getState().mtkFirmwareVersion\n  if (!mtkFirmwareVersion && waitForMtkVersionMs > 0) {\n    await waitForGlassesState(\"mtkFirmwareVersion\", (value) => !!value, waitForMtkVersionMs)\n    mtkFirmwareVersion = useGlassesStore.getState().mtkFirmwareVersion\n  }\n\n  if (!glassesConnectedNow()) {\n    return emptyCheckResult(\"disconnected\")\n  }\n\n  if (fixClockBeforeCheck) {\n    const systemTimeMs = getGlassesSystemTimeMs()\n    await maybeFixGlassesClockFromVersionInfo(systemTimeMs > 0 ? systemTimeMs : undefined).catch((error) => {\n      console.warn(\"OTA: clock fix attempt failed; continuing OTA check\", error)\n    })\n  }\n\n  const manifestUrl = resolveOtaManifestUrl(useGlassesStore.getState().otaVersionUrl, buildNumber)\n  if (!manifestUrl) {\n    console.log(\"OTA: check skipped - no OTA manifest pin resolved\")\n    return emptyCheckResult(\"dev_build\")\n  }\n  const result = await checkForOtaUpdate(\n    manifestUrl,\n    buildNumber,\n    mtkFirmwareVersion,\n    besFirmwareVersion,\n    floorVersionCode,\n  )\n\n  if (!result.hasCheckCompleted) {\n    return {\n      ...result,\n      updateInfo: null,\n      isRequired: true,\n      manifestUrl,\n      buildNumber,\n      mtkFirmwareVersion,\n      besFirmwareVersion,\n    }\n  }\n\n  const mtkUpdatedThisSession = useGlassesStore.getState().mtkUpdatedThisSession\n  let filteredUpdates = result.updates\n  if (mtkUpdatedThisSession && filteredUpdates.includes(\"mtk\")) {\n    console.log(\"OTA: Filtering out MTK - already updated this session (pending reboot)\")\n    filteredUpdates = filteredUpdates.filter((update) => update !== \"mtk\")\n  }\n\n  // Pre-migration parity: an update is only surfaced when the manifest also\n  // carries APK version metadata. A firmware-only manifest (mtk_patches /\n  // bes_firmware with no APK entry) is therefore dropped here — same as the\n  // legacy host check. Loud-log it so the case is visible in the field;\n  // surfacing firmware-only updates is a deliberate behavior change to make\n  // separately, not silently inside the boundary migration.\n  if (filteredUpdates.length > 0 && !result.latestVersionInfo) {\n    console.warn(\n      `OTA: manifest lists updates [${filteredUpdates.join(\", \")}] but has no APK version metadata - ` +\n        \"reporting no update (legacy behavior)\",\n    )\n  }\n  const updateAvailable = filteredUpdates.length > 0 && !!result.latestVersionInfo\n  const isApkDowngrade = result.isApkDowngrade && filteredUpdates.includes(\"apk\")\n  const updateInfo = updateAvailable\n    ? {\n        available: true,\n        versionCode: result.latestVersionInfo?.versionCode || 0,\n        versionName: result.latestVersionInfo?.versionName || \"\",\n        updates: filteredUpdates,\n        totalSize: 0,\n        ...(filteredUpdates.includes(\"bes\") && result.besVersion ? {besVersion: result.besVersion} : {}),\n        isDowngrade: isApkDowngrade,\n      }\n    : null\n\n  useGlassesStore.getState().setOtaUpdateAvailable(updateInfo)\n\n  return {\n    ...result,\n    updateAvailable,\n    updates: filteredUpdates,\n    isApkDowngrade,\n    updateInfo,\n    // Required-update policy: an EXPLICIT isRequired in the manifest is the\n    // release-engineering escape hatch and wins in both directions. When absent,\n    // upgrades keep the historical forced default, but downgrades are always\n    // skippable — a version change that resets glasses settings must be\n    // declinable unless someone explicitly forced it.\n    isRequired:\n      result.latestVersionInfo?.isRequired === true\n        ? true\n        : result.latestVersionInfo?.isRequired === false\n          ? false\n          : !isApkDowngrade,\n    manifestUrl,\n    buildNumber,\n    mtkFirmwareVersion,\n    besFirmwareVersion,\n  }\n}\n"]}

package/build/services/PhoneCalendarHelpers.d.ts

@@ -0,0 +1,32 @@
+import { MiniappErrorCode, type CalendarEvent } from "@mentra/miniapp";
+export interface CalendarListRequest {
+    startsAt?: unknown;
+    endsAt?: unknown;
+    limit?: unknown;
+}
+export declare class PhoneCalendarError extends Error {
+    readonly code: MiniappErrorCode;
+    constructor(code: MiniappErrorCode, message: string);
+}
+export interface ValidatedCalendarListRequest {
+    startsAt: Date;
+    endsAt: Date;
+    limit: number;
+}
+export interface RawCalendarEvent {
+    id?: string;
+    calendarId?: string;
+    title?: string | null;
+    startDate: string | Date;
+    endDate: string | Date;
+    timeZone?: string | null;
+    allDay?: boolean;
+    location?: string | null;
+    notes?: string | null;
+    url?: string | null;
+}
+export declare function validateCalendarListRequest(request: CalendarListRequest): ValidatedCalendarListRequest;
+export declare function extractHttpsLinks(...values: Array<string | null | undefined>): string[];
+export declare function normalizeCalendarEvent(event: RawCalendarEvent): CalendarEvent;
+export declare function calendarEventOverlapsWindow(event: CalendarEvent, startsAt: Date, endsAt: Date): boolean;
+//# sourceMappingURL=PhoneCalendarHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCalendarHelpers.d.ts","sourceRoot":"","sources":["../../src/services/PhoneCalendarHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,KAAK,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAMpE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,gBAAgB;gBAAtB,IAAI,EAAE,gBAAgB,EACtC,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,IAAI,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,4BAA4B,CAkBtG;AAaD,wBAAgB,iBAAiB,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAUvF;AAyGD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAoB7E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAEvG"}