✨ feat: initial commit

src/__tests__/fixtures/invalid-image.txt

@@ -0,0 +1 @@
+you know, p-chan, ive always really - *clank clank clank clank*

src/__tests__/fixtures/known-packets.json

@@ -0,0 +1,48 @@
+{
+  "knownPackets": {
+    "imageInfo": {
+      "description": "Image info packet: {\"type\":6,\"number\":1}",
+      "hex": "f10600000000001a7b2274797065223a362c226e756d626572223a317d77"
+    },
+    "deviceStatusResponse": {
+      "description": "Device status response Type 13",
+      "hex": "7b2274797065223a31332c22616c6c7370616365223a31363338342c22667265657370616365223a31333839322c226465766e616d65223a224265616d426f78222c2273697a65223a223634783332222c226272616e64223a317d",
+      "json": {
+        "type": 13,
+        "allspace": 16384,
+        "freespace": 13892,
+        "devname": "BeamBox",
+        "size": "64x32",
+        "brand": 1
+      }
+    },
+    "getPacketSuccess": {
+      "description": "Success response from device",
+      "text": "GetPacketSuccess"
+    },
+    "getPacketFail": {
+      "description": "Failure response from device",
+      "text": "GetPacketFail"
+    },
+    "errorResponse": {
+      "description": "Error response from device",
+      "text": "1111111111"
+    }
+  },
+  "expectedHeaders": [
+    {
+      "description": "1KB JPEG, 64x32",
+      "jpegSize": 1024,
+      "width": 64,
+      "height": 32,
+      "hex": "494d4200000000240000041800000b0040002000000024000004000000000000000000"
+    },
+    {
+      "description": "100 byte JPEG, 128x64",
+      "jpegSize": 100,
+      "width": 128,
+      "height": 64,
+      "hex": "494d4200000000240000008800000b0080004000000024000000640000000000000000"
+    }
+  ]
+}

src/__tests__/utils/test-helpers.ts

@@ -0,0 +1,117 @@
+/**
+ * Test utilities and helpers for BeamBox tests
+ */
+
+/**
+ * Compare buffer content as hex strings
+ */
+export function expectHex(actual: Buffer, expected: string): void {
+  const actualHex = actual.toString("hex").toLowerCase();
+  const expectedHex = expected.toLowerCase().replace(/\s/g, "");
+  
+  if (actualHex !== expectedHex) {
+    throw new Error(
+      `Hex mismatch:\nExpected: ${expectedHex}\nActual:   ${actualHex}`
+    );
+  }
+}
+
+/**
+ * Convert hex string to Buffer
+ */
+export function hexToBuffer(hex: string): Buffer {
+  return Buffer.from(hex.replace(/\s/g, ""), "hex");
+}
+
+/**
+ * Create a test JPEG buffer (minimal valid JPEG)
+ * This is a 1x1 pixel red JPEG
+ */
+export function createTestJpeg(size: number = 631): Buffer {
+  // Minimal valid JPEG header + data
+  const minimalJpeg = Buffer.from([
+    0xff, 0xd8, 0xff, 0xe0, 0x00, 0x10, 0x4a, 0x46, 0x49, 0x46, 0x00, 0x01,
+    0x01, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0xff, 0xdb, 0x00, 0x43,
+    0x00, 0x08, 0x06, 0x06, 0x07, 0x06, 0x05, 0x08, 0x07, 0x07, 0x07, 0x09,
+    0x09, 0x08, 0x0a, 0x0c, 0x14, 0x0d, 0x0c, 0x0b, 0x0b, 0x0c, 0x19, 0x12,
+    0x13, 0x0f, 0x14, 0x1d, 0x1a, 0x1f, 0x1e, 0x1d, 0x1a, 0x1c, 0x1c, 0x20,
+    0x24, 0x2e, 0x27, 0x20, 0x22, 0x2c, 0x23, 0x1c, 0x1c, 0x28, 0x37, 0x29,
+    0x2c, 0x30, 0x31, 0x34, 0x34, 0x34, 0x1f, 0x27, 0x39, 0x3d, 0x38, 0x32,
+    0x3c, 0x2e, 0x33, 0x34, 0x32, 0xff, 0xc0, 0x00, 0x0b, 0x08, 0x00, 0x01,
+    0x00, 0x01, 0x01, 0x01, 0x11, 0x00, 0xff, 0xc4, 0x00, 0x14, 0x00, 0x01,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x03, 0xff, 0xc4, 0x00, 0x14, 0x10, 0x01, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0xff, 0xda, 0x00, 0x08, 0x01, 0x01, 0x00, 0x00, 0x3f, 0x00,
+    0x37, 0xff, 0xd9,
+  ]);
+
+  if (size <= minimalJpeg.length) {
+    return minimalJpeg;
+  }
+
+  // Pad to requested size by inserting data before EOI marker
+  const padding = Buffer.alloc(size - minimalJpeg.length, 0xff);
+  const withoutEOI = minimalJpeg.subarray(0, minimalJpeg.length - 2);
+  const EOI = minimalJpeg.subarray(minimalJpeg.length - 2);
+  return Buffer.concat([withoutEOI, padding, EOI]);
+}
+
+/**
+ * Create a test PNG buffer (minimal valid PNG)
+ * This is a 1x1 pixel transparent PNG
+ */
+export function createTestPng(): Buffer {
+  return Buffer.from([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0x00, 0x00, 0x00, 0x0d,
+    0x49, 0x48, 0x44, 0x52, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01,
+    0x08, 0x06, 0x00, 0x00, 0x00, 0x1f, 0x15, 0xc4, 0x89, 0x00, 0x00, 0x00,
+    0x0a, 0x49, 0x44, 0x41, 0x54, 0x78, 0x9c, 0x63, 0x00, 0x01, 0x00, 0x00,
+    0x05, 0x00, 0x01, 0x0d, 0x0a, 0x2d, 0xb4, 0x00, 0x00, 0x00, 0x00, 0x49,
+    0x45, 0x4e, 0x44, 0xae, 0x42, 0x60, 0x82,
+  ]);
+}
+
+/**
+ * Calculate checksum for protocol packet
+ */
+export function calculateChecksum(data: Buffer): number {
+  let sum = 0;
+  for (let i = 0; i < data.length; i++) {
+    sum += data[i]!;
+  }
+  return (-sum & 0xff);
+}
+
+/**
+ * Create a mock logger that captures log calls
+ */
+export class MockLogger {
+  public logs: Array<{ level: string; message: string; args: any[] }> = [];
+
+  info(message: string, ...args: any[]) {
+    this.logs.push({ level: "info", message, args });
+  }
+
+  debug(message: string, ...args: any[]) {
+    this.logs.push({ level: "debug", message, args });
+  }
+
+  warning(message: string, ...args: any[]) {
+    this.logs.push({ level: "warning", message, args });
+  }
+
+  error(message: string, ...args: any[]) {
+    this.logs.push({ level: "error", message, args });
+  }
+
+  clear() {
+    this.logs = [];
+  }
+
+  hasLog(level: string, messageFragment: string): boolean {
+    return this.logs.some(
+      (log) => log.level === level && log.message.includes(messageFragment)
+    );
+  }
+}