@mentra/crust 3.2.1 → 3.3.0-beta.1000

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/ios/Crust.podspec

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

package/ios/CrustModule.swift

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

package/ios/PermissionStatusReceipt.swift

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