@napi-rs/webcodecs 1.3.1 → 1.4.0

package/README.md

@@ -168,6 +168,11 @@ result.image.close()
 decoder.close()
 ```
 
+When `data` is a `ReadableStream`, `ImageDecoder` accumulates every chunk so it
+can re-probe the growing input. This buffer currently has no fixed limit, so
+applications should bound or reject unexpectedly large streams before passing
+them to the decoder.
+
 ### Container Demuxing
 
 Read encoded video/audio from MP4, WebM, or MKV containers:
@@ -283,6 +288,7 @@ import { Mp4Muxer } from '@napi-rs/webcodecs'
 
 const muxer = new Mp4Muxer({
   fragmented: true, // Required for MP4 streaming
+  // Maximum bytes returned by each read(); this is not a memory limit.
   streaming: { bufferCapacity: 256 * 1024 },
 })
 
@@ -303,6 +309,12 @@ if (muxer.isFinished) {
 }
 ```
 
+Streaming writes are queued in a growable native buffer so `addVideoChunk()`
+and `addAudioChunk()` never wait for JavaScript to call `read()`. Applications
+must drain `read()` regularly; an indefinitely stalled consumer can retain the
+entire muxed output in memory. `bufferCapacity` controls only the maximum size
+of each returned read chunk.
+
 ### VideoFrame from Canvas
 
 Create VideoFrames from `@napi-rs/canvas` for graphics, text rendering, or image compositing:
@@ -683,6 +695,11 @@ For full API documentation, see the [W3C WebCodecs specification](https://w3c.gi
 - Node.js 18+
 - pnpm
 
+The build downloads the pinned FFmpeg 9.0 release by default. If you opt out
+of that download or set `FFMPEG_DIR`, the supplied FFmpeg headers and libraries
+must be from FFmpeg 9.x; FFmpeg 8.x system/Homebrew installations are rejected
+by the ABI guard.
+
 ### Build
 
 ```bash

package/index.d.ts

@@ -111,32 +111,6 @@ export interface MuxerAudioTrackConfig {
   description?: Uint8Array
 }
 
-/** Init options for Mp4Muxer */
-export interface Mp4MuxerInit {
-  /** Move moov atom to beginning (not compatible with streaming) */
-  fastStart?: boolean
-  /** Use fragmented MP4 for streaming */
-  fragmented?: boolean
-  /** Enable streaming output mode */
-  streaming?: { bufferCapacity?: number }
-}
-
-/** Init options for WebMMuxer */
-export interface WebMMuxerInit {
-  /** Enable live streaming mode */
-  live?: boolean
-  /** Enable streaming output mode */
-  streaming?: { bufferCapacity?: number }
-}
-
-/** Init options for MkvMuxer */
-export interface MkvMuxerInit {
-  /** Enable live streaming mode */
-  live?: boolean
-  /** Enable streaming output mode */
-  streaming?: { bufferCapacity?: number }
-}
-
 // ============================================================================
 // Async Iterator Types
 // ============================================================================
@@ -539,7 +513,8 @@ export declare class EncodedVideoChunk {
 export declare class ImageDecoder {
   /**
    * Create a new ImageDecoder
-   * Supports both Uint8Array and ReadableStream as data source per W3C spec
+   * Supports both Uint8Array and ReadableStream as data source per W3C spec.
+   * ReadableStream input is buffered without a fixed size limit.
    */
   constructor(init: ImageDecoderInit)
   /** Whether the data is fully buffered */
@@ -1272,9 +1247,9 @@ export declare class WebMMuxer {
 
 /** AAC bitstream format (W3C WebCodecs AAC Registration) */
 export type AacBitstreamFormat = /** Raw AAC frames - metadata in description */
-  | 'aac'
-  /** ADTS frames - metadata in each frame */
-  | 'adts'
+| 'aac'
+/** ADTS frames - metadata in each frame */
+| 'adts'
 
 /** AAC encoder configuration (W3C WebCodecs AAC Registration) */
 export interface AacEncoderConfig {
@@ -1294,9 +1269,9 @@ export interface AddEventListenerOptions {
  * Default is "discard" per spec
  */
 export type AlphaOption = /** Keep alpha channel if present */
-  | 'keep'
-  /** Discard alpha channel (default per W3C spec) */
-  | 'discard'
+| 'keep'
+/** Discard alpha channel (default per W3C spec) */
+| 'discard'
 
 /** Options for copyTo operation */
 export interface AudioDataCopyToOptions {
@@ -1379,27 +1354,27 @@ export interface AudioEncoderSupport {
 
 /** Audio sample format (WebCodecs spec) */
 export type AudioSampleFormat = /** Unsigned 8-bit integer samples| interleaved */
-  | 'u8'
-  /** Signed 16-bit integer samples| interleaved */
-  | 's16'
-  /** Signed 32-bit integer samples| interleaved */
-  | 's32'
-  /** 32-bit float samples| interleaved */
-  | 'f32'
-  /** Unsigned 8-bit integer samples| planar */
-  | 'u8-planar'
-  /** Signed 16-bit integer samples| planar */
-  | 's16-planar'
-  /** Signed 32-bit integer samples| planar */
-  | 's32-planar'
-  /** 32-bit float samples| planar */
-  | 'f32-planar'
+| 'u8'
+/** Signed 16-bit integer samples| interleaved */
+| 's16'
+/** Signed 32-bit integer samples| interleaved */
+| 's32'
+/** 32-bit float samples| interleaved */
+| 'f32'
+/** Unsigned 8-bit integer samples| planar */
+| 'u8-planar'
+/** Signed 16-bit integer samples| planar */
+| 's16-planar'
+/** Signed 32-bit integer samples| planar */
+| 's32-planar'
+/** 32-bit float samples| planar */
+| 'f32-planar'
 
 /** AVC (H.264) bitstream format (W3C WebCodecs AVC Registration) */
 export type AvcBitstreamFormat = /** AVC format with parameter sets in description (ISO 14496-15) */
-  | 'avc'
-  /** Annex B format with parameter sets in bitstream */
-  | 'annexb'
+| 'avc'
+/** Annex B format with parameter sets in bitstream */
+| 'annexb'
 
 /** AVC (H.264) encoder configuration (W3C WebCodecs AVC Registration) */
 export interface AvcEncoderConfig {
@@ -1409,23 +1384,23 @@ export interface AvcEncoderConfig {
 
 /** Bitrate mode for audio encoding (W3C WebCodecs spec) */
 export type BitrateMode = /** Variable bitrate (default) */
-  | 'variable'
-  /** Constant bitrate */
-  | 'constant'
+| 'variable'
+/** Constant bitrate */
+| 'constant'
 
 /** Encoder state per WebCodecs spec */
 export type CodecState = /** Encoder not configured */
-  | 'unconfigured'
-  /** Encoder configured and ready */
-  | 'configured'
-  /** Encoder closed */
-  | 'closed'
+| 'unconfigured'
+/** Encoder configured and ready */
+| 'configured'
+/** Encoder closed */
+| 'closed'
 
 /** ColorSpaceConversion for ImageDecoder (W3C WebCodecs spec) */
 export type ColorSpaceConversion = /** Apply default color space conversion (spec default) */
-  | 'default'
-  /** No color space conversion */
-  | 'none'
+| 'default'
+/** No color space conversion */
+| 'none'
 
 /** Audio decoder configuration exposed to JavaScript */
 export interface DemuxerAudioDecoderConfig {
@@ -1493,9 +1468,9 @@ export interface EncodedAudioChunkMetadataJs {
 
 /** Type of encoded audio chunk */
 export type EncodedAudioChunkType = /** Key chunk - can be decoded independently */
-  | 'key'
-  /** Delta chunk - depends on previous chunks */
-  | 'delta'
+| 'key'
+/** Delta chunk - depends on previous chunks */
+| 'delta'
 
 /** Output callback metadata per WebCodecs spec */
 export interface EncodedVideoChunkMetadata {
@@ -1523,9 +1498,9 @@ export interface EncodedVideoChunkMetadataJs {
 
 /** Type of encoded video chunk */
 export type EncodedVideoChunkType = /** Keyframe - can be decoded independently */
-  | 'key'
-  /** Delta frame - depends on previous frames */
-  | 'delta'
+| 'key'
+/** Delta frame - depends on previous frames */
+| 'delta'
 
 /** Options for removeEventListener (W3C DOM spec) */
 export interface EventListenerOptions {
@@ -1551,11 +1526,11 @@ export declare function getPreferredHardwareAccelerator(): string | null
 
 /** Hardware acceleration preference (W3C WebCodecs spec) */
 export type HardwareAcceleration = /** No preference - may use hardware or software */
-  | 'no-preference'
-  /** Prefer hardware acceleration */
-  | 'prefer-hardware'
-  /** Prefer software implementation */
-  | 'prefer-software'
+| 'no-preference'
+/** Prefer hardware acceleration */
+| 'prefer-hardware'
+/** Prefer software implementation */
+| 'prefer-software'
 
 /** Hardware accelerator information */
 export interface HardwareAccelerator {
@@ -1569,9 +1544,9 @@ export interface HardwareAccelerator {
 
 /** HEVC (H.265) bitstream format (W3C WebCodecs HEVC Registration) */
 export type HevcBitstreamFormat = /** HEVC format with parameter sets in description (ISO 14496-15) */
-  | 'hevc'
-  /** Annex B format with parameter sets in bitstream */
-  | 'annexb'
+| 'hevc'
+/** Annex B format with parameter sets in bitstream */
+| 'annexb'
 
 /** HEVC (H.265) encoder configuration (W3C WebCodecs HEVC Registration) */
 export interface HevcEncoderConfig {
@@ -1592,9 +1567,9 @@ export declare function isHardwareAcceleratorAvailable(name: string): boolean
 
 /** Latency mode for video encoding (W3C WebCodecs spec) */
 export type LatencyMode = /** Optimize for quality (default) */
-  | 'quality'
-  /** Optimize for low latency */
-  | 'realtime'
+| 'quality'
+/** Optimize for low latency */
+| 'realtime'
 
 /** Audio track configuration for MKV muxer */
 export interface MkvAudioTrackConfig {
@@ -1674,17 +1649,17 @@ export interface Mp4VideoTrackConfig {
 
 /** Opus application mode (W3C WebCodecs Opus Registration) */
 export type OpusApplication = /** Optimize for VoIP (speech intelligibility) */
-  | 'voip'
-  /** Optimize for audio fidelity (default) */
-  | 'audio'
-  /** Minimize coding delay */
-  | 'lowdelay'
+| 'voip'
+/** Optimize for audio fidelity (default) */
+| 'audio'
+/** Minimize coding delay */
+| 'lowdelay'
 
 /** Opus bitstream format (W3C WebCodecs Opus Registration) */
 export type OpusBitstreamFormat = /** Opus packets (RFC 6716) - no metadata needed for decoding */
-  | 'opus'
-  /** Ogg encapsulation (RFC 7845) - metadata in description */
-  | 'ogg'
+| 'opus'
+/** Ogg encapsulation (RFC 7845) - metadata in description */
+| 'ogg'
 
 /** Opus encoder configuration (W3C WebCodecs Opus Registration) */
 export interface OpusEncoderConfig {
@@ -1711,11 +1686,11 @@ export interface OpusEncoderConfig {
 
 /** Opus signal type hint (W3C WebCodecs Opus Registration) */
 export type OpusSignal = /** Auto-detect signal type */
-  | 'auto'
-  /** Music signal */
-  | 'music'
-  /** Voice/speech signal */
-  | 'voice'
+| 'auto'
+/** Music signal */
+| 'music'
+/** Voice/speech signal */
+| 'voice'
 
 /** Layout information for a single plane per WebCodecs spec */
 export interface PlaneLayout {
@@ -1738,7 +1713,10 @@ export declare function resetHardwareFallbackState(): void
 
 /** Streaming mode options for muxers */
 export interface StreamingMuxerOptions {
-  /** Buffer capacity for streaming output (default: 256KB) */
+  /**
+   * Maximum bytes returned by each streaming read (default: 256KB).
+   * Muxer writes are queued without blocking the JavaScript consumer.
+   */
   bufferCapacity?: number
 }
 
@@ -1756,15 +1734,15 @@ export interface SvcOutputMetadataJs {
 
 /** Video color primaries (W3C WebCodecs spec) */
 export type VideoColorPrimaries = /** BT.709 / sRGB primaries */
-  | 'bt709'
-  /** BT.470 BG (PAL) */
-  | 'bt470bg'
-  /** SMPTE 170M (NTSC) */
-  | 'smpte170m'
-  /** BT.2020 (UHD) */
-  | 'bt2020'
-  /** SMPTE 432 (DCI-P3) */
-  | 'smpte432'
+| 'bt709'
+/** BT.470 BG (PAL) */
+| 'bt470bg'
+/** SMPTE 170M (NTSC) */
+| 'smpte170m'
+/** BT.2020 (UHD) */
+| 'bt2020'
+/** SMPTE 432 (DCI-P3) */
+| 'smpte432'
 
 /** Options for addEventListener (W3C DOM spec) */
 export interface VideoDecoderAddEventListenerOptions {
@@ -1822,11 +1800,11 @@ export interface VideoDecoderSupport {
 
 /** Bitrate mode for video encoding (W3C WebCodecs spec) */
 export type VideoEncoderBitrateMode = /** Variable bitrate (default) */
-  | 'variable'
-  /** Constant bitrate */
-  | 'constant'
-  /** Use quantizer parameter from codec-specific options */
-  | 'quantizer'
+| 'variable'
+/** Constant bitrate */
+| 'constant'
+/** Use quantizer parameter from codec-specific options */
+| 'quantizer'
 
 /** Encode options per WebCodecs spec */
 export interface VideoEncoderEncodeOptions {
@@ -1922,75 +1900,75 @@ export interface VideoFrameRect {
 
 /** Video matrix coefficients (W3C WebCodecs spec) */
 export type VideoMatrixCoefficients = /** RGB (identity matrix) */
-  | 'rgb'
-  /** BT.709 */
-  | 'bt709'
-  /** BT.470 BG */
-  | 'bt470bg'
-  /** SMPTE 170M */
-  | 'smpte170m'
-  /** BT.2020 non-constant luminance */
-  | 'bt2020-ncl'
+| 'rgb'
+/** BT.709 */
+| 'bt709'
+/** BT.470 BG */
+| 'bt470bg'
+/** SMPTE 170M */
+| 'smpte170m'
+/** BT.2020 non-constant luminance */
+| 'bt2020-ncl'
 
 /** Video pixel format (WebCodecs spec) */
 export type VideoPixelFormat = /** Planar YUV 4:2:0| 12bpp| (1 Cr & Cb sample per 2x2 Y samples) */
-  | 'I420'
-  /** Planar YUV 4:2:0| 12bpp| with alpha plane */
-  | 'I420A'
-  /** Planar YUV 4:2:2| 16bpp */
-  | 'I422'
-  /** Planar YUV 4:2:2| 16bpp| with alpha plane */
-  | 'I422A'
-  /** Planar YUV 4:4:4| 24bpp */
-  | 'I444'
-  /** Planar YUV 4:4:4| 24bpp| with alpha plane */
-  | 'I444A'
-  /** Planar YUV 4:2:0| 10-bit */
-  | 'I420P10'
-  /** Planar YUV 4:2:0| 10-bit| with alpha plane */
-  | 'I420AP10'
-  /** Planar YUV 4:2:2| 10-bit */
-  | 'I422P10'
-  /** Planar YUV 4:2:2| 10-bit| with alpha plane */
-  | 'I422AP10'
-  /** Planar YUV 4:4:4| 10-bit */
-  | 'I444P10'
-  /** Planar YUV 4:4:4| 10-bit| with alpha plane */
-  | 'I444AP10'
-  /** Planar YUV 4:2:0| 12-bit */
-  | 'I420P12'
-  /** Planar YUV 4:2:2| 12-bit */
-  | 'I422P12'
-  /** Planar YUV 4:4:4| 12-bit */
-  | 'I444P12'
-  /** Semi-planar YUV 4:2:0| 12bpp (Y plane + interleaved UV) */
-  | 'NV12'
-  /** Semi-planar YUV 4:2:0| 12bpp (Y plane + interleaved VU) - per W3C WebCodecs spec */
-  | 'NV21'
-  /** RGBA 32bpp */
-  | 'RGBA'
-  /** RGBX 32bpp (alpha ignored) */
-  | 'RGBX'
-  /** BGRA 32bpp */
-  | 'BGRA'
-  /** BGRX 32bpp (alpha ignored) */
-  | 'BGRX'
+| 'I420'
+/** Planar YUV 4:2:0| 12bpp| with alpha plane */
+| 'I420A'
+/** Planar YUV 4:2:2| 16bpp */
+| 'I422'
+/** Planar YUV 4:2:2| 16bpp| with alpha plane */
+| 'I422A'
+/** Planar YUV 4:4:4| 24bpp */
+| 'I444'
+/** Planar YUV 4:4:4| 24bpp| with alpha plane */
+| 'I444A'
+/** Planar YUV 4:2:0| 10-bit */
+| 'I420P10'
+/** Planar YUV 4:2:0| 10-bit| with alpha plane */
+| 'I420AP10'
+/** Planar YUV 4:2:2| 10-bit */
+| 'I422P10'
+/** Planar YUV 4:2:2| 10-bit| with alpha plane */
+| 'I422AP10'
+/** Planar YUV 4:4:4| 10-bit */
+| 'I444P10'
+/** Planar YUV 4:4:4| 10-bit| with alpha plane */
+| 'I444AP10'
+/** Planar YUV 4:2:0| 12-bit */
+| 'I420P12'
+/** Planar YUV 4:2:2| 12-bit */
+| 'I422P12'
+/** Planar YUV 4:4:4| 12-bit */
+| 'I444P12'
+/** Semi-planar YUV 4:2:0| 12bpp (Y plane + interleaved UV) */
+| 'NV12'
+/** Semi-planar YUV 4:2:0| 12bpp (Y plane + interleaved VU) - per W3C WebCodecs spec */
+| 'NV21'
+/** RGBA 32bpp */
+| 'RGBA'
+/** RGBX 32bpp (alpha ignored) */
+| 'RGBX'
+/** BGRA 32bpp */
+| 'BGRA'
+/** BGRX 32bpp (alpha ignored) */
+| 'BGRX'
 
 /** Video transfer characteristics (W3C WebCodecs spec) */
 export type VideoTransferCharacteristics = /** BT.709 transfer */
-  | 'bt709'
-  /** SMPTE 170M transfer */
-  | 'smpte170m'
-  /** IEC 61966-2-1 (sRGB) - technical name */
-  | 'iec61966-2-1'
-  /** sRGB transfer (alias for iec61966-2-1) */
-  | 'srgb'
-  /** Linear transfer */
-  | 'linear'
-  /** Perceptual Quantizer (HDR) */
-  | 'pq'
-  /** Hybrid Log-Gamma (HDR) */
-  | 'hlg'
+| 'bt709'
+/** SMPTE 170M transfer */
+| 'smpte170m'
+/** IEC 61966-2-1 (sRGB) - technical name */
+| 'iec61966-2-1'
+/** sRGB transfer (alias for iec61966-2-1) */
+| 'srgb'
+/** Linear transfer */
+| 'linear'
+/** Perceptual Quantizer (HDR) */
+| 'pq'
+/** Hybrid Log-Gamma (HDR) */
+| 'hlg'
 
 /** Audio track configuration for WebM muxer */
 export interface WebMAudioTrackConfig {

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()
   }
@@ -78,12 +78,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-android-arm64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-android-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -100,12 +100,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-android-arm-eabi')
         const bindingPackageVersion = require('@napi-rs/webcodecs-android-arm-eabi/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -118,8 +118,8 @@ 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'
+        (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('./webcodecs.win32-x64-gnu.node')
@@ -130,12 +130,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-win32-x64-gnu')
           const bindingPackageVersion = require('@napi-rs/webcodecs-win32-x64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -152,12 +152,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-win32-x64-msvc')
           const bindingPackageVersion = require('@napi-rs/webcodecs-win32-x64-msvc/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -175,12 +175,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-win32-ia32-msvc')
         const bindingPackageVersion = require('@napi-rs/webcodecs-win32-ia32-msvc/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -197,12 +197,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-win32-arm64-msvc')
         const bindingPackageVersion = require('@napi-rs/webcodecs-win32-arm64-msvc/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -222,12 +222,12 @@ function requireNative() {
       const binding = require('@napi-rs/webcodecs-darwin-universal')
       const bindingPackageVersion = require('@napi-rs/webcodecs-darwin-universal/package.json').version
       if (
-        bindingPackageVersion !== '1.3.1' &&
+        bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
         )
       }
       return binding
@@ -244,12 +244,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-darwin-x64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-darwin-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -266,12 +266,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-darwin-arm64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-darwin-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -292,12 +292,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-freebsd-x64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-freebsd-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -314,12 +314,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-freebsd-arm64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-freebsd-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -341,12 +341,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-x64-musl')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-x64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -363,12 +363,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-x64-gnu')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-x64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -387,12 +387,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-arm64-musl')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-arm64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -409,12 +409,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-arm64-gnu')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-arm64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -433,12 +433,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-arm-musleabihf')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-arm-musleabihf/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -455,12 +455,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-arm-gnueabihf/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -479,12 +479,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-loong64-musl')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-loong64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -501,12 +501,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-loong64-gnu')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-loong64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -525,12 +525,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-riscv64-musl')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-riscv64-musl/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -547,12 +547,12 @@ function requireNative() {
           const binding = require('@napi-rs/webcodecs-linux-riscv64-gnu')
           const bindingPackageVersion = require('@napi-rs/webcodecs-linux-riscv64-gnu/package.json').version
           if (
-            bindingPackageVersion !== '1.3.1' &&
+            bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -570,12 +570,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-linux-ppc64-gnu')
         const bindingPackageVersion = require('@napi-rs/webcodecs-linux-ppc64-gnu/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -592,12 +592,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-linux-s390x-gnu')
         const bindingPackageVersion = require('@napi-rs/webcodecs-linux-s390x-gnu/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -618,12 +618,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-openharmony-arm64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-openharmony-arm64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -640,12 +640,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-openharmony-x64')
         const bindingPackageVersion = require('@napi-rs/webcodecs-openharmony-x64/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -662,12 +662,12 @@ function requireNative() {
         const binding = require('@napi-rs/webcodecs-openharmony-arm')
         const bindingPackageVersion = require('@napi-rs/webcodecs-openharmony-arm/package.json').version
         if (
-          bindingPackageVersion !== '1.3.1' &&
+          bindingPackageVersion !== '1.4.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 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -682,54 +682,165 @@ function requireNative() {
   }
 }
 
-nativeBinding = requireNative()
+function createLoadErrorChain(errors) {
+  return errors.reduce((previous, current) => {
+    let message
+    try {
+      message = current && typeof current.message === 'string' ? current.message : String(current)
+    } catch {
+      message = 'Unknown error'
+    }
+    const error = new Error(message)
+    error.cause = previous
+    return error
+  }, null)
+}
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → prefer WASI, but retain native as a lazy fallback
+//   'error'                  → require WASI without initializing a native fallback
+// 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.
+//
+// NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
+// WASI loading. It never crosses into another flavor or falls back to native.
+const __napiWasiFlavors = ['wasm32-wasi']
+const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
+const __napiWasiFlavorRequested = typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
+if (__napiWasiFlavorRequested && __napiWasiFlavors.indexOf(__napiWasiFlavor) === -1) {
+  throw new Error(
+    'Unsupported WASI flavor "' + __napiWasiFlavor + '". Available flavors: ' + __napiWasiFlavors.join(', '),
+  )
+}
+const forceWasiError = process.env.NAPI_RS_FORCE_WASI === 'error'
+const forceWasi = process.env.NAPI_RS_FORCE_WASI === 'true' || forceWasiError || __napiWasiFlavorRequested
 
-if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+if (!forceWasi) {
+  nativeBinding = requireNative()
+}
+
+if (!nativeBinding || forceWasi) {
   let wasiBinding = null
-  let wasiBindingError = null
-  try {
-    wasiBinding = require('./webcodecs.wasi.cjs')
-    nativeBinding = wasiBinding
-  } catch (err) {
-    if (process.env.NAPI_RS_FORCE_WASI) {
-      wasiBindingError = err
+  let wasiBindingLoaded = false
+  const wasiBindingErrors = []
+  const __napiWasiResolveCandidate = (specifier, isPackage, localArtifacts) => {
+    try {
+      require.resolve(specifier)
+    } catch (resolveError) {
+      if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+        throw resolveError
+      }
+      if (isPackage) {
+        try {
+          require.resolve(specifier + '/package.json')
+        } catch (packageError) {
+          if (packageError && packageError.code === 'MODULE_NOT_FOUND') {
+            return resolveError
+          }
+          // An exports restriction proves the package exists even when its
+          // package.json is not public. Preserve the root resolution failure.
+          throw resolveError
+        }
+        // The package exists but its main/export target is broken.
+        throw resolveError
+      }
+      return resolveError
     }
+    if (localArtifacts) {
+      let artifactError = null
+      for (let i = 0; i < localArtifacts.length; i++) {
+        try {
+          require.resolve(localArtifacts[i])
+          return null
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+            throw resolveError
+          }
+          artifactError = resolveError
+        }
+      }
+      return artifactError
+    }
+    return null
   }
-  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
+    let candidateError = null
+    let candidateFailed = false
     try {
-      wasiBinding = require('@napi-rs/webcodecs-wasm32-wasi')
-      nativeBinding = wasiBinding
+      candidateError = __napiWasiResolveCandidate('./webcodecs.wasi.cjs', false, [
+        './webcodecs.wasm32-wasi.debug.wasm',
+        './webcodecs.wasm32-wasi.wasm',
+      ])
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        wasiBinding = require('./webcodecs.wasi.cjs')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
+      }
     } catch (err) {
-      if (process.env.NAPI_RS_FORCE_WASI) {
-        if (!wasiBindingError) {
-          wasiBindingError = err
-        } else {
-          wasiBindingError.cause = err
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
+    let candidateError = null
+    let candidateFailed = false
+    try {
+      candidateError = __napiWasiResolveCandidate('@napi-rs/webcodecs-wasm32-wasi', true, undefined)
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          const bindingPackageVersion = require('@napi-rs/webcodecs-wasm32-wasi/package.json').version
+          if (bindingPackageVersion !== '1.4.0') {
+            throw new Error(
+              `WASI binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            )
+          }
         }
-        loadErrors.push(err)
+        wasiBinding = require('@napi-rs/webcodecs-wasm32-wasi')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
       }
+    } catch (err) {
+      candidateError = err
+      candidateFailed = true
     }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (!wasiBindingLoaded && forceWasi && !forceWasiError && !__napiWasiFlavorRequested) {
+    nativeBinding = requireNative()
   }
-  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
+  if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
+    const error = new Error(
+      __napiWasiFlavorRequested
+        ? 'WASI binding for flavor "' + __napiWasiFlavor + '" not found'
+        : 'WASI binding not found and NAPI_RS_FORCE_WASI is set to error',
+    )
+    error.cause = createLoadErrorChain(wasiBindingErrors)
     throw error
   }
 }
 
 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 = createLoadErrorChain(loadErrors)
+    throw error
   }
   throw new Error(`Failed to load native binding`)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/webcodecs",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "WebCodecs API implementation for Node.js using FFmpeg",
   "keywords": [
     "N-API",
@@ -32,7 +32,6 @@
       "require": "./polyfill.js"
     }
   },
-  "browser": "browser.js",
   "types": "index.d.ts",
   "files": [
     "index.d.ts",
@@ -53,7 +52,7 @@
     "prepublishOnly": "napi prepublish -t npm",
     "test": "ava",
     "demo": "cd example && vite",
-    "typecheck": "tsc -b tsconfig.json && tsc ./index.d.ts",
+    "typecheck": "tsc -b tsconfig.json && tsc --ignoreConfig ./index.d.ts",
     "preversion": "oxnode ./build.ts --platform && git add .",
     "version": "napi version"
   },
@@ -63,31 +62,31 @@
     ]
   },
   "devDependencies": {
-    "@emnapi/core": "^1.8.1",
-    "@emnapi/runtime": "^1.8.1",
-    "@napi-rs/canvas": "^0.1.88",
-    "@napi-rs/cli": "^3.5.1",
-    "@napi-rs/wasm-runtime": "^1.1.1",
-    "@oxc-node/cli": "^0.0.35",
-    "@oxc-node/core": "^0.0.35",
+    "@emnapi/core": "^1.11.3",
+    "@emnapi/runtime": "^1.11.3",
+    "@napi-rs/canvas": "^1.0.5",
+    "@napi-rs/cli": "^3.8.4",
+    "@napi-rs/wasm-runtime": "^1.2.2",
+    "@oxc-node/cli": "^0.1.0",
+    "@oxc-node/core": "^0.1.0",
     "@taplo/cli": "^0.7.0",
-    "@tybys/wasm-util": "^0.10.1",
-    "@types/node": "^25.0.10",
-    "ava": "^6.4.1",
-    "chalk": "^5.6.2",
-    "emnapi": "^1.8.1",
+    "@tybys/wasm-util": "^0.10.3",
+    "@types/node": "^26.2.0",
+    "ava": "^8.0.1",
+    "chalk": "^6.0.0",
+    "emnapi": "^1.11.3",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "mediabunny": "1.30.1",
-    "npm-run-all2": "^8.0.4",
-    "oxfmt": "^0.26.0",
-    "oxlint": "^1.41.0",
-    "oxlint-tsgolint": "^0.11.1",
-    "prettier": "^3.8.1",
-    "tinybench": "^6.0.0",
-    "typescript": "^5.9.3",
+    "lint-staged": "^17.3.0",
+    "mediabunny": "1.53.0",
+    "npm-run-all2": "^9.0.3",
+    "oxfmt": "^0.62.0",
+    "oxlint": "^1.77.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "prettier": "^3.9.6",
+    "tinybench": "^6.1.2",
+    "typescript": "^7.0.2",
     "webcodecs-polyfill": "^1.0.1",
-    "vite-plugin-mkcert": "^1.17.9"
+    "vite-plugin-mkcert": "^2.1.0"
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.0"
@@ -113,14 +112,14 @@
       "armv7-unknown-linux-gnueabihf"
     ]
   },
-  "packageManager": "pnpm@10.28.1",
+  "packageManager": "pnpm@11.21.0",
   "ava": {
     "environmentVariables": {
       "TS_NODE_PROJECT": "./tsconfig.json"
     },
-    "extensions": {
-      "ts": "module"
-    },
+    "extensions": [
+      "ts"
+    ],
     "files": [
       "__test__/**/*.spec.ts"
     ],
@@ -132,34 +131,21 @@
     "workerThreads": false
   },
   "engines": {
-    "node": ">= 10"
+    "node": "^22.20 || ^24.12 || >=25"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "node-av",
-      "@seydx/node-av-darwin-arm64",
-      "@seydx/node-av-darwin-x64",
-      "@seydx/node-av-linux-arm64",
-      "@seydx/node-av-linux-x64",
-      "@seydx/node-av-win32-arm64-mingw",
-      "@seydx/node-av-win32-arm64-msvc",
-      "@seydx/node-av-win32-x64-mingw",
-      "@seydx/node-av-win32-x64-msvc"
-    ]
-  },
   "optionalDependencies": {
-    "@napi-rs/webcodecs-darwin-x64": "1.3.1",
-    "@napi-rs/webcodecs-darwin-arm64": "1.3.1",
-    "@napi-rs/webcodecs-linux-x64-gnu": "1.3.1",
-    "@napi-rs/webcodecs-linux-x64-musl": "1.3.1",
-    "@napi-rs/webcodecs-win32-x64-msvc": "1.3.1",
-    "@napi-rs/webcodecs-linux-arm64-gnu": "1.3.1",
-    "@napi-rs/webcodecs-linux-arm64-musl": "1.3.1",
-    "@napi-rs/webcodecs-win32-arm64-msvc": "1.3.1",
-    "@napi-rs/webcodecs-linux-arm-gnueabihf": "1.3.1"
+    "@napi-rs/webcodecs-darwin-x64": "1.4.0",
+    "@napi-rs/webcodecs-darwin-arm64": "1.4.0",
+    "@napi-rs/webcodecs-linux-x64-gnu": "1.4.0",
+    "@napi-rs/webcodecs-linux-x64-musl": "1.4.0",
+    "@napi-rs/webcodecs-win32-x64-msvc": "1.4.0",
+    "@napi-rs/webcodecs-linux-arm64-gnu": "1.4.0",
+    "@napi-rs/webcodecs-linux-arm64-musl": "1.4.0",
+    "@napi-rs/webcodecs-win32-arm64-msvc": "1.4.0",
+    "@napi-rs/webcodecs-linux-arm-gnueabihf": "1.4.0"
   }
 }