@camera.ui/rust-postprocessor 0.0.3 → 0.0.4

package/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "externals/norfair-rs"]
+	path = externals/norfair-rs
+	url = https://github.com/seydx/norfair-rs

package/.vscode/settings.json

@@ -0,0 +1,104 @@
+{
+  "git.ignoreLimitWarning": true,
+  "editor.tabSize": 2,
+  "editor.insertSpaces": true,
+  "files.eol": "\n",
+  "editor.codeLens": true,
+  "editor.formatOnSave": true,
+  "js/ts.preferences.importModuleSpecifierEnding": "js",
+  "js/ts.tsdk.path": "node_modules/typescript/lib",
+  "remote.autoForwardPorts": false,
+  "eslint.debug": false,
+  "eslint.workingDirectories": [
+    {
+      "mode": "auto"
+    }
+  ],
+  "rust-analyzer.procMacro.ignored": {
+    "napi-derive": [
+      "napi"
+    ]
+  },
+  "rust-analyzer.linkedProjects": [
+    "./packages/rust-decoder/Cargo.toml",
+    "./packages/rust-detector/Cargo.toml",
+    "./packages/rust-postprocessor/Cargo.toml",
+    "./externals/norfair-rs/Cargo.toml"
+  ],
+  "python.languageServer": "Pylance",
+  "python.analysis.autoImportCompletions": true,
+  "python.analysis.typeCheckingMode": "strict",
+  "python.analysis.diagnosticSeverityOverrides": {
+    "reportMissingTypeStubs": false,
+    "reportUnknownMemberType": "warning"
+  },
+  "python-envs.terminal.autoActivationType": "shellStartup",
+  "ruff.nativeServer": true,
+  "ruff.fixAll": true,
+  "ruff.configuration": "./ruff.toml",
+  "tailwindCSS.lint.suggestCanonicalClasses": "ignore",
+  "[rust]": {
+    "editor.defaultFormatter": "rust-lang.rust-analyzer",
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit"
+    }
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit",
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit",
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit",
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "[html]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit",
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.tabSize": 4,
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "never",
+      "source.fixAll": "explicit"
+    }
+  },
+  "[go]": {
+    "editor.defaultFormatter": "golang.go",
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit",
+      "quickfix.gopls": "explicit",
+      "refactor.rewrite.gopls": "explicit"
+    }
+  },
+  "[xml]": {
+    "editor.formatOnSave": false
+  },
+  "files.associations": {
+    "*.yaml": "yaml"
+  }
+}

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2020-2026 seydx <hi@seydx.dev>
+
+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

@@ -1,5 +1,44 @@
 # @camera.ui/rust-postprocessor
 
+Native Rust detection post-processing for the [camera.ui](https://github.com/seydx/camera.ui) ecosystem — NMS, IoU, box merging, a multi-class IoU + Kalman object tracker, line-crossing events and zone filtering.
+
+Built with [napi-rs](https://napi.rs) — ships prebuilt binaries for Linux (glibc/musl), macOS, Windows and FreeBSD across x64, arm64 and riscv64, so there is no compile step on install.
+
+## Installation
+
+```bash
+npm install @camera.ui/rust-postprocessor
+```
+
+## Usage
+
+```ts
+import { nms, merge, ObjectTracker } from '@camera.ui/rust-postprocessor';
+
+// Greedy non-maximum suppression (per label), normalized [0,1] boxes
+const kept = nms(detections, 0.5);
+
+// Cluster nearby/overlapping same-label boxes into union boxes
+const merged = merge(detections, 0.5, 0.02);
+
+// Stateful multi-class tracker with stable track ids across frames
+const tracker = new ObjectTracker({ iouThreshold: 0.3, hitCounterMax: 15 });
+const { tracked, crossings } = tracker.update(detections, Date.now());
+```
+
+Also exposes `nmsIndices`, `boxIou`, and tracker configuration for crossing
+lines (`setLines`), detection zones / privacy masks (`setZones`), confidence
+thresholds and ReID. See `index.d.ts` for the full, documented API.
+
+## Development
+
+```bash
+npm install
+npm run build        # release build (napi build --platform --release)
+npm run build:debug  # debug build
+npm run lint         # cargo clippy + eslint
+```
+
 ---
 
-*Part of the camera.ui ecosystem - A comprehensive camera management solution.*
+_Part of the camera.ui ecosystem - A comprehensive camera management solution._

package/index.d.ts

@@ -1,90 +1,55 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
 /**
- * Multi-class IoU + Kalman object tracker.
- *
- * Wraps `norfair-rs` with one sub-tracker per class label. Track ids are
- * stable across frames and globally unique across classes. The tracker is
- * resolution-independent — feed normalized `[0.0, 1.0]` coordinates.
+ * Multi-class IoU + Kalman tracker (norfair-rs, one sub-tracker per label).
+ * Track ids are stable and globally unique; feed normalized coordinates.
  */
 export declare class ObjectTracker {
   constructor(options?: ObjectTrackerOptions | undefined | null)
   /**
    * Process one frame's detections and return active tracks plus any
-   * line-crossing events that fired this frame. Detections without
-   * overlap to existing tracks spawn new ones; existing tracks without a
-   * matching detection are kept alive via Kalman extrapolation until
-   * `hitCounterMax` frames have elapsed.
-   *
-   * `timestampMs` is forwarded onto emitted crossing events for sequencing
-   * — pass `Date.now()` (or any monotonic millisecond clock).
-   *
-   * `cameraMotion` is the camera ego-motion for this frame step in
-   * normalized image coordinates (typically derived from PTZ pose delta).
-   * When provided, Kalman predictions are transformed into a world-stable
-   * frame so tracks survive pans. Omit (or pass null) for fixed cameras.
+   * crossing events. `timestampMs` is forwarded onto crossing events.
+   * `cameraMotion` (optional) stabilizes Kalman predictions across pans.
    */
   update(detections: Array<Detection>, timestampMs: number, frame?: Buffer | undefined | null, frameWidth?: number | undefined | null, frameHeight?: number | undefined | null, cameraMotion?: CameraMotion | undefined | null): UpdateResult
   /**
-   * Replace the configured crossing lines. Pass an empty array to disable
-   * line crossings entirely. The `aspectRatio` is the camera's
-   * `width / height` so the perpendicular crossing line ends up visually
-   * perpendicular to the handle the user drew.
-   *
-   * Crossing memory is cleared on every reconfigure so existing tracks
-   * will fire again the moment they cross a freshly-edited line.
+   * Replace the configured crossing lines (empty array disables them).
+   * `aspectRatio` is `width / height` so the line renders perpendicular to
+   * the drawn handle. Crossing memory is cleared on every call.
    */
   setLines(lines: Array<DetectionLine>, aspectRatio: number): void
   /**
-   * Replace the configured detection zones (privacy masks + active
-   * include/exclude regions). Pass an empty array to disable zone
-   * filtering entirely. Coordinates are in `[0, 100]` UI space — the
-   * tracker normalizes them internally and auto-closes polygons.
-   *
-   * The filter runs at the start of every `update()` call before
-   * detections reach the underlying tracker.
+   * Replace the configured detection zones (empty array disables filtering).
+   * Coordinates are in `[0, 100]` UI space; normalized and auto-closed
+   * internally. Applied at the start of every `update()`.
    */
   setZones(zones: Array<DetectionZone>): void
   /**
-   * Set the minimum detection confidence threshold. Detections below
-   * this score are dropped at the start of every `update()` call before
-   * they reach the zone filter or tracker. Default 0.0 (no threshold).
+   * Drop detections below this score at the start of every `update()`,
+   * before zone filtering or tracking. Default 0.0 (no threshold).
    */
   setMinConfidence(minConfidence: number): void
   /**
-   * Set how many frames a dead track stays available for ReID re-matching.
-   * When a new detection appears near a dead track's last position,
-   * norfair merges them — the old track ID is preserved with fresh
-   * Kalman state. Pass 0 to disable ReID. Use to tie track re-ID
-   * window to an external cascade timeout (e.g. `cascadeTimeout * fps`).
+   * How many frames a dead track stays available for ReID re-matching;
+   * the old id is preserved on merge. Pass 0 to disable.
    */
   setReidHitCounterMax(frames: number): void
   /**
-   * Refresh the ReID counter for all dead tracks back to max. Call every
-   * frame while a cascade is active so dead tracks never expire during
-   * the cascade window. Stop calling when the cascade ends.
+   * Refresh the ReID counter for all dead tracks back to max. Call each
+   * frame while a cascade is active so dead tracks don't expire mid-window.
    */
   refreshReid(): void
   /**
-   * Apply the configured zones + confidence threshold to a list of
-   * detections WITHOUT advancing the tracker state. Returns the indices
-   * (positions in the input array) of the detections that pass the
-   * filter. Used for the external-sensor-write path where a plugin
-   * reports detections directly and we want to apply zone filtering
-   * without running the full tracker.
+   * Apply zones + confidence threshold without advancing tracker state,
+   * returning the surviving input indices. Used by the external-sensor-write
+   * path that needs zone filtering without running the full tracker.
    */
   filterIndices(detections: Array<Detection>): Array<number>
-  /**
-   * Drop every active track. The next `update()` starts from a clean
-   * slate and track ids restart from 1. Use this to align tracker state
-   * with external segment boundaries (e.g. cascade activate/deactivate).
-   */
+  /** Drop every active track; the next `update()` restarts ids from 1. */
   reset(): void
-  /** Total number of active tracks across all class buckets. */
   get trackCount(): number
 }
 
-/** Bounding box used by [`box_iou`]. */
 export interface BoundingBox {
   x: number
   y: number
@@ -92,22 +57,18 @@ export interface BoundingBox {
   height: number
 }
 
-/** Compute IoU between two normalized `[x, y, width, height]` boxes. */
+/** IoU between two normalized `[x, y, width, height]` boxes. */
 export declare function boxIou(a: BoundingBox, b: BoundingBox): number
 
 /**
- * Camera ego-motion vector for one frame step, in the same normalized
- * `[0.0, 1.0]` coordinate space as detections. `x` positive = camera panned
- * right; `y` positive = camera tilted down. When passed to
- * `ObjectTracker.update()`, Kalman predictions are transformed into a
- * world-stable frame so tracks survive camera pans without losing their id.
+ * Camera ego-motion for one frame step in normalized coords; when supplied
+ * to `update()`, Kalman predictions are transformed to survive pans.
  */
 export interface CameraMotion {
   x: number
   y: number
 }
 
-/** Detection in normalized image coordinates `[0.0, 1.0]`. */
 export interface Detection {
   x: number
   y: number
@@ -118,10 +79,8 @@ export interface Detection {
 }
 
 /**
- * User-facing crossing line definition.
- *
- * `points` are the two handle endpoints in `[0, 100]` UI coordinates.
- * `labels` is the set of allowed detection labels — empty means "any label".
+ * `points` are the two handle endpoints in `[0, 100]` UI coordinates;
+ * empty `labels` means "any label".
  */
 export interface DetectionLine {
   name: string
@@ -130,33 +89,22 @@ export interface DetectionLine {
   points: Array<Array<number>>
 }
 
-/**
- * User-facing detection zone definition (matches the SDK shape).
- *
- * `points` are polygon vertices in `[0, 100]` UI coordinates. The
- * polygon is auto-closed so the caller does not need to repeat the
- * first vertex at the end.
- */
+/** `points` are polygon vertices in `[0, 100]` UI coordinates; auto-closed. */
 export interface DetectionZone {
   labels: Array<string>
   filter: ZoneFilterMode
-  /**
-   * Match mode (intersect vs contain). Mapped to `type` on the JS side
-   * of the SDK — the consumer is responsible for translating that field.
-   */
+  /** Mapped to `type` on the JS side of the SDK. */
   matchType: ZoneMatchType
   isPrivacyMask: boolean
   points: Array<Array<number>>
 }
 
-/** Crossing event emitted by [`ObjectTracker::update`]. */
 export interface LineCrossingEvent {
   lineName: string
   direction: LineDirection
   trackId: number
   label: string
   confidence: number
-  /** Frame timestamp in milliseconds (forwarded from the `update()` call). */
   timestampMs: number
   prevX: number
   prevY: number
@@ -164,12 +112,6 @@ export interface LineCrossingEvent {
   currY: number
 }
 
-/**
- * Crossing line direction filter.
- *
- * `"both"` accepts either direction. `"a-to-b"` and `"b-to-a"` only fire
- * when the track moves from one specific side to the other.
- */
 export declare const enum LineDirection {
   Both = 'both',
   AToB = 'a-to-b',
@@ -177,66 +119,40 @@ export declare const enum LineDirection {
 }
 
 /**
- * Cluster nearby/overlapping same-label detections into single union
- * boxes via union-find. Two boxes join the same cluster if their
- * top-left corners are within `closeThreshold` along both axes OR if
- * their IoU exceeds `iouThreshold`. Each cluster collapses to one
- * `Detection` whose box covers the axis-aligned union of all members
- * (clamped to `[0, 1]`) and whose confidence is the maximum in the
- * cluster. Different labels are never clustered together.
+ * Cluster nearby/overlapping same-label detections into union boxes. Boxes
+ * join when their top-left corners are within `closeThreshold` on both axes
+ * or their IoU exceeds `iouThreshold`; the cluster keeps the max confidence.
  */
 export declare function merge(detections: Array<Detection>, iouThreshold: number, closeThreshold: number): Array<Detection>
 
 /**
- * Run greedy non-maximum suppression on a list of detections.
- *
- * Detections are suppressed only against higher-confidence boxes of the
- * same `label`. Output is sorted by confidence descending. Pass
- * `maxDetections` to cap the result length.
+ * Greedy NMS, suppressing only against higher-confidence boxes of the same
+ * `label`. Output sorted by confidence descending.
  */
 export declare function nms(detections: Array<Detection>, iouThreshold: number, maxDetections?: number | undefined | null): Array<Detection>
 
 /**
- * Run greedy NMS and return the **indices** (positions in the input
- * array) of the surviving detections, sorted by confidence descending.
- * Use this instead of [`nms`] when the caller needs to preserve extra
- * fields on the original detection objects (e.g. face identity, plate
- * text) that would be lost by the Detection → RustDetection round-trip.
+ * Like [`nms`] but returns the surviving input indices, so callers can keep
+ * extra fields that the Detection round-trip would drop.
  */
 export declare function nmsIndices(detections: Array<Detection>, iouThreshold: number): Array<number>
 
-/** Constructor options for [`ObjectTracker`]. */
 export interface ObjectTrackerOptions {
-  /**
-   * IoU threshold above which a candidate is matched to an existing track.
-   * Higher = stricter matching. Default 0.3.
-   */
+  /** Default 0.3. */
   iouThreshold?: number
-  /**
-   * Frames a track survives without a fresh detection (Kalman extrapolation
-   * continues during this window). Default 15.
-   */
+  /** Frames a track survives without a fresh detection. Default 15. */
   hitCounterMax?: number
-  /**
-   * Frames a new track must be matched before getting a permanent id —
-   * filters one-frame false positives. Default 3.
-   */
+  /** Frames a new track must be matched before getting a permanent id. Default 3. */
   initializationDelay?: number
-  /**
-   * Frames a dead track stays available for ReID re-matching. When a new
-   * detection appears near a dead track, norfair merges them — the old
-   * track ID is preserved. Default: disabled.
-   */
+  /** Frames a dead track stays available for ReID re-matching. Default: disabled. */
   reidHitCounterMax?: number
   /**
-   * Cosine distance threshold for appearance-based ReID matching.
-   * Lower = stricter. Only used when a frame buffer is provided to `update()`.
-   * Default: 0.4.
+   * Cosine distance threshold for appearance ReID; only used when a frame
+   * buffer is passed to `update()`. Default 0.4.
    */
   reidEmbeddingThreshold?: number
 }
 
-/** Detection with stable identity assigned by [`ObjectTracker`]. */
 export interface TrackedDetection {
   x: number
   y: number
@@ -244,56 +160,29 @@ export interface TrackedDetection {
   height: number
   confidence: number
   label: string
-  /** Stable id across frames. Resets only on `ObjectTracker::reset()`. */
   trackId: number
-  /** Number of frames this track has existed (1 on first emit). */
   trackAge: number
-  /**
-   * True when the box is being kept alive by Kalman extrapolation
-   * instead of a fresh detection match this frame.
-   */
+  /** True when the box is kept alive by Kalman extrapolation, not a fresh match. */
   trackLost: boolean
-  /**
-   * Centroid speed magnitude in normalized units per frame step, i.e.
-   * `sqrt(vx² + vy²)` of the velocity vector below. 0 when the track
-   * has only one sample so far. Consumers can compare against a
-   * threshold (typical: 0.001–0.01) to distinguish moving from
-   * stationary tracks.
-   */
+  /** `sqrt(vx² + vy²)` in normalized units per frame; 0 with only one sample. */
   trackSpeed: number
-  /**
-   * Centroid velocity X component in normalized units per frame step.
-   * Signed: positive = moving right, negative = moving left. Kalman
-   * state update happens once per `ObjectTracker::update()` call.
-   */
   trackVelocityX: number
-  /**
-   * Centroid velocity Y component in normalized units per frame step.
-   * Signed: positive = moving down, negative = moving up. Kalman
-   * state update happens once per `ObjectTracker::update()` call.
-   */
   trackVelocityY: number
 }
 
-/**
- * Result of [`ObjectTracker::update`] — active tracks plus any crossings
- * fired this frame.
- */
 export interface UpdateResult {
   tracked: Array<TrackedDetection>
   crossings: Array<LineCrossingEvent>
 }
 
-/** How an active zone affects matching detections. */
 export declare const enum ZoneFilterMode {
   Include = 'include',
   Exclude = 'exclude'
 }
 
-/** Where in the polygon the box must sit for the zone to apply. */
 export declare const enum ZoneMatchType {
   /** Any overlap with the polygon counts. */
   Intersect = 'intersect',
-  /** All four corners of the box must be inside the polygon. */
+  /** All four corners must be inside the polygon. */
   Contain = 'contain'
 }

package/index.js

@@ -3,7 +3,7 @@
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { readFileSync } = require('node:fs')
+const { readFileSync } = require('fs')
 let nativeBinding = null
 const loadErrors = []
 
@@ -33,7 +33,7 @@ const isMuslFromFilesystem = () => {
 
 const isMuslFromReport = () => {
   let report = null
-  if (typeof process.report?.getReport === 'function') {
+  if (process.report && typeof process.report.getReport === 'function') {
     process.report.excludeNetwork = true
     report = process.report.getReport()
   }
@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-android-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-android-arm-eabi')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -105,7 +105,7 @@ function requireNative() {
     }
   } 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') {
+      if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
         try {
         return require('./rust-postprocessor.win32-x64-gnu.node')
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-x64-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-x64-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-ia32-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-arm64-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@camera.ui/rust-postprocessor-darwin-universal')
       const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-darwin-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-darwin-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-freebsd-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-freebsd-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-x64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-x64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm-musleabihf')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-loong64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-loong64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-riscv64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-riscv64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-linux-ppc64-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-linux-s390x-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-arm')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.0.2' && 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.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -525,23 +525,33 @@ function requireNative() {
 
 nativeBinding = requireNative()
 
-if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
   let wasiBinding = null
   let wasiBindingError = null
   try {
     wasiBinding = require('./rust-postprocessor.wasi.cjs')
     nativeBinding = wasiBinding
   } catch (err) {
-    if (process.env.NAPI_RS_FORCE_WASI) {
+    if (forceWasi) {
       wasiBindingError = err
     }
   }
-  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  if (!nativeBinding || forceWasi) {
     try {
       wasiBinding = require('@camera.ui/rust-postprocessor-wasm32-wasi')
       nativeBinding = wasiBinding
     } catch (err) {
-      if (process.env.NAPI_RS_FORCE_WASI) {
+      if (forceWasi) {
         if (!wasiBindingError) {
           wasiBindingError = err
         } else {
@@ -560,17 +570,18 @@ if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
 
 if (!nativeBinding) {
   if (loadErrors.length > 0) {
-    throw new Error(
+    const error = 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
-        }),
-      },
     )
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = loadErrors.reduce((err, cur) => {
+      cur.cause = err
+      return cur
+    })
+    throw error
   }
   throw new Error(`Failed to load native binding`)
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@camera.ui/rust-postprocessor",
-  "version": "0.0.3",
-  "description": "camera.ui rust postprocessor",
-  "author": "seydx (https://github.com/seydx/camera.ui)",
+  "version": "0.0.4",
+  "description": "Native Rust detection post-processing (NMS, IoU, merge, object tracking, line crossing & zone filtering) for the camera.ui ecosystem",
+  "author": "seydx (https://github.com/seydx)",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "commonjs",
@@ -39,25 +39,25 @@
     "version": "napi version"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.6.2",
+    "@napi-rs/cli": "^3.7.2",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@typescript-eslint/parser": "^8.58.2",
-    "concurrently": "^9.2.1",
+    "@typescript-eslint/parser": "^8.61.1",
+    "concurrently": "^10.0.3",
     "cross-env": "^10.1.0",
     "eslint": "9.39.2",
-    "globals": "^17.5.0",
-    "prettier": "^3.8.3",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.4",
     "rimraf": "^6.1.3",
     "set-interval-async": "^3.0.3",
-    "sharp": "^0.34.5",
+    "sharp": "^0.35.1",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.58.2",
-    "updates": "^17.15.5"
+    "typescript-eslint": "^8.61.1",
+    "updates": "^17.18.0"
   },
   "bugs": {
-    "url": "https://github.com/seydx/camera.ui/issues"
+    "url": "https://github.com/cameraui/rust-postprocessor/issues"
   },
-  "homepage": "https://github.com/seydx/camera.ui#readme",
+  "homepage": "https://github.com/cameraui/rust-postprocessor#readme",
   "keywords": [
     "camera-ui",
     "postprocessing",
@@ -66,21 +66,21 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/seydx/camera.ui.git"
+    "url": "git+https://github.com/cameraui/rust-postprocessor.git"
   },
   "engines": {
     "node": ">= 10"
   },
   "optionalDependencies": {
-    "@camera.ui/rust-postprocessor-darwin-x64": "0.0.3",
-    "@camera.ui/rust-postprocessor-win32-x64-msvc": "0.0.3",
-    "@camera.ui/rust-postprocessor-linux-x64-gnu": "0.0.3",
-    "@camera.ui/rust-postprocessor-linux-x64-musl": "0.0.3",
-    "@camera.ui/rust-postprocessor-freebsd-x64": "0.0.3",
-    "@camera.ui/rust-postprocessor-darwin-arm64": "0.0.3",
-    "@camera.ui/rust-postprocessor-win32-arm64-msvc": "0.0.3",
-    "@camera.ui/rust-postprocessor-linux-arm64-gnu": "0.0.3",
-    "@camera.ui/rust-postprocessor-linux-arm64-musl": "0.0.3",
-    "@camera.ui/rust-postprocessor-linux-riscv64-gnu": "0.0.3"
+    "@camera.ui/rust-postprocessor-darwin-x64": "0.0.4",
+    "@camera.ui/rust-postprocessor-win32-x64-msvc": "0.0.4",
+    "@camera.ui/rust-postprocessor-linux-x64-gnu": "0.0.4",
+    "@camera.ui/rust-postprocessor-linux-x64-musl": "0.0.4",
+    "@camera.ui/rust-postprocessor-freebsd-x64": "0.0.4",
+    "@camera.ui/rust-postprocessor-darwin-arm64": "0.0.4",
+    "@camera.ui/rust-postprocessor-win32-arm64-msvc": "0.0.4",
+    "@camera.ui/rust-postprocessor-linux-arm64-gnu": "0.0.4",
+    "@camera.ui/rust-postprocessor-linux-arm64-musl": "0.0.4",
+    "@camera.ui/rust-postprocessor-linux-riscv64-gnu": "0.0.4"
   }
 }

package/scripts/release.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+set -euo pipefail
+
+# Bump the package version, commit it, tag it and push. The Release workflow
+# then cross-compiles every platform binary and publishes the main package plus
+# its platform packages to npm via OIDC trusted publishing (with provenance).
+#
+#   tag vX.Y.Z -> bumps package.json, triggers the Release workflow (npm)
+#
+# The platform packages under npm/* stay at 0.0.0 in git; `napi prepublish`
+# stamps them with the real version during the publish job.
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+usage() {
+  cat <<EOF
+Usage: scripts/release.sh <version|major|minor|patch> [--yes] [--skip-checks]
+
+Examples:
+  scripts/release.sh 0.0.9
+  scripts/release.sh patch
+  scripts/release.sh minor
+
+Options:
+  --yes, -y       Push without the confirmation prompt.
+  --skip-checks   Skip the local lint (the bindings rebuild always runs).
+EOF
+  exit 1
+}
+
+SPEC="${1:-}"
+YES=false
+SKIP_CHECKS=false
+for arg in "${@:2}"; do
+  case "$arg" in
+    --yes | -y) YES=true ;;
+    --skip-checks) SKIP_CHECKS=true ;;
+    *)
+      echo "Unknown option: $arg"
+      usage
+      ;;
+  esac
+done
+
+[ -z "$SPEC" ] && usage
+
+cd "$ROOT"
+
+# Safety: clean tree, on main, not behind origin.
+if [ -n "$(git status --porcelain)" ]; then
+  echo -e "${RED}Working tree not clean - commit or stash first.${NC}"
+  exit 1
+fi
+branch="$(git rev-parse --abbrev-ref HEAD)"
+if [ "$branch" != "main" ]; then
+  echo -e "${RED}Not on main (on '$branch').${NC}"
+  exit 1
+fi
+git fetch -q origin main || true
+if [ -n "$(git rev-list HEAD..origin/main 2>/dev/null)" ]; then
+  echo -e "${RED}Local main is behind origin/main - pull first.${NC}"
+  exit 1
+fi
+
+cur="$(node -p "require('./package.json').version")"
+
+bump() {
+  local IFS='.'
+  read -r ma mi pa <<<"$1"
+  case "$2" in
+    major) echo "$((ma + 1)).0.0" ;;
+    minor) echo "$ma.$((mi + 1)).0" ;;
+    patch) echo "$ma.$mi.$((pa + 1))" ;;
+  esac
+}
+
+case "$SPEC" in
+  major | minor | patch) NEW="$(bump "$cur" "$SPEC")" ;;
+  *) NEW="$SPEC" ;;
+esac
+
+if ! echo "$NEW" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+  echo -e "${RED}Invalid version '$NEW' (expected X.Y.Z).${NC}"
+  exit 1
+fi
+
+TAG="v$NEW"
+
+if git rev-parse "$TAG" >/dev/null 2>&1; then
+  echo -e "${RED}Tag $TAG already exists.${NC}"
+  exit 1
+fi
+
+echo -e "${CYAN}Releasing rust-postprocessor: $cur -> $NEW (tag $TAG)${NC}"
+
+# Bump the top-level version first (leave scripts.version = "napi version") so the
+# rebuild below regenerates index.js / index.d.ts with the new version baked in.
+node -e 'const fs=require("fs");const p=require("./package.json");p.version=process.argv[1];fs.writeFileSync("package.json",JSON.stringify(p,null,2)+"\n")' "$NEW"
+
+if [ "$SKIP_CHECKS" = false ]; then
+  echo -e "${YELLOW}Running lint...${NC}"
+  npm run lint
+fi
+
+# Always rebuild so the committed (and published) bindings match the new version.
+echo -e "${YELLOW}Regenerating native bindings...${NC}"
+npm run build:debug
+
+git add package.json index.js index.d.ts
+
+git commit -q -m "release: v$NEW"
+echo -e "${GREEN}Committed version bump.${NC}"
+
+git tag "$TAG"
+echo -e "${GREEN}Created tag $TAG.${NC}"
+
+if [ "$YES" = false ]; then
+  printf "Push main + %s and trigger the release? [y/N] " "$TAG"
+  read -r ans
+  case "$ans" in
+    y | Y | yes) ;;
+    *)
+      git tag -d "$TAG" >/dev/null
+      git reset -q --hard HEAD~1
+      echo "Aborted - tag and bump commit were undone locally."
+      exit 0
+      ;;
+  esac
+fi
+
+git push -q origin main
+git push -q origin "$TAG"
+echo -e "${GREEN}Pushed. Watch the release workflow under the repo's Actions tab.${NC}"

package/CHANGELOG.md

@@ -1,8 +0,0 @@
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [X.X.X] - ???
-
-- Initial Release

package/CONTRIBUTING.md

@@ -1 +0,0 @@
-# Contributing