@mentra/sdk 2.1.31-beta.5 → 3.0.0-alpha.1

package/dist/session/managers/DeviceManager.d.ts.map

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

package/dist/session/managers/DisplayManager.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 🖥️ DisplayManager — AR Display Control
+ *
+ * v3 manager that wraps the existing LayoutManager display functionality.
+ * Sends DisplayRequest messages to the cloud with identical wire format
+ * to ensure backward compatibility.
+ *
+ * @example
+ * ```ts
+ * const display = new DisplayManager(deps);
+ *
+ * // Simple text
+ * display.showText("Hello AR World!");
+ *
+ * // Pre-wrapped lines
+ * display.showText(["Line 1", "Line 2"]);
+ *
+ * // Structured layouts
+ * display.showReferenceCard("Weather", "Sunny and 75°F");
+ * display.showDashboardCard("BPM", "72");
+ *
+ * // Clear the display
+ * display.clear();
+ * ```
+ */
+/**
+ * Shared dependency bag injected by MentraSession.
+ * Keeps managers decoupled from the session implementation.
+ */
+export interface ManagerDeps {
+    /** DataStreamRouter — register for DATA_STREAM messages by streamType key. */
+    router: {
+        on(key: string, handler: (streamType: string, data: any, message: any) => void): () => void;
+    };
+    /** MessageHandlerRegistry — register for top-level message types. */
+    messageHandlers: {
+        register(type: string, handler: (msg: any) => void): () => void;
+    };
+    addSubscription: (stream: string) => void;
+    removeSubscription: (stream: string) => void;
+    sendMessage: (message: any) => void;
+    sendBinary: (data: ArrayBuffer | Uint8Array) => void;
+    logger: {
+        debug(...args: any[]): void;
+        info(...args: any[]): void;
+        warn(...args: any[]): void;
+        error(...args: any[]): void;
+    };
+    getPackageName: () => string;
+    getSessionId: () => string;
+}
+/**
+ * Controls the AR display on the user's glasses.
+ *
+ * Provides high-level methods for showing text, cards, bitmaps, and
+ * clearing the display. All methods produce a `DisplayRequest` message
+ * with `type: "display_event"` — the exact same wire format the cloud
+ * and glasses firmware already understand from v2.
+ */
+export declare class DisplayManager {
+    private readonly deps;
+    constructor(deps: ManagerDeps);
+    /**
+     * Show text on the AR display.
+     *
+     * Accepts a single string or an array of pre-wrapped lines.
+     * When an array is provided the lines are joined with newlines
+     * and sent as a single TextWall layout.
+     *
+     * @param text - A string or array of strings to display
+     *
+     * @example
+     * ```ts
+     * display.showText("Connected to server");
+     * display.showText(["Line 1", "Line 2", "Line 3"]);
+     * ```
+     */
+    showText(text: string | string[]): void;
+    /**
+     * 📝 Show a single block of text on the main display.
+     *
+     * Best for simple messages, status updates, and notifications.
+     *
+     * @param text - Text content to display
+     *
+     * @example
+     * ```ts
+     * display.showTextWall("Listening…");
+     * ```
+     */
+    showTextWall(text: string): void;
+    /**
+     * ↕️ Show two sections of text, one above the other.
+     *
+     * Best for before/after content, question/answer, translations,
+     * or any two-part message.
+     *
+     * @param leftText  - Text for the top section
+     * @param rightText - Text for the bottom section
+     *
+     * @example
+     * ```ts
+     * display.showDoubleTextWall("Original: Hello", "Translated: Bonjour");
+     * ```
+     */
+    showDoubleTextWall(leftText: string, rightText: string): void;
+    /**
+     * 📇 Show a card with a title and body text.
+     *
+     * Best for titled content, important information, and notifications
+     * with context.
+     *
+     * @param title - Card title
+     * @param body  - Main content text
+     *
+     * @example
+     * ```ts
+     * display.showReferenceCard("Meeting Reminder", "Team standup in 5 minutes");
+     * ```
+     */
+    showReferenceCard(title: string, body: string): void;
+    /**
+     * 📊 Show a dashboard card with left and right text.
+     *
+     * Best for key-value pairs, metrics, and dashboard-style displays.
+     * Automatically uses the DASHBOARD view type.
+     *
+     * @param leftText  - Left side text (typically label/key)
+     * @param rightText - Right side text (typically value)
+     *
+     * @example
+     * ```ts
+     * display.showDashboardCard("Weather", "72°F");
+     * ```
+     */
+    showDashboardCard(leftText: string, rightText: string): void;
+    /**
+     * 🖼️ Show a bitmap image on the display.
+     *
+     * @param data - Hex or base64 encoded bitmap data string
+     *
+     * @example
+     * ```ts
+     * display.showBitmap(base64EncodedBitmapString);
+     * ```
+     */
+    showBitmap(data: any): void;
+    /**
+     * 🧹 Clear the AR display.
+     *
+     * Removes any currently shown content from the main view.
+     *
+     * @example
+     * ```ts
+     * display.clear();
+     * ```
+     */
+    clear(): void;
+    /**
+     * Build and send a DisplayRequest message.
+     *
+     * Wire format is identical to v2 LayoutManager — the cloud receives
+     * the same `{ type: "display_event", packageName, view, layout, … }`.
+     *
+     * @param layout    - The layout configuration to display
+     * @param view      - View type (main or dashboard), defaults to MAIN
+     * @param durationMs - Optional display duration in milliseconds
+     */
+    private sendDisplayEvent;
+}
+//# sourceMappingURL=DisplayManager.d.ts.map

package/dist/session/managers/DisplayManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayManager.d.ts","sourceRoot":"","sources":["../../../src/session/managers/DisplayManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAiBH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,MAAM,EAAE;QACN,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;KAC7F,CAAC;IACF,qEAAqE;IACrE,eAAe,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;KACjE,CAAC;IACF,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,KAAK,IAAI,CAAC;IACrD,MAAM,EAAE;QACN,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;KAC7B,CAAC;IACF,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAID;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,IAAI,EAAE,WAAW;IAM7B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAKvC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAuBhC;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAS7D;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASpD;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAS5D;;;;;;;;;OASG;IACH,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAkB3B;;;;;;;;;OASG;IACH,KAAK,IAAI,IAAI;IASb;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;CAgCzB"}

package/dist/session/managers/LedManager.d.ts

@@ -0,0 +1,116 @@
+/**
+ * LedManager — v3 SDK LED Control API
+ *
+ * Thin wrapper around the existing LedModule patterns. Provides a simplified
+ * API for controlling RGB LEDs on connected smart glasses.
+ *
+ * Wire format is identical to v2:
+ * ```json
+ * {
+ *   "type": "rgb_led_control",
+ *   "packageName": "<packageName>",
+ *   "sessionId": "<sessionId>",
+ *   "requestId": "<requestId>",
+ *   "action": "on" | "off",
+ *   "color": "<LedColor>",
+ *   "ontime": <ms>
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Dependencies injected by MentraSession.
+ *
+ * Structural type — no concrete imports so the manager stays unit-testable
+ * with plain stubs.
+ */
+export interface LedManagerDeps {
+    /** DataStreamRouter — register for DATA_STREAM messages by streamType key. */
+    router: {
+        on(key: string, handler: (streamType: string, data: any, message: any) => void): () => void;
+    };
+    /** MessageHandlerRegistry — register for top-level message types. */
+    messageHandlers: {
+        register(type: string, handler: (msg: any) => void): () => void;
+    };
+    /** Add a subscription string (triggers SUBSCRIPTION_UPDATE to cloud). */
+    addSubscription: (stream: string) => void;
+    /** Remove a subscription string. */
+    removeSubscription: (stream: string) => void;
+    /** Send an arbitrary JSON message over the WebSocket. */
+    sendMessage: (message: any) => void;
+    /** Structured logger. */
+    logger: {
+        debug(...args: any[]): void;
+        info(...args: any[]): void;
+        warn(...args: any[]): void;
+        error(...args: any[]): void;
+    };
+    /** Package name for outgoing messages. */
+    getPackageName: () => string;
+    /** Current session ID. */
+    getSessionId: () => string;
+}
+/**
+ * Controls RGB LEDs on connected smart glasses.
+ *
+ * LED commands are fire-and-forget — the methods return immediately after
+ * sending the control message to the cloud. No response is awaited.
+ *
+ * @example
+ * ```ts
+ * const session = await mentra.connect();
+ *
+ * // Solid green LED for 2 seconds
+ * session.led.setColor("green", 2000);
+ *
+ * // Turn LED off
+ * session.led.off();
+ * ```
+ */
+export declare class LedManager {
+    private readonly deps;
+    constructor(deps: LedManagerDeps);
+    /**
+     * Set the LED to a specific colour.
+     *
+     * Sends an `rgb_led_control` message with `action: "on"` to the cloud.
+     * The LED will remain on for `onTimeMs` milliseconds (defaults to 1000ms)
+     * then turn off automatically on the device.
+     *
+     * @param color - LED colour name. One of `"red"`, `"green"`, `"blue"`, `"orange"`, `"white"`.
+     * @param onTimeMs - Duration in milliseconds the LED stays on. Defaults to `1000`.
+     *
+     * @example
+     * ```ts
+     * // Red LED for 500ms
+     * session.led.setColor("red", 500);
+     *
+     * // White LED for the default 1s
+     * session.led.setColor("white");
+     * ```
+     */
+    setColor(color: string, onTimeMs?: number): void;
+    /**
+     * Turn the LED off.
+     *
+     * Sends an `rgb_led_control` message with `action: "off"` to the cloud.
+     *
+     * @example
+     * ```ts
+     * session.led.off();
+     * ```
+     */
+    off(): void;
+    /**
+     * Clean up resources.
+     *
+     * Called by MentraSession during disconnect/cleanup. LED commands are
+     * fire-and-forget so there is no pending state to drain.
+     *
+     * @internal
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=LedManager.d.ts.map

package/dist/session/managers/LedManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LedManager.d.ts","sourceRoot":"","sources":["../../../src/session/managers/LedManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,MAAM,EAAE;QACN,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;KAC7F,CAAC;IACF,qEAAqE;IACrE,eAAe,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;KACjE,CAAC;IACF,yEAAyE;IACzE,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,oCAAoC;IACpC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,yDAAyD;IACzD,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,yBAAyB;IACzB,MAAM,EAAE;QACN,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;KAC7B,CAAC;IACF,0CAA0C;IAC1C,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;gBAE1B,IAAI,EAAE,cAAc;IAMhC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBhD;;;;;;;;;OASG;IACH,GAAG,IAAI,IAAI;IAmBX;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/session/managers/LocationManager.d.ts

@@ -0,0 +1,224 @@
+/**
+ * LocationManager — v3 SDK Location API
+ *
+ * Wraps the existing LocationManager patterns from v2 with a cleaner,
+ * composable API. Subscribes to location data streams, caches the latest
+ * known position, and supports one-shot location polls.
+ *
+ * Wire format is identical to v2:
+ * - Location stream subscription: `"location_stream"` added to subscriptions
+ * - Location poll: `{ type: "location_poll_request", packageName, sessionId, accuracy, correlationId }`
+ * - Location updates arrive as DATA_STREAM messages with streamType `"location_update"` or `"location_stream"`
+ *
+ * The LocationUpdate payload shape (from glasses-to-cloud):
+ * ```json
+ * {
+ *   "type": "location_update",
+ *   "lat": number,
+ *   "lng": number,
+ *   "accuracy": number,
+ *   "correlationId": string | undefined
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * Normalised location data delivered to subscriber callbacks.
+ */
+export interface LocationData {
+    /** Latitude in decimal degrees. */
+    lat: number;
+    /** Longitude in decimal degrees. */
+    lng: number;
+    /** Horizontal accuracy in metres (`undefined` if not available). */
+    accuracy?: number;
+    /** Unix timestamp (ms) when the location was recorded. */
+    timestamp: number;
+    /** Correlation ID returned from a one-shot poll (if applicable). */
+    correlationId?: string;
+}
+/**
+ * Accuracy tier for location stream subscriptions.
+ * Maps directly to the v2 `LocationStreamRequest.rate` values.
+ */
+export type LocationAccuracy = "standard" | "high" | "realtime" | "tenMeters" | "hundredMeters" | "kilometer" | "threeKilometers" | "reduced";
+/** Callback signature for location subscribers. */
+export type LocationHandler = (location: LocationData) => void;
+/**
+ * Dependencies injected by MentraSession.
+ *
+ * Structural type — no concrete imports so the manager stays unit-testable
+ * with plain stubs.
+ */
+export interface LocationManagerDeps {
+    /** DataStreamRouter — register for DATA_STREAM messages by streamType key. */
+    router: {
+        on(key: string, handler: (streamType: string, data: any, message: any) => void): () => void;
+    };
+    /** MessageHandlerRegistry — register for top-level message types. */
+    messageHandlers: {
+        register(type: string, handler: (msg: any) => void): () => void;
+    };
+    /** Add a subscription string (triggers SUBSCRIPTION_UPDATE to cloud). */
+    addSubscription: (stream: string) => void;
+    /** Remove a subscription string. */
+    removeSubscription: (stream: string) => void;
+    /** Send an arbitrary JSON message over the WebSocket. */
+    sendMessage: (message: any) => void;
+    /** Structured logger. */
+    logger: {
+        debug(...args: any[]): void;
+        info(...args: any[]): void;
+        warn(...args: any[]): void;
+        error(...args: any[]): void;
+    };
+    /** Package name for outgoing messages. */
+    getPackageName: () => string;
+    /** Current session ID. */
+    getSessionId: () => string;
+}
+/**
+ * Manages location subscriptions, caches the latest known position, and
+ * supports one-shot location polls.
+ *
+ * @example
+ * ```ts
+ * const session = await mentra.connect();
+ *
+ * // Subscribe to continuous location updates
+ * const stop = session.location.onUpdate((loc) => {
+ *   console.log(`${loc.lat}, ${loc.lng} (±${loc.accuracy}m)`);
+ * });
+ *
+ * // Read cached values at any time
+ * console.log("Last known:", session.location.lat, session.location.lng);
+ *
+ * // Request a single location update
+ * session.location.requestUpdate();
+ *
+ * // Stop all subscriptions
+ * session.location.stop();
+ * ```
+ */
+export declare class LocationManager {
+    private readonly deps;
+    /**
+     * All currently-active registrations. Tracked so that {@link stop}
+     * can clean everything up in one shot.
+     */
+    private registrations;
+    /**
+     * Reference count for the location_stream subscription.
+     * We only call `removeSubscription` when ref-count drops to zero.
+     */
+    private streamRefCount;
+    /** Latest latitude, or `null` if no update has been received. */
+    private _lat;
+    /** Latest longitude, or `null` if no update has been received. */
+    private _lng;
+    /** Latest horizontal accuracy in metres, or `null` if unknown. */
+    private _accuracy;
+    /** Timestamp of the latest location update, or `null` if none received. */
+    private _timestamp;
+    /**
+     * Whether the device has location permission.
+     * Optimistically `true`, updated to `false` on permission errors.
+     */
+    private _hasPermission;
+    /** Cleanup for the internal location_update message handler. */
+    private locationUpdateCleanup;
+    constructor(deps: LocationManagerDeps);
+    /**
+     * Subscribe to continuous location updates.
+     *
+     * Registers on the DataStreamRouter for `"location_stream"` events and
+     * adds the `"location_stream"` subscription to the cloud. Multiple
+     * independent subscriptions are supported — each returns its own
+     * cleanup function.
+     *
+     * @param handler - Called each time a location update arrives.
+     * @param accuracy - Desired accuracy tier. Defaults to `"standard"`.
+     * @returns A cleanup function that removes this specific subscription.
+     *
+     * @example
+     * ```ts
+     * const stop = session.location.onUpdate((loc) => {
+     *   console.log(`${loc.lat}, ${loc.lng}`);
+     * });
+     *
+     * // Later:
+     * stop();
+     * ```
+     */
+    onUpdate(handler: LocationHandler, accuracy?: LocationAccuracy): () => void;
+    /**
+     * Request a single location update (one-shot poll).
+     *
+     * Sends a `location_poll_request` message to the cloud. The response
+     * will arrive as a `location_update` DATA_STREAM event and will be
+     * delivered to any active `onUpdate()` listeners as well as updating
+     * the cached position.
+     *
+     * @param accuracy - Desired accuracy tier for the poll. Defaults to `"standard"`.
+     *
+     * @example
+     * ```ts
+     * session.location.requestUpdate();
+     * // The next onUpdate() callback will fire with the fresh position.
+     * ```
+     */
+    requestUpdate(accuracy?: LocationAccuracy): void;
+    /**
+     * Stop all location subscriptions and remove every handler.
+     *
+     * After calling this, no location callbacks will fire until new
+     * subscriptions are created via {@link onUpdate}.
+     *
+     * @example
+     * ```ts
+     * session.location.stop();
+     * ```
+     */
+    stop(): void;
+    /**
+     * Latest known latitude, or `null` if no location update has been received.
+     */
+    get lat(): number | null;
+    /**
+     * Latest known longitude, or `null` if no location update has been received.
+     */
+    get lng(): number | null;
+    /**
+     * Latest horizontal accuracy in metres, or `null` if unknown.
+     */
+    get accuracy(): number | null;
+    /**
+     * Unix timestamp (ms) of the latest location update, or `null` if none received.
+     */
+    get timestamp(): number | null;
+    /**
+     * Whether the device has granted location permission.
+     *
+     * Optimistically `true` — updated to `false` if a permission error
+     * is received from the cloud.
+     */
+    get hasPermission(): boolean;
+    /**
+     * Update cached location values from raw incoming data.
+     */
+    private cacheLocation;
+    /**
+     * Called by MentraSession if a permission error for location is received.
+     * @internal
+     */
+    setPermission(granted: boolean): void;
+    /**
+     * Clean up all resources.
+     *
+     * Called by MentraSession during disconnect/cleanup.
+     * @internal
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=LocationManager.d.ts.map

package/dist/session/managers/LocationManager.d.ts.map

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