bun-image-turbo 1.2.2 → 1.4.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>
 
 ---
@@ -34,8 +34,10 @@
 |----------|:-------:|-----|
 | 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 |
 | HEIC Support | **Exclusive** | Only lib with native HEIC |
 
 > **bun-image-turbo** is the fastest image processing library for JavaScript. Period.
@@ -81,7 +83,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 +110,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/)**
@@ -137,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 |
@@ -148,6 +170,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)**
 
 ---
@@ -169,11 +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
@@ -191,8 +226,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 +290,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 +406,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,31 +152,12 @@ interface TransformOptions {
     brightness?: number;
     /** Contrast adjustment (-100 to 100) */
     contrast?: number;
+    /** EXIF metadata to write (for JPEG/WebP output) */
+    exif?: ExifOptions;
 }
 
 /**
- * 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
  */
 
 /**
@@ -169,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
  *
@@ -193,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
  *
@@ -206,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
  *
@@ -219,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
  *
@@ -236,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
  *
@@ -257,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
  *
@@ -275,37 +323,91 @@ declare function transform(input: Buffer, options: TransformOptions): Promise<Bu
  */
 declare function blurhash(input: Buffer, componentsX?: number, componentsY?: number): Promise<BlurHashResult>;
 /**
- * Get image metadata synchronously
+ * Generate blurhash from image synchronously
  */
-declare function metadataSync(input: Buffer): ImageMetadata;
+declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
 /**
- * Resize image synchronously
+ * EXIF metadata API functions
  */
-declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
+
 /**
- * Convert image to JPEG synchronously
+ * 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 toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
+declare function writeExif(input: Buffer, options: ExifOptions): Promise<Buffer>;
 /**
- * Convert image to PNG synchronously
+ * Write EXIF metadata to an image synchronously
+ *
+ * Supports JPEG and WebP formats.
  */
-declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
+declare function writeExifSync(input: Buffer, options: ExifOptions): Buffer;
 /**
- * Convert image to WebP synchronously
+ * 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 toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
+declare function stripExif(input: Buffer): Promise<Buffer>;
 /**
- * Transform image with multiple operations synchronously
+ * Strip all EXIF metadata from an image synchronously
+ *
+ * Supports JPEG and WebP formats.
  */
-declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
+declare function stripExifSync(input: Buffer): Buffer;
+
 /**
- * Generate blurhash from image synchronously
+ * 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);
+ * ```
  */
-declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
 /**
  * Get library version
  */
 declare function version(): string;
+
 declare const _default: {
     metadata: typeof metadata;
     metadataSync: typeof metadataSync;
@@ -321,7 +423,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,31 +152,12 @@ interface TransformOptions {
     brightness?: number;
     /** Contrast adjustment (-100 to 100) */
     contrast?: number;
+    /** EXIF metadata to write (for JPEG/WebP output) */
+    exif?: ExifOptions;
 }
 
 /**
- * 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
  */
 
 /**
@@ -169,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
  *
@@ -193,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
  *
@@ -206,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
  *
@@ -219,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
  *
@@ -236,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
  *
@@ -257,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
  *
@@ -275,37 +323,91 @@ declare function transform(input: Buffer, options: TransformOptions): Promise<Bu
  */
 declare function blurhash(input: Buffer, componentsX?: number, componentsY?: number): Promise<BlurHashResult>;
 /**
- * Get image metadata synchronously
+ * Generate blurhash from image synchronously
  */
-declare function metadataSync(input: Buffer): ImageMetadata;
+declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
 /**
- * Resize image synchronously
+ * EXIF metadata API functions
  */
-declare function resizeSync(input: Buffer, options: ResizeOptions): Buffer;
+
 /**
- * Convert image to JPEG synchronously
+ * 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 toJpegSync(input: Buffer, options?: JpegOptions): Buffer;
+declare function writeExif(input: Buffer, options: ExifOptions): Promise<Buffer>;
 /**
- * Convert image to PNG synchronously
+ * Write EXIF metadata to an image synchronously
+ *
+ * Supports JPEG and WebP formats.
  */
-declare function toPngSync(input: Buffer, options?: PngOptions): Buffer;
+declare function writeExifSync(input: Buffer, options: ExifOptions): Buffer;
 /**
- * Convert image to WebP synchronously
+ * 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 toWebpSync(input: Buffer, options?: WebPOptions): Buffer;
+declare function stripExif(input: Buffer): Promise<Buffer>;
 /**
- * Transform image with multiple operations synchronously
+ * Strip all EXIF metadata from an image synchronously
+ *
+ * Supports JPEG and WebP formats.
  */
-declare function transformSync(input: Buffer, options: TransformOptions): Buffer;
+declare function stripExifSync(input: Buffer): Buffer;
+
 /**
- * Generate blurhash from image synchronously
+ * 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);
+ * ```
  */
-declare function blurhashSync(input: Buffer, componentsX?: number, componentsY?: number): BlurHashResult;
+
 /**
  * Get library version
  */
 declare function version(): string;
+
 declare const _default: {
     metadata: typeof metadata;
     metadataSync: typeof metadataSync;
@@ -321,7 +423,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,20 +37,24 @@ __export(index_exports, {
   toWebpSync: () => toWebpSync,
   transform: () => transform,
   transformSync: () => transformSync,
-  version: () => version
+  version: () => version,
+  writeExif: () => writeExif,
+  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;
@@ -102,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);
@@ -154,50 +170,71 @@ 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) {
-  return native.metadata(input);
-}
+
+// src/api/resize.ts
 async function resize(input, options) {
   return native.resize(input, toNapiResizeOptions(options));
 }
+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 metadataSync(input) {
-  return native.metadataSync(input);
-}
-function resizeSync(input, options) {
-  return native.resizeSync(input, toNapiResizeOptions(options));
-}
-function toJpegSync(input, options) {
-  return native.toJpegSync(input, options);
+function blurhashSync(input, componentsX, componentsY) {
+  return native.blurhashSync(input, componentsX, componentsY);
 }
-function toPngSync(input, options) {
-  return native.toPngSync(input, options);
+
+// src/api/exif.ts
+async function writeExif(input, options) {
+  return native.writeExif(input, options);
 }
-function toWebpSync(input, options) {
-  return native.toWebpSync(input, options);
+function writeExifSync(input, options) {
+  return native.writeExifSync(input, options);
 }
-function transformSync(input, options) {
-  return native.transformSync(input, toNapiTransformOptions(options));
+async function stripExif(input) {
+  return native.stripExif(input);
 }
-function blurhashSync(input, componentsX, componentsY) {
-  return native.blurhashSync(input, componentsX, componentsY);
+function stripExifSync(input) {
+  return native.stripExifSync(input);
 }
+
+// src/index.ts
 function version() {
   return native.version();
 }
@@ -216,6 +253,10 @@ var index_default = {
   transformSync,
   blurhash,
   blurhashSync,
+  writeExif,
+  writeExifSync,
+  stripExif,
+  stripExifSync,
   version
 };
 // Annotate the CommonJS export names for ESM import in node:
@@ -226,6 +267,8 @@ var index_default = {
   metadataSync,
   resize,
   resizeSync,
+  stripExif,
+  stripExifSync,
   toJpeg,
   toJpegSync,
   toPng,
@@ -234,5 +277,7 @@ var index_default = {
   toWebpSync,
   transform,
   transformSync,
-  version
+  version,
+  writeExif,
+  writeExifSync
 });

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);
@@ -121,50 +131,71 @@ 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) {
-  return native.metadata(input);
-}
+
+// src/api/resize.ts
 async function resize(input, options) {
   return native.resize(input, toNapiResizeOptions(options));
 }
+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 metadataSync(input) {
-  return native.metadataSync(input);
-}
-function resizeSync(input, options) {
-  return native.resizeSync(input, toNapiResizeOptions(options));
-}
-function toJpegSync(input, options) {
-  return native.toJpegSync(input, options);
+function blurhashSync(input, componentsX, componentsY) {
+  return native.blurhashSync(input, componentsX, componentsY);
 }
-function toPngSync(input, options) {
-  return native.toPngSync(input, options);
+
+// src/api/exif.ts
+async function writeExif(input, options) {
+  return native.writeExif(input, options);
 }
-function toWebpSync(input, options) {
-  return native.toWebpSync(input, options);
+function writeExifSync(input, options) {
+  return native.writeExifSync(input, options);
 }
-function transformSync(input, options) {
-  return native.transformSync(input, toNapiTransformOptions(options));
+async function stripExif(input) {
+  return native.stripExif(input);
 }
-function blurhashSync(input, componentsX, componentsY) {
-  return native.blurhashSync(input, componentsX, componentsY);
+function stripExifSync(input) {
+  return native.stripExifSync(input);
 }
+
+// src/index.ts
 function version() {
   return native.version();
 }
@@ -183,6 +214,10 @@ var index_default = {
   transformSync,
   blurhash,
   blurhashSync,
+  writeExif,
+  writeExifSync,
+  stripExif,
+  stripExifSync,
   version
 };
 export {
@@ -193,6 +228,8 @@ export {
   metadataSync,
   resize,
   resizeSync,
+  stripExif,
+  stripExifSync,
   toJpeg,
   toJpegSync,
   toPng,
@@ -201,5 +238,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.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.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"
-  }
+  "types": "./dist/index.d.ts"
 }