@dynlabs/react-native-image-to-webp 0.1.0

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@dynlabs/react-native-image-to-webp",
+  "version": "0.1.0",
+  "description": "Convert images to WebP format with presets and resizing options",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @dynlabs/react-native-image-to-webp-example",
+    "example:ios": "yarn workspace @dynlabs/react-native-image-to-webp-example ios",
+    "example:android": "yarn workspace @dynlabs/react-native-image-to-webp-example android",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "format": "prettier --write \"**/*.{js,ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{js,ts,tsx,json,md}\"",
+    "test": "echo \"No tests specified\" && exit 0",
+    "build": "bob build",
+    "vendor:libwebp": "node -e \"const {execSync} = require('child_process'); const os = require('os'); const script = os.platform() === 'win32' ? 'scripts/vendor-libwebp.ps1' : 'scripts/vendor-libwebp.sh'; execSync(script, {stdio: 'inherit'})\""
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+.git"
+  },
+  "author": " <> ()",
+  "license": "MIT",
+  "bugs": {
+    "url": "/issues"
+  },
+  "homepage": "#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "restricted"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.1",
+    "@commitlint/cli": "^19.5.0",
+    "@commitlint/config-conventional": "^19.5.0",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@types/react": "^19.2.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.0.11",
+    "lint-staged": "^15.2.2",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.17",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "ReactNativeImageToWebpSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.dynlabs.reactnativeimagetowebp"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.57.0"
+  }
+}

package/src/NativeReactNativeImageToWebp.ts

@@ -0,0 +1,32 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+export type ConvertPreset =
+  | 'balanced'
+  | 'small'
+  | 'fast'
+  | 'lossless'
+  | 'document';
+
+export interface ConvertOptions {
+  inputPath: string;
+  outputPath?: string;
+  preset?: ConvertPreset;
+  maxLongEdge?: number;
+  quality?: number;
+  method?: number;
+  lossless?: boolean;
+  stripMetadata?: boolean;
+}
+
+export interface ConvertResult {
+  outputPath: string;
+  width: number;
+  height: number;
+  sizeBytes: number;
+}
+
+export interface Spec extends TurboModule {
+  convertImageToWebP(options: ConvertOptions): Promise<ConvertResult>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('ReactNativeImageToWebp');

package/src/index.tsx

@@ -0,0 +1,109 @@
+import NativeReactNativeImageToWebp, {
+  type ConvertOptions,
+  type ConvertResult,
+  type ConvertPreset,
+} from './NativeReactNativeImageToWebp';
+import { validateOptions } from './validation';
+import { applyPreset } from './presets';
+
+export type { ConvertOptions, ConvertResult, ConvertPreset };
+
+const ERROR_CODES = {
+  INVALID_INPUT: 'INVALID_INPUT',
+  FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+  DECODE_FAILED: 'DECODE_FAILED',
+  ENCODE_FAILED: 'ENCODE_FAILED',
+  IO_ERROR: 'IO_ERROR',
+  UNSUPPORTED_FORMAT: 'UNSUPPORTED_FORMAT',
+} as const;
+
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+
+export class ImageToWebPError extends Error {
+  code: ErrorCode;
+
+  constructor(code: ErrorCode, message: string) {
+    super(message);
+    this.name = 'ImageToWebPError';
+    this.code = code;
+    Object.setPrototypeOf(this, ImageToWebPError.prototype);
+  }
+}
+
+/**
+ * Convert an image file to WebP format.
+ *
+ * @param options - Conversion options
+ * @returns Promise resolving to conversion result with output path and metadata
+ * @throws {ImageToWebPError} If conversion fails
+ *
+ * @example
+ * ```ts
+ * const result = await convertImageToWebP({
+ *   inputPath: '/path/to/image.jpg',
+ *   preset: 'balanced',
+ *   maxLongEdge: 2048,
+ * });
+ * console.log(`Output: ${result.outputPath}, Size: ${result.sizeBytes} bytes`);
+ * ```
+ */
+export async function convertImageToWebP(
+  options: ConvertOptions
+): Promise<ConvertResult> {
+  // Validate input
+  const validationError = validateOptions(options);
+  if (validationError) {
+    throw new ImageToWebPError(validationError.code, validationError.message);
+  }
+
+  // Apply preset defaults
+  const finalOptions = applyPreset(options);
+
+  try {
+    return await NativeReactNativeImageToWebp.convertImageToWebP(finalOptions);
+  } catch (error) {
+    // Map native errors to our error types
+    if (error instanceof Error) {
+      const message = error.message;
+      if (message.includes('FILE_NOT_FOUND')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.FILE_NOT_FOUND,
+          `File not found: ${options.inputPath}`
+        );
+      }
+      if (message.includes('DECODE_FAILED')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.DECODE_FAILED,
+          `Failed to decode image: ${message}`
+        );
+      }
+      if (message.includes('ENCODE_FAILED')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.ENCODE_FAILED,
+          `Failed to encode WebP: ${message}`
+        );
+      }
+      if (message.includes('IO_ERROR')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.IO_ERROR,
+          `I/O error: ${message}`
+        );
+      }
+      if (message.includes('UNSUPPORTED_FORMAT')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.UNSUPPORTED_FORMAT,
+          `Unsupported image format: ${message}`
+        );
+      }
+      if (message.includes('INVALID_INPUT')) {
+        throw new ImageToWebPError(
+          ERROR_CODES.INVALID_INPUT,
+          `Invalid input: ${message}`
+        );
+      }
+    }
+    throw error;
+  }
+}
+
+export { ERROR_CODES };

package/src/presets.ts

@@ -0,0 +1,80 @@
+import type {
+  ConvertOptions,
+  ConvertPreset,
+} from './NativeReactNativeImageToWebp';
+
+interface PresetConfig {
+  quality?: number;
+  method?: number;
+  lossless?: boolean;
+  stripMetadata?: boolean;
+  threadLevel?: number;
+  exact?: boolean;
+}
+
+const PRESETS: Record<ConvertPreset, PresetConfig> = {
+  balanced: {
+    quality: 80,
+    method: 3,
+    lossless: false,
+    stripMetadata: true,
+    threadLevel: 1,
+  },
+  small: {
+    quality: 74,
+    method: 5,
+    lossless: false,
+    stripMetadata: true,
+    threadLevel: 1,
+  },
+  fast: {
+    quality: 78,
+    method: 1,
+    lossless: false,
+    stripMetadata: true,
+    threadLevel: 1,
+  },
+  lossless: {
+    lossless: true,
+    method: 4,
+    stripMetadata: true,
+  },
+  document: {
+    quality: 82,
+    method: 4,
+    lossless: false,
+    stripMetadata: true,
+    exact: true, // Will be set conditionally if alpha present
+  },
+};
+
+export function applyPreset(options: ConvertOptions): ConvertOptions {
+  const preset: ConvertPreset = options.preset || 'balanced';
+  const presetConfig = PRESETS[preset];
+
+  const result: ConvertOptions = {
+    ...options,
+  };
+
+  // Apply preset values only if not explicitly overridden
+  if (result.quality === undefined && presetConfig.quality !== undefined) {
+    result.quality = presetConfig.quality;
+  }
+  if (result.method === undefined && presetConfig.method !== undefined) {
+    result.method = presetConfig.method;
+  }
+  if (result.lossless === undefined && presetConfig.lossless !== undefined) {
+    result.lossless = presetConfig.lossless;
+  }
+  if (
+    result.stripMetadata === undefined &&
+    presetConfig.stripMetadata !== undefined
+  ) {
+    result.stripMetadata = presetConfig.stripMetadata;
+  }
+
+  // Note: threadLevel and exact are handled natively, not passed through JS API
+  // They are documented here for reference but applied in native code
+
+  return result;
+}

package/src/validation.ts

@@ -0,0 +1,55 @@
+import type { ConvertOptions } from './NativeReactNativeImageToWebp';
+import type { ErrorCode } from './index';
+
+interface ValidationError {
+  code: ErrorCode;
+  message: string;
+}
+
+export function validateOptions(
+  options: ConvertOptions
+): ValidationError | null {
+  if (!options.inputPath || typeof options.inputPath !== 'string') {
+    return {
+      code: 'INVALID_INPUT',
+      message: 'inputPath is required and must be a string',
+    };
+  }
+
+  if (options.maxLongEdge !== undefined) {
+    if (typeof options.maxLongEdge !== 'number' || options.maxLongEdge <= 0) {
+      return {
+        code: 'INVALID_INPUT',
+        message: 'maxLongEdge must be a positive number',
+      };
+    }
+  }
+
+  if (options.quality !== undefined) {
+    if (
+      typeof options.quality !== 'number' ||
+      options.quality < 0 ||
+      options.quality > 100
+    ) {
+      return {
+        code: 'INVALID_INPUT',
+        message: 'quality must be a number between 0 and 100',
+      };
+    }
+  }
+
+  if (options.method !== undefined) {
+    if (
+      typeof options.method !== 'number' ||
+      options.method < 0 ||
+      options.method > 6
+    ) {
+      return {
+        code: 'INVALID_INPUT',
+        message: 'method must be a number between 0 and 6',
+      };
+    }
+  }
+
+  return null;
+}