@mentra/sdk 2.1.27 → 2.1.29-beta.1

package/dist/app/session/modules/led.d.ts

@@ -0,0 +1,141 @@
+/**
+ * 💡 LED Control Module
+ *
+ * Provides RGB LED control functionality for App Sessions.
+ * Controls the RGB LEDs on smart glasses with custom colors and timing patterns.
+ */
+import { LedColor } from "../../../types";
+import { Logger } from "pino";
+/**
+ * Options for LED control
+ */
+export interface LedControlOptions {
+    /** LED color */
+    color?: LedColor;
+    /** LED on duration in milliseconds */
+    ontime?: number;
+    /** LED off duration in milliseconds */
+    offtime?: number;
+    /** Number of on/off cycles */
+    count?: number;
+}
+/**
+ * 💡 LED Control Module Implementation
+ *
+ * Provides methods for controlling LEDs on smart glasses.
+ * Supports both low-level on/off control and higher-level pattern methods.
+ *
+ * @example
+ * ```typescript
+ * // General LED control
+ * await session.led.turnOn({ color: 'red', ontime: 1000, count: 1 });
+ *
+ * // Blink green LED
+ * await session.led.blink('green', 500, 500, 5);
+ *
+ * // Turn off all LEDs
+ * await session.led.turnOff();
+ * ```
+ */
+export declare class LedModule {
+    private session;
+    private packageName;
+    private sessionId;
+    private logger;
+    /**
+     * Create a new LedModule
+     *
+     * @param session - Reference to the parent AppSession
+     * @param packageName - The App package name
+     * @param sessionId - The current session ID
+     * @param logger - Logger instance for debugging
+     */
+    constructor(session: any, packageName: string, sessionId: string, logger?: Logger);
+    /**
+     * 💡 Turn on an LED with specified timing parameters
+     *
+     * @param options - LED control options (color, timing, count)
+     * @returns Promise that resolves immediately after sending the command
+     *
+     * @example
+     * ```typescript
+     * // Solid red for 2 seconds
+     * await session.led.turnOn({ color: 'red', ontime: 2000, count: 1 });
+     *
+     * // Blink white 3 times
+     * await session.led.turnOn({ color: 'white', ontime: 500, offtime: 500, count: 3 });
+     * ```
+     */
+    turnOn(options: LedControlOptions): Promise<void>;
+    /**
+     * 💡 Turn off all LEDs
+     *
+     * @returns Promise that resolves immediately after sending the command
+     *
+     * @example
+     * ```typescript
+     * await session.led.turnOff();
+     * ```
+     */
+    turnOff(): Promise<void>;
+    /**
+     * 💡 Get available LED capabilities
+     *
+     * @returns Array of available LED configurations
+     *
+     * @example
+     * ```typescript
+     * const capabilities = session.led.getCapabilities();
+     * console.log('Available LEDs:', capabilities);
+     * ```
+     */
+    getCapabilities(): Array<{
+        id: string;
+        purpose: string;
+        isFullColor: boolean;
+        color?: string;
+        position?: string;
+    }>;
+    /**
+     * 💡 Blink an LED with specified timing
+     *
+     * @param color - LED color to use
+     * @param ontime - How long LED stays on (ms)
+     * @param offtime - How long LED stays off (ms)
+     * @param count - Number of blink cycles
+     * @returns Promise that resolves immediately after sending the command
+     *
+     * @example
+     * ```typescript
+     * // Blink red LED 5 times (500ms on, 500ms off)
+     * await session.led.blink('red', 500, 500, 5);
+     * ```
+     */
+    blink(color: LedColor, ontime: number, offtime: number, count: number): Promise<void>;
+    /**
+     * 💡 Solid LED mode - LED stays on continuously for specified duration
+     *
+     * Creates a solid LED effect with no off time, perfect for continuous illumination.
+     *
+     * @param color - LED color to use
+     * @param duration - How long LED stays on (ms)
+     * @returns Promise that resolves when the command is sent
+     *
+     * @example
+     * ```typescript
+     * // Solid red LED for 5 seconds
+     * await session.led.solid('red', 5000);
+     *
+     * // Solid white LED for 30 seconds
+     * await session.led.solid('white', 30000);
+     * ```
+     */
+    solid(color: LedColor, duration: number): Promise<void>;
+    /**
+     * Clean up LED module
+     *
+     * @internal
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=led.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"led.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/led.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA8C,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAC,MAAM,EAAC,MAAM,MAAM,CAAA;AAE3B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAQ;IAEtB;;;;;;;OAOG;gBACS,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAWjF;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCvD;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B;;;;;;;;;;OAUG;IACH,eAAe,IAAI,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC;IAUF;;;;;;;;;;;;;;OAcG;IACG,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3F;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/app/session/modules/location.d.ts

@@ -2,9 +2,8 @@ import { AppSession } from "..";
 import { LocationUpdate } from "../../../types";
 export declare class LocationManager {
     private session;
-    private send;
     private lastLocationCleanupHandler;
-    constructor(session: AppSession, send: (message: any) => void);
+    constructor(session: AppSession);
     subscribeToStream(options: {
         accuracy: "standard" | "high" | "realtime" | "tenMeters" | "hundredMeters" | "kilometer" | "threeKilometers" | "reduced";
     }, handler: (data: LocationUpdate) => void): () => void;

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

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAEL,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,qBAAa,eAAe;IAIxB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,0BAA0B,CAAwB;gBAGhD,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;IAI/B,iBAAiB,CACtB,OAAO,EAAE;QACP,QAAQ,EACJ,UAAU,GACV,MAAM,GACN,UAAU,GACV,WAAW,GACX,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAC;KACf,EACD,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GACtC,MAAM,IAAI;IAkBN,qBAAqB,IAAI,IAAI;IAUvB,iBAAiB,CAAC,OAAO,EAAE;QACtC,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,cAAc,CAAC;CA+B5B"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,IAAI,CAAA;AAC7B,OAAO,EAAwB,cAAc,EAAwB,MAAM,gBAAgB,CAAA;AAE3F,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,0BAA0B,CAAuB;gBAE7C,OAAO,EAAE,UAAU;IAKxB,iBAAiB,CACtB,OAAO,EAAE;QACP,QAAQ,EACJ,UAAU,GACV,MAAM,GACN,UAAU,GACV,WAAW,GACX,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAA;KACd,EACD,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GACtC,MAAM,IAAI;IAcN,qBAAqB,IAAI,IAAI;IAUvB,iBAAiB,CAAC,OAAO,EAAE;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CA4BrF"}

package/dist/app/session/modules/simple-storage.d.ts

@@ -1,10 +1,15 @@
 /**
  * Simple Storage SDK Module for MentraOS Apps
  * Provides localStorage-like API with cloud synchronization
+ *
+ * Mental Model: App server RAM = source of truth, MongoDB = crash recovery backup
+ * - User interactions read/write to RAM instantly
+ * - Changes are debounced and batched to MongoDB (3s idle / 10s max)
+ * - On disconnect, pending writes are flushed automatically
  */
 import { AppSession } from "..";
 /**
- * Key-value storage with local caching and cloud sync
+ * Key-value storage with local caching and debounced cloud sync
  * Data is isolated by userId and packageName
  */
 export declare class SimpleStorage {
@@ -13,12 +18,28 @@ export declare class SimpleStorage {
     private userId;
     private packageName;
     private baseUrl;
+    private pendingWrites;
+    private debounceTimer?;
+    private maxWaitTimer?;
+    private firstWriteTime?;
+    private static readonly MAX_VALUE_SIZE;
+    private static readonly DEBOUNCE_MS;
+    private static readonly MAX_WAIT_MS;
     constructor(appSession: AppSession);
     private getBaseUrl;
     private getAuthHeaders;
     private fetchStorageFromCloud;
     get(key: string): Promise<string | undefined>;
     set(key: string, value: string): Promise<void>;
+    /**
+     * Schedule flush with debounce (3s idle) and max wait (10s)
+     */
+    private scheduleFlush;
+    /**
+     * Flush pending writes immediately
+     * Called by: debounce timeout, max wait timeout, disconnect, or explicit flush()
+     */
+    flush(): Promise<void>;
     delete(key: string): Promise<boolean>;
     clear(): Promise<boolean>;
     keys(): Promise<string[]>;

package/dist/app/session/modules/simple-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simple-storage.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/simple-storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGhC;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,UAAU;IAQlC,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,cAAc;YASR,qBAAqB;IA8BtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAe7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqCrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BzB,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAavB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAa7C,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgCtE"}
+{"version":3,"file":"simple-storage.d.ts","sourceRoot":"","sources":["../../../../src/app/session/modules/simple-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,IAAI,CAAA;AAc7B;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAQ;IAGvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAQ;IAG/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAC3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEhC,UAAU,EAAE,UAAU;IAQlC,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,cAAc;YASR,qBAAqB;IAwBtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgB7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B3D;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CtB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsCrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAuBzB,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAavB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAa7C,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BtE"}