@mentra/miniapp 3.2.1-beta.319 → 3.2.1-beta.354

package/dist/react/stream-preview/PreviewConnection.d.ts

@@ -0,0 +1,139 @@
+/**
+ * The preview connection for this document.
+ *
+ * Three owners with three lifetimes meet here:
+ *   - The **lease** belongs to the miniapp's background (`session.stream.preview()`). The page
+ *     never creates or releases it; it only hears `lease_available` / `lease_ended`.
+ *   - The **connection** belongs to this document: the host config (token, docGen), the frame
+ *     transport and the credit loop. It is a module-scoped singleton so it survives
+ *     `<StreamPreview>` unmounting and remounting; a remount sends `start` without a handshake.
+ *     It ends with the document (reload, navigation, `pagehide`) or when the lease ends.
+ *   - The **renderer** belongs to the component and is attached here only as a draw callback.
+ *
+ * Control is desired-state: the component says which mount epoch wants which tier and whether it
+ * wants frames, and `sync()` sends the difference to the host over `_preview`. A new document
+ * always needs a new handshake; a new mount never does.
+ */
+import type { PreviewControlChannel } from "./controlChannel";
+import { type CreditLoopStats } from "./creditLoop";
+import type { ParsedFrame } from "./protocol";
+import { type PreviewTier } from "./tiers";
+import { type PreviewTransport, type PreviewTransportOptions } from "./transport";
+/** The only control protocol this SDK speaks. Anything else is reported as `unsupported`. */
+export declare const PREVIEW_PROTOCOL_VERSION = 1;
+export type PreviewConnectionState = 
+/** No handshake attempted yet in this document, or the lease ended and nobody wants frames. */
+"idle" | "handshaking"
+/** The host has no lease for this miniapp yet. Not an error: `lease_available` will follow. */
+ | "waiting_for_lease" | "connecting" | "open"
+/** A failure that a re-handshake may fix (transport lost, ack timeout, host refused). */
+ | "error"
+/** Terminal for this document: unknown protocol version or missing platform support. */
+ | "unsupported"
+/** Not running inside a Mentra App WebView. */
+ | "unavailable" | "closed";
+export interface PreviewConnectionStateDetail {
+    code?: string;
+    reason?: string;
+    paused?: boolean;
+}
+/** What a mounted `<StreamPreview>` gives the connection. */
+export interface PreviewSink {
+    readonly mountEpoch: number;
+    /** Submit one frame; null when the renderer has no usable context. */
+    draw(frame: ParsedFrame): number | null;
+    onState(state: PreviewConnectionState, detail: PreviewConnectionStateDetail): void;
+    onStatus(status: Record<string, unknown>): void;
+    onError(code: string): void;
+}
+export interface PreviewDesiredState {
+    /** Rendered box in device pixels; only sent when `tier` changes. */
+    boxWidth: number;
+    boxHeight: number;
+    /** Null means hidden (zero-size box). */
+    tier: PreviewTier | null;
+    /** False while the page is hidden (`visibilitychange`) or the component is unmounting. */
+    running: boolean;
+}
+export interface PreviewConnectionCounters {
+    handshakes: number;
+    reconnects: number;
+    staleReplies: number;
+    staleLocalOps: number;
+    tierChanges: number;
+    page: CreditLoopStats;
+}
+export interface PreviewConnectionDeps {
+    channel: PreviewControlChannel | null;
+    createTransport?: (transport: "websocket" | "webmessage", options: PreviewTransportOptions) => PreviewTransport;
+    now?: () => number;
+    /** Document event hookup; defaults to the real `document`/`window`. */
+    listen?: (target: "document" | "window", type: string, handler: () => void) => () => void;
+    isDocumentVisible?: () => boolean;
+}
+export declare class PreviewConnection {
+    private readonly deps;
+    private state;
+    private detail;
+    private docGen;
+    private config;
+    private transport;
+    /** Bumped whenever the transport is dropped, so a stale async continuation can tell. */
+    private connectionGen;
+    private mountEpochCounter;
+    private latestEpoch;
+    private sink;
+    private desired;
+    private applied;
+    /** Epoch whose production the host halted on a non-recoverable error; not restarted until remount. */
+    private haltedEpoch;
+    private handshaking;
+    private opChain;
+    private reconnectTimes;
+    private paused;
+    private readonly creditLoop;
+    private readonly createTransport;
+    private readonly now;
+    private readonly isVisible;
+    private readonly unsubscribers;
+    private counters;
+    constructor(deps: PreviewConnectionDeps);
+    get currentState(): PreviewConnectionState;
+    get documentGeneration(): number;
+    snapshot(): PreviewConnectionCounters;
+    /** A fresh, strictly increasing epoch for a component mounting in this document. */
+    nextMountEpoch(): number;
+    /**
+     * Route frames to this component's renderer. The newest mount wins; an older sink detaching
+     * later cannot remove a newer one.
+     */
+    attach(sink: PreviewSink): () => void;
+    /** Declare what `mountEpoch` wants. Operations from a superseded epoch are ignored. */
+    update(mountEpoch: number, state: PreviewDesiredState): void;
+    reportRendererError(mountEpoch: number, message: string): void;
+    /** End of document. The lease is untouched; a new document will handshake again. */
+    close(reason: string): void;
+    /** Test seam: detach from the channel and document. */
+    dispose(): void;
+    private sync;
+    private wantsFrames;
+    private syncOnce;
+    /** False when the host dropped the op as stale; our identity is then out of date. */
+    private accept;
+    private send;
+    private ensureOpen;
+    private handshake;
+    private openTransport;
+    private handleTransportError;
+    private handleHostEvent;
+    private handleHostError;
+    private handleVisibility;
+    private scheduleReconnect;
+    private dropTransport;
+    private setState;
+}
+/** The connection for this document, created on first use. */
+export declare function getPreviewConnection(): PreviewConnection;
+/** Test seam: replace (or clear) the document singleton, as a reload would. */
+export declare function setPreviewConnectionForTests(next: PreviewConnection | null): void;
+//# sourceMappingURL=PreviewConnection.d.ts.map

package/dist/react/stream-preview/PreviewConnection.d.ts.map

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

package/dist/react/stream-preview/PreviewConnection.js

@@ -0,0 +1,462 @@
+/**
+ * The preview connection for this document.
+ *
+ * Three owners with three lifetimes meet here:
+ *   - The **lease** belongs to the miniapp's background (`session.stream.preview()`). The page
+ *     never creates or releases it; it only hears `lease_available` / `lease_ended`.
+ *   - The **connection** belongs to this document: the host config (token, docGen), the frame
+ *     transport and the credit loop. It is a module-scoped singleton so it survives
+ *     `<StreamPreview>` unmounting and remounting; a remount sends `start` without a handshake.
+ *     It ends with the document (reload, navigation, `pagehide`) or when the lease ends.
+ *   - The **renderer** belongs to the component and is attached here only as a draw callback.
+ *
+ * Control is desired-state: the component says which mount epoch wants which tier and whether it
+ * wants frames, and `sync()` sends the difference to the host over `_preview`. A new document
+ * always needs a new handshake; a new mount never does.
+ */
+import { createMentraControlChannel, PreviewControlError } from "./controlChannel";
+import { CreditLoop } from "./creditLoop";
+import { sameTier } from "./tiers";
+import { previewTrace, previewTraceWarn, previewTraceWarnLimited } from "./trace";
+import { ackMessage, createPreviewTransport } from "./transport";
+/** The only control protocol this SDK speaks. Anything else is reported as `unsupported`. */
+export const PREVIEW_PROTOCOL_VERSION = 1;
+/** Automatic re-handshakes after a transport failure, per window, before giving up until remount. */
+const RECONNECT_BUDGET = 3;
+const RECONNECT_WINDOW_MS = 60000;
+/** Immediate re-handshakes after the host answers a handshake as stale. */
+const STALE_HANDSHAKE_RETRIES = 2;
+function defaultListen(target, type, handler) {
+    const node = target === "document"
+        ? typeof document === "undefined"
+            ? null
+            : document
+        : typeof window === "undefined"
+            ? null
+            : window;
+    if (!node)
+        return () => { };
+    node.addEventListener(type, handler);
+    return () => node.removeEventListener(type, handler);
+}
+function defaultIsVisible() {
+    return typeof document === "undefined" || document.visibilityState !== "hidden";
+}
+const NOTHING_APPLIED = { epoch: -1, tier: null, running: false };
+export class PreviewConnection {
+    constructor(deps) {
+        this.deps = deps;
+        this.detail = {};
+        this.docGen = 0;
+        this.config = null;
+        this.transport = null;
+        /** Bumped whenever the transport is dropped, so a stale async continuation can tell. */
+        this.connectionGen = 0;
+        this.mountEpochCounter = 0;
+        this.latestEpoch = 0;
+        this.sink = null;
+        this.desired = null;
+        this.applied = NOTHING_APPLIED;
+        /** Epoch whose production the host halted on a non-recoverable error; not restarted until remount. */
+        this.haltedEpoch = -1;
+        this.handshaking = null;
+        this.opChain = Promise.resolve();
+        this.reconnectTimes = [];
+        this.paused = false;
+        this.unsubscribers = [];
+        this.counters = { handshakes: 0, reconnects: 0, staleReplies: 0, staleLocalOps: 0, tierChanges: 0 };
+        this.createTransport = deps.createTransport ?? createPreviewTransport;
+        this.now = deps.now ?? (() => (typeof performance !== "undefined" ? performance.now() : Date.now()));
+        this.isVisible = deps.isDocumentVisible ?? defaultIsVisible;
+        this.state = deps.channel ? "idle" : "unavailable";
+        this.creditLoop = new CreditLoop({
+            sendAck: (gen, seq) => this.transport?.sendText(ackMessage(gen, seq)),
+            onParseError: (reason) => previewTraceWarnLimited(`parse:${reason}`, "parse_reject", { reason, docGen: this.docGen }),
+        });
+        if (deps.channel) {
+            this.unsubscribers.push(deps.channel.onEvent((event) => this.handleHostEvent(event)));
+            const listen = deps.listen ?? defaultListen;
+            this.unsubscribers.push(listen("window", "pagehide", () => this.close("pagehide")));
+            // A page restored from the back/forward cache is the same document with a dead transport.
+            this.unsubscribers.push(listen("window", "pageshow", () => {
+                if (this.state !== "closed")
+                    return;
+                this.setState("idle", { reason: "pageshow" });
+                this.sync();
+            }));
+            this.unsubscribers.push(listen("document", "visibilitychange", () => this.handleVisibility()));
+        }
+    }
+    get currentState() {
+        return this.state;
+    }
+    get documentGeneration() {
+        return this.docGen;
+    }
+    snapshot() {
+        return { ...this.counters, page: this.creditLoop.snapshot() };
+    }
+    /** A fresh, strictly increasing epoch for a component mounting in this document. */
+    nextMountEpoch() {
+        this.mountEpochCounter += 1;
+        return this.mountEpochCounter;
+    }
+    /**
+     * Route frames to this component's renderer. The newest mount wins; an older sink detaching
+     * later cannot remove a newer one.
+     */
+    attach(sink) {
+        if (sink.mountEpoch < this.latestEpoch) {
+            this.counters.staleLocalOps += 1;
+            return () => { };
+        }
+        this.latestEpoch = sink.mountEpoch;
+        this.sink = sink;
+        this.creditLoop.setDraw((frame) => sink.draw(frame));
+        sink.onState(this.state, { ...this.detail, paused: this.paused });
+        return () => {
+            if (this.sink !== sink)
+                return;
+            this.sink = null;
+            this.creditLoop.setDraw(null);
+        };
+    }
+    /** Declare what `mountEpoch` wants. Operations from a superseded epoch are ignored. */
+    update(mountEpoch, state) {
+        if (mountEpoch < this.latestEpoch) {
+            this.counters.staleLocalOps += 1;
+            previewTrace("stale_local_op", { mountEpoch, latestEpoch: this.latestEpoch });
+            return;
+        }
+        this.latestEpoch = mountEpoch;
+        this.desired = { epoch: mountEpoch, state };
+        this.sync();
+    }
+    reportRendererError(mountEpoch, message) {
+        this.creditLoop.recordError(message);
+        if (this.state !== "open" || !this.config)
+            return;
+        void this.send({ cmd: "rendererError", mountEpoch, message }).catch(() => undefined);
+    }
+    /** End of document. The lease is untouched; a new document will handshake again. */
+    close(reason) {
+        if (this.state === "closed")
+            return;
+        previewTrace("connection_closed", { reason, docGen: this.docGen });
+        this.dropTransport();
+        this.setState("closed", { reason });
+    }
+    /** Test seam: detach from the channel and document. */
+    dispose() {
+        for (const unsubscribe of this.unsubscribers.splice(0))
+            unsubscribe();
+        this.dropTransport();
+    }
+    // ---------------------------------------------------------------------------
+    sync() {
+        this.opChain = this.opChain
+            .then(() => this.syncOnce())
+            .catch((error) => {
+            previewTraceWarn("sync_failed", { error: error instanceof Error ? error.message : String(error) });
+        });
+    }
+    wantsFrames() {
+        const desired = this.desired;
+        return !!desired && desired.state.running && desired.state.tier !== null && desired.epoch !== this.haltedEpoch;
+    }
+    async syncOnce() {
+        const desired = this.desired;
+        if (!desired)
+            return;
+        if (this.state !== "open") {
+            // Hidden components never force a handshake; the next visible one will.
+            if (!this.wantsFrames())
+                return;
+            if (!(await this.ensureOpen()))
+                return;
+        }
+        const gen = this.connectionGen;
+        const { epoch, state } = desired;
+        if (state.tier && !sameTier(state.tier, this.applied.tier)) {
+            const reply = await this.send({
+                cmd: "configure",
+                mountEpoch: epoch,
+                boxWidth: state.boxWidth,
+                boxHeight: state.boxHeight,
+            });
+            if (gen !== this.connectionGen || !this.accept(reply, "configure"))
+                return;
+            this.counters.tierChanges += 1;
+            previewTrace("tier_sent", {
+                mountEpoch: epoch,
+                width: state.tier.width,
+                height: state.tier.height,
+                docGen: this.docGen,
+            });
+            this.applied = { ...this.applied, tier: state.tier };
+        }
+        const running = this.wantsFrames();
+        if (running !== this.applied.running || (running && epoch !== this.applied.epoch)) {
+            const reply = await this.send({ cmd: running ? "start" : "stop", mountEpoch: epoch });
+            if (gen !== this.connectionGen || !this.accept(reply, running ? "start" : "stop"))
+                return;
+            this.applied = { ...this.applied, epoch, running };
+        }
+    }
+    /** False when the host dropped the op as stale; our identity is then out of date. */
+    accept(reply, cmd) {
+        if (!reply)
+            return false;
+        if (!reply.stale)
+            return true;
+        this.counters.staleReplies += 1;
+        previewTraceWarn("control_stale", { cmd, docGen: this.docGen });
+        // The host no longer recognises this document's credential: start over with a handshake.
+        this.dropTransport();
+        this.setState("idle", { reason: "stale_identity" });
+        this.scheduleReconnect("stale_identity");
+        return false;
+    }
+    async send(request) {
+        const channel = this.deps.channel;
+        if (!channel)
+            return null;
+        try {
+            const reply = await channel.request({ ...request, docGen: this.docGen, token: this.config?.token });
+            return (reply ?? {});
+        }
+        catch (error) {
+            const code = error instanceof PreviewControlError ? error.code : "transport_failed";
+            previewTraceWarn("control_failed", { cmd: request.cmd, code, docGen: this.docGen });
+            this.sink?.onError(code);
+            return null;
+        }
+    }
+    ensureOpen() {
+        if (this.state === "open")
+            return Promise.resolve(true);
+        if (this.state === "unsupported" || this.state === "unavailable" || this.state === "closed") {
+            return Promise.resolve(false);
+        }
+        if (!this.handshaking) {
+            this.handshaking = this.handshake().finally(() => {
+                this.handshaking = null;
+            });
+        }
+        return this.handshaking;
+    }
+    async handshake(staleRetries = STALE_HANDSHAKE_RETRIES) {
+        const channel = this.deps.channel;
+        if (!channel)
+            return false;
+        const gen = this.connectionGen;
+        const mountEpoch = this.desired?.epoch ?? 0;
+        this.setState("handshaking");
+        previewTrace("handshake_attempt", { docGen: this.docGen, mountEpoch });
+        let result;
+        try {
+            result = (await channel.request({ cmd: "handshake", docGen: this.docGen, mountEpoch }));
+        }
+        catch (error) {
+            const code = error instanceof PreviewControlError ? error.code : "transport_failed";
+            const message = error instanceof Error ? error.message.slice(0, 120) : undefined;
+            previewTraceWarn("handshake_failed", { code, message, docGen: this.docGen });
+            // A bind that is not ready yet is reported as unsupported. That used to
+            // stick for the whole document. Treat it like a transport error and try again.
+            this.setState("error", { code });
+            this.sink?.onError(code);
+            if (this.isVisible() && this.wantsFrames())
+                this.scheduleReconnect(code);
+            return false;
+        }
+        if (gen !== this.connectionGen)
+            return false;
+        if (!result || typeof result !== "object") {
+            this.setState("error", { code: "transport_failed" });
+            return false;
+        }
+        if ("stale" in result) {
+            // The docGen this page claimed (or the one minted for it mid-handshake) was superseded,
+            // e.g. by the `ready` that follows `handshake_without_ready`. Ask again as a page that does
+            // not know its document yet; the host answers with its current one.
+            this.counters.staleReplies += 1;
+            previewTraceWarn("handshake_stale", { docGen: this.docGen, staleRetries });
+            this.docGen = 0;
+            if (staleRetries > 0)
+                return this.handshake(staleRetries - 1);
+            this.setState("error", { reason: "stale_identity" });
+            return false;
+        }
+        if (result.t === "waiting_for_lease") {
+            if (typeof result.docGen === "number")
+                this.docGen = result.docGen;
+            previewTrace("waiting_for_lease", { docGen: this.docGen });
+            this.setState("waiting_for_lease");
+            return false;
+        }
+        return this.openTransport(result);
+    }
+    async openTransport(config) {
+        if (config.protocolVersion !== PREVIEW_PROTOCOL_VERSION) {
+            previewTraceWarn("handshake_rejected", { reason: "unsupported_version", protocolVersion: config.protocolVersion });
+            this.setState("unsupported", { code: "unsupported" });
+            this.sink?.onError("unsupported");
+            return false;
+        }
+        this.docGen = config.docGen;
+        this.config = config;
+        this.counters.handshakes += 1;
+        this.setState("connecting");
+        const gen = ++this.connectionGen;
+        let transport;
+        try {
+            transport = this.createTransport(config.transport, {
+                url: config.url,
+                portName: config.portName,
+                token: config.token,
+            });
+            transport.onBinary((buffer) => this.creditLoop.handleBinary(buffer));
+            transport.onError((reason) => this.handleTransportError(gen, reason));
+            await transport.connect();
+        }
+        catch (error) {
+            const reason = error.reason ?? "connect_failed";
+            previewTraceWarn("transport_failed", { reason, docGen: this.docGen, transport: config.transport });
+            if (gen === this.connectionGen) {
+                this.config = null;
+                this.setState("error", { code: "transport_failed", reason });
+                this.sink?.onError("transport_failed");
+            }
+            return false;
+        }
+        if (gen !== this.connectionGen) {
+            transport.close();
+            return false;
+        }
+        this.transport = transport;
+        this.applied = NOTHING_APPLIED;
+        previewTrace("handshake_ok", {
+            docGen: this.docGen,
+            transport: config.transport,
+            handshakes: this.counters.handshakes,
+        });
+        this.setState("open");
+        return true;
+    }
+    handleTransportError(gen, reason) {
+        if (gen !== this.connectionGen)
+            return;
+        previewTraceWarn("transport_closed", { reason, docGen: this.docGen });
+        this.dropTransport();
+        this.setState("error", { code: "transport_failed", reason });
+        this.sink?.onError("transport_failed");
+        // A socket the OS tore down while suspended is re-established on foreground instead.
+        if (this.isVisible())
+            this.scheduleReconnect(reason);
+    }
+    handleHostEvent(event) {
+        switch (event.t) {
+            case "lease_available":
+                previewTrace("lease_available", { docGen: this.docGen, state: this.state });
+                if (this.state === "waiting_for_lease" ||
+                    this.state === "idle" ||
+                    this.state === "error" ||
+                    this.state === "unsupported") {
+                    this.setState("idle");
+                    // Hidden stays connected-but-stopped, so handshake as soon as anyone has mounted.
+                    if (this.desired)
+                        void this.ensureOpen().then((open) => open && this.sync());
+                }
+                return;
+            case "lease_ended":
+                previewTrace("lease_ended", { reason: event.reason, docGen: this.docGen });
+                this.dropTransport();
+                this.setState("waiting_for_lease", { reason: event.reason });
+                if (event.reason === "source_ended")
+                    this.sink?.onError("source_ended");
+                return;
+            case "error":
+                if (typeof event.docGen === "number" && event.docGen !== this.docGen)
+                    return;
+                this.handleHostError(event.code);
+                return;
+            case "status":
+                this.sink?.onStatus({ ...event, page: this.snapshot() });
+                return;
+            case "paused_background":
+                this.paused = true;
+                this.sink?.onState(this.state, { ...this.detail, paused: true });
+                return;
+            case "resumed":
+                this.paused = false;
+                this.sink?.onState(this.state, { ...this.detail, paused: false });
+                return;
+            case "config":
+                if (event.docGen === this.docGen && this.state !== "open" && this.state !== "connecting") {
+                    void this.openTransport(event).then((open) => open && this.sync());
+                }
+                return;
+        }
+    }
+    handleHostError(code) {
+        previewTraceWarn("host_error", { code, docGen: this.docGen });
+        this.sink?.onError(code);
+        if (code === "transport_failed" || code === "ack_timeout") {
+            this.dropTransport();
+            this.setState("error", { code });
+            this.scheduleReconnect(code);
+            return;
+        }
+        // The host halted production (pack_failed, diagnostics_disabled, ...). Restarting would only
+        // hit the same failure; a new mount epoch may try again.
+        this.applied = { ...this.applied, running: false };
+        this.haltedEpoch = this.desired?.epoch ?? this.haltedEpoch;
+    }
+    handleVisibility() {
+        const visible = this.isVisible();
+        previewTrace("visibility", { visible, state: this.state, docGen: this.docGen });
+        if (visible && (this.state === "error" || this.state === "idle"))
+            this.sync();
+    }
+    scheduleReconnect(reason) {
+        const at = this.now();
+        this.reconnectTimes = this.reconnectTimes.filter((t) => at - t < RECONNECT_WINDOW_MS);
+        if (this.reconnectTimes.length >= RECONNECT_BUDGET) {
+            previewTraceWarn("reconnect_budget_exhausted", { reason, docGen: this.docGen });
+            return;
+        }
+        this.reconnectTimes.push(at);
+        this.counters.reconnects += 1;
+        previewTrace("reconnect", { reason, docGen: this.docGen, reconnects: this.counters.reconnects });
+        this.sync();
+    }
+    dropTransport() {
+        this.connectionGen += 1;
+        const transport = this.transport;
+        this.transport = null;
+        this.config = null;
+        this.applied = NOTHING_APPLIED;
+        if (transport) {
+            transport.close();
+            previewTrace("transport_close", { docGen: this.docGen });
+        }
+    }
+    setState(state, detail = {}) {
+        this.state = state;
+        this.detail = detail;
+        this.sink?.onState(state, { ...detail, paused: this.paused });
+    }
+}
+let shared = null;
+/** The connection for this document, created on first use. */
+export function getPreviewConnection() {
+    if (!shared)
+        shared = new PreviewConnection({ channel: createMentraControlChannel() });
+    return shared;
+}
+/** Test seam: replace (or clear) the document singleton, as a reload would. */
+export function setPreviewConnectionForTests(next) {
+    shared?.dispose();
+    shared = next;
+}
+//# sourceMappingURL=PreviewConnection.js.map

package/dist/react/stream-preview/PreviewConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewConnection.js","sourceRoot":"","sources":["../../../src/react/stream-preview/PreviewConnection.ts"],"names":[],"mappings":"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"}