@mentra/crust 3.3.0-dev.774 → 3.3.0-dev.780

package/README.md

@@ -46,3 +46,15 @@ sibling, which is declared as a dependency.
 
 Source lives in the [MentraOS monorepo](https://github.com/Mentra-Community/MentraOS)
 under `mobile/modules/crust`. Issues and contributions welcome there.
+
+## Android native HTTP cancellation
+
+Engine's cloud client uses `nativeHttpRequest(CrustModule, method, url, headers,
+body, signal?)` from `@mentra/crust`. The helper preserves Android's native
+background HTTP transport and connects the caller's `AbortSignal` to cancellation
+of that exact OkHttp call. Request IDs and native call ownership stay inside the
+transport. Completion removes its listener and native registry entry; module
+shutdown cancels only that module's outstanding host requests.
+
+Engine callers use the ordinary cloud-client API with a signal. They do not call
+native start/cancel methods or maintain their own request registry.

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

@@ -22,6 +22,7 @@ import com.mentra.crust.preview.PixelCopyPreview
 import com.mentra.crust.jsc.JSCRuntime
 import com.mentra.crust.jsc.InstalledMiniappManifest
 import com.mentra.crust.jsc.JSCPolyfillBridge
+import com.mentra.crust.http.NativeHttpRequests
 
 class CrustModule : Module() {
   companion object {
@@ -99,6 +100,7 @@ class CrustModule : Module() {
           )
   private var notificationEventReceiver: BroadcastReceiver? = null
   private var notificationBridgeContext: android.content.Context? = null
+  private val nativeHttpRequests = NativeHttpRequests(JSCPolyfillBridge.httpClient)
 
   private fun registerNotificationBridgeIfPossible(): Boolean {
     if (notificationEventReceiver != null) return true
@@ -169,6 +171,7 @@ class CrustModule : Module() {
       notificationEventReceiver = null
       notificationBridgeContext = null
       eventEmitter = null
+      nativeHttpRequests.cancelAll()
       mentraJsQueue.cancel()
       mentraJsExecutor.shutdown()
     }
@@ -187,12 +190,16 @@ class CrustModule : Module() {
     }
 
     AsyncFunction("nativeHttpRequest") {
-      method: String, url: String, headers: Map<String, String>, body: String?, promise: expo.modules.kotlin.Promise ->
-      JSCPolyfillBridge.enqueueHttp(
-        method,
-        url,
-        headers,
-        body,
+      requestId: String, method: String, url: String, headers: Map<String, String>, body: String?, promise: expo.modules.kotlin.Promise ->
+      val request = try {
+        JSCPolyfillBridge.buildHttpRequest(method, url, headers, body)
+      } catch (error: Throwable) {
+        promise.reject("E_NATIVE_HTTP", error.message ?: "Native HTTP request failed", error)
+        return@AsyncFunction
+      }
+      nativeHttpRequests.enqueue(
+        requestId,
+        request,
         onResult = { result ->
           promise.resolve(
             mapOf(
@@ -207,6 +214,11 @@ class CrustModule : Module() {
       )
     }
 
+    // Same serial Expo queue as nativeHttpRequest: cancellation cannot precede registration.
+    AsyncFunction("cancelNativeHttpRequest") { requestId: String ->
+      nativeHttpRequests.cancel(requestId)
+    }
+
     Function("showAVRoutePicker") { _: String? ->
       // iOS-only; Android uses system Bluetooth settings / Crust where appropriate.
     }

package/android/src/main/java/com/mentra/crust/http/NativeHttpRequests.kt

@@ -0,0 +1,86 @@
+package com.mentra.crust.http
+
+import java.io.IOException
+import java.util.concurrent.ConcurrentHashMap
+import java.util.concurrent.atomic.AtomicBoolean
+import okhttp3.Call
+import okhttp3.Callback
+import okhttp3.Request
+import okhttp3.Response
+
+/** Calls owned by one Expo module, separate from miniapp fetch and WebSocket traffic. */
+internal class NativeHttpRequests(private val client: Call.Factory) {
+    data class Result(
+        val status: Int,
+        val statusText: String,
+        val headers: Map<String, String>,
+        val body: String,
+    )
+
+    private val calls = ConcurrentHashMap<String, Call>()
+    private val closed = AtomicBoolean(false)
+    internal val activeCount: Int get() = calls.size
+
+    fun enqueue(
+        requestId: String,
+        request: Request,
+        onResult: (Result) -> Unit,
+        onError: (Throwable) -> Unit,
+    ) {
+        if (closed.get()) {
+            onError(IllegalStateException("Native HTTP module is closed"))
+            return
+        }
+        val call = client.newCall(request)
+        if (calls.putIfAbsent(requestId, call) != null) {
+            onError(IllegalArgumentException("Native HTTP request ID is already active"))
+            return
+        }
+        // Destruction may run on a different thread from Expo's serial request queue.
+        if (closed.get()) {
+            calls.remove(requestId, call)
+            call.cancel()
+            onError(IllegalStateException("Native HTTP module is closed"))
+            return
+        }
+        try {
+            call.enqueue(object : Callback {
+                override fun onFailure(call: Call, e: IOException) {
+                    calls.remove(requestId, call)
+                    onError(e)
+                }
+
+                override fun onResponse(call: Call, response: Response) {
+                    val result = try {
+                        response.use { r ->
+                            val headers = r.headers.names().associate { name ->
+                                name.lowercase() to r.headers.values(name).joinToString(", ")
+                            }
+                            Result(r.code, r.message, headers, r.body?.string() ?: "")
+                        }
+                    } catch (e: Throwable) {
+                        calls.remove(requestId, call)
+                        onError(e)
+                        return
+                    }
+                    calls.remove(requestId, call)
+                    onResult(result)
+                }
+            })
+        } catch (e: Throwable) {
+            calls.remove(requestId, call)
+            onError(e)
+        }
+    }
+
+    fun cancel(requestId: String) {
+        calls.remove(requestId)?.cancel()
+    }
+
+    fun cancelAll() {
+        closed.set(true)
+        for ((requestId, call) in calls) {
+            if (calls.remove(requestId, call)) call.cancel()
+        }
+    }
+}

package/android/src/main/java/com/mentra/crust/jsc/JSCPolyfillBridge.kt

@@ -37,7 +37,7 @@ import android.util.Base64
 object JSCPolyfillBridge {
     private const val TAG = "MentraJS.PolyfillBridge"
 
-    private val httpClient: OkHttpClient by lazy {
+    internal val httpClient: OkHttpClient by lazy {
         OkHttpClient.Builder()
             .connectTimeout(30, TimeUnit.SECONDS)
             .readTimeout(60, TimeUnit.SECONDS)
@@ -45,58 +45,6 @@ object JSCPolyfillBridge {
             .build()
     }
 
-    data class HttpResult(
-        val status: Int,
-        val statusText: String,
-        val headers: Map<String, String>,
-        val body: String,
-    )
-
-    /**
-     * Shared OkHttp path for host cloud-client requests. Asynchronous because Expo runs every
-     * module's AsyncFunction on one shared thread: a blocking call here stalls miniapp delivery
-     * and every other native module for the length of the request, up to [callTimeout].
-     */
-    fun enqueueHttp(
-        method: String,
-        url: String,
-        headers: Map<String, String>,
-        bodyString: String?,
-        onResult: (HttpResult) -> Unit,
-        onError: (Throwable) -> Unit,
-    ) {
-        val request = try {
-            buildHttpRequest(method, url, headers, bodyString)
-        } catch (e: Throwable) {
-            onError(e)
-            return
-        }
-        httpClient.newCall(request).enqueue(object : Callback {
-            override fun onFailure(call: Call, e: IOException) = onError(e)
-
-            override fun onResponse(call: Call, response: Response) {
-                try {
-                    response.use { r ->
-                        val responseHeaders = mutableMapOf<String, String>()
-                        for (name in r.headers.names()) {
-                            responseHeaders[name.lowercase()] = r.headers.values(name).joinToString(", ")
-                        }
-                        onResult(
-                            HttpResult(
-                                status = r.code,
-                                statusText = r.message,
-                                headers = responseHeaders,
-                                body = r.body?.string() ?: "",
-                            )
-                        )
-                    }
-                } catch (e: Throwable) {
-                    onError(e)
-                }
-            }
-        })
-    }
-
     /** Keep host HTTP and miniapp fetch body semantics identical, including empty POSTs. */
     internal fun buildHttpRequest(method: String, url: String, headers: Map<String, String>, bodyString: String?): Request {
         val builder = Request.Builder().url(url)

package/android/src/test/java/com/mentra/crust/http/NativeHttpRequestsTest.kt

@@ -0,0 +1,133 @@
+package com.mentra.crust.http
+
+import java.io.IOException
+import java.net.ServerSocket
+import java.util.concurrent.CountDownLatch
+import java.util.concurrent.TimeUnit
+import okhttp3.Call
+import okhttp3.Callback
+import okhttp3.OkHttpClient
+import okhttp3.Protocol
+import okhttp3.Request
+import okhttp3.Response
+import okhttp3.ResponseBody.Companion.toResponseBody
+import okio.Timeout
+import org.junit.Assert.*
+import org.junit.Test
+
+class NativeHttpRequestsTest {
+    private val request = Request.Builder().url("https://example.com/report").build()
+
+    private class PendingCall(private val request: Request) : Call {
+        var callback: Callback? = null
+        var cancelled = false
+        var onEnqueue: (() -> Unit)? = null
+        override fun request() = request
+        override fun execute(): Response = error("Test only exercises asynchronous calls")
+        override fun enqueue(responseCallback: Callback) {
+            callback = responseCallback
+            onEnqueue?.invoke()
+        }
+        override fun cancel() {cancelled = true}
+        override fun isExecuted() = callback != null
+        override fun isCanceled() = cancelled
+        override fun timeout() = Timeout.NONE
+        override fun clone(): Call = PendingCall(request)
+    }
+
+    @Test fun `register before enqueue and cancel only the requested call`() {
+        val calls = mutableListOf<PendingCall>()
+        val owner = NativeHttpRequests(Call.Factory { req -> PendingCall(req).also {calls.add(it)} })
+        owner.enqueue("one", request, {}, {throw it})
+        calls[0].onEnqueue = {assertEquals(2, owner.activeCount)}
+        owner.enqueue("two", request, {}, {throw it})
+        assertEquals(2, owner.activeCount)
+        owner.cancel("one")
+        assertTrue(calls[0].cancelled)
+        assertFalse(calls[1].cancelled)
+        assertEquals(1, owner.activeCount)
+        owner.cancel("not-owned")
+        assertEquals(1, owner.activeCount)
+        owner.cancelAll()
+        assertTrue(calls[1].cancelled)
+        assertEquals(0, owner.activeCount)
+    }
+
+    @Test fun `completion removes the active request and preserves the response`() {
+        val call = PendingCall(request)
+        val owner = NativeHttpRequests(Call.Factory {call})
+        var result: NativeHttpRequests.Result? = null
+        call.onEnqueue = {assertEquals(1, owner.activeCount)}
+        owner.enqueue("complete", request, {result = it}, {throw it})
+        call.callback!!.onResponse(call, Response.Builder().request(request).protocol(Protocol.HTTP_1_1)
+            .code(200).message("OK").header("Content-Type", "application/json").body("{}".toResponseBody()).build())
+        assertEquals("{}", result!!.body)
+        assertEquals("application/json", result!!.headers["content-type"])
+        assertEquals(0, owner.activeCount)
+        owner.cancel("complete")
+        assertFalse(call.cancelled)
+    }
+
+    @Test fun `network failure and synchronous enqueue failure leave no registry entries`() {
+        val call = PendingCall(request)
+        val owner = NativeHttpRequests(Call.Factory {call})
+        var failures = 0
+        owner.enqueue("failed", request, {}, {failures++})
+        call.callback!!.onFailure(call, IOException("offline"))
+        assertEquals(0, owner.activeCount)
+        call.onEnqueue = {throw IllegalStateException("dispatcher closed")}
+        owner.enqueue("enqueue-failed", request, {}, {failures++})
+        assertEquals(0, owner.activeCount)
+        assertEquals(2, failures)
+    }
+
+    @Test fun `duplicate IDs cannot replace existing ownership and destruction prevents later requests`() {
+        val calls = mutableListOf<PendingCall>()
+        val owner = NativeHttpRequests(Call.Factory {req -> PendingCall(req).also {calls.add(it)} })
+        var failures = 0
+        owner.enqueue("one", request, {}, {failures++})
+        owner.enqueue("one", request, {}, {failures++})
+        assertEquals(1, failures)
+        assertEquals(1, owner.activeCount)
+        assertNull(calls[1].callback)
+        owner.cancelAll()
+        assertTrue(calls[0].cancelled)
+        owner.enqueue("later", request, {}, {failures++})
+        assertEquals(2, failures)
+        assertEquals(2, calls.size)
+        assertEquals(0, owner.activeCount)
+    }
+
+    @Test fun `cancel interrupts an actual OkHttp response body and closes the server socket`() {
+        val client = OkHttpClient()
+        val owner = NativeHttpRequests(client)
+        val bodyStarted = CountDownLatch(1)
+        val socketClosed = CountDownLatch(1)
+        val failed = CountDownLatch(1)
+        ServerSocket(0, 1, java.net.InetAddress.getLoopbackAddress()).use {server ->
+            val thread = Thread {
+                server.accept().use {socket ->
+                    socket.soTimeout = 5_000
+                    val reader = socket.getInputStream().bufferedReader()
+                    while (!reader.readLine().isNullOrEmpty()) {}
+                    socket.getOutputStream().write("HTTP/1.1 200 OK\r\nContent-Length: 100\r\n\r\n".toByteArray())
+                    socket.getOutputStream().flush()
+                    bodyStarted.countDown()
+                    if (socket.getInputStream().read() == -1) socketClosed.countDown()
+                }
+            }
+            thread.isDaemon = true
+            thread.start()
+            val req = Request.Builder().url("http://127.0.0.1:${server.localPort}/report").build()
+            owner.enqueue("stalled-body", req, {fail("Cancelled body must not complete")}, {failed.countDown()})
+            assertTrue("server started body", bodyStarted.await(5, TimeUnit.SECONDS))
+            owner.cancel("stalled-body")
+            assertTrue("native request rejected", failed.await(5, TimeUnit.SECONDS))
+            assertTrue("socket closed", socketClosed.await(5, TimeUnit.SECONDS))
+            assertEquals(0, owner.activeCount)
+            thread.join(5_000)
+        }
+        client.dispatcher.executorService.shutdownNow()
+        client.connectionPool.evictAll()
+    }
+}

package/build/CrustModule.d.ts

@@ -8,12 +8,13 @@ declare class CrustModule extends NativeModule<CrustModuleEvents> {
     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<{
+    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;
     /**
      * iOS: configure `preferredScreenEdgesDeferringSystemGestures`. When an

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":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAC,MAAM,eAAe,CAAA;AAE7D,OAAO,OAAO,WAAY,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IAC/D,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,IAAI,MAAM;IACf,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,gFAAgF;IAChF,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvD,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;IAC/F,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACzD,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAElD;;;;;;;;OAQG;IACH,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAGnG,qBAAqB,CAAC,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACnF,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAC3C,gCAAgC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAC3D,iCAAiC,IAAI,OAAO,CAAC,OAAO,CAAC;IACrD,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC;IAC/C,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC;IACpD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAE/B,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC;IAC9C,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC;IAC7C,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IACxC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IACnC,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAGzC,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QACP,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,GACA,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC;IAEF,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC;IAEF,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC;IAGF,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC;IAGF,eAAe,CACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,iHAAiH;QACjH,KAAK,CAAC,EAAE,KAAK,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAC,CAAC,CAAA;QACzC,2EAA2E;QAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAC,CAAA;QAChE,yFAAyF;QACzF,uBAAuB,CAAC,EAAE,MAAM,CAAA;KACjC,GACA,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IACzC,cAAc,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAExD;;;;;OAKG;IACH,2BAA2B,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAExF;;;;;OAKG;IACH,yBAAyB,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAEnE;;;OAGG;IACH,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAEhF;;;;;;;OAOG;IACH,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAEhF;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAG1E,YAAY,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IACtD,WAAW,IAAI,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IAGrD;;;;;;;;OAQG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC/F,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACvE,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD;;;;;OAKG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3F,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9E,qEAAqE;IACrE,qBAAqB,IAAI,MAAM,EAAE;IACjC,0DAA0D;IAC1D,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC3D;;;;;OAKG;IACH,0BAA0B,IAAI,MAAM;CACrC;;AAGD,wBAAwD"}

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;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"]}
+{"version":3,"file":"CrustModule.js","sourceRoot":"","sources":["../src/CrustModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAoMtD,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    requestId: string,\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  cancelNativeHttpRequest(requestId: string): Promise<void>\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/build/CrustModule.web.d.ts

@@ -2,8 +2,9 @@ import { NativeModule } from "expo";
 import { CrustModuleEvents } from "./Crust.types";
 declare class CrustModule extends NativeModule<CrustModuleEvents> {
     PI: number;
+    private readonly httpRequests;
     setValueAsync(value: string): Promise<void>;
-    nativeHttpRequest(method: string, url: string, headers: Record<string, string>, body?: string | null): Promise<{
+    nativeHttpRequest(requestId: string, method: string, url: string, headers: Record<string, string>, body?: string | null): Promise<{
         status: number;
         statusText: string;
         headers: {
@@ -11,6 +12,7 @@ declare class CrustModule extends NativeModule<CrustModuleEvents> {
         };
         body: string;
     }>;
+    cancelNativeHttpRequest(requestId: string): Promise<void>;
     hello(): string;
     showAVRoutePicker(_tintColor?: string | null): void;
     setDeferredSystemGestures(_edges: string[]): Promise<void>;

package/build/CrustModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrustModule.web.d.ts","sourceRoot":"","sources":["../src/CrustModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAC,MAAM,MAAM,CAAA;AAEpD,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAA;AAE/C,cAAM,WAAY,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACvD,EAAE,SAAU;IACN,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG3C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;;;;;;;;IAS1G,KAAK;IAGL,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IACtC,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1D,qBAAqB,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACrF,gBAAgB;IAGhB,gCAAgC;IAGhC,iCAAiC;IAGjC,2BAA2B;IAG3B,gCAAgC;IAGhC,WAAW;IAGX,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAGjE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAG3C,YAAY,CAAC,IAAI,EAAE,MAAM;IAGzB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAGxD,qBAAqB;IAGf,oBAAoB,CAAC,IAAI,EAAE,MAAM;IAGvC,0BAA0B;CAG3B;;AAED,wBAA4D"}
+{"version":3,"file":"CrustModule.web.d.ts","sourceRoot":"","sources":["../src/CrustModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAC,MAAM,MAAM,CAAA;AAEpD,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAA;AAE/C,cAAM,WAAY,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACvD,EAAE,SAAU;IACZ,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAC5D,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG3C,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;;;;;;;;IAevH,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,KAAK;IAGL,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IACtC,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1D,qBAAqB,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IACrF,gBAAgB;IAGhB,gCAAgC;IAGhC,iCAAiC;IAGjC,2BAA2B;IAG3B,gCAAgC;IAGhC,WAAW;IAGX,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAGjE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAG3C,YAAY,CAAC,IAAI,EAAE,MAAM;IAGzB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGhE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAGxD,qBAAqB;IAGf,oBAAoB,CAAC,IAAI,EAAE,MAAM;IAGvC,0BAA0B;CAG3B;;AAED,wBAA4D"}

package/build/CrustModule.web.js

@@ -1,17 +1,29 @@
 import { registerWebModule, NativeModule } from "expo";
 class CrustModule extends NativeModule {
     PI = Math.PI;
+    httpRequests = new Map();
     async setValueAsync(value) {
         this.emit("onChange", { value });
     }
-    async nativeHttpRequest(method, url, headers, body) {
-        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, method, url, headers, body) {
+        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) {
+        this.httpRequests.get(requestId)?.abort();
+        this.httpRequests.delete(requestId);
     }
     hello() {
         return "Hello world! 👋";

package/build/CrustModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"CrustModule.web.js","sourceRoot":"","sources":["../src/CrustModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAC,MAAM,MAAM,CAAA;AAIpD,MAAM,WAAY,SAAQ,YAA+B;IACvD,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;IACZ,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAC,KAAK,EAAC,CAAC,CAAA;IAChC,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,GAAW,EAAE,OAA+B,EAAE,IAAoB;QACxG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,CAAA;QAC1D,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACvD,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;SAC5B,CAAA;IACH,CAAC;IACD,KAAK;QACH,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IACD,iBAAiB,CAAC,UAA0B,IAAG,CAAC;IAChD,KAAK,CAAC,yBAAyB,CAAC,MAAgB,IAAkB,CAAC;IACnE,KAAK,CAAC,qBAAqB,CAAC,gBAAyB,EAAE,UAAoB,IAAkB,CAAC;IAC9F,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,KAAK,CAAC,gCAAgC;QACpC,OAAO,EAAE,CAAA;IACX,CAAC;IACD,KAAK,CAAC,iCAAiC;QACrC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,2BAA2B;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,gCAAgC;QACpC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,WAAW;QACf,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,SAAiB,EAAE,UAAkB;QACrE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,IAAY;QAC/C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,OAAM;IACR,CAAC;IACD,KAAK,CAAC,oBAAoB,CAAC,IAAY,EAAE,IAA6B;QACpE,OAAM;IACR,CAAC;IACD,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,MAAgB;QACtD,OAAM;IACR,CAAC;IACD,qBAAqB;QACnB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,KAAK,CAAC,oBAAoB,CAAC,IAAY;QACrC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,0BAA0B;QACxB,OAAO,EAAE,CAAA;IACX,CAAC;CACF;AAED,eAAe,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA","sourcesContent":["import {registerWebModule, NativeModule} from \"expo\"\n\nimport {CrustModuleEvents} from \"./Crust.types\"\n\nclass CrustModule extends NativeModule<CrustModuleEvents> {\n  PI = Math.PI\n  async setValueAsync(value: string): Promise<void> {\n    this.emit(\"onChange\", {value})\n  }\n  async nativeHttpRequest(method: string, url: string, headers: Record<string, string>, body?: string | null) {\n    const response = await fetch(url, {method, headers, body})\n    return {\n      status: response.status,\n      statusText: response.statusText,\n      headers: Object.fromEntries(response.headers.entries()),\n      body: await response.text(),\n    }\n  }\n  hello() {\n    return \"Hello world! 👋\"\n  }\n  showAVRoutePicker(_tintColor?: string | null) {}\n  async setDeferredSystemGestures(_edges: string[]): Promise<void> {}\n  async setNotificationConfig(_listenerEnabled: boolean, _blocklist: string[]): Promise<void> {}\n  async getInstalledApps() {\n    return []\n  }\n  async getInstalledAppsForNotifications() {\n    return []\n  }\n  async hasNotificationListenerPermission() {\n    return false\n  }\n  async refreshNotificationListener() {\n    return false\n  }\n  async openNotificationListenerSettings() {\n    return false\n  }\n  async isBetaBuild() {\n    return false\n  }\n  async mentraJsSpawn(_pkg: string, _polyfill: string, _miniappJs: string) {\n    return false\n  }\n  async mentraJsEvaluate(_pkg: string, _src: string) {\n    return null\n  }\n  async mentraJsKill(_pkg: string) {\n    return\n  }\n  async mentraJsDispatchToJs(_pkg: string, _env: Record<string, unknown>) {\n    return\n  }\n  async mentraJsSetManifest(_pkg: string, _perms: string[]) {\n    return\n  }\n  mentraJsAlivePackages() {\n    return []\n  }\n  async mentraJsDebugForceGC(_pkg: string) {\n    return false\n  }\n  mentraJsLoadPolyfillBundle() {\n    return \"\"\n  }\n}\n\nexport default registerWebModule(CrustModule, \"CrustModule\")\n"]}
+{"version":3,"file":"CrustModule.web.js","sourceRoot":"","sources":["../src/CrustModule.web.ts"],"names":[],"mappings":"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","sourcesContent":["import {registerWebModule, NativeModule} from \"expo\"\n\nimport {CrustModuleEvents} from \"./Crust.types\"\n\nclass CrustModule extends NativeModule<CrustModuleEvents> {\n  PI = Math.PI\n  private readonly httpRequests = new Map<string, AbortController>()\n  async setValueAsync(value: string): Promise<void> {\n    this.emit(\"onChange\", {value})\n  }\n  async nativeHttpRequest(requestId: string, method: string, url: string, headers: Record<string, string>, body?: string | null) {\n    const controller = new AbortController()\n    this.httpRequests.set(requestId, controller)\n    try {\n      const response = await fetch(url, {method, headers, body, signal: controller.signal})\n      return {\n        status: response.status,\n        statusText: response.statusText,\n        headers: Object.fromEntries(response.headers.entries()),\n        body: await response.text(),\n      }\n    } finally {\n      this.httpRequests.delete(requestId)\n    }\n  }\n  async cancelNativeHttpRequest(requestId: string): Promise<void> {\n    this.httpRequests.get(requestId)?.abort()\n    this.httpRequests.delete(requestId)\n  }\n  hello() {\n    return \"Hello world! 👋\"\n  }\n  showAVRoutePicker(_tintColor?: string | null) {}\n  async setDeferredSystemGestures(_edges: string[]): Promise<void> {}\n  async setNotificationConfig(_listenerEnabled: boolean, _blocklist: string[]): Promise<void> {}\n  async getInstalledApps() {\n    return []\n  }\n  async getInstalledAppsForNotifications() {\n    return []\n  }\n  async hasNotificationListenerPermission() {\n    return false\n  }\n  async refreshNotificationListener() {\n    return false\n  }\n  async openNotificationListenerSettings() {\n    return false\n  }\n  async isBetaBuild() {\n    return false\n  }\n  async mentraJsSpawn(_pkg: string, _polyfill: string, _miniappJs: string) {\n    return false\n  }\n  async mentraJsEvaluate(_pkg: string, _src: string) {\n    return null\n  }\n  async mentraJsKill(_pkg: string) {\n    return\n  }\n  async mentraJsDispatchToJs(_pkg: string, _env: Record<string, unknown>) {\n    return\n  }\n  async mentraJsSetManifest(_pkg: string, _perms: string[]) {\n    return\n  }\n  mentraJsAlivePackages() {\n    return []\n  }\n  async mentraJsDebugForceGC(_pkg: string) {\n    return false\n  }\n  mentraJsLoadPolyfillBundle() {\n    return \"\"\n  }\n}\n\nexport default registerWebModule(CrustModule, \"CrustModule\")\n"]}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export { default } from "./CrustModule";
 export { default as CrustView } from "./CrustView";
 export * from "./Crust.types";
+export { nativeHttpRequest } from "./nativeHttpRequest";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AACrC,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAA;AAChD,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AACrC,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAA;AAChD,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA"}

package/build/index.js

@@ -3,4 +3,5 @@
 export { default } from "./CrustModule";
 export { default as CrustView } from "./CrustView";
 export * from "./Crust.types";
+export { nativeHttpRequest } from "./nativeHttpRequest";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AACrC,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAA;AAChD,cAAc,eAAe,CAAA","sourcesContent":["// Reexport the native module. On web, it will be resolved to CrustModule.web.ts\n// and on native platforms to CrustModule.ts\nexport {default} from \"./CrustModule\"\nexport {default as CrustView} from \"./CrustView\"\nexport * from \"./Crust.types\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AACrC,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAA;AAChD,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAA","sourcesContent":["// Reexport the native module. On web, it will be resolved to CrustModule.web.ts\n// and on native platforms to CrustModule.ts\nexport {default} from \"./CrustModule\"\nexport {default as CrustView} from \"./CrustView\"\nexport * from \"./Crust.types\"\nexport {nativeHttpRequest} from \"./nativeHttpRequest\"\n"]}

package/build/nativeHttpRequest.d.ts

@@ -0,0 +1,13 @@
+export interface NativeHttpResult {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface NativeHttpTransport {
+    nativeHttpRequest(requestId: string, method: string, url: string, headers: Record<string, string>, body: string | null): Promise<NativeHttpResult>;
+    cancelNativeHttpRequest(requestId: string): Promise<void>;
+}
+/** Keep Android's background-safe HTTP path while cancelling its actual native request. */
+export declare function nativeHttpRequest(native: NativeHttpTransport, method: string, url: string, headers: Record<string, string>, body: string | null, signal?: AbortSignal): Promise<NativeHttpResult>;
+//# sourceMappingURL=nativeHttpRequest.d.ts.map

package/build/nativeHttpRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeHttpRequest.d.ts","sourceRoot":"","sources":["../src/nativeHttpRequest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5B,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAWD,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAsC3B"}

package/build/nativeHttpRequest.js

@@ -0,0 +1,51 @@
+let requestSequence = 0;
+function abortReason(signal) {
+    if (signal.reason !== undefined)
+        return signal.reason;
+    const error = new Error("Native HTTP request aborted");
+    error.name = "AbortError";
+    return error;
+}
+/** Keep Android's background-safe HTTP path while cancelling its actual native request. */
+export function nativeHttpRequest(native, method, url, headers, body, signal) {
+    if (signal?.aborted)
+        return Promise.reject(abortReason(signal));
+    const requestId = `http-${Date.now().toString(36)}-${++requestSequence}`;
+    // Start first, then subscribe: Expo delivers start and cancel on the same serial queue.
+    const request = native.nativeHttpRequest(requestId, method, url, headers, body);
+    if (!signal)
+        return request;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let cancelling = false;
+        const finish = (action) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            action();
+        };
+        const onAbort = () => {
+            if (settled || cancelling)
+                return;
+            cancelling = true;
+            void native.cancelNativeHttpRequest(requestId).then(() => finish(() => reject(abortReason(signal))), (error) => finish(() => reject(error)));
+        };
+        request.then((result) => {
+            if (signal.aborted)
+                onAbort();
+            else
+                finish(() => resolve(result));
+        }, (error) => {
+            if (signal.aborted)
+                onAbort();
+            else
+                finish(() => reject(error));
+        });
+        signal.addEventListener("abort", onAbort, { once: true });
+        // Handles an abort fired synchronously during native registration.
+        if (signal.aborted)
+            onAbort();
+    });
+}
+//# sourceMappingURL=nativeHttpRequest.js.map

package/build/nativeHttpRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeHttpRequest.js","sourceRoot":"","sources":["../src/nativeHttpRequest.ts"],"names":[],"mappings":"AAkBA,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,SAAS,WAAW,CAAC,MAAmB;IACtC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAA;IACrD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IACtD,KAAK,CAAC,IAAI,GAAG,YAAY,CAAA;IACzB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAC/B,MAA2B,EAC3B,MAAc,EACd,GAAW,EACX,OAA+B,EAC/B,IAAmB,EACnB,MAAoB;IAEpB,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,CAAA;IACxE,wFAAwF;IACxF,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC/E,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAA;IAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,UAAU,GAAG,KAAK,CAAA;QACtB,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAE;YACpC,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,EAAE,CAAA;QACV,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,OAAO,IAAI,UAAU;gBAAE,OAAM;YACjC,UAAU,GAAG,IAAI,CAAA;YACjB,KAAK,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,IAAI,CACjD,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAC/C,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAChD,CAAA;QACH,CAAC,CAAA;QACD,OAAO,CAAC,IAAI,CACV,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAA;;gBACxB,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;QACpC,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAA;;gBACxB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAClC,CAAC,CACF,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAA;QACvD,mEAAmE;QACnE,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["export interface NativeHttpResult {\n  status: number\n  statusText: string\n  headers: Record<string, string>\n  body: string\n}\n\nexport interface NativeHttpTransport {\n  nativeHttpRequest(\n    requestId: string,\n    method: string,\n    url: string,\n    headers: Record<string, string>,\n    body: string | null,\n  ): Promise<NativeHttpResult>\n  cancelNativeHttpRequest(requestId: string): Promise<void>\n}\n\nlet requestSequence = 0\n\nfunction abortReason(signal: AbortSignal): unknown {\n  if (signal.reason !== undefined) return signal.reason\n  const error = new Error(\"Native HTTP request aborted\")\n  error.name = \"AbortError\"\n  return error\n}\n\n/** Keep Android's background-safe HTTP path while cancelling its actual native request. */\nexport function nativeHttpRequest(\n  native: NativeHttpTransport,\n  method: string,\n  url: string,\n  headers: Record<string, string>,\n  body: string | null,\n  signal?: AbortSignal,\n): Promise<NativeHttpResult> {\n  if (signal?.aborted) return Promise.reject(abortReason(signal))\n  const requestId = `http-${Date.now().toString(36)}-${++requestSequence}`\n  // Start first, then subscribe: Expo delivers start and cancel on the same serial queue.\n  const request = native.nativeHttpRequest(requestId, method, url, headers, body)\n  if (!signal) return request\n\n  return new Promise((resolve, reject) => {\n    let settled = false\n    let cancelling = false\n    const finish = (action: () => void) => {\n      if (settled) return\n      settled = true\n      signal.removeEventListener(\"abort\", onAbort)\n      action()\n    }\n    const onAbort = () => {\n      if (settled || cancelling) return\n      cancelling = true\n      void native.cancelNativeHttpRequest(requestId).then(\n        () => finish(() => reject(abortReason(signal))),\n        (error: unknown) => finish(() => reject(error)),\n      )\n    }\n    request.then(\n      (result) => {\n        if (signal.aborted) onAbort()\n        else finish(() => resolve(result))\n      },\n      (error: unknown) => {\n        if (signal.aborted) onAbort()\n        else finish(() => reject(error))\n      },\n    )\n    signal.addEventListener(\"abort\", onAbort, {once: true})\n    // Handles an abort fired synchronously during native registration.\n    if (signal.aborted) onAbort()\n  })\n}\n"]}

package/build/nativeHttpRequest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nativeHttpRequest.test.d.ts.map

package/build/nativeHttpRequest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeHttpRequest.test.d.ts","sourceRoot":"","sources":["../src/nativeHttpRequest.test.ts"],"names":[],"mappings":""}

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/package.json

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

package/src/CrustModule.ts

@@ -11,11 +11,13 @@ declare class CrustModule extends NativeModule<CrustModuleEvents> {
   /** 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()
+  })
+})

package/src/nativeHttpRequest.ts

@@ -0,0 +1,74 @@
+export interface NativeHttpResult {
+  status: number
+  statusText: string
+  headers: Record<string, string>
+  body: string
+}
+
+export interface NativeHttpTransport {
+  nativeHttpRequest(
+    requestId: string,
+    method: string,
+    url: string,
+    headers: Record<string, string>,
+    body: string | null,
+  ): Promise<NativeHttpResult>
+  cancelNativeHttpRequest(requestId: string): Promise<void>
+}
+
+let requestSequence = 0
+
+function abortReason(signal: AbortSignal): unknown {
+  if (signal.reason !== undefined) return signal.reason
+  const error = new Error("Native HTTP request aborted")
+  error.name = "AbortError"
+  return error
+}
+
+/** Keep Android's background-safe HTTP path while cancelling its actual native request. */
+export function nativeHttpRequest(
+  native: NativeHttpTransport,
+  method: string,
+  url: string,
+  headers: Record<string, string>,
+  body: string | null,
+  signal?: AbortSignal,
+): Promise<NativeHttpResult> {
+  if (signal?.aborted) return Promise.reject(abortReason(signal))
+  const requestId = `http-${Date.now().toString(36)}-${++requestSequence}`
+  // Start first, then subscribe: Expo delivers start and cancel on the same serial queue.
+  const request = native.nativeHttpRequest(requestId, method, url, headers, body)
+  if (!signal) return request
+
+  return new Promise((resolve, reject) => {
+    let settled = false
+    let cancelling = false
+    const finish = (action: () => void) => {
+      if (settled) return
+      settled = true
+      signal.removeEventListener("abort", onAbort)
+      action()
+    }
+    const onAbort = () => {
+      if (settled || cancelling) return
+      cancelling = true
+      void native.cancelNativeHttpRequest(requestId).then(
+        () => finish(() => reject(abortReason(signal))),
+        (error: unknown) => finish(() => reject(error)),
+      )
+    }
+    request.then(
+      (result) => {
+        if (signal.aborted) onAbort()
+        else finish(() => resolve(result))
+      },
+      (error: unknown) => {
+        if (signal.aborted) onAbort()
+        else finish(() => reject(error))
+      },
+    )
+    signal.addEventListener("abort", onAbort, {once: true})
+    // Handles an abort fired synchronously during native registration.
+    if (signal.aborted) onAbort()
+  })
+}