@mentra/crust 3.2.1-beta.622 → 3.2.1-beta.628

package/android/src/main/cpp/quickjs/jni/quickjs_jni.h

@@ -0,0 +1,40 @@
+#ifndef QJS_KT_JNI_H
+#define QJS_KT_JNI_H
+
+#include <pthread.h>
+#include "cvector.h"
+#include "quickjs.h"
+#include "jni.h"
+
+/**
+ * Global objects for the wrapped runtime.
+ */
+typedef struct {
+    /**
+     * Some JS values, used by C functions.
+     */
+    cvector_vector_type(JSValue)managed_js_values;
+    /**
+     * Defined JS objects, keep them to support nested define.
+     */
+    cvector_vector_type(JSValue)defined_js_objects;
+    /**
+     * Promise resolve/reject functions.
+     */
+    cvector_vector_type(JSValue)created_js_functions;
+    /**
+     * Global JNI refs.
+     */
+    cvector_vector_type(jobject)global_object_refs;
+    /**
+     * Result promises of eval calls.
+     */
+    JSValue *evaluate_result_promise;
+    /**
+     * The mutex which is used to protect the JS stack in a multi-threaded environment.
+     * Scopes with a JS_UpdateStackTop() call are required to be locked.
+     */
+    pthread_mutex_t js_mutex;
+} Globals;
+
+#endif //QJS_KT_JNI_H

package/android/src/main/java/com/mentra/crust/CrustModule.kt

@@ -7,6 +7,7 @@ import com.mentra.crust.services.NotificationProcessBridge
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 import expo.modules.kotlin.functions.Queues
+import expo.modules.kotlin.functions.Coroutine
 import java.net.URL
 import java.util.concurrent.Executors
 import kotlinx.coroutines.CoroutineName
@@ -17,6 +18,7 @@ import kotlinx.coroutines.cancel
 
 import com.mentra.crust.navigation.NavigationManager
 import com.mentra.crust.heading.HeadingManager
+import com.mentra.crust.preview.PixelCopyPreview
 import com.mentra.crust.jsc.JSCRuntime
 import com.mentra.crust.jsc.InstalledMiniappManifest
 import com.mentra.crust.jsc.JSCPolyfillBridge
@@ -184,6 +186,11 @@ class CrustModule : Module() {
       sendEvent("onChange", mapOf("value" to value))
     }
 
+    AsyncFunction("captureMiniappPreview") Coroutine { viewTag: Int ->
+      val activity = appContext.currentActivity ?: error("No activity available for screenshot")
+      PixelCopyPreview.capture(activity, viewTag)
+    }
+
     AsyncFunction("nativeHttpRequest") {
       method: String, url: String, headers: Map<String, String>, body: String? ->
       val result = JSCPolyfillBridge.executeHttp(method, url, headers, body)

package/android/src/main/java/com/mentra/crust/preview/PixelCopyPreview.kt

@@ -0,0 +1,76 @@
+package com.mentra.crust.preview
+
+import android.app.Activity
+import android.graphics.Bitmap
+import android.graphics.Rect
+import android.net.Uri
+import android.os.Handler
+import android.os.Looper
+import android.view.PixelCopy
+import android.view.View
+import java.io.File
+import kotlin.coroutines.resumeWithException
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.ExperimentalCoroutinesApi
+import kotlinx.coroutines.suspendCancellableCoroutine
+import kotlinx.coroutines.withContext
+
+/** Copies the displayed miniapp pixels without invoking WebView's software renderer. */
+object PixelCopyPreview {
+  @OptIn(ExperimentalCoroutinesApi::class)
+  suspend fun capture(activity: Activity, viewTag: Int): String =
+    withContext(Dispatchers.Main.immediate) {
+      check(!activity.isFinishing && !activity.isDestroyed) { "Screenshot activity is unavailable" }
+      val window = activity.window
+      val decor = window.decorView
+      val view = decor.findViewById<View>(viewTag)
+        ?: error("Screenshot view $viewTag is unavailable")
+      check(view.isAttachedToWindow && view.isLaidOut && view.width > 0 && view.height > 0) {
+        "Screenshot view is not ready"
+      }
+
+      val location = IntArray(2)
+      view.getLocationInWindow(location)
+      val bounds = Rect(location[0], location[1], location[0] + view.width, location[1] + view.height)
+      check(Rect(0, 0, decor.width, decor.height).contains(bounds)) {
+        "Screenshot view must be fully inside the window"
+      }
+
+      val bitmap = Bitmap.createBitmap(bounds.width(), bounds.height(), Bitmap.Config.ARGB_8888)
+      val captured = suspendCancellableCoroutine<Bitmap> { continuation ->
+        try {
+          PixelCopy.request(window, bounds, bitmap, { result ->
+            if (result == PixelCopy.SUCCESS) {
+              // A cancelled request still owns its bitmap until PixelCopy finishes.
+              continuation.resume(bitmap) { bitmap.recycle() }
+            } else {
+              bitmap.recycle()
+              continuation.resumeWithException(IllegalStateException("PixelCopy failed: $result"))
+            }
+          }, Handler(Looper.getMainLooper()))
+        } catch (error: Exception) {
+          bitmap.recycle()
+          continuation.resumeWithException(error)
+        }
+      }
+
+      try {
+        withContext(Dispatchers.IO) {
+          val file = File.createTempFile("miniapp-preview-", ".jpg", activity.cacheDir)
+          try {
+            file.outputStream().use { output ->
+              check(captured.compress(Bitmap.CompressFormat.JPEG, 50, output)) {
+                "Unable to encode miniapp screenshot"
+              }
+            }
+            Uri.fromFile(file).toString()
+          } catch (error: Exception) {
+            file.delete()
+            throw error
+          }
+        }
+      } finally {
+        captured.recycle()
+      }
+    }
+}

package/android/src/testNative/QuickJsLifecycleTest.kt

@@ -0,0 +1,56 @@
+package com.mentra.crust.jsc
+
+import com.dokar.quickjs.QuickJs
+import com.dokar.quickjs.binding.function
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.withTimeout
+import java.util.concurrent.Executors
+
+/** Exercise actual JNI/Kotlin callbacks across independent runtime lifetimes. */
+fun main() = runBlocking {
+    var calls = 0
+    val survivor = QuickJs.create(Dispatchers.Unconfined)
+    survivor.function("hostCallback") { calls++; 42 }
+    val other = QuickJs.create(Dispatchers.Unconfined)
+    check(survivor.evaluate<Int>("hostCallback()") == 42)
+    other.close()
+    var failure: Throwable? = null
+    try {
+        withTimeout(1000) { check(survivor.evaluate<Int>("hostCallback()") == 42) }
+    } catch (error: Throwable) {
+        failure = error
+    }
+    check(failure == null) { "Closing another instance broke the survivor: $failure" }
+    check(calls == 2)
+    repeat(20) {
+        val temporary = QuickJs.create(Dispatchers.Unconfined)
+        temporary.close()
+        check(survivor.evaluate<Int>("hostCallback()") == 42)
+    }
+    val workers = Executors.newFixedThreadPool(4)
+    try {
+        val jobs = (1..40).map {
+            workers.submit {
+                val temporary = QuickJs.create(Dispatchers.Unconfined)
+                temporary.close()
+            }
+        }
+        jobs.forEach { it.get() }
+        check(survivor.evaluate<Int>("hostCallback()") == 42)
+    } finally {
+        workers.shutdownNow()
+    }
+    survivor.close()
+    val fresh = QuickJs.create(Dispatchers.Unconfined)
+    fresh.function("hostCallback") { 7 }
+    check(fresh.evaluate<Int>("hostCallback()") == 7)
+    fresh.close()
+    val older = QuickJs.create(Dispatchers.Unconfined)
+    val newer = QuickJs.create(Dispatchers.Unconfined)
+    newer.function("hostCallback") { 9 }
+    older.close()
+    check(newer.evaluate<Int>("hostCallback()") == 9)
+    newer.close()
+    println("PASS: callbacks survive across both close orders, churn, and clean restart")
+}

package/build/CrustModule.d.ts

@@ -6,6 +6,8 @@ declare class CrustModule extends NativeModule<CrustModuleEvents> {
     PI: number;
     hello(): string;
     setValueAsync(value: string): Promise<void>;
+    /** Android: copy the displayed view's window pixels to a temporary JPEG URI. */
+    captureMiniappPreview(viewTag: number): Promise<string>;
     nativeHttpRequest(method: string, url: string, headers: Record<string, string>, body?: string | null): Promise<{
         status: number;
         statusText: string;

package/build/CrustModule.d.ts.map

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

package/build/CrustModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"CrustModule.js","sourceRoot":"","sources":["../src/CrustModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAgMtD,yDAAyD;AACzD,eAAe,mBAAmB,CAAc,OAAO,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport {CrustModuleEvents, InstalledApp} from \"./Crust.types\"\n\ndeclare class CrustModule extends NativeModule<CrustModuleEvents> {\n  /** True for the native iOS app running on an Apple Silicon Mac. */\n  readonly isIOSAppOnMac?: boolean\n  PI: number\n  hello(): string\n  setValueAsync(value: string): Promise<void>\n  nativeHttpRequest(\n    method: string,\n    url: string,\n    headers: Record<string, string>,\n    body?: string | null,\n  ): Promise<{status: number; statusText: string; headers: Record<string, string>; body: string}>\n  showAVRoutePicker(tintColor?: string | null): void\n\n  /**\n   * iOS: configure `preferredScreenEdgesDeferringSystemGestures`. When an\n   * edge is deferred, the first swipe across that edge is consumed by the\n   * app and the system gesture (Control Center, Notification Center, Home\n   * indicator) only fires on a second swipe — i.e. a two-swipe-to-exit UX.\n   *\n   * Pass `[]` to restore default behavior. Android: no-op (Android has no\n   * per-app equivalent; system gestures are configured at the OS level).\n   */\n  setDeferredSystemGestures(edges: Array<\"top\" | \"bottom\" | \"left\" | \"right\" | \"all\">): Promise<void>\n\n  // MentraOS Notification Commands\n  setNotificationConfig(listenerEnabled: boolean, blocklist: string[]): Promise<void>\n  getInstalledApps(): Promise<InstalledApp[]>\n  getInstalledAppsForNotifications(): Promise<InstalledApp[]>\n  hasNotificationListenerPermission(): Promise<boolean>\n  refreshNotificationListener(): Promise<boolean>\n  openNotificationListenerSettings(): Promise<boolean>\n  isBetaBuild(): Promise<boolean>\n  // location services commands\n  showLocationServicesDialog(): Promise<boolean>\n  isLocationServicesEnabled(): Promise<boolean>\n  openLocationSettings(): Promise<boolean>\n  openAppSettings(): Promise<boolean>\n  openBluetoothSettings(): Promise<boolean>\n\n  // Image Processing Commands\n  processGalleryImage(\n    inputPath: string,\n    outputPath: string,\n    options: {\n      lensCorrection?: boolean\n      colorCorrection?: boolean\n    },\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  mergeHdrBrackets(\n    underPath: string,\n    normalPath: string,\n    overPath: string,\n    outputPath: string,\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  stabilizeVideo(\n    inputPath: string,\n    imuPath: string,\n    outputPath: string,\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  // Media Library Commands\n  saveToGalleryWithDate(\n    filePath: string,\n    captureTimeMillis?: number,\n    displayName?: string,\n  ): Promise<{\n    success: boolean\n    uri?: string\n    identifier?: string\n    existing?: boolean\n    error?: string\n  }>\n\n  // Navigation (Android only — iOS stubs return error)\n  startNavigation(\n    lat: number,\n    lng: number,\n    options?: {\n      simulate?: boolean\n      speedMultiplier?: number\n      /** Optional multi-stop list. When present takes precedence over lat/lng. Last entry is the final destination. */\n      stops?: Array<{lat: number; lng: number}>\n      /** \"walking\" | \"driving\" | \"cycling\" | \"two_wheeler\". Defaults driving. */\n      mode?: string\n      avoid?: {highways?: boolean; tolls?: boolean; ferries?: boolean}\n      /** Force a reroute when the user is more than N meters past a pivot they didn't take. */\n      missedTurnRerouteMeters?: number\n    },\n  ): Promise<{ok: boolean; error?: string}>\n  stopNavigation(): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Show the Google Nav SDK Terms & Conditions dialog if not already\n   * accepted. Idempotent — resolves immediately with `{accepted: true}`\n   * when the user has already accepted (cached in-process / on-disk /\n   * inside the SDK).\n   */\n  requestNavigationPermission(): Promise<{ok: boolean; accepted: boolean; error?: string}>\n\n  /**\n   * Dev-only: clear cached T&C acceptance (SDK flag + on-disk pref +\n   * in-process flag) so the next requestNavigationPermission() re-shows\n   * the dialog. Android only; iOS returns {ok: false, error: \"not\n   * supported on iOS\"}.\n   */\n  resetNavigationPermission(): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev-only: nudge the simulated user position ~offsetMeters perpendicular\n   * to the route so the Nav SDK reroutes. Default 20m. Android only.\n   */\n  simulateDeviation(offsetMeters?: number): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev toggle. When enabled, the native NavigationManager shifts every\n   * reported location ~8m perpendicular to the route bearing, simulating\n   * a pedestrian walking on the wrong sidewalk. Only meaningful in\n   * simulate mode; lets us verify the SDK's along-path pivot trigger\n   * fires even when the user never crosses the 7m pivot point radius.\n   * Android-only today; iOS is a no-op stub.\n   */\n  setWrongSidewalkOffset(enabled: boolean): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev toggle. When enabled, the native NavigationManager takes over\n   * from the Google simulator and walks the user along a modified\n   * polyline that omits crossing micro-steps — reproducing the\n   * wrong-sidewalk-then-missed-the-turn scenario. Android-only today;\n   * iOS is a no-op stub.\n   */\n  setSkipCrossings(enabled: boolean): Promise<{ok: boolean; error?: string}>\n\n  // Heading / compass (Android only)\n  startHeading(): Promise<{ok: boolean; error?: string}>\n  stopHeading(): Promise<{ok: boolean; error?: string}>\n\n  // MentraJS Runtime — per-miniapp JSContext lifecycle.\n  /**\n   * Spawn a per-miniapp JS context. Re-spawn is allowed: a live context\n   * with the same packageName is killed first. Returns true if the\n   * polyfill bundle + miniapp source evaluated without throwing.\n   *\n   * The polyfill bundle is `mobile/modules/mentrajs-runtime/dist/startup.js`\n   * (shipped inside the host binary). It installs window-style globals\n   * (console, timers, fetch, localStorage, crypto) atop the JSC runtime.\n   */\n  mentraJsSpawn(packageName: string, polyfillBundle: string, miniappJs: string): Promise<boolean>\n  mentraJsEvaluate(packageName: string, source: string): Promise<unknown>\n  mentraJsKill(packageName: string): Promise<void>\n  /**\n   * Push a `{kind: \"event\"|\"response\", …}` envelope into the named\n   * context's globalThis.__deliver. Returns when the underlying\n   * evaluateScript completes (the JS handler runs synchronously on the\n   * context's queue).\n   */\n  mentraJsDispatchToJs(packageName: string, envelope: Record<string, unknown>): Promise<void>\n  mentraJsSetManifest(packageName: string, permissions: string[]): Promise<void>\n  /** Diagnostic — returns the packageNames of every live JSContext. */\n  mentraJsAlivePackages(): string[]\n  /** Diagnostic — force a GC cycle on the named context. */\n  mentraJsDebugForceGC(packageName: string): Promise<boolean>\n  /**\n   * Read the bundled MentraJS polyfill (startup.js) shipped inside the\n   * host binary. Synchronous — host RN code calls this once on app boot\n   * and caches the string, then passes it to every mentraJsSpawn so\n   * every JSContext starts with the same polyfill ABI.\n   */\n  mentraJsLoadPolyfillBundle(): string\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<CrustModule>(\"Crust\")\n"]}
+{"version":3,"file":"CrustModule.js","sourceRoot":"","sources":["../src/CrustModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAkMtD,yDAAyD;AACzD,eAAe,mBAAmB,CAAc,OAAO,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport {CrustModuleEvents, InstalledApp} from \"./Crust.types\"\n\ndeclare class CrustModule extends NativeModule<CrustModuleEvents> {\n  /** True for the native iOS app running on an Apple Silicon Mac. */\n  readonly isIOSAppOnMac?: boolean\n  PI: number\n  hello(): string\n  setValueAsync(value: string): Promise<void>\n  /** Android: copy the displayed view's window pixels to a temporary JPEG URI. */\n  captureMiniappPreview(viewTag: number): Promise<string>\n  nativeHttpRequest(\n    method: string,\n    url: string,\n    headers: Record<string, string>,\n    body?: string | null,\n  ): Promise<{status: number; statusText: string; headers: Record<string, string>; body: string}>\n  showAVRoutePicker(tintColor?: string | null): void\n\n  /**\n   * iOS: configure `preferredScreenEdgesDeferringSystemGestures`. When an\n   * edge is deferred, the first swipe across that edge is consumed by the\n   * app and the system gesture (Control Center, Notification Center, Home\n   * indicator) only fires on a second swipe — i.e. a two-swipe-to-exit UX.\n   *\n   * Pass `[]` to restore default behavior. Android: no-op (Android has no\n   * per-app equivalent; system gestures are configured at the OS level).\n   */\n  setDeferredSystemGestures(edges: Array<\"top\" | \"bottom\" | \"left\" | \"right\" | \"all\">): Promise<void>\n\n  // MentraOS Notification Commands\n  setNotificationConfig(listenerEnabled: boolean, blocklist: string[]): Promise<void>\n  getInstalledApps(): Promise<InstalledApp[]>\n  getInstalledAppsForNotifications(): Promise<InstalledApp[]>\n  hasNotificationListenerPermission(): Promise<boolean>\n  refreshNotificationListener(): Promise<boolean>\n  openNotificationListenerSettings(): Promise<boolean>\n  isBetaBuild(): Promise<boolean>\n  // location services commands\n  showLocationServicesDialog(): Promise<boolean>\n  isLocationServicesEnabled(): Promise<boolean>\n  openLocationSettings(): Promise<boolean>\n  openAppSettings(): Promise<boolean>\n  openBluetoothSettings(): Promise<boolean>\n\n  // Image Processing Commands\n  processGalleryImage(\n    inputPath: string,\n    outputPath: string,\n    options: {\n      lensCorrection?: boolean\n      colorCorrection?: boolean\n    },\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  mergeHdrBrackets(\n    underPath: string,\n    normalPath: string,\n    overPath: string,\n    outputPath: string,\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  stabilizeVideo(\n    inputPath: string,\n    imuPath: string,\n    outputPath: string,\n  ): Promise<{\n    success: boolean\n    outputPath?: string\n    processingTimeMs?: number\n    error?: string\n  }>\n\n  // Media Library Commands\n  saveToGalleryWithDate(\n    filePath: string,\n    captureTimeMillis?: number,\n    displayName?: string,\n  ): Promise<{\n    success: boolean\n    uri?: string\n    identifier?: string\n    existing?: boolean\n    error?: string\n  }>\n\n  // Navigation (Android only — iOS stubs return error)\n  startNavigation(\n    lat: number,\n    lng: number,\n    options?: {\n      simulate?: boolean\n      speedMultiplier?: number\n      /** Optional multi-stop list. When present takes precedence over lat/lng. Last entry is the final destination. */\n      stops?: Array<{lat: number; lng: number}>\n      /** \"walking\" | \"driving\" | \"cycling\" | \"two_wheeler\". Defaults driving. */\n      mode?: string\n      avoid?: {highways?: boolean; tolls?: boolean; ferries?: boolean}\n      /** Force a reroute when the user is more than N meters past a pivot they didn't take. */\n      missedTurnRerouteMeters?: number\n    },\n  ): Promise<{ok: boolean; error?: string}>\n  stopNavigation(): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Show the Google Nav SDK Terms & Conditions dialog if not already\n   * accepted. Idempotent — resolves immediately with `{accepted: true}`\n   * when the user has already accepted (cached in-process / on-disk /\n   * inside the SDK).\n   */\n  requestNavigationPermission(): Promise<{ok: boolean; accepted: boolean; error?: string}>\n\n  /**\n   * Dev-only: clear cached T&C acceptance (SDK flag + on-disk pref +\n   * in-process flag) so the next requestNavigationPermission() re-shows\n   * the dialog. Android only; iOS returns {ok: false, error: \"not\n   * supported on iOS\"}.\n   */\n  resetNavigationPermission(): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev-only: nudge the simulated user position ~offsetMeters perpendicular\n   * to the route so the Nav SDK reroutes. Default 20m. Android only.\n   */\n  simulateDeviation(offsetMeters?: number): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev toggle. When enabled, the native NavigationManager shifts every\n   * reported location ~8m perpendicular to the route bearing, simulating\n   * a pedestrian walking on the wrong sidewalk. Only meaningful in\n   * simulate mode; lets us verify the SDK's along-path pivot trigger\n   * fires even when the user never crosses the 7m pivot point radius.\n   * Android-only today; iOS is a no-op stub.\n   */\n  setWrongSidewalkOffset(enabled: boolean): Promise<{ok: boolean; error?: string}>\n\n  /**\n   * Dev toggle. When enabled, the native NavigationManager takes over\n   * from the Google simulator and walks the user along a modified\n   * polyline that omits crossing micro-steps — reproducing the\n   * wrong-sidewalk-then-missed-the-turn scenario. Android-only today;\n   * iOS is a no-op stub.\n   */\n  setSkipCrossings(enabled: boolean): Promise<{ok: boolean; error?: string}>\n\n  // Heading / compass (Android only)\n  startHeading(): Promise<{ok: boolean; error?: string}>\n  stopHeading(): Promise<{ok: boolean; error?: string}>\n\n  // MentraJS Runtime — per-miniapp JSContext lifecycle.\n  /**\n   * Spawn a per-miniapp JS context. Re-spawn is allowed: a live context\n   * with the same packageName is killed first. Returns true if the\n   * polyfill bundle + miniapp source evaluated without throwing.\n   *\n   * The polyfill bundle is `mobile/modules/mentrajs-runtime/dist/startup.js`\n   * (shipped inside the host binary). It installs window-style globals\n   * (console, timers, fetch, localStorage, crypto) atop the JSC runtime.\n   */\n  mentraJsSpawn(packageName: string, polyfillBundle: string, miniappJs: string): Promise<boolean>\n  mentraJsEvaluate(packageName: string, source: string): Promise<unknown>\n  mentraJsKill(packageName: string): Promise<void>\n  /**\n   * Push a `{kind: \"event\"|\"response\", …}` envelope into the named\n   * context's globalThis.__deliver. Returns when the underlying\n   * evaluateScript completes (the JS handler runs synchronously on the\n   * context's queue).\n   */\n  mentraJsDispatchToJs(packageName: string, envelope: Record<string, unknown>): Promise<void>\n  mentraJsSetManifest(packageName: string, permissions: string[]): Promise<void>\n  /** Diagnostic — returns the packageNames of every live JSContext. */\n  mentraJsAlivePackages(): string[]\n  /** Diagnostic — force a GC cycle on the named context. */\n  mentraJsDebugForceGC(packageName: string): Promise<boolean>\n  /**\n   * Read the bundled MentraJS polyfill (startup.js) shipped inside the\n   * host binary. Synchronous — host RN code calls this once on app boot\n   * and caches the string, then passes it to every mentraJsSpawn so\n   * every JSContext starts with the same polyfill ABI.\n   */\n  mentraJsLoadPolyfillBundle(): string\n}\n\n// This call loads the native module object from the JSI.\nexport default requireNativeModule<CrustModule>(\"Crust\")\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/crust",
-  "version": "3.2.1-beta.622",
+  "version": "3.2.1-beta.628",
   "description": "Mentra Native Module",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -35,7 +35,7 @@
   "license": "Apache-2.0",
   "homepage": "https://github.com/Mentra-Community/MentraOS/tree/dev/mobile/modules/crust#readme",
   "dependencies": {
-    "@mentra/jspolyfill": "3.2.1-beta.622"
+    "@mentra/jspolyfill": "3.2.1-beta.628"
   },
   "devDependencies": {
     "@expo/config-plugins": ">=8.0.0",

package/src/CrustModule.ts

@@ -8,6 +8,8 @@ declare class CrustModule extends NativeModule<CrustModuleEvents> {
   PI: number
   hello(): string
   setValueAsync(value: string): Promise<void>
+  /** Android: copy the displayed view's window pixels to a temporary JPEG URI. */
+  captureMiniappPreview(viewTag: number): Promise<string>
   nativeHttpRequest(
     method: string,
     url: string,