@mentra/miniapp 0.3.0-beta.0

package/dist/transport/mock.js

@@ -0,0 +1,207 @@
+/**
+ * @fileoverview MockTransport — browser-tab fallback so the SDK doesn't hang.
+ *
+ * Activates when:
+ *   - `window.ReactNativeWebView` is undefined (not in MentraOS WebView), AND
+ *   - The first LocalSocketTransport connection attempt fails fast, OR
+ *   - The author opts in via `?mentra=mock` query param / `localStorage.MENTRA_MOCK = "1"`.
+ *
+ * Behaviors:
+ *   - On `open()`: synthesize a CONNECT_ACK envelope so `session.connect()` resolves.
+ *   - On `send(envelope)`: parse, log to console with `[mock-transport]` prefix,
+ *     auto-reply with synthetic results for any request that needs one.
+ *   - Does NOT emit any glasses events. Subscribing succeeds silently.
+ *
+ * This is the Stage-1 stopgap from `agents/miniapp-quick-fixes-spec.md` #6.
+ * The full simulator (event injection, glasses-display preview, hardware bridge)
+ * is Stage 2 — see `agents/miniapp-browser-testing-simulator-spec.md`.
+ */
+import { parseEnvelope, serializeEnvelope } from "../envelope";
+import { MiniappRequestType, MiniappResponseType } from "../protocol";
+const LOG_PREFIX = "[mock-transport]";
+/**
+ * Returns true if the current environment requested the mock transport
+ * explicitly. Checks `?mentra=mock` query param and `localStorage.MENTRA_MOCK`.
+ */
+export function isMockExplicitlyRequested() {
+    if (typeof window === "undefined")
+        return false;
+    try {
+        if (typeof window.location !== "undefined" && window.location.search) {
+            const params = new URLSearchParams(window.location.search);
+            if (params.get("mentra") === "mock")
+                return true;
+        }
+    }
+    catch {
+        // ignore
+    }
+    try {
+        if (typeof localStorage !== "undefined" && localStorage.getItem("MENTRA_MOCK") === "1") {
+            return true;
+        }
+    }
+    catch {
+        // localStorage may throw in some embedded contexts; ignore
+    }
+    return false;
+}
+export class MockTransport {
+    constructor(options = {}) {
+        this.messageHandler = null;
+        this.disconnectHandler = null;
+        this.open_ = false;
+        this.userId = options.userId ?? "mock-user";
+        this.authToken = options.authToken ?? "mock-miniapp-token";
+        this.packageName = options.packageName ?? null;
+        this.silent = options.silent === true;
+    }
+    async open() {
+        if (this.open_)
+            return;
+        this.open_ = true;
+        this.log("transport opened (no real host; synthetic responses only)");
+    }
+    send(raw) {
+        if (!this.open_) {
+            throw new Error("MockTransport: send() before open()");
+        }
+        const envelope = parseEnvelope(raw);
+        if (!envelope) {
+            this.log("dropped unparseable envelope:", raw.slice(0, 200));
+            return;
+        }
+        const payload = envelope.payload;
+        const type = payload?.type;
+        this.log(`recv ${type ?? "<unknown>"}${envelope.requestId ? ` (rid=${envelope.requestId})` : ""}`);
+        // Handle the protocol's synchronous handshake/responses.
+        switch (type) {
+            case MiniappRequestType.CONNECT:
+                this.deliverConnectAck(payload);
+                return;
+            case MiniappRequestType.PING:
+                // Real phone sends PING. We never do — but if app code somehow does,
+                // ignore it. The SDK auto-replies to inbound PINGs, not vice versa.
+                return;
+            case MiniappRequestType.SUBSCRIBE:
+                // Subscribe is fire-and-forget; no response expected. Stage 1 emits no
+                // events. Future Stage 2 simulator can synthesize events here.
+                return;
+            default:
+                // Anything that has a requestId expects a REQUEST_RESULT. Reply with a
+                // synthetic empty success so app code that awaits the promise resolves.
+                if (envelope.requestId) {
+                    this.deliverSyntheticResult(envelope.requestId, type ?? "<unknown>", payload);
+                }
+                return;
+        }
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onDisconnect(handler) {
+        this.disconnectHandler = handler;
+    }
+    close() {
+        if (!this.open_)
+            return;
+        this.open_ = false;
+        this.disconnectHandler?.("MockTransport.close()");
+    }
+    isOpen() {
+        return this.open_;
+    }
+    // ---------------------------------------------------------------------------
+    deliverConnectAck(connectPayload) {
+        const incomingPackage = connectPayload.packageName ?? this.packageName ?? "com.mock.app";
+        const ackPayload = {
+            type: MiniappResponseType.CONNECT_ACK,
+            userId: this.userId,
+            packageName: incomingPackage,
+            capabilities: null,
+            visibility: "foreground",
+            colorScheme: "light",
+            auth: {
+                mentraUserId: this.userId,
+                oemId: "mock",
+                token: this.authToken,
+                expiresAt: Date.now() + 60 * 60 * 1000,
+            },
+        };
+        const envelope = { payload: ackPayload };
+        this.log(`-> CONNECT_ACK userId=${this.userId} pkg=${incomingPackage}`);
+        // Deliver asynchronously so it doesn't fire during the same tick as send().
+        queueMicrotask(() => this.messageHandler?.(serializeEnvelope(envelope)));
+    }
+    deliverSyntheticResult(requestId, requestType, requestPayload) {
+        const data = syntheticDataFor(requestId, requestType, requestPayload);
+        const responsePayload = {
+            type: MiniappResponseType.REQUEST_RESULT,
+            ok: true,
+            data,
+        };
+        const envelope = { payload: responsePayload, requestId };
+        this.log(`-> REQUEST_RESULT (rid=${requestId}) synthetic ${requestType}`);
+        queueMicrotask(() => this.messageHandler?.(serializeEnvelope(envelope)));
+    }
+    log(...args) {
+        if (this.silent)
+            return;
+        console.log(LOG_PREFIX, ...args);
+    }
+}
+/**
+ * Synthetic payload for an unrecognized request that nonetheless awaits a
+ * REQUEST_RESULT. Returns enough shape to satisfy callers without crashing.
+ */
+function syntheticDataFor(requestId, requestType, requestPayload) {
+    switch (requestType) {
+        case MiniappRequestType.CAMERA_FOV: {
+            const presetFov = requestPayload.preset === "narrow"
+                ? 82
+                : requestPayload.preset === "wide"
+                    ? 118
+                    : requestPayload.preset === "standard"
+                        ? 102
+                        : undefined;
+            const fov = typeof requestPayload.fov === "number" ? requestPayload.fov : (presetFov ?? 102);
+            const roi = requestPayload.roiPosition;
+            const roiPosition = roi === "bottom" ? "bottom" : roi === "top" ? "top" : "center";
+            return {
+                requestId,
+                fov,
+                roiPosition,
+                timestamp: Date.now(),
+            };
+        }
+        case MiniappRequestType.PHOTO:
+            // 1×1 transparent PNG so consumers that try to render don't 404.
+            return {
+                photoUrl: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkAAIAAAoAAv/lxKUAAAAASUVORK5CYII=",
+                requestId: "mock-photo",
+            };
+        case MiniappRequestType.RGB_LED:
+            return { type: "rgb_led_control_response", state: "success", requestId };
+        case MiniappRequestType.LOCATION_POLL:
+            // San Francisco fallback — using 0,0 puts dev sessions in the
+            // Atlantic, which makes maps/navigation unusable in the WebView.
+            return { lat: 37.7956, lng: -122.3933, accuracy: 0, timestamp: Date.now() };
+        case MiniappRequestType.CALENDAR_LIST_EVENTS:
+            return { events: [], truncated: false };
+        case MiniappRequestType.STORAGE_GET:
+            return { value: null };
+        case MiniappRequestType.STORAGE_LIST:
+            return { keys: [] };
+        case MiniappRequestType.SPEAK:
+            return { audioUrl: null, durationMs: 0 };
+        case MiniappRequestType.SHARE:
+        case MiniappRequestType.OPEN_URL:
+        case MiniappRequestType.COPY_CLIPBOARD:
+        case MiniappRequestType.DOWNLOAD:
+        case MiniappRequestType.REQUEST_WIFI_SETUP:
+            return { ok: true };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/transport/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../src/transport/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAC,aAAa,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAA;AAClF,OAAO,EAAC,kBAAkB,EAAE,mBAAmB,EAAC,MAAM,aAAa,CAAA;AAGnE,MAAM,UAAU,GAAG,kBAAkB,CAAA;AAErC;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAC/C,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC1D,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAA;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,IAAI,CAAC;QACH,IAAI,OAAO,YAAY,KAAK,WAAW,IAAI,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,GAAG,EAAE,CAAC;YACvF,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAaD,MAAM,OAAO,aAAa;IASxB,YAAY,UAAgC,EAAE;QARtC,mBAAc,GAAmC,IAAI,CAAA;QACrD,sBAAiB,GAAsC,IAAI,CAAA;QAC3D,UAAK,GAAG,KAAK,CAAA;QAOnB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAA;QAC3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,oBAAoB,CAAA;QAC1D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAA;QAC9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACxD,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,+BAA+B,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAoD,CAAA;QAC7E,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,CAAA;QAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAElG,yDAAyD;QACzD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,kBAAkB,CAAC,OAAO;gBAC7B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA;gBAC/B,OAAM;YAER,KAAK,kBAAkB,CAAC,IAAI;gBAC1B,qEAAqE;gBACrE,oEAAoE;gBACpE,OAAM;YAER,KAAK,kBAAkB,CAAC,SAAS;gBAC/B,uEAAuE;gBACvE,+DAA+D;gBAC/D,OAAM;YAER;gBACE,uEAAuE;gBACvE,wEAAwE;gBACxE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;oBACvB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,WAAW,EAAE,OAAO,CAAC,CAAA;gBAC/E,CAAC;gBACD,OAAM;QACV,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAAgC;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAA;IAC/B,CAAC;IAED,YAAY,CAAC,OAAmC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAM;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC,uBAAuB,CAAC,CAAA;IACnD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,8EAA8E;IAEtE,iBAAiB,CAAC,cAAuC;QAC/D,MAAM,eAAe,GAAI,cAAc,CAAC,WAAkC,IAAI,IAAI,CAAC,WAAW,IAAI,cAAc,CAAA;QAChH,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,mBAAmB,CAAC,WAAW;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,eAAe;YAC5B,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,YAAY;YACxB,WAAW,EAAE,OAAO;YACpB,IAAI,EAAE;gBACJ,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;aACvC;SACF,CAAA;QACD,MAAM,QAAQ,GAAoB,EAAC,OAAO,EAAE,UAAU,EAAC,CAAA;QACvD,IAAI,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,MAAM,QAAQ,eAAe,EAAE,CAAC,CAAA;QACvE,4EAA4E;QAC5E,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC1E,CAAC;IAEO,sBAAsB,CAC5B,SAAiB,EACjB,WAAmB,EACnB,cAAuC;QAEvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC,CAAA;QACrE,MAAM,eAAe,GAAG;YACtB,IAAI,EAAE,mBAAmB,CAAC,cAAc;YACxC,EAAE,EAAE,IAAI;YACR,IAAI;SACL,CAAA;QACD,MAAM,QAAQ,GAAoB,EAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAC,CAAA;QACvE,IAAI,CAAC,GAAG,CAAC,0BAA0B,SAAS,eAAe,WAAW,EAAE,CAAC,CAAA;QACzE,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC1E,CAAC;IAEO,GAAG,CAAC,GAAG,IAAe;QAC5B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QAEvB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAA;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,SAAiB,EAAE,WAAmB,EAAE,cAAuC;IACvG,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;YACnC,MAAM,SAAS,GACb,cAAc,CAAC,MAAM,KAAK,QAAQ;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,cAAc,CAAC,MAAM,KAAK,MAAM;oBAChC,CAAC,CAAC,GAAG;oBACL,CAAC,CAAC,cAAc,CAAC,MAAM,KAAK,UAAU;wBACpC,CAAC,CAAC,GAAG;wBACL,CAAC,CAAC,SAAS,CAAA;YACnB,MAAM,GAAG,GAAG,OAAO,cAAc,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAA;YAC5F,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,CAAA;YACtC,MAAM,WAAW,GAAG,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;YAClF,OAAO;gBACL,SAAS;gBACT,GAAG;gBACH,WAAW;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAA;QACH,CAAC;QAED,KAAK,kBAAkB,CAAC,KAAK;YAC3B,iEAAiE;YACjE,OAAO;gBACL,QAAQ,EACN,oHAAoH;gBACtH,SAAS,EAAE,YAAY;aACxB,CAAA;QAEH,KAAK,kBAAkB,CAAC,OAAO;YAC7B,OAAO,EAAC,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAC,CAAA;QAExE,KAAK,kBAAkB,CAAC,aAAa;YACnC,8DAA8D;YAC9D,iEAAiE;YACjE,OAAO,EAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAC,CAAA;QAE3E,KAAK,kBAAkB,CAAC,oBAAoB;YAC1C,OAAO,EAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAC,CAAA;QAEvC,KAAK,kBAAkB,CAAC,WAAW;YACjC,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAA;QAEtB,KAAK,kBAAkB,CAAC,YAAY;YAClC,OAAO,EAAC,IAAI,EAAE,EAAE,EAAC,CAAA;QAEnB,KAAK,kBAAkB,CAAC,KAAK;YAC3B,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAC,CAAA;QAExC,KAAK,kBAAkB,CAAC,KAAK,CAAC;QAC9B,KAAK,kBAAkB,CAAC,QAAQ,CAAC;QACjC,KAAK,kBAAkB,CAAC,cAAc,CAAC;QACvC,KAAK,kBAAkB,CAAC,QAAQ,CAAC;QACjC,KAAK,kBAAkB,CAAC,kBAAkB;YACxC,OAAO,EAAC,EAAE,EAAE,IAAI,EAAC,CAAA;QAEnB;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC"}

package/dist/transport/postmessage.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview PostMessage transport — in-WebView bridge via React Native WebView.
+ *
+ * The React Native WebView exposes:
+ *   - window.ReactNativeWebView.postMessage(string): miniapp → phone
+ *   - document "message" events + window "message" events: phone → miniapp
+ *
+ * react-native-webview sends incoming messages as regular DOM `MessageEvent`s
+ * on the `window` object, with `event.data` as the string payload. We listen
+ * there.
+ *
+ * Old MentraOS builds injected a global `window.receiveNativeMessage` function;
+ * we also accept that path for compatibility by assigning our handler to it.
+ */
+import { Transport, TransportDisconnectHandler, TransportMessageHandler } from "./types";
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage: (data: string) => void;
+        };
+        receiveNativeMessage?: (raw: string) => void;
+    }
+}
+export declare class PostMessageTransport implements Transport {
+    private messageHandler;
+    private disconnectHandler;
+    private open_;
+    private windowListener;
+    open(): Promise<void>;
+    send(raw: string): void;
+    onMessage(handler: TransportMessageHandler): void;
+    onDisconnect(handler: TransportDisconnectHandler): void;
+    close(): void;
+    isOpen(): boolean;
+}
+//# sourceMappingURL=postmessage.d.ts.map

package/dist/transport/postmessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmessage.d.ts","sourceRoot":"","sources":["../../src/transport/postmessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAC,SAAS,EAAE,0BAA0B,EAAE,uBAAuB,EAAC,MAAM,SAAS,CAAA;AAItF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE;YACnB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;SACpC,CAAA;QACD,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAC7C;CACF;AAED,qBAAa,oBAAqB,YAAW,SAAS;IACpD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAA4C;IAE5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIjD,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAIvD,KAAK,IAAI,IAAI;IAgBb,MAAM,IAAI,OAAO;CAGlB"}

package/dist/transport/postmessage.js

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview PostMessage transport — in-WebView bridge via React Native WebView.
+ *
+ * The React Native WebView exposes:
+ *   - window.ReactNativeWebView.postMessage(string): miniapp → phone
+ *   - document "message" events + window "message" events: phone → miniapp
+ *
+ * react-native-webview sends incoming messages as regular DOM `MessageEvent`s
+ * on the `window` object, with `event.data` as the string payload. We listen
+ * there.
+ *
+ * Old MentraOS builds injected a global `window.receiveNativeMessage` function;
+ * we also accept that path for compatibility by assigning our handler to it.
+ */
+export class PostMessageTransport {
+    constructor() {
+        this.messageHandler = null;
+        this.disconnectHandler = null;
+        this.open_ = false;
+        this.windowListener = null;
+    }
+    async open() {
+        if (this.open_)
+            return;
+        if (typeof window === "undefined" || !window.ReactNativeWebView) {
+            throw new Error("PostMessageTransport: not running inside a React Native WebView");
+        }
+        // Listen on window "message" — react-native-webview routes host→webview
+        // messages here. Also some builds dispatch on document; hook both.
+        this.windowListener = (ev) => {
+            const data = ev.data;
+            if (typeof data !== "string")
+                return;
+            this.messageHandler?.(data);
+        };
+        window.addEventListener("message", this.windowListener);
+        if (typeof document !== "undefined") {
+            document.addEventListener("message", this.windowListener);
+        }
+        // Legacy path: some host code calls window.receiveNativeMessage directly.
+        window.receiveNativeMessage = (raw) => {
+            this.messageHandler?.(raw);
+        };
+        this.open_ = true;
+    }
+    send(raw) {
+        if (typeof window === "undefined" || !window.ReactNativeWebView) {
+            throw new Error("PostMessageTransport: not running inside a React Native WebView");
+        }
+        window.ReactNativeWebView.postMessage(raw);
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onDisconnect(handler) {
+        this.disconnectHandler = handler;
+    }
+    close() {
+        if (!this.open_)
+            return;
+        this.open_ = false;
+        if (this.windowListener) {
+            window.removeEventListener("message", this.windowListener);
+            if (typeof document !== "undefined") {
+                document.removeEventListener("message", this.windowListener);
+            }
+            this.windowListener = null;
+        }
+        if (typeof window !== "undefined" && window.receiveNativeMessage) {
+            window.receiveNativeMessage = undefined;
+        }
+        this.disconnectHandler?.("closed");
+    }
+    isOpen() {
+        return this.open_;
+    }
+}
+//# sourceMappingURL=postmessage.js.map

package/dist/transport/postmessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmessage.js","sourceRoot":"","sources":["../../src/transport/postmessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,OAAO,oBAAoB;IAAjC;QACU,mBAAc,GAAmC,IAAI,CAAA;QACrD,sBAAiB,GAAsC,IAAI,CAAA;QAC3D,UAAK,GAAG,KAAK,CAAA;QACb,mBAAc,GAAwC,IAAI,CAAA;IA8DpE,CAAC;IA5DC,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QACtB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QAED,wEAAwE;QACxE,mEAAmE;QACnE,IAAI,CAAC,cAAc,GAAG,CAAC,EAAgB,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAA;YACpB,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAM;YACpC,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QACvD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,cAA0C,CAAC,CAAA;QACvF,CAAC;QAED,0EAA0E;QAC1E,MAAM,CAAC,oBAAoB,GAAG,CAAC,GAAW,EAAE,EAAE;YAC5C,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,CAAA;QAC5B,CAAC,CAAA;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QACD,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,SAAS,CAAC,OAAgC;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAA;IAC/B,CAAC;IAED,YAAY,CAAC,OAAmC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAM;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;YAC1D,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACpC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,cAA0C,CAAC,CAAA;YAC1F,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACjE,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAA;QACzC,CAAC;QACD,IAAI,CAAC,iBAAiB,EAAE,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF"}

package/dist/transport/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Transport abstraction for @mentra/miniapp.
+ *
+ * Two v1 implementations:
+ *   - PostMessageTransport — inside MentraOS WebView, uses window.ReactNativeWebView
+ *   - LocalSocketTransport — in external Safari/Chrome fallback, uses ws://127.0.0.1
+ *
+ * createTransport() in auto.ts picks the right one based on environment.
+ */
+export type TransportMessageHandler = (raw: string) => void;
+export type TransportDisconnectHandler = (reason: string) => void;
+export interface Transport {
+    /** Establish whatever connection the transport needs. May be a no-op. */
+    open(): Promise<void>;
+    /** Send a serialized envelope. */
+    send(raw: string): void;
+    /** Register a callback for incoming serialized envelopes. */
+    onMessage(handler: TransportMessageHandler): void;
+    /** Register a callback for transport-level disconnects / errors. */
+    onDisconnect(handler: TransportDisconnectHandler): void;
+    /** Close the transport cleanly. Idempotent. */
+    close(): void;
+    isOpen(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;AAC3D,MAAM,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;AAEjE,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,kCAAkC;IAClC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,6DAA6D;IAC7D,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAA;IACjD,oEAAoE;IACpE,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAA;IACvD,+CAA+C;IAC/C,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,OAAO,CAAA;CAClB"}

package/dist/transport/types.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Transport abstraction for @mentra/miniapp.
+ *
+ * Two v1 implementations:
+ *   - PostMessageTransport — inside MentraOS WebView, uses window.ReactNativeWebView
+ *   - LocalSocketTransport — in external Safari/Chrome fallback, uses ws://127.0.0.1
+ *
+ * createTransport() in auto.ts picks the right one based on environment.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/ui/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @mentra/miniapp/ui — WebView-side SDK entry point.
+ *
+ * Imported from a miniapp's `src/ui/main.tsx` (or equivalent) to access
+ * the `mentra` WebView global, React hooks, and the `MentraProvider`
+ * wrapper. This is the **on-demand WebView side** of a two-layer miniapp.
+ *
+ * What's NOT in this entry point:
+ *   - `MiniappSession` — background-only.
+ *   - Any `session.*` module classes — background-only.
+ *   - `__dispatch` / direct native access — by design, the WebView has
+ *     no host-native APIs. All hardware calls go through the background
+ *     bus via `mentra.send(channel, payload)`.
+ *
+ * The `mentra` global is injected into every UI WebView at mount time
+ * by the host's `mentraUiShim` (see `@mentra/engine/services/mentraUiShim`).
+ * This entry point exports its TypeScript declaration so authors get
+ * autocomplete and compile-time errors on channel names + payloads.
+ */
+import type { IsRpc, RpcReq, RpcRes, RpcRequestOptions } from "../modules/ui";
+export type { Rpc, IsRpc, RpcReq, RpcRes, RpcRequestOptions, RpcHandlerContext } from "../modules/ui";
+export { MentraRpcError, MentraRpcTimeoutError } from "../modules/ui";
+export interface MentraUiGlobal<TChannels extends object = Record<string, unknown>> {
+    /**
+     * Broadcast a typed message to the bound background JSContext.
+     * Buffered until `ready()` acks; once acked, fires immediately.
+     * Compile-error if `C` is an RPC channel — use `request()` instead.
+     */
+    send<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? never : C, payload: TChannels[C]): void;
+    /**
+     * Subscribe to broadcast messages from the background. Compile-error
+     * if `C` is an RPC channel.
+     */
+    on<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? never : C, cb: (payload: TChannels[C]) => void): () => void;
+    /**
+     * Make an RPC call to the background `session.ui.handle(channel, ...)`
+     * handler. On failure, throws an `Error` whose `name` is one of:
+     *   - `"MentraRpcError"` — the handler threw. `err.cause?.code` may be set.
+     *   - `"MentraRpcTimeoutError"` — `options.timeout` elapsed.
+     *   - `"AbortError"` — `options.signal` aborted.
+     * Distinguish by `err.name`, not `instanceof` — these errors are
+     * constructed in the WebView's bare runtime scope. No default timeout.
+     */
+    request<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? C : never, payload: RpcReq<TChannels[C]>, options?: RpcRequestOptions): Promise<RpcRes<TChannels[C]>>;
+    /**
+     * Fires when the bridge is open and `mentra.send` is flushable. If
+     * subscribed AFTER `ready()` has been called, fires immediately.
+     */
+    onOpen(cb: () => void): () => void;
+    /**
+     * Fires when the host is about to destroy the WebView. Handlers
+     * should snapshot any session state into background via
+     * `mentra.send` if they want it to survive.
+     */
+    onClose(cb: () => void): () => void;
+    /**
+     * MUST be called once on UI bootstrap. Tells the host the WebView is
+     * mounted and ready to receive messages from background. Idempotent
+     * — subsequent calls no-op. Background's `session.ui.onOpen` handlers
+     * fire after this lands.
+     */
+    ready(): void;
+}
+export { MentraProvider, type MentraProviderProps, } from "../react/MentraProvider";
+export { MiniappHeader } from "../react/MiniappHeader";
+export { useColorScheme } from "../react/useColorScheme";
+export { useCapabilities } from "../react/useCapabilities";
+export { useConnected } from "../react/useConnected";
+export { useSafeArea } from "../react/useSafeArea";
+export { useCapsuleHeaderStyle } from "../react/useCapsuleHeaderStyle";
+export { useRpc, type RpcCallable } from "../react/useRpc";
+/**
+ * Type helper for declaring a typed `mentra` global inside a miniapp.
+ *
+ * Every mini app should declare ONE global `mentra` typed against its
+ * own channel registry. The SDK no longer auto-declares the global so
+ * each miniapp's registry doesn't collide with the SDK's default.
+ *
+ * Usage (in your miniapp's `src/shared/channels.ts`):
+ *
+ * ```ts
+ * import type {MentraTyped} from "@mentra/miniapp/ui"
+ *
+ * export interface Channels {
+ *   "live-transcript": {text: string}
+ * }
+ *
+ * declare global {
+ *   // eslint-disable-next-line no-var
+ *   var mentra: MentraTyped<Channels>
+ * }
+ * ```
+ *
+ * Both halves of the miniapp (background + UI) import this same file,
+ * so the typed shape is consistent across the bridge.
+ */
+export type MentraTyped<TChannels extends object> = MentraUiGlobal<TChannels>;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAC,MAAM,eAAe,CAAA;AAC3E,YAAY,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,eAAe,CAAA;AACnG,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAC,MAAM,eAAe,CAAA;AAEnE,MAAM,WAAW,cAAc,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChF;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,EACrC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,EACrD,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GACpB,IAAI,CAAA;IAEP;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,EACnC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,EACrD,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAClC,MAAM,IAAI,CAAA;IAEb;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,MAAM,EACxC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,EACrD,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAElC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAEnC;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAAA;CACd;AAKD,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAC,qBAAqB,EAAC,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAC,MAAM,EAAE,KAAK,WAAW,EAAC,MAAM,iBAAiB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,WAAW,CAAC,SAAS,SAAS,MAAM,IAAI,cAAc,CAAC,SAAS,CAAC,CAAA"}

package/dist/ui/index.js

@@ -0,0 +1,32 @@
+/**
+ * @mentra/miniapp/ui — WebView-side SDK entry point.
+ *
+ * Imported from a miniapp's `src/ui/main.tsx` (or equivalent) to access
+ * the `mentra` WebView global, React hooks, and the `MentraProvider`
+ * wrapper. This is the **on-demand WebView side** of a two-layer miniapp.
+ *
+ * What's NOT in this entry point:
+ *   - `MiniappSession` — background-only.
+ *   - Any `session.*` module classes — background-only.
+ *   - `__dispatch` / direct native access — by design, the WebView has
+ *     no host-native APIs. All hardware calls go through the background
+ *     bus via `mentra.send(channel, payload)`.
+ *
+ * The `mentra` global is injected into every UI WebView at mount time
+ * by the host's `mentraUiShim` (see `@mentra/engine/services/mentraUiShim`).
+ * This entry point exports its TypeScript declaration so authors get
+ * autocomplete and compile-time errors on channel names + payloads.
+ */
+export { MentraRpcError, MentraRpcTimeoutError } from "../modules/ui";
+// React adapters are re-exported here so authors can import everything
+// from a single sub-path. The actual hooks live in src/react/ and are
+// already shipped as a separate sub-path for backwards-compat.
+export { MentraProvider, } from "../react/MentraProvider";
+export { MiniappHeader } from "../react/MiniappHeader";
+export { useColorScheme } from "../react/useColorScheme";
+export { useCapabilities } from "../react/useCapabilities";
+export { useConnected } from "../react/useConnected";
+export { useSafeArea } from "../react/useSafeArea";
+export { useCapsuleHeaderStyle } from "../react/useCapsuleHeaderStyle";
+export { useRpc } from "../react/useRpc";
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAC,cAAc,EAAE,qBAAqB,EAAC,MAAM,eAAe,CAAA;AA2DnE,uEAAuE;AACvE,sEAAsE;AACtE,+DAA+D;AAC/D,OAAO,EACL,cAAc,GAEf,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAC,qBAAqB,EAAC,MAAM,gCAAgC,CAAA;AACpE,OAAO,EAAC,MAAM,EAAmB,MAAM,iBAAiB,CAAA"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@mentra/miniapp",
+  "version": "0.3.0-beta.0",
+  "description": "SDK for building MentraOS local miniapps (browser/WebView)",
+  "author": "Mentra Labs",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./background": {
+      "types": "./dist/background/index.d.ts",
+      "default": "./dist/background/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "default": "./dist/ui/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "default": "./dist/protocol.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "dev"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
+    "dev": "bun x tsc --watch",
+    "typecheck": "bun x tsc --noEmit",
+    "test": "bun test",
+    "prepare": "bun run build",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@mentra/types": "1.0.0-beta.2",
+    "eventemitter3": "^5.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.6",
+    "react": "^19.1.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "keywords": [
+    "mentra",
+    "mentraos",
+    "miniapp",
+    "smart-glasses"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mentra-Community/MentraOS.git",
+    "directory": "mobile/modules/miniapp"
+  },
+  "homepage": "https://github.com/Mentra-Community/MentraOS/tree/dev/mobile/modules/miniapp#readme",
+  "bugs": {
+    "url": "https://github.com/Mentra-Community/MentraOS/issues"
+  }
+}