@glassly/engine 0.1.0-dev.1 → 0.1.0-dev.101

package/build/services/HotspotOtaTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"HotspotOtaTransport.js","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {isEnabledHotspotStatus, OtaServer} from \"@glassly/bluetooth-sdk/internal\"\n// One coordinator selects the native Android or iOS staging implementation at runtime.\n// eslint-disable-next-line react-native/split-platform-components\nimport {PermissionsAndroid, Platform} from \"react-native\"\nimport type {OtaCheckCurrentGlassesResult} from \"./OtaUpdateCheckService\"\nimport {\n  cleanupArtifacts,\n  OtaArtifactError,\n  planArtifacts,\n  prepareArtifacts,\n  rewriteManifestForLocalServer,\n  type OtaArtifactDownloadProgress,\n  type PreparedOtaArtifact,\n} from \"./OtaArtifactDownloader\"\nimport {disableHotspotWithRetry} from \"./HotspotShutdown\"\nimport {localNetworkTransport} from \"./asg/localNetworkTransport\"\n\nexport type HotspotOtaPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\n\nexport type HotspotOtaProgress = {\n  phase: HotspotOtaPhase\n  artifact?: OtaArtifactDownloadProgress\n}\n\nexport type HotspotOtaErrorCode =\n  | \"hotspot_wifi_permission_denied\"\n  | \"hotspot_start_failed\"\n  | \"hotspot_join_failed\"\n  | \"hotspot_server_failed\"\n\nexport class HotspotOtaTransportError extends Error {\n  constructor(\n    public readonly code: HotspotOtaErrorCode,\n    message: string,\n  ) {\n    super(message)\n    this.name = \"HotspotOtaTransportError\"\n  }\n}\n\n/** Owns the single phone-side endpoint and network lease for one hotspot OTA attempt. */\nclass HotspotOtaTransport {\n  private active = false\n  private prepared: PreparedOtaArtifact[] = []\n  private hotspotRequested = false\n  private localNetworkConnected = false\n  private serverStarted = false\n  private teardownPromise: Promise<void> | null = null\n\n  async prepare(\n    checkResult: OtaCheckCurrentGlassesResult,\n    onProgress?: (progress: HotspotOtaProgress) => void,\n  ): Promise<string> {\n    if (this.teardownPromise) await this.teardownPromise\n    if (this.active) {\n      throw new Error(\"A hotspot OTA transport is already active\")\n    }\n    if (!checkResult.manifestBody) {\n      throw new Error(\"The selected OTA check has no manifest body\")\n    }\n\n    let phase: HotspotOtaPhase = \"downloading\"\n    try {\n      await this.ensureAndroidWifiPermission()\n      onProgress?.({phase: \"downloading\"})\n      this.prepared = await prepareArtifacts(\n        planArtifacts(checkResult),\n        (artifact) => onProgress?.({phase: \"downloading\", artifact}),\n        Platform.OS === \"ios\" ? this.downloadIosArtifact : undefined,\n      )\n\n      phase = \"starting_hotspot\"\n      onProgress?.({phase: \"starting_hotspot\"})\n      this.hotspotRequested = true\n      const hotspot = await BluetoothSdk.setHotspotState(true)\n      if (!isEnabledHotspotStatus(hotspot)) {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", \"Mentra Live did not return hotspot credentials\")\n      }\n      phase = \"joining_hotspot\"\n      onProgress?.({phase: \"joining_hotspot\"})\n      const scopedAddress = await localNetworkTransport.connect(hotspot.ssid, hotspot.password)\n      this.localNetworkConnected = true\n      let localAddress = scopedAddress\n      if (Platform.OS === \"ios\") {\n        try {\n          localAddress = await OtaServer.waitForWifiAddress(hotspot.localIp, 15_000)\n        } catch (error) {\n          throw new HotspotOtaTransportError(\n            \"hotspot_join_failed\",\n            error instanceof Error ? error.message : String(error),\n          )\n        }\n      }\n      const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]))\n      // Start exactly one native listener to learn its selected port, then atomically replace\n      // the placeholder with the immutable rewritten manifest before ota_start is sent.\n      const server = await OtaServer.startOtaServer(\"{}\", artifactPaths, localAddress)\n      this.serverStarted = true\n      const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl)\n      const published = await OtaServer.startOtaServer(manifest, artifactPaths, server.host)\n      if (published.manifestUrl !== server.manifestUrl) {\n        throw new Error(\"Local OTA server endpoint changed while publishing the manifest\")\n      }\n      this.active = true\n      onProgress?.({phase: \"serving\"})\n      return published.manifestUrl\n    } catch (error) {\n      const joined = this.localNetworkConnected\n      await this.teardown()\n      if (error instanceof OtaArtifactError || error instanceof HotspotOtaTransportError) {\n        throw error\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      if (phase === \"starting_hotspot\") {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", message)\n      }\n      if (phase === \"joining_hotspot\" && !joined) {\n        throw new HotspotOtaTransportError(\"hotspot_join_failed\", message)\n      }\n      throw new HotspotOtaTransportError(\"hotspot_server_failed\", message)\n    }\n  }\n\n  /** Android 13+ requires the nearby-WiFi runtime grant before WifiNetworkSpecifier is usable. */\n  private async ensureAndroidWifiPermission(): Promise<void> {\n    if (Platform.OS !== \"android\") return\n\n    const permission = PermissionsAndroid.PERMISSIONS.NEARBY_WIFI_DEVICES\n    if (await PermissionsAndroid.check(permission)) return\n    const result = await PermissionsAndroid.request(permission)\n    if (result !== PermissionsAndroid.RESULTS.GRANTED) {\n      throw new HotspotOtaTransportError(\n        \"hotspot_wifi_permission_denied\",\n        \"Nearby devices permission is required to connect to the glasses hotspot\",\n      )\n    }\n  }\n\n  private downloadIosArtifact = async (\n    entry: {url: string},\n    destination: string,\n    onProgress?: (bytesWritten: number, contentLength: number) => void,\n  ): Promise<{statusCode: number}> => {\n    const subscription = OtaServer.addListener(\"artifactDownloadProgress\", (event) => {\n      if (event.destination === destination) onProgress?.(event.bytesWritten, event.contentLength)\n    })\n    try {\n      return await OtaServer.downloadArtifact(entry.url, destination)\n    } finally {\n      subscription.remove()\n    }\n  }\n\n  async teardown(): Promise<void> {\n    if (this.teardownPromise) return this.teardownPromise\n    this.teardownPromise = (async () => {\n      if (this.hotspotRequested) {\n        const hotspotStopped = await disableHotspotWithRetry(() => BluetoothSdk.setHotspotState(false), {\n          // A completed APK step has just replaced ASG. Let the new command path\n          // settle before asking it to tear down the SystemUI-owned access point.\n          initialDelayMs: this.serverStarted ? 750 : 0,\n        })\n        if (!hotspotStopped) {\n          console.warn(\"[OTA_PROGRESS] glasses hotspot shutdown was not confirmed after bounded retries\")\n        }\n      }\n      if (this.serverStarted) await OtaServer.stopOtaServer().catch(() => {})\n      if (this.localNetworkConnected) await localNetworkTransport.disconnect().catch(() => {})\n      await cleanupArtifacts().catch(() => {})\n      this.prepared = []\n      this.active = false\n      this.serverStarted = false\n      this.localNetworkConnected = false\n      this.hotspotRequested = false\n    })()\n    try {\n      await this.teardownPromise\n    } finally {\n      this.teardownPromise = null\n    }\n  }\n}\n\nexport const hotspotOtaTransport = new HotspotOtaTransport()\n"]}
+{"version":3,"file":"HotspotOtaTransport.js","sourceRoot":"","sources":["../../src/services/HotspotOtaTransport.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,EAAE,EAAC,sBAAsB,EAAC,MAAM,wBAAwB,CAAA;AAC3E,OAAO,EAAC,SAAS,EAAC,MAAM,sCAAsC,CAAA;AAC9D,uFAAuF;AACvF,kEAAkE;AAClE,OAAO,EAAC,kBAAkB,EAAE,QAAQ,EAAC,MAAM,cAAc,CAAA;AAEzD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,6BAA6B,GAG9B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAC,uBAAuB,EAAC,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,6BAA6B,CAAA;AAejE,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAE/B;IADlB,YACkB,IAAyB,EACzC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAqB;QAIzC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,yFAAyF;AACzF,MAAM,mBAAmB;IACf,MAAM,GAAG,KAAK,CAAA;IACd,QAAQ,GAA0B,EAAE,CAAA;IACpC,gBAAgB,GAAG,KAAK,CAAA;IACxB,qBAAqB,GAAG,KAAK,CAAA;IAC7B,aAAa,GAAG,KAAK,CAAA;IACrB,eAAe,GAAyB,IAAI,CAAA;IAEpD,KAAK,CAAC,OAAO,CACX,WAAyC,EACzC,UAAmD;QAEnD,IAAI,IAAI,CAAC,eAAe;YAAE,MAAM,IAAI,CAAC,eAAe,CAAA;QACpD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAC9D,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QAED,IAAI,KAAK,GAAoB,aAAa,CAAA;QAC1C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,2BAA2B,EAAE,CAAA;YACxC,UAAU,EAAE,CAAC,EAAC,KAAK,EAAE,aAAa,EAAC,CAAC,CAAA;YACpC,IAAI,CAAC,QAAQ,GAAG,MAAM,gBAAgB,CACpC,aAAa,CAAC,WAAW,CAAC,EAC1B,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,EAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAC,CAAC,EAC5D,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAC7D,CAAA;YAED,KAAK,GAAG,kBAAkB,CAAA;YAC1B,UAAU,EAAE,CAAC,EAAC,KAAK,EAAE,kBAAkB,EAAC,CAAC,CAAA;YACzC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAA;YAC5B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YACxD,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,gDAAgD,CAAC,CAAA;YAC9G,CAAC;YACD,KAAK,GAAG,iBAAiB,CAAA;YACzB,UAAU,EAAE,CAAC,EAAC,KAAK,EAAE,iBAAiB,EAAC,CAAC,CAAA;YACxC,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;YACzF,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAA;YACjC,IAAI,YAAY,GAAG,aAAa,CAAA;YAChC,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,YAAY,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBAC5E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,wBAAwB,CAChC,qBAAqB,EACrB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAA;gBACH,CAAC;YACH,CAAC;YACD,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAC/G,wFAAwF;YACxF,kFAAkF;YAClF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;YACvE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACzB,MAAM,QAAQ,GAAG,6BAA6B,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;YACvG,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAC7E,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;YACpF,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,UAAU,EAAE,CAAC,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAA;YAChC,OAAO,SAAS,CAAC,WAAW,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAA;YACzC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrB,IAAI,KAAK,YAAY,gBAAgB,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;gBACnF,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,IAAI,KAAK,KAAK,kBAAkB,EAAE,CAAC;gBACjC,MAAM,IAAI,wBAAwB,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAA;YACrE,CAAC;YACD,IAAI,KAAK,KAAK,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,IAAI,wBAAwB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAA;YACpE,CAAC;YACD,MAAM,IAAI,wBAAwB,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IAED,gGAAgG;IACxF,KAAK,CAAC,2BAA2B;QACvC,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAM;QAErC,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,mBAAmB,CAAA;QACrE,IAAI,MAAM,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC;YAAE,OAAM;QACtD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC3D,IAAI,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAClD,MAAM,IAAI,wBAAwB,CAChC,gCAAgC,EAChC,yEAAyE,CAC1E,CAAA;QACH,CAAC;IACH,CAAC;IAEO,mBAAmB,GAAG,KAAK,EACjC,KAAoB,EACpB,WAAmB,EACnB,UAAkE,EACnC,EAAE;QACjC,MAAM,YAAY,GAAG,SAAS,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,EAAE;YAClE,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW;gBAAE,UAAU,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;QAC9F,CAAC,CAAC,CAAA;QACF,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;QACjE,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,MAAM,EAAE,CAAA;QACvB,CAAC;IACH,CAAC,CAAA;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAA;QACrD,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;YACjC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,MAAM,cAAc,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE;oBAC9F,uEAAuE;oBACvE,wEAAwE;oBACxE,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBAC7C,CAAC,CAAA;gBACF,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAA;gBACjG,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,aAAa;gBAAE,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC9D,IAAI,IAAI,CAAC,qBAAqB;gBAAE,MAAM,qBAAqB,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACxF,MAAM,gBAAgB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACxC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;YAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;YACnB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;YAC1B,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAA;YAClC,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAA;QAC/B,CAAC,CAAC,EAAE,CAAA;QACJ,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAA;QAC5B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,eAAe,GAAG,IAAI,CAAA;QAC7B,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA","sourcesContent":["import BluetoothSdk, {isEnabledHotspotStatus} from \"@glassly/bluetooth-sdk\"\nimport {otaServer} from \"@glassly/bluetooth-sdk/ota-transport\"\n// One coordinator selects the native Android or iOS staging implementation at runtime.\n// eslint-disable-next-line react-native/split-platform-components\nimport {PermissionsAndroid, Platform} from \"react-native\"\nimport type {OtaCheckCurrentGlassesResult} from \"./OtaUpdateCheckService\"\nimport {\n  cleanupArtifacts,\n  OtaArtifactError,\n  planArtifacts,\n  prepareArtifacts,\n  rewriteManifestForLocalServer,\n  type OtaArtifactDownloadProgress,\n  type PreparedOtaArtifact,\n} from \"./OtaArtifactDownloader\"\nimport {disableHotspotWithRetry} from \"./HotspotShutdown\"\nimport {localNetworkTransport} from \"./asg/localNetworkTransport\"\n\nexport type HotspotOtaPhase = \"idle\" | \"downloading\" | \"starting_hotspot\" | \"joining_hotspot\" | \"serving\"\n\nexport type HotspotOtaProgress = {\n  phase: HotspotOtaPhase\n  artifact?: OtaArtifactDownloadProgress\n}\n\nexport type HotspotOtaErrorCode =\n  | \"hotspot_wifi_permission_denied\"\n  | \"hotspot_start_failed\"\n  | \"hotspot_join_failed\"\n  | \"hotspot_server_failed\"\n\nexport class HotspotOtaTransportError extends Error {\n  constructor(\n    public readonly code: HotspotOtaErrorCode,\n    message: string,\n  ) {\n    super(message)\n    this.name = \"HotspotOtaTransportError\"\n  }\n}\n\n/** Owns the single phone-side endpoint and network lease for one hotspot OTA attempt. */\nclass HotspotOtaTransport {\n  private active = false\n  private prepared: PreparedOtaArtifact[] = []\n  private hotspotRequested = false\n  private localNetworkConnected = false\n  private serverStarted = false\n  private teardownPromise: Promise<void> | null = null\n\n  async prepare(\n    checkResult: OtaCheckCurrentGlassesResult,\n    onProgress?: (progress: HotspotOtaProgress) => void,\n  ): Promise<string> {\n    if (this.teardownPromise) await this.teardownPromise\n    if (this.active) {\n      throw new Error(\"A hotspot OTA transport is already active\")\n    }\n    if (!checkResult.manifestBody) {\n      throw new Error(\"The selected OTA check has no manifest body\")\n    }\n\n    let phase: HotspotOtaPhase = \"downloading\"\n    try {\n      await this.ensureAndroidWifiPermission()\n      onProgress?.({phase: \"downloading\"})\n      this.prepared = await prepareArtifacts(\n        planArtifacts(checkResult),\n        (artifact) => onProgress?.({phase: \"downloading\", artifact}),\n        Platform.OS === \"ios\" ? this.downloadIosArtifact : undefined,\n      )\n\n      phase = \"starting_hotspot\"\n      onProgress?.({phase: \"starting_hotspot\"})\n      this.hotspotRequested = true\n      const hotspot = await BluetoothSdk.setHotspotState(true)\n      if (!isEnabledHotspotStatus(hotspot)) {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", \"Mentra Live did not return hotspot credentials\")\n      }\n      phase = \"joining_hotspot\"\n      onProgress?.({phase: \"joining_hotspot\"})\n      const scopedAddress = await localNetworkTransport.connect(hotspot.ssid, hotspot.password)\n      this.localNetworkConnected = true\n      let localAddress = scopedAddress\n      if (Platform.OS === \"ios\") {\n        try {\n          localAddress = await otaServer.waitForWifiAddress(hotspot.localIp, 15_000)\n        } catch (error) {\n          throw new HotspotOtaTransportError(\n            \"hotspot_join_failed\",\n            error instanceof Error ? error.message : String(error),\n          )\n        }\n      }\n      const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]))\n      // Start exactly one native listener to learn its selected port, then atomically replace\n      // the placeholder with the immutable rewritten manifest before ota_start is sent.\n      const server = await otaServer.start(\"{}\", artifactPaths, localAddress)\n      this.serverStarted = true\n      const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl)\n      const published = await otaServer.start(manifest, artifactPaths, server.host)\n      if (published.manifestUrl !== server.manifestUrl) {\n        throw new Error(\"Local OTA server endpoint changed while publishing the manifest\")\n      }\n      this.active = true\n      onProgress?.({phase: \"serving\"})\n      return published.manifestUrl\n    } catch (error) {\n      const joined = this.localNetworkConnected\n      await this.teardown()\n      if (error instanceof OtaArtifactError || error instanceof HotspotOtaTransportError) {\n        throw error\n      }\n      const message = error instanceof Error ? error.message : String(error)\n      if (phase === \"starting_hotspot\") {\n        throw new HotspotOtaTransportError(\"hotspot_start_failed\", message)\n      }\n      if (phase === \"joining_hotspot\" && !joined) {\n        throw new HotspotOtaTransportError(\"hotspot_join_failed\", message)\n      }\n      throw new HotspotOtaTransportError(\"hotspot_server_failed\", message)\n    }\n  }\n\n  /** Android 13+ requires the nearby-WiFi runtime grant before WifiNetworkSpecifier is usable. */\n  private async ensureAndroidWifiPermission(): Promise<void> {\n    if (Platform.OS !== \"android\") return\n\n    const permission = PermissionsAndroid.PERMISSIONS.NEARBY_WIFI_DEVICES\n    if (await PermissionsAndroid.check(permission)) return\n    const result = await PermissionsAndroid.request(permission)\n    if (result !== PermissionsAndroid.RESULTS.GRANTED) {\n      throw new HotspotOtaTransportError(\n        \"hotspot_wifi_permission_denied\",\n        \"Nearby devices permission is required to connect to the glasses hotspot\",\n      )\n    }\n  }\n\n  private downloadIosArtifact = async (\n    entry: {url: string},\n    destination: string,\n    onProgress?: (bytesWritten: number, contentLength: number) => void,\n  ): Promise<{statusCode: number}> => {\n    const subscription = otaServer.onArtifactDownloadProgress((event) => {\n      if (event.destination === destination) onProgress?.(event.bytesWritten, event.contentLength)\n    })\n    try {\n      return await otaServer.downloadArtifact(entry.url, destination)\n    } finally {\n      subscription.remove()\n    }\n  }\n\n  async teardown(): Promise<void> {\n    if (this.teardownPromise) return this.teardownPromise\n    this.teardownPromise = (async () => {\n      if (this.hotspotRequested) {\n        const hotspotStopped = await disableHotspotWithRetry(() => BluetoothSdk.setHotspotState(false), {\n          // A completed APK step has just replaced ASG. Let the new command path\n          // settle before asking it to tear down the SystemUI-owned access point.\n          initialDelayMs: this.serverStarted ? 750 : 0,\n        })\n        if (!hotspotStopped) {\n          console.warn(\"[OTA_PROGRESS] glasses hotspot shutdown was not confirmed after bounded retries\")\n        }\n      }\n      if (this.serverStarted) await otaServer.stop().catch(() => {})\n      if (this.localNetworkConnected) await localNetworkTransport.disconnect().catch(() => {})\n      await cleanupArtifacts().catch(() => {})\n      this.prepared = []\n      this.active = false\n      this.serverStarted = false\n      this.localNetworkConnected = false\n      this.hotspotRequested = false\n    })()\n    try {\n      await this.teardownPromise\n    } finally {\n      this.teardownPromise = null\n    }\n  }\n}\n\nexport const hotspotOtaTransport = new HotspotOtaTransport()\n"]}

package/build/services/LocalDisplayManager.d.ts

@@ -2,8 +2,8 @@
  * LocalDisplayManager
  *
  * Phone-side arbiter for display requests originating from LOCAL miniapps
- * (the @glassly/miniapp SDK). Mirrors the user-facing behavior of the cloud
- * DisplayManager for the features that matter on the phone:
+ * (the @glassly/miniapp SDK). Preserves the retired cloud display manager's
+ * user-facing behavior for the features that matter on the phone:
  *
  *   - boot message ("Starting <AppName>…") with a bounded window
  *   - durationMs auto-clear
@@ -49,10 +49,22 @@ declare class LocalDisplayManager {
     private static instance;
     private coreApp;
     private coreAppDisplay;
-    private currentDisplay;
+    private _currentDisplay;
     private backgroundLock;
+    /** Fired when the display transitions between empty and occupied (any package, system screens included). */
+    private activeDisplayListeners;
+    private get currentDisplay();
+    private set currentDisplay(value);
+    /** True while anything (miniapp or system screen) is on the glasses display. */
+    hasActiveDisplay(): boolean;
+    /** Subscribe to empty↔occupied display transitions. Returns an unsubscribe. */
+    onActiveDisplayChange(listener: (active: boolean) => void): () => void;
     private bootingApp;
     private bootQueue;
+    /** While true the dashboard owns the glasses: main frames are retained but not sent. */
+    private dashboardActive;
+    /** Miniapp whose visible frame is temporarily covered by an OS exit notice. */
+    private exitingApp;
     private expiryTimerId;
     /** Reconnect-replay subscription state (attachToRuntime). */
     private runtimeAttached;
@@ -82,12 +94,51 @@ declare class LocalDisplayManager {
      * miniapp is foreground.
      */
     onCoreAppChange(packageName: string | null): void;
+    /**
+     * The package that currently owns the glasses screen, for gesture-claim
+     * arbitration (see LocalMiniappRuntime.foregroundClaimsGesture). This is
+     * glasses ownership, not the phone's Compositor foreground: a background
+     * miniapp rendering to the glasses with the phone pocketed is the owner.
+     *
+     * The live frame's owner wins; a background app that holds the display lock
+     * but has no frame up right now (between renders) still counts. System
+     * frames (boot, notices) own nothing claimable. Returns null when the
+     * glasses are idle.
+     */
+    getGestureOwner(): string | null;
+    /**
+     * The miniapp whose frame is visibly on the glasses right now.
+     *
+     * Unlike getGestureOwner(), this deliberately does not fall back to a
+     * background display lock: a lock holder with no live frame is not visible
+     * and therefore must not be closed by the system double-tap gesture.
+     */
+    getVisibleMiniappPackageName(): string | null;
+    /**
+     * Cover the currently visible miniapp with a persistent system exit notice.
+     * While it is up, miniapp display traffic is held off so a streaming app
+     * cannot immediately overwrite the notice. The caller completes the normal
+     * stop flow and then calls finishMiniappExit(); onUnmount does the same as a
+     * safety net.
+     */
+    beginMiniappExit(packageName: string, text: string): boolean;
+    /** Remove an exit notice and resume the display state normal app teardown leaves behind. */
+    finishMiniappExit(packageName: string): void;
+    /** Cancel the handoff and put back the frame the exit notice covered. */
+    cancelMiniappExit(packageName: string): void;
     /** Report-safe ownership snapshot for incident diagnostics. */
     getDiagnosticSnapshot(): Record<string, unknown>;
     /**
      * A local miniapp is going away. Clean up all state associated with it.
      */
     onUnmount(packageName: string): void;
+    /**
+     * Dashboard cover state. On deactivate the retained main frame repaints
+     * (scenes replay create-based; legacy re-sends), or the glasses clear.
+     */
+    setDashboardActive(active: boolean): void;
+    /** Dashboard renderers only; bypasses arbitration and main ownership state. */
+    renderDashboard(packageName: string, payload: DisplayPayload): void;
     /**
      * A miniapp requested a display. Routes through boot queue, arbitration,
      * and throttle. This is the only public entry point for miniapp display
@@ -120,6 +171,7 @@ declare class LocalDisplayManager {
      */
     private sendScene;
     private sendToNative;
+    private pushToNative;
     private handleExpiry;
     private tryRestoreCoreDisplay;
     private sendClear;

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

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

package/build/services/LocalDisplayManager.js

@@ -2,8 +2,8 @@
  * LocalDisplayManager
  *
  * Phone-side arbiter for display requests originating from LOCAL miniapps
- * (the @glassly/miniapp SDK). Mirrors the user-facing behavior of the cloud
- * DisplayManager for the features that matter on the phone:
+ * (the @glassly/miniapp SDK). Preserves the retired cloud display manager's
+ * user-facing behavior for the features that matter on the phone:
  *
  *   - boot message ("Starting <AppName>…") with a bounded window
  *   - durationMs auto-clear
@@ -59,10 +59,43 @@ class LocalDisplayManager {
     static instance = null;
     coreApp = null;
     coreAppDisplay = null;
-    currentDisplay = null;
+    _currentDisplay = null;
     backgroundLock = null;
+    /** Fired when the display transitions between empty and occupied (any package, system screens included). */
+    activeDisplayListeners = new Set();
+    get currentDisplay() {
+        return this._currentDisplay;
+    }
+    set currentDisplay(value) {
+        const wasActive = this._currentDisplay !== null;
+        this._currentDisplay = value;
+        const isActive = value !== null;
+        if (wasActive === isActive)
+            return;
+        for (const listener of this.activeDisplayListeners) {
+            try {
+                listener(isActive);
+            }
+            catch (error) {
+                console.error(`${LOG_TAG}: onActiveDisplayChange listener failed:`, error);
+            }
+        }
+    }
+    /** True while anything (miniapp or system screen) is on the glasses display. */
+    hasActiveDisplay() {
+        return this._currentDisplay !== null;
+    }
+    /** Subscribe to empty↔occupied display transitions. Returns an unsubscribe. */
+    onActiveDisplayChange(listener) {
+        this.activeDisplayListeners.add(listener);
+        return () => this.activeDisplayListeners.delete(listener);
+    }
     bootingApp = null;
     bootQueue = new Map();
+    /** While true the dashboard owns the glasses: main frames are retained but not sent. */
+    dashboardActive = false;
+    /** Miniapp whose visible frame is temporarily covered by an OS exit notice. */
+    exitingApp = null;
     expiryTimerId = null;
     /** Reconnect-replay subscription state (attachToRuntime). */
     runtimeAttached = false;
@@ -131,7 +164,7 @@ class LocalDisplayManager {
     showSystemNotice(text, durationMs = SYSTEM_NOTICE_DURATION_MS) {
         if (!isGlassesConnected(useGlassesStore.getState().connection))
             return;
-        if (this.bootingApp)
+        if (this.bootingApp || this.exitingApp)
             return;
         console.log(`${LOG_TAG}: showSystemNotice("${text}")`);
         this.sendNow(SYSTEM_NOTICE_PKG, {
@@ -157,6 +190,92 @@ class LocalDisplayManager {
             this.coreAppDisplay = null;
         }
     }
+    /**
+     * The package that currently owns the glasses screen, for gesture-claim
+     * arbitration (see LocalMiniappRuntime.foregroundClaimsGesture). This is
+     * glasses ownership, not the phone's Compositor foreground: a background
+     * miniapp rendering to the glasses with the phone pocketed is the owner.
+     *
+     * The live frame's owner wins; a background app that holds the display lock
+     * but has no frame up right now (between renders) still counts. System
+     * frames (boot, notices) own nothing claimable. Returns null when the
+     * glasses are idle.
+     */
+    getGestureOwner() {
+        const current = this.currentDisplay?.packageName ?? null;
+        if (current && current !== SYSTEM_BOOT_PKG && current !== SYSTEM_NOTICE_PKG)
+            return current;
+        const lock = this.backgroundLock;
+        if (lock && this.now() <= lock.expiresAt)
+            return lock.packageName;
+        return null;
+    }
+    /**
+     * The miniapp whose frame is visibly on the glasses right now.
+     *
+     * Unlike getGestureOwner(), this deliberately does not fall back to a
+     * background display lock: a lock holder with no live frame is not visible
+     * and therefore must not be closed by the system double-tap gesture.
+     */
+    getVisibleMiniappPackageName() {
+        const current = this.currentDisplay?.packageName ?? null;
+        if (!current || current === SYSTEM_BOOT_PKG || current === SYSTEM_NOTICE_PKG)
+            return null;
+        return current;
+    }
+    /**
+     * Cover the currently visible miniapp with a persistent system exit notice.
+     * While it is up, miniapp display traffic is held off so a streaming app
+     * cannot immediately overwrite the notice. The caller completes the normal
+     * stop flow and then calls finishMiniappExit(); onUnmount does the same as a
+     * safety net.
+     */
+    beginMiniappExit(packageName, text) {
+        if (this.exitingApp !== null)
+            return this.exitingApp.packageName === packageName;
+        const coveredDisplay = this.currentDisplay;
+        if (!coveredDisplay || this.getVisibleMiniappPackageName() !== packageName)
+            return false;
+        console.log(`${LOG_TAG}: beginMiniappExit(${packageName})`);
+        this.exitingApp = { packageName, coveredDisplay };
+        this.clearExpiryTimer();
+        this.sendNow(SYSTEM_NOTICE_PKG, {
+            view: "main",
+            layout: { layoutType: "text_wall", text },
+        });
+        return true;
+    }
+    /** Remove an exit notice and resume the display state normal app teardown leaves behind. */
+    finishMiniappExit(packageName) {
+        if (this.exitingApp?.packageName !== packageName)
+            return;
+        console.log(`${LOG_TAG}: finishMiniappExit(${packageName})`);
+        this.exitingApp = null;
+        if (this.currentDisplay?.packageName !== SYSTEM_NOTICE_PKG)
+            return;
+        this.currentDisplay = null;
+        this.tryRestoreCoreDisplay();
+        if (!this.currentDisplay)
+            this.sendClear();
+    }
+    /** Cancel the handoff and put back the frame the exit notice covered. */
+    cancelMiniappExit(packageName) {
+        if (this.exitingApp?.packageName !== packageName)
+            return;
+        const covered = this.exitingApp.coveredDisplay;
+        this.exitingApp = null;
+        if (this.currentDisplay?.packageName !== SYSTEM_NOTICE_PKG)
+            return;
+        if (covered.expiresAt === null || covered.expiresAt > this.now()) {
+            this.restoreDisplay(covered);
+        }
+        else {
+            this.currentDisplay = null;
+            this.tryRestoreCoreDisplay();
+            if (!this.currentDisplay)
+                this.sendClear();
+        }
+    }
     /** Report-safe ownership snapshot for incident diagnostics. */
     getDiagnosticSnapshot() {
         return {
@@ -164,6 +283,7 @@ class LocalDisplayManager {
             currentDisplayPackageName: this.currentDisplay?.packageName ?? null,
             backgroundLockPackageName: this.backgroundLock?.packageName ?? null,
             bootingPackageName: this.bootingApp?.packageName ?? null,
+            exitingPackageName: this.exitingApp?.packageName ?? null,
         };
     }
     /**
@@ -221,6 +341,51 @@ class LocalDisplayManager {
                 this.sendClear();
             }
         }
+        this.finishMiniappExit(packageName);
+    }
+    // ===========================================================================
+    // Dashboard switching (called from DashboardCoordinator)
+    // ===========================================================================
+    /**
+     * Dashboard cover state. On deactivate the retained main frame repaints
+     * (scenes replay create-based; legacy re-sends), or the glasses clear.
+     */
+    setDashboardActive(active) {
+        if (this.dashboardActive === active)
+            return;
+        this.dashboardActive = active;
+        useDisplayStore.getState().setDashboardActive(active);
+        if (active)
+            return;
+        sceneRenderer.markViewStale("dashboard");
+        const current = this.currentDisplay;
+        if (current && (current.expiresAt === null || this.now() < current.expiresAt)) {
+            this.replayCurrent();
+        }
+        else {
+            this.sendClear();
+        }
+    }
+    /** Dashboard renderers only; bypasses arbitration and main ownership state. */
+    renderDashboard(packageName, payload) {
+        if (!this.dashboardActive)
+            return;
+        if (payload.scene) {
+            sceneRenderer.emitScene(packageName, "dashboard", payload.scene);
+            return;
+        }
+        if (!payload.layout)
+            return;
+        const rawEvent = { view: "dashboard", layout: payload.layout };
+        let processedEvent;
+        try {
+            processedEvent = displayProcessor.processDisplayEvent(rawEvent);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: DisplayProcessor error, using raw event:`, err);
+            processedEvent = rawEvent;
+        }
+        this.pushToNative(processedEvent);
     }
     // ===========================================================================
     // Display request API (called from LocalMiniappRuntime.handleDisplay)
@@ -235,10 +400,17 @@ class LocalDisplayManager {
      * the boot queue (resolved when drained or superseded).
      */
     request(packageName, payload, resolve) {
-        // Dashboard view: pass straight through (no throttle/arbitration). Local
-        // dashboard rendering is currently a stub on the phone anyway.
+        // Keep the OS exit notice visible for its short handoff window. Without
+        // this, streaming captions/terminal frames can replace it immediately.
+        if (this.exitingApp !== null) {
+            resolve?.({ status: "blocked", reason: "a miniapp exit notice is active" });
+            return;
+        }
+        // Dashboard view: only visible while the dashboard covers the glasses.
+        // Local miniapp dashboard content remains a stub.
         if (payload.view === "dashboard") {
-            this.sendNow(packageName, payload, resolve);
+            this.renderDashboard(packageName, payload);
+            resolve?.({ status: "displayed" });
             return;
         }
         // During boot, any app's requests go into the queue. If the booting app
@@ -448,6 +620,21 @@ class LocalDisplayManager {
             console.error(`${LOG_TAG}: DisplayProcessor error, using raw event:`, err);
             processedEvent = rawEvent;
         }
+        // While the dashboard covers the glasses, main frames only update the
+        // retained state; setDashboardActive(false) replays the latest.
+        if (!this.dashboardActive)
+            this.pushToNative(processedEvent);
+        this.currentDisplay = { packageName, processedEvent, expiresAt };
+        this.clearExpiryTimer();
+        if (expiresAt !== null) {
+            const delay = Math.max(0, expiresAt - this.now());
+            this.expiryTimerId = BgTimer.setTimeout(() => {
+                this.expiryTimerId = null;
+                this.handleExpiry(packageName);
+            }, delay);
+        }
+    }
+    pushToNative(processedEvent) {
         try {
             // The display output path is a direct btsdk call now (was a host sendDisplayEvent
             // hook) so a bare OEM renders to the glasses without wiring it.
@@ -461,15 +648,6 @@ class LocalDisplayManager {
         catch (err) {
             console.error(`${LOG_TAG}: native display failed:`, err);
         }
-        this.currentDisplay = { packageName, processedEvent, expiresAt };
-        this.clearExpiryTimer();
-        if (expiresAt !== null) {
-            const delay = Math.max(0, expiresAt - this.now());
-            this.expiryTimerId = BgTimer.setTimeout(() => {
-                this.expiryTimerId = null;
-                this.handleExpiry(packageName);
-            }, delay);
-        }
     }
     handleExpiry(packageName) {
         // Someone else is on the glasses now — ignore.
@@ -663,6 +841,8 @@ class LocalDisplayManager {
         this.coreAppDisplay = null;
         this.currentDisplay = null;
         this.backgroundLock = null;
+        this.exitingApp = null;
+        this.dashboardActive = false;
         this.bootQueue.clear();
         this.now = () => Date.now();
         this.unsubscribeGlassesStatus?.();