@mentra/engine 0.1.0-dev.0

package/build/services/cloudStreamApi.js

@@ -0,0 +1,81 @@
+/**
+ * Managed-stream provisioning over the cloud-v2 runtime (cloud-client REST):
+ *
+ *   POST   /api/camera/stream      -> provision (Cloudflare live input)
+ *   GET    /api/camera/stream/:id  -> provider's ingest status
+ *   DELETE /api/camera/stream/:id  -> teardown
+ *
+ * Drop-in replacement for the legacy `v2StreamApi` (which hit the v1 cloud's
+ * /api/v2/client/streams/managed on backend_url): same exported shapes, so
+ * PhoneStreamCoordinator is unchanged apart from the import. Local miniapps
+ * use ONLY this path — no legacy V1 transport.
+ *
+ * Errors are tagged with stage "provision"/"status"/"teardown" and transport
+ * "cloud-rest" so a miniapp sees exactly where and on which leg it broke.
+ */
+import { cloudClientService as cloudClient } from "./CloudClientService";
+export class StreamApiError extends Error {
+    code;
+    stage;
+    transport = "cloud-rest";
+    constructor(code, message, stage) {
+        super(message);
+        this.code = code;
+        this.stage = stage;
+        this.name = "StreamApiError";
+    }
+}
+/**
+ * Provision a managed stream on the cloud-v2 runtime. Returns ready-to-publish
+ * ingest URLs (credentials embedded) plus the playback URLs.
+ */
+export async function provisionManagedStream(restreamDestinations) {
+    let wire;
+    try {
+        wire = (await cloudClient.startManagedStream(restreamDestinations && restreamDestinations.length > 0 ? { restreamDestinations } : {}));
+    }
+    catch (err) {
+        throw new StreamApiError("STREAM_PROVISION_FAILED", err instanceof Error ? err.message : String(err), "provision");
+    }
+    const ingest = wire.ingest ?? {};
+    const playback = wire.playback ?? {};
+    const rtmpUrl = ingest.rtmpUrl ?? (ingest.url && ingest.streamKey ? `${ingest.url}${ingest.streamKey}` : "");
+    if (!playback.hls || !playback.dash) {
+        throw new StreamApiError("STREAM_PROVISION_INCOMPLETE", `runtime returned no playback URLs for stream ${wire.streamId}`, "provision");
+    }
+    return {
+        liveInputId: wire.streamId,
+        rtmpUrl,
+        srtUrl: ingest.srtUrl,
+        hlsUrl: playback.hls,
+        dashUrl: playback.dash,
+        webrtcUrl: playback.webrtc,
+        webrtcPublishUrl: ingest.webrtcPublishUrl,
+    };
+}
+/** The provider's view of the ingest: is the device's push arriving? */
+export async function getManagedStreamStatus(liveInputId) {
+    try {
+        const s = await cloudClient.getManagedStreamStatus(liveInputId);
+        return {
+            isConnected: s.isConnected,
+            state: s.state,
+            connectedAt: s.connectedAt,
+            lastSeenAt: s.lastSeenAt,
+            reason: s.reason,
+        };
+    }
+    catch (err) {
+        throw new StreamApiError("STREAM_STATUS_FAILED", err instanceof Error ? err.message : String(err), "status");
+    }
+}
+/** Tear down the provider stream. */
+export async function teardownManagedStream(liveInputId) {
+    try {
+        await cloudClient.stopManagedStream(liveInputId);
+    }
+    catch (err) {
+        throw new StreamApiError("STREAM_TEARDOWN_FAILED", err instanceof Error ? err.message : String(err), "teardown");
+    }
+}
+//# sourceMappingURL=cloudStreamApi.js.map

package/build/services/cloudStreamApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudStreamApi.js","sourceRoot":"","sources":["../../src/services/cloudStreamApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Managed-stream provisioning over the cloud-v2 runtime (cloud-client REST):\n *\n *   POST   /api/camera/stream      -> provision (Cloudflare live input)\n *   GET    /api/camera/stream/:id  -> provider's ingest status\n *   DELETE /api/camera/stream/:id  -> teardown\n *\n * Drop-in replacement for the legacy `v2StreamApi` (which hit the v1 cloud's\n * /api/v2/client/streams/managed on backend_url): same exported shapes, so\n * PhoneStreamCoordinator is unchanged apart from the import. Local miniapps\n * use ONLY this path — no legacy V1 transport.\n *\n * Errors are tagged with stage \"provision\"/\"status\"/\"teardown\" and transport\n * \"cloud-rest\" so a miniapp sees exactly where and on which leg it broke.\n */\n\nimport {cloudClientService as cloudClient} from \"./CloudClientService\"\n\n/**\n * Restream destination. The full stream key is part of the URL — Cloudflare\n * appends nothing on the publish side. `name` is a human label that surfaces\n * in Cloudflare's dashboard but doesn't affect routing.\n */\nexport interface RestreamDestination {\n  url: string\n  name?: string\n}\n\n/** Caller-facing shape: either a bare URL string or the full object. */\nexport type RestreamDestinationInput = string | RestreamDestination\n\nexport interface ProvisionResult {\n  liveInputId: string\n  rtmpUrl: string\n  srtUrl?: string\n  hlsUrl: string\n  dashUrl: string\n  webrtcUrl?: string\n  webrtcPublishUrl?: string\n}\n\nexport interface CloudflareStatus {\n  isConnected: boolean\n  state?: string | null\n  connectedAt?: string\n  lastSeenAt?: string\n  reason?: string\n}\n\nexport type StreamApiStage = \"provision\" | \"status\" | \"teardown\"\n\nexport class StreamApiError extends Error {\n  readonly transport = \"cloud-rest\" as const\n  constructor(\n    public readonly code: string,\n    message: string,\n    public readonly stage: StreamApiStage,\n  ) {\n    super(message)\n    this.name = \"StreamApiError\"\n  }\n}\n\n/** The cloud-v2 runtime's ManagedStream wire shape (open records, see protocol). */\ninterface ManagedStreamWire {\n  streamId: string\n  ingest: {\n    url?: string\n    streamKey?: string\n    rtmpUrl?: string\n    srtUrl?: string\n    webrtcPublishUrl?: string\n  }\n  playback: {\n    hls?: string\n    dash?: string\n    webrtc?: string\n  }\n}\n\n/**\n * Provision a managed stream on the cloud-v2 runtime. Returns ready-to-publish\n * ingest URLs (credentials embedded) plus the playback URLs.\n */\nexport async function provisionManagedStream(\n  restreamDestinations?: RestreamDestinationInput[],\n): Promise<ProvisionResult> {\n  let wire: ManagedStreamWire\n  try {\n    wire = (await cloudClient.startManagedStream(\n      restreamDestinations && restreamDestinations.length > 0 ? {restreamDestinations} : {},\n    )) as ManagedStreamWire\n  } catch (err) {\n    throw new StreamApiError(\n      \"STREAM_PROVISION_FAILED\",\n      err instanceof Error ? err.message : String(err),\n      \"provision\",\n    )\n  }\n\n  const ingest = wire.ingest ?? {}\n  const playback = wire.playback ?? {}\n  const rtmpUrl = ingest.rtmpUrl ?? (ingest.url && ingest.streamKey ? `${ingest.url}${ingest.streamKey}` : \"\")\n  if (!playback.hls || !playback.dash) {\n    throw new StreamApiError(\n      \"STREAM_PROVISION_INCOMPLETE\",\n      `runtime returned no playback URLs for stream ${wire.streamId}`,\n      \"provision\",\n    )\n  }\n\n  return {\n    liveInputId: wire.streamId,\n    rtmpUrl,\n    srtUrl: ingest.srtUrl,\n    hlsUrl: playback.hls,\n    dashUrl: playback.dash,\n    webrtcUrl: playback.webrtc,\n    webrtcPublishUrl: ingest.webrtcPublishUrl,\n  }\n}\n\n/** The provider's view of the ingest: is the device's push arriving? */\nexport async function getManagedStreamStatus(liveInputId: string): Promise<CloudflareStatus> {\n  try {\n    const s = await cloudClient.getManagedStreamStatus(liveInputId)\n    return {\n      isConnected: s.isConnected,\n      state: s.state,\n      connectedAt: s.connectedAt,\n      lastSeenAt: s.lastSeenAt,\n      reason: s.reason,\n    }\n  } catch (err) {\n    throw new StreamApiError(\n      \"STREAM_STATUS_FAILED\",\n      err instanceof Error ? err.message : String(err),\n      \"status\",\n    )\n  }\n}\n\n/** Tear down the provider stream. */\nexport async function teardownManagedStream(liveInputId: string): Promise<void> {\n  try {\n    await cloudClient.stopManagedStream(liveInputId)\n  } catch (err) {\n    throw new StreamApiError(\n      \"STREAM_TEARDOWN_FAILED\",\n      err instanceof Error ? err.message : String(err),\n      \"teardown\",\n    )\n  }\n}\n"]}

package/build/services/gallerySyncClock.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Clock skew detection for gallery sync (phone vs glasses).
+ * Phone pushes time to glasses only when skew is detected during sync.
+ */
+export declare const CLOCK_SKEW_TOLERANCE_MS = 60000;
+export type ClockSkewReason = "watermark_ahead_of_glasses" | "wall_clock_drift" | "";
+export interface ClockSkewResult {
+    skewed: boolean;
+    reason: ClockSkewReason;
+}
+export declare function detectClockSkew(phoneNow: number, glassesServerTime: number, lastSyncTime: number, toleranceMs?: number): ClockSkewResult;
+export declare function isSyncManifestEmpty(syncData: {
+    api_version?: number;
+    captures?: unknown[];
+    changed_files?: unknown[];
+}): boolean;
+//# sourceMappingURL=gallerySyncClock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gallerySyncClock.d.ts","sourceRoot":"","sources":["../../src/services/gallerySyncClock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAE7C,MAAM,MAAM,eAAe,GAAG,4BAA4B,GAAG,kBAAkB,GAAG,EAAE,CAAA;AAEpF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,eAAe,CAAA;CACxB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM,EACpB,WAAW,GAAE,MAAgC,GAC5C,eAAe,CAQjB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAA;CAC1B,GAAG,OAAO,CAKV"}

package/build/services/gallerySyncClock.js

@@ -0,0 +1,21 @@
+/**
+ * Clock skew detection for gallery sync (phone vs glasses).
+ * Phone pushes time to glasses only when skew is detected during sync.
+ */
+export const CLOCK_SKEW_TOLERANCE_MS = 60_000;
+export function detectClockSkew(phoneNow, glassesServerTime, lastSyncTime, toleranceMs = CLOCK_SKEW_TOLERANCE_MS) {
+    if (lastSyncTime > glassesServerTime + toleranceMs) {
+        return { skewed: true, reason: "watermark_ahead_of_glasses" };
+    }
+    if (Math.abs(phoneNow - glassesServerTime) > toleranceMs) {
+        return { skewed: true, reason: "wall_clock_drift" };
+    }
+    return { skewed: false, reason: "" };
+}
+export function isSyncManifestEmpty(syncData) {
+    if (syncData.api_version === 2 && syncData.captures && syncData.captures.length > 0) {
+        return false;
+    }
+    return !syncData.changed_files || syncData.changed_files.length === 0;
+}
+//# sourceMappingURL=gallerySyncClock.js.map

package/build/services/gallerySyncClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallerySyncClock.js","sourceRoot":"","sources":["../../src/services/gallerySyncClock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAS7C,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,iBAAyB,EACzB,YAAoB,EACpB,cAAsB,uBAAuB;IAE7C,IAAI,YAAY,GAAG,iBAAiB,GAAG,WAAW,EAAE,CAAC;QACnD,OAAO,EAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAC,CAAA;IAC7D,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAC,GAAG,WAAW,EAAE,CAAC;QACzD,OAAO,EAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAC,CAAA;IACnD,CAAC;IACD,OAAO,EAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAInC;IACC,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpF,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAA;AACvE,CAAC","sourcesContent":["/**\n * Clock skew detection for gallery sync (phone vs glasses).\n * Phone pushes time to glasses only when skew is detected during sync.\n */\n\nexport const CLOCK_SKEW_TOLERANCE_MS = 60_000\n\nexport type ClockSkewReason = \"watermark_ahead_of_glasses\" | \"wall_clock_drift\" | \"\"\n\nexport interface ClockSkewResult {\n  skewed: boolean\n  reason: ClockSkewReason\n}\n\nexport function detectClockSkew(\n  phoneNow: number,\n  glassesServerTime: number,\n  lastSyncTime: number,\n  toleranceMs: number = CLOCK_SKEW_TOLERANCE_MS,\n): ClockSkewResult {\n  if (lastSyncTime > glassesServerTime + toleranceMs) {\n    return {skewed: true, reason: \"watermark_ahead_of_glasses\"}\n  }\n  if (Math.abs(phoneNow - glassesServerTime) > toleranceMs) {\n    return {skewed: true, reason: \"wall_clock_drift\"}\n  }\n  return {skewed: false, reason: \"\"}\n}\n\nexport function isSyncManifestEmpty(syncData: {\n  api_version?: number\n  captures?: unknown[]\n  changed_files?: unknown[]\n}): boolean {\n  if (syncData.api_version === 2 && syncData.captures && syncData.captures.length > 0) {\n    return false\n  }\n  return !syncData.changed_files || syncData.changed_files.length === 0\n}\n"]}

package/build/services/glassesClockSync.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Push phone time to glasses only when clock skew is detected (gallery sync, OTA, etc.).
+ */
+export declare const CLOCK_SETTLE_MS = 500;
+/** @internal test-only */
+export declare function resetOtaClockFixCooldownForTests(): void;
+/**
+ * Set glasses system clock from phone when skew is detected.
+ */
+export declare function fixGlassesClockIfSkewed(glassesServerTime: number, lastSyncTime?: number): Promise<boolean>;
+/**
+ * After glasses report OTA failure due to clock skew, fix time and restart
+ * through the normal phone-driven ota_start path.
+ */
+export declare function handleOtaClockSkewFromGlasses(errorCode: string | undefined, glassesTimeMs?: number): Promise<boolean>;
+/**
+ * Proactive fix when version_info includes glasses system_time_ms before OTA manifest checks.
+ */
+export declare function maybeFixGlassesClockFromVersionInfo(systemTimeMs: number | undefined): Promise<boolean>;
+//# sourceMappingURL=glassesClockSync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glassesClockSync.d.ts","sourceRoot":"","sources":["../../src/services/glassesClockSync.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,eAAO,MAAM,eAAe,MAAM,CAAA;AASlC,0BAA0B;AAC1B,wBAAgB,gCAAgC,IAAI,IAAI,CAGvD;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3G;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED;;GAEG;AACH,wBAAsB,mCAAmC,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAW5G"}

package/build/services/glassesClockSync.js

@@ -0,0 +1,97 @@
+/**
+ * Push phone time to glasses only when clock skew is detected (gallery sync, OTA, etc.).
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { BgTimer } from "../utils/timers";
+import { useGlassesStore } from "../stores/glasses";
+import { getAsgOtaVersionUrl } from "./asgOtaVersionUrl";
+import { detectClockSkew } from "./gallerySyncClock";
+export const CLOCK_SETTLE_MS = 500;
+const OTA_CLOCK_FIX_COOLDOWN_MS = 30_000;
+let lastOtaClockFixAt = 0;
+// Coalesce concurrent OTA clock-fix attempts. Glasses can emit two clock_skew events
+// back-to-back during BLE handshake; without this guard both would await the BLE fix
+// + retry pair before either updated `lastOtaClockFixAt`.
+let inflightOtaClockFix = null;
+/** @internal test-only */
+export function resetOtaClockFixCooldownForTests() {
+    lastOtaClockFixAt = 0;
+    inflightOtaClockFix = null;
+}
+function delay(ms) {
+    return new Promise((resolve) => BgTimer.setTimeout(resolve, ms));
+}
+/**
+ * Set glasses system clock from phone when skew is detected.
+ */
+export async function fixGlassesClockIfSkewed(glassesServerTime, lastSyncTime = 0) {
+    const { skewed, reason } = detectClockSkew(Date.now(), glassesServerTime, lastSyncTime);
+    if (!skewed) {
+        return false;
+    }
+    console.log(`[GlassesClockSync] ⏰ Clock skew detected (${reason}) — setting glasses time from phone`);
+    await BluetoothSdk.setSystemTime(Date.now());
+    await delay(CLOCK_SETTLE_MS);
+    return true;
+}
+/**
+ * After glasses report OTA failure due to clock skew, fix time and restart
+ * through the normal phone-driven ota_start path.
+ */
+export async function handleOtaClockSkewFromGlasses(errorCode, glassesTimeMs) {
+    if (Date.now() - lastOtaClockFixAt < OTA_CLOCK_FIX_COOLDOWN_MS) {
+        return false;
+    }
+    const hasGlassesTime = typeof glassesTimeMs === "number" && Number.isFinite(glassesTimeMs) && glassesTimeMs > 0;
+    if (errorCode === "ssl_error") {
+        if (!hasGlassesTime) {
+            return false;
+        }
+        const { skewed } = detectClockSkew(Date.now(), glassesTimeMs, 0);
+        if (!skewed) {
+            return false;
+        }
+        console.log("[GlassesClockSync] ⏰ OTA ssl_error with wall-clock drift — treating as clock skew");
+    }
+    else if (errorCode !== "clock_skew") {
+        return false;
+    }
+    // Coalesce concurrent attempts: if a fix is already in flight, await its result instead
+    // of racing it through the cooldown guard.
+    if (inflightOtaClockFix) {
+        return inflightOtaClockFix;
+    }
+    const glassesTime = hasGlassesTime ? glassesTimeMs : Date.now() - 86_400_000;
+    inflightOtaClockFix = (async () => {
+        try {
+            const fixed = await fixGlassesClockIfSkewed(glassesTime, 0);
+            if (!fixed) {
+                return false;
+            }
+            lastOtaClockFixAt = Date.now();
+            const { buildNumber, otaVersionUrl } = useGlassesStore.getState();
+            const manifestUrl = getAsgOtaVersionUrl(otaVersionUrl, buildNumber);
+            console.log("[GlassesClockSync] ⏰ Restarting OTA with ota_start after clock fix");
+            await BluetoothSdk.startOtaUpdate(manifestUrl);
+            return true;
+        }
+        finally {
+            inflightOtaClockFix = null;
+        }
+    })();
+    return inflightOtaClockFix;
+}
+/**
+ * Proactive fix when version_info includes glasses system_time_ms before OTA manifest checks.
+ */
+export async function maybeFixGlassesClockFromVersionInfo(systemTimeMs) {
+    if (typeof systemTimeMs !== "number" || systemTimeMs <= 0) {
+        return false;
+    }
+    const fixed = await fixGlassesClockIfSkewed(systemTimeMs, 0);
+    if (!fixed) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=glassesClockSync.js.map

package/build/services/glassesClockSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glassesClockSync.js","sourceRoot":"","sources":["../../src/services/glassesClockSync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Push phone time to glasses only when clock skew is detected (gallery sync, OTA, etc.).\n */\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {BgTimer} from \"../utils/timers\"\nimport {useGlassesStore} from \"../stores/glasses\"\n\nimport {getAsgOtaVersionUrl} from \"./asgOtaVersionUrl\"\nimport {detectClockSkew} from \"./gallerySyncClock\"\n\nexport const CLOCK_SETTLE_MS = 500\n\nconst OTA_CLOCK_FIX_COOLDOWN_MS = 30_000\nlet lastOtaClockFixAt = 0\n// Coalesce concurrent OTA clock-fix attempts. Glasses can emit two clock_skew events\n// back-to-back during BLE handshake; without this guard both would await the BLE fix\n// + retry pair before either updated `lastOtaClockFixAt`.\nlet inflightOtaClockFix: Promise<boolean> | null = null\n\n/** @internal test-only */\nexport function resetOtaClockFixCooldownForTests(): void {\n  lastOtaClockFixAt = 0\n  inflightOtaClockFix = null\n}\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => BgTimer.setTimeout(resolve, ms))\n}\n\n/**\n * Set glasses system clock from phone when skew is detected.\n */\nexport async function fixGlassesClockIfSkewed(glassesServerTime: number, lastSyncTime = 0): Promise<boolean> {\n  const {skewed, reason} = detectClockSkew(Date.now(), glassesServerTime, lastSyncTime)\n  if (!skewed) {\n    return false\n  }\n  console.log(`[GlassesClockSync] ⏰ Clock skew detected (${reason}) — setting glasses time from phone`)\n  await BluetoothSdk.setSystemTime(Date.now())\n  await delay(CLOCK_SETTLE_MS)\n  return true\n}\n\n/**\n * After glasses report OTA failure due to clock skew, fix time and restart\n * through the normal phone-driven ota_start path.\n */\nexport async function handleOtaClockSkewFromGlasses(\n  errorCode: string | undefined,\n  glassesTimeMs?: number,\n): Promise<boolean> {\n  if (Date.now() - lastOtaClockFixAt < OTA_CLOCK_FIX_COOLDOWN_MS) {\n    return false\n  }\n\n  const hasGlassesTime = typeof glassesTimeMs === \"number\" && Number.isFinite(glassesTimeMs) && glassesTimeMs > 0\n\n  if (errorCode === \"ssl_error\") {\n    if (!hasGlassesTime) {\n      return false\n    }\n    const {skewed} = detectClockSkew(Date.now(), glassesTimeMs, 0)\n    if (!skewed) {\n      return false\n    }\n    console.log(\"[GlassesClockSync] ⏰ OTA ssl_error with wall-clock drift — treating as clock skew\")\n  } else if (errorCode !== \"clock_skew\") {\n    return false\n  }\n\n  // Coalesce concurrent attempts: if a fix is already in flight, await its result instead\n  // of racing it through the cooldown guard.\n  if (inflightOtaClockFix) {\n    return inflightOtaClockFix\n  }\n\n  const glassesTime = hasGlassesTime ? glassesTimeMs : Date.now() - 86_400_000\n\n  inflightOtaClockFix = (async () => {\n    try {\n      const fixed = await fixGlassesClockIfSkewed(glassesTime, 0)\n      if (!fixed) {\n        return false\n      }\n\n      lastOtaClockFixAt = Date.now()\n      const {buildNumber, otaVersionUrl} = useGlassesStore.getState()\n      const manifestUrl = getAsgOtaVersionUrl(otaVersionUrl, buildNumber)\n      console.log(\"[GlassesClockSync] ⏰ Restarting OTA with ota_start after clock fix\")\n      await BluetoothSdk.startOtaUpdate(manifestUrl)\n      return true\n    } finally {\n      inflightOtaClockFix = null\n    }\n  })()\n\n  return inflightOtaClockFix\n}\n\n/**\n * Proactive fix when version_info includes glasses system_time_ms before OTA manifest checks.\n */\nexport async function maybeFixGlassesClockFromVersionInfo(systemTimeMs: number | undefined): Promise<boolean> {\n  if (typeof systemTimeMs !== \"number\" || systemTimeMs <= 0) {\n    return false\n  }\n\n  const fixed = await fixGlassesClockIfSkewed(systemTimeMs, 0)\n  if (!fixed) {\n    return false\n  }\n\n  return true\n}\n"]}

package/build/services/manifestVersionGate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pure helper extracted from `AppRegistry.checkManifestVersions` so it
+ * can be unit-tested without dragging in the `expo-file-system`
+ * transitively-React-Native dependency tree.
+ *
+ * Returns `{ok: true}` when the manifest is compatible with the host,
+ * or `{ok: false, reason}` with a user-facing string. Manifests missing
+ * either field pass through (legacy single-bundle bundles).
+ *
+ * `sdkVersion` is the SDK ABI the bundle targets; `minHostVersion` is
+ * the host floor the miniapp requires. Both must satisfy semver-coerce.
+ * Strings that don't coerce are treated as "unspecified" — the
+ * CLI's validateManifest catches malformed inputs at install time so
+ * this helper stays permissive at the policy layer.
+ */
+export declare function checkManifestVersions(manifest: {
+    sdkVersion?: string;
+    minHostVersion?: string;
+} | null, options: {
+    hostVersion: string;
+    supportedSdkRange: string;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=manifestVersionGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifestVersionGate.d.ts","sourceRoot":"","sources":["../../src/services/manifestVersionGate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,EAC/D,OAAO,EAAE;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAC,GACxD;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,GAAG;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAsB1C"}

package/build/services/manifestVersionGate.js

@@ -0,0 +1,41 @@
+import semver from "semver";
+/**
+ * Pure helper extracted from `AppRegistry.checkManifestVersions` so it
+ * can be unit-tested without dragging in the `expo-file-system`
+ * transitively-React-Native dependency tree.
+ *
+ * Returns `{ok: true}` when the manifest is compatible with the host,
+ * or `{ok: false, reason}` with a user-facing string. Manifests missing
+ * either field pass through (legacy single-bundle bundles).
+ *
+ * `sdkVersion` is the SDK ABI the bundle targets; `minHostVersion` is
+ * the host floor the miniapp requires. Both must satisfy semver-coerce.
+ * Strings that don't coerce are treated as "unspecified" — the
+ * CLI's validateManifest catches malformed inputs at install time so
+ * this helper stays permissive at the policy layer.
+ */
+export function checkManifestVersions(manifest, options) {
+    if (!manifest)
+        return { ok: true };
+    if (manifest.minHostVersion) {
+        const cleanHost = semver.valid(semver.coerce(options.hostVersion) ?? options.hostVersion);
+        const cleanMin = semver.valid(semver.coerce(manifest.minHostVersion) ?? manifest.minHostVersion);
+        if (cleanHost && cleanMin && semver.lt(cleanHost, cleanMin)) {
+            return {
+                ok: false,
+                reason: `Requires MentraOS ${manifest.minHostVersion}+; this host is ${options.hostVersion}.`,
+            };
+        }
+    }
+    if (manifest.sdkVersion) {
+        const cleanSdk = semver.valid(semver.coerce(manifest.sdkVersion) ?? manifest.sdkVersion);
+        if (cleanSdk && !semver.satisfies(cleanSdk, options.supportedSdkRange)) {
+            return {
+                ok: false,
+                reason: `Built for SDK ${manifest.sdkVersion}; host supports ${options.supportedSdkRange}.`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=manifestVersionGate.js.map

package/build/services/manifestVersionGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestVersionGate.js","sourceRoot":"","sources":["../../src/services/manifestVersionGate.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA+D,EAC/D,OAAyD;IAEzD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAC,EAAE,EAAE,IAAI,EAAC,CAAA;IAChC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;QACzF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAA;QAChG,IAAI,SAAS,IAAI,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5D,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,qBAAqB,QAAQ,CAAC,cAAc,mBAAmB,OAAO,CAAC,WAAW,GAAG;aAC9F,CAAA;QACH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAA;QACxF,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvE,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,iBAAiB,QAAQ,CAAC,UAAU,mBAAmB,OAAO,CAAC,iBAAiB,GAAG;aAC5F,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAC,EAAE,EAAE,IAAI,EAAC,CAAA;AACnB,CAAC","sourcesContent":["import semver from \"semver\"\n\n/**\n * Pure helper extracted from `AppRegistry.checkManifestVersions` so it\n * can be unit-tested without dragging in the `expo-file-system`\n * transitively-React-Native dependency tree.\n *\n * Returns `{ok: true}` when the manifest is compatible with the host,\n * or `{ok: false, reason}` with a user-facing string. Manifests missing\n * either field pass through (legacy single-bundle bundles).\n *\n * `sdkVersion` is the SDK ABI the bundle targets; `minHostVersion` is\n * the host floor the miniapp requires. Both must satisfy semver-coerce.\n * Strings that don't coerce are treated as \"unspecified\" — the\n * CLI's validateManifest catches malformed inputs at install time so\n * this helper stays permissive at the policy layer.\n */\nexport function checkManifestVersions(\n  manifest: {sdkVersion?: string; minHostVersion?: string} | null,\n  options: {hostVersion: string; supportedSdkRange: string},\n): {ok: true} | {ok: false; reason: string} {\n  if (!manifest) return {ok: true}\n  if (manifest.minHostVersion) {\n    const cleanHost = semver.valid(semver.coerce(options.hostVersion) ?? options.hostVersion)\n    const cleanMin = semver.valid(semver.coerce(manifest.minHostVersion) ?? manifest.minHostVersion)\n    if (cleanHost && cleanMin && semver.lt(cleanHost, cleanMin)) {\n      return {\n        ok: false,\n        reason: `Requires MentraOS ${manifest.minHostVersion}+; this host is ${options.hostVersion}.`,\n      }\n    }\n  }\n  if (manifest.sdkVersion) {\n    const cleanSdk = semver.valid(semver.coerce(manifest.sdkVersion) ?? manifest.sdkVersion)\n    if (cleanSdk && !semver.satisfies(cleanSdk, options.supportedSdkRange)) {\n      return {\n        ok: false,\n        reason: `Built for SDK ${manifest.sdkVersion}; host supports ${options.supportedSdkRange}.`,\n      }\n    }\n  }\n  return {ok: true}\n}\n"]}

package/build/services/mentraUiShim.d.ts

@@ -0,0 +1,38 @@
+/**
+ * window.mentra — WebView-side bridge to the per-miniapp background JSContext.
+ *
+ * Injected into every UI WebView via `injectedJavaScriptBeforeContentLoaded`
+ * (iOS) or `injectedJavaScriptObject` + a bundler-emitted inline `<script>`
+ * (Android, where the `BeforeContentLoaded` prop is documented unreliable
+ * per react-native-webview issues #1099 / #1609).
+ *
+ * The shim:
+ *   - Buffers `mentra.send(channel, payload)` calls until `mentra.ready()`
+ *     fires + the host acks the channel is open. WebView-side BUFFERS (the
+ *     WebView is the short-lived side and shouldn't drop user input).
+ *   - Installs `window.__mentra.recv(envelope)` for the host to push
+ *     background → WebView messages via `webview.injectJavaScript(...)`.
+ *   - Sends `__heartbeat__` every 5s; host considers the WebView gone
+ *     after 15s of silence.
+ *   - Maintains monotonic seq numbers; the host's per-WebView dedup window
+ *     drops replays during reconnect.
+ *
+ * This file exports a `buildMentraUiShim()` function returning the JS
+ * source as a string. The host's MentraUIRouter wraps it inside the
+ * existing WebView setup so a single bundler-time string emission covers
+ * both platforms.
+ *
+ * IMPORTANT: the shim runs in the WebView's bare ECMAScript scope before
+ * the miniapp's bundle. It must not import anything; the source is one
+ * IIFE. The only injected dependencies are
+ * `window.ReactNativeWebView.postMessage` (provided by react-native-webview)
+ * and (on Android) `window.ReactNativeWebView.injectedObjectJson()`
+ * (provided when the host sets `injectedJavaScriptObject`).
+ */
+export interface MentraUiShimOptions {
+    packageName: string;
+    /** @deprecated No longer used — heartbeat removed since WebViews are foreground-only. */
+    heartbeatIntervalMs?: number;
+}
+export declare function buildMentraUiShim(options: MentraUiShimOptions): string;
+//# sourceMappingURL=mentraUiShim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mentraUiShim.d.ts","sourceRoot":"","sources":["../../src/services/mentraUiShim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAuUtE"}