@mentra/engine 0.1.0-dev.0 → 3.1.0-beta.100

package/build/react/useMentraLiveOta.d.ts

@@ -0,0 +1,84 @@
+import type { ReleaseChangelog } from "../facades/ota";
+export type MentraLiveOtaFlowPage = "check" | "progress";
+export type MentraLiveOtaScreen = "initializing" | "checking" | "finishing" | "update_available" | "battery_required" | "wifi_required" | "up_to_date" | "dev_build" | "check_failed" | "update_info_unavailable" | "starting" | "preparing_hotspot" | "updating" | "restarting" | "verifying" | "complete" | "failed" | "disconnected";
+export type MentraLiveOtaErrorCode = "check_failed" | "update_info_unavailable" | "install_failed" | "bes_restart_required";
+export type MentraLiveOtaError = {
+    code: MentraLiveOtaErrorCode;
+    message: string;
+};
+export type MentraLiveOtaTransport = "wifi" | "hotspot";
+export type MentraLiveOtaHotspotPhase = "idle" | "downloading" | "starting_hotspot" | "joining_hotspot" | "serving";
+export type MentraLiveOtaInstallPhase = "download" | "install";
+export type MentraLiveOtaStep = "apk" | "mtk" | "bes";
+export type MentraLiveOtaReleaseTransition = {
+    /** Current glasses software label. Temporarily backed by the reported ASG app version. */
+    fromVersion: string | null;
+    /** Exact coordinated release identity for the selected OTA pin. */
+    toVersion: string;
+};
+export type MentraLiveOtaState = {
+    screen: MentraLiveOtaScreen;
+    connected: boolean;
+    batteryLevel: number | null;
+    transport: MentraLiveOtaTransport | null;
+    updateRequired: boolean;
+    versionChange: boolean;
+    versionChangeConverged: boolean;
+    versionChangePhase: "installing" | "restarting" | "verifying" | null;
+    wifiConnected: boolean;
+    wifiStatusKnown: boolean;
+    hotspotSupported: boolean;
+    hotspotPhase: MentraLiveOtaHotspotPhase;
+    hotspotArtifactPercent: number | null;
+    phase: MentraLiveOtaInstallPhase | null;
+    step: MentraLiveOtaStep | null;
+    currentStep: number | null;
+    totalSteps: number | null;
+    progress: number | null;
+    installingApkOnly: boolean;
+    firmwareRestarting: boolean;
+    error: MentraLiveOtaError | null;
+    canInstall: boolean;
+    canRetry: boolean;
+    canFinish: boolean;
+    canDismiss: boolean;
+    canDiscard: boolean;
+    canOpenWifiSetup: boolean;
+    continueDisabled: boolean;
+    /** True only after an approved update session reaches a final no-update check. */
+    completedUpdate: boolean;
+    /** Release labels for the offered or just-completed coordinated update. */
+    releaseTransition: MentraLiveOtaReleaseTransition | null;
+    /** Release notes crossed by this update, newest first. Populated on completion. */
+    changelogs: ReleaseChangelog[];
+};
+export type UseMentraLiveOtaOptions = {
+    /** Entry page. `progress` exists for interrupted-session recovery. */
+    initialPage?: MentraLiveOtaFlowPage;
+    /** Start Engine's OTA-only projections. Full Engine hosts should pass false. */
+    initializeRuntime?: boolean;
+    /** Called after the final check or when an optional update is dismissed. */
+    onFinished?: () => void;
+    /** Host-owned Wi-Fi setup for glasses without hotspot OTA support. */
+    onOpenWifiSetup?: () => void;
+    /** Lets a host coordinate its connection overlay with OTA firmware restarts. */
+    onFirmwareRestartingChange?: (restarting: boolean, progressActive: boolean) => void;
+};
+export type MentraLiveOtaController = {
+    state: MentraLiveOtaState;
+    check: () => void;
+    retryCheck: () => void;
+    install: () => void;
+    retryInstall: () => void;
+    finish: () => void;
+    discard: () => void;
+    openWifiSetup: () => void;
+};
+export declare const MINIMUM_OTA_BATTERY_LEVEL = 25;
+/**
+ * Headless Mentra Live OTA flow. Engine owns checking, hotspot staging,
+ * APK/MTK/BES sequencing, restart recovery, retries, and verification; the host
+ * renders semantic state and invokes these idempotent actions.
+ */
+export declare function useMentraLiveOta(options?: UseMentraLiveOtaOptions): MentraLiveOtaController;
+//# sourceMappingURL=useMentraLiveOta.d.ts.map

package/build/react/useMentraLiveOta.d.ts.map

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