@mentra/crust 3.2.1-dev.314 → 3.3.0-beta.942

package/build/nativeHttpRequest.test.js

@@ -0,0 +1,88 @@
+import { nativeHttpRequest } from "./nativeHttpRequest";
+const response = { status: 200, statusText: "OK", headers: {}, body: "{}" };
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((yes, no) => {
+        resolve = yes;
+        reject = no;
+    });
+    return { promise, resolve, reject };
+}
+function transport(request = deferred()) {
+    const native = {
+        nativeHttpRequest: jest.fn(() => request.promise),
+        cancelNativeHttpRequest: jest.fn(async () => { }),
+    };
+    return { native, request };
+}
+describe("nativeHttpRequest", () => {
+    test("pre-aborted requests do not start or cancel native work", async () => {
+        const { native } = transport();
+        const controller = new AbortController();
+        const reason = new Error("deadline");
+        controller.abort(reason);
+        await expect(nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal)).rejects.toBe(reason);
+        expect(native.nativeHttpRequest).not.toHaveBeenCalled();
+        expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled();
+    });
+    test("abort cancels only this request and waits for native cancellation acceptance", async () => {
+        const { native, request } = transport();
+        const cancellation = deferred();
+        native.cancelNativeHttpRequest = jest.fn(() => cancellation.promise);
+        const controller = new AbortController();
+        const remove = jest.spyOn(controller.signal, "removeEventListener");
+        const promise = nativeHttpRequest(native, "POST", "https://example.com", { test: "header" }, "body", controller.signal);
+        const rejected = expect(promise).rejects.toMatchObject({ name: "AbortError" });
+        controller.abort();
+        const id = native.nativeHttpRequest.mock.calls[0][0];
+        expect(native.cancelNativeHttpRequest).toHaveBeenCalledWith(id);
+        expect(remove).not.toHaveBeenCalled();
+        request.reject(new Error("cancelled socket"));
+        cancellation.resolve();
+        await rejected;
+        expect(native.cancelNativeHttpRequest).toHaveBeenCalledTimes(1);
+        expect(remove).toHaveBeenCalledWith("abort", expect.any(Function));
+    });
+    test("an abort during native start is cancelled after start and removes its listener", async () => {
+        const { native } = transport();
+        const controller = new AbortController();
+        const order = [];
+        native.nativeHttpRequest = jest.fn(() => {
+            order.push("start");
+            controller.abort();
+            return new Promise(() => { });
+        });
+        native.cancelNativeHttpRequest = jest.fn(async () => { order.push("cancel"); });
+        await expect(nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal)).rejects.toMatchObject({ name: "AbortError" });
+        expect(order).toEqual(["start", "cancel"]);
+    });
+    test.each(["success", "failure"])("%s removes its abort listener and a later abort does not cancel", async (outcome) => {
+        const { native, request } = transport();
+        const controller = new AbortController();
+        const remove = jest.spyOn(controller.signal, "removeEventListener");
+        const promise = nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal);
+        if (outcome === "success") {
+            request.resolve(response);
+            await expect(promise).resolves.toBe(response);
+        }
+        else {
+            request.reject(new Error("offline"));
+            await expect(promise).rejects.toThrow("offline");
+        }
+        controller.abort();
+        expect(remove).toHaveBeenCalledTimes(1);
+        expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled();
+    });
+    test("independent calls have separate IDs and unsignalled calls keep the native path", async () => {
+        const { native, request } = transport();
+        const first = nativeHttpRequest(native, "GET", "https://example.com/first", {}, null);
+        const second = nativeHttpRequest(native, "GET", "https://example.com/second", {}, null);
+        const calls = native.nativeHttpRequest.mock.calls;
+        expect(calls[0][0]).not.toBe(calls[1][0]);
+        request.resolve(response);
+        await Promise.all([first, second]);
+        expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=nativeHttpRequest.test.js.map

package/build/nativeHttpRequest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeHttpRequest.test.js","sourceRoot":"","sources":["../src/nativeHttpRequest.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {nativeHttpRequest, type NativeHttpResult, type NativeHttpTransport} from \"./nativeHttpRequest\"\n\nconst response: NativeHttpResult = {status: 200, statusText: \"OK\", headers: {}, body: \"{}\"}\n\nfunction deferred<T>() {\n  let resolve!: (value: T) => void\n  let reject!: (error: unknown) => void\n  const promise = new Promise<T>((yes, no) => {\n    resolve = yes\n    reject = no\n  })\n  return {promise, resolve, reject}\n}\n\nfunction transport(request = deferred<NativeHttpResult>()) {\n  const native: NativeHttpTransport = {\n    nativeHttpRequest: jest.fn(() => request.promise),\n    cancelNativeHttpRequest: jest.fn(async () => {}),\n  }\n  return {native, request}\n}\n\ndescribe(\"nativeHttpRequest\", () => {\n  test(\"pre-aborted requests do not start or cancel native work\", async () => {\n    const {native} = transport()\n    const controller = new AbortController()\n    const reason = new Error(\"deadline\")\n    controller.abort(reason)\n    await expect(nativeHttpRequest(native, \"GET\", \"https://example.com\", {}, null, controller.signal)).rejects.toBe(reason)\n    expect(native.nativeHttpRequest).not.toHaveBeenCalled()\n    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()\n  })\n\n  test(\"abort cancels only this request and waits for native cancellation acceptance\", async () => {\n    const {native, request} = transport()\n    const cancellation = deferred<void>()\n    native.cancelNativeHttpRequest = jest.fn(() => cancellation.promise)\n    const controller = new AbortController()\n    const remove = jest.spyOn(controller.signal, \"removeEventListener\")\n    const promise = nativeHttpRequest(native, \"POST\", \"https://example.com\", {test: \"header\"}, \"body\", controller.signal)\n    const rejected = expect(promise).rejects.toMatchObject({name: \"AbortError\"})\n    controller.abort()\n    const id = (native.nativeHttpRequest as jest.Mock).mock.calls[0][0]\n    expect(native.cancelNativeHttpRequest).toHaveBeenCalledWith(id)\n    expect(remove).not.toHaveBeenCalled()\n    request.reject(new Error(\"cancelled socket\"))\n    cancellation.resolve()\n    await rejected\n    expect(native.cancelNativeHttpRequest).toHaveBeenCalledTimes(1)\n    expect(remove).toHaveBeenCalledWith(\"abort\", expect.any(Function))\n  })\n\n  test(\"an abort during native start is cancelled after start and removes its listener\", async () => {\n    const {native} = transport()\n    const controller = new AbortController()\n    const order: string[] = []\n    native.nativeHttpRequest = jest.fn(() => {\n      order.push(\"start\")\n      controller.abort()\n      return new Promise<NativeHttpResult>(() => {})\n    })\n    native.cancelNativeHttpRequest = jest.fn(async () => {order.push(\"cancel\")})\n    await expect(nativeHttpRequest(native, \"GET\", \"https://example.com\", {}, null, controller.signal)).rejects.toMatchObject({name: \"AbortError\"})\n    expect(order).toEqual([\"start\", \"cancel\"])\n  })\n\n  test.each([\"success\", \"failure\"])(\"%s removes its abort listener and a later abort does not cancel\", async (outcome) => {\n    const {native, request} = transport()\n    const controller = new AbortController()\n    const remove = jest.spyOn(controller.signal, \"removeEventListener\")\n    const promise = nativeHttpRequest(native, \"GET\", \"https://example.com\", {}, null, controller.signal)\n    if (outcome === \"success\") {\n      request.resolve(response)\n      await expect(promise).resolves.toBe(response)\n    } else {\n      request.reject(new Error(\"offline\"))\n      await expect(promise).rejects.toThrow(\"offline\")\n    }\n    controller.abort()\n    expect(remove).toHaveBeenCalledTimes(1)\n    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()\n  })\n\n  test(\"independent calls have separate IDs and unsignalled calls keep the native path\", async () => {\n    const {native, request} = transport()\n    const first = nativeHttpRequest(native, \"GET\", \"https://example.com/first\", {}, null)\n    const second = nativeHttpRequest(native, \"GET\", \"https://example.com/second\", {}, null)\n    const calls = (native.nativeHttpRequest as jest.Mock).mock.calls\n    expect(calls[0][0]).not.toBe(calls[1][0])\n    request.resolve(response)\n    await Promise.all([first, second])\n    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()\n  })\n})\n"]}

package/ios/Crust.podspec

@@ -29,7 +29,7 @@ Pod::Spec.new do |s|
   # is intentionally NO `s.dependency 'MapboxNavigationCore'` here.
 
   # iOS frameworks required for media processing + navigation + heading
-  s.frameworks = 'AVFoundation', 'Photos', 'CoreImage', 'CoreGraphics', 'UIKit', 'CoreLocation', 'CoreMotion'
+  s.frameworks = 'AVFoundation', 'Photos', 'CoreImage', 'CoreGraphics', 'UIKit', 'CoreLocation', 'CoreMotion', 'CoreBluetooth'
 
   # Swift/Objective-C compatibility + Mapbox SPM module visibility.
   #

package/ios/CrustModule.swift

@@ -61,10 +61,26 @@ private struct PhotoLibrarySaveResult {
     let timedOut: Bool
 }
 
+/// MentraJS calls get their own serial queue. Expo runs every module's default-queue
+/// AsyncFunction on one shared serial queue, so a blocking call in another module held every
+/// host→miniapp message behind it: the ~25s offline STT model extraction after login kept
+/// miniapps from spawning and starved running ones of PINGs until the host respawned them.
+/// Serial, so spawn, dispatch and kill still run in the order JS issued them.
+private let mentraJsQueue = DispatchQueue(label: "com.mentra.mentrajs-bridge", qos: .userInitiated)
+
 public class CrustModule: Module {
     public func definition() -> ModuleDefinition {
         Name("Crust")
 
+        Constant("isIOSAppOnMac") {
+            ProcessInfo.processInfo.isiOSAppOnMac
+        }
+
+        AsyncFunction("getPermissionStatus") { (requestId: String?) -> [String: Any] in
+            if let requestId { return try await PermissionStatusReceipt.publish(requestId: requestId) }
+            return await PermissionStatusReceipt.current()
+        }
+
         Constant("PI") {
             Double.pi
         }
@@ -73,7 +89,6 @@ public class CrustModule: Module {
             "onChange",
             "phone_notification",
             "phone_notification_dismissed",
-            "captions_tester_incident",
             "onNavManeuver",
             "onNavRerouting",
             "onNavArrived",
@@ -279,7 +294,7 @@ public class CrustModule: Module {
                 polyfillBundle: polyfillBundle,
                 miniappJs: miniappJs
             )
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Evaluate an arbitrary script inside the named context. Returns
         /// the JS return value bridged to a JSON-friendly Swift type, or
@@ -287,19 +302,19 @@ public class CrustModule: Module {
         /// + tests; production code paths use mentraJsDispatchToJs.
         AsyncFunction("mentraJsEvaluate") { (packageName: String, source: String) -> Any? in
             return JSCRuntime.shared.evaluate(packageName: packageName, source: source)
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Tear down a JS context. Cancels timers, drops refs, forces GC.
         AsyncFunction("mentraJsKill") { (packageName: String) -> Void in
             JSCRuntime.shared.kill(packageName: packageName)
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Push an event / response envelope into the named context's
         /// globalThis.__deliver. Used by MentraJSRouter for
         /// glasses-status broadcasts and request/response correlation.
         AsyncFunction("mentraJsDispatchToJs") { (packageName: String, envelope: [String: Any]) -> Void in
             JSCRuntime.shared.dispatchToJs(packageName: packageName, envelope: envelope)
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Set the installed manifest for a miniapp so the dispatcher's
         /// permission gate can authorize sensitive `__dispatch` calls.
@@ -308,7 +323,7 @@ public class CrustModule: Module {
                 packageName: packageName,
                 manifest: InstalledMiniappManifest(permissions: Set(permissions))
             )
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Diagnostic: list all live packageNames.
         Function("mentraJsAlivePackages") { () -> [String] in
@@ -320,7 +335,7 @@ public class CrustModule: Module {
         /// the context is dead.
         AsyncFunction("mentraJsDebugForceGC") { (packageName: String) -> Bool in
             return JSCRuntime.shared.debugForceGC(packageName: packageName)
-        }
+        }.runOnQueue(mentraJsQueue)
 
         /// Read the bundled MentraJS polyfill (startup.js) from the iOS
         /// pod's resource bundle. The host calls this once on app boot,

package/ios/PermissionStatusReceipt.swift

@@ -0,0 +1,105 @@
+import AVFoundation
+import CoreBluetooth
+import CoreLocation
+import Foundation
+
+/// Passive app-owned observations. None of these getters requests consent,
+/// starts capture, creates a Bluetooth central, or joins a network.
+enum PermissionStatusReceipt {
+    static let relativePath = "MentraDiagnostics/permission-status.json"
+
+    static func state(_ rawStatus: String, _ status: String) -> [String: String] {
+        ["rawStatus": rawStatus, "status": status]
+    }
+
+    static func location(_ value: CLAuthorizationStatus) -> [String: String] {
+        switch value {
+        case .notDetermined: return state("notDetermined", "denied")
+        case .denied: return state("denied", "blocked")
+        case .restricted: return state("restricted", "unavailable")
+        case .authorizedAlways: return state("authorizedAlways", "granted")
+        case .authorizedWhenInUse: return state("authorizedWhenInUse", "granted")
+        @unknown default: return state("unknown", "unknown")
+        }
+    }
+
+    static func capture(_ value: AVAuthorizationStatus) -> [String: String] {
+        switch value {
+        case .notDetermined: return state("notDetermined", "denied")
+        case .denied: return state("denied", "blocked")
+        case .restricted: return state("restricted", "unavailable")
+        case .authorized: return state("authorized", "granted")
+        @unknown default: return state("unknown", "unknown")
+        }
+    }
+
+    static func bluetooth(_ value: CBManagerAuthorization) -> [String: String] {
+        switch value {
+        case .notDetermined: return state("notDetermined", "denied")
+        case .denied: return state("denied", "blocked")
+        case .restricted: return state("restricted", "unavailable")
+        case .allowedAlways: return state("allowedAlways", "granted")
+        @unknown default: return state("unknown", "unknown")
+        }
+    }
+
+    static func current() async -> [String: Any] {
+        // The global service getter may block; only the manager's authorization
+        // observation belongs to the main actor, which owns Core Location objects.
+        let servicesEnabled = CLLocationManager.locationServicesEnabled()
+        return await MainActor.run {
+            let bundle = Bundle.main
+            let formatter = ISO8601DateFormatter()
+            formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+            return [
+                "schemaVersion": 1,
+                "observedAt": formatter.string(from: Date()),
+                "identity": [
+                    "pid": ProcessInfo.processInfo.processIdentifier,
+                    "uid": getuid(),
+                    "bundleId": bundle.bundleIdentifier ?? "",
+                    "bundlePath": bundle.bundleURL.path,
+                    "executablePath": bundle.executableURL?.path ?? "",
+                    "version": bundle.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String ?? "",
+                    "build": bundle.object(forInfoDictionaryKey: "CFBundleVersion") as? String ?? "",
+                ] as [String: Any],
+                "locationServicesEnabled": servicesEnabled,
+                "permissions": [
+                    "location": location(CLLocationManager().authorizationStatus),
+                    "camera": capture(AVCaptureDevice.authorizationStatus(for: .video)),
+                    "microphone": capture(AVCaptureDevice.authorizationStatus(for: .audio)),
+                    "bluetooth": bluetooth(CBManager.authorization),
+                    // iOS has no public passive Local Network authorization getter.
+                    "localNetwork": ["rawStatus": NSNull(), "status": "unknown"],
+                ] as [String: Any],
+            ]
+        }
+    }
+
+    static func correlate(_ observation: [String: Any], requestId: String) throws -> [String: Any] {
+        guard requestId.range(of: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}\\z", options: .regularExpression) != nil else {
+            throw NSError(domain: "MentraPermissionStatus", code: 1,
+                          userInfo: [NSLocalizedDescriptionKey: "One bounded permission request ID is required"])
+        }
+        return observation.merging(["requestId": requestId]) { _, fresh in fresh }
+    }
+
+    static func write(_ receipt: [String: Any], to path: URL) throws {
+        let files = FileManager.default
+        try files.createDirectory(at: path.deletingLastPathComponent(), withIntermediateDirectories: true,
+                                  attributes: [.posixPermissions: 0o700])
+        try JSONSerialization.data(withJSONObject: receipt, options: [.sortedKeys]).write(to: path, options: .atomic)
+        try files.setAttributes([.posixPermissions: 0o600], ofItemAtPath: path.path)
+    }
+
+    static func publish(requestId: String) async throws -> [String: Any] {
+        // Validate before observing; the request never controls a filesystem path.
+        _ = try correlate([:], requestId: requestId)
+        let observation = await current()
+        let receipt = try correlate(observation, requestId: requestId)
+        let cache = try FileManager.default.url(for: .cachesDirectory, in: .userDomainMask,
+                                                appropriateFor: nil, create: true)
+        try write(receipt, to: cache.appendingPathComponent(relativePath))
+        return receipt
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/crust",
-  "version": "3.2.1-dev.314",
+  "version": "3.3.0-beta.942",
   "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-dev.314"
+    "@mentra/jspolyfill": "3.3.0-beta.942"
   },
   "devDependencies": {
     "@expo/config-plugins": ">=8.0.0",

package/plugin/build/index.d.ts

@@ -14,6 +14,8 @@ import { type ConfigPlugin } from "expo/config-plugins";
  *   both fails the release build with duplicate classes)
  * - core-library desugaring (crust's AAR metadata requires it of embedding
  *   apps — the Nav SDK uses newer core libs)
+ * - Kotlin 2.3.0 or newer, with the root Kotlin Gradle plugin pinned to it
+ *   (crust's QuickJS library, quickjs-kt 1.0.15, is compiled with Kotlin 2.4)
  * - a generated MainApplication process guard so the notification-listener
  *   process never initializes React Native
  * - iOS Mapbox Swift Package products and the Crust build-order dependency

package/plugin/build/index.js

@@ -21,6 +21,8 @@ const withMapboxNavIos_1 = __importDefault(require("./withMapboxNavIos"));
  *   both fails the release build with duplicate classes)
  * - core-library desugaring (crust's AAR metadata requires it of embedding
  *   apps — the Nav SDK uses newer core libs)
+ * - Kotlin 2.3.0 or newer, with the root Kotlin Gradle plugin pinned to it
+ *   (crust's QuickJS library, quickjs-kt 1.0.15, is compiled with Kotlin 2.4)
  * - a generated MainApplication process guard so the notification-listener
  *   process never initializes React Native
  * - iOS Mapbox Swift Package products and the Crust build-order dependency

package/plugin/build/withAndroid.js

@@ -20,12 +20,50 @@ const MAPBOX_REPO = [
     "      }",
     "    }",
 ].join("\n");
+// quickjs-kt 1.0.15 is compiled with Kotlin 2.4, and a Kotlin compiler reads
+// metadata one version ahead. 2.3.0 is the newest 2.3 release Expo SDK 55's
+// root plugin maps to a KSP version.
+const MIN_KOTLIN_VERSION = "2.3.0";
+// The template's unversioned classpath entry resolves to the Kotlin Gradle
+// plugin React Native's Gradle plugin depends on (2.1.20 on RN 0.83), whatever
+// `android.kotlinVersion` says; Expo fixes that only in SDK 58
+// (expo/expo#49668). SDK 56 also never copies the property into Expo's catalog,
+// so pin both the compiler and the root `kotlinVersion` to the property itself.
+const UNVERSIONED_KOTLIN_PLUGIN = "classpath('org.jetbrains.kotlin:kotlin-gradle-plugin')";
+const PINNED_KOTLIN_PLUGIN = `classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:\${findProperty('android.kotlinVersion')}")`;
+const KOTLIN_VERSION_MARKER = "kotlinVersion from android.kotlinVersion (injected by @mentra/crust)";
+const EXPO_ROOT_PROJECT = 'apply plugin: "expo-root-project"';
+function isOlderVersion(version, minimum) {
+    const actual = version.split(".").map(Number);
+    const required = minimum.split(".").map(Number);
+    for (let i = 0; i < required.length; i++) {
+        if ((actual[i] ?? 0) !== required[i])
+            return (actual[i] ?? 0) < required[i];
+    }
+    return false;
+}
+function withCrustKotlinVersion(config) {
+    return (0, config_plugins_1.withGradleProperties)(config, (cfg) => {
+        const property = cfg.modResults.find((item) => item.type === "property" && item.key === "android.kotlinVersion");
+        if (property?.type !== "property") {
+            cfg.modResults.push({ type: "property", key: "android.kotlinVersion", value: MIN_KOTLIN_VERSION });
+        }
+        else if (isOlderVersion(property.value, MIN_KOTLIN_VERSION)) {
+            property.value = MIN_KOTLIN_VERSION;
+        }
+        return cfg;
+    });
+}
 const PROTOBUF_EXCLUDE = "exclude group: 'com.google.protobuf', module: 'protobuf-javalite'";
 const NOTIFICATION_PROCESS_GUARD = "crust: skip React Native in notification process";
 const NOTIFICATION_CONFIG_GUARD = "crust: skip Expo lifecycle in notification process";
 function withCrustProjectGradle(config) {
     return (0, config_plugins_1.withProjectBuildGradle)(config, (cfg) => {
         let gradle = cfg.modResults.contents;
+        gradle = gradle.replace(UNVERSIONED_KOTLIN_PLUGIN, PINNED_KOTLIN_PLUGIN);
+        if (!gradle.includes(KOTLIN_VERSION_MARKER)) {
+            gradle = gradle.replace(EXPO_ROOT_PROJECT, `// ${KOTLIN_VERSION_MARKER}\next.kotlinVersion = findProperty('android.kotlinVersion')\n${EXPO_ROOT_PROJECT}`);
+        }
         // Mapbox Downloads repo, inserted at the top of allprojects.repositories.
         if (!gradle.includes(MAPBOX_REPO_MARKER)) {
             const reposMatch = gradle.match(/allprojects\s*\{[\s\S]*?repositories\s*\{/);
@@ -129,6 +167,7 @@ function withNotificationProcessGuard(config) {
     });
 }
 const withCrustAndroidBuildContract = (config) => {
+    config = withCrustKotlinVersion(config);
     config = withCrustProjectGradle(config);
     config = withCrustAppGradle(config);
     return withNotificationProcessGuard(config);

package/src/Crust.types.ts

@@ -16,7 +16,6 @@ export type CrustModuleEvents = {
   onHeading: (params: HeadingPayload) => void
   phone_notification: (event: PhoneNotificationEvent) => void
   phone_notification_dismissed: (event: PhoneNotificationDismissedEvent) => void
-  captions_tester_incident: (event: CaptionsTesterIncidentEvent) => void
 }
 
 export type NavOffRoutePayload = {
@@ -114,6 +113,8 @@ export type NavManeuverPayload = {
 
 export type NavErrorPayload = {
   message: string
+  /** True only when native navigation has ended; absent for recoverable reroute errors. */
+  terminal?: boolean
 }
 
 export type InstalledApp = {
@@ -144,19 +145,32 @@ export type PhoneNotificationDismissedEvent = {
   notificationId: string
 }
 
-export type CaptionsTesterIncidentEvent = {
-  action?: string
-  timestamp?: number
-  failure_code?: string
-  failure_message?: string
-  test_run_id?: string
-  scenario_name?: string
-  source?: string
-  [key: string]: unknown
-}
-
 export type CrustViewProps = {
   url: string
   onLoad: (event: {nativeEvent: OnLoadEventPayload}) => void
   style?: StyleProp<ViewStyle>
 }
+
+/** Passive OS observations for the currently executing Mentra App. */
+export type AppPermissionStatus = {
+  rawStatus: string | null
+  status: "granted" | "denied" | "blocked" | "unavailable" | "unknown"
+}
+
+export type AppPermissionSnapshot = {
+  schemaVersion: 1
+  observedAt: string
+  identity: {
+    pid: number
+    uid: number
+    bundleId: string
+    bundlePath: string
+    executablePath: string
+    version: string
+    build: string
+  }
+  locationServicesEnabled: boolean
+  permissions: Record<"location" | "camera" | "microphone" | "bluetooth" | "localNetwork", AppPermissionStatus>
+}
+
+export type AppPermissionReceipt = AppPermissionSnapshot & {requestId: string}

package/src/CrustModule.ts

@@ -1,17 +1,27 @@
 import {NativeModule, requireNativeModule} from "expo"
 
-import {CrustModuleEvents, InstalledApp} from "./Crust.types"
+import {AppPermissionReceipt, AppPermissionSnapshot, CrustModuleEvents, InstalledApp} from "./Crust.types"
 
 declare class CrustModule extends NativeModule<CrustModuleEvents> {
+  /** True for the native iOS app running on an Apple Silicon Mac. */
+  readonly isIOSAppOnMac?: boolean
+  /** iOS: passive actual-app authorization status; never requests consent. */
+  getPermissionStatus(requestId: null): Promise<AppPermissionSnapshot>
+  /** iOS: a nonce publishes fresh status at the fixed managed-cache path. */
+  getPermissionStatus(requestId: string): Promise<AppPermissionReceipt>
   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(
+    requestId: string,
     method: string,
     url: string,
     headers: Record<string, string>,
     body?: string | null,
   ): Promise<{status: number; statusText: string; headers: Record<string, string>; body: string}>
+  cancelNativeHttpRequest(requestId: string): Promise<void>
   showAVRoutePicker(tintColor?: string | null): void
 
   /**

package/src/CrustModule.web.ts

@@ -4,18 +4,29 @@ import {CrustModuleEvents} from "./Crust.types"
 
 class CrustModule extends NativeModule<CrustModuleEvents> {
   PI = Math.PI
+  private readonly httpRequests = new Map<string, AbortController>()
   async setValueAsync(value: string): Promise<void> {
     this.emit("onChange", {value})
   }
-  async nativeHttpRequest(method: string, url: string, headers: Record<string, string>, body?: string | null) {
-    const response = await fetch(url, {method, headers, body})
-    return {
-      status: response.status,
-      statusText: response.statusText,
-      headers: Object.fromEntries(response.headers.entries()),
-      body: await response.text(),
+  async nativeHttpRequest(requestId: string, method: string, url: string, headers: Record<string, string>, body?: string | null) {
+    const controller = new AbortController()
+    this.httpRequests.set(requestId, controller)
+    try {
+      const response = await fetch(url, {method, headers, body, signal: controller.signal})
+      return {
+        status: response.status,
+        statusText: response.statusText,
+        headers: Object.fromEntries(response.headers.entries()),
+        body: await response.text(),
+      }
+    } finally {
+      this.httpRequests.delete(requestId)
     }
   }
+  async cancelNativeHttpRequest(requestId: string): Promise<void> {
+    this.httpRequests.get(requestId)?.abort()
+    this.httpRequests.delete(requestId)
+  }
   hello() {
     return "Hello world! 👋"
   }

package/src/index.ts

@@ -3,3 +3,4 @@
 export {default} from "./CrustModule"
 export {default as CrustView} from "./CrustView"
 export * from "./Crust.types"
+export {nativeHttpRequest} from "./nativeHttpRequest"

package/src/nativeHttpRequest.test.ts

@@ -0,0 +1,94 @@
+import {nativeHttpRequest, type NativeHttpResult, type NativeHttpTransport} from "./nativeHttpRequest"
+
+const response: NativeHttpResult = {status: 200, statusText: "OK", headers: {}, body: "{}"}
+
+function deferred<T>() {
+  let resolve!: (value: T) => void
+  let reject!: (error: unknown) => void
+  const promise = new Promise<T>((yes, no) => {
+    resolve = yes
+    reject = no
+  })
+  return {promise, resolve, reject}
+}
+
+function transport(request = deferred<NativeHttpResult>()) {
+  const native: NativeHttpTransport = {
+    nativeHttpRequest: jest.fn(() => request.promise),
+    cancelNativeHttpRequest: jest.fn(async () => {}),
+  }
+  return {native, request}
+}
+
+describe("nativeHttpRequest", () => {
+  test("pre-aborted requests do not start or cancel native work", async () => {
+    const {native} = transport()
+    const controller = new AbortController()
+    const reason = new Error("deadline")
+    controller.abort(reason)
+    await expect(nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal)).rejects.toBe(reason)
+    expect(native.nativeHttpRequest).not.toHaveBeenCalled()
+    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()
+  })
+
+  test("abort cancels only this request and waits for native cancellation acceptance", async () => {
+    const {native, request} = transport()
+    const cancellation = deferred<void>()
+    native.cancelNativeHttpRequest = jest.fn(() => cancellation.promise)
+    const controller = new AbortController()
+    const remove = jest.spyOn(controller.signal, "removeEventListener")
+    const promise = nativeHttpRequest(native, "POST", "https://example.com", {test: "header"}, "body", controller.signal)
+    const rejected = expect(promise).rejects.toMatchObject({name: "AbortError"})
+    controller.abort()
+    const id = (native.nativeHttpRequest as jest.Mock).mock.calls[0][0]
+    expect(native.cancelNativeHttpRequest).toHaveBeenCalledWith(id)
+    expect(remove).not.toHaveBeenCalled()
+    request.reject(new Error("cancelled socket"))
+    cancellation.resolve()
+    await rejected
+    expect(native.cancelNativeHttpRequest).toHaveBeenCalledTimes(1)
+    expect(remove).toHaveBeenCalledWith("abort", expect.any(Function))
+  })
+
+  test("an abort during native start is cancelled after start and removes its listener", async () => {
+    const {native} = transport()
+    const controller = new AbortController()
+    const order: string[] = []
+    native.nativeHttpRequest = jest.fn(() => {
+      order.push("start")
+      controller.abort()
+      return new Promise<NativeHttpResult>(() => {})
+    })
+    native.cancelNativeHttpRequest = jest.fn(async () => {order.push("cancel")})
+    await expect(nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal)).rejects.toMatchObject({name: "AbortError"})
+    expect(order).toEqual(["start", "cancel"])
+  })
+
+  test.each(["success", "failure"])("%s removes its abort listener and a later abort does not cancel", async (outcome) => {
+    const {native, request} = transport()
+    const controller = new AbortController()
+    const remove = jest.spyOn(controller.signal, "removeEventListener")
+    const promise = nativeHttpRequest(native, "GET", "https://example.com", {}, null, controller.signal)
+    if (outcome === "success") {
+      request.resolve(response)
+      await expect(promise).resolves.toBe(response)
+    } else {
+      request.reject(new Error("offline"))
+      await expect(promise).rejects.toThrow("offline")
+    }
+    controller.abort()
+    expect(remove).toHaveBeenCalledTimes(1)
+    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()
+  })
+
+  test("independent calls have separate IDs and unsignalled calls keep the native path", async () => {
+    const {native, request} = transport()
+    const first = nativeHttpRequest(native, "GET", "https://example.com/first", {}, null)
+    const second = nativeHttpRequest(native, "GET", "https://example.com/second", {}, null)
+    const calls = (native.nativeHttpRequest as jest.Mock).mock.calls
+    expect(calls[0][0]).not.toBe(calls[1][0])
+    request.resolve(response)
+    await Promise.all([first, second])
+    expect(native.cancelNativeHttpRequest).not.toHaveBeenCalled()
+  })
+})