@standardagents/builder 0.9.17 → 0.10.0

package/dist/image-processing.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Server-side image processing for Cloudflare Workers
+ *
+ * Features:
+ * - Compress/resize images >2MB to fit under 2MB target
+ * - Convert AVIF/WebP to JPEG/PNG
+ * - Preserve PNG transparency (don't convert transparent PNGs to JPEG)
+ * - Smart quality optimization: quality first, dimensions last
+ */
+interface ProcessedImage {
+    data: ArrayBuffer;
+    mimeType: "image/jpeg" | "image/png";
+    width: number;
+    height: number;
+}
+/**
+ * Process an image to ensure it's under 2MB and in a supported format.
+ *
+ * @param input - Raw image data as ArrayBuffer
+ * @param inputMimeType - MIME type hint (used as fallback for format detection)
+ * @returns Processed image data with updated mimeType and dimensions
+ */
+declare function processImage(input: ArrayBuffer, inputMimeType: string): Promise<ProcessedImage>;
+/**
+ * Check if an image needs processing based on size and format.
+ *
+ * @param data - Base64-encoded image data
+ * @param mimeType - MIME type of the image
+ * @returns true if processing is needed
+ */
+declare function needsProcessing(data: string, mimeType: string): boolean;
+/**
+ * Convert base64 string to ArrayBuffer
+ */
+declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+/**
+ * Convert ArrayBuffer to base64 string
+ */
+declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+
+export { type ProcessedImage, arrayBufferToBase64, base64ToArrayBuffer, needsProcessing, processImage };

package/dist/image-processing.js

@@ -0,0 +1,198 @@
+import { PhotonImage, resize, SamplingFilter } from '@cf-wasm/photon/workerd';
+import { decode } from '@jsquash/avif';
+import { encode } from '@jsquash/png';
+
+// src/image-processing/index.ts
+var MAX_SIZE = 1.5 * 1024 * 1024;
+var MAX_DIMENSION = 8192;
+var MAX_INPUT_SIZE = 20 * 1024 * 1024;
+async function processImage(input, inputMimeType) {
+  if (input.byteLength > MAX_INPUT_SIZE) {
+    throw new Error(`Image too large: ${input.byteLength} bytes exceeds ${MAX_INPUT_SIZE} byte limit`);
+  }
+  const format = detectFormat(input, inputMimeType);
+  let photonImage;
+  if (format === "avif") {
+    const imageData = await decode(input);
+    photonImage = new PhotonImage(
+      new Uint8Array(imageData.data.buffer),
+      imageData.width,
+      imageData.height
+    );
+  } else {
+    photonImage = PhotonImage.new_from_byteslice(new Uint8Array(input));
+  }
+  try {
+    const width = photonImage.get_width();
+    const height = photonImage.get_height();
+    if (width > MAX_DIMENSION || height > MAX_DIMENSION) {
+      const scale = Math.min(MAX_DIMENSION / width, MAX_DIMENSION / height);
+      const newWidth = Math.floor(width * scale);
+      const newHeight = Math.floor(height * scale);
+      const resized = resize(photonImage, newWidth, newHeight, SamplingFilter.Lanczos3);
+      photonImage.free();
+      photonImage = resized;
+    }
+    const hasAlpha = detectAlphaChannel(photonImage);
+    return await encodeWithSizeLimit(photonImage, hasAlpha, MAX_SIZE);
+  } finally {
+    photonImage.free();
+  }
+}
+function detectFormat(data, mimeType) {
+  const bytes = new Uint8Array(data.slice(0, 12));
+  if (bytes[4] === 102 && bytes[5] === 116 && bytes[6] === 121 && bytes[7] === 112) {
+    const brand = String.fromCharCode(...bytes.slice(8, 12));
+    if (brand === "avif" || brand === "avis") return "avif";
+  }
+  if (bytes[0] === 137 && bytes[1] === 80 && bytes[2] === 78 && bytes[3] === 71) {
+    return "png";
+  }
+  if (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255) {
+    return "jpeg";
+  }
+  if (bytes[0] === 82 && bytes[1] === 73 && bytes[2] === 70 && bytes[3] === 70 && bytes[8] === 87 && bytes[9] === 69 && bytes[10] === 66 && bytes[11] === 80) {
+    return "webp";
+  }
+  if (mimeType.includes("png")) return "png";
+  if (mimeType.includes("webp")) return "webp";
+  if (mimeType.includes("avif")) return "avif";
+  return "jpeg";
+}
+function detectAlphaChannel(image) {
+  const rawPixels = image.get_raw_pixels();
+  for (let i = 3; i < rawPixels.length; i += 4) {
+    if (rawPixels[i] < 255) {
+      return true;
+    }
+  }
+  return false;
+}
+async function encodeWithSizeLimit(image, hasAlpha, maxSize) {
+  const originalWidth = image.get_width();
+  const originalHeight = image.get_height();
+  if (!hasAlpha) {
+    const qualityLevels = [92, 85, 75, 65, 55, 45];
+    for (const quality of qualityLevels) {
+      const encoded3 = image.get_bytes_jpeg(quality);
+      if (encoded3.byteLength <= maxSize) {
+        return {
+          data: encoded3.buffer,
+          mimeType: "image/jpeg",
+          width: originalWidth,
+          height: originalHeight
+        };
+      }
+    }
+    let scale2 = 0.9;
+    while (scale2 > 0.15) {
+      const newWidth = Math.floor(originalWidth * scale2);
+      const newHeight = Math.floor(originalHeight * scale2);
+      if (newWidth < 100 || newHeight < 100) {
+        scale2 *= 0.9;
+        continue;
+      }
+      const resized = resize(image, newWidth, newHeight, SamplingFilter.Lanczos3);
+      for (const quality of qualityLevels) {
+        const encoded3 = resized.get_bytes_jpeg(quality);
+        if (encoded3.byteLength <= maxSize) {
+          const result2 = {
+            data: encoded3.buffer,
+            mimeType: "image/jpeg",
+            width: newWidth,
+            height: newHeight
+          };
+          resized.free();
+          return result2;
+        }
+      }
+      resized.free();
+      scale2 *= 0.9;
+    }
+    const finalResized2 = resize(
+      image,
+      Math.floor(originalWidth * 0.15),
+      Math.floor(originalHeight * 0.15),
+      SamplingFilter.Lanczos3
+    );
+    const encoded2 = finalResized2.get_bytes_jpeg(45);
+    const result = {
+      data: encoded2.buffer,
+      mimeType: "image/jpeg",
+      width: finalResized2.get_width(),
+      height: finalResized2.get_height()
+    };
+    finalResized2.free();
+    return result;
+  }
+  const imageData = image.get_image_data();
+  let encoded = await encode(imageData);
+  if (encoded.byteLength <= maxSize) {
+    return {
+      data: encoded,
+      mimeType: "image/png",
+      width: originalWidth,
+      height: originalHeight
+    };
+  }
+  let scale = 0.9;
+  while (encoded.byteLength > maxSize && scale > 0.15) {
+    const newWidth = Math.floor(originalWidth * scale);
+    const newHeight = Math.floor(originalHeight * scale);
+    if (newWidth < 100 || newHeight < 100) {
+      scale *= 0.9;
+      continue;
+    }
+    const resized = resize(image, newWidth, newHeight, SamplingFilter.Lanczos3);
+    const resizedImageData = resized.get_image_data();
+    encoded = await encode(resizedImageData);
+    if (encoded.byteLength <= maxSize) {
+      const result = {
+        data: encoded,
+        mimeType: "image/png",
+        width: newWidth,
+        height: newHeight
+      };
+      resized.free();
+      return result;
+    }
+    resized.free();
+    scale *= 0.9;
+  }
+  const finalWidth = Math.floor(originalWidth * 0.15);
+  const finalHeight = Math.floor(originalHeight * 0.15);
+  const finalResized = resize(image, finalWidth, finalHeight, SamplingFilter.Lanczos3);
+  const finalImageData = finalResized.get_image_data();
+  encoded = await encode(finalImageData);
+  finalResized.free();
+  return {
+    data: encoded,
+    mimeType: "image/png",
+    width: finalWidth,
+    height: finalHeight
+  };
+}
+function needsProcessing(data, mimeType) {
+  const binaryLength = Math.ceil(data.length * 3 / 4);
+  return binaryLength > MAX_SIZE || mimeType.includes("avif") || mimeType.includes("webp");
+}
+function base64ToArrayBuffer(base64) {
+  const binaryString = atob(base64);
+  const bytes = new Uint8Array(binaryString.length);
+  for (let i = 0; i < binaryString.length; i++) {
+    bytes[i] = binaryString.charCodeAt(i);
+  }
+  return bytes.buffer;
+}
+function arrayBufferToBase64(buffer) {
+  const bytes = new Uint8Array(buffer);
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+
+export { arrayBufferToBase64, base64ToArrayBuffer, needsProcessing, processImage };
+//# sourceMappingURL=image-processing.js.map
+//# sourceMappingURL=image-processing.js.map

package/dist/image-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/image-processing/index.ts"],"names":["decodeAvif","encoded","scale","result","finalResized","encodePng"],"mappings":"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","file":"image-processing.js","sourcesContent":["/**\n * Server-side image processing for Cloudflare Workers\n *\n * Features:\n * - Compress/resize images >2MB to fit under 2MB target\n * - Convert AVIF/WebP to JPEG/PNG\n * - Preserve PNG transparency (don't convert transparent PNGs to JPEG)\n * - Smart quality optimization: quality first, dimensions last\n */\n\nimport {\n  PhotonImage,\n  SamplingFilter,\n  resize,\n} from \"@cf-wasm/photon/workerd\";\nimport { decode as decodeAvif } from \"@jsquash/avif\";\nimport { encode as encodeJpeg, decode as decodeJpeg } from \"@jsquash/jpeg\";\nimport { encode as encodePng, decode as decodePng } from \"@jsquash/png\";\n\n// Target 1.5MB binary → ~2MB base64 for RPC transfer\n// SQLite limit is 2MB per row, but base64 overhead means we need headroom\nconst MAX_SIZE = 1.5 * 1024 * 1024;\n\n// Memory safety limit - extremely large images can crash Workers (128MB limit)\nconst MAX_DIMENSION = 8192;\n\n// Reject images that would consume too much memory before decoding\nconst MAX_INPUT_SIZE = 20 * 1024 * 1024; // 20MB\n\nexport interface ProcessedImage {\n  data: ArrayBuffer;\n  mimeType: \"image/jpeg\" | \"image/png\";\n  width: number;\n  height: number;\n}\n\n/**\n * Process an image to ensure it's under 2MB and in a supported format.\n *\n * @param input - Raw image data as ArrayBuffer\n * @param inputMimeType - MIME type hint (used as fallback for format detection)\n * @returns Processed image data with updated mimeType and dimensions\n */\nexport async function processImage(\n  input: ArrayBuffer,\n  inputMimeType: string\n): Promise<ProcessedImage> {\n  // Memory safety: reject very large images\n  if (input.byteLength > MAX_INPUT_SIZE) {\n    throw new Error(`Image too large: ${input.byteLength} bytes exceeds ${MAX_INPUT_SIZE} byte limit`);\n  }\n\n  // Detect format from magic bytes\n  const format = detectFormat(input, inputMimeType);\n\n  // Decode image to PhotonImage\n  let photonImage: PhotonImage;\n\n  if (format === \"avif\") {\n    // AVIF: decode with jSquash, then convert to PhotonImage\n    const imageData = await decodeAvif(input);\n    photonImage = new PhotonImage(\n      new Uint8Array(imageData.data.buffer),\n      imageData.width,\n      imageData.height\n    );\n  } else {\n    // JPEG, PNG, WebP: photon can decode these directly\n    photonImage = PhotonImage.new_from_byteslice(new Uint8Array(input));\n  }\n\n  try {\n    // Get original dimensions\n    const width = photonImage.get_width();\n    const height = photonImage.get_height();\n\n    // Memory safety: limit extreme dimensions\n    if (width > MAX_DIMENSION || height > MAX_DIMENSION) {\n      const scale = Math.min(MAX_DIMENSION / width, MAX_DIMENSION / height);\n      const newWidth = Math.floor(width * scale);\n      const newHeight = Math.floor(height * scale);\n      const resized = resize(photonImage, newWidth, newHeight, SamplingFilter.Lanczos3);\n      photonImage.free();\n      photonImage = resized;\n    }\n\n    // Check for transparency to decide output format\n    const hasAlpha = detectAlphaChannel(photonImage);\n\n    // Encode with smart size optimization\n    return await encodeWithSizeLimit(photonImage, hasAlpha, MAX_SIZE);\n  } finally {\n    photonImage.free();\n  }\n}\n\n/**\n * Detect image format from magic bytes\n */\nfunction detectFormat(data: ArrayBuffer, mimeType: string): string {\n  const bytes = new Uint8Array(data.slice(0, 12));\n\n  // AVIF/HEIC: starts with ftyp box\n  if (bytes[4] === 0x66 && bytes[5] === 0x74 && bytes[6] === 0x79 && bytes[7] === 0x70) {\n    const brand = String.fromCharCode(...bytes.slice(8, 12));\n    if (brand === \"avif\" || brand === \"avis\") return \"avif\";\n    // Note: HEIC (heic, heix, mif1) not supported - would need separate decoder\n  }\n\n  // PNG: 89 50 4E 47\n  if (bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4E && bytes[3] === 0x47) {\n    return \"png\";\n  }\n\n  // JPEG: FF D8 FF\n  if (bytes[0] === 0xFF && bytes[1] === 0xD8 && bytes[2] === 0xFF) {\n    return \"jpeg\";\n  }\n\n  // WebP: RIFF....WEBP\n  if (bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[2] === 0x46 && bytes[3] === 0x46 &&\n      bytes[8] === 0x57 && bytes[9] === 0x45 && bytes[10] === 0x42 && bytes[11] === 0x50) {\n    return \"webp\";\n  }\n\n  // Fallback to mimeType hint\n  if (mimeType.includes(\"png\")) return \"png\";\n  if (mimeType.includes(\"webp\")) return \"webp\";\n  if (mimeType.includes(\"avif\")) return \"avif\";\n  return \"jpeg\";\n}\n\n/**\n * Check if image has transparent pixels\n */\nfunction detectAlphaChannel(image: PhotonImage): boolean {\n  const rawPixels = image.get_raw_pixels();\n  // RGBA format: check every 4th byte (alpha channel)\n  for (let i = 3; i < rawPixels.length; i += 4) {\n    if (rawPixels[i] < 255) {\n      return true; // Found non-opaque pixel\n    }\n  }\n  return false;\n}\n\n/**\n * Encode image with smart size optimization.\n * Strategy: quality reduction first, dimension reduction last.\n */\nasync function encodeWithSizeLimit(\n  image: PhotonImage,\n  hasAlpha: boolean,\n  maxSize: number\n): Promise<ProcessedImage> {\n  const originalWidth = image.get_width();\n  const originalHeight = image.get_height();\n\n  // For opaque images: use JPEG with quality reduction first\n  if (!hasAlpha) {\n    // Quality levels to try (minimum 45% to preserve acceptable quality)\n    const qualityLevels = [92, 85, 75, 65, 55, 45];\n\n    // Try each quality level at original resolution\n    for (const quality of qualityLevels) {\n      const encoded = image.get_bytes_jpeg(quality);\n      if (encoded.byteLength <= maxSize) {\n        return {\n          data: encoded.buffer,\n          mimeType: \"image/jpeg\",\n          width: originalWidth,\n          height: originalHeight,\n        };\n      }\n    }\n\n    // Quality 45 wasn't enough - reduce dimensions iteratively\n    // Use fine-grained steps (10% reduction each) to find optimal quality/resolution tradeoff\n    let scale = 0.9;\n    while (scale > 0.15) {\n      const newWidth = Math.floor(originalWidth * scale);\n      const newHeight = Math.floor(originalHeight * scale);\n\n      // Skip if dimensions haven't changed meaningfully\n      if (newWidth < 100 || newHeight < 100) {\n        scale *= 0.9;\n        continue;\n      }\n\n      const resized = resize(image, newWidth, newHeight, SamplingFilter.Lanczos3);\n\n      for (const quality of qualityLevels) {\n        const encoded = resized.get_bytes_jpeg(quality);\n        if (encoded.byteLength <= maxSize) {\n          const result = {\n            data: encoded.buffer,\n            mimeType: \"image/jpeg\" as const,\n            width: newWidth,\n            height: newHeight,\n          };\n          resized.free();\n          return result;\n        }\n      }\n\n      resized.free();\n      scale *= 0.9; // 10% reduction per step for finer granularity\n    }\n\n    // Fallback: return smallest we could achieve\n    const finalResized = resize(\n      image,\n      Math.floor(originalWidth * 0.15),\n      Math.floor(originalHeight * 0.15),\n      SamplingFilter.Lanczos3\n    );\n    const encoded = finalResized.get_bytes_jpeg(45);\n    const result = {\n      data: encoded.buffer,\n      mimeType: \"image/jpeg\" as const,\n      width: finalResized.get_width(),\n      height: finalResized.get_height(),\n    };\n    finalResized.free();\n    return result;\n  }\n\n  // For transparent images: use PNG (lossless, can only reduce dimensions)\n  // First try at original resolution\n  const imageData = image.get_image_data();\n  let encoded = await encodePng(imageData);\n\n  if (encoded.byteLength <= maxSize) {\n    return {\n      data: encoded,\n      mimeType: \"image/png\",\n      width: originalWidth,\n      height: originalHeight,\n    };\n  }\n\n  // PNG too large - reduce dimensions iteratively (10% reduction per step)\n  let scale = 0.9;\n  while (encoded.byteLength > maxSize && scale > 0.15) {\n    const newWidth = Math.floor(originalWidth * scale);\n    const newHeight = Math.floor(originalHeight * scale);\n\n    // Skip if dimensions are too small\n    if (newWidth < 100 || newHeight < 100) {\n      scale *= 0.9;\n      continue;\n    }\n\n    const resized = resize(image, newWidth, newHeight, SamplingFilter.Lanczos3);\n    const resizedImageData = resized.get_image_data();\n    encoded = await encodePng(resizedImageData);\n\n    if (encoded.byteLength <= maxSize) {\n      const result = {\n        data: encoded,\n        mimeType: \"image/png\" as const,\n        width: newWidth,\n        height: newHeight,\n      };\n      resized.free();\n      return result;\n    }\n\n    resized.free();\n    scale *= 0.9;\n  }\n\n  // Fallback: return smallest PNG we could achieve\n  const finalWidth = Math.floor(originalWidth * 0.15);\n  const finalHeight = Math.floor(originalHeight * 0.15);\n  const finalResized = resize(image, finalWidth, finalHeight, SamplingFilter.Lanczos3);\n  const finalImageData = finalResized.get_image_data();\n  encoded = await encodePng(finalImageData);\n  finalResized.free();\n\n  return {\n    data: encoded,\n    mimeType: \"image/png\",\n    width: finalWidth,\n    height: finalHeight,\n  };\n}\n\n/**\n * Check if an image needs processing based on size and format.\n *\n * @param data - Base64-encoded image data\n * @param mimeType - MIME type of the image\n * @returns true if processing is needed\n */\nexport function needsProcessing(data: string, mimeType: string): boolean {\n  // Decode base64 to get actual size\n  const binaryLength = Math.ceil(data.length * 3 / 4);\n\n  // Process if >2MB or unsupported format\n  return (\n    binaryLength > MAX_SIZE ||\n    mimeType.includes(\"avif\") ||\n    mimeType.includes(\"webp\")\n  );\n}\n\n/**\n * Convert base64 string to ArrayBuffer\n */\nexport function base64ToArrayBuffer(base64: string): ArrayBuffer {\n  const binaryString = atob(base64);\n  const bytes = new Uint8Array(binaryString.length);\n  for (let i = 0; i < binaryString.length; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n  return bytes.buffer;\n}\n\n/**\n * Convert ArrayBuffer to base64 string\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  const bytes = new Uint8Array(buffer);\n  let binary = \"\";\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n"]}