heif2jpeg 0.1.1

package/README.md

@@ -0,0 +1,67 @@
+# heif2jpeg
+
+Fast and simple HEIC/HEIF to JPEG converter for Node.js. Native performance, zero runtime dependencies.
+
+Built with node-api.
+
+## Install
+
+```bash
+npm install heif2jpeg
+```
+
+Prebuilt binaries are provided for:
+
+| Platform | Architecture |
+|----------|-------------|
+| macOS | x64, arm64 |
+| Linux (glibc) | x64, arm64 |
+| Linux (musl) | x64, arm64 |
+| Windows | x64, arm64 |
+
+Works with Node.js, Bun, and Deno.
+
+## Usage
+
+```js
+const { heifToJpeg } = require("heif2jpeg");
+const fs = require("fs");
+
+const heic = fs.readFileSync("photo.heic");
+const jpeg = await heifToJpeg(heic, { quality: 85 });
+fs.writeFileSync("photo.jpg", jpeg);
+```
+
+## API
+
+### `heifToJpeg(input, options?)`
+
+Convert a HEIF/HEIC buffer to JPEG.
+
+- **input** `Buffer`: HEIF/HEIC file contents
+- **options.quality** `number`: JPEG quality, 1-100 (default: 85)
+- Returns `Promise<Buffer>`: JPEG file contents
+
+## How it works
+
+All processing runs on the libuv thread pool — the main thread is never blocked.
+
+1. [libheif](https://github.com/strukturag/libheif) parses the HEIF container
+2. [libde265](https://github.com/strukturag/libde265) decodes the HEVC payload to raw RGB pixels
+3. [jpeg-encoder](https://crates.io/crates/jpeg-encoder) (pure Rust) encodes to JPEG
+
+## Building from source
+
+Requires Rust, CMake, and a C/C++ compiler.
+
+```bash
+git clone --recurse-submodules https://github.com/nicmus/heif2jpeg.git
+cd heif2jpeg
+npm install
+npx napi build --platform --release
+npm test
+```
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,11 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface ConvertOptions {
+  /** JPEG quality (1-100, default 85) */
+  quality?: number
+}
+/** Convert a HEIF/HEIC buffer to JPEG. */
+export declare function heifToJpeg(input: Buffer, options?: ConvertOptions | undefined | null): Promise<unknown>

package/index.js

@@ -0,0 +1,315 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'heif2jpeg.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.android-arm64.node')
+          } else {
+            nativeBinding = require('heif2jpeg-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'heif2jpeg.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('heif2jpeg-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'heif2jpeg.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('heif2jpeg-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'heif2jpeg.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('heif2jpeg-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'heif2jpeg.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('heif2jpeg-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'heif2jpeg.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./heif2jpeg.darwin-universal.node')
+      } else {
+        nativeBinding = require('heif2jpeg-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'heif2jpeg.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.darwin-x64.node')
+          } else {
+            nativeBinding = require('heif2jpeg-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'heif2jpeg.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.darwin-arm64.node')
+          } else {
+            nativeBinding = require('heif2jpeg-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'heif2jpeg.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./heif2jpeg.freebsd-x64.node')
+      } else {
+        nativeBinding = require('heif2jpeg-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'heif2jpeg.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./heif2jpeg.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('heif2jpeg-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'heif2jpeg.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./heif2jpeg.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('heif2jpeg-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { heifToJpeg } = nativeBinding
+
+module.exports.heifToJpeg = heifToJpeg

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "heif2jpeg",
+  "version": "0.1.1",
+  "description": "Fast HEIC/HEIF to JPEG converter — native, zero runtime dependencies",
+  "type": "commonjs",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "napi": {
+    "name": "heif2jpeg",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "node --test test/test.mjs",
+    "version": "napi version"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">= 18"
+  },
+  "optionalDependencies": {
+    "heif2jpeg-win32-x64-msvc": "0.1.1",
+    "heif2jpeg-darwin-x64": "0.1.1",
+    "heif2jpeg-linux-x64-gnu": "0.1.1",
+    "heif2jpeg-darwin-arm64": "0.1.1",
+    "heif2jpeg-linux-arm64-gnu": "0.1.1"
+  }
+}