@everystack/server 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/server",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Server runtime primitives for Lambda — event adapters, routing, SSR, image processing",
   "license": "AGPL-3.0-only",
   "publishConfig": {
@@ -65,6 +65,7 @@
     "@everystack/cli": ">=0.1.0",
     "drizzle-orm": "0.41.0",
     "postgres": "3.4.9",
+    "heic-decode": "2.1.0",
     "sharp": "0.34.5",
     "sst": "4.13.1"
   },
@@ -78,6 +79,9 @@
     "@everystack/cli": {
       "optional": true
     },
+    "heic-decode": {
+      "optional": true
+    },
     "sharp": {
       "optional": true
     },

package/src/heic-decode.d.ts

@@ -0,0 +1,9 @@
+declare module 'heic-decode' {
+  interface DecodedImage {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+  }
+  function decode(opts: { buffer: Buffer | ArrayBuffer }): Promise<DecodedImage>;
+  export default decode;
+}

package/src/image.ts

@@ -142,15 +142,17 @@ function isNotFound(error: any): boolean {
 
 export async function processImage(
   data: Buffer,
-  params: TransformParams
+  params: TransformParams,
+  raw?: { width: number; height: number; channels: 1 | 2 | 3 | 4 }
 ): Promise<{ data: Buffer; contentType: string }> {
   // Sharp is provided via Lambda layer
   const sharp = (await import('sharp')).default;
 
-  let pipeline = sharp(data);
+  let pipeline = raw ? sharp(data, { raw }) : sharp(data);
 
   // Auto-orient based on EXIF metadata (fixes rotated portrait thumbnails)
-  pipeline = pipeline.rotate();
+  // Skip for raw pixel input — no EXIF to orient
+  if (!raw) pipeline = pipeline.rotate();
 
   // Resize
   if (params.w || params.h) {
@@ -346,21 +348,52 @@ export function createImageHandler(
       const hasTransforms = params.w || params.h || params.fit || params.fm || params.q;
 
       // Process with Sharp — catch decode failures (e.g. HEIC without libheif)
-      let processed: { data: Buffer; contentType: string };
+      let processed: { data: Buffer; contentType: string } | undefined;
       try {
         processed = hasTransforms
           ? await processImage(originalData, params)
           : await processImage(originalData, { fm: 'webp', q: 80 });
       } catch (sharpError) {
-        log('error', 'Sharp processing failed', {
-          key, format: detectedFormat, contentType: originalContentType,
-          error: String(sharpError),
-        });
-        return {
-          statusCode: 422,
-          headers: errorHeaders,
-          body: JSON.stringify({ error: 'Unsupported image format' }),
-        };
+        // HEIC fallback: decode via WASM (heic-decode) then re-process with Sharp
+        if (detectedFormat === 'heif') {
+          try {
+            const decode = (await import('heic-decode')).default;
+            const { width, height, data } = await decode({ buffer: originalData });
+            const rawBuffer = Buffer.from(data.buffer);
+            const transformParams = hasTransforms ? params : { fm: 'webp' as const, q: 80 };
+            processed = await processImage(rawBuffer, transformParams, { width, height, channels: 4 });
+          } catch (heicError) {
+            log('warn', 'HEIC decode failed, passing through original', {
+              key, contentType: originalContentType,
+              error: String(heicError),
+            });
+          }
+        }
+
+        if (!processed) {
+          log('warn', 'Sharp decode failed, passing through original', {
+            key, format: detectedFormat, contentType: originalContentType,
+            error: String(sharpError),
+          });
+          // Can't decode — pass through original bytes (better than 422)
+          const MAX_PASSTHROUGH = 4_500_000;
+          if (originalData.length > MAX_PASSTHROUGH) {
+            return {
+              statusCode: 422,
+              headers: errorHeaders,
+              body: JSON.stringify({ error: 'Unsupported image format' }),
+            };
+          }
+          return {
+            statusCode: 200,
+            headers: {
+              'Content-Type': originalContentType || 'application/octet-stream',
+              ...cacheHeaders,
+            },
+            body: originalData.toString('base64'),
+            isBase64Encoded: true,
+          };
+        }
       }
 
       // --- Write rendered image to S3 cache (fire-and-forget) ---