@glassly/engine 0.1.0-dev.0

package/build/services/HotspotOtaTransport.js

@@ -0,0 +1,146 @@
+import BluetoothSdk, { isEnabledHotspotStatus, OtaServer } from "@glassly/bluetooth-sdk/internal";
+// One coordinator selects the native Android or iOS staging implementation at runtime.
+// eslint-disable-next-line react-native/split-platform-components
+import { PermissionsAndroid, Platform } from "react-native";
+import { cleanupArtifacts, OtaArtifactError, planArtifacts, prepareArtifacts, rewriteManifestForLocalServer, } from "./OtaArtifactDownloader";
+import { disableHotspotWithRetry } from "./HotspotShutdown";
+import { localNetworkTransport } from "./asg/localNetworkTransport";
+export class HotspotOtaTransportError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "HotspotOtaTransportError";
+    }
+}
+/** Owns the single phone-side endpoint and network lease for one hotspot OTA attempt. */
+class HotspotOtaTransport {
+    active = false;
+    prepared = [];
+    hotspotRequested = false;
+    localNetworkConnected = false;
+    serverStarted = false;
+    teardownPromise = null;
+    async prepare(checkResult, onProgress) {
+        if (this.teardownPromise)
+            await this.teardownPromise;
+        if (this.active) {
+            throw new Error("A hotspot OTA transport is already active");
+        }
+        if (!checkResult.manifestBody) {
+            throw new Error("The selected OTA check has no manifest body");
+        }
+        let phase = "downloading";
+        try {
+            await this.ensureAndroidWifiPermission();
+            onProgress?.({ phase: "downloading" });
+            this.prepared = await prepareArtifacts(planArtifacts(checkResult), (artifact) => onProgress?.({ phase: "downloading", artifact }), Platform.OS === "ios" ? this.downloadIosArtifact : undefined);
+            phase = "starting_hotspot";
+            onProgress?.({ phase: "starting_hotspot" });
+            this.hotspotRequested = true;
+            const hotspot = await BluetoothSdk.setHotspotState(true);
+            if (!isEnabledHotspotStatus(hotspot)) {
+                throw new HotspotOtaTransportError("hotspot_start_failed", "Mentra Live did not return hotspot credentials");
+            }
+            phase = "joining_hotspot";
+            onProgress?.({ phase: "joining_hotspot" });
+            const scopedAddress = await localNetworkTransport.connect(hotspot.ssid, hotspot.password);
+            this.localNetworkConnected = true;
+            let localAddress = scopedAddress;
+            if (Platform.OS === "ios") {
+                try {
+                    localAddress = await OtaServer.waitForWifiAddress(hotspot.localIp, 15_000);
+                }
+                catch (error) {
+                    throw new HotspotOtaTransportError("hotspot_join_failed", error instanceof Error ? error.message : String(error));
+                }
+            }
+            const artifactPaths = Object.fromEntries(this.prepared.map((artifact) => [artifact.sha256, artifact.filePath]));
+            // Start exactly one native listener to learn its selected port, then atomically replace
+            // the placeholder with the immutable rewritten manifest before ota_start is sent.
+            const server = await OtaServer.startOtaServer("{}", artifactPaths, localAddress);
+            this.serverStarted = true;
+            const manifest = rewriteManifestForLocalServer(checkResult.manifestBody, this.prepared, server.baseUrl);
+            const published = await OtaServer.startOtaServer(manifest, artifactPaths, server.host);
+            if (published.manifestUrl !== server.manifestUrl) {
+                throw new Error("Local OTA server endpoint changed while publishing the manifest");
+            }
+            this.active = true;
+            onProgress?.({ phase: "serving" });
+            return published.manifestUrl;
+        }
+        catch (error) {
+            const joined = this.localNetworkConnected;
+            await this.teardown();
+            if (error instanceof OtaArtifactError || error instanceof HotspotOtaTransportError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            if (phase === "starting_hotspot") {
+                throw new HotspotOtaTransportError("hotspot_start_failed", message);
+            }
+            if (phase === "joining_hotspot" && !joined) {
+                throw new HotspotOtaTransportError("hotspot_join_failed", message);
+            }
+            throw new HotspotOtaTransportError("hotspot_server_failed", message);
+        }
+    }
+    /** Android 13+ requires the nearby-WiFi runtime grant before WifiNetworkSpecifier is usable. */
+    async ensureAndroidWifiPermission() {
+        if (Platform.OS !== "android")
+            return;
+        const permission = PermissionsAndroid.PERMISSIONS.NEARBY_WIFI_DEVICES;
+        if (await PermissionsAndroid.check(permission))
+            return;
+        const result = await PermissionsAndroid.request(permission);
+        if (result !== PermissionsAndroid.RESULTS.GRANTED) {
+            throw new HotspotOtaTransportError("hotspot_wifi_permission_denied", "Nearby devices permission is required to connect to the glasses hotspot");
+        }
+    }
+    downloadIosArtifact = async (entry, destination, onProgress) => {
+        const subscription = OtaServer.addListener("artifactDownloadProgress", (event) => {
+            if (event.destination === destination)
+                onProgress?.(event.bytesWritten, event.contentLength);
+        });
+        try {
+            return await OtaServer.downloadArtifact(entry.url, destination);
+        }
+        finally {
+            subscription.remove();
+        }
+    };
+    async teardown() {
+        if (this.teardownPromise)
+            return this.teardownPromise;
+        this.teardownPromise = (async () => {
+            if (this.hotspotRequested) {
+                const hotspotStopped = await disableHotspotWithRetry(() => BluetoothSdk.setHotspotState(false), {
+                    // A completed APK step has just replaced ASG. Let the new command path
+                    // settle before asking it to tear down the SystemUI-owned access point.
+                    initialDelayMs: this.serverStarted ? 750 : 0,
+                });
+                if (!hotspotStopped) {
+                    console.warn("[OTA_PROGRESS] glasses hotspot shutdown was not confirmed after bounded retries");
+                }
+            }
+            if (this.serverStarted)
+                await OtaServer.stopOtaServer().catch(() => { });
+            if (this.localNetworkConnected)
+                await localNetworkTransport.disconnect().catch(() => { });
+            await cleanupArtifacts().catch(() => { });
+            this.prepared = [];
+            this.active = false;
+            this.serverStarted = false;
+            this.localNetworkConnected = false;
+            this.hotspotRequested = false;
+        })();
+        try {
+            await this.teardownPromise;
+        }
+        finally {
+            this.teardownPromise = null;
+        }
+    }
+}
+export const hotspotOtaTransport = new HotspotOtaTransport();
+//# sourceMappingURL=HotspotOtaTransport.js.map

package/build/services/HotspotOtaTransport.js.map

@@ -0,0 +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"]}

package/build/services/HotspotShutdown.d.ts

@@ -0,0 +1,17 @@
+type HotspotState = {
+    state: "disabled" | "enabled";
+};
+type HotspotShutdownOptions = {
+    attempts?: number;
+    initialDelayMs?: number;
+    retryDelayMs?: number;
+    sleep?: (delayMs: number) => Promise<void>;
+};
+/**
+ * Disable a glasses hotspot with a bounded retry. ASG APK replacement keeps the
+ * BLE link alive through BES, but the first command after the new ASG process
+ * appears can still land while its command path is settling.
+ */
+export declare function disableHotspotWithRetry(requestDisabled: () => Promise<HotspotState>, options?: HotspotShutdownOptions): Promise<boolean>;
+export {};
+//# sourceMappingURL=HotspotShutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HotspotShutdown.d.ts","sourceRoot":"","sources":["../../src/services/HotspotShutdown.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;CAAC,CAAA;AAEnD,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C,CAAA;AAID;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAC5C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAqBlB"}

package/build/services/HotspotShutdown.js

@@ -0,0 +1,29 @@
+const sleep = (delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs));
+/**
+ * Disable a glasses hotspot with a bounded retry. ASG APK replacement keeps the
+ * BLE link alive through BES, but the first command after the new ASG process
+ * appears can still land while its command path is settling.
+ */
+export async function disableHotspotWithRetry(requestDisabled, options = {}) {
+    const attempts = Math.max(1, options.attempts ?? 2);
+    const initialDelayMs = Math.max(0, options.initialDelayMs ?? 0);
+    const retryDelayMs = Math.max(0, options.retryDelayMs ?? 500);
+    const wait = options.sleep ?? sleep;
+    if (initialDelayMs > 0)
+        await wait(initialDelayMs);
+    for (let attempt = 1; attempt <= attempts; attempt += 1) {
+        try {
+            const status = await requestDisabled();
+            if (status.state === "disabled")
+                return true;
+        }
+        catch {
+            // A lost command is indistinguishable from a response timeout here. Retry
+            // while the phone still owns the hotspot network and local server.
+        }
+        if (attempt < attempts && retryDelayMs > 0)
+            await wait(retryDelayMs);
+    }
+    return false;
+}
+//# sourceMappingURL=HotspotShutdown.js.map

package/build/services/HotspotShutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotspotShutdown.js","sourceRoot":"","sources":["../../src/services/HotspotShutdown.ts"],"names":[],"mappings":"AASA,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAE/F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,eAA4C,EAC5C,UAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;IACnD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,CAAA;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IAEnC,IAAI,cAAc,GAAG,CAAC;QAAE,MAAM,IAAI,CAAC,cAAc,CAAC,CAAA;IAElD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAA;YACtC,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU;gBAAE,OAAO,IAAI,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,mEAAmE;QACrE,CAAC;QAED,IAAI,OAAO,GAAG,QAAQ,IAAI,YAAY,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,YAAY,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["type HotspotState = {state: \"disabled\" | \"enabled\"}\n\ntype HotspotShutdownOptions = {\n  attempts?: number\n  initialDelayMs?: number\n  retryDelayMs?: number\n  sleep?: (delayMs: number) => Promise<void>\n}\n\nconst sleep = (delayMs: number) => new Promise<void>((resolve) => setTimeout(resolve, delayMs))\n\n/**\n * Disable a glasses hotspot with a bounded retry. ASG APK replacement keeps the\n * BLE link alive through BES, but the first command after the new ASG process\n * appears can still land while its command path is settling.\n */\nexport async function disableHotspotWithRetry(\n  requestDisabled: () => Promise<HotspotState>,\n  options: HotspotShutdownOptions = {},\n): Promise<boolean> {\n  const attempts = Math.max(1, options.attempts ?? 2)\n  const initialDelayMs = Math.max(0, options.initialDelayMs ?? 0)\n  const retryDelayMs = Math.max(0, options.retryDelayMs ?? 500)\n  const wait = options.sleep ?? sleep\n\n  if (initialDelayMs > 0) await wait(initialDelayMs)\n\n  for (let attempt = 1; attempt <= attempts; attempt += 1) {\n    try {\n      const status = await requestDisabled()\n      if (status.state === \"disabled\") return true\n    } catch {\n      // A lost command is indistinguishable from a response timeout here. Retry\n      // while the phone still owns the hotspot network and local server.\n    }\n\n    if (attempt < attempts && retryDelayMs > 0) await wait(retryDelayMs)\n  }\n\n  return false\n}\n"]}

package/build/services/JSCrashController.d.ts

@@ -0,0 +1,97 @@
+/**
+ * JSCrashController — crash recovery state machine for the
+ * per-miniapp JSContexts owned by JSRouter.
+ *
+ *   RUNNING
+ *     │  crash detected (uncaught exception, native bridge throw,
+ *     │   ping miss, soft-watchdog kill, etc.)
+ *     ▼
+ *   CRASHED ──── respawn allowed? ──── no ──► CRASHLOOP_DISABLED
+ *     │                                          (persistent banner)
+ *     ▼ yes
+ *   BACKOFF(2s → 8s → 30s)
+ *     │  timer fires
+ *     ▼
+ *   RUNNING (and stays here on a clean 60s window;
+ *            otherwise crash count increments)
+ *
+ * Retry policy: zero retries by default — the first crash escalates
+ * straight to CRASHLOOP_DISABLED, matching how Android / iOS treat crashed
+ * apps. Callers that prefer auto-respawn opt in by passing
+ * `{maxRetries: 3, backoffMs: [2_000, 8_000, 30_000]}`; the BACKOFF state
+ * machine and exponential delays are implemented and unit-tested for that
+ * case.
+ *
+ * The controller is purely a policy engine — it doesn't actually call
+ * jsSpawn / jsKill. Callers (JSRouter) read the
+ * Outcome returned from onCrash() and drive the host accordingly. This
+ * makes the controller unit-testable with synthetic timer.
+ */
+export type CrashState = {
+    kind: "RUNNING";
+    sinceMs: number;
+} | {
+    kind: "CRASHED";
+    reason: string;
+    crashedAtMs: number;
+} | {
+    kind: "BACKOFF";
+    until: number;
+    attempt: number;
+    reason: string;
+} | {
+    kind: "CRASHLOOP_DISABLED";
+    sinceMs: number;
+    reason: string;
+};
+export interface CrashOutcome {
+    /** Caller must call `respawn(packageName)` after this delay (ms from now). */
+    scheduleRespawnAfterMs?: number;
+    /** Caller should surface "X restarted" toast (2nd-within-5m crash). */
+    showRestartToast?: boolean;
+    /** Caller should surface persistent "crashloop disabled" banner. */
+    surfaceCrashloopBanner?: boolean;
+    /** Caller may push the crash event to dev portal / Sentry as warn-level. */
+    sentryLevel?: "info" | "warning" | "error";
+}
+export interface CrashControllerOptions {
+    /** Override the wall clock for tests. Defaults to Date.now. */
+    now?: () => number;
+    /** Backoff sequence in ms. Defaults to [2_000, 8_000, 30_000]. */
+    backoffMs?: number[];
+    /** Window in ms — N crashes inside this window escalates. Defaults to 5min. */
+    crashWindowMs?: number;
+    /** Max retries before CRASHLOOP_DISABLED. Defaults to 0 — first crash
+     *  escalates immediately, matching Android / iOS app conventions. */
+    maxRetries?: number;
+    /** Clean-uptime threshold that resets the retry counter. Defaults to 60s. */
+    cleanUptimeResetMs?: number;
+}
+export declare class JSCrashController {
+    private readonly now;
+    private readonly backoffMs;
+    private readonly crashWindowMs;
+    private readonly maxRetries;
+    private readonly cleanUptimeResetMs;
+    private readonly packages;
+    constructor(opts?: CrashControllerOptions);
+    /** Tracking starts when JSRouter spawns a fresh JSContext. */
+    onSpawn(packageName: string): void;
+    /** Called when JSRouter explicitly tears down (user-initiated). */
+    onKill(packageName: string): void;
+    /**
+     * Record a crash and return the policy outcome. Caller is responsible for
+     * scheduling the respawn (timer ownership belongs at the orchestration
+     * layer that holds the host context, not here).
+     */
+    onCrash(packageName: string, reason: string): CrashOutcome;
+    /** Inspect current state — useful for tests and diagnostics. */
+    stateFor(packageName: string): CrashState | null;
+    /** Total respawns since registration — surfaced to Sentry as a counter. */
+    respawnCount(packageName: string): number;
+    /** Currently-disabled packages. Host UI uses this to show banners. */
+    disabledPackages(): string[];
+    /** Manually re-enable a disabled package (user "Try again" tap). */
+    reset(packageName: string): void;
+}
+//# sourceMappingURL=JSCrashController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JSCrashController.d.ts","sourceRoot":"","sources":["../../src/services/JSCrashController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,UAAU,GAClB;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAClC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,GACtD;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GACjE;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAA;AAEjE,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,oEAAoE;IACpE,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;yEACqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAeD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEpD,IAAI,GAAE,sBAA2B;IAQ7C,8DAA8D;IAC9D,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAiBlC,mEAAmE;IACnE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;OAIG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IA4C1D,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIhD,2EAA2E;IAC3E,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIzC,sEAAsE;IACtE,gBAAgB,IAAI,MAAM,EAAE;IAQ5B,oEAAoE;IACpE,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAMjC"}

package/build/services/JSCrashController.js

@@ -0,0 +1,138 @@
+/**
+ * JSCrashController — crash recovery state machine for the
+ * per-miniapp JSContexts owned by JSRouter.
+ *
+ *   RUNNING
+ *     │  crash detected (uncaught exception, native bridge throw,
+ *     │   ping miss, soft-watchdog kill, etc.)
+ *     ▼
+ *   CRASHED ──── respawn allowed? ──── no ──► CRASHLOOP_DISABLED
+ *     │                                          (persistent banner)
+ *     ▼ yes
+ *   BACKOFF(2s → 8s → 30s)
+ *     │  timer fires
+ *     ▼
+ *   RUNNING (and stays here on a clean 60s window;
+ *            otherwise crash count increments)
+ *
+ * Retry policy: zero retries by default — the first crash escalates
+ * straight to CRASHLOOP_DISABLED, matching how Android / iOS treat crashed
+ * apps. Callers that prefer auto-respawn opt in by passing
+ * `{maxRetries: 3, backoffMs: [2_000, 8_000, 30_000]}`; the BACKOFF state
+ * machine and exponential delays are implemented and unit-tested for that
+ * case.
+ *
+ * The controller is purely a policy engine — it doesn't actually call
+ * jsSpawn / jsKill. Callers (JSRouter) read the
+ * Outcome returned from onCrash() and drive the host accordingly. This
+ * makes the controller unit-testable with synthetic timer.
+ */
+const DEFAULT_BACKOFFS = [2_000, 8_000, 30_000];
+const DEFAULT_WINDOW_MS = 5 * 60_000;
+const DEFAULT_MAX_RETRIES = 0;
+const DEFAULT_CLEAN_UPTIME_RESET_MS = 60_000;
+export class JSCrashController {
+    now;
+    backoffMs;
+    crashWindowMs;
+    maxRetries;
+    cleanUptimeResetMs;
+    packages = new Map();
+    constructor(opts = {}) {
+        this.now = opts.now ?? (() => Date.now());
+        this.backoffMs = opts.backoffMs ?? DEFAULT_BACKOFFS;
+        this.crashWindowMs = opts.crashWindowMs ?? DEFAULT_WINDOW_MS;
+        this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.cleanUptimeResetMs = opts.cleanUptimeResetMs ?? DEFAULT_CLEAN_UPTIME_RESET_MS;
+    }
+    /** Tracking starts when JSRouter spawns a fresh JSContext. */
+    onSpawn(packageName) {
+        const at = this.now();
+        const prev = this.packages.get(packageName);
+        if (prev) {
+            // Carry forward the crash history; a respawn doesn't reset retry
+            // budget unless the previous RUNNING state survived >= cleanUptimeResetMs.
+            prev.state = { kind: "RUNNING", sinceMs: at };
+            prev.totalRespawns += 1;
+        }
+        else {
+            this.packages.set(packageName, {
+                state: { kind: "RUNNING", sinceMs: at },
+                crashesInWindow: [],
+                totalRespawns: 0,
+            });
+        }
+    }
+    /** Called when JSRouter explicitly tears down (user-initiated). */
+    onKill(packageName) {
+        this.packages.delete(packageName);
+    }
+    /**
+     * Record a crash and return the policy outcome. Caller is responsible for
+     * scheduling the respawn (timer ownership belongs at the orchestration
+     * layer that holds the host context, not here).
+     */
+    onCrash(packageName, reason) {
+        const at = this.now();
+        const entry = this.packages.get(packageName) ?? {
+            state: { kind: "RUNNING", sinceMs: at },
+            crashesInWindow: [],
+            totalRespawns: 0,
+        };
+        // If the previous RUNNING window was long enough, reset the retry
+        // counter — a crash after a stable session shouldn't burn budget.
+        if (entry.state.kind === "RUNNING") {
+            const uptime = at - entry.state.sinceMs;
+            if (uptime >= this.cleanUptimeResetMs) {
+                entry.crashesInWindow = [];
+            }
+        }
+        // Drop crashes that fell out of the window before counting the new one.
+        const cutoff = at - this.crashWindowMs;
+        entry.crashesInWindow = entry.crashesInWindow.filter((t) => t >= cutoff);
+        entry.crashesInWindow.push(at);
+        this.packages.set(packageName, entry);
+        const crashCount = entry.crashesInWindow.length;
+        if (crashCount > this.maxRetries) {
+            entry.state = { kind: "CRASHLOOP_DISABLED", sinceMs: at, reason };
+            return {
+                surfaceCrashloopBanner: true,
+                sentryLevel: "error",
+            };
+        }
+        const attempt = crashCount - 1;
+        const delayMs = this.backoffMs[Math.min(attempt, this.backoffMs.length - 1)];
+        entry.state = { kind: "BACKOFF", until: at + delayMs, attempt: crashCount, reason };
+        return {
+            scheduleRespawnAfterMs: delayMs,
+            showRestartToast: crashCount >= 2,
+            sentryLevel: crashCount === 1 ? "info" : "warning",
+        };
+    }
+    /** Inspect current state — useful for tests and diagnostics. */
+    stateFor(packageName) {
+        return this.packages.get(packageName)?.state ?? null;
+    }
+    /** Total respawns since registration — surfaced to Sentry as a counter. */
+    respawnCount(packageName) {
+        return this.packages.get(packageName)?.totalRespawns ?? 0;
+    }
+    /** Currently-disabled packages. Host UI uses this to show banners. */
+    disabledPackages() {
+        const out = [];
+        for (const [name, entry] of this.packages) {
+            if (entry.state.kind === "CRASHLOOP_DISABLED")
+                out.push(name);
+        }
+        return out;
+    }
+    /** Manually re-enable a disabled package (user "Try again" tap). */
+    reset(packageName) {
+        const entry = this.packages.get(packageName);
+        if (!entry)
+            return;
+        entry.crashesInWindow = [];
+        entry.state = { kind: "RUNNING", sinceMs: this.now() };
+    }
+}
+//# sourceMappingURL=JSCrashController.js.map

package/build/services/JSCrashController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSCrashController.js","sourceRoot":"","sources":["../../src/services/JSCrashController.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * JSCrashController — crash recovery state machine for the\n * per-miniapp JSContexts owned by JSRouter.\n *\n *   RUNNING\n *     │  crash detected (uncaught exception, native bridge throw,\n *     │   ping miss, soft-watchdog kill, etc.)\n *     ▼\n *   CRASHED ──── respawn allowed? ──── no ──► CRASHLOOP_DISABLED\n *     │                                          (persistent banner)\n *     ▼ yes\n *   BACKOFF(2s → 8s → 30s)\n *     │  timer fires\n *     ▼\n *   RUNNING (and stays here on a clean 60s window;\n *            otherwise crash count increments)\n *\n * Retry policy: zero retries by default — the first crash escalates\n * straight to CRASHLOOP_DISABLED, matching how Android / iOS treat crashed\n * apps. Callers that prefer auto-respawn opt in by passing\n * `{maxRetries: 3, backoffMs: [2_000, 8_000, 30_000]}`; the BACKOFF state\n * machine and exponential delays are implemented and unit-tested for that\n * case.\n *\n * The controller is purely a policy engine — it doesn't actually call\n * jsSpawn / jsKill. Callers (JSRouter) read the\n * Outcome returned from onCrash() and drive the host accordingly. This\n * makes the controller unit-testable with synthetic timer.\n */\n\nexport type CrashState =\n  | {kind: \"RUNNING\"; sinceMs: number}\n  | {kind: \"CRASHED\"; reason: string; crashedAtMs: number}\n  | {kind: \"BACKOFF\"; until: number; attempt: number; reason: string}\n  | {kind: \"CRASHLOOP_DISABLED\"; sinceMs: number; reason: string}\n\nexport interface CrashOutcome {\n  /** Caller must call `respawn(packageName)` after this delay (ms from now). */\n  scheduleRespawnAfterMs?: number\n  /** Caller should surface \"X restarted\" toast (2nd-within-5m crash). */\n  showRestartToast?: boolean\n  /** Caller should surface persistent \"crashloop disabled\" banner. */\n  surfaceCrashloopBanner?: boolean\n  /** Caller may push the crash event to dev portal / Sentry as warn-level. */\n  sentryLevel?: \"info\" | \"warning\" | \"error\"\n}\n\nexport interface CrashControllerOptions {\n  /** Override the wall clock for tests. Defaults to Date.now. */\n  now?: () => number\n  /** Backoff sequence in ms. Defaults to [2_000, 8_000, 30_000]. */\n  backoffMs?: number[]\n  /** Window in ms — N crashes inside this window escalates. Defaults to 5min. */\n  crashWindowMs?: number\n  /** Max retries before CRASHLOOP_DISABLED. Defaults to 0 — first crash\n   *  escalates immediately, matching Android / iOS app conventions. */\n  maxRetries?: number\n  /** Clean-uptime threshold that resets the retry counter. Defaults to 60s. */\n  cleanUptimeResetMs?: number\n}\n\ninterface PackageState {\n  state: CrashState\n  /** Crash timestamps inside the current window (sorted ascending). */\n  crashesInWindow: number[]\n  /** Total respawns since the package was first registered (for telemetry). */\n  totalRespawns: number\n}\n\nconst DEFAULT_BACKOFFS = [2_000, 8_000, 30_000]\nconst DEFAULT_WINDOW_MS = 5 * 60_000\nconst DEFAULT_MAX_RETRIES = 0\nconst DEFAULT_CLEAN_UPTIME_RESET_MS = 60_000\n\nexport class JSCrashController {\n  private readonly now: () => number\n  private readonly backoffMs: number[]\n  private readonly crashWindowMs: number\n  private readonly maxRetries: number\n  private readonly cleanUptimeResetMs: number\n  private readonly packages: Map<string, PackageState> = new Map()\n\n  constructor(opts: CrashControllerOptions = {}) {\n    this.now = opts.now ?? (() => Date.now())\n    this.backoffMs = opts.backoffMs ?? DEFAULT_BACKOFFS\n    this.crashWindowMs = opts.crashWindowMs ?? DEFAULT_WINDOW_MS\n    this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES\n    this.cleanUptimeResetMs = opts.cleanUptimeResetMs ?? DEFAULT_CLEAN_UPTIME_RESET_MS\n  }\n\n  /** Tracking starts when JSRouter spawns a fresh JSContext. */\n  onSpawn(packageName: string): void {\n    const at = this.now()\n    const prev = this.packages.get(packageName)\n    if (prev) {\n      // Carry forward the crash history; a respawn doesn't reset retry\n      // budget unless the previous RUNNING state survived >= cleanUptimeResetMs.\n      prev.state = {kind: \"RUNNING\", sinceMs: at}\n      prev.totalRespawns += 1\n    } else {\n      this.packages.set(packageName, {\n        state: {kind: \"RUNNING\", sinceMs: at},\n        crashesInWindow: [],\n        totalRespawns: 0,\n      })\n    }\n  }\n\n  /** Called when JSRouter explicitly tears down (user-initiated). */\n  onKill(packageName: string): void {\n    this.packages.delete(packageName)\n  }\n\n  /**\n   * Record a crash and return the policy outcome. Caller is responsible for\n   * scheduling the respawn (timer ownership belongs at the orchestration\n   * layer that holds the host context, not here).\n   */\n  onCrash(packageName: string, reason: string): CrashOutcome {\n    const at = this.now()\n    const entry = this.packages.get(packageName) ?? {\n      state: {kind: \"RUNNING\", sinceMs: at},\n      crashesInWindow: [],\n      totalRespawns: 0,\n    }\n\n    // If the previous RUNNING window was long enough, reset the retry\n    // counter — a crash after a stable session shouldn't burn budget.\n    if (entry.state.kind === \"RUNNING\") {\n      const uptime = at - entry.state.sinceMs\n      if (uptime >= this.cleanUptimeResetMs) {\n        entry.crashesInWindow = []\n      }\n    }\n\n    // Drop crashes that fell out of the window before counting the new one.\n    const cutoff = at - this.crashWindowMs\n    entry.crashesInWindow = entry.crashesInWindow.filter((t) => t >= cutoff)\n    entry.crashesInWindow.push(at)\n    this.packages.set(packageName, entry)\n\n    const crashCount = entry.crashesInWindow.length\n\n    if (crashCount > this.maxRetries) {\n      entry.state = {kind: \"CRASHLOOP_DISABLED\", sinceMs: at, reason}\n      return {\n        surfaceCrashloopBanner: true,\n        sentryLevel: \"error\",\n      }\n    }\n\n    const attempt = crashCount - 1\n    const delayMs = this.backoffMs[Math.min(attempt, this.backoffMs.length - 1)]!\n    entry.state = {kind: \"BACKOFF\", until: at + delayMs, attempt: crashCount, reason}\n\n    return {\n      scheduleRespawnAfterMs: delayMs,\n      showRestartToast: crashCount >= 2,\n      sentryLevel: crashCount === 1 ? \"info\" : \"warning\",\n    }\n  }\n\n  /** Inspect current state — useful for tests and diagnostics. */\n  stateFor(packageName: string): CrashState | null {\n    return this.packages.get(packageName)?.state ?? null\n  }\n\n  /** Total respawns since registration — surfaced to Sentry as a counter. */\n  respawnCount(packageName: string): number {\n    return this.packages.get(packageName)?.totalRespawns ?? 0\n  }\n\n  /** Currently-disabled packages. Host UI uses this to show banners. */\n  disabledPackages(): string[] {\n    const out: string[] = []\n    for (const [name, entry] of this.packages) {\n      if (entry.state.kind === \"CRASHLOOP_DISABLED\") out.push(name)\n    }\n    return out\n  }\n\n  /** Manually re-enable a disabled package (user \"Try again\" tap). */\n  reset(packageName: string): void {\n    const entry = this.packages.get(packageName)\n    if (!entry) return\n    entry.crashesInWindow = []\n    entry.state = {kind: \"RUNNING\", sinceMs: this.now()}\n  }\n}\n"]}

package/build/services/JSCrashloopReportService.d.ts

@@ -0,0 +1,9 @@
+import { type AutomaticReportSubmissionStatus } from "./AutomaticReportResult";
+export declare function submitJSCrashloopReport(params: {
+    packageName: string;
+    reason: string;
+    lastLogLines?: string[];
+}): Promise<AutomaticReportSubmissionStatus>;
+export declare function startJSCrashloopReportService(): void;
+export declare function stopJSCrashloopReportService(): void;
+//# sourceMappingURL=JSCrashloopReportService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JSCrashloopReportService.d.ts","sourceRoot":"","sources":["../../src/services/JSCrashloopReportService.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,yBAAyB,CAAA;AAQhC,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAwB3C;AAeD,wBAAgB,6BAA6B,IAAI,IAAI,CAGpD;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/build/services/JSCrashloopReportService.js

@@ -0,0 +1,54 @@
+import { submitAutomaticReport } from "../facades/reports";
+import { useAppStatusStore } from "../stores/apps";
+import { logAutomaticReportSubmissionStatus, toAutomaticReportSubmissionStatus, } from "./AutomaticReportResult";
+import { getMiniappEngine } from "./MiniappEngine";
+import { islandNotifications } from "./NotificationsEmitter";
+const LOG_TAG = "JSCrashloopReport";
+let unsubscribe = null;
+export async function submitJSCrashloopReport(params) {
+    const { packageName, reason, lastLogLines = [] } = params;
+    const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName);
+    const appName = app?.name ?? packageName;
+    const result = await submitAutomaticReport({
+        kind: "automatic",
+        trigger: {
+            type: "automatic",
+            source: "miniapp_crashloop",
+            reason: "glasslyjs_crashloop_disabled",
+            sourceAppletPackageName: packageName,
+            sourceAppletName: appName,
+        },
+        report: {
+            expectedBehavior: `${appName} should run without crashing.`,
+            actualBehavior: JSON.stringify({ reason, lastLogLines }, null, 2),
+            systemPriority: "critical",
+        },
+        throttleKey: `glasslyjs_crashloop:${packageName}`,
+    });
+    const status = toAutomaticReportSubmissionStatus(result);
+    logAutomaticReportSubmissionStatus(LOG_TAG, status, packageName);
+    return status;
+}
+function handleNotification(notification) {
+    if (notification.kind !== "miniapp_crashloop" || !notification.packageName)
+        return;
+    const packageName = notification.packageName;
+    const lastLogLines = getMiniappEngine()?.router.logRing.snapshot(packageName) ?? [];
+    void submitJSCrashloopReport({
+        packageName,
+        reason: notification.reason,
+        lastLogLines,
+    }).catch((error) => {
+        console.error(`[${LOG_TAG}] Unexpected error:`, error);
+    });
+}
+export function startJSCrashloopReportService() {
+    if (unsubscribe)
+        return;
+    unsubscribe = islandNotifications.subscribe(handleNotification);
+}
+export function stopJSCrashloopReportService() {
+    unsubscribe?.();
+    unsubscribe = null;
+}
+//# sourceMappingURL=JSCrashloopReportService.js.map

package/build/services/JSCrashloopReportService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSCrashloopReportService.js","sourceRoot":"","sources":["../../src/services/JSCrashloopReportService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAA;AAChD,OAAO,EACL,kCAAkC,EAClC,iCAAiC,GAElC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAC,mBAAmB,EAA0B,MAAM,wBAAwB,CAAA;AAEnF,MAAM,OAAO,GAAG,mBAAmB,CAAA;AAEnC,IAAI,WAAW,GAAwB,IAAI,CAAA;AAE3C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAI7C;IACC,MAAM,EAAC,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,EAAE,EAAC,GAAG,MAAM,CAAA;IACvD,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAA;IACxF,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,IAAI,WAAW,CAAA;IACxC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;QACzC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,mBAAmB;YAC3B,MAAM,EAAE,8BAA8B;YACtC,uBAAuB,EAAE,WAAW;YACpC,gBAAgB,EAAE,OAAO;SAC1B;QACD,MAAM,EAAE;YACN,gBAAgB,EAAE,GAAG,OAAO,+BAA+B;YAC3D,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,EAAC,MAAM,EAAE,YAAY,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,cAAc,EAAE,UAAU;SAC3B;QACD,WAAW,EAAE,uBAAuB,WAAW,EAAE;KAClD,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAA;IACxD,kCAAkC,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;IAChE,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,YAAgC;IAC1D,IAAI,YAAY,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,YAAY,CAAC,WAAW;QAAE,OAAM;IAClF,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAA;IAC5C,MAAM,YAAY,GAAG,gBAAgB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;IACnF,KAAK,uBAAuB,CAAC;QAC3B,WAAW;QACX,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,YAAY;KACb,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,qBAAqB,EAAE,KAAK,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,IAAI,WAAW;QAAE,OAAM;IACvB,WAAW,GAAG,mBAAmB,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,WAAW,EAAE,EAAE,CAAA;IACf,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC","sourcesContent":["import {submitAutomaticReport} from \"../facades/reports\"\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {\n  logAutomaticReportSubmissionStatus,\n  toAutomaticReportSubmissionStatus,\n  type AutomaticReportSubmissionStatus,\n} from \"./AutomaticReportResult\"\nimport {getMiniappEngine} from \"./MiniappEngine\"\nimport {islandNotifications, type IslandNotification} from \"./NotificationsEmitter\"\n\nconst LOG_TAG = \"JSCrashloopReport\"\n\nlet unsubscribe: (() => void) | null = null\n\nexport async function submitJSCrashloopReport(params: {\n  packageName: string\n  reason: string\n  lastLogLines?: string[]\n}): Promise<AutomaticReportSubmissionStatus> {\n  const {packageName, reason, lastLogLines = []} = params\n  const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName)\n  const appName = app?.name ?? packageName\n  const result = await submitAutomaticReport({\n    kind: \"automatic\",\n    trigger: {\n      type: \"automatic\",\n      source: \"miniapp_crashloop\",\n      reason: \"glasslyjs_crashloop_disabled\",\n      sourceAppletPackageName: packageName,\n      sourceAppletName: appName,\n    },\n    report: {\n      expectedBehavior: `${appName} should run without crashing.`,\n      actualBehavior: JSON.stringify({reason, lastLogLines}, null, 2),\n      systemPriority: \"critical\",\n    },\n    throttleKey: `glasslyjs_crashloop:${packageName}`,\n  })\n\n  const status = toAutomaticReportSubmissionStatus(result)\n  logAutomaticReportSubmissionStatus(LOG_TAG, status, packageName)\n  return status\n}\n\nfunction handleNotification(notification: IslandNotification): void {\n  if (notification.kind !== \"miniapp_crashloop\" || !notification.packageName) return\n  const packageName = notification.packageName\n  const lastLogLines = getMiniappEngine()?.router.logRing.snapshot(packageName) ?? []\n  void submitJSCrashloopReport({\n    packageName,\n    reason: notification.reason,\n    lastLogLines,\n  }).catch((error) => {\n    console.error(`[${LOG_TAG}] Unexpected error:`, error)\n  })\n}\n\nexport function startJSCrashloopReportService(): void {\n  if (unsubscribe) return\n  unsubscribe = islandNotifications.subscribe(handleNotification)\n}\n\nexport function stopJSCrashloopReportService(): void {\n  unsubscribe?.()\n  unsubscribe = null\n}\n"]}