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

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/android/src/test/java/com/mentra/crust/jsc/FetchBridgeTest.kt

@@ -0,0 +1,199 @@
+package com.mentra.crust.jsc
+
+import java.io.File
+import java.util.concurrent.LinkedBlockingQueue
+import java.util.concurrent.TimeUnit
+import kotlin.math.PI
+import kotlin.math.roundToInt
+import kotlin.math.sin
+import okhttp3.MediaType.Companion.toMediaType
+import okhttp3.Protocol
+import okhttp3.Request
+import okhttp3.Response
+import okhttp3.ResponseBody.Companion.toResponseBody
+import okhttp3.mockwebserver.Dispatcher
+import okhttp3.mockwebserver.MockResponse
+import okhttp3.mockwebserver.MockWebServer
+import okhttp3.mockwebserver.RecordedRequest
+import okio.Buffer
+import okio.ByteString.Companion.decodeBase64
+import org.junit.After
+import org.junit.Assert.*
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.RuntimeEnvironment
+import org.robolectric.annotation.Config
+
+/**
+ * Miniapp `fetch` end to end on Android's real stack: the shipped startup.js
+ * polyfill in QuickJS, [JSCRuntime]'s dispatcher and `__deliver` path, this
+ * bridge, and OkHttp against a local server. Each miniapp script reports
+ * through a `test` dispatch, which the runtime forwards to `onOutbound`.
+ */
+@RunWith(RobolectricTestRunner::class)
+@Config(sdk = [28], manifest = Config.NONE)
+class FetchBridgeTest {
+    private val packageName = "com.mentra.fetchtest"
+    private val results = LinkedBlockingQueue<Map<*, *>>()
+    private lateinit var server: MockWebServer
+    private lateinit var runtime: JSCRuntime
+
+    /** A 24 kHz 16-bit sine followed by every byte value: mostly not valid UTF-8. */
+    private val pcm = ByteArray(4800 * 2 + 256).also { out ->
+        for (i in 0 until 4800) {
+            val sample = (sin(2 * PI * 220 * i / 24000) * 20000).roundToInt()
+            out[2 * i] = sample.toByte()
+            out[2 * i + 1] = (sample shr 8).toByte()
+        }
+        for (value in 0 until 256) out[9600 + value] = value.toByte()
+    }
+
+    /** Valid UTF-8 that is still binary data: a BOM, NUL and DEL must all survive. */
+    private val utf8Bytes = byteArrayOf(0xEF.toByte(), 0xBB.toByte(), 0xBF.toByte()) +
+        "{\"a\":\"é😀\"}".toByteArray(Charsets.UTF_8) + byteArrayOf(0x00, 0x7F)
+
+    // crust's build.gradle ships this file as the runtime's startup.js asset.
+    private val polyfill: String by lazy { File("../../jspolyfill/assets/startup.js").readText() }
+
+    @Before fun setUp() {
+        server = MockWebServer().apply {
+            dispatcher = object : Dispatcher() {
+                override fun dispatch(request: RecordedRequest): MockResponse = when (request.path) {
+                    "/reply.pcm" -> response("application/octet-stream").setBody(Buffer().write(pcm))
+                    "/utf8.bin" -> response("application/octet-stream").setBody(Buffer().write(utf8Bytes))
+                    "/data.json" -> response("application/json").setBody("{\"message\":\"héllo 😀 中文\"}")
+                    "/upload" -> response("text/plain").setBody("ok")
+                    else -> MockResponse().setResponseCode(404)
+                }
+            }
+            start()
+        }
+        runtime = JSCRuntime.shared(RuntimeEnvironment.getApplication())
+        JSCPolyfillBridge.install(runtime)
+        runtime.onOutbound = { message ->
+            if (message.payload["iface"] == "test") {
+                results.add((message.payload["args"] as List<*>).first() as Map<*, *>)
+            }
+        }
+    }
+
+    @After fun tearDown() {
+        runtime.kill(packageName)
+        runtime.onOutbound = null
+        server.shutdown()
+    }
+
+    @Test fun `arrayBuffer returns the exact bytes of a binary response`() {
+        val result = runMiniapp(
+            """
+            const response = await fetch(BASE + "/reply.pcm")
+            const bytes = new Uint8Array(await response.arrayBuffer())
+            return {status: response.status, type: response.headers.get("content-type"), bytes: Array.from(bytes)}
+            """,
+        )
+        assertEquals(200, result["status"])
+        assertEquals("application/octet-stream", result["type"])
+        assertArrayEquals(pcm, bytes(result["bytes"]))
+    }
+
+    @Test fun `arrayBuffer returns the exact bytes of a body that is valid UTF-8`() {
+        val result = runMiniapp(
+            """
+            const response = await fetch(BASE + "/utf8.bin")
+            return {bytes: Array.from(new Uint8Array(await response.arrayBuffer()))}
+            """,
+        )
+        assertArrayEquals(utf8Bytes, bytes(result["bytes"]))
+    }
+
+    @Test fun `responses are sent as text only when that text re-encodes to the same bytes`() {
+        val text = JSCPolyfillBridge.fetchResult(responseWith(utf8Bytes))
+        assertEquals(String(utf8Bytes, Charsets.UTF_8), text.getString("body"))
+        assertFalse(text.has("bodyBase64"))
+
+        val empty = JSCPolyfillBridge.fetchResult(responseWith(ByteArray(0)))
+        assertEquals("", empty.getString("body"))
+
+        // Truncated, overlong, surrogate and out-of-range sequences, then raw PCM.
+        for (binary in listOf(byteArrayOf(0x41, 0xE2.toByte(), 0x82.toByte()), byteArrayOf(0xC0.toByte(), 0x80.toByte()),
+            byteArrayOf(0xED.toByte(), 0xA0.toByte(), 0x80.toByte()), byteArrayOf(0xF4.toByte(), 0x90.toByte(), 0x80.toByte(), 0x80.toByte()), pcm)) {
+            val result = JSCPolyfillBridge.fetchResult(responseWith(binary))
+            assertFalse(result.has("body"))
+            assertArrayEquals(binary, result.getString("bodyBase64").decodeBase64()!!.toByteArray())
+        }
+    }
+
+    @Test fun `text and json decode a UTF-8 response`() {
+        val result = runMiniapp(
+            """
+            const text = await (await fetch(BASE + "/data.json")).text()
+            const json = await (await fetch(BASE + "/data.json")).json()
+            return {text, message: json.message}
+            """,
+        )
+        assertEquals("{\"message\":\"héllo 😀 中文\"}", result["text"])
+        assertEquals("héllo 😀 中文", result["message"])
+    }
+
+    @Test fun `binary request bodies reach the server byte for byte`() {
+        val result = runMiniapp(
+            """
+            const backing = Uint8Array.from({length: 600}, (_, i) => (i * 37 + 11) & 255)
+            const response = await fetch(BASE + "/upload", {
+              method: "POST",
+              headers: {"Content-Type": "audio/L16; rate=24000"},
+              body: backing.subarray(44),
+            })
+            return {status: response.status, text: await response.text()}
+            """,
+        )
+        assertEquals(200, result["status"])
+        assertEquals("ok", result["text"])
+        val upload = server.takeRequest()
+        val expected = ByteArray(600) { ((it * 37 + 11) and 255).toByte() }.copyOfRange(44, 600)
+        assertArrayEquals(expected, upload.body.readByteArray())
+        assertEquals("audio/L16; rate=24000", upload.getHeader("Content-Type"))
+    }
+
+    @Test fun `string request bodies keep their UTF-8 text and content type`() {
+        runMiniapp(
+            """
+            await fetch(BASE + "/upload", {method: "POST", headers: {"Content-Type": "application/json"}, body: '{"t":"é😀"}'})
+            return {}
+            """,
+        )
+        val upload = server.takeRequest()
+        assertEquals("{\"t\":\"é😀\"}", upload.body.readUtf8())
+        assertEquals("application/json; charset=utf-8", upload.getHeader("Content-Type"))
+    }
+
+    private fun runMiniapp(body: String): Map<*, *> {
+        val script =
+            """
+            const BASE = "${server.url("/").toString().removeSuffix("/")}"
+            const report = (value) => __mentraSendOneShot("test", "result", [value])
+            ;(async () => {
+              $body
+            })().then(report, (error) => report({error: String(error && (error.message || error))}))
+            """.trimIndent()
+        assertTrue("spawn failed", runtime.spawn(packageName, polyfill, script))
+        val result = results.poll(15, TimeUnit.SECONDS) ?: throw AssertionError("miniapp did not report a result")
+        assertNull("miniapp script threw", result["error"])
+        return result
+    }
+
+    private fun bytes(value: Any?): ByteArray =
+        (value as List<*>).map { (it as Number).toInt().toByte() }.toByteArray()
+
+    private fun response(contentType: String) = MockResponse().setHeader("Content-Type", contentType)
+
+    private fun responseWith(body: ByteArray): Response = Response.Builder()
+        .request(Request.Builder().url("https://example.com/body").build())
+        .protocol(Protocol.HTTP_1_1)
+        .code(200)
+        .message("OK")
+        .body(body.toResponseBody("application/octet-stream".toMediaType()))
+        .build()
+}

package/android/src/test/java/com/mentra/crust/jsc/HttpRequestTest.kt

@@ -0,0 +1,32 @@
+package com.mentra.crust.jsc
+
+import okhttp3.Request
+import okio.Buffer
+import org.junit.Assert.*
+import org.junit.Test
+
+class HttpRequestTest {
+    private fun request(method: String, body: String? = null): Request =
+        JSCPolyfillBridge.buildHttpRequest(method, "https://example.com/stream", mapOf("Content-Type" to "application/json"), body)
+
+    @Test fun `bodyless post put and patch produce valid zero byte requests`() {
+        for (method in listOf("post", "PUT", "PATCH")) for (body in listOf(null, "")) {
+            val request = request(method, body)
+            assertEquals(method.uppercase(), request.method)
+            assertNotNull(request.body)
+            assertEquals(0L, request.body!!.contentLength())
+        }
+    }
+
+    @Test fun `get head and delete can omit a body`() {
+        for (method in listOf("GET", "HEAD", "DELETE")) assertNull(request(method).body)
+    }
+
+    @Test fun `nonempty body and content type survive request construction`() {
+        val request = request("POST", "{\"status\":\"stopped\"}")
+        val buffer = Buffer()
+        request.body!!.writeTo(buffer)
+        assertEquals("{\"status\":\"stopped\"}", buffer.readUtf8())
+        assertEquals("application/json; charset=utf-8", request.body!!.contentType().toString())
+    }
+}

package/android/src/test/java/com/mentra/crust/jsc/JSDeliveryDiagnosticsTest.kt

@@ -0,0 +1,54 @@
+package com.mentra.crust.jsc
+
+import org.junit.Assert.*
+import org.junit.Test
+
+class JSDeliveryDiagnosticsTest {
+    @Test fun `queue wait and evaluate duration are distinct`() {
+        var now = 100L
+        val events = mutableListOf<Map<String, Any?>>()
+        val diagnostic = JSDeliveryDiagnostics(7, 2, { now }, { events += it })
+        diagnostic.entry()
+        now = 110
+        diagnostic.queued()
+        now = 310
+        diagnostic.started()
+        now = 350
+        diagnostic.finished()
+
+        assertEquals(listOf("native-entry", "queued", "started", "finished"), events.map { it["phase"] })
+        assertEquals(200L, events.last()["queueWaitMs"])
+        assertEquals(40L, events.last()["evaluateMs"])
+        assertEquals(250L, events.last()["elapsedMs"])
+        assertEquals(7L, events.last()["deliveryId"])
+        assertEquals(2L, events.last()["contextId"])
+    }
+
+    @Test fun `failure includes exception identity without payload or message`() {
+        val events = mutableListOf<Map<String, Any?>>()
+        val diagnostic = JSDeliveryDiagnostics(1, 4, { 0L }, { events += it })
+        val error = IllegalStateException("private-token user transcript", IllegalArgumentException("private-source"))
+        diagnostic.entry()
+        diagnostic.queued()
+        diagnostic.started()
+        diagnostic.finished(error)
+
+        assertEquals("evaluate-failed", events.last()["phase"])
+        assertEquals("IllegalStateException", events.last()["errorClass"])
+        assertEquals("IllegalArgumentException", events.last()["causeClass"])
+        assertFalse(events.toString().contains("private-"))
+        assertFalse(events.toString().contains("transcript"))
+    }
+
+    @Test fun `missing context and rejected executor have explicit terminal events`() {
+        for (reason in listOf("context-missing", "executor-rejected")) {
+            val events = mutableListOf<Map<String, Any?>>()
+            val diagnostic = JSDeliveryDiagnostics(9, null, { 0L }, { events += it })
+            diagnostic.entry()
+            diagnostic.dropped(reason)
+            assertEquals(reason, events.last()["phase"])
+            assertNull(events.last()["contextId"])
+            assertNull(events.last()["evaluateMs"])
+        }
+    }
+}

package/android/src/test/java/com/mentra/crust/jsc/QuickJsLifecycleTest.kt

@@ -0,0 +1,87 @@
+package com.mentra.crust.jsc
+
+import com.dokar.quickjs.QuickJs
+import com.dokar.quickjs.QuickJsException
+import com.dokar.quickjs.binding.function
+import java.util.concurrent.Executors
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.withTimeout
+import org.junit.Assert.*
+import org.junit.Test
+
+/**
+ * Runs the real QuickJS JNI library (through the desktop JVM artifact, see
+ * build.gradle) the way [JSCRuntime] uses it: one instance per miniapp, Kotlin
+ * bindings called from JS, and independent close orders.
+ */
+class QuickJsLifecycleTest {
+    private fun create() = QuickJs.create(Dispatchers.Unconfined)
+
+    @Test fun `closing one instance keeps another instance's callbacks working`() = runBlocking {
+        var calls = 0
+        val survivor = create()
+        survivor.function("hostCallback") { calls++; 42 }
+        val other = create()
+        assertEquals(42, survivor.evaluate<Int>("hostCallback()"))
+        other.close()
+        withTimeout(1000) { assertEquals(42, survivor.evaluate<Int>("hostCallback()")) }
+        assertEquals(2, calls)
+        repeat(20) {
+            create().close()
+            assertEquals(42, survivor.evaluate<Int>("hostCallback()"))
+        }
+        val workers = Executors.newFixedThreadPool(4)
+        try {
+            (1..40).map { workers.submit { create().close() } }.forEach { it.get() }
+            assertEquals(42, survivor.evaluate<Int>("hostCallback()"))
+        } finally {
+            workers.shutdownNow()
+        }
+        survivor.close()
+        val fresh = create()
+        fresh.function("hostCallback") { 7 }
+        assertEquals(7, fresh.evaluate<Int>("hostCallback()"))
+        fresh.close()
+        val older = create()
+        val newer = create()
+        newer.function("hostCallback") { 9 }
+        older.close()
+        assertEquals(9, newer.evaluate<Int>("hostCallback()"))
+        newer.close()
+    }
+
+    @Test fun `a binding exception is a catchable JS Error carrying the message`() = runBlocking {
+        val qjs = create()
+        qjs.function("__dispatch") { throw MentraJSDispatchError("INVALID_ARGS", "iface") }
+        val caught = qjs.evaluate<String>(
+            "try { __dispatch(); 'no throw' } catch (e) { (e instanceof Error) + '|' + e.message }",
+        )
+        assertEquals("true|INVALID_ARGS: iface", caught)
+        qjs.close()
+    }
+
+    @Test fun `non-ASCII strings cross the bridge unchanged`() = runBlocking {
+        val text = "héllo 😀 中文 \u0000 end"
+        var received: String? = null
+        val qjs = create()
+        qjs.function("hostText") { text }
+        qjs.function("hostEcho") { args -> received = args[0] as String; args[0] }
+        assertEquals(text, qjs.evaluate<String>("hostEcho(hostText())"))
+        assertEquals(text, received)
+        qjs.close()
+    }
+
+    @Test fun `unusual thrown values fail as exceptions, not crashes`() = runBlocking {
+        val qjs = create()
+        for (source in listOf("throw undefined", "throw null", "throw new Error('%s%n%s%n')")) {
+            try {
+                qjs.evaluate<Any?>(source)
+                fail("$source did not throw")
+            } catch (_: QuickJsException) {
+            }
+            assertEquals(2, qjs.evaluate<Int>("1 + 1"))
+        }
+        qjs.close()
+    }
+}

package/android/src/test/java/com/mentra/crust/navigation/NavigationSessionGuardTest.kt

@@ -0,0 +1,68 @@
+package com.mentra.crust.navigation
+
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class NavigationSessionGuardTest {
+  @Test
+  fun cachedCallbacksAreRejectedUntilTheCurrentInitialRouteIsReady() {
+    val guard = NavigationSessionGuard()
+    val session = guard.begin()
+
+    assertTrue(guard.acceptsCallback(session))
+    assertFalse(guard.acceptsLocation(session))
+    assertFalse(guard.acceptRouteUpdate(session, "cached-route"))
+    assertFalse(guard.acceptsProgress(session, "cached-route"))
+
+    assertTrue(guard.activateInitialRoute(session, "current-route"))
+    assertTrue(guard.acceptsProgress(session, "current-route"))
+
+    guard.enableLocationCallbacks(session)
+    assertTrue(guard.acceptsLocation(session))
+  }
+
+  @Test
+  fun stoppedAndSupersededSessionsCannotMutateCurrentState() {
+    val guard = NavigationSessionGuard()
+    val oldSession = guard.begin()
+    assertTrue(guard.activateInitialRoute(oldSession, "old-route"))
+
+    guard.invalidate()
+    assertFalse(guard.acceptsCallback(oldSession))
+    guard.enableLocationCallbacks(oldSession)
+    assertFalse(guard.acceptsLocation(oldSession))
+    assertFalse(guard.activateInitialRoute(oldSession, "late-route"))
+    assertFalse(guard.acceptRouteUpdate(oldSession, "late-reroute"))
+    assertFalse(guard.acceptsProgress(oldSession, "old-route"))
+
+    val currentSession = guard.begin()
+    assertTrue(guard.activateInitialRoute(currentSession, "current-route"))
+    assertTrue(guard.acceptsProgress(currentSession, "current-route"))
+  }
+
+  @Test
+  fun rerouteMovesProgressIdentityToTheNewRoute() {
+    val guard = NavigationSessionGuard()
+    val session = guard.begin()
+    assertTrue(guard.activateInitialRoute(session, "initial-route"))
+
+    assertTrue(guard.acceptRouteUpdate(session, "rerouted-route"))
+    assertFalse(guard.acceptsProgress(session, "initial-route"))
+    assertTrue(guard.acceptsProgress(session, "rerouted-route"))
+  }
+
+  @Test
+  fun delayedWorkCapturedBeforeStopCannotRunInTheNextSession() {
+    val guard = NavigationSessionGuard()
+    val oldWork = guard.begin()
+    assertTrue(guard.captureActive() == oldWork)
+
+    guard.invalidate()
+    assertTrue(guard.captureActive() == null)
+    val nextSession = guard.begin()
+
+    assertFalse(guard.acceptsCallback(oldWork))
+    assertTrue(guard.acceptsCallback(nextSession))
+  }
+}

package/build/Crust.types.d.ts

@@ -14,7 +14,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 = {
     /** Approximate perpendicular distance in meters from the route. */
@@ -107,6 +106,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 = {
     packageName: string;
@@ -133,16 +134,6 @@ export type PhoneNotificationDismissedEvent = {
     packageName: string;
     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: {
@@ -150,4 +141,27 @@ export type CrustViewProps = {
     }) => 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;
+};
 //# sourceMappingURL=Crust.types.d.ts.map

package/build/Crust.types.d.ts.map

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