@mentra/sdk 2.1.9 → 2.1.10

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

@@ -66,13 +66,16 @@ export declare class BitmapUtils {
      *
      * @example
      * ```typescript
-     * const bmpHex = await BitmapUtils.loadBmpAsHex('./assets/icon.bmp');
-     * session.layouts.showBitmapView(bmpHex);
+     * const bmpBase64 = await BitmapUtils.loadBmpFromFileAsBase64('./assets/icon.bmp');
+     * session.layouts.showBitmapView(bmpBase64);
      * ```
      */
+    static loadBmpFromFileAsBase64(filePath: string): Promise<string>;
     static loadBmpFromFileAsHex(filePath: string): Promise<string>;
     static convert24BitTo1BitBMP(input24BitBmp: Buffer): Promise<Buffer>;
     static loadBmpFromDataAsHex(bmpData: Buffer): Promise<string>;
+    static loadBmpFromDataAsBase64(bmpData: Buffer): Promise<string>;
+    static padBmpData(bmpData: Buffer): Promise<Buffer>;
     /**
      * Load multiple BMP frames as hex array for animations
      *
@@ -110,7 +113,7 @@ export declare class BitmapUtils {
      * }
      * ```
      */
-    static validateBmpHex(hexString: string): BitmapValidation;
+    static validateBmpBase64(base64String: string): BitmapValidation;
     /**
      * Convert bitmap data between different formats
      *

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;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;IAkDnE;;;;;;;;;;;;;;;;;;;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"}
+{"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,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAe1D,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;WAKtD,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAKzD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkDzD;;;;;;;;;;;;;;;;;;;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,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB;IAgGhE;;;;;;;;;;;;;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

@@ -69,10 +69,22 @@ class BitmapUtils {
      *
      * @example
      * ```typescript
-     * const bmpHex = await BitmapUtils.loadBmpAsHex('./assets/icon.bmp');
-     * session.layouts.showBitmapView(bmpHex);
+     * const bmpBase64 = await BitmapUtils.loadBmpFromFileAsBase64('./assets/icon.bmp');
+     * session.layouts.showBitmapView(bmpBase64);
      * ```
      */
+    static async loadBmpFromFileAsBase64(filePath) {
+        try {
+            const bmpData = await fs.readFile(filePath);
+            return this.loadBmpFromDataAsBase64(bmpData);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to load BMP file ${filePath}: ${error.message}`);
+            }
+            throw new Error(`Failed to load BMP file ${filePath}: Unknown error`);
+        }
+    }
     static async loadBmpFromFileAsHex(filePath) {
         try {
             const bmpData = await fs.readFile(filePath);
@@ -180,6 +192,14 @@ class BitmapUtils {
         return output1BitBmp;
     }
     static async loadBmpFromDataAsHex(bmpData) {
+        const paddedBmpData = await this.padBmpData(bmpData);
+        return paddedBmpData.toString("hex");
+    }
+    static async loadBmpFromDataAsBase64(bmpData) {
+        const paddedBmpData = await this.padBmpData(bmpData);
+        return paddedBmpData.toString("base64");
+    }
+    static async padBmpData(bmpData) {
         try {
             // Basic BMP validation - check for BMP signature
             if (bmpData.length < 14 || bmpData[0] !== 0x42 || bmpData[1] !== 0x4d) {
@@ -195,7 +215,7 @@ class BitmapUtils {
                 const paddedImage = new jimp_1.Jimp({
                     width: 576,
                     height: 135,
-                    color: 0xffffffff,
+                    color: 0x00000000,
                 });
                 // // Calculate position to place the original image (with padding)
                 const leftPadding = 50; // 45px padding on left
@@ -207,7 +227,7 @@ class BitmapUtils {
             }
             // No padding needed, just return as hex
             console.log(`finalBmpData: ${finalBmpData.length} bytes`);
-            return finalBmpData.toString("hex");
+            return finalBmpData;
         }
         catch (error) {
             if (error instanceof Error) {
@@ -245,9 +265,9 @@ class BitmapUtils {
             const fileName = filePattern.replace("{i}", frameNumber.toString());
             const filePath = path.join(basePath, fileName);
             try {
-                const frameHex = await this.loadBmpFromFileAsHex(filePath);
+                const frameHex = await this.loadBmpFromFileAsBase64(filePath);
                 if (validateFrames) {
-                    const validation = this.validateBmpHex(frameHex);
+                    const validation = this.validateBmpBase64(frameHex);
                     if (!validation.isValid) {
                         const errorMsg = `Frame ${frameNumber} validation failed: ${validation.errors.join(", ")}`;
                         if (skipMissingFrames) {
@@ -298,12 +318,13 @@ class BitmapUtils {
      * }
      * ```
      */
-    static validateBmpHex(hexString) {
+    static validateBmpBase64(base64String) {
         const errors = [];
         let byteCount = 0;
         let blackPixels = 0;
         const metadata = {};
         try {
+            const hexString = Buffer.from(base64String, "base64").toString("hex");
             // Basic hex validation
             if (typeof hexString !== "string" || hexString.length === 0) {
                 errors.push("Hex string is empty or invalid");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/sdk",
-  "version": "2.1.9",
+  "version": "2.1.10",
   "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",