@mentra/sdk 2.1.31-beta.6 → 3.0.0-alpha.3

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,131 @@
+/**
+ * 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();
+ * ```
+ */
+/** Options for LED blink patterns. */
+export interface LedBlinkOptions {
+    /** How long the LED stays on per cycle (ms). */
+    onTime: number;
+    /** How long the LED stays off between cycles (ms). */
+    offTime: number;
+    /** Number of on/off cycles. */
+    count: number;
+}
+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.
+     *
+     * Three calling styles:
+     * - `setColor(color)` - on for 1000ms (default)
+     * - `setColor(color, durationMs)` - on for the specified duration
+     * - `setColor(color, { onTime, offTime, count })` - blink pattern
+     *
+     * @param color - LED colour name. One of `"red"`, `"green"`, `"blue"`, `"orange"`, `"white"`.
+     * @param durationOrOptions - Duration in ms, or an options object for blink patterns.
+     *
+     * @example
+     * ```ts
+     * // Red LED for 500ms
+     * session.led.setColor("red", 500);
+     *
+     * // White LED for the default 1s
+     * session.led.setColor("white");
+     *
+     * // Blink green 3 times (500ms on, 500ms off)
+     * session.led.setColor("green", { onTime: 500, offTime: 500, count: 3 });
+     * ```
+     */
+    setColor(color: string, durationOrOptions?: number | LedBlinkOptions): 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,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;gBAE1B,IAAI,EAAE,cAAc;IAMhC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAqC3E;;;;;;;;;OASG;IACH,GAAG,IAAI,IAAI;IAmBX;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAGhB"}

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

@@ -0,0 +1,255 @@
+/**
+ * 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;
+/** Location configuration options. */
+export interface LocationConfig {
+    /** Accuracy level for location updates. Default: "standard". */
+    accuracy?: LocationAccuracy;
+}
+/**
+ * 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;
+    /** User-provided configuration (accuracy, etc.). */
+    private _config;
+    /** Pending one-shot poll requests awaiting a correlated response. */
+    private pendingPolls;
+    /** Cleanup for the internal location_update message handler. */
+    private locationUpdateCleanup;
+    constructor(deps: LocationManagerDeps);
+    /**
+     * Configure location settings.
+     *
+     * Sets the accuracy level for subsequent `onUpdate()` subscriptions
+     * and `requestUpdate()` calls.
+     *
+     * @example
+     * ```ts
+     * session.location.configure({ accuracy: "high" });
+     * ```
+     */
+    configure(config: LocationConfig): void;
+    /**
+     * 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.
+     *
+     * Uses the accuracy level set via {@link configure}. Defaults to `"standard"`.
+     *
+     * @param handler - Called each time a location update arrives.
+     * @returns A cleanup function that removes this specific subscription.
+     *
+     * @example
+     * ```ts
+     * session.location.configure({ accuracy: "high" });
+     * const stop = session.location.onUpdate((loc) => {
+     *   console.log(`${loc.lat}, ${loc.lng}`);
+     * });
+     *
+     * // Later:
+     * stop();
+     * ```
+     */
+    onUpdate(handler: LocationHandler): () => void;
+    /**
+     * Request a single location update (one-shot poll).
+     *
+     * Sends a `location_poll_request` message to the cloud and returns a
+     * Promise that resolves with the {@link LocationData} when the correlated
+     * response arrives. The response will also be delivered to any active
+     * `onUpdate()` listeners and will update the cached position.
+     *
+     * Uses the accuracy level set via {@link configure}. Defaults to `"standard"`.
+     *
+     * @returns A promise that resolves with the location data from the poll.
+     * @throws If the poll times out (default: 15 seconds).
+     *
+     * @example
+     * ```ts
+     * session.location.configure({ accuracy: "high" });
+     * const loc = await session.location.requestUpdate();
+     * console.log(`${loc.lat}, ${loc.lng}`);
+     * ```
+     */
+    requestUpdate(): Promise<LocationData>;
+    /**
+     * 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;
+    /**
+     * Check if incoming data matches a pending one-shot poll and resolve it.
+     */
+    private resolvePendingPoll;
+    /**
+     * 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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"}