@altronix/webtobin 0.6.0 → 0.8.0

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@altronix/webtobin",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "description": "",
   "main": "./webtobin.mjs",
   "types": "./webtobin.d.ts",
-  "scripts": {
-    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules npx jest"
-  },
   "files": [
     "webtobin.d.ts",
     "webtobin.mjs",
@@ -16,9 +13,11 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "packageManager": "pnpm@10.5.2",
   "devDependencies": {
     "cross-env": "^10.0.0",
     "jest": "^30.1.3"
+  },
+  "scripts": {
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules npx jest"
   }
-}
+}

package/webtobin.d.ts

@@ -1,7 +1,55 @@
-export default class {
+export interface McubootVersion {
+  major: number;
+  minor: number;
+  revision: number;
+  build: number;
+}
+
+export interface McubootHeader {
+  magic: number;
+  loadAddr: number;
+  hdrSize: number;
+  protectTlvSize: number;
+  imgSize: number;
+  flags: number;
+  version: McubootVersion;
+}
+
+export interface McubootTlv {
+  type: number;
+  value: Uint8Array;
+}
+
+export interface McubootImage {
+  header: McubootHeader;
+  /** Inner firmware data only */
+  image: Uint8Array;
+  /** Full MCUboot signed image (header + data + TLVs) */
+  signedImage: Uint8Array;
+  protectedTlvs: McubootTlv[];
+  tlvs: McubootTlv[];
+}
+
+export function parseMcubootImages(bin: Buffer | Uint8Array): McubootImage[];
+
+export class AltronixImage {
+  partitionIndex: number;
+  partitionName: string;
+  constructor(mcubootImage: McubootImage);
+  static fromMcubootImage(img: McubootImage): AltronixImage;
+  readTlv(type: number): Uint8Array | null;
+  get header(): McubootHeader;
+  /** Inner firmware data only */
+  get image(): Uint8Array;
+  /** Full MCUboot signed image (header + data + TLVs) */
+  get signedImage(): Uint8Array;
+  get version(): McubootVersion;
+}
+
+export default class Webtobin {
   constructor();
   files: { path: string; data: Uint8Array }[];
-  static from(bin: Uint8Array): this;
+  static from(bin: Uint8Array): Webtobin;
   append(path: string, data: string | Uint8Array): this;
   remove(path: string): this;
   print(): Uint8Array;

package/webtobin.mjs

@@ -32,7 +32,8 @@ const TLV_PROT_INFO_MAGIC = 0x6908;
 /**
  * @typedef {Object} McubootImage
  * @property {McubootHeader} header
- * @property {Uint8Array} image
+ * @property {Uint8Array} image - Inner firmware data only
+ * @property {Uint8Array} signedImage - Full MCUboot signed image (header + data + TLVs)
  * @property {McubootTlv[]} protectedTlvs
  * @property {McubootTlv[]} tlvs
  */
@@ -80,7 +81,8 @@ export function parseMcubootImages(bin) {
       tlvOffset += tlvSize;
     }
 
-    images.push({ header, image, protectedTlvs, tlvs });
+    const signedImage = new Uint8Array(buf.slice(offset, tlvOffset));
+    images.push({ header, image, signedImage, protectedTlvs, tlvs });
     offset = tlvOffset;
   }
 
@@ -198,11 +200,16 @@ export class AltronixImage {
     return this.#mcuboot.header;
   }
 
-  /** @returns {Uint8Array} */
+  /** @returns {Uint8Array} Inner firmware data only */
   get image() {
     return this.#mcuboot.image;
   }
 
+  /** @returns {Uint8Array} Full MCUboot signed image (header + data + TLVs) */
+  get signedImage() {
+    return this.#mcuboot.signedImage;
+  }
+
   /** @returns {McubootVersion} */
   get version() {
     return this.#mcuboot.header.version;