bun-image-turbo 1.3.0 → 1.4.0

package/README.md

@@ -34,6 +34,7 @@
 |----------|:-------:|-----|
 | WebP Metadata | **950x** | Header-only parsing, no decode |
 | JPEG Metadata | **38x** | Optimized marker extraction |
+| WebP Resize | **1.25x** | Shrink-on-load optimization (NEW in v1.4.0) |
 | 50 Concurrent Ops | **2.6x** | Rayon thread pool |
 | Transform Pipeline | **1.6x** | Single-pass processing |
 | EXIF Write | **<0.3ms** | Native EXIF embedding |
@@ -146,6 +147,18 @@ Tested on Apple M1 Pro with Bun 1.3.3 (compared to sharp v0.34.5):
 | 1MB JPEG → 800px | **12.6ms** | 20.3ms | **1.6x** |
 | Thumbnail (200px) | **8.8ms** | 10.7ms | **1.2x** |
 
+### WebP Resize (NEW in v1.4.0)
+
+| Source Size | Target | bun-image-turbo | sharp | Speedup |
+|-------------|--------|---------------:|------:|:-------:|
+| 800x600 | 200px | **3.1ms** | 4.3ms | **1.40x** |
+| 1600x1200 | 200px | **6.4ms** | 8.0ms | **1.24x** |
+| 2000x1500 | 200px | **8.6ms** | 10.1ms | **1.18x** |
+| 3000x2000 | 200px | **14.7ms** | 16.1ms | **1.10x** |
+| 4000x3000 | 400px | **32.4ms** | 33.1ms | **1.02x** |
+
+> **v1.4.0** introduces WebP shrink-on-load optimization using libwebp's native scaling, making WebP resize operations **1.02-1.40x faster** than sharp across all sizes.
+
 ### HEIC Support (Exclusive)
 
 | Operation | Time | Notes |
@@ -188,12 +201,14 @@ Tested on Apple M1 Pro with Bun 1.3.3 (compared to sharp v0.34.5):
 ## Features
 
 - **TurboJPEG with SIMD** - 2-6x faster JPEG encoding/decoding via libjpeg-turbo
-- **Shrink-on-Decode** - Decode JPEG/HEIC at reduced resolution for faster thumbnails
+- **Shrink-on-Decode** - Decode JPEG/WebP/HEIC at reduced resolution for faster thumbnails
+- **WebP Shrink-on-Load** - NEW in v1.4.0: Native libwebp scaling for 1.25x faster WebP resize
 - **Adaptive Algorithms** - Auto-selects optimal resize filter based on scale factor
 - **Native HEIC Support** - The only high-performance library with HEIC/HEIF decoding
 - **EXIF Metadata Writing** - Write/strip EXIF data for AI image attribution
 - **Blurhash Generation** - Built-in compact placeholder generation
 - **Multi-Step Resize** - Progressive halving for large scale reductions
+- **Zero-Copy Optimizations** - Minimal memory copies for lower memory usage
 - **Async & Sync APIs** - Both async and sync versions available
 - **TypeScript First** - Full TypeScript support with strict types
 - **Cross-Platform** - macOS, Linux, Windows support

package/dist/index.d.mts

@@ -157,28 +157,7 @@ interface TransformOptions {
 }
 
 /**
- * bun-image-turbo - High-performance image processing for Bun and Node.js
- *
- * @module bun-image-turbo
- * @author Aissam Irhir <aissamirhir@gmail.com>
- *
- * @example
- * ```typescript
- * import { resize, toWebp, metadata } from 'bun-image-turbo';
- *
- * // Read image
- * const input = await Bun.file('input.jpg').arrayBuffer();
- *
- * // Resize image
- * const resized = await resize(Buffer.from(input), { width: 800, height: 600 });
- *
- * // Convert to WebP
- * const webp = await toWebp(Buffer.from(input), { quality: 85 });
- *
- * // Get metadata
- * const info = await metadata(Buffer.from(input));
- * console.log(info.width, info.height, info.format);
- * ```
+ * Metadata API functions
  */
 
 /**
@@ -194,6 +173,15 @@ interface TransformOptions {
  * ```
  */
 declare function metadata(input: Buffer): Promise<ImageMetadata>;
+/**
+ * Get image metadata synchronously
+ */
+declare function metadataSync(input: Buffer): ImageMetadata;
+
+/**
+ * Resize API functions
+ */
+
 /**
  * Resize image asynchronously
  *
@@ -218,6 +206,15 @@ declare function metadata(input: Buffer): Promise<ImageMetadata>;
  * ```
  */
 declare function resize(input: Buffer, options: ResizeOptions): Promise<Buffer>;
+/**
+ * Resize image synchronously
+ */
+declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
+
+/**
+ * Image encoding/format conversion API functions
+ */
+
 /**
  * Convert image to JPEG asynchronously
  *
@@ -231,6 +228,10 @@ declare function resize(input: Buffer, options: ResizeOptions): Promise<Buffer>;
  * ```
  */
 declare function toJpeg(input: Buffer, options?: JpegOptions): Promise<Buffer>;
+/**
+ * Convert image to JPEG synchronously
+ */
+declare function toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
 /**
  * Convert image to PNG asynchronously
  *
@@ -244,6 +245,10 @@ declare function toJpeg(input: Buffer, options?: JpegOptions): Promise<Buffer>;
  * ```
  */
 declare function toPng(input: Buffer, options?: PngOptions): Promise<Buffer>;
+/**
+ * Convert image to PNG synchronously
+ */
+declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
 /**
  * Convert image to WebP asynchronously
  *
@@ -261,6 +266,15 @@ declare function toPng(input: Buffer, options?: PngOptions): Promise<Buffer>;
  * ```
  */
 declare function toWebp(input: Buffer, options?: WebPOptions): Promise<Buffer>;
+/**
+ * Convert image to WebP synchronously
+ */
+declare function toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
+
+/**
+ * Transform API functions
+ */
+
 /**
  * Transform image with multiple operations asynchronously
  *
@@ -282,6 +296,15 @@ declare function toWebp(input: Buffer, options?: WebPOptions): Promise<Buffer>;
  * ```
  */
 declare function transform(input: Buffer, options: TransformOptions): Promise<Buffer>;
+/**
+ * Transform image with multiple operations synchronously
+ */
+declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
+
+/**
+ * Blurhash API functions
+ */
+
 /**
  * Generate blurhash from image asynchronously
  *
@@ -299,34 +322,15 @@ declare function transform(input: Buffer, options: TransformOptions): Promise<Bu
  * ```
  */
 declare function blurhash(input: Buffer, componentsX?: number, componentsY?: number): Promise<BlurHashResult>;
-/**
- * Get image metadata synchronously
- */
-declare function metadataSync(input: Buffer): ImageMetadata;
-/**
- * Resize image synchronously
- */
-declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
-/**
- * Convert image to JPEG synchronously
- */
-declare function toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
-/**
- * Convert image to PNG synchronously
- */
-declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
-/**
- * Convert image to WebP synchronously
- */
-declare function toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
-/**
- * Transform image with multiple operations synchronously
- */
-declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
 /**
  * Generate blurhash from image synchronously
  */
 declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
+/**
+ * EXIF metadata API functions
+ */
+
 /**
  * Write EXIF metadata to an image asynchronously
  *
@@ -373,10 +377,37 @@ declare function stripExif(input: Buffer): Promise<Buffer>;
  * Supports JPEG and WebP formats.
  */
 declare function stripExifSync(input: Buffer): Buffer;
+
+/**
+ * bun-image-turbo - High-performance image processing for Bun and Node.js
+ *
+ * @module bun-image-turbo
+ * @author Aissam Irhir <aissamirhir@gmail.com>
+ *
+ * @example
+ * ```typescript
+ * import { resize, toWebp, metadata } from 'bun-image-turbo';
+ *
+ * // Read image
+ * const input = await Bun.file('input.jpg').arrayBuffer();
+ *
+ * // Resize image
+ * const resized = await resize(Buffer.from(input), { width: 800, height: 600 });
+ *
+ * // Convert to WebP
+ * const webp = await toWebp(Buffer.from(input), { quality: 85 });
+ *
+ * // Get metadata
+ * const info = await metadata(Buffer.from(input));
+ * console.log(info.width, info.height, info.format);
+ * ```
+ */
+
 /**
  * Get library version
  */
 declare function version(): string;
+
 declare const _default: {
     metadata: typeof metadata;
     metadataSync: typeof metadataSync;

package/dist/index.d.ts

@@ -157,28 +157,7 @@ interface TransformOptions {
 }
 
 /**
- * bun-image-turbo - High-performance image processing for Bun and Node.js
- *
- * @module bun-image-turbo
- * @author Aissam Irhir <aissamirhir@gmail.com>
- *
- * @example
- * ```typescript
- * import { resize, toWebp, metadata } from 'bun-image-turbo';
- *
- * // Read image
- * const input = await Bun.file('input.jpg').arrayBuffer();
- *
- * // Resize image
- * const resized = await resize(Buffer.from(input), { width: 800, height: 600 });
- *
- * // Convert to WebP
- * const webp = await toWebp(Buffer.from(input), { quality: 85 });
- *
- * // Get metadata
- * const info = await metadata(Buffer.from(input));
- * console.log(info.width, info.height, info.format);
- * ```
+ * Metadata API functions
  */
 
 /**
@@ -194,6 +173,15 @@ interface TransformOptions {
  * ```
  */
 declare function metadata(input: Buffer): Promise<ImageMetadata>;
+/**
+ * Get image metadata synchronously
+ */
+declare function metadataSync(input: Buffer): ImageMetadata;
+
+/**
+ * Resize API functions
+ */
+
 /**
  * Resize image asynchronously
  *
@@ -218,6 +206,15 @@ declare function metadata(input: Buffer): Promise<ImageMetadata>;
  * ```
  */
 declare function resize(input: Buffer, options: ResizeOptions): Promise<Buffer>;
+/**
+ * Resize image synchronously
+ */
+declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
+
+/**
+ * Image encoding/format conversion API functions
+ */
+
 /**
  * Convert image to JPEG asynchronously
  *
@@ -231,6 +228,10 @@ declare function resize(input: Buffer, options: ResizeOptions): Promise<Buffer>;
  * ```
  */
 declare function toJpeg(input: Buffer, options?: JpegOptions): Promise<Buffer>;
+/**
+ * Convert image to JPEG synchronously
+ */
+declare function toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
 /**
  * Convert image to PNG asynchronously
  *
@@ -244,6 +245,10 @@ declare function toJpeg(input: Buffer, options?: JpegOptions): Promise<Buffer>;
  * ```
  */
 declare function toPng(input: Buffer, options?: PngOptions): Promise<Buffer>;
+/**
+ * Convert image to PNG synchronously
+ */
+declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
 /**
  * Convert image to WebP asynchronously
  *
@@ -261,6 +266,15 @@ declare function toPng(input: Buffer, options?: PngOptions): Promise<Buffer>;
  * ```
  */
 declare function toWebp(input: Buffer, options?: WebPOptions): Promise<Buffer>;
+/**
+ * Convert image to WebP synchronously
+ */
+declare function toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
+
+/**
+ * Transform API functions
+ */
+
 /**
  * Transform image with multiple operations asynchronously
  *
@@ -282,6 +296,15 @@ declare function toWebp(input: Buffer, options?: WebPOptions): Promise<Buffer>;
  * ```
  */
 declare function transform(input: Buffer, options: TransformOptions): Promise<Buffer>;
+/**
+ * Transform image with multiple operations synchronously
+ */
+declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
+
+/**
+ * Blurhash API functions
+ */
+
 /**
  * Generate blurhash from image asynchronously
  *
@@ -299,34 +322,15 @@ declare function transform(input: Buffer, options: TransformOptions): Promise<Bu
  * ```
  */
 declare function blurhash(input: Buffer, componentsX?: number, componentsY?: number): Promise<BlurHashResult>;
-/**
- * Get image metadata synchronously
- */
-declare function metadataSync(input: Buffer): ImageMetadata;
-/**
- * Resize image synchronously
- */
-declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
-/**
- * Convert image to JPEG synchronously
- */
-declare function toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
-/**
- * Convert image to PNG synchronously
- */
-declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
-/**
- * Convert image to WebP synchronously
- */
-declare function toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
-/**
- * Transform image with multiple operations synchronously
- */
-declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
 /**
  * Generate blurhash from image synchronously
  */
 declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
+/**
+ * EXIF metadata API functions
+ */
+
 /**
  * Write EXIF metadata to an image asynchronously
  *
@@ -373,10 +377,37 @@ declare function stripExif(input: Buffer): Promise<Buffer>;
  * Supports JPEG and WebP formats.
  */
 declare function stripExifSync(input: Buffer): Buffer;
+
+/**
+ * bun-image-turbo - High-performance image processing for Bun and Node.js
+ *
+ * @module bun-image-turbo
+ * @author Aissam Irhir <aissamirhir@gmail.com>
+ *
+ * @example
+ * ```typescript
+ * import { resize, toWebp, metadata } from 'bun-image-turbo';
+ *
+ * // Read image
+ * const input = await Bun.file('input.jpg').arrayBuffer();
+ *
+ * // Resize image
+ * const resized = await resize(Buffer.from(input), { width: 800, height: 600 });
+ *
+ * // Convert to WebP
+ * const webp = await toWebp(Buffer.from(input), { quality: 85 });
+ *
+ * // Get metadata
+ * const info = await metadata(Buffer.from(input));
+ * console.log(info.width, info.height, info.format);
+ * ```
+ */
+
 /**
  * Get library version
  */
 declare function version(): string;
+
 declare const _default: {
     metadata: typeof metadata;
     metadataSync: typeof metadataSync;

package/dist/index.js

@@ -42,17 +42,19 @@ __export(index_exports, {
   writeExifSync: () => writeExifSync
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/loader.ts
 var import_fs = require("fs");
 var import_path = require("path");
 var import_url = require("url");
 var import_meta = {};
-var getCurrentDir = () => {
+function getCurrentDir() {
   try {
     return (0, import_path.dirname)((0, import_url.fileURLToPath)(import_meta.url));
   } catch {
     return __dirname;
   }
-};
+}
 function loadNativeBinding() {
   const platform = process.platform;
   const arch = process.arch;
@@ -106,6 +108,16 @@ function loadNativeBinding() {
   );
 }
 var native = loadNativeBinding();
+
+// src/api/metadata.ts
+async function metadata(input) {
+  return native.metadata(input);
+}
+function metadataSync(input) {
+  return native.metadataSync(input);
+}
+
+// src/converters.ts
 function toNapiFilter(filter) {
   if (!filter) return void 0;
   return filter.charAt(0).toUpperCase() + filter.slice(1);
@@ -163,48 +175,52 @@ function toNapiTransformOptions(options) {
   }
   return result;
 }
-async function metadata(input) {
-  return native.metadata(input);
-}
+
+// src/api/resize.ts
 async function resize(input, options) {
   return native.resize(input, toNapiResizeOptions(options));
 }
-async function toJpeg(input, options) {
-  return native.toJpeg(input, options);
-}
-async function toPng(input, options) {
-  return native.toPng(input, options);
-}
-async function toWebp(input, options) {
-  return native.toWebp(input, options);
-}
-async function transform(input, options) {
-  return native.transform(input, toNapiTransformOptions(options));
-}
-async function blurhash(input, componentsX, componentsY) {
-  return native.blurhash(input, componentsX, componentsY);
-}
-function metadataSync(input) {
-  return native.metadataSync(input);
-}
 function resizeSync(input, options) {
   return native.resizeSync(input, toNapiResizeOptions(options));
 }
+
+// src/api/encode.ts
+async function toJpeg(input, options) {
+  return native.toJpeg(input, options);
+}
 function toJpegSync(input, options) {
   return native.toJpegSync(input, options);
 }
+async function toPng(input, options) {
+  return native.toPng(input, options);
+}
 function toPngSync(input, options) {
   return native.toPngSync(input, options);
 }
+async function toWebp(input, options) {
+  return native.toWebp(input, options);
+}
 function toWebpSync(input, options) {
   return native.toWebpSync(input, options);
 }
+
+// src/api/transform.ts
+async function transform(input, options) {
+  return native.transform(input, toNapiTransformOptions(options));
+}
 function transformSync(input, options) {
   return native.transformSync(input, toNapiTransformOptions(options));
 }
+
+// src/api/blurhash.ts
+async function blurhash(input, componentsX, componentsY) {
+  return native.blurhash(input, componentsX, componentsY);
+}
 function blurhashSync(input, componentsX, componentsY) {
   return native.blurhashSync(input, componentsX, componentsY);
 }
+
+// src/api/exif.ts
 async function writeExif(input, options) {
   return native.writeExif(input, options);
 }
@@ -217,6 +233,8 @@ async function stripExif(input) {
 function stripExifSync(input) {
   return native.stripExifSync(input);
 }
+
+// src/index.ts
 function version() {
   return native.version();
 }

package/dist/index.mjs

@@ -5,17 +5,17 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// src/index.ts
+// src/loader.ts
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
-var getCurrentDir = () => {
+function getCurrentDir() {
   try {
     return dirname(fileURLToPath(import.meta.url));
   } catch {
     return __dirname;
   }
-};
+}
 function loadNativeBinding() {
   const platform = process.platform;
   const arch = process.arch;
@@ -69,6 +69,16 @@ function loadNativeBinding() {
   );
 }
 var native = loadNativeBinding();
+
+// src/api/metadata.ts
+async function metadata(input) {
+  return native.metadata(input);
+}
+function metadataSync(input) {
+  return native.metadataSync(input);
+}
+
+// src/converters.ts
 function toNapiFilter(filter) {
   if (!filter) return void 0;
   return filter.charAt(0).toUpperCase() + filter.slice(1);
@@ -126,48 +136,52 @@ function toNapiTransformOptions(options) {
   }
   return result;
 }
-async function metadata(input) {
-  return native.metadata(input);
-}
+
+// src/api/resize.ts
 async function resize(input, options) {
   return native.resize(input, toNapiResizeOptions(options));
 }
-async function toJpeg(input, options) {
-  return native.toJpeg(input, options);
-}
-async function toPng(input, options) {
-  return native.toPng(input, options);
-}
-async function toWebp(input, options) {
-  return native.toWebp(input, options);
-}
-async function transform(input, options) {
-  return native.transform(input, toNapiTransformOptions(options));
-}
-async function blurhash(input, componentsX, componentsY) {
-  return native.blurhash(input, componentsX, componentsY);
-}
-function metadataSync(input) {
-  return native.metadataSync(input);
-}
 function resizeSync(input, options) {
   return native.resizeSync(input, toNapiResizeOptions(options));
 }
+
+// src/api/encode.ts
+async function toJpeg(input, options) {
+  return native.toJpeg(input, options);
+}
 function toJpegSync(input, options) {
   return native.toJpegSync(input, options);
 }
+async function toPng(input, options) {
+  return native.toPng(input, options);
+}
 function toPngSync(input, options) {
   return native.toPngSync(input, options);
 }
+async function toWebp(input, options) {
+  return native.toWebp(input, options);
+}
 function toWebpSync(input, options) {
   return native.toWebpSync(input, options);
 }
+
+// src/api/transform.ts
+async function transform(input, options) {
+  return native.transform(input, toNapiTransformOptions(options));
+}
 function transformSync(input, options) {
   return native.transformSync(input, toNapiTransformOptions(options));
 }
+
+// src/api/blurhash.ts
+async function blurhash(input, componentsX, componentsY) {
+  return native.blurhash(input, componentsX, componentsY);
+}
 function blurhashSync(input, componentsX, componentsY) {
   return native.blurhashSync(input, componentsX, componentsY);
 }
+
+// src/api/exif.ts
 async function writeExif(input, options) {
   return native.writeExif(input, options);
 }
@@ -180,6 +194,8 @@ async function stripExif(input) {
 function stripExifSync(input) {
   return native.stripExifSync(input);
 }
+
+// src/index.ts
 function version() {
   return native.version();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-image-turbo",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "author": "Aissam Irhir <aissamirhir@gmail.com>",
   "repository": {
     "type": "git",
@@ -64,6 +64,15 @@
     "turbo"
   ],
   "license": "MIT",
+  "optionalDependencies": {
+    "bun-image-turbo-darwin-arm64": "1.4.0",
+    "bun-image-turbo-darwin-x64": "1.4.0",
+    "bun-image-turbo-linux-arm64-gnu": "1.4.0",
+    "bun-image-turbo-linux-x64-gnu": "1.4.0",
+    "bun-image-turbo-linux-x64-musl": "1.4.0",
+    "bun-image-turbo-win32-arm64-msvc": "1.4.0",
+    "bun-image-turbo-win32-x64-msvc": "1.4.0"
+  },
   "napi": {
     "name": "image-turbo",
     "binaryName": "image-turbo",
@@ -90,14 +99,5 @@
     "lint": "eslint src",
     "clean": "rm -rf dist *.node npm"
   },
-  "types": "./dist/index.d.ts",
-  "optionalDependencies": {
-    "bun-image-turbo-darwin-arm64": "1.3.0",
-    "bun-image-turbo-darwin-x64": "1.3.0",
-    "bun-image-turbo-linux-arm64-gnu": "1.3.0",
-    "bun-image-turbo-linux-x64-gnu": "1.3.0",
-    "bun-image-turbo-linux-x64-musl": "1.3.0",
-    "bun-image-turbo-win32-arm64-msvc": "1.3.0",
-    "bun-image-turbo-win32-x64-msvc": "1.3.0"
-  }
+  "types": "./dist/index.d.ts"
 }