bun-image-turbo 1.2.2 → 1.3.0

package/README.md

@@ -23,7 +23,7 @@
 </p>
 
 <p align="center">
-  <b>Up to 950x faster</b> than alternatives • <b>Native HEIC support</b> • <b>Zero-copy buffers</b> • <b>SIMD-accelerated</b>
+  <b>Up to 950x faster</b> than alternatives • <b>Native HEIC support</b> • <b>EXIF metadata writing</b> • <b>SIMD-accelerated</b>
 </p>
 
 ---
@@ -36,6 +36,7 @@
 | JPEG Metadata | **38x** | Optimized marker extraction |
 | 50 Concurrent Ops | **2.6x** | Rayon thread pool |
 | Transform Pipeline | **1.6x** | Single-pass processing |
+| EXIF Write | **<0.3ms** | Native EXIF embedding |
 | HEIC Support | **Exclusive** | Only lib with native HEIC |
 
 > **bun-image-turbo** is the fastest image processing library for JavaScript. Period.
@@ -81,7 +82,7 @@ Prebuilt binaries are available for **all major platforms** - no compilation nee
 ## Quick Start
 
 ```typescript
-import { metadata, resize, transform, toWebp, blurhash } from 'bun-image-turbo';
+import { metadata, resize, transform, toWebp, blurhash, writeExif } from 'bun-image-turbo';
 
 // Read image
 const buffer = Buffer.from(await Bun.file('photo.jpg').arrayBuffer());
@@ -108,8 +109,16 @@ const result = await transform(buffer, {
 // Generate blurhash placeholder
 const { hash } = await blurhash(buffer, 4, 3);
 
+// Add EXIF metadata (perfect for AI images)
+const withExif = await writeExif(webp, {
+  imageDescription: 'AI-generated sunset',
+  artist: 'Stable Diffusion XL',
+  software: 'ComfyUI',
+  userComment: JSON.stringify({ prompt: '...', seed: 12345 })
+});
+
 // Save result
-await Bun.write('output.webp', result);
+await Bun.write('output.webp', withExif);
 ```
 
 **[See more examples →](https://nexus-aissam.github.io/bun-image-turbo/examples/)**
@@ -148,6 +157,16 @@ Tested on Apple M1 Pro with Bun 1.3.3 (compared to sharp v0.34.5):
 
 > **sharp does NOT support HEIC/HEIF files!** bun-image-turbo is the only high-performance library with native HEIC support.
 
+### EXIF Metadata (NEW in v1.3.0)
+
+| Operation | JPEG | WebP | Notes |
+|-----------|-----:|-----:|:------|
+| writeExif (simple) | **0.24ms** | **0.10ms** | 3 fields |
+| writeExif (full) | **0.20ms** | **0.05ms** | 10 fields + JSON |
+| stripExif | **0.26ms** | **0.08ms** | Remove all metadata |
+
+> **Perfect for AI-generated images!** Store prompts, seeds, and generation parameters in standard EXIF fields.
+
 **[Full benchmark details →](https://nexus-aissam.github.io/bun-image-turbo/guide/performance)**
 
 ---
@@ -172,6 +191,7 @@ Tested on Apple M1 Pro with Bun 1.3.3 (compared to sharp v0.34.5):
 - **Shrink-on-Decode** - Decode JPEG/HEIC at reduced resolution for faster thumbnails
 - **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
 - **Async & Sync APIs** - Both async and sync versions available
@@ -191,8 +211,10 @@ Tested on Apple M1 Pro with Bun 1.3.3 (compared to sharp v0.34.5):
 | `toPng()` | Convert to PNG | [→](https://nexus-aissam.github.io/bun-image-turbo/api/to-png) |
 | `toWebp()` | Convert to WebP | [→](https://nexus-aissam.github.io/bun-image-turbo/api/to-webp) |
 | `blurhash()` | Generate placeholder hash | [→](https://nexus-aissam.github.io/bun-image-turbo/api/blurhash) |
+| `writeExif()` | Write EXIF metadata | [→](https://nexus-aissam.github.io/bun-image-turbo/api/exif) |
+| `stripExif()` | Remove EXIF metadata | [→](https://nexus-aissam.github.io/bun-image-turbo/api/exif) |
 
-All functions have sync variants (`metadataSync`, `resizeSync`, etc.)
+All functions have sync variants (`metadataSync`, `resizeSync`, `writeExifSync`, etc.)
 
 **[Full API Reference →](https://nexus-aissam.github.io/bun-image-turbo/api/)**
 
@@ -253,6 +275,29 @@ bun run batch    # Parallel batch processing
 | [api-endpoint.ts](./examples/api-endpoint.ts) | HTTP image processing server |
 | [batch-processing.ts](./examples/batch-processing.ts) | Parallel multi-file processing |
 
+### EXIF Metadata Example
+
+```typescript
+import { writeExif, toWebp, stripExif } from 'bun-image-turbo';
+
+// Add AI generation metadata to WebP
+const webp = await toWebp(imageBuffer, { quality: 90 });
+const withMetadata = await writeExif(webp, {
+  imageDescription: 'A sunset over mountains',
+  artist: 'Stable Diffusion XL',
+  software: 'ComfyUI',
+  userComment: JSON.stringify({
+    prompt: 'sunset over mountains, 8k',
+    seed: 12345,
+    steps: 30,
+    cfg_scale: 7.5
+  })
+});
+
+// Strip metadata for privacy
+const clean = await stripExif(photoWithGPS);
+```
+
 **[All examples →](https://nexus-aissam.github.io/bun-image-turbo/examples/)**
 
 ---
@@ -346,6 +391,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 - [fast_image_resize](https://crates.io/crates/fast_image_resize) - Fast image resizing with Rayon
 - [webp](https://crates.io/crates/webp) - WebP encoding/decoding
 - [libheif-rs](https://crates.io/crates/libheif-rs) - HEIC/HEIF decoding via libheif
+- [img-parts](https://crates.io/crates/img-parts) - EXIF/XMP metadata manipulation
 - [blurhash](https://crates.io/crates/blurhash) - Blurhash generation
 - [napi-rs](https://napi.rs/) - Rust bindings for Node.js
 

package/dist/index.d.mts

@@ -107,6 +107,29 @@ interface BlurHashResult {
     /** Original height */
     height: number;
 }
+/** EXIF metadata options for writing */
+interface ExifOptions {
+    /** Image description / caption / AI prompt */
+    imageDescription?: string;
+    /** Artist / creator name */
+    artist?: string;
+    /** Copyright notice */
+    copyright?: string;
+    /** Software used to create the image */
+    software?: string;
+    /** Date/time in EXIF format (YYYY:MM:DD HH:MM:SS) */
+    dateTime?: string;
+    /** Original date/time in EXIF format */
+    dateTimeOriginal?: string;
+    /** User comment (can contain JSON or other data) */
+    userComment?: string;
+    /** Camera/device make */
+    make?: string;
+    /** Camera/device model */
+    model?: string;
+    /** Orientation (1-8) */
+    orientation?: number;
+}
 /** Transform options (all-in-one processing) */
 interface TransformOptions {
     /** Resize options */
@@ -129,6 +152,8 @@ interface TransformOptions {
     brightness?: number;
     /** Contrast adjustment (-100 to 100) */
     contrast?: number;
+    /** EXIF metadata to write (for JPEG/WebP output) */
+    exif?: ExifOptions;
 }
 
 /**
@@ -302,6 +327,52 @@ declare function transformSync(input: Buffer, options: TransformOptions): Buffer
  * Generate blurhash from image synchronously
  */
 declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+/**
+ * Write EXIF metadata to an image asynchronously
+ *
+ * Supports JPEG and WebP formats.
+ *
+ * @param input - Image buffer
+ * @param options - EXIF metadata options
+ * @returns Promise resolving to image buffer with EXIF data
+ *
+ * @example
+ * ```typescript
+ * const withExif = await writeExif(imageBuffer, {
+ *   imageDescription: 'A beautiful sunset over the ocean',
+ *   artist: 'John Doe',
+ *   software: 'My AI App v1.0',
+ *   userComment: JSON.stringify({ model: 'stable-diffusion', seed: 12345 })
+ * });
+ * ```
+ */
+declare function writeExif(input: Buffer, options: ExifOptions): Promise<Buffer>;
+/**
+ * Write EXIF metadata to an image synchronously
+ *
+ * Supports JPEG and WebP formats.
+ */
+declare function writeExifSync(input: Buffer, options: ExifOptions): Buffer;
+/**
+ * Strip all EXIF metadata from an image asynchronously
+ *
+ * Supports JPEG and WebP formats.
+ *
+ * @param input - Image buffer
+ * @returns Promise resolving to image buffer without EXIF data
+ *
+ * @example
+ * ```typescript
+ * const stripped = await stripExif(imageBuffer);
+ * ```
+ */
+declare function stripExif(input: Buffer): Promise<Buffer>;
+/**
+ * Strip all EXIF metadata from an image synchronously
+ *
+ * Supports JPEG and WebP formats.
+ */
+declare function stripExifSync(input: Buffer): Buffer;
 /**
  * Get library version
  */
@@ -321,7 +392,11 @@ declare const _default: {
     transformSync: typeof transformSync;
     blurhash: typeof blurhash;
     blurhashSync: typeof blurhashSync;
+    writeExif: typeof writeExif;
+    writeExifSync: typeof writeExifSync;
+    stripExif: typeof stripExif;
+    stripExifSync: typeof stripExifSync;
     version: typeof version;
 };
 
-export { type AvifOptions, type BlurHashResult, type FitMode, type ImageFormat, type ImageMetadata, type JpegOptions, type OutputOptions, type PngOptions, type ResizeFilter, type ResizeOptions, type TransformOptions, type WebPOptions, blurhash, blurhashSync, _default as default, metadata, metadataSync, resize, resizeSync, toJpeg, toJpegSync, toPng, toPngSync, toWebp, toWebpSync, transform, transformSync, version };
+export { type AvifOptions, type BlurHashResult, type ExifOptions, type FitMode, type ImageFormat, type ImageMetadata, type JpegOptions, type OutputOptions, type PngOptions, type ResizeFilter, type ResizeOptions, type TransformOptions, type WebPOptions, blurhash, blurhashSync, _default as default, metadata, metadataSync, resize, resizeSync, stripExif, stripExifSync, toJpeg, toJpegSync, toPng, toPngSync, toWebp, toWebpSync, transform, transformSync, version, writeExif, writeExifSync };

package/dist/index.d.ts

@@ -107,6 +107,29 @@ interface BlurHashResult {
     /** Original height */
     height: number;
 }
+/** EXIF metadata options for writing */
+interface ExifOptions {
+    /** Image description / caption / AI prompt */
+    imageDescription?: string;
+    /** Artist / creator name */
+    artist?: string;
+    /** Copyright notice */
+    copyright?: string;
+    /** Software used to create the image */
+    software?: string;
+    /** Date/time in EXIF format (YYYY:MM:DD HH:MM:SS) */
+    dateTime?: string;
+    /** Original date/time in EXIF format */
+    dateTimeOriginal?: string;
+    /** User comment (can contain JSON or other data) */
+    userComment?: string;
+    /** Camera/device make */
+    make?: string;
+    /** Camera/device model */
+    model?: string;
+    /** Orientation (1-8) */
+    orientation?: number;
+}
 /** Transform options (all-in-one processing) */
 interface TransformOptions {
     /** Resize options */
@@ -129,6 +152,8 @@ interface TransformOptions {
     brightness?: number;
     /** Contrast adjustment (-100 to 100) */
     contrast?: number;
+    /** EXIF metadata to write (for JPEG/WebP output) */
+    exif?: ExifOptions;
 }
 
 /**
@@ -302,6 +327,52 @@ declare function transformSync(input: Buffer, options: TransformOptions): Buffer
  * Generate blurhash from image synchronously
  */
 declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+/**
+ * Write EXIF metadata to an image asynchronously
+ *
+ * Supports JPEG and WebP formats.
+ *
+ * @param input - Image buffer
+ * @param options - EXIF metadata options
+ * @returns Promise resolving to image buffer with EXIF data
+ *
+ * @example
+ * ```typescript
+ * const withExif = await writeExif(imageBuffer, {
+ *   imageDescription: 'A beautiful sunset over the ocean',
+ *   artist: 'John Doe',
+ *   software: 'My AI App v1.0',
+ *   userComment: JSON.stringify({ model: 'stable-diffusion', seed: 12345 })
+ * });
+ * ```
+ */
+declare function writeExif(input: Buffer, options: ExifOptions): Promise<Buffer>;
+/**
+ * Write EXIF metadata to an image synchronously
+ *
+ * Supports JPEG and WebP formats.
+ */
+declare function writeExifSync(input: Buffer, options: ExifOptions): Buffer;
+/**
+ * Strip all EXIF metadata from an image asynchronously
+ *
+ * Supports JPEG and WebP formats.
+ *
+ * @param input - Image buffer
+ * @returns Promise resolving to image buffer without EXIF data
+ *
+ * @example
+ * ```typescript
+ * const stripped = await stripExif(imageBuffer);
+ * ```
+ */
+declare function stripExif(input: Buffer): Promise<Buffer>;
+/**
+ * Strip all EXIF metadata from an image synchronously
+ *
+ * Supports JPEG and WebP formats.
+ */
+declare function stripExifSync(input: Buffer): Buffer;
 /**
  * Get library version
  */
@@ -321,7 +392,11 @@ declare const _default: {
     transformSync: typeof transformSync;
     blurhash: typeof blurhash;
     blurhashSync: typeof blurhashSync;
+    writeExif: typeof writeExif;
+    writeExifSync: typeof writeExifSync;
+    stripExif: typeof stripExif;
+    stripExifSync: typeof stripExifSync;
     version: typeof version;
 };
 
-export { type AvifOptions, type BlurHashResult, type FitMode, type ImageFormat, type ImageMetadata, type JpegOptions, type OutputOptions, type PngOptions, type ResizeFilter, type ResizeOptions, type TransformOptions, type WebPOptions, blurhash, blurhashSync, _default as default, metadata, metadataSync, resize, resizeSync, toJpeg, toJpegSync, toPng, toPngSync, toWebp, toWebpSync, transform, transformSync, version };
+export { type AvifOptions, type BlurHashResult, type ExifOptions, type FitMode, type ImageFormat, type ImageMetadata, type JpegOptions, type OutputOptions, type PngOptions, type ResizeFilter, type ResizeOptions, type TransformOptions, type WebPOptions, blurhash, blurhashSync, _default as default, metadata, metadataSync, resize, resizeSync, stripExif, stripExifSync, toJpeg, toJpegSync, toPng, toPngSync, toWebp, toWebpSync, transform, transformSync, version, writeExif, writeExifSync };

package/dist/index.js

@@ -27,6 +27,8 @@ __export(index_exports, {
   metadataSync: () => metadataSync,
   resize: () => resize,
   resizeSync: () => resizeSync,
+  stripExif: () => stripExif,
+  stripExifSync: () => stripExifSync,
   toJpeg: () => toJpeg,
   toJpegSync: () => toJpegSync,
   toPng: () => toPng,
@@ -35,7 +37,9 @@ __export(index_exports, {
   toWebpSync: () => toWebpSync,
   transform: () => transform,
   transformSync: () => transformSync,
-  version: () => version
+  version: () => version,
+  writeExif: () => writeExif,
+  writeExifSync: () => writeExifSync
 });
 module.exports = __toCommonJS(index_exports);
 var import_fs = require("fs");
@@ -154,6 +158,9 @@ function toNapiTransformOptions(options) {
   result.sharpen = options.sharpen;
   result.brightness = options.brightness;
   result.contrast = options.contrast;
+  if (options.exif) {
+    result.exif = options.exif;
+  }
   return result;
 }
 async function metadata(input) {
@@ -198,6 +205,18 @@ function transformSync(input, options) {
 function blurhashSync(input, componentsX, componentsY) {
   return native.blurhashSync(input, componentsX, componentsY);
 }
+async function writeExif(input, options) {
+  return native.writeExif(input, options);
+}
+function writeExifSync(input, options) {
+  return native.writeExifSync(input, options);
+}
+async function stripExif(input) {
+  return native.stripExif(input);
+}
+function stripExifSync(input) {
+  return native.stripExifSync(input);
+}
 function version() {
   return native.version();
 }
@@ -216,6 +235,10 @@ var index_default = {
   transformSync,
   blurhash,
   blurhashSync,
+  writeExif,
+  writeExifSync,
+  stripExif,
+  stripExifSync,
   version
 };
 // Annotate the CommonJS export names for ESM import in node:
@@ -226,6 +249,8 @@ var index_default = {
   metadataSync,
   resize,
   resizeSync,
+  stripExif,
+  stripExifSync,
   toJpeg,
   toJpegSync,
   toPng,
@@ -234,5 +259,7 @@ var index_default = {
   toWebpSync,
   transform,
   transformSync,
-  version
+  version,
+  writeExif,
+  writeExifSync
 });

package/dist/index.mjs

@@ -121,6 +121,9 @@ function toNapiTransformOptions(options) {
   result.sharpen = options.sharpen;
   result.brightness = options.brightness;
   result.contrast = options.contrast;
+  if (options.exif) {
+    result.exif = options.exif;
+  }
   return result;
 }
 async function metadata(input) {
@@ -165,6 +168,18 @@ function transformSync(input, options) {
 function blurhashSync(input, componentsX, componentsY) {
   return native.blurhashSync(input, componentsX, componentsY);
 }
+async function writeExif(input, options) {
+  return native.writeExif(input, options);
+}
+function writeExifSync(input, options) {
+  return native.writeExifSync(input, options);
+}
+async function stripExif(input) {
+  return native.stripExif(input);
+}
+function stripExifSync(input) {
+  return native.stripExifSync(input);
+}
 function version() {
   return native.version();
 }
@@ -183,6 +198,10 @@ var index_default = {
   transformSync,
   blurhash,
   blurhashSync,
+  writeExif,
+  writeExifSync,
+  stripExif,
+  stripExifSync,
   version
 };
 export {
@@ -193,6 +212,8 @@ export {
   metadataSync,
   resize,
   resizeSync,
+  stripExif,
+  stripExifSync,
   toJpeg,
   toJpegSync,
   toPng,
@@ -201,5 +222,7 @@ export {
   toWebpSync,
   transform,
   transformSync,
-  version
+  version,
+  writeExif,
+  writeExifSync
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-image-turbo",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "author": "Aissam Irhir <aissamirhir@gmail.com>",
   "repository": {
     "type": "git",
@@ -92,12 +92,12 @@
   },
   "types": "./dist/index.d.ts",
   "optionalDependencies": {
-    "bun-image-turbo-darwin-arm64": "1.2.2",
-    "bun-image-turbo-darwin-x64": "1.2.2",
-    "bun-image-turbo-linux-arm64-gnu": "1.2.2",
-    "bun-image-turbo-linux-x64-gnu": "1.2.2",
-    "bun-image-turbo-linux-x64-musl": "1.2.2",
-    "bun-image-turbo-win32-arm64-msvc": "1.2.2",
-    "bun-image-turbo-win32-x64-msvc": "1.2.2"
+    "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"
   }
 }