nokhwa-node 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 N-API for Rust
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+# nokhwa-node
+
+![CI](https://github.com/nglmercer/nokhwa-node/workflows/CI/badge.svg)
+
+Node.js bindings for [nokhwa](https://github.com/l1npengtul/nokhwa) camera library using [napi-rs](https://napi.rs/). This package provides native performance for camera access across multiple platforms including WebAssembly via WASI.
+
+## Features
+
+- **Cross-platform support**: macOS, Linux (glibc & musl), Windows, FreeBSD, and WebAssembly (WASI)
+- **High performance**: Native Rust implementation with N-API for optimal speed
+- **WebAssembly support**: Run camera operations in browser and edge environments via WASI
+- **Thread-safe**: Multi-threaded camera access support
+- **Easy to use**: Simple JavaScript/TypeScript API
+
+## Supported Platforms
+
+| Platform | Architecture | Status |
+|----------|-------------|--------|
+| macOS | x86_64, ARM64 (Apple Silicon) | ✅ |
+| Windows | x86_64, i686, ARM64 | ✅ |
+| Linux | x86_64, aarch64 (glibc & musl) | ✅ |
+| FreeBSD | x86_64 | ✅ |
+| WebAssembly | wasm32-wasip1-threads | ✅ |
+
+## Installation
+
+```bash
+npm install nokhwa-node
+```
+
+## Usage
+
+```typescript
+import { Camera, CameraFormat } from 'nokhwa-node';
+
+// List available cameras
+const cameras = await Camera.list_cameras();
+console.log('Available cameras:', cameras);
+
+// Open a camera
+const camera = new Camera(0, {
+  width: 640,
+  height: 480,
+  format: 'mjpeg',
+});
+
+// Start the camera stream
+await camera.open_stream();
+
+// Capture a frame
+const frame = await camera.frame();
+console.log('Frame size:', frame.len);
+
+// Close the camera
+camera.stop();
+```
+
+## Building Locally
+
+### Prerequisites
+
+- **Rust**: Latest stable version
+- **Node.js**: >= 10 (NAPI support)
+- **Yarn**: 1.x or higher
+
+### Standard Build
+
+```bash
+# Install dependencies
+yarn install
+
+# Build for current platform
+yarn build
+
+# Run tests
+yarn test
+```
+
+### Building for WebAssembly (WASI)
+
+To build for the `wasm32-wasip1-threads` target locally, you need to install the WASI SDK and configure your build environment:
+
+```bash
+# Download and extract WASI SDK
+wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-22/wasi-sdk-22.0-linux.tar.gz
+tar xvf wasi-sdk-22.0-linux.tar.gz
+
+# Set environment variables
+export WASI_SDK_PATH="$(pwd)/wasi-sdk-22.0"
+export CC="${WASI_SDK_PATH}/bin/clang"
+export AR="${WASI_SDK_PATH}/bin/llvm-ar"
+export CFLAGS="--sysroot=${WASI_SDK_PATH}/share/wasi-sysroot"
+
+# Build for WASI target
+yarn build --platform --target wasm32-wasip1-threads
+```
+
+### Building for Specific Platforms
+
+```bash
+# Build for all supported platforms
+yarn build --platform
+
+# Build for a specific target
+yarn build --platform --target x86_64-unknown-linux-gnu
+```
+
+## CI/CD Pipeline
+
+This project uses GitHub Actions for continuous integration and automated releases. The CI pipeline builds and tests across all supported platforms:
+
+### Build Matrix
+
+- **Node.js versions**: 20, 22
+- **Platforms**: 
+  - macOS (x86_64, ARM64)
+  - Windows (x86_64, i686, ARM64)
+  - Linux (x86_64, aarch64 with glibc & musl)
+  - FreeBSD (x86_64)
+  - WebAssembly (wasm32-wasip1-threads)
+
+### WASI Build Configuration
+
+The WebAssembly build requires special handling to ensure all necessary libc headers are available. The CI workflow automatically:
+
+1. **Installs WASI SDK** - Downloads wasi-sdk-22.0 for the wasm target
+2. **Configures environment variables**:
+   - `CC`: Points to WASI SDK's clang compiler
+   - `AR`: Points to WASI SDK's llvm-ar
+   - `CFLAGS`: Sets `--sysroot` to the WASI sysroot
+3. **Builds with proper toolchain** - Ensures clang can find libc headers like `bits/libc-header-start.h`
+
+### Testing
+
+All builds are automatically tested using [AVA](https://avajs.dev/) across different Node.js versions to ensure compatibility and correctness.
+
+## Development
+
+### Running Benchmarks
+
+```bash
+# Build and run benchmarks
+yarn bench
+
+# Build in debug mode and run benchmarks
+yarn bench:debug
+```
+
+### Code Formatting
+
+```bash
+# Format all code (JavaScript, TypeScript, Rust, TOML)
+yarn format
+
+# Format individual parts
+yarn format:prettier  # JS/TS/YAML/MD/JSON
+yarn format:rs        # Rust
+yarn format:toml       # TOML
+```
+
+### Linting
+
+```bash
+# Run linter
+yarn lint
+```
+
+## Release Process
+
+The release process is automated via GitHub Actions:
+
+1. Update version using semantic versioning:
+   ```bash
+   npm version [major | minor | patch]
+   ```
+2. Push to trigger the release workflow:
+   ```bash
+   git push
+   ```
+
+The CI pipeline will:
+- Build binaries for all supported platforms
+- Run tests across all platforms and Node.js versions
+- Publish platform-specific packages to npm
+- Publish the main package with optional dependencies
+
+### Platform-Specific Packages
+
+For optimal user experience, this package publishes separate npm packages for each platform:
+
+- `@nokhwa/node-darwin-x64`
+- `@nokhwa/node-darwin-arm64`
+- `@nokhwa/node-win32-x64`
+- `@nokhwa/node-win32-ia32`
+- `@nokhwa/node-win32-arm64`
+- `@nokhwa/node-linux-x64-gnu`
+- `@nokhwa/node-linux-x64-musl`
+- `@nokhwa/node-linux-arm64-gnu`
+- `@nokhwa/node-linux-arm64-musl`
+- `@nokhwa/node-freebsd-x64`
+- `@nokhwa/node-wasm32-wasi`
+
+NPM automatically selects the correct package for the user's platform, eliminating the need for users to install build toolchains or download binaries manually.
+
+### Setup for Release
+
+Ensure you've added your `NPM_TOKEN` in GitHub repository settings:
+
+1. Go to **Settings → Secrets and variables → Actions**
+2. Add a new secret named `NPM_TOKEN` with your npm authentication token
+
+⚠️ **Important**: Do not run `npm publish` manually. Use the automated release workflow instead.
+
+## Troubleshooting
+
+### WASI Build Failures
+
+If you encounter errors like `bits/libc-header-start.h: No such file or directory` when building for WebAssembly:
+
+1. Ensure WASI SDK is properly installed
+2. Verify the `WASI_SYSROOT` environment variable is set correctly
+3. Check that `CC` and `AR` point to the WASI SDK tools
+4. Make sure `CFLAGS` includes the `--sysroot` flag
+
+Example:
+```bash
+export WASI_SYSROOT="/path/to/wasi-sdk-22.0/share/wasi-sysroot"
+export CC="/path/to/wasi-sdk-22.0/bin/clang"
+export AR="/path/to/wasi-sdk-22.0/bin/llvm-ar"
+export CFLAGS="--sysroot=$WASI_SYSROOT"
+```
+
+### Platform-Specific Issues
+
+For platform-specific build issues, ensure you have the required toolchain:
+
+- **macOS**: Xcode Command Line Tools
+- **Linux**: `gcc`, `glibc-devel` (or `musl-dev` for musl builds)
+- **Windows**: Visual Studio Build Tools or MSVC
+- **FreeBSD**: Build environment with proper development tools
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [nokhwa](https://github.com/l1npengtul/nokhwa) - The underlying Rust camera library
+- [napi-rs](https://napi.rs/) - Framework for building Node.js native modules in Rust
+- [WASI SDK](https://github.com/WebAssembly/wasi-sdk) - WebAssembly System Interface toolchain
+
+## Links
+
+- [GitHub Repository](https://github.com/nglmercer/nokhwa-node)
+- [NPM Package](https://www.npmjs.com/package/nokhwa-node)
+- [Documentation](https://github.com/nglmercer/nokhwa-node#readme)

package/browser.js

@@ -0,0 +1 @@
+export * from 'nokhwa-node-wasm32-wasi'

package/index.d.ts

@@ -0,0 +1,196 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** Camera instance for capturing frames with full nokhwa functionality */
+export declare class Camera {
+  /**
+   * Create a new camera instance with the given index
+   * The camera stream is opened immediately with automatic format detection
+   */
+  constructor(cameraIndex: string)
+  /**
+   * Capture a single frame from the camera
+   * Returns the frame as RGBA buffer with width and height
+   */
+  captureFrame(): Frame
+  /** Get the camera index */
+  index(): string
+  /** Get the backend being used */
+  backend(): ApiBackend
+  /** Get camera information */
+  info(): CameraDevice
+  /** Get the current camera format */
+  cameraFormat(): CameraFormat
+  /** Refresh and get the camera format */
+  refreshCameraFormat(): CameraFormat
+  /** Set camera format with requested configuration */
+  setCameraRequest(request: RequestedFormatConfig): CameraFormat
+  /** Get compatible camera formats */
+  compatibleCameraFormats(): Array<CameraFormat>
+  /** Get supported camera controls */
+  supportedCameraControls(): Array<KnownCameraControl>
+  /** Get all camera controls */
+  cameraControls(): Array<CameraControl>
+  /** Set a camera control value */
+  setCameraControl(control: KnownCameraControl, value: ControlValueSetter): void
+  /** Check if stream is open */
+  isStreamOpen(): boolean
+  /** Open the camera stream */
+  openStream(): void
+  /** Stop the camera stream */
+  stopStream(): void
+  /** Get raw frame data */
+  frameRaw(): CameraBuffer
+}
+
+/** Buffer struct representing raw camera frame data */
+export declare class CameraBuffer {
+  /** Create a new buffer with resolution, data, and format */
+  constructor(resolution: Resolution, data: Buffer, sourceFrameFormat: FrameFormat)
+  /** Get the resolution of the buffer */
+  resolution(): Resolution
+  /** Get the raw buffer data */
+  data(): Buffer
+  /** Get the source frame format */
+  sourceFrameFormat(): FrameFormat
+  /** Get the width of the buffer */
+  width(): number
+  /** Get the height of the buffer */
+  height(): number
+  /** Get the size of the buffer in bytes */
+  size(): number
+  /** Check if the buffer is empty */
+  isEmpty(): boolean
+}
+
+/** Get all known camera controls */
+export declare function allKnownCameraControls(): Array<KnownCameraControl>
+
+/** API backend options for camera access */
+export declare const enum ApiBackend {
+  Auto = 'Auto',
+  MediaFoundation = 'MediaFoundation',
+  AVFoundation = 'AVFoundation',
+  OpenCv = 'OpenCv',
+  Browser = 'Browser'
+}
+
+/** Convert BGR buffer to RGB */
+export declare function bufBgrToRgb(width: number, height: number, bgr: Buffer): Buffer
+
+/** Convert MJPEG buffer to RGB */
+export declare function bufMjpegToRgb(width: number, height: number, mjpeg: Buffer): Buffer
+
+/** Convert NV12 buffer to RGB */
+export declare function bufNv12ToRgb(width: number, height: number, nv12: Buffer): Buffer
+
+/** Convert YUYV422 buffer to RGB */
+export declare function bufYuyv422ToRgb(width: number, height: number, yuyv: Buffer): Buffer
+
+/** Camera control descriptor */
+export interface CameraControl {
+  name: string
+  controlType: string
+}
+
+/** Camera device information */
+export interface CameraDevice {
+  index: string
+  name: string
+}
+
+/** Camera format specification */
+export interface CameraFormat {
+  resolution: Resolution
+  frameRate: number
+  format: FrameFormat
+}
+
+/** Get all color frame formats */
+export declare function colorFrameFormats(): Array<FrameFormat>
+
+/** Control value types for setting camera properties */
+export type ControlValueSetter =
+  | { type: 'Integer', field0: number }
+  | { type: 'Float', field0: number }
+  | { type: 'Boolean', field0: boolean }
+  | { type: 'String', field0: string }
+
+/** Frame structure exported to JavaScript/TypeScript */
+export interface Frame {
+  data: Buffer
+  width: number
+  height: number
+}
+
+/** Frame format types supported by the camera */
+export declare const enum FrameFormat {
+  MJPEG = 'MJPEG',
+  YUYV = 'YUYV',
+  NV12 = 'NV12',
+  RGB = 'RGB',
+  RGBA = 'RGBA',
+  GRAY = 'GRAY'
+}
+
+/** Get all available frame formats */
+export declare function frameFormats(): Array<FrameFormat>
+
+/** Known camera control properties */
+export declare const enum KnownCameraControl {
+  Brightness = 'Brightness',
+  Contrast = 'Contrast',
+  Saturation = 'Saturation',
+  Hue = 'Hue',
+  WhiteBalance = 'WhiteBalance',
+  Gamma = 'Gamma',
+  Sharpness = 'Sharpness',
+  BacklightComp = 'BacklightComp',
+  Gain = 'Gain',
+  Pan = 'Pan',
+  Tilt = 'Tilt',
+  Zoom = 'Zoom',
+  Exposure = 'Exposure',
+  Iris = 'Iris',
+  Focus = 'Focus'
+}
+
+/** List all available cameras */
+export declare function listCameras(): Array<CameraDevice>
+
+/** Convert MJPEG to RGB (convenience function) */
+export declare function mjpegToRgb(mjpeg: Buffer, width: number, height: number): Buffer
+
+/** Get native API backend */
+export declare function nativeApiBackend(): ApiBackend | null
+
+/** Check if nokhwa is initialized */
+export declare function nokhwaCheck(): boolean
+
+/** Convert NV12 to RGB (convenience function) */
+export declare function nv12ToRgb(nv12: Buffer, width: number, height: number): Buffer
+
+/** Query available cameras with specific backend */
+export declare function query(backend: ApiBackend): Array<CameraDevice>
+
+/** Requested format configuration */
+export interface RequestedFormatConfig {
+  requestType: RequestedFormatType
+}
+
+/** Format request types for automatic format selection */
+export declare const enum RequestedFormatType {
+  AbsoluteHighestResolution = 'AbsoluteHighestResolution',
+  AbsoluteHighestFrameRate = 'AbsoluteHighestFrameRate'
+}
+
+/** Resolution dimensions */
+export interface Resolution {
+  width: number
+  height: number
+}
+
+/** Get predicted size for YUYV422 format */
+export declare function yuyv422PredictedSize(width: number, height: number): number
+
+/** Convert YUYV422 to RGB (convenience function) */
+export declare function yuyv422ToRgb(yuyv: Buffer, width: number, height: number): Buffer

package/index.js

@@ -0,0 +1,595 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./nokhwa-node.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-android-arm64')
+        const bindingPackageVersion = require('nokhwa-node-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./nokhwa-node.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-android-arm-eabi')
+        const bindingPackageVersion = require('nokhwa-node-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./nokhwa-node.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-win32-x64-gnu')
+        const bindingPackageVersion = require('nokhwa-node-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./nokhwa-node.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-win32-x64-msvc')
+        const bindingPackageVersion = require('nokhwa-node-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./nokhwa-node.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-win32-ia32-msvc')
+        const bindingPackageVersion = require('nokhwa-node-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./nokhwa-node.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-win32-arm64-msvc')
+        const bindingPackageVersion = require('nokhwa-node-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./nokhwa-node.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('nokhwa-node-darwin-universal')
+      const bindingPackageVersion = require('nokhwa-node-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./nokhwa-node.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-darwin-x64')
+        const bindingPackageVersion = require('nokhwa-node-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./nokhwa-node.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-darwin-arm64')
+        const bindingPackageVersion = require('nokhwa-node-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./nokhwa-node.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-freebsd-x64')
+        const bindingPackageVersion = require('nokhwa-node-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./nokhwa-node.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-freebsd-arm64')
+        const bindingPackageVersion = require('nokhwa-node-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./nokhwa-node.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-x64-musl')
+          const bindingPackageVersion = require('nokhwa-node-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./nokhwa-node.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-x64-gnu')
+          const bindingPackageVersion = require('nokhwa-node-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./nokhwa-node.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-arm64-musl')
+          const bindingPackageVersion = require('nokhwa-node-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./nokhwa-node.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-arm64-gnu')
+          const bindingPackageVersion = require('nokhwa-node-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./nokhwa-node.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-arm-musleabihf')
+          const bindingPackageVersion = require('nokhwa-node-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./nokhwa-node.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('nokhwa-node-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./nokhwa-node.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-loong64-musl')
+          const bindingPackageVersion = require('nokhwa-node-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./nokhwa-node.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-loong64-gnu')
+          const bindingPackageVersion = require('nokhwa-node-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./nokhwa-node.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-riscv64-musl')
+          const bindingPackageVersion = require('nokhwa-node-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./nokhwa-node.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('nokhwa-node-linux-riscv64-gnu')
+          const bindingPackageVersion = require('nokhwa-node-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./nokhwa-node.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-linux-ppc64-gnu')
+        const bindingPackageVersion = require('nokhwa-node-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./nokhwa-node.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-linux-s390x-gnu')
+        const bindingPackageVersion = require('nokhwa-node-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./nokhwa-node.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-openharmony-arm64')
+        const bindingPackageVersion = require('nokhwa-node-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./nokhwa-node.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-openharmony-x64')
+        const bindingPackageVersion = require('nokhwa-node-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./nokhwa-node.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('nokhwa-node-openharmony-arm')
+        const bindingPackageVersion = require('nokhwa-node-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./nokhwa-node.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding) {
+    try {
+      wasiBinding = require('nokhwa-node-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        wasiBindingError.cause = err
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.Camera = nativeBinding.Camera
+module.exports.CameraBuffer = nativeBinding.CameraBuffer
+module.exports.allKnownCameraControls = nativeBinding.allKnownCameraControls
+module.exports.ApiBackend = nativeBinding.ApiBackend
+module.exports.bufBgrToRgb = nativeBinding.bufBgrToRgb
+module.exports.bufMjpegToRgb = nativeBinding.bufMjpegToRgb
+module.exports.bufNv12ToRgb = nativeBinding.bufNv12ToRgb
+module.exports.bufYuyv422ToRgb = nativeBinding.bufYuyv422ToRgb
+module.exports.colorFrameFormats = nativeBinding.colorFrameFormats
+module.exports.FrameFormat = nativeBinding.FrameFormat
+module.exports.frameFormats = nativeBinding.frameFormats
+module.exports.KnownCameraControl = nativeBinding.KnownCameraControl
+module.exports.listCameras = nativeBinding.listCameras
+module.exports.mjpegToRgb = nativeBinding.mjpegToRgb
+module.exports.nativeApiBackend = nativeBinding.nativeApiBackend
+module.exports.nokhwaCheck = nativeBinding.nokhwaCheck
+module.exports.nv12ToRgb = nativeBinding.nv12ToRgb
+module.exports.query = nativeBinding.query
+module.exports.RequestedFormatType = nativeBinding.RequestedFormatType
+module.exports.yuyv422PredictedSize = nativeBinding.yuyv422PredictedSize
+module.exports.yuyv422ToRgb = nativeBinding.yuyv422ToRgb

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "nokhwa-node",
+  "version": "0.1.1",
+  "description": "Node.js bindings for nokhwa camera library using napi-rs",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/nglmercer/nokhwa-node.git"
+  },
+  "license": "MIT",
+  "browser": "browser.js",
+  "keywords": [
+    "camera",
+    "webcam",
+    "video",
+    "napi-rs",
+    "NAPI",
+    "N-API",
+    "Rust",
+    "node-addon",
+    "node-addon-api",
+    "nokhwa"
+  ],
+  "files": [
+    "index.d.ts",
+    "index.js",
+    "browser.js"
+  ],
+  "napi": {
+    "binaryName": "nokhwa-node",
+    "targets": [
+      "x86_64-pc-windows-msvc",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "aarch64-unknown-linux-gnu",
+      "i686-pc-windows-msvc",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-freebsd",
+      "aarch64-unknown-linux-musl",
+      "aarch64-pc-windows-msvc",
+      "wasm32-wasip1-threads"
+    ]
+  },
+  "engines": {
+    "node": ">= 10"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "bench": "tsx benchmark/bench.ts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "format": "run-p format:prettier format:rs format:toml",
+    "format:prettier": "prettier . -w",
+    "format:toml": "taplo format",
+    "format:rs": "cargo fmt",
+    "lint": "oxlint .",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "node test-runner.mjs",
+    "test:ava": "ava",
+    "preversion": "napi build --platform && git add .",
+    "version": "napi version",
+    "prepare": "husky",
+    "bench:debug": "napi build --platform && tsx benchmark/bench.ts"
+  },
+  "devDependencies": {
+    "@emnapi/core": "^1.5.0",
+    "@emnapi/runtime": "^1.5.0",
+    "@napi-rs/cli": "^3.2.0",
+    "@oxc-node/core": "^0.0.35",
+    "@taplo/cli": "^0.7.0",
+    "@tybys/wasm-util": "^0.10.0",
+    "@types/node": "^22.10.5",
+    "ava": "^6.4.1",
+    "chalk": "^5.6.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.6",
+    "npm-run-all2": "^8.0.4",
+    "oxlint": "^1.14.0",
+    "prettier": "^3.6.2",
+    "tinybench": "^6.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.2"
+  },
+  "lint-staged": {
+    "*.@(js|ts|tsx)": [
+      "oxlint --fix"
+    ],
+    "*.@(js|ts|tsx|yml|yaml|md|json)": [
+      "prettier --write"
+    ],
+    "*.toml": [
+      "taplo format"
+    ]
+  },
+  "ava": {
+    "extensions": {
+      "ts": "module",
+      "js": true
+    },
+    "timeout": "2m",
+    "workerThreads": false
+  },
+  "prettier": {
+    "printWidth": 120,
+    "semi": false,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "arrowParens": "always"
+  },
+  "packageManager": "yarn@4.12.0",
+  "optionalDependencies": {
+    "nokhwa-node-win32-x64-msvc": "0.1.1",
+    "nokhwa-node-darwin-x64": "0.1.1",
+    "nokhwa-node-linux-x64-gnu": "0.1.1",
+    "nokhwa-node-linux-x64-musl": "0.1.1",
+    "nokhwa-node-linux-arm64-gnu": "0.1.1",
+    "nokhwa-node-win32-ia32-msvc": "0.1.1",
+    "nokhwa-node-darwin-arm64": "0.1.1",
+    "nokhwa-node-freebsd-x64": "0.1.1",
+    "nokhwa-node-linux-arm64-musl": "0.1.1",
+    "nokhwa-node-win32-arm64-msvc": "0.1.1",
+    "nokhwa-node-wasm32-wasi": "0.1.1"
+  }
+}