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

package/dist/session/MentraSession.d.ts

@@ -0,0 +1,102 @@
+import type { Logger } from "pino";
+import { type LoggerConfig } from "../logging/logger";
+import type { AppConfig, AppSettings, Capabilities } from "../types";
+import type { Transport } from "../transport/Transport";
+import { CameraManager } from "./managers/CameraManager";
+import { DashboardManager } from "./managers/DashboardManager";
+import { DeviceManager } from "./managers/DeviceManager";
+import { DisplayManager } from "./managers/DisplayManager";
+import { LedManager } from "./managers/LedManager";
+import { LocationManager } from "./managers/LocationManager";
+import { MicManager } from "./managers/MicManager";
+import { PermissionsManager } from "./managers/PermissionsManager";
+import { PhoneManager } from "./managers/PhoneManager";
+import { SpeakerManager } from "./managers/SpeakerManager";
+import { StorageManager } from "./managers/StorageManager";
+import { TimeUtils } from "./managers/TimeUtils";
+import { TranscriptionManager } from "./managers/TranscriptionManager";
+import { TranslationManager } from "./managers/TranslationManager";
+export interface MentraSessionConfig extends LoggerConfig {
+    packageName: string;
+    apiKey: string;
+    sessionId: string;
+    transport: Transport;
+    userId?: string;
+    serverUrl?: string;
+    autoReconnect?: boolean;
+    maxReconnectAttempts?: number;
+    reconnectDelay?: number;
+    logger?: Logger;
+}
+type SessionEventMap = {
+    connected: [AppSettings];
+    disconnected: [{
+        code: number;
+        reason: string;
+        permanent: boolean;
+    }];
+    error: [Error];
+    stopped: [string];
+    settings: [AppSettings];
+    reconnected: [];
+};
+export declare class MentraSession {
+    readonly transport: Transport;
+    readonly logger: Logger;
+    readonly permissions: PermissionsManager;
+    readonly transcription: TranscriptionManager;
+    readonly translation: TranslationManager;
+    readonly display: DisplayManager;
+    readonly speaker: SpeakerManager;
+    readonly mic: MicManager;
+    readonly device: DeviceManager;
+    readonly phone: PhoneManager;
+    readonly camera: CameraManager;
+    readonly led: LedManager;
+    readonly location: LocationManager;
+    readonly dashboard: DashboardManager;
+    readonly storage: StorageManager;
+    readonly time: TimeUtils;
+    settingsData: AppSettings;
+    mentraosSettings: Record<string, any>;
+    appConfig: AppConfig | null;
+    capabilities: Capabilities | null;
+    private runtimeSessionId;
+    private hasCompletedInitialConnect;
+    private readonly config;
+    private readonly lifecycle;
+    private readonly cleanupTasks;
+    private readonly _router;
+    private readonly _subscriptions;
+    private readonly _lifecycleManager;
+    constructor(config: MentraSessionConfig);
+    get packageName(): string;
+    get sessionId(): string;
+    get userId(): string | undefined;
+    get isConnected(): boolean;
+    get isParked(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    releaseOwnership(reason: "switching_clouds" | "clean_shutdown" | "user_logout"): Promise<void>;
+    updateSettingsForTesting(newSettings: AppSettings): void;
+    onConnected(handler: (...args: SessionEventMap["connected"]) => void): () => void;
+    onDisconnected(handler: (...args: SessionEventMap["disconnected"]) => void): () => void;
+    onError(handler: (...args: SessionEventMap["error"]) => void): () => void;
+    onStopped(handler: (...args: SessionEventMap["stopped"]) => void): () => void;
+    onSettings(handler: (...args: SessionEventMap["settings"]) => void): () => void;
+    onReconnected(handler: (...args: SessionEventMap["reconnected"]) => void): () => void;
+    sendMessage(message: unknown): void;
+    sendBinary(data: ArrayBuffer | Uint8Array): void;
+    getServerUrl(): string | null;
+    private registerCoreHandlers;
+    private handleTextMessage;
+    private handleConnectionAck;
+    private handleSettingsUpdate;
+    private applyMentraosSettings;
+    private sendHandshake;
+    private sendConnectionInit;
+    private emit;
+    private destroyManagers;
+}
+export {};
+//# sourceMappingURL=MentraSession.d.ts.map

package/dist/session/MentraSession.d.ts.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,2 @@
+export { MentraSession, type MentraSessionConfig } from "./MentraSession";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/session/internal/_ConnectionManager.d.ts

@@ -0,0 +1,43 @@
+import type { Logger } from "pino";
+import { Transport } from "../../transport/Transport";
+export interface _ConnectionManagerDeps {
+    transport: Transport;
+    logger: Logger;
+    autoReconnect: boolean;
+    maxReconnectAttempts: number;
+    reconnectDelay: number;
+    onTransportReady: () => void;
+    onTextMessage: (raw: string) => void;
+    onBinaryMessage: (data: ArrayBuffer) => void;
+    onClose: (info: {
+        code: number;
+        reason: string;
+        permanent: boolean;
+    }) => void;
+    onError: (error: Error) => void;
+}
+export declare class _ConnectionManager {
+    private readonly deps;
+    private connected;
+    private parked;
+    private explicitDisconnect;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingInterval;
+    private parkedTimer;
+    constructor(deps: _ConnectionManagerDeps);
+    get isConnected(): boolean;
+    get isParked(): boolean;
+    connect(): Promise<void>;
+    disconnect(): void;
+    markConnected(): void;
+    park(timeoutMs: number, onTimeout: () => void): void;
+    destroy(): void;
+    private attachTransportHandlers;
+    private scheduleReconnect;
+    private startPingInterval;
+    private stopPingInterval;
+    private stopReconnectTimer;
+    private stopParkedTimer;
+}
+//# sourceMappingURL=_ConnectionManager.d.ts.map

package/dist/session/internal/_ConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_ConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_ConnectionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,SAAS,EAAkB,MAAM,2BAA2B,CAAC;AAMtE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9E,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAE9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,WAAW,CAA8C;gBAErD,IAAI,EAAE,sBAAsB;IAKxC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,UAAU,IAAI,IAAI;IAUlB,aAAa,IAAI,IAAI;IAQrB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI;IAcpD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;CAMxB"}

package/dist/session/internal/_MessageRouter.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from "pino";
+import { DataStreamRouter, MessageHandlerRegistry } from "../DataStreamRouter";
+export declare class _MessageRouter {
+    readonly messageHandlers: MessageHandlerRegistry;
+    readonly dataStreamRouter: DataStreamRouter;
+    private readonly logger;
+    constructor(logger: Logger);
+    handleRawText(raw: string): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=_MessageRouter.d.ts.map

package/dist/session/internal/_MessageRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_MessageRouter.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_MessageRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,qBAAa,cAAc;IACzB,QAAQ,CAAC,eAAe,yBAAgC;IACxD,QAAQ,CAAC,gBAAgB,mBAA0B;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAI1B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAuBnC,OAAO,IAAI,IAAI;CAGhB"}

package/dist/session/internal/_SubscriptionManager.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from "pino";
+export interface _SubscriptionManagerDeps {
+    logger: Logger;
+    isConnected: () => boolean;
+    sendMessage: (message: unknown) => void;
+    getPackageName: () => string;
+    getSessionId: () => string;
+}
+export declare class _SubscriptionManager {
+    private readonly deps;
+    private readonly subscriptions;
+    private syncScheduled;
+    constructor(deps: _SubscriptionManagerDeps);
+    add(stream: string): void;
+    remove(stream: string): void;
+    /**
+     * Send the full subscription set to the cloud immediately.
+     * Called directly after CONNECTION_ACK / RECONNECT_ACK to ensure
+     * the cloud and SDK are in sync. Bypasses the microtask batch.
+     */
+    sync(): void;
+    snapshot(): string[];
+    clear(): void;
+    /**
+     * Batch multiple add/remove calls within the same microtask into a
+     * single SUBSCRIPTION_UPDATE message. If onSession registers 5
+     * subscriptions synchronously, only one message is sent at the end
+     * of the current tick instead of 5.
+     */
+    private scheduleSync;
+}
+//# sourceMappingURL=_SubscriptionManager.d.ts.map

package/dist/session/internal/_SubscriptionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_SubscriptionManager.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_SubscriptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,aAAa,CAAS;gBAElB,IAAI,EAAE,wBAAwB;IAI1C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM5B;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAWZ,QAAQ,IAAI,MAAM,EAAE;IAIpB,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAWrB"}

package/dist/session/internal/_V2AudioStreamShim.d.ts

@@ -0,0 +1,12 @@
+import { EventEmitter } from "events";
+import type { AudioOutputStream } from "../managers/SpeakerManager";
+export declare class _V2AudioStreamShim extends EventEmitter {
+    private readonly stream;
+    readonly streamId: string;
+    constructor(stream: AudioOutputStream);
+    get state(): string;
+    write(chunk: Uint8Array): void;
+    end(): Promise<void>;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=_V2AudioStreamShim.d.ts.map

package/dist/session/internal/_V2AudioStreamShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_V2AudioStreamShim.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_V2AudioStreamShim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,qBAAa,kBAAmB,SAAQ,YAAY;IAGtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEG,MAAM,EAAE,iBAAiB;IAetD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIxB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/session/internal/_V2CameraShim.d.ts

@@ -0,0 +1,52 @@
+import type { PhotoData as LegacyPhotoData } from "../../types/photo-data";
+import type { MentraSession } from "../MentraSession";
+import type { ExistingStreamInfo, ManagedStreamOptions, ManagedStreamResult, PhotoOptions, RtmpStreamOptions } from "../managers/CameraManager";
+export interface _V2PhotoRequestOptions {
+    saveToGallery?: boolean;
+    customWebhookUrl?: string;
+    authToken?: string;
+    size?: "small" | "medium" | "large" | "full";
+    compress?: "none" | "medium" | "heavy";
+    sound?: boolean;
+}
+export interface _V2PhotoRequestBridge {
+    registerPhotoRequest(requestId: string, request: {
+        userId: string;
+        sessionId: string;
+        session: unknown;
+        resolve: (photo: LegacyPhotoData) => void;
+        reject: (error: Error) => void;
+        timestamp: number;
+    }): void;
+    completePhotoRequest(requestId: string): {
+        resolve: (photo: LegacyPhotoData) => void;
+        reject: (error: Error) => void;
+    } | undefined;
+}
+interface _V2CameraShimConfig {
+    photoRequestBridge?: _V2PhotoRequestBridge;
+    getV2Session?: () => unknown;
+}
+export declare class _V2CameraShim {
+    private readonly session;
+    private readonly config;
+    constructor(session: MentraSession, config?: _V2CameraShimConfig);
+    get hasPermission(): boolean;
+    takePhoto(options?: PhotoOptions): Promise<import("../managers/CameraManager").PhotoData>;
+    onPhotoTaken(handler: (photo: any) => void): () => void;
+    requestPhoto(options?: _V2PhotoRequestOptions): Promise<LegacyPhotoData>;
+    startStream(options: RtmpStreamOptions): Promise<void>;
+    stopStream(): Promise<void>;
+    onStreamStatus(handler: (status: any) => void): () => void;
+    isCurrentlyStreaming(): boolean;
+    getCurrentStreamUrl(): string | undefined;
+    getStreamStatus(): import("../../types").StreamStatus | undefined;
+    startManagedStream(options?: ManagedStreamOptions): Promise<ManagedStreamResult>;
+    stopManagedStream(): Promise<void>;
+    onManagedStreamStatus(handler: (status: any) => void): () => void;
+    isManagedStreamActive(): boolean;
+    getManagedStreamUrls(): ManagedStreamResult | undefined;
+    checkExistingStream(): Promise<ExistingStreamInfo>;
+}
+export {};
+//# sourceMappingURL=_V2CameraShim.d.ts.map

package/dist/session/internal/_V2CameraShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_V2CameraShim.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_V2CameraShim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;QAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;KACnB,GACA,IAAI,CAAC;IACR,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAClC;QACE,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;QAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAChC,GACD,SAAS,CAAC;CACf;AAED,UAAU,mBAAmB;IAC3B,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAUD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,mBAAwB;IAKpE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY;IAIhC,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjD,YAAY,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgD9E,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1D,oBAAoB,IAAI,OAAO;IAI/B,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC,eAAe;IAIf,kBAAkB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIhF,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,qBAAqB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjE,qBAAqB,IAAI,OAAO;IAIhC,oBAAoB,IAAI,mBAAmB,GAAG,SAAS;IAIvD,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAGnD"}

package/dist/session/internal/_V2EventManagerShim.d.ts

@@ -0,0 +1,52 @@
+import { MentraSession } from "../MentraSession";
+type LegacyEventName = "transcription" | "head_position" | "button_press" | "touch_event" | "phone_notification" | "phone_notification_dismissed" | "vps_coordinates" | "photo_taken";
+/**
+ * V2 Event Manager Shim
+ *
+ * Maps every `session.events.*` method from the v2 API to the
+ * corresponding v3 manager method. This is the compatibility layer
+ * for code that does `session.events.onTranscription(handler)` etc.
+ *
+ * Note on `ontranslationForLanguage` (lowercase 'on'):
+ * The v2 EventManager had this as a lowercase method name — it was a bug
+ * in the original codebase that shipped and became part of the public API.
+ * We preserve the lowercase version for backward compat AND add a
+ * correctly-cased `onTranslationForLanguage` alias so both work.
+ *
+ * Removed in v3.1.
+ *
+ * @internal
+ */
+export declare class _V2EventManagerShim {
+    private readonly session;
+    constructor(session: MentraSession);
+    onTranscription(handler: (data: any) => void): () => void;
+    onTranscriptionForLanguage(language: string, handler: (data: any) => void): () => void;
+    /**
+     * Original v2 method name (lowercase 'on' — was a bug, shipped as public API).
+     * Preserved for backward compat with code that calls `events.ontranslationForLanguage()`.
+     */
+    ontranslationForLanguage(source: string, target: string, handler: (data: any) => void): () => void;
+    /**
+     * Correctly-cased alias. Both `onTranslationForLanguage` and `ontranslationForLanguage` work.
+     */
+    onTranslationForLanguage(source: string, target: string, handler: (data: any) => void): () => void;
+    onHeadPosition(handler: (data: any) => void): () => void;
+    onButtonPress(handler: (data: any) => void): () => void;
+    onTouchEvent(gestureOrHandler: string | ((data: any) => void), handler?: (data: any) => void): () => void;
+    onPhoneNotifications(handler: (data: any) => void): () => void;
+    onPhoneNotificationDismissed(handler: (data: any) => void): () => void;
+    onVpsCoordinates(handler: (data: any) => void): () => void;
+    onPhotoTaken(handler: (data: any) => void): () => void;
+    onAudioChunk(handler: (data: any) => void): () => void;
+    onLocation(handler: (data: any) => void): () => void;
+    onCalendarEvent(handler: (data: any) => void): () => void;
+    onConnected(handler: (data: any) => void): () => void;
+    onDisconnected(handler: (data: any) => void): () => void;
+    onError(handler: (data: any) => void): () => void;
+    onSettingsUpdate(handler: (data: any) => void): () => void;
+    onCapabilitiesUpdate(handler: (data: any) => void): () => void;
+    on(event: LegacyEventName, handler: (data: any) => void): () => void;
+}
+export {};
+//# sourceMappingURL=_V2EventManagerShim.d.ts.map

package/dist/session/internal/_V2EventManagerShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_V2EventManagerShim.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_V2EventManagerShim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,eAAe,GAChB,eAAe,GACf,eAAe,GACf,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,8BAA8B,GAC9B,iBAAiB,GACjB,aAAa,CAAC;AAElB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,aAAa;IAIlC,eAAe,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIzD,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAItF;;;OAGG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIlG;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIlG,cAAc,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIxD,aAAa,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIvD,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAQzG,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAI9D,4BAA4B,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAItE,gBAAgB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1D,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAItD,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAWtD,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIpD,eAAe,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIzD,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIrD,cAAc,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIxD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjD,gBAAgB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1D,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAS9D,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;CAsBrE"}

package/dist/session/internal/_V2SessionShim.d.ts

@@ -0,0 +1,169 @@
+import type { AppSettings, AppConfig, AppSetting, Capabilities, ExtendedStreamType } from "../../types";
+import { MentraSession } from "../MentraSession";
+import { _V2AudioStreamShim } from "./_V2AudioStreamShim";
+import { _V2CameraShim, type _V2PhotoRequestBridge } from "./_V2CameraShim";
+import { _V2EventManagerShim } from "./_V2EventManagerShim";
+import { _V2SettingsShim } from "./_V2SettingsShim";
+/**
+ * V2 Session Shim
+ *
+ * Wraps a v3 MentraSession in the v2 AppSession-shaped API so that
+ * existing mini apps continue to work without code changes.
+ *
+ * This is the primary backward-compatibility surface. It exposes:
+ *   - session.layouts.*      → delegates to session.display
+ *   - session.audio.*        → delegates to session.speaker
+ *   - session.simpleStorage  → delegates to session.storage
+ *   - session.camera.*       → delegates via _V2CameraShim
+ *   - session.events.*       → delegates via _V2EventManagerShim
+ *   - session.settings.*     → delegates via _V2SettingsShim
+ *   - All deprecated top-level on*() convenience methods
+ *   - All v2 utility methods (getSettings, getWifiStatus, subscribe, etc.)
+ *
+ * Removed in v3.1.
+ *
+ * @internal
+ */
+export declare class _V2SessionShim {
+    readonly session: MentraSession;
+    readonly layouts: {
+        showText: MentraSession["display"]["showText"];
+        showTextWall: MentraSession["display"]["showTextWall"];
+        showDoubleTextWall: MentraSession["display"]["showDoubleTextWall"];
+        showReferenceCard: MentraSession["display"]["showReferenceCard"];
+        showDashboardCard: MentraSession["display"]["showDashboardCard"];
+        showBitmap: MentraSession["display"]["showBitmap"];
+        clear: MentraSession["display"]["clear"];
+        updateText: (payload: {
+            text: string;
+        }) => void;
+    };
+    readonly simpleStorage: MentraSession["storage"];
+    readonly audio: {
+        speak: MentraSession["speaker"]["speak"];
+        playAudio: (options: {
+            url: string;
+            volume?: number;
+            trackId?: 0 | 1 | 2;
+            stopOtherAudio?: boolean;
+        }) => Promise<any>;
+        stopAudio: (trackId?: 0 | 1 | 2) => Promise<void>;
+        createOutputStream: (options?: Record<string, any>) => Promise<_V2AudioStreamShim>;
+    };
+    readonly camera: _V2CameraShim;
+    readonly led: MentraSession["led"];
+    readonly location: MentraSession["location"];
+    readonly device: MentraSession["device"];
+    readonly dashboard: MentraSession["dashboard"];
+    readonly settings: _V2SettingsShim;
+    readonly events: _V2EventManagerShim;
+    constructor(session: MentraSession, options?: {
+        photoRequestBridge?: _V2PhotoRequestBridge;
+    });
+    get userId(): string | undefined;
+    get packageName(): string;
+    getSessionId(): string;
+    getPackageName(): string;
+    get capabilities(): Capabilities | null;
+    /** @deprecated Use session.settings or session.settingsData */
+    getSettings(): AppSettings;
+    /** @deprecated Use session.settings.get(key) */
+    getSetting<T>(key: string): T | undefined;
+    /** @deprecated Use session.appConfig */
+    getConfig(): AppConfig | null;
+    /** @deprecated Use session.getServerUrl() */
+    getServerUrl(): string | null;
+    /** @deprecated Convert WS URL to HTTPS */
+    getHttpsServerUrl(): string | null;
+    /** @deprecated Use session.device.state.wifiConnected */
+    getWifiStatus(): {
+        connected: boolean;
+        ssid?: string | null;
+    } | null;
+    /** @deprecated Use session.device.state.wifiConnected.value */
+    isWifiConnected(): boolean;
+    /** @deprecated Use session.device.requestWifiSetup() */
+    requestWifiSetup(reason?: string): void;
+    /**
+     * @deprecated Subscriptions are now derived from handler registrations.
+     * Prefer using manager methods (e.g., session.transcription.on()) which
+     * handle subscriptions automatically.
+     */
+    subscribe(sub: string | {
+        stream: string;
+        rate?: string;
+    }): void;
+    /**
+     * @deprecated Subscriptions are now derived from handler registrations.
+     */
+    unsubscribe(sub: string | {
+        stream: string;
+    }): void;
+    /** @deprecated Use the specific manager methods instead. */
+    on(event: string, handler: (data: any) => void): () => void;
+    /** @deprecated Use session.device.subscribeToGestures() */
+    subscribeToGestures(gestures: string[]): () => void;
+    /** @deprecated Use session.device.state.connected.onChange() */
+    onGlassesConnectionState(handler: (state: any) => void): () => void;
+    /** @deprecated Use session.transcription.on() */
+    onTranscription(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.transcription.forLanguage() */
+    onTranscriptionForLanguage(language: string, handler: (data: any) => void): () => void;
+    /** @deprecated Use session.translation.fromTo() */
+    onTranslationForLanguage(source: string, target: string, handler: (data: any) => void): () => void;
+    /** @deprecated Use session.device.onHeadPosition() */
+    onHeadPosition(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.device.onButtonPress() */
+    onButtonPress(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.device.onTouchEvent() */
+    onTouchEvent(gestureOrHandler: string | ((data: any) => void), handler?: (data: any) => void): () => void;
+    /** @deprecated Use session.phone.notifications.on() */
+    onPhoneNotifications(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.phone.notifications.onDismissed() */
+    onPhoneNotificationDismissed(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.device.onVpsCoordinates() */
+    onVpsCoordinates(handler: (data: any) => void): () => void;
+    /** @deprecated Use session.camera.onPhotoTaken() */
+    onPhotoTaken(handler: (data: any) => void): () => void;
+    /**
+     * @deprecated Use v3 manager-based subscriptions instead.
+     *
+     * Configure automatic subscription updates when settings change.
+     * The handler function receives the current settings and returns
+     * the desired subscription list. When any of the `updateOnChange`
+     * keys change, the handler is re-evaluated and subscriptions updated.
+     */
+    private _subscriptionSettingsHandler?;
+    private _subscriptionUpdateTriggers;
+    setSubscriptionSettings(options: {
+        updateOnChange: string[];
+        handler: (settings: AppSettings) => ExtendedStreamType[];
+    }): void;
+    private _updateSubscriptionsFromSettings;
+    /**
+     * @deprecated Use appConfig property directly.
+     * Load app configuration from a JSON string.
+     */
+    loadConfigFromJson(jsonData: string): AppConfig;
+    /**
+     * @deprecated Read from appConfig.settings directly.
+     * Get default settings from the loaded app configuration.
+     */
+    getDefaultSettings(): AppSettings;
+    /**
+     * @deprecated Read from appConfig.settings directly.
+     * Get the schema for a specific setting key.
+     */
+    getSettingSchema(key: string): AppSetting | undefined;
+    /** Send an arbitrary JSON message over the WebSocket. */
+    sendMessage(message: unknown): void;
+    /** Send binary data over the WebSocket (e.g., audio stream frames). */
+    sendBinary(data: ArrayBuffer | Uint8Array): void;
+    releaseOwnership(reason: "switching_clouds" | "clean_shutdown" | "user_logout"): Promise<void>;
+    disconnect(_options?: {
+        releaseOwnership?: boolean;
+        reason?: "switching_clouds" | "clean_shutdown" | "user_logout";
+    }): Promise<void>;
+    updateSettingsForTesting(newSettings: AppSettings): void;
+}
+//# sourceMappingURL=_V2SessionShim.d.ts.map

package/dist/session/internal/_V2SessionShim.d.ts.map

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

package/dist/session/internal/_V2SettingsShim.d.ts

@@ -0,0 +1,17 @@
+import type { AppSettings } from "../../types";
+import { MentraSession } from "../MentraSession";
+type SettingsChangeMap = Record<string, {
+    oldValue: any;
+    newValue: any;
+}>;
+export declare class _V2SettingsShim {
+    private readonly session;
+    constructor(session: MentraSession);
+    has(key: string): boolean;
+    getAll(): AppSettings;
+    get<T = any>(key: string, defaultValue?: T): T;
+    onChange(handler: (changes: SettingsChangeMap) => void): () => void;
+    onValueChange<T = any>(key: string, handler: (newValue: T, oldValue: T) => void): () => void;
+}
+export {};
+//# sourceMappingURL=_V2SettingsShim.d.ts.map

package/dist/session/internal/_V2SettingsShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_V2SettingsShim.d.ts","sourceRoot":"","sources":["../../../src/session/internal/_V2SettingsShim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,iBAAiB,GAAG,MAAM,CAC7B,MAAM,EACN;IACE,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,GAAG,CAAC;CACf,CACF,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,aAAa;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,IAAI,WAAW;IAIrB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAS9C,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAiCnE,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;CAY7F"}