@mentra/sdk 2.1.3 → 2.1.5

package/dist/app/session/layouts.d.ts

@@ -15,7 +15,7 @@
  * layouts.showReferenceCard('Weather', 'Sunny and 75°F');
  * ```
  */
-import { DisplayRequest, ViewType } from '../../types';
+import { DisplayRequest, ViewType } from "../../types";
 export declare class LayoutManager {
     private packageName;
     private sendMessage;
@@ -109,28 +109,25 @@ export declare class LayoutManager {
         durationMs?: number;
     }): void;
     /**
-   * 📇 Shows a bitmap
-   *
-   * Uses the proven animation system internally for proper L/R eye synchronization.
-   * This ensures single bitmap displays work consistently with the same
-   * hardware-optimized timing as animations.
-   *
-   * @param data - hex or base64 encoded bitmap data
-   * @param options - Optional parameters (view, duration)
-   *
-   * @example
-   * ```typescript
-   * layouts.showBitmapView(
-   *   yourHexOrBase64EncodedBitmapDataString
-   * );
-   * ```
-   */
+     * 📇 Shows a bitmap
+     *
+     * Uses the proven animation system internally for proper L/R eye synchronization.
+     * This ensures single bitmap displays work consistently with the same
+     * hardware-optimized timing as animations.
+     *
+     * @param data - hex or base64 encoded bitmap data
+     * @param options - Optional parameters (view, duration)
+     *
+     * @example
+     * ```typescript
+     * layouts.showBitmapView(
+     *   yourHexOrBase64EncodedBitmapDataString
+     * );
+     * ```
+     */
     showBitmapView(data: string, options?: {
         view?: ViewType;
-        durationMs?: number;
-    }): {
-        stop: () => void;
-    };
+    }): void;
     /**
      * 📊 Shows a dashboard card with left and right text
      *

package/dist/app/session/layouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../../src/app/session/layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EAOd,QAAQ,EAKT,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IAQtB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IARrB;;;;;OAKG;gBAEO,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI;IAGxD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAuG1B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC;IAuCnD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAcpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAclD;;;;;;;;;;;;;;;;KAgBC;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;cA0HzC,MAAM,IAAI;;IA/FrB;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAcpD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE;IAUvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,mBAAmB,CACjB,eAAe,EAAE,MAAM,EAAE,EACzB,UAAU,GAAE,MAAa,EACzB,MAAM,GAAE,OAAe,EACvB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,GAC5B;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE;CA8BxB"}
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../../src/app/session/layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,cAAc,EAOd,QAAQ,EAKT,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IAQtB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IARrB;;;;;OAKG;gBAEO,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI;IAGxD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAoH1B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAuCpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAYpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAYpD;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE;IAQ1D;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAgBpD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE;IAOvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,mBAAmB,CACjB,eAAe,EAAE,MAAM,EAAE,EACzB,UAAU,GAAE,MAAa,EACzB,MAAM,GAAE,OAAe,EACvB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,GAC5B;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE;CAiCxB"}

package/dist/app/session/layouts.js

@@ -51,7 +51,7 @@ class LayoutManager {
             // Layout-specific validations
             switch (layout.layoutType) {
                 case types_1.LayoutType.TEXT_WALL:
-                    if (typeof layout.text !== 'string') {
+                    if (typeof layout.text !== "string") {
                         throw new Error("TextWall layout must have a text property");
                     }
                     // Ensure text is not too long (prevent performance issues)
@@ -61,38 +61,39 @@ class LayoutManager {
                     break;
                 case types_1.LayoutType.DOUBLE_TEXT_WALL:
                     const doubleText = layout;
-                    if (typeof doubleText.topText !== 'string') {
+                    if (typeof doubleText.topText !== "string") {
                         throw new Error("DoubleTextWall layout must have a topText property");
                     }
-                    if (typeof doubleText.bottomText !== 'string') {
+                    if (typeof doubleText.bottomText !== "string") {
                         throw new Error("DoubleTextWall layout must have a bottomText property");
                     }
                     break;
                 case types_1.LayoutType.REFERENCE_CARD:
                     const refCard = layout;
-                    if (typeof refCard.title !== 'string') {
+                    if (typeof refCard.title !== "string") {
                         throw new Error("ReferenceCard layout must have a title property");
                     }
-                    if (typeof refCard.text !== 'string') {
+                    if (typeof refCard.text !== "string") {
                         throw new Error("ReferenceCard layout must have a text property");
                     }
                     break;
                 case types_1.LayoutType.DASHBOARD_CARD:
                     const dashCard = layout;
-                    if (typeof dashCard.leftText !== 'string') {
+                    if (typeof dashCard.leftText !== "string") {
                         throw new Error("DashboardCard layout must have a leftText property");
                     }
-                    if (typeof dashCard.rightText !== 'string') {
+                    if (typeof dashCard.rightText !== "string") {
                         throw new Error("DashboardCard layout must have a rightText property");
                     }
                     break;
                 case types_1.LayoutType.BITMAP_VIEW:
                     const bitmapView = layout;
-                    if (typeof bitmapView.data !== 'string') {
+                    if (typeof bitmapView.data !== "string") {
                         throw new Error("BitmapView layout must have a data property");
                     }
                     // Check if data is too large (prevent OOM errors)
-                    if (bitmapView.data.length > 1000000) { // 1MB limit
+                    if (bitmapView.data.length > 1000000) {
+                        // 1MB limit
                         throw new Error("Bitmap data is too large (>1MB), please reduce size");
                     }
                     break;
@@ -107,7 +108,7 @@ class LayoutManager {
             }
             // Validate duration if provided
             if (durationMs !== undefined) {
-                if (typeof durationMs !== 'number' || durationMs < 0) {
+                if (typeof durationMs !== "number" || durationMs < 0) {
                     console.warn(`Invalid duration: ${durationMs}, ignoring`);
                     durationMs = undefined;
                 }
@@ -115,12 +116,12 @@ class LayoutManager {
             // Create the display request with validated data
             return {
                 timestamp: new Date(),
-                sessionId: '', // Will be filled by session
+                sessionId: "", // Will be filled by session
                 type: types_1.AppToCloudMessageType.DISPLAY_REQUEST,
                 packageName: this.packageName,
                 view,
                 layout,
-                durationMs
+                durationMs,
             };
         }
         catch (error) {
@@ -154,14 +155,14 @@ class LayoutManager {
                 console.warn("showTextWall called with null/undefined text");
             }
             // Ensure text is a string
-            if (typeof text !== 'string') {
+            if (typeof text !== "string") {
                 text = String(text); // Convert to string
                 console.warn("showTextWall: Non-string input converted to string");
             }
             // Create layout with validated text
             const layout = {
                 layoutType: types_1.LayoutType.TEXT_WALL,
-                text
+                text,
             };
             // Create and send display event with error handling
             try {
@@ -203,7 +204,7 @@ class LayoutManager {
         const layout = {
             layoutType: types_1.LayoutType.DOUBLE_TEXT_WALL,
             topText,
-            bottomText
+            bottomText,
         };
         this.sendMessage(this.createDisplayEvent(layout, options?.view, options?.durationMs));
     }
@@ -232,45 +233,33 @@ class LayoutManager {
         const layout = {
             layoutType: types_1.LayoutType.REFERENCE_CARD,
             title,
-            text
+            text,
         };
         this.sendMessage(this.createDisplayEvent(layout, options?.view, options?.durationMs));
     }
     /**
-   * 📇 Shows a bitmap
-   *
-   * Uses the proven animation system internally for proper L/R eye synchronization.
-   * This ensures single bitmap displays work consistently with the same
-   * hardware-optimized timing as animations.
-   *
-   * @param data - hex or base64 encoded bitmap data
-   * @param options - Optional parameters (view, duration)
-   *
-   * @example
-   * ```typescript
-   * layouts.showBitmapView(
-   *   yourHexOrBase64EncodedBitmapDataString
-   * );
-   * ```
-   */
+     * 📇 Shows a bitmap
+     *
+     * Uses the proven animation system internally for proper L/R eye synchronization.
+     * This ensures single bitmap displays work consistently with the same
+     * hardware-optimized timing as animations.
+     *
+     * @param data - hex or base64 encoded bitmap data
+     * @param options - Optional parameters (view, duration)
+     *
+     * @example
+     * ```typescript
+     * layouts.showBitmapView(
+     *   yourHexOrBase64EncodedBitmapDataString
+     * );
+     * ```
+     */
     showBitmapView(data, options) {
-        // Use the proven animation system for single frame display
-        // This ensures proper L/R eye synchronization that works with
-        // the optimized iOS BLE transmission system
-        const duration = options?.durationMs || 5000; // Default 5 seconds
-        const frameInterval = 1650; // Use same interval as working animations
-        // Create short multi-frame animation for better L/R sync
-        // Repeat the same frame a few times to mimic continuous animation behavior
-        const frames = [data, data, data]; // Triple the frame for stability
-        const animation = this.showBitmapAnimation(frames, // Multi-frame array (same image repeated)
-        frameInterval, // Use proven 1650ms interval
-        false, // Don't repeat infinitely
-        { view: options?.view });
-        // Auto-stop after duration
-        setTimeout(() => {
-            animation.stop();
-        }, duration);
-        return animation;
+        const layout = {
+            layoutType: types_1.LayoutType.BITMAP_VIEW,
+            data: data,
+        };
+        this.sendMessage(this.createDisplayEvent(layout, options?.view));
     }
     /**
      * 📊 Shows a dashboard card with left and right text
@@ -293,7 +282,7 @@ class LayoutManager {
         const layout = {
             layoutType: types_1.LayoutType.DASHBOARD_CARD,
             leftText,
-            rightText
+            rightText,
         };
         this.sendMessage(this.createDisplayEvent(layout, options?.view || types_1.ViewType.DASHBOARD, options?.durationMs));
     }
@@ -315,7 +304,7 @@ class LayoutManager {
      */
     clearView(options) {
         const layout = {
-            layoutType: types_1.LayoutType.CLEAR_VIEW
+            layoutType: types_1.LayoutType.CLEAR_VIEW,
         };
         this.sendMessage(this.createDisplayEvent(layout, options?.view));
     }
@@ -359,17 +348,17 @@ class LayoutManager {
             layoutType: types_1.LayoutType.BITMAP_ANIMATION,
             frames: bitmapDataArray,
             interval: intervalMs,
-            repeat: repeat
+            repeat: repeat,
         };
         this.sendMessage(this.createDisplayEvent(layout, options?.view));
-        console.log(`🎬 Sent batched animation to iOS: ${bitmapDataArray.length} frames at ${intervalMs}ms${repeat ? ' (repeating)' : ''}`);
+        console.log(`🎬 Sent batched animation to iOS: ${bitmapDataArray.length} frames at ${intervalMs}ms${repeat ? " (repeating)" : ""}`);
         // Return controller for compatibility
         return {
             stop: () => {
                 // Send stop command to iOS
                 this.clearView();
-                console.log('🛑 Animation stop requested');
-            }
+                console.log("🛑 Animation stop requested");
+            },
         };
     }
 }

package/dist/types/user-session.d.ts

@@ -1,10 +1,10 @@
-import { WebSocket } from 'ws';
-import { AppI, TranscriptI } from './models';
-import { DisplayRequest } from './layouts';
-import { Transform } from 'stream';
-import { ConversationTranscriber, PushAudioInputStream } from 'microsoft-cognitiveservices-speech-sdk';
-import { ExtendedStreamType } from './streams';
-import pino from 'pino';
+import { WebSocket } from "ws";
+import { AppI, TranscriptI } from "./models";
+import { DisplayRequest } from "./layouts";
+import { Transform } from "stream";
+import { ConversationTranscriber, PushAudioInputStream } from "microsoft-cognitiveservices-speech-sdk";
+import { ExtendedStreamType } from "./streams";
+import pino from "pino";
 /**
  * Session for an application
  */
@@ -53,7 +53,7 @@ export interface UserSession {
     installedApps: AppI[];
     activeAppSessions: string[];
     loadingApps: Set<string>;
-    appSubscriptions: Map<string, ExtendedStreamType[]> | Object;
+    appSubscriptions: Map<string, ExtendedStreamType[]> | object;
     appConnections: Map<string, WebSocket>;
     websocket: WebSocket;
     transcript: TranscriptI;

package/dist/types/user-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-session.d.ts","sourceRoot":"","sources":["../../src/types/user-session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAU,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAc,MAAM,WAAW,CAAC;AAE3D,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AAkBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;CAAG;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IACtF,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACpE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAG5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAGpB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7D,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEvC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,WAAW,CAAA;IAGvB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,aAAa,EAAE,eAAe,EAAE,CAAC;IAGjC,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED;;GAEG"}
+{"version":3,"file":"user-session.d.ts","sourceRoot":"","sources":["../../src/types/user-session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAU,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAc,MAAM,WAAW,CAAC;AAE3D,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AAkBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;CAAG;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAChB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IACX,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACpE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAG5B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAGpB,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7D,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEvC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,WAAW,CAAC;IAGxB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,aAAa,EAAE,eAAe,EAAE,CAAC;IAGjC,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAG5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED;;GAEG"}

package/dist/utils/animation-utils.d.ts

@@ -20,8 +20,8 @@
  * animation.stop();
  * ```
  */
-import { AppSession } from '../app/session';
-import { LoadFramesOptions } from './bitmap-utils';
+import { AppSession } from "../app/session";
+import { LoadFramesOptions } from "./bitmap-utils";
 /**
  * Configuration options for bitmap animations
  */
@@ -132,7 +132,7 @@ export declare class AnimationUtils {
      * );
      * ```
      */
-    static createBitmapAnimationFromFrames(session: AppSession, frames: string[], config?: Omit<AnimationConfig, 'loadOptions' | 'validateFrames'>): AnimationController;
+    static createBitmapAnimationFromFrames(session: AppSession, frames: string[], config?: Omit<AnimationConfig, "loadOptions" | "validateFrames">): AnimationController;
     /**
      * Create a sequence of bitmap displays with custom timing
      *
@@ -182,7 +182,7 @@ export declare class AnimationUtils {
      * );
      * ```
      */
-    static getOptimizedConfig(deviceType: 'even-realities-g1' | 'generic'): AnimationConfig;
+    static getOptimizedConfig(deviceType: "even-realities-g1" | "generic"): AnimationConfig;
     /**
      * Preload and cache animation frames for better performance
      *

package/dist/utils/animation-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation-utils.d.ts","sourceRoot":"","sources":["../../src/utils/animation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAe,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,cAAc,EAAE,MAAM,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,cAAc;IAEvB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;WACU,qBAAqB,CAC9B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,eAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAgD/B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,+BAA+B,CAClC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,gBAAgB,CAAM,GACrE,mBAAmB;IAyFtB;;;;;;;;;;;;;;;OAeG;WACU,oBAAoB,CAC7B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;;;;;;OAaG;WACU,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,GAAE,MAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA0CxG;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,GAAG,eAAe;IA2BvF;;;;;;;;;;;;;;;;;OAiBG;WACU,aAAa,CACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;CAYvB"}
+{"version":3,"file":"animation-utils.d.ts","sourceRoot":"","sources":["../../src/utils/animation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAe,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,cAAc,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;WACU,qBAAqB,CAChC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAkD/B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,+BAA+B,CACpC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,gBAAgB,CAAM,GACnE,mBAAmB;IA6FtB;;;;;;;;;;;;;;;OAeG;WACU,oBAAoB,CAC/B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;;;;;;;;;;;OAaG;WACU,aAAa,CACxB,cAAc,EAAE,MAAM,EACtB,eAAe,GAAE,MAAc,GAC9B,OAAO,CAAC,UAAU,CAAC;IA2CtB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kBAAkB,CACvB,UAAU,EAAE,mBAAmB,GAAG,SAAS,GAC1C,eAAe;IA2BlB;;;;;;;;;;;;;;;;;OAiBG;WACU,aAAa,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;CAcrB"}

package/dist/utils/animation-utils.js

@@ -42,7 +42,7 @@ class AnimationUtils {
      * ```
      */
     static delay(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
+        return new Promise((resolve) => setTimeout(resolve, ms));
     }
     /**
      * Create bitmap animation from files with advanced configuration
@@ -74,16 +74,16 @@ class AnimationUtils {
      */
     static async createBitmapAnimation(session, basePath, frameCount, config = {}) {
         const { intervalMs = 1750, // Optimized for MentraOS hardware
-        repeat = false, validateFrames = true, loadOptions = {}, onStart, onStop, onFrame, onError } = config;
+        repeat = false, validateFrames = true, loadOptions = {}, onStart, onStop, onFrame, onError, } = config;
         try {
             console.log(`🎬 Loading ${frameCount} animation frames from ${basePath}...`);
             // Load frames with validation
             const frames = await bitmap_utils_1.BitmapUtils.loadBmpFrames(basePath, frameCount, {
                 validateFrames,
-                ...loadOptions
+                ...loadOptions,
             });
             if (frames.length === 0) {
-                throw new Error('No frames loaded for animation');
+                throw new Error("No frames loaded for animation");
             }
             console.log(`📚 Animation ready: ${frames.length} frames at ${intervalMs}ms intervals`);
             // Create enhanced animation with the loaded frames
@@ -93,11 +93,11 @@ class AnimationUtils {
                 onStart,
                 onStop,
                 onFrame,
-                onError
+                onError,
             });
         }
         catch (error) {
-            const errorMsg = `Failed to create animation: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            const errorMsg = `Failed to create animation: ${error instanceof Error ? error.message : "Unknown error"}`;
             console.error(`❌ ${errorMsg}`);
             if (onError) {
                 onError(errorMsg);
@@ -122,9 +122,9 @@ class AnimationUtils {
      * ```
      */
     static createBitmapAnimationFromFrames(session, frames, config = {}) {
-        const { intervalMs = 1750, repeat = false, onStart, onStop, onFrame, onError } = config;
+        const { intervalMs = 1750, repeat = false, onStart, onStop, onFrame, onError, } = config;
         let isRunning = false;
-        let currentFrame = 0;
+        const currentFrame = 0;
         let animationController = null;
         const controller = {
             stop: () => {
@@ -136,11 +136,11 @@ class AnimationUtils {
                 if (onStop) {
                     onStop();
                 }
-                console.log('🛑 Animation stopped');
+                console.log("🛑 Animation stopped");
             },
             isRunning: () => isRunning,
             getCurrentFrame: () => currentFrame,
-            getTotalFrames: () => frames.length
+            getTotalFrames: () => frames.length,
         };
         try {
             // Start the animation using the session's built-in method
@@ -149,7 +149,7 @@ class AnimationUtils {
             if (onStart) {
                 onStart();
             }
-            console.log(`🎬 Animation started: ${frames.length} frames at ${intervalMs}ms${repeat ? ' (repeating)' : ''}`);
+            console.log(`🎬 Animation started: ${frames.length} frames at ${intervalMs}ms${repeat ? " (repeating)" : ""}`);
             // If we have frame callbacks, we need to track timing manually
             // This is a limitation of the current SDK - we can't hook into individual frame displays
             if (onFrame) {
@@ -177,7 +177,7 @@ class AnimationUtils {
             }
         }
         catch (error) {
-            const errorMsg = `Failed to start animation: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            const errorMsg = `Failed to start animation: ${error instanceof Error ? error.message : "Unknown error"}`;
             console.error(`❌ ${errorMsg}`);
             if (onError) {
                 onError(errorMsg);
@@ -209,7 +209,8 @@ class AnimationUtils {
             try {
                 console.log(`📽️ Sequence frame ${i + 1}/${sequence.length} (${duration}ms)`);
                 session.layouts.showBitmapView(frame);
-                if (i < sequence.length - 1) { // Don't delay after the last frame
+                if (i < sequence.length - 1) {
+                    // Don't delay after the last frame
                     await this.delay(duration);
                 }
             }
@@ -218,7 +219,7 @@ class AnimationUtils {
                 throw error;
             }
         }
-        console.log('✅ Bitmap sequence completed');
+        console.log("✅ Bitmap sequence completed");
     }
     /**
      * Measure animation timing performance
@@ -237,7 +238,7 @@ class AnimationUtils {
     static async measureTiming(targetInterval, measureDuration = 10000) {
         return new Promise((resolve) => {
             const timestamps = [];
-            let startTime = Date.now();
+            const startTime = Date.now();
             const measureInterval = setInterval(() => {
                 timestamps.push(Date.now());
             }, targetInterval);
@@ -248,7 +249,7 @@ class AnimationUtils {
                         targetInterval,
                         actualInterval: targetInterval,
                         drift: 0,
-                        fps: 1000 / targetInterval
+                        fps: 1000 / targetInterval,
                     });
                     return;
                 }
@@ -264,7 +265,7 @@ class AnimationUtils {
                     targetInterval,
                     actualInterval,
                     drift,
-                    fps
+                    fps,
                 });
             }, measureDuration);
         });
@@ -285,17 +286,17 @@ class AnimationUtils {
      */
     static getOptimizedConfig(deviceType) {
         switch (deviceType) {
-            case 'even-realities-g1':
+            case "even-realities-g1":
                 return {
                     intervalMs: 1650, // Tested optimal timing for Even Realities G1
                     repeat: false,
                     validateFrames: true,
                     loadOptions: {
                         validateFrames: true,
-                        skipMissingFrames: false
-                    }
+                        skipMissingFrames: false,
+                    },
                 };
-            case 'generic':
+            case "generic":
             default:
                 return {
                     intervalMs: 1000,
@@ -303,8 +304,8 @@ class AnimationUtils {
                     validateFrames: true,
                     loadOptions: {
                         validateFrames: true,
-                        skipMissingFrames: false
-                    }
+                        skipMissingFrames: false,
+                    },
                 };
         }
     }
@@ -330,7 +331,7 @@ class AnimationUtils {
         console.log(`📦 Preloading ${frameCount} frames from ${basePath}...`);
         const frames = await bitmap_utils_1.BitmapUtils.loadBmpFrames(basePath, frameCount, {
             validateFrames: true,
-            ...options
+            ...options,
         });
         console.log(`✅ Preloaded ${frames.length} frames (${frames.reduce((total, frame) => total + frame.length, 0)} total characters)`);
         return frames;

package/dist/utils/bitmap-utils.d.ts

@@ -70,7 +70,9 @@ export declare class BitmapUtils {
      * session.layouts.showBitmapView(bmpHex);
      * ```
      */
-    static loadBmpAsHex(filePath: string): Promise<string>;
+    static loadBmpFromFileAsHex(filePath: string): Promise<string>;
+    static convert24BitTo1BitBMP(input24BitBmp: Buffer): Promise<Buffer>;
+    static loadBmpFromDataAsHex(bmpData: Buffer): Promise<string>;
     /**
      * Load multiple BMP frames as hex array for animations
      *
@@ -123,7 +125,7 @@ export declare class BitmapUtils {
      * const bufferData = BitmapUtils.convertFormat(base64Data, 'base64', 'buffer');
      * ```
      */
-    static convertFormat(data: string | Buffer, fromFormat: 'hex' | 'base64' | 'buffer', toFormat: 'hex' | 'base64' | 'buffer'): string | Buffer;
+    static convertFormat(data: string | Buffer, fromFormat: "hex" | "base64" | "buffer", toFormat: "hex" | "base64" | "buffer"): string | Buffer;
     /**
      * Get bitmap information without full validation
      *

package/dist/utils/bitmap-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitmap-utils.d.ts","sourceRoot":"","sources":["../../src/utils/bitmap-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QACT,iDAAiD;QACjD,UAAU,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,8BAA8B;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB;;;;;;;;;;;;OAYG;WACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5D;;;;;;;;;;;;;;;;;;;OAmBG;WACU,aAAa,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IA0DpB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAkF1D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa,CAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EACvC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GACpC,MAAM,GAAG,MAAM;IA+BlB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;KACrB;CAmCF"}
+{"version":3,"file":"bitmap-utils.d.ts","sourceRoot":"","sources":["../../src/utils/bitmap-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QACT,iDAAiD;QACjD,UAAU,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,8BAA8B;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;;;;OAYG;WACU,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAevD,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WA+G7D,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiDnE;;;;;;;;;;;;;;;;;;;OAmBG;WACU,aAAa,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IAgEpB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IA+F1D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa,CAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EACvC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GACpC,MAAM,GAAG,MAAM;IA+BlB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;KACrB;CAsCF"}

package/dist/utils/bitmap-utils.js

@@ -55,6 +55,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BitmapUtils = void 0;
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
+const jimp_1 = require("jimp");
 /**
  * Utility class for working with bitmap images in MentraOS applications
  */
@@ -72,16 +73,10 @@ class BitmapUtils {
      * session.layouts.showBitmapView(bmpHex);
      * ```
      */
-    static async loadBmpAsHex(filePath) {
+    static async loadBmpFromFileAsHex(filePath) {
         try {
             const bmpData = await fs.readFile(filePath);
-            // Basic BMP validation - check for BMP signature
-            if (bmpData.length < 14 || bmpData[0] !== 0x42 || bmpData[1] !== 0x4D) {
-                throw new Error(`File ${filePath} is not a valid BMP file (missing BM signature)`);
-            }
-            const hexString = bmpData.toString('hex');
-            console.log(`📁 Loaded BMP: ${path.basename(filePath)} (${bmpData.length} bytes)`);
-            return hexString;
+            return this.loadBmpFromDataAsHex(bmpData);
         }
         catch (error) {
             if (error instanceof Error) {
@@ -90,6 +85,136 @@ class BitmapUtils {
             throw new Error(`Failed to load BMP file ${filePath}: Unknown error`);
         }
     }
+    static async convert24BitTo1BitBMP(input24BitBmp) {
+        // Read header information from 24-bit BMP
+        const width = input24BitBmp.readUInt32LE(18);
+        const height = Math.abs(input24BitBmp.readInt32LE(22)); // Height can be negative (top-down BMP)
+        const isTopDown = input24BitBmp.readInt32LE(22) < 0;
+        const bitsPerPixel = input24BitBmp.readUInt16LE(28);
+        if (bitsPerPixel !== 24) {
+            throw new Error("Input must be a 24-bit BMP");
+        }
+        // Calculate row sizes (both must be 4-byte aligned)
+        const rowSize24 = Math.ceil((width * 3) / 4) * 4;
+        const rowSize1 = Math.ceil(width / 32) * 4; // 32 pixels per 4 bytes
+        // Calculate sizes for 1-bit BMP
+        const colorTableSize = 8; // 2 colors * 4 bytes each
+        const headerSize = 54 + colorTableSize;
+        const pixelDataSize = rowSize1 * height;
+        const fileSize = headerSize + pixelDataSize;
+        // Create new buffer for 1-bit BMP
+        const output1BitBmp = Buffer.alloc(fileSize);
+        let offset = 0;
+        // Write BMP file header (14 bytes)
+        output1BitBmp.write("BM", offset);
+        offset += 2; // Signature
+        output1BitBmp.writeUInt32LE(fileSize, offset);
+        offset += 4; // File size
+        output1BitBmp.writeUInt16LE(0, offset);
+        offset += 2; // Reserved 1
+        output1BitBmp.writeUInt16LE(0, offset);
+        offset += 2; // Reserved 2
+        output1BitBmp.writeUInt32LE(headerSize, offset);
+        offset += 4; // Pixel data offset
+        // Write DIB header (40 bytes)
+        output1BitBmp.writeUInt32LE(40, offset);
+        offset += 4; // DIB header size
+        output1BitBmp.writeInt32LE(width, offset);
+        offset += 4; // Width
+        output1BitBmp.writeInt32LE(height, offset);
+        offset += 4; // Height (positive for bottom-up)
+        output1BitBmp.writeUInt16LE(1, offset);
+        offset += 2; // Planes
+        output1BitBmp.writeUInt16LE(1, offset);
+        offset += 2; // Bits per pixel (1-bit)
+        output1BitBmp.writeUInt32LE(0, offset);
+        offset += 4; // Compression (none)
+        output1BitBmp.writeUInt32LE(pixelDataSize, offset);
+        offset += 4; // Image size
+        output1BitBmp.writeInt32LE(2835, offset);
+        offset += 4; // X pixels per meter (72 DPI)
+        output1BitBmp.writeInt32LE(2835, offset);
+        offset += 4; // Y pixels per meter (72 DPI)
+        output1BitBmp.writeUInt32LE(2, offset);
+        offset += 4; // Colors used
+        output1BitBmp.writeUInt32LE(2, offset);
+        offset += 4; // Important colors
+        // Write color table (8 bytes)
+        // Black (index 0): B=0, G=0, R=0, Reserved=0
+        output1BitBmp.writeUInt32LE(0x00000000, offset);
+        offset += 4;
+        // White (index 1): B=255, G=255, R=255, Reserved=0
+        output1BitBmp.writeUInt8(255, offset++); // Blue
+        output1BitBmp.writeUInt8(255, offset++); // Green
+        output1BitBmp.writeUInt8(255, offset++); // Red
+        output1BitBmp.writeUInt8(0, offset++); // Reserved
+        // Convert pixel data from 24-bit to 1-bit
+        const pixelDataStart24 = 54; // 24-bit BMP has no color table
+        for (let y = 0; y < height; y++) {
+            // BMP files are usually stored bottom-up
+            const sourceY = isTopDown ? y : height - 1 - y;
+            const destY = height - 1 - y; // Always write bottom-up for compatibility
+            // Initialize the row with zeros
+            const rowData = Buffer.alloc(rowSize1);
+            for (let x = 0; x < width; x++) {
+                // Get pixel from 24-bit BMP
+                const offset24 = pixelDataStart24 + sourceY * rowSize24 + x * 3;
+                const blue = input24BitBmp[offset24];
+                const green = input24BitBmp[offset24 + 1];
+                const red = input24BitBmp[offset24 + 2];
+                // Determine if pixel is white (assuming pure black or white)
+                // White = 1, Black = 0
+                const isWhite = red > 128 || green > 128 || blue > 128 ? 1 : 0;
+                // Calculate bit position
+                const byteIndex = Math.floor(x / 8);
+                const bitPosition = 7 - (x % 8); // MSB first
+                // Set bit if white
+                if (isWhite) {
+                    rowData[byteIndex] |= 1 << bitPosition;
+                }
+            }
+            // Write row to output buffer
+            const destOffset = offset + destY * rowSize1;
+            rowData.copy(output1BitBmp, destOffset);
+        }
+        return output1BitBmp;
+    }
+    static async loadBmpFromDataAsHex(bmpData) {
+        try {
+            // Basic BMP validation - check for BMP signature
+            if (bmpData.length < 14 || bmpData[0] !== 0x42 || bmpData[1] !== 0x4d) {
+                throw new Error(`Bmp data is not a valid BMP file (missing BM signature)`);
+            }
+            let finalBmpData = bmpData;
+            // Load the image with Jimp
+            const image = await jimp_1.Jimp.read(bmpData);
+            // Check if we need to add padding
+            if (image.width !== 576 || image.height !== 135) {
+                console.log(`Adding padding to BMP since it isn't 576x135 (current: ${image.width}x${image.height})`);
+                // Create a new 576x135 white canvas
+                const paddedImage = new jimp_1.Jimp({
+                    width: 576,
+                    height: 135,
+                    color: 0xffffffff,
+                });
+                // // Calculate position to place the original image (with padding)
+                const leftPadding = 40; // 40px padding on left
+                const topPadding = 35; // 35px padding on top
+                // Composite the original image onto the white canvas
+                paddedImage.composite(image, leftPadding, topPadding);
+                finalBmpData = await this.convert24BitTo1BitBMP(await paddedImage.getBuffer("image/bmp"));
+            }
+            // No padding needed, just return as hex
+            console.log(`finalBmpData: ${finalBmpData.length} bytes`);
+            return finalBmpData.toString("hex");
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to load BMP data: ${error.message}`);
+            }
+            throw new Error(`Failed to load BMP data: Unknown error`);
+        }
+    }
     /**
      * Load multiple BMP frames as hex array for animations
      *
@@ -111,19 +236,19 @@ class BitmapUtils {
      * ```
      */
     static async loadBmpFrames(basePath, frameCount, options = {}) {
-        const { filePattern = 'animation_10_frame_{i}.bmp', startFrame = 1, validateFrames = true, skipMissingFrames = false } = options;
+        const { filePattern = "animation_10_frame_{i}.bmp", startFrame = 1, validateFrames = true, skipMissingFrames = false, } = options;
         const frames = [];
         const errors = [];
         for (let i = 0; i < frameCount; i++) {
             const frameNumber = startFrame + i;
-            const fileName = filePattern.replace('{i}', frameNumber.toString());
+            const fileName = filePattern.replace("{i}", frameNumber.toString());
             const filePath = path.join(basePath, fileName);
             try {
-                const frameHex = await this.loadBmpAsHex(filePath);
+                const frameHex = await this.loadBmpFromFileAsHex(filePath);
                 if (validateFrames) {
                     const validation = this.validateBmpHex(frameHex);
                     if (!validation.isValid) {
-                        const errorMsg = `Frame ${frameNumber} validation failed: ${validation.errors.join(', ')}`;
+                        const errorMsg = `Frame ${frameNumber} validation failed: ${validation.errors.join(", ")}`;
                         if (skipMissingFrames) {
                             console.warn(`⚠️ ${errorMsg} - skipping`);
                             continue;
@@ -137,7 +262,7 @@ class BitmapUtils {
                 frames.push(frameHex);
             }
             catch (error) {
-                const errorMsg = `Failed to load frame ${frameNumber} (${fileName}): ${error instanceof Error ? error.message : 'Unknown error'}`;
+                const errorMsg = `Failed to load frame ${frameNumber} (${fileName}): ${error instanceof Error ? error.message : "Unknown error"}`;
                 if (skipMissingFrames) {
                     console.warn(`⚠️ ${errorMsg} - skipping`);
                     continue;
@@ -148,7 +273,7 @@ class BitmapUtils {
             }
         }
         if (errors.length > 0) {
-            throw new Error(`Failed to load frames:\n${errors.join('\n')}`);
+            throw new Error(`Failed to load frames:\n${errors.join("\n")}`);
         }
         if (frames.length === 0) {
             throw new Error(`No valid frames loaded from ${basePath}`);
@@ -176,35 +301,37 @@ class BitmapUtils {
         const errors = [];
         let byteCount = 0;
         let blackPixels = 0;
-        let metadata = {};
+        const metadata = {};
         try {
             // Basic hex validation
-            if (typeof hexString !== 'string' || hexString.length === 0) {
-                errors.push('Hex string is empty or invalid');
+            if (typeof hexString !== "string" || hexString.length === 0) {
+                errors.push("Hex string is empty or invalid");
                 return { isValid: false, byteCount: 0, blackPixels: 0, errors };
             }
             if (hexString.length % 2 !== 0) {
-                errors.push('Hex string length must be even');
+                errors.push("Hex string length must be even");
                 return { isValid: false, byteCount: 0, blackPixels: 0, errors };
             }
             // Convert to buffer
-            const buffer = Buffer.from(hexString, 'hex');
+            const buffer = Buffer.from(hexString, "hex");
             byteCount = buffer.length;
             // BMP signature validation
             if (buffer.length < 14) {
-                errors.push('File too small to be a valid BMP (minimum 14 bytes for header)');
+                errors.push("File too small to be a valid BMP (minimum 14 bytes for header)");
             }
             else {
-                if (buffer[0] !== 0x42 || buffer[1] !== 0x4D) {
+                if (buffer[0] !== 0x42 || buffer[1] !== 0x4d) {
                     errors.push('Invalid BMP signature (should start with "BM")');
                 }
             }
             // Size validation for MentraOS (576x135 = ~9782 bytes expected)
             const expectedSize = 9782;
-            if (buffer.length < expectedSize - 100) { // Allow some tolerance
+            if (buffer.length < expectedSize - 100) {
+                // Allow some tolerance
                 errors.push(`BMP too small (${buffer.length} bytes, expected ~${expectedSize})`);
             }
-            else if (buffer.length > expectedSize + 1000) { // Allow some tolerance
+            else if (buffer.length > expectedSize + 1000) {
+                // Allow some tolerance
                 errors.push(`BMP too large (${buffer.length} bytes, expected ~${expectedSize})`);
             }
             // Extract BMP metadata if header is valid
@@ -214,37 +341,37 @@ class BitmapUtils {
                     const width = buffer.readUInt32LE(18);
                     const height = buffer.readUInt32LE(22);
                     metadata.dimensions = { width, height };
-                    metadata.format = 'BMP';
+                    metadata.format = "BMP";
                     // Validate dimensions for MentraOS glasses
                     if (width !== 576 || height !== 135) {
                         errors.push(`Invalid dimensions (${width}x${height}, expected 576x135 for MentraOS)`);
                     }
                 }
                 catch (e) {
-                    errors.push('Failed to parse BMP header metadata');
+                    errors.push("Failed to parse BMP header metadata");
                 }
             }
             // Pixel data validation (assumes 54-byte header + pixel data)
             if (buffer.length > 62) {
                 const pixelData = buffer.slice(62); // Skip BMP header
-                blackPixels = Array.from(pixelData).filter(b => b !== 0xFF).length;
+                blackPixels = Array.from(pixelData).filter((b) => b !== 0xff).length;
                 if (blackPixels === 0) {
-                    errors.push('No black pixels found (image appears to be all white)');
+                    errors.push("No black pixels found (image appears to be all white)");
                 }
             }
             else {
-                errors.push('File too small to contain pixel data');
+                errors.push("File too small to contain pixel data");
             }
         }
         catch (error) {
-            errors.push(`Failed to parse hex data: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            errors.push(`Failed to parse hex data: ${error instanceof Error ? error.message : "Unknown error"}`);
         }
         return {
             isValid: errors.length === 0,
             byteCount,
             blackPixels,
             errors,
-            metadata: Object.keys(metadata).length > 0 ? metadata : undefined
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
         };
     }
     /**
@@ -265,13 +392,13 @@ class BitmapUtils {
         let buffer;
         // Convert input to buffer
         switch (fromFormat) {
-            case 'hex':
-                buffer = Buffer.from(data, 'hex');
+            case "hex":
+                buffer = Buffer.from(data, "hex");
                 break;
-            case 'base64':
-                buffer = Buffer.from(data, 'base64');
+            case "base64":
+                buffer = Buffer.from(data, "base64");
                 break;
-            case 'buffer':
+            case "buffer":
                 buffer = data;
                 break;
             default:
@@ -279,11 +406,11 @@ class BitmapUtils {
         }
         // Convert buffer to target format
         switch (toFormat) {
-            case 'hex':
-                return buffer.toString('hex');
-            case 'base64':
-                return buffer.toString('base64');
-            case 'buffer':
+            case "hex":
+                return buffer.toString("hex");
+            case "base64":
+                return buffer.toString("base64");
+            case "buffer":
                 return buffer;
             default:
                 throw new Error(`Unsupported target format: ${toFormat}`);
@@ -303,8 +430,8 @@ class BitmapUtils {
      */
     static getBitmapInfo(hexString) {
         try {
-            const buffer = Buffer.from(hexString, 'hex');
-            const isValidBmp = buffer.length >= 14 && buffer[0] === 0x42 && buffer[1] === 0x4D;
+            const buffer = Buffer.from(hexString, "hex");
+            const isValidBmp = buffer.length >= 14 && buffer[0] === 0x42 && buffer[1] === 0x4d;
             let width;
             let height;
             if (isValidBmp && buffer.length >= 54) {
@@ -317,20 +444,20 @@ class BitmapUtils {
                 }
             }
             const pixelData = buffer.slice(62);
-            const blackPixels = Array.from(pixelData).filter(b => b !== 0xFF).length;
+            const blackPixels = Array.from(pixelData).filter((b) => b !== 0xff).length;
             return {
                 byteCount: buffer.length,
                 blackPixels,
                 width,
                 height,
-                isValidBmp
+                isValidBmp,
             };
         }
         catch (error) {
             return {
                 byteCount: 0,
                 blackPixels: 0,
-                isValidBmp: false
+                isValidBmp: false,
             };
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/sdk",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "Build apps for MentraOS smartglasses. This SDK provides everything you need to create real-time smartglasses applications.",
   "source": "src/index.ts",
   "main": "dist/index.js",
@@ -29,6 +29,7 @@
     "cookie-parser": "^1.4.7",
     "dotenv": "^16.4.0",
     "express": "^4.18.2",
+    "jimp": "^1.6.0",
     "jsonwebtoken": "^8.5.1",
     "jsrsasign": "^11.1.0",
     "multer": "^2.0.1",