@mentra/miniapp 0.3.0-beta.0

package/dist/modules/events.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview EventManager — internal subscription registry + escape hatch.
+ *
+ * Most miniapp authors should NOT touch this directly. Use the typed methods
+ * on domain modules instead:
+ *   - session.transcription.on(...)
+ *   - session.mic.onAudioChunk(...) / onVoiceActivity(...)
+ *   - session.input.onButtonPress(...)
+ *   - session.imu.onHeadPosition(...)
+ *   - session.location.onUpdate(...)
+ *   - session.glasses.onBattery(...) / onConnection(...)
+ *   - session.phone.notifications.on(...) / session.phone.onBattery(...)
+ *
+ * This module's only public method is `subscribe(rawStreamType, handler)` —
+ * a forward-compat escape hatch for new event types not yet wrapped on a
+ * domain module. Officially undocumented; the typed methods on domain
+ * modules are the canonical surface.
+ *
+ * Internally, EventManager owns:
+ *   1. The ref-count map. Outbound SUBSCRIBE is only sent when a stream's
+ *      ref count transitions 0↔1, so multiple components listening for the
+ *      same stream issue one wire-level subscribe.
+ *   2. Inbound event fan-out via `_forwardEvent(streamType, data)`, called
+ *      by MiniappSession.handleIncoming when an EVENT envelope arrives.
+ *
+ * Domain modules call back into the session via session._subscribe(...) which
+ * in turn delegates to this class — the session is the integration point;
+ * domain modules don't see this class directly.
+ */
+import { EventEmitter } from "eventemitter3";
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+export class EventManager {
+    constructor(session) {
+        this.session = session;
+        this.emitter = new EventEmitter();
+        /** Stream -> ref count. Outbound SUBSCRIBE tracks active streams and routing changes. */
+        this.refCounts = new Map();
+        /** Transcription stream -> refs that require on-device-only processing. */
+        this.forceLocalRefCounts = new Map();
+    }
+    /**
+     * Generic subscribe. `stream` is the raw wire value, including any language
+     * suffix like `"transcription:en-US"`. Forward-compat escape hatch for new
+     * event types not yet wrapped on a domain module. Most authors should use
+     * typed methods on domain modules instead.
+     *
+     * Stream names beginning with `_` (e.g. `_ui` for the session.ui bus) are
+     * INTERNAL — they ride the local _forwardEvent fan-out and never appear in
+     * the outbound SUBSCRIBE list. Native already knows to deliver UI envelopes
+     * via a separate envelope `type`; the EventManager only routes them
+     * locally.
+     */
+    subscribe(stream, handler, options = {}) {
+        const isInternal = stream.startsWith("_");
+        const forceLocal = options.forceLocal === true && stream.startsWith(`${MiniappStreamType.TRANSCRIPTION}:`);
+        const listener = (data, route) => {
+            if (stream.startsWith(`${MiniappStreamType.TRANSCRIPTION}:`)) {
+                // Hosts that predate routed transcription events omit `route`. Treat
+                // those events as the default/cloud path so a forceLocal listener can
+                // never accidentally receive cloud text.
+                if (forceLocal ? route !== "forceLocal" && route !== "all" : route === "forceLocal")
+                    return;
+            }
+            handler(data);
+        };
+        this.emitter.on(stream, listener);
+        if (!isInternal) {
+            const before = this.refCounts.get(stream) ?? 0;
+            this.refCounts.set(stream, before + 1);
+            const forceLocalBefore = this.forceLocalRefCounts.get(stream) ?? 0;
+            const defaultBefore = before - forceLocalBefore;
+            if (forceLocal)
+                this.forceLocalRefCounts.set(stream, forceLocalBefore + 1);
+            if (before === 0 || (forceLocal && forceLocalBefore === 0) || (!forceLocal && defaultBefore === 0)) {
+                this.sendSubscriptionUpdate();
+            }
+        }
+        return () => {
+            this.emitter.off(stream, listener);
+            if (isInternal)
+                return;
+            const current = this.refCounts.get(stream) ?? 0;
+            const forceLocalCurrent = this.forceLocalRefCounts.get(stream) ?? 0;
+            let subscriptionChanged = current <= 1;
+            if (current <= 1) {
+                this.refCounts.delete(stream);
+            }
+            else {
+                this.refCounts.set(stream, current - 1);
+            }
+            if (forceLocal) {
+                if (forceLocalCurrent <= 1) {
+                    this.forceLocalRefCounts.delete(stream);
+                    subscriptionChanged = true;
+                }
+                else {
+                    this.forceLocalRefCounts.set(stream, forceLocalCurrent - 1);
+                }
+            }
+            else if (current - forceLocalCurrent <= 1) {
+                subscriptionChanged = true;
+            }
+            if (subscriptionChanged)
+                this.sendSubscriptionUpdate();
+        };
+    }
+    /** Unsubscribe every handler on every stream this EventManager owns. */
+    unsubscribeAll() {
+        this.emitter.removeAllListeners();
+        this.refCounts.clear();
+        this.forceLocalRefCounts.clear();
+        this.sendSubscriptionUpdate();
+    }
+    // -------------------------------------------------------------------------
+    // Internal — called by MiniappSession when EVENT arrives from phone
+    // -------------------------------------------------------------------------
+    /** @internal */
+    _forwardEvent(stream, data, transcriptionRoute) {
+        this.emitter.emit(stream, data, transcriptionRoute);
+        // Wildcard fan-out: handlers register under wildcard patterns
+        // ("transcription:auto", "translation:*:<target>", …) but the host
+        // delivers events under the CONCRETE stream key
+        // ("transcription:en-US", "translation:en:es"). Re-emit on every
+        // pattern the concrete key satisfies — the same pattern set
+        // LocalMiniappRuntime.forwardEvent matches on the host side —
+        // otherwise a wildcard subscriber never fires.
+        if (stream.startsWith("transcription:") && stream !== "transcription:auto") {
+            this.emitter.emit("transcription:auto", data, transcriptionRoute);
+        }
+        else if (stream.startsWith("translation:")) {
+            const parts = stream.split(":");
+            const patterns = new Set(["translation:auto"]);
+            if (parts.length === 3) {
+                const [, source, target] = parts;
+                patterns.add("translation:*:*");
+                patterns.add(`translation:*:${target}`);
+                patterns.add(`translation:${source}:*`);
+            }
+            patterns.delete(stream); // exact key already emitted above
+            for (const pattern of patterns) {
+                this.emitter.emit(pattern, data);
+            }
+        }
+    }
+    sendSubscriptionUpdate() {
+        const subscriptions = Array.from(this.refCounts.keys()).map((stream) => {
+            if (stream === MiniappStreamType.LOCATION_UPDATE)
+                return { stream: "location_stream", rate: "realtime" };
+            const forceLocalRefs = this.forceLocalRefCounts.get(stream) ?? 0;
+            if (forceLocalRefs === 0)
+                return stream;
+            const totalRefs = this.refCounts.get(stream) ?? 0;
+            return {
+                stream,
+                forceLocal: true,
+                ...(totalRefs > forceLocalRefs ? { includeCloud: true } : {}),
+            };
+        });
+        this.session.sendOneShot({
+            type: MiniappRequestType.SUBSCRIBE,
+            subscriptions,
+        });
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/modules/events.js.map

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

package/dist/modules/glasses.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview GlassesModule — device-state events for the glasses themselves.
+ *
+ * Reports on the glasses hardware: battery level + charging state, connection
+ * status (connected/disconnected, model name). The phone has its own battery
+ * + connection events on `session.phone`.
+ */
+import { MiniappSession } from "../session";
+import type { BatteryData, ConnectionData, UnsubscribeFn, WifiData } from "./events";
+export declare class GlassesModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    onBattery(handler: (data: BatteryData) => void): UnsubscribeFn;
+    onConnection(handler: (data: ConnectionData) => void): UnsubscribeFn;
+    /**
+     * Subscribe to glasses Wi-Fi state. Fires the current state on subscribe and
+     * on every change. `connected` is false on glasses without Wi-Fi. Streaming
+     * requires Wi-Fi — pair this with {@link requestWifiSetup} to prompt the user.
+     */
+    onWifi(handler: (data: WifiData) => void): UnsubscribeFn;
+    /**
+     * Ask the host to open the glasses Wi-Fi setup flow on the phone. Mirrors the
+     * cloud SDK's `session.requestWifiSetup(reason)`. `reason` is a user-facing
+     * line shown in the setup prompt (e.g. "Streaming needs your glasses on Wi-Fi").
+     */
+    requestWifiSetup(reason?: string): Promise<void>;
+}
+//# sourceMappingURL=glasses.d.ts.map

package/dist/modules/glasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/modules/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AAElF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,aAAa;IAI9D,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,aAAa;IAIpE;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,aAAa;IAIxD;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMvD"}

package/dist/modules/glasses.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview GlassesModule — device-state events for the glasses themselves.
+ *
+ * Reports on the glasses hardware: battery level + charging state, connection
+ * status (connected/disconnected, model name). The phone has its own battery
+ * + connection events on `session.phone`.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class GlassesModule {
+    constructor(session) {
+        this.session = session;
+    }
+    onBattery(handler) {
+        return this.session._subscribe(MiniappStreamType.GLASSES_BATTERY, handler);
+    }
+    onConnection(handler) {
+        return this.session._subscribe(MiniappStreamType.GLASSES_CONNECTION, handler);
+    }
+    /**
+     * Subscribe to glasses Wi-Fi state. Fires the current state on subscribe and
+     * on every change. `connected` is false on glasses without Wi-Fi. Streaming
+     * requires Wi-Fi — pair this with {@link requestWifiSetup} to prompt the user.
+     */
+    onWifi(handler) {
+        return this.session._subscribe(MiniappStreamType.GLASSES_WIFI, handler);
+    }
+    /**
+     * Ask the host to open the glasses Wi-Fi setup flow on the phone. Mirrors the
+     * cloud SDK's `session.requestWifiSetup(reason)`. `reason` is a user-facing
+     * line shown in the setup prompt (e.g. "Streaming needs your glasses on Wi-Fi").
+     */
+    async requestWifiSetup(reason) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.REQUEST_WIFI_SETUP,
+            reason,
+        });
+    }
+}
+//# sourceMappingURL=glasses.js.map

package/dist/modules/glasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glasses.js","sourceRoot":"","sources":["../../src/modules/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,aAAa;IACxB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,SAAS,CAAC,OAAoC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,eAAe,EAAE,OAAkC,CAAC,CAAA;IACvG,CAAC;IAED,YAAY,CAAC,OAAuC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,OAAkC,CAAC,CAAA;IAC1G,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAiC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAkC,CAAC,CAAA;IACpG,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAe;QACpC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACnC,IAAI,EAAE,kBAAkB,CAAC,kBAAkB;YAC3C,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/modules/heading.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview HeadingModule — phone compass heading events.
+ *
+ * Works on both Android and iOS. LOCATION permission must be declared in miniapp.json.
+ */
+import { MiniappSession } from "../session";
+import type { HeadingData, UnsubscribeFn } from "./events";
+export declare class HeadingModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    /** Subscribe to continuous compass heading updates. */
+    onUpdate(handler: (data: HeadingData) => void): UnsubscribeFn;
+}
+//# sourceMappingURL=heading.d.ts.map

package/dist/modules/heading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../src/modules/heading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,WAAW,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAExD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iEAAiE;IACjE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,aAAa;CAG9D"}

package/dist/modules/heading.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview HeadingModule — phone compass heading events.
+ *
+ * Works on both Android and iOS. LOCATION permission must be declared in miniapp.json.
+ */
+import { MiniappStreamType } from "../protocol";
+export class HeadingModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("LOCATION");
+    }
+    /** Subscribe to continuous compass heading updates. */
+    onUpdate(handler) {
+        return this.session._subscribe(MiniappStreamType.HEADING_UPDATE, handler);
+    }
+}
+//# sourceMappingURL=heading.js.map

package/dist/modules/heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../src/modules/heading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAI7C,MAAM,OAAO,aAAa;IACxB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iEAAiE;IACjE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACxD,CAAC;IAED,uDAAuD;IACvD,QAAQ,CAAC,OAAoC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,cAAc,EAAE,OAAkC,CAAC,CAAA;IACtG,CAAC;CACF"}

package/dist/modules/imu.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview ImuModule — head position + motion events.
+ *
+ * Glasses' inertial measurement unit. Exposes head-up/down position and a
+ * raw accelerometer stream (`onAccel`). Gyroscope / magnetometer / fused
+ * orientation are future work — when added they'll surface as a combined IMU
+ * event rather than extending this single-sensor accel stream.
+ */
+import { MiniappSession } from "../session";
+import type { AccelData, HeadPositionData, UnsubscribeFn } from "./events";
+export declare class ImuModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    onHeadPosition(handler: (data: HeadPositionData) => void): UnsubscribeFn;
+    /**
+     * Subscribe to raw accelerometer readings (`{x, y, z}` in g) from the
+     * glasses IMU. G2 only today; on glasses without an exposed IMU stream the
+     * subscription succeeds but no events fire.
+     */
+    onAccel(handler: (data: AccelData) => void): UnsubscribeFn;
+    /**
+     * Explicitly enable or disable raw accelerometer streaming on the glasses.
+     *
+     * Subscribing via `onAccel` already auto-enables the sensor and unsubscribing
+     * disables it, so most callers don't need this. Use it when you want to drive
+     * the IMU directly — e.g. a diagnostic toggle. G2 only today; a no-op on
+     * glasses without an exposed IMU stream.
+     */
+    setEnabled(enabled: boolean): Promise<void>;
+}
+//# sourceMappingURL=imu.d.ts.map

package/dist/modules/imu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imu.d.ts","sourceRoot":"","sources":["../../src/modules/imu.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAExE,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,cAAc,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,aAAa;IAIxE;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,aAAa;IAI1D;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5C"}

package/dist/modules/imu.js

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview ImuModule — head position + motion events.
+ *
+ * Glasses' inertial measurement unit. Exposes head-up/down position and a
+ * raw accelerometer stream (`onAccel`). Gyroscope / magnetometer / fused
+ * orientation are future work — when added they'll surface as a combined IMU
+ * event rather than extending this single-sensor accel stream.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class ImuModule {
+    constructor(session) {
+        this.session = session;
+    }
+    onHeadPosition(handler) {
+        return this.session._subscribe(MiniappStreamType.HEAD_POSITION, handler);
+    }
+    /**
+     * Subscribe to raw accelerometer readings (`{x, y, z}` in g) from the
+     * glasses IMU. G2 only today; on glasses without an exposed IMU stream the
+     * subscription succeeds but no events fire.
+     */
+    onAccel(handler) {
+        return this.session._subscribe(MiniappStreamType.ACCEL_DATA, handler);
+    }
+    /**
+     * Explicitly enable or disable raw accelerometer streaming on the glasses.
+     *
+     * Subscribing via `onAccel` already auto-enables the sensor and unsubscribing
+     * disables it, so most callers don't need this. Use it when you want to drive
+     * the IMU directly — e.g. a diagnostic toggle. G2 only today; a no-op on
+     * glasses without an exposed IMU stream.
+     */
+    setEnabled(enabled) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.IMU_SET_ENABLED,
+            enabled,
+        });
+    }
+}
+//# sourceMappingURL=imu.js.map

package/dist/modules/imu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imu.js","sourceRoot":"","sources":["../../src/modules/imu.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,SAAS;IACpB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,cAAc,CAAC,OAAyC;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,aAAa,EAAE,OAAkC,CAAC,CAAA;IACrG,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAkC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAkC,CAAC,CAAA;IAClG,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACpC,IAAI,EAAE,kBAAkB,CAAC,eAAe;YACxC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/modules/input.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview InputModule — physical control events on the glasses.
+ *
+ * Combines button + touch surfaces. Future input modes (gesture, voice
+ * command, eye tracking) will extend this module rather than spawning new
+ * top-level modules.
+ *
+ * Touch overloads:
+ *
+ *   session.input.onTouch(handler)
+ *   session.input.onTouch("single_tap", handler)
+ *   session.input.onTouch(["swipe_up", "swipe_down"], handler)
+ *
+ * Per-gesture filtering rides on `touch_event:<gesture>` stream variants
+ * the phone runtime fans out alongside the bare `touch_event` stream.
+ */
+import { MiniappSession } from "../session";
+import type { ButtonPressData, TouchData, UnsubscribeFn } from "./events";
+export declare class InputModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    onButtonPress(handler: (data: ButtonPressData) => void): UnsubscribeFn;
+    /**
+     * Subscribe to touch events.
+     *
+     *   onTouch(handler)                — all touch events
+     *   onTouch("single_tap", handler)  — only single taps
+     *   onTouch(["a","b"], handler)     — multiple gestures, single subscription
+     */
+    onTouch(handler: (data: TouchData) => void): UnsubscribeFn;
+    onTouch(gesture: string, handler: (data: TouchData) => void): UnsubscribeFn;
+    onTouch(gestures: string[], handler: (data: TouchData) => void): UnsubscribeFn;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/modules/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/modules/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAEvE,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,aAAa,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,aAAa;IAItE;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,aAAa;IAC1D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,aAAa;IAC3E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,aAAa;CAiC/E"}

package/dist/modules/input.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview InputModule — physical control events on the glasses.
+ *
+ * Combines button + touch surfaces. Future input modes (gesture, voice
+ * command, eye tracking) will extend this module rather than spawning new
+ * top-level modules.
+ *
+ * Touch overloads:
+ *
+ *   session.input.onTouch(handler)
+ *   session.input.onTouch("single_tap", handler)
+ *   session.input.onTouch(["swipe_up", "swipe_down"], handler)
+ *
+ * Per-gesture filtering rides on `touch_event:<gesture>` stream variants
+ * the phone runtime fans out alongside the bare `touch_event` stream.
+ */
+import { MiniappStreamType } from "../protocol";
+export class InputModule {
+    constructor(session) {
+        this.session = session;
+    }
+    onButtonPress(handler) {
+        return this.session._subscribe(MiniappStreamType.BUTTON_PRESS, handler);
+    }
+    onTouch(gestureOrHandler, maybeHandler) {
+        // Plain handler — subscribe to all touches.
+        if (typeof gestureOrHandler === "function") {
+            return this.session._subscribe(MiniappStreamType.TOUCH_EVENT, gestureOrHandler);
+        }
+        const handler = maybeHandler;
+        const gestures = Array.isArray(gestureOrHandler) ? gestureOrHandler : [gestureOrHandler];
+        if (gestures.length === 0)
+            return () => { };
+        const unsubs = [];
+        for (const g of gestures) {
+            unsubs.push(this.session._subscribe(`${MiniappStreamType.TOUCH_EVENT}:${g}`, handler));
+        }
+        return () => {
+            for (const u of unsubs) {
+                try {
+                    u();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        };
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/modules/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/modules/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAI7C,MAAM,OAAO,WAAW;IACtB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,aAAa,CAAC,OAAwC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAkC,CAAC,CAAA;IACpG,CAAC;IAYD,OAAO,CACL,gBAAiE,EACjE,YAAwC;QAExC,4CAA4C;QAC5C,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,iBAAiB,CAAC,WAAW,EAC7B,gBAA2C,CAC5C,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,YAAa,CAAA;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAA;QACxF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;QAE1C,MAAM,MAAM,GAAoB,EAAE,CAAA;QAClC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,OAAkC,CAAC,CACrG,CAAA;QACH,CAAC;QACD,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,CAAC,EAAE,CAAA;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/modules/led.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview LedModule — glasses RGB LED control.
+ *
+ * API mirrors the cloud SDK's LED module. Colors are named strings
+ * (the phone maps them to per-device LED indices). Actions are "on" / "off".
+ */
+import { MiniappSession } from "../session";
+export type LedColor = "red" | "green" | "blue" | "orange" | "white";
+export type LedControlResult = {
+    type?: "rgb_led_control_response";
+    state: "success";
+    requestId: string;
+};
+export interface LedControlOptions {
+    color?: LedColor;
+    /** LED on duration in ms. */
+    ontime?: number;
+    /** LED off duration in ms. */
+    offtime?: number;
+    /** Number of on/off cycles. */
+    count?: number;
+}
+export declare class LedModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** Turn an LED on with the given pattern. Resolves after the glasses acknowledge the command. */
+    turnOn(options?: LedControlOptions): Promise<LedControlResult>;
+    /** Turn all LEDs off. Resolves after the glasses acknowledge the command. */
+    turnOff(): Promise<LedControlResult>;
+    /** Blink pattern — repeats `count` times with ontime/offtime. */
+    blink(color: LedColor, ontime: number, offtime: number, count: number): Promise<LedControlResult>;
+    /** Solid LED for a fixed duration. */
+    solid(color: LedColor, duration: number): Promise<LedControlResult>;
+}
+//# sourceMappingURL=led.d.ts.map

package/dist/modules/led.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"led.d.ts","sourceRoot":"","sources":["../../src/modules/led.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,0BAA0B,CAAA;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iGAAiG;IAC3F,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWxE,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAO1C,iEAAiE;IAC3D,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIvG,sCAAsC;IAChC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG1E"}

package/dist/modules/led.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview LedModule — glasses RGB LED control.
+ *
+ * API mirrors the cloud SDK's LED module. Colors are named strings
+ * (the phone maps them to per-device LED indices). Actions are "on" / "off".
+ */
+import { MiniappRequestType } from "../protocol";
+export class LedModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** Turn an LED on with the given pattern. Resolves after the glasses acknowledge the command. */
+    async turnOn(options = {}) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.RGB_LED,
+            action: "on",
+            color: options.color ?? "red",
+            ontime: options.ontime ?? 1000,
+            offtime: options.offtime ?? 0,
+            count: options.count ?? 1,
+        });
+    }
+    /** Turn all LEDs off. Resolves after the glasses acknowledge the command. */
+    async turnOff() {
+        return this.session.sendRequest({
+            type: MiniappRequestType.RGB_LED,
+            action: "off",
+        });
+    }
+    /** Blink pattern — repeats `count` times with ontime/offtime. */
+    async blink(color, ontime, offtime, count) {
+        return this.turnOn({ color, ontime, offtime, count });
+    }
+    /** Solid LED for a fixed duration. */
+    async solid(color, duration) {
+        return this.turnOn({ color, ontime: duration, offtime: 0, count: 1 });
+    }
+}
+//# sourceMappingURL=led.js.map

package/dist/modules/led.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"led.js","sourceRoot":"","sources":["../../src/modules/led.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AAqB9C,MAAM,OAAO,SAAS;IACpB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iGAAiG;IACjG,KAAK,CAAC,MAAM,CAAC,UAA6B,EAAE;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAmB;YAChD,IAAI,EAAE,kBAAkB,CAAC,OAAO;YAChC,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;YAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAmB;YAChD,IAAI,EAAE,kBAAkB,CAAC,OAAO;YAChC,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;IACJ,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe,EAAE,KAAa;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAC,CAAC,CAAA;IACrD,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,QAAgB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC,CAAA;IACrE,CAAC;CACF"}

package/dist/modules/location.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview LocationModule — phone location events.
+ *
+ * Exposes both a continuous `onUpdate` subscription and a one-shot
+ * `getOnce()` poll over `MiniappRequestType.LOCATION_POLL`.
+ *
+ * LOCATION permission must be declared in miniapp.json for either path to
+ * succeed; the phone runtime rejects with PERMISSION_NOT_DECLARED
+ * otherwise.
+ */
+import { MiniappSession } from "../session";
+import type { LocationData, UnsubscribeFn } from "./events";
+export declare class LocationModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    /** Subscribe to continuous location updates. */
+    onUpdate(handler: (data: LocationData) => void): UnsubscribeFn;
+    /**
+     * Request a single location fix. Resolves with the next available
+     * reading from the phone. Useful at app load to seed UI before a
+     * continuous stream of updates begins.
+     */
+    getOnce(): Promise<LocationData>;
+}
+//# sourceMappingURL=location.d.ts.map

package/dist/modules/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/modules/location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAEzD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iEAAiE;IACjE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,aAAa;IAI9D;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CAKjC"}

package/dist/modules/location.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview LocationModule — phone location events.
+ *
+ * Exposes both a continuous `onUpdate` subscription and a one-shot
+ * `getOnce()` poll over `MiniappRequestType.LOCATION_POLL`.
+ *
+ * LOCATION permission must be declared in miniapp.json for either path to
+ * succeed; the phone runtime rejects with PERMISSION_NOT_DECLARED
+ * otherwise.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class LocationModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("LOCATION");
+    }
+    /** Subscribe to continuous location updates. */
+    onUpdate(handler) {
+        return this.session._subscribe(MiniappStreamType.LOCATION_UPDATE, handler);
+    }
+    /**
+     * Request a single location fix. Resolves with the next available
+     * reading from the phone. Useful at app load to seed UI before a
+     * continuous stream of updates begins.
+     */
+    getOnce() {
+        return this.session.sendRequest({
+            type: MiniappRequestType.LOCATION_POLL,
+        });
+    }
+}
+//# sourceMappingURL=location.js.map

package/dist/modules/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/modules/location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iEAAiE;IACjE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACxD,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAC,OAAqC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,eAAe,EAAE,OAAkC,CAAC,CAAA;IACvG,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAe;YAC5C,IAAI,EAAE,kBAAkB,CAAC,aAAa;SACvC,CAAC,CAAA;IACJ,CAAC;CACF"}