lightdrift-libraw 1.0.0-alpha.1 → 1.0.0-alpha.2

package/lib/index.js

@@ -1,761 +1,1358 @@
-const path = require("path");
-
-let librawAddon;
-try {
-  librawAddon = require("../build/Release/libraw_addon");
-} catch (err) {
-  try {
-    librawAddon = require("../build/Debug/libraw_addon");
-  } catch (err2) {
-    throw new Error('LibRaw addon not built. Run "npm run build" first.');
-  }
-}
-
-class LibRaw {
-  constructor() {
-    this._wrapper = new librawAddon.LibRawWrapper();
-  }
-
-  // ============== FILE OPERATIONS ==============
-
-  /**
-   * Load a RAW file from filesystem
-   * @param {string} filename - Path to the RAW file
-   * @returns {Promise<boolean>} - Success status
-   */
-  async loadFile(filename) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.loadFile(filename);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Load a RAW file from memory buffer
-   * @param {Buffer} buffer - Buffer containing RAW data
-   * @returns {Promise<boolean>} - Success status
-   */
-  async loadBuffer(buffer) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.loadBuffer(buffer);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Close and cleanup resources
-   * @returns {Promise<boolean>} - Success status
-   */
-  async close() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.close();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== ERROR HANDLING ==============
-
-  /**
-   * Get the last error message
-   * @returns {string} - Last error message
-   */
-  getLastError() {
-    return this._wrapper.getLastError();
-  }
-
-  /**
-   * Convert error code to string
-   * @param {number} errorCode - Error code
-   * @returns {string} - Error message
-   */
-  strerror(errorCode) {
-    return this._wrapper.strerror(errorCode);
-  }
-
-  // ============== METADATA & INFORMATION ==============
-
-  /**
-   * Get basic metadata from the loaded RAW file
-   * @returns {Promise<Object>} - Metadata object
-   */
-  async getMetadata() {
-    return new Promise((resolve, reject) => {
-      try {
-        const metadata = this._wrapper.getMetadata();
-        resolve(metadata);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get image dimensions and size information
-   * @returns {Promise<Object>} - Size object with width/height details
-   */
-  async getImageSize() {
-    return new Promise((resolve, reject) => {
-      try {
-        const size = this._wrapper.getImageSize();
-        resolve(size);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get advanced metadata including color matrices and calibration data
-   * @returns {Promise<Object>} - Advanced metadata object
-   */
-  async getAdvancedMetadata() {
-    return new Promise((resolve, reject) => {
-      try {
-        const metadata = this._wrapper.getAdvancedMetadata();
-        resolve(metadata);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get lens information
-   * @returns {Promise<Object>} - Lens metadata object
-   */
-  async getLensInfo() {
-    return new Promise((resolve, reject) => {
-      try {
-        const lensInfo = this._wrapper.getLensInfo();
-        resolve(lensInfo);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get color information including white balance and color matrices
-   * @returns {Promise<Object>} - Color information object
-   */
-  async getColorInfo() {
-    return new Promise((resolve, reject) => {
-      try {
-        const colorInfo = this._wrapper.getColorInfo();
-        resolve(colorInfo);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== IMAGE PROCESSING ==============
-
-  /**
-   * Unpack thumbnail data
-   * @returns {Promise<boolean>} - Success status
-   */
-  async unpackThumbnail() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.unpackThumbnail();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Process the RAW image with current settings
-   * @returns {Promise<boolean>} - Success status
-   */
-  async processImage() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.processImage();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Subtract black level from RAW data
-   * @returns {Promise<boolean>} - Success status
-   */
-  async subtractBlack() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.subtractBlack();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Convert RAW data to image format
-   * @returns {Promise<boolean>} - Success status
-   */
-  async raw2Image() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.raw2Image();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Adjust maximum values in the image
-   * @returns {Promise<boolean>} - Success status
-   */
-  async adjustMaximum() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.adjustMaximum();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== MEMORY IMAGE CREATION ==============
-
-  /**
-   * Create processed image in memory
-   * @returns {Promise<Object>} - Image data object with Buffer
-   */
-  async createMemoryImage() {
-    return new Promise((resolve, reject) => {
-      try {
-        const imageData = this._wrapper.createMemoryImage();
-        resolve(imageData);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Create thumbnail image in memory
-   * @returns {Promise<Object>} - Thumbnail data object with Buffer
-   */
-  async createMemoryThumbnail() {
-    return new Promise((resolve, reject) => {
-      try {
-        const thumbData = this._wrapper.createMemoryThumbnail();
-        resolve(thumbData);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== FILE WRITERS ==============
-
-  /**
-   * Write processed image as PPM file
-   * @param {string} filename - Output filename
-   * @returns {Promise<boolean>} - Success status
-   */
-  async writePPM(filename) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.writePPM(filename);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Write processed image as TIFF file
-   * @param {string} filename - Output filename
-   * @returns {Promise<boolean>} - Success status
-   */
-  async writeTIFF(filename) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.writeTIFF(filename);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Write thumbnail to file
-   * @param {string} filename - Output filename
-   * @returns {Promise<boolean>} - Success status
-   */
-  async writeThumbnail(filename) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.writeThumbnail(filename);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== CONFIGURATION & SETTINGS ==============
-
-  /**
-   * Set output parameters for processing
-   * @param {Object} params - Parameter object
-   * @returns {Promise<boolean>} - Success status
-   */
-  async setOutputParams(params) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.setOutputParams(params);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get current output parameters
-   * @returns {Promise<Object>} - Current parameters
-   */
-  async getOutputParams() {
-    return new Promise((resolve, reject) => {
-      try {
-        const params = this._wrapper.getOutputParams();
-        resolve(params);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== UTILITY FUNCTIONS ==============
-
-  /**
-   * Check if image uses floating point data
-   * @returns {Promise<boolean>} - Floating point status
-   */
-  async isFloatingPoint() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isFloatingPoint();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if image is Fuji rotated
-   * @returns {Promise<boolean>} - Fuji rotation status
-   */
-  async isFujiRotated() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isFujiRotated();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if image is sRAW format
-   * @returns {Promise<boolean>} - sRAW status
-   */
-  async isSRAW() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isSRAW();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if thumbnail is JPEG format
-   * @returns {Promise<boolean>} - JPEG thumbnail status
-   */
-  async isJPEGThumb() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isJPEGThumb();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get error count during processing
-   * @returns {Promise<number>} - Number of errors
-   */
-  async errorCount() {
-    return new Promise((resolve, reject) => {
-      try {
-        const count = this._wrapper.errorCount();
-        resolve(count);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== EXTENDED UTILITY FUNCTIONS ==============
-
-  /**
-   * Check if image is Nikon sRAW format
-   * @returns {Promise<boolean>} - True if Nikon sRAW
-   */
-  async isNikonSRAW() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isNikonSRAW();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if image is Coolscan NEF format
-   * @returns {Promise<boolean>} - True if Coolscan NEF
-   */
-  async isCoolscanNEF() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.isCoolscanNEF();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if image has floating point data
-   * @returns {Promise<boolean>} - True if floating point data available
-   */
-  async haveFPData() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.haveFPData();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get sRAW midpoint value
-   * @returns {Promise<number>} - sRAW midpoint
-   */
-  async srawMidpoint() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.srawMidpoint();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Check if thumbnail is OK
-   * @param {number} [maxSize=-1] - Maximum size limit
-   * @returns {Promise<number>} - Thumbnail status
-   */
-  async thumbOK(maxSize = -1) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.thumbOK(maxSize);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get unpacker function name
-   * @returns {Promise<string>} - Name of the unpacker function
-   */
-  async unpackFunctionName() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.unpackFunctionName();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Get decoder information
-   * @returns {Promise<Object>} - Decoder info with name and flags
-   */
-  async getDecoderInfo() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.getDecoderInfo();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== ADVANCED PROCESSING ==============
-
-  /**
-   * Unpack RAW data (low-level operation)
-   * @returns {Promise<boolean>} - Success status
-   */
-  async unpack() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.unpack();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Convert RAW to image with extended options
-   * @param {boolean} [subtractBlack=true] - Whether to subtract black level
-   * @returns {Promise<boolean>} - Success status
-   */
-  async raw2ImageEx(subtractBlack = true) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.raw2ImageEx(subtractBlack);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Adjust sizes for information only (no processing)
-   * @returns {Promise<boolean>} - Success status
-   */
-  async adjustSizesInfoOnly() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.adjustSizesInfoOnly();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Free processed image data
-   * @returns {Promise<boolean>} - Success status
-   */
-  async freeImage() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.freeImage();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Convert floating point to integer data
-   * @param {number} [dmin=4096] - Minimum data value
-   * @param {number} [dmax=32767] - Maximum data value
-   * @param {number} [dtarget=16383] - Target value
-   * @returns {Promise<boolean>} - Success status
-   */
-  async convertFloatToInt(dmin = 4096, dmax = 32767, dtarget = 16383) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.convertFloatToInt(dmin, dmax, dtarget);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== MEMORY OPERATIONS EXTENDED ==============
-
-  /**
-   * Get memory image format information
-   * @returns {Promise<Object>} - Format info with width, height, colors, bps
-   */
-  async getMemImageFormat() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.getMemImageFormat();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Copy memory image to buffer
-   * @param {Buffer} buffer - Destination buffer
-   * @param {number} stride - Row stride in bytes
-   * @param {boolean} bgr - Whether to use BGR order
-   * @returns {Promise<boolean>} - Success status
-   */
-  async copyMemImage(buffer, stride, bgr = false) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.copyMemImage(buffer, stride, bgr);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== COLOR OPERATIONS ==============
-
-  /**
-   * Get color filter at specific position
-   * @param {number} row - Row position
-   * @param {number} col - Column position
-   * @returns {Promise<number>} - Color value
-   */
-  async getColorAt(row, col) {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.getColorAt(row, col);
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== CANCELLATION SUPPORT ==============
-
-  /**
-   * Set cancellation flag to stop processing
-   * @returns {Promise<boolean>} - Success status
-   */
-  async setCancelFlag() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.setCancelFlag();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  /**
-   * Clear cancellation flag
-   * @returns {Promise<boolean>} - Success status
-   */
-  async clearCancelFlag() {
-    return new Promise((resolve, reject) => {
-      try {
-        const result = this._wrapper.clearCancelFlag();
-        resolve(result);
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  // ============== VERSION INFORMATION (INSTANCE METHODS) ==============
-
-  /**
-   * Get LibRaw version string
-   * @returns {string} - Version string
-   */
-  version() {
-    return this._wrapper.version();
-  }
-
-  /**
-   * Get LibRaw version as array [major, minor, patch]
-   * @returns {number[]} - Version number array
-   */
-  versionNumber() {
-    return this._wrapper.versionNumber();
-  }
-
-  // ============== STATIC METHODS ==============
-
-  /**
-   * Get LibRaw version
-   * @returns {string} - Version string
-   */
-  static getVersion() {
-    return librawAddon.LibRawWrapper.getVersion();
-  }
-
-  /**
-   * Get LibRaw capabilities
-   * @returns {number} - Capabilities flags
-   */
-  static getCapabilities() {
-    return librawAddon.LibRawWrapper.getCapabilities();
-  }
-
-  /**
-   * Get list of supported cameras
-   * @returns {string[]} - Array of camera names
-   */
-  static getCameraList() {
-    return librawAddon.LibRawWrapper.getCameraList();
-  }
-
-  /**
-   * Get count of supported cameras
-   * @returns {number} - Number of supported cameras
-   */
-  static getCameraCount() {
-    return librawAddon.LibRawWrapper.getCameraCount();
-  }
-}
-
-module.exports = LibRaw;
+const path = require("path");
+const sharp = require("sharp");
+
+let librawAddon;
+try {
+  librawAddon = require("../build/Release/libraw_addon");
+} catch (err) {
+  try {
+    librawAddon = require("../build/Debug/libraw_addon");
+  } catch (err2) {
+    throw new Error('LibRaw addon not built. Run "npm run build" first.');
+  }
+}
+
+class LibRaw {
+  constructor() {
+    this._wrapper = new librawAddon.LibRawWrapper();
+    this._isProcessed = false; // Track if processImage() has been called
+    this._processedImageData = null; // Cache processed image data
+  }
+
+  // ============== FILE OPERATIONS ==============
+
+  /**
+   * Load a RAW file from filesystem
+   * @param {string} filename - Path to the RAW file
+   * @returns {Promise<boolean>} - Success status
+   */
+  async loadFile(filename) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.loadFile(filename);
+        this._isProcessed = false; // Reset processing state for new file
+        this._processedImageData = null; // Clear cached data
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Load a RAW file from memory buffer
+   * @param {Buffer} buffer - Buffer containing RAW data
+   * @returns {Promise<boolean>} - Success status
+   */
+  async loadBuffer(buffer) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.loadBuffer(buffer);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Close and cleanup resources
+   * @returns {Promise<boolean>} - Success status
+   */
+  async close() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.close();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== ERROR HANDLING ==============
+
+  /**
+   * Get the last error message
+   * @returns {string} - Last error message
+   */
+  getLastError() {
+    return this._wrapper.getLastError();
+  }
+
+  /**
+   * Convert error code to string
+   * @param {number} errorCode - Error code
+   * @returns {string} - Error message
+   */
+  strerror(errorCode) {
+    return this._wrapper.strerror(errorCode);
+  }
+
+  // ============== METADATA & INFORMATION ==============
+
+  /**
+   * Get basic metadata from the loaded RAW file
+   * @returns {Promise<Object>} - Metadata object
+   */
+  async getMetadata() {
+    return new Promise((resolve, reject) => {
+      try {
+        const metadata = this._wrapper.getMetadata();
+        resolve(metadata);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get image dimensions and size information
+   * @returns {Promise<Object>} - Size object with width/height details
+   */
+  async getImageSize() {
+    return new Promise((resolve, reject) => {
+      try {
+        const size = this._wrapper.getImageSize();
+        resolve(size);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get advanced metadata including color matrices and calibration data
+   * @returns {Promise<Object>} - Advanced metadata object
+   */
+  async getAdvancedMetadata() {
+    return new Promise((resolve, reject) => {
+      try {
+        const metadata = this._wrapper.getAdvancedMetadata();
+        resolve(metadata);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get lens information
+   * @returns {Promise<Object>} - Lens metadata object
+   */
+  async getLensInfo() {
+    return new Promise((resolve, reject) => {
+      try {
+        const lensInfo = this._wrapper.getLensInfo();
+        resolve(lensInfo);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get color information including white balance and color matrices
+   * @returns {Promise<Object>} - Color information object
+   */
+  async getColorInfo() {
+    return new Promise((resolve, reject) => {
+      try {
+        const colorInfo = this._wrapper.getColorInfo();
+        resolve(colorInfo);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== IMAGE PROCESSING ==============
+
+  /**
+   * Unpack thumbnail data
+   * @returns {Promise<boolean>} - Success status
+   */
+  async unpackThumbnail() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.unpackThumbnail();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Process the RAW image with current settings
+   * @returns {Promise<boolean>} - Success status
+   */
+  async processImage() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.processImage();
+        this._isProcessed = true; // Mark as processed
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Subtract black level from RAW data
+   * @returns {Promise<boolean>} - Success status
+   */
+  async subtractBlack() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.subtractBlack();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Convert RAW data to image format
+   * @returns {Promise<boolean>} - Success status
+   */
+  async raw2Image() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.raw2Image();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Adjust maximum values in the image
+   * @returns {Promise<boolean>} - Success status
+   */
+  async adjustMaximum() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.adjustMaximum();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== MEMORY IMAGE CREATION ==============
+
+  /**
+   * Create processed image in memory
+   * @returns {Promise<Object>} - Image data object with Buffer
+   */
+  async createMemoryImage() {
+    return new Promise((resolve, reject) => {
+      try {
+        // Return cached data if available
+        if (this._processedImageData) {
+          resolve(this._processedImageData);
+          return;
+        }
+
+        const imageData = this._wrapper.createMemoryImage();
+
+        // Cache the result if image was processed
+        if (this._isProcessed) {
+          this._processedImageData = imageData;
+        }
+
+        resolve(imageData);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Create thumbnail image in memory
+   * @returns {Promise<Object>} - Thumbnail data object with Buffer
+   */
+  async createMemoryThumbnail() {
+    return new Promise((resolve, reject) => {
+      try {
+        const thumbData = this._wrapper.createMemoryThumbnail();
+        resolve(thumbData);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== FILE WRITERS ==============
+
+  /**
+   * Write processed image as PPM file
+   * @param {string} filename - Output filename
+   * @returns {Promise<boolean>} - Success status
+   */
+  async writePPM(filename) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.writePPM(filename);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Write processed image as TIFF file
+   * @param {string} filename - Output filename
+   * @returns {Promise<boolean>} - Success status
+   */
+  async writeTIFF(filename) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.writeTIFF(filename);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Write thumbnail to file
+   * @param {string} filename - Output filename
+   * @returns {Promise<boolean>} - Success status
+   */
+  async writeThumbnail(filename) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.writeThumbnail(filename);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== CONFIGURATION & SETTINGS ==============
+
+  /**
+   * Set output parameters for processing
+   * @param {Object} params - Parameter object
+   * @returns {Promise<boolean>} - Success status
+   */
+  async setOutputParams(params) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.setOutputParams(params);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get current output parameters
+   * @returns {Promise<Object>} - Current parameters
+   */
+  async getOutputParams() {
+    return new Promise((resolve, reject) => {
+      try {
+        const params = this._wrapper.getOutputParams();
+        resolve(params);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== UTILITY FUNCTIONS ==============
+
+  /**
+   * Check if image uses floating point data
+   * @returns {Promise<boolean>} - Floating point status
+   */
+  async isFloatingPoint() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isFloatingPoint();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if image is Fuji rotated
+   * @returns {Promise<boolean>} - Fuji rotation status
+   */
+  async isFujiRotated() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isFujiRotated();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if image is sRAW format
+   * @returns {Promise<boolean>} - sRAW status
+   */
+  async isSRAW() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isSRAW();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if thumbnail is JPEG format
+   * @returns {Promise<boolean>} - JPEG thumbnail status
+   */
+  async isJPEGThumb() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isJPEGThumb();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get error count during processing
+   * @returns {Promise<number>} - Number of errors
+   */
+  async errorCount() {
+    return new Promise((resolve, reject) => {
+      try {
+        const count = this._wrapper.errorCount();
+        resolve(count);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== EXTENDED UTILITY FUNCTIONS ==============
+
+  /**
+   * Check if image is Nikon sRAW format
+   * @returns {Promise<boolean>} - True if Nikon sRAW
+   */
+  async isNikonSRAW() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isNikonSRAW();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if image is Coolscan NEF format
+   * @returns {Promise<boolean>} - True if Coolscan NEF
+   */
+  async isCoolscanNEF() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.isCoolscanNEF();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if image has floating point data
+   * @returns {Promise<boolean>} - True if floating point data available
+   */
+  async haveFPData() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.haveFPData();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get sRAW midpoint value
+   * @returns {Promise<number>} - sRAW midpoint
+   */
+  async srawMidpoint() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.srawMidpoint();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Check if thumbnail is OK
+   * @param {number} [maxSize=-1] - Maximum size limit
+   * @returns {Promise<number>} - Thumbnail status
+   */
+  async thumbOK(maxSize = -1) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.thumbOK(maxSize);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get unpacker function name
+   * @returns {Promise<string>} - Name of the unpacker function
+   */
+  async unpackFunctionName() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.unpackFunctionName();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Get decoder information
+   * @returns {Promise<Object>} - Decoder info with name and flags
+   */
+  async getDecoderInfo() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.getDecoderInfo();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== ADVANCED PROCESSING ==============
+
+  /**
+   * Unpack RAW data (low-level operation)
+   * @returns {Promise<boolean>} - Success status
+   */
+  async unpack() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.unpack();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Convert RAW to image with extended options
+   * @param {boolean} [subtractBlack=true] - Whether to subtract black level
+   * @returns {Promise<boolean>} - Success status
+   */
+  async raw2ImageEx(subtractBlack = true) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.raw2ImageEx(subtractBlack);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Adjust sizes for information only (no processing)
+   * @returns {Promise<boolean>} - Success status
+   */
+  async adjustSizesInfoOnly() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.adjustSizesInfoOnly();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Free processed image data
+   * @returns {Promise<boolean>} - Success status
+   */
+  async freeImage() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.freeImage();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Convert floating point to integer data
+   * @param {number} [dmin=4096] - Minimum data value
+   * @param {number} [dmax=32767] - Maximum data value
+   * @param {number} [dtarget=16383] - Target value
+   * @returns {Promise<boolean>} - Success status
+   */
+  async convertFloatToInt(dmin = 4096, dmax = 32767, dtarget = 16383) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.convertFloatToInt(dmin, dmax, dtarget);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== MEMORY OPERATIONS EXTENDED ==============
+
+  /**
+   * Get memory image format information
+   * @returns {Promise<Object>} - Format info with width, height, colors, bps
+   */
+  async getMemImageFormat() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.getMemImageFormat();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Copy memory image to buffer
+   * @param {Buffer} buffer - Destination buffer
+   * @param {number} stride - Row stride in bytes
+   * @param {boolean} bgr - Whether to use BGR order
+   * @returns {Promise<boolean>} - Success status
+   */
+  async copyMemImage(buffer, stride, bgr = false) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.copyMemImage(buffer, stride, bgr);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== COLOR OPERATIONS ==============
+
+  /**
+   * Get color filter at specific position
+   * @param {number} row - Row position
+   * @param {number} col - Column position
+   * @returns {Promise<number>} - Color value
+   */
+  async getColorAt(row, col) {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.getColorAt(row, col);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== JPEG CONVERSION (NEW FEATURE) ==============
+
+  /**
+   * Convert RAW to JPEG with advanced options
+   * @param {string} outputPath - Output JPEG file path
+   * @param {Object} options - JPEG conversion options
+   * @param {number} [options.quality=85] - JPEG quality (1-100)
+   * @param {number} [options.width] - Target width (maintains aspect ratio if height not specified)
+   * @param {number} [options.height] - Target height (maintains aspect ratio if width not specified)
+   * @param {boolean} [options.progressive=false] - Use progressive JPEG
+   * @param {boolean} [options.mozjpeg=true] - Use mozjpeg encoder for better compression
+   * @param {number} [options.chromaSubsampling='4:2:0'] - Chroma subsampling ('4:4:4', '4:2:2', '4:2:0')
+   * @param {boolean} [options.trellisQuantisation=false] - Enable trellis quantisation
+   * @param {boolean} [options.optimizeScans=false] - Optimize scan order
+   * @param {number} [options.overshootDeringing=false] - Overshoot deringing
+   * @param {boolean} [options.optimizeCoding=true] - Optimize Huffman coding
+   * @param {string} [options.colorSpace='srgb'] - Output color space ('srgb', 'rec2020', 'p3', 'cmyk')
+   * @returns {Promise<Object>} - Conversion result with metadata
+   */
+  async convertToJPEG(outputPath, options = {}) {
+    return new Promise(async (resolve, reject) => {
+      try {
+        // Set default options with performance-optimized values
+        const opts = {
+          quality: options.quality || 85,
+          progressive: options.progressive || false,
+          mozjpeg: options.mozjpeg !== false, // Default to true for better compression
+          chromaSubsampling: options.chromaSubsampling || "4:2:0",
+          trellisQuantisation: options.trellisQuantisation || false,
+          optimizeScans: options.optimizeScans || false,
+          overshootDeringing: options.overshootDeringing || false,
+          optimizeCoding: options.optimizeCoding !== false, // Default to true
+          colorSpace: options.colorSpace || "srgb",
+          ...options,
+        };
+
+        const startTime = process.hrtime.bigint();
+
+        // Smart processing: only process if not already processed
+        if (!this._isProcessed) {
+          await this.processImage();
+        }
+
+        // Create processed image in memory (uses cache if available)
+        const imageData = await this.createMemoryImage();
+
+        if (!imageData || !imageData.data) {
+          throw new Error("Failed to create memory image from RAW data");
+        }
+
+        // Convert the LibRaw RGB data to Sharp-compatible buffer
+        let sharpInstance;
+
+        // Determine if this is a large image for performance optimizations
+        const isLargeImage = imageData.width * imageData.height > 20_000_000; // > 20MP
+        const fastMode = opts.fastMode !== false; // Default to fast mode
+
+        // Optimized Sharp configuration
+        const sharpConfig = {
+          raw: {
+            width: imageData.width,
+            height: imageData.height,
+            channels: imageData.colors,
+            premultiplied: false,
+          },
+          // Performance optimizations
+          sequentialRead: true,
+          limitInputPixels: false,
+          density: fastMode ? 72 : 300, // Lower DPI for speed
+        };
+
+        if (imageData.bits === 16) {
+          sharpConfig.raw.depth = "ushort";
+        }
+
+        sharpInstance = sharp(imageData.data, sharpConfig);
+
+        // Apply resizing if specified with performance optimizations
+        if (opts.width || opts.height) {
+          const resizeOptions = {
+            withoutEnlargement: true,
+            // Use faster kernel for large images or when fast mode is enabled
+            kernel:
+              isLargeImage || fastMode
+                ? sharp.kernel.cubic
+                : sharp.kernel.lanczos3,
+            fit: "inside",
+            fastShrinkOnLoad: true, // Enable fast shrink-on-load optimization
+          };
+
+          if (opts.width && opts.height) {
+            sharpInstance = sharpInstance.resize(
+              opts.width,
+              opts.height,
+              resizeOptions
+            );
+          } else if (opts.width) {
+            sharpInstance = sharpInstance.resize(
+              opts.width,
+              null,
+              resizeOptions
+            );
+          } else {
+            sharpInstance = sharpInstance.resize(
+              null,
+              opts.height,
+              resizeOptions
+            );
+          }
+        }
+
+        // Configure color space
+        switch (opts.colorSpace.toLowerCase()) {
+          case "rec2020":
+            sharpInstance = sharpInstance.toColorspace("rec2020");
+            break;
+          case "p3":
+            sharpInstance = sharpInstance.toColorspace("p3");
+            break;
+          case "cmyk":
+            sharpInstance = sharpInstance.toColorspace("cmyk");
+            break;
+          case "srgb":
+          default:
+            sharpInstance = sharpInstance.toColorspace("srgb");
+            break;
+        }
+
+        // Configure JPEG options with performance optimizations
+        const jpegOptions = {
+          quality: Math.max(1, Math.min(100, opts.quality)),
+          progressive: fastMode ? false : opts.progressive, // Disable progressive for speed
+          mozjpeg: fastMode ? false : opts.mozjpeg, // Disable mozjpeg for speed
+          trellisQuantisation: fastMode ? false : opts.trellisQuantisation,
+          optimizeScans: fastMode ? false : opts.optimizeScans,
+          overshootDeringing: false, // Always disable for speed
+          optimizeCoding: fastMode ? false : opts.optimizeCoding,
+          // Add effort control for JPEG encoding
+          effort: fastMode ? 1 : Math.min(opts.effort || 4, 6),
+        };
+
+        // Set chroma subsampling
+        switch (opts.chromaSubsampling) {
+          case "4:4:4":
+            jpegOptions.chromaSubsampling = "4:4:4";
+            break;
+          case "4:2:2":
+            jpegOptions.chromaSubsampling = "4:4:4"; // Sharp doesn't support 4:2:2, use 4:4:4 instead
+            break;
+          case "4:2:0":
+          default:
+            jpegOptions.chromaSubsampling = "4:2:0";
+            break;
+        }
+
+        // Convert to JPEG and save
+        const jpegBuffer = await sharpInstance
+          .jpeg(jpegOptions)
+          .toBuffer({ resolveWithObject: true });
+
+        // Write to file
+        await sharp(jpegBuffer.data).toFile(outputPath);
+
+        const endTime = process.hrtime.bigint();
+        const processingTime = Number(endTime - startTime) / 1000000; // Convert to milliseconds
+
+        // Get output file stats
+        const fs = require("fs");
+        const stats = fs.statSync(outputPath);
+
+        // Calculate compression ratio
+        const originalSize = imageData.dataSize;
+        const compressedSize = stats.size;
+        const compressionRatio = originalSize / compressedSize;
+
+        const result = {
+          success: true,
+          outputPath: outputPath,
+          metadata: {
+            originalDimensions: {
+              width: imageData.width,
+              height: imageData.height,
+            },
+            outputDimensions: {
+              width: jpegBuffer.info.width,
+              height: jpegBuffer.info.height,
+            },
+            fileSize: {
+              original: originalSize,
+              compressed: compressedSize,
+              compressionRatio: compressionRatio.toFixed(2),
+            },
+            processing: {
+              timeMs: processingTime.toFixed(2),
+              throughputMBps: (
+                originalSize /
+                1024 /
+                1024 /
+                (processingTime / 1000)
+              ).toFixed(2),
+            },
+            jpegOptions: jpegOptions,
+          },
+        };
+
+        resolve(result);
+      } catch (error) {
+        reject(new Error(`JPEG conversion failed: ${error.message}`));
+      }
+    });
+  }
+
+  /**
+   * Batch convert multiple RAW files to JPEG
+   * @param {string[]} inputPaths - Array of input RAW file paths
+   * @param {string} outputDir - Output directory for JPEG files
+   * @param {Object} options - JPEG conversion options (same as convertToJPEG)
+   * @returns {Promise<Object>} - Batch conversion results
+   */
+  async batchConvertToJPEG(inputPaths, outputDir, options = {}) {
+    return new Promise(async (resolve, reject) => {
+      try {
+        const fs = require("fs");
+        const path = require("path");
+
+        // Ensure output directory exists
+        if (!fs.existsSync(outputDir)) {
+          fs.mkdirSync(outputDir, { recursive: true });
+        }
+
+        const results = {
+          successful: [],
+          failed: [],
+          summary: {
+            total: inputPaths.length,
+            processed: 0,
+            errors: 0,
+            totalProcessingTime: 0,
+            averageCompressionRatio: 0,
+            totalOriginalSize: 0,
+            totalCompressedSize: 0,
+          },
+        };
+
+        const startTime = process.hrtime.bigint();
+
+        for (const inputPath of inputPaths) {
+          try {
+            // Generate output filename
+            const baseName = path.basename(inputPath, path.extname(inputPath));
+            const outputPath = path.join(outputDir, `${baseName}.jpg`);
+
+            // Load the RAW file
+            await this.close(); // Close any previous file
+            await this.loadFile(inputPath);
+
+            // Convert to JPEG
+            const result = await this.convertToJPEG(outputPath, options);
+
+            results.successful.push({
+              input: inputPath,
+              output: outputPath,
+              result: result,
+            });
+
+            results.summary.processed++;
+            results.summary.totalOriginalSize +=
+              result.metadata.fileSize.original;
+            results.summary.totalCompressedSize +=
+              result.metadata.fileSize.compressed;
+          } catch (error) {
+            results.failed.push({
+              input: inputPath,
+              error: error.message,
+            });
+            results.summary.errors++;
+          }
+        }
+
+        const endTime = process.hrtime.bigint();
+        results.summary.totalProcessingTime =
+          Number(endTime - startTime) / 1000000; // ms
+
+        if (results.summary.totalOriginalSize > 0) {
+          results.summary.averageCompressionRatio = (
+            results.summary.totalOriginalSize /
+            results.summary.totalCompressedSize
+          ).toFixed(2);
+        }
+
+        results.summary.averageProcessingTimePerFile = (
+          results.summary.totalProcessingTime / inputPaths.length
+        ).toFixed(2);
+
+        resolve(results);
+      } catch (error) {
+        reject(new Error(`Batch JPEG conversion failed: ${error.message}`));
+      }
+    });
+  }
+
+  /**
+   * Get optimal JPEG conversion settings based on image analysis
+   * @param {Object} analysisOptions - Options for image analysis
+   * @returns {Promise<Object>} - Recommended JPEG settings
+   */
+  async getOptimalJPEGSettings(analysisOptions = {}) {
+    return new Promise(async (resolve, reject) => {
+      try {
+        // Get image metadata and process for analysis
+        const metadata = await this.getMetadata();
+        const imageSize = await this.getImageSize();
+
+        // Analyze image characteristics
+        const imageArea = metadata.width * metadata.height;
+        const isHighRes = imageArea > 6000 * 4000; // > 24MP
+        const isMediumRes = imageArea > 3000 * 2000; // > 6MP
+
+        // Default settings based on image characteristics
+        let recommendedSettings = {
+          quality: 85,
+          progressive: false,
+          mozjpeg: true,
+          chromaSubsampling: "4:2:0",
+          optimizeCoding: true,
+          trellisQuantisation: false,
+          optimizeScans: false,
+          reasoning: [],
+        };
+
+        // Adjust settings based on image size
+        if (isHighRes) {
+          recommendedSettings.quality = 80; // Slightly lower quality for large images
+          recommendedSettings.progressive = true; // Progressive loading for large images
+          recommendedSettings.trellisQuantisation = true; // Better compression for large images
+          recommendedSettings.reasoning.push(
+            "High resolution image detected - optimizing for file size"
+          );
+        } else if (isMediumRes) {
+          recommendedSettings.quality = 85;
+          recommendedSettings.reasoning.push(
+            "Medium resolution image - balanced quality/size"
+          );
+        } else {
+          recommendedSettings.quality = 90; // Higher quality for smaller images
+          recommendedSettings.chromaSubsampling = "4:4:4"; // Better chroma for small images (Sharp compatible)
+          recommendedSettings.reasoning.push(
+            "Lower resolution image - prioritizing quality"
+          );
+        }
+
+        // Adjust for different use cases
+        if (analysisOptions.usage === "web") {
+          recommendedSettings.quality = Math.min(
+            recommendedSettings.quality,
+            80
+          );
+          recommendedSettings.progressive = true;
+          recommendedSettings.optimizeScans = true;
+          recommendedSettings.reasoning.push(
+            "Web usage - optimized for loading speed"
+          );
+        } else if (analysisOptions.usage === "print") {
+          recommendedSettings.quality = Math.max(
+            recommendedSettings.quality,
+            90
+          );
+          recommendedSettings.chromaSubsampling = "4:4:4"; // Use 4:4:4 instead of 4:2:2 for Sharp compatibility
+          recommendedSettings.reasoning.push(
+            "Print usage - optimized for quality"
+          );
+        } else if (analysisOptions.usage === "archive") {
+          recommendedSettings.quality = 95;
+          recommendedSettings.chromaSubsampling = "4:4:4";
+          recommendedSettings.trellisQuantisation = true;
+          recommendedSettings.reasoning.push(
+            "Archive usage - maximum quality preservation"
+          );
+        }
+
+        // Camera-specific optimizations
+        if (metadata.make) {
+          const make = metadata.make.toLowerCase();
+          if (make.includes("canon") || make.includes("nikon")) {
+            // Professional cameras often benefit from slightly different settings
+            recommendedSettings.reasoning.push(
+              `${metadata.make} camera detected - professional settings`
+            );
+          }
+        }
+
+        resolve({
+          recommended: recommendedSettings,
+          imageAnalysis: {
+            dimensions: {
+              width: metadata.width,
+              height: metadata.height,
+              area: imageArea,
+            },
+            category: isHighRes
+              ? "high-resolution"
+              : isMediumRes
+              ? "medium-resolution"
+              : "low-resolution",
+            camera: {
+              make: metadata.make,
+              model: metadata.model,
+            },
+          },
+        });
+      } catch (error) {
+        reject(
+          new Error(
+            `Failed to analyze image for optimal settings: ${error.message}`
+          )
+        );
+      }
+    });
+  }
+
+  // ============== CANCELLATION SUPPORT ==============
+
+  /**
+   * Set cancellation flag to stop processing
+   * @returns {Promise<boolean>} - Success status
+   */
+  async setCancelFlag() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.setCancelFlag();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Clear cancellation flag
+   * @returns {Promise<boolean>} - Success status
+   */
+  async clearCancelFlag() {
+    return new Promise((resolve, reject) => {
+      try {
+        const result = this._wrapper.clearCancelFlag();
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  // ============== VERSION INFORMATION (INSTANCE METHODS) ==============
+
+  /**
+   * Get LibRaw version string
+   * @returns {string} - Version string
+   */
+  version() {
+    return this._wrapper.version();
+  }
+
+  /**
+   * Get LibRaw version as array [major, minor, patch]
+   * @returns {number[]} - Version number array
+   */
+  versionNumber() {
+    return this._wrapper.versionNumber();
+  }
+
+  // ============== STATIC METHODS ==============
+
+  /**
+   * Get LibRaw version
+   * @returns {string} - Version string
+   */
+  static getVersion() {
+    return librawAddon.LibRawWrapper.getVersion();
+  }
+
+  /**
+   * Get LibRaw capabilities
+   * @returns {number} - Capabilities flags
+   */
+  static getCapabilities() {
+    return librawAddon.LibRawWrapper.getCapabilities();
+  }
+
+  /**
+   * Get list of supported cameras
+   * @returns {string[]} - Array of camera names
+   */
+  static getCameraList() {
+    return librawAddon.LibRawWrapper.getCameraList();
+  }
+
+  /**
+   * Get count of supported cameras
+   * @returns {number} - Number of supported cameras
+   */
+  static getCameraCount() {
+    return librawAddon.LibRawWrapper.getCameraCount();
+  }
+
+  /**
+   * High-performance fast JPEG conversion with minimal processing
+   * @param {string} outputPath - Output JPEG file path
+   * @param {Object} options - Speed-optimized JPEG options
+   * @returns {Promise<Object>} - Conversion result
+   */
+  async convertToJPEGFast(outputPath, options = {}) {
+    return this.convertToJPEG(outputPath, {
+      fastMode: true,
+      effort: 1, // Fastest encoding
+      progressive: false,
+      trellisQuantisation: false,
+      optimizeScans: false,
+      mozjpeg: false,
+      quality: options.quality || 80,
+      ...options,
+    });
+  }
+
+  /**
+   * Create multiple JPEG sizes from single RAW (thumbnail, web, full)
+   * @param {string} baseOutputPath - Base output path (without extension)
+   * @param {Object} options - Multi-size options
+   * @returns {Promise<Object>} - Multi-size conversion results
+   */
+  async convertToJPEGMultiSize(baseOutputPath, options = {}) {
+    const sizes = options.sizes || [
+      { name: "thumb", width: 400, quality: 85 },
+      { name: "web", width: 1920, quality: 80 },
+      { name: "full", quality: 85 },
+    ];
+
+    // Process the RAW once (uses smart caching)
+    if (!this._isProcessed) {
+      await this.processImage();
+    }
+
+    const results = {};
+    const startTime = Date.now();
+
+    // Create all sizes sequentially to reuse cached data
+    for (const sizeConfig of sizes) {
+      const outputPath = `${baseOutputPath}_${sizeConfig.name}.jpg`;
+      const sizeStart = Date.now();
+
+      const result = await this.convertToJPEG(outputPath, {
+        fastMode: true,
+        width: sizeConfig.width,
+        height: sizeConfig.height,
+        quality: sizeConfig.quality || 85,
+        effort: sizeConfig.effort || 2,
+        ...sizeConfig,
+      });
+
+      const sizeEnd = Date.now();
+
+      results[sizeConfig.name] = {
+        name: sizeConfig.name,
+        outputPath,
+        dimensions: result.metadata.outputDimensions,
+        fileSize: result.metadata.fileSize.compressed,
+        processingTime: sizeEnd - sizeStart,
+        config: sizeConfig,
+      };
+    }
+
+    const endTime = Date.now();
+    const totalTime = endTime - startTime;
+
+    return {
+      success: true,
+      sizes: results,
+      originalDimensions: Object.values(results)[0]
+        ? Object.values(results)[0].dimensions
+        : { width: 0, height: 0 },
+      totalProcessingTime: totalTime,
+      averageTimePerSize: `${(totalTime / sizes.length).toFixed(2)}ms`,
+    };
+  }
+
+  /**
+   * High-performance parallel batch conversion using worker threads
+   * @param {string[]} inputPaths - Array of RAW file paths
+   * @param {string} outputDir - Output directory
+   * @param {Object} options - Conversion options
+   * @returns {Promise<Object>} - Batch conversion results
+   */
+  static async batchConvertToJPEGParallel(inputPaths, outputDir, options = {}) {
+    const fs = require("fs");
+    const path = require("path");
+    const os = require("os");
+
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
+
+    const maxConcurrency =
+      options.maxConcurrency || Math.min(os.cpus().length, 4);
+    const results = [];
+    const errors = [];
+    const startTime = Date.now();
+
+    // Process files in parallel batches
+    for (let i = 0; i < inputPaths.length; i += maxConcurrency) {
+      const batch = inputPaths.slice(i, i + maxConcurrency);
+
+      const batchPromises = batch.map(async (inputPath) => {
+        try {
+          const fileName = path.parse(inputPath).name;
+          const outputPath = path.join(outputDir, `${fileName}.jpg`);
+
+          const libraw = new LibRaw();
+          await libraw.loadFile(inputPath);
+
+          const result = await libraw.convertToJPEG(outputPath, {
+            fastMode: true,
+            effort: 1,
+            quality: options.quality || 85,
+            ...options,
+          });
+
+          await libraw.close();
+
+          return {
+            inputPath,
+            outputPath,
+            success: true,
+            fileSize: result.metadata.fileSize.compressed,
+            processingTime: result.metadata.processing.timeMs,
+          };
+        } catch (error) {
+          errors.push({ inputPath, error: error.message });
+          return {
+            inputPath,
+            success: false,
+            error: error.message,
+          };
+        }
+      });
+
+      const batchResults = await Promise.all(batchPromises);
+      results.push(...batchResults);
+    }
+
+    const endTime = Date.now();
+    const successCount = results.filter((r) => r.success).length;
+
+    return {
+      totalFiles: inputPaths.length,
+      successCount,
+      errorCount: errors.length,
+      results,
+      errors,
+      totalProcessingTime: endTime - startTime,
+      averageTimePerFile:
+        successCount > 0 ? (endTime - startTime) / successCount : 0,
+    };
+  }
+}
+
+module.exports = LibRaw;