@napi-rs/webcodecs 1.3.1 → 1.4.1

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
 // ============================================================================
@@ -203,6 +177,7 @@ export type TypedArray =
   | Float64Array
   | BigInt64Array
   | BigUint64Array
+
 /**
  * AudioData - represents uncompressed audio data
  *
@@ -296,7 +271,7 @@ export declare class AudioDecoder {
    *
    * @param init - Init dictionary containing output and error callbacks
    */
-  constructor(init: { output: (data: AudioData) => void; error: (error: Error) => void })
+  constructor(init: { output: (data: AudioData) => void; error: (error: DOMException) => void })
   /** Get decoder state */
   get state(): CodecState
   /** Get number of pending decode operations (per WebCodecs spec) */
@@ -307,9 +282,9 @@ export declare class AudioDecoder {
    * The dequeue event fires when decodeQueueSize decreases,
    * allowing backpressure management.
    */
-  set ondequeue(callback: (() => unknown) | undefined | null)
+  set ondequeue(callback: ((event: Event) => unknown) | undefined | null)
   /** Get the dequeue event handler (per WebCodecs spec) */
-  get ondequeue(): (() => unknown) | null
+  get ondequeue(): ((event: Event) => unknown) | null
   /** Configure the decoder */
   configure(config: AudioDecoderConfig): void
   /** Decode an encoded audio chunk */
@@ -335,16 +310,19 @@ export declare class AudioDecoder {
    * returns { supported: false } for valid but unsupported configs.
    */
   static isConfigSupported(config: AudioDecoderConfig): Promise<AudioDecoderSupport>
-  /** Add an event listener for the specified event type */
+  /**
+   * Add an event listener for the specified event type
+   * Uses separate RwLock to avoid blocking on decode operations
+   */
   addEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: AudioDecoderAddEventListenerOptions | undefined | null,
   ): void
   /** Remove an event listener for the specified event type */
   removeEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: AudioDecoderEventListenerOptions | undefined | null,
   ): void
   /** Dispatch an event to all registered listeners */
@@ -383,7 +361,7 @@ export declare class AudioEncoder {
    */
   constructor(init: {
     output: (chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata) => void
-    error: (error: Error) => void
+    error: (error: DOMException) => void
   })
   /** Get encoder state */
   get state(): CodecState
@@ -395,9 +373,9 @@ export declare class AudioEncoder {
    * The dequeue event fires when encodeQueueSize decreases,
    * allowing backpressure management.
    */
-  set ondequeue(callback: (() => unknown) | undefined | null)
+  set ondequeue(callback: ((event: Event) => unknown) | undefined | null)
   /** Get the dequeue event handler (per WebCodecs spec) */
-  get ondequeue(): (() => unknown) | null
+  get ondequeue(): ((event: Event) => unknown) | null
   /** Configure the encoder */
   configure(config: AudioEncoderConfig): void
   /** Encode audio data */
@@ -429,13 +407,13 @@ export declare class AudioEncoder {
    */
   addEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: AudioEncoderAddEventListenerOptions | undefined | null,
   ): void
   /** Remove an event listener for the specified event type */
   removeEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: AudioEncoderEventListenerOptions | undefined | null,
   ): void
   /** Dispatch an event to all registered listeners */
@@ -539,7 +517,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 */
@@ -919,7 +898,7 @@ export declare class VideoDecoder {
    *
    * @param init - Init dictionary containing output and error callbacks
    */
-  constructor(init: { output: (frame: VideoFrame) => void; error: (error: Error) => void })
+  constructor(init: { output: (frame: VideoFrame) => void; error: (error: DOMException) => void })
   /** Get decoder state */
   get state(): CodecState
   /** Get number of pending decode operations (per WebCodecs spec) */
@@ -930,9 +909,9 @@ export declare class VideoDecoder {
    * The dequeue event fires when decodeQueueSize decreases,
    * allowing backpressure management.
    */
-  set ondequeue(callback: (() => unknown) | undefined | null)
+  set ondequeue(callback: ((event: Event) => unknown) | undefined | null)
   /** Get the dequeue event handler (per WebCodecs spec) */
-  get ondequeue(): (() => unknown) | null
+  get ondequeue(): ((event: Event) => unknown) | null
   /**
    * Configure the decoder
    *
@@ -971,13 +950,13 @@ export declare class VideoDecoder {
    */
   addEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: VideoDecoderAddEventListenerOptions | undefined | null,
   ): void
   /** Remove an event listener for the specified event type */
   removeEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: VideoDecoderEventListenerOptions | undefined | null,
   ): void
   /** Dispatch an event to all registered listeners */
@@ -1017,7 +996,7 @@ export declare class VideoEncoder {
    */
   constructor(init: {
     output: (chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata) => void
-    error: (error: Error) => void
+    error: (error: DOMException) => void
   })
   /** Get encoder state */
   get state(): CodecState
@@ -1029,9 +1008,9 @@ export declare class VideoEncoder {
    * The dequeue event fires when encodeQueueSize decreases,
    * allowing backpressure management.
    */
-  set ondequeue(callback: (() => unknown) | undefined | null)
+  set ondequeue(callback: ((event: Event) => unknown) | undefined | null)
   /** Get the dequeue event handler (per WebCodecs spec) */
-  get ondequeue(): (() => unknown) | null
+  get ondequeue(): ((event: Event) => unknown) | null
   /** Configure the encoder */
   configure(config: VideoEncoderConfig): void
   /** Encode a frame */
@@ -1055,13 +1034,13 @@ export declare class VideoEncoder {
    */
   addEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: AddEventListenerOptions | undefined | null,
   ): void
   /** Remove an event listener for the specified event type */
   removeEventListener(
     eventType: string,
-    callback: () => unknown,
+    callback: (event: Event) => unknown,
     options?: EventListenerOptions | undefined | null,
   ): void
   /** Dispatch an event to all registered listeners */
@@ -1271,10 +1250,7 @@ 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'
+export type AacBitstreamFormat = 'aac' | 'adts'
 
 /** AAC encoder configuration (W3C WebCodecs AAC Registration) */
 export interface AacEncoderConfig {
@@ -1293,10 +1269,7 @@ export interface AddEventListenerOptions {
  * Alpha channel handling option (W3C WebCodecs spec)
  * Default is "discard" per spec
  */
-export type AlphaOption = /** Keep alpha channel if present */
-  | 'keep'
-  /** Discard alpha channel (default per W3C spec) */
-  | 'discard'
+export type AlphaOption = 'keep' | 'discard'
 
 /** Options for copyTo operation */
 export interface AudioDataCopyToOptions {
@@ -1378,28 +1351,10 @@ 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'
+export type AudioSampleFormat = 'u8' | 's16' | 's32' | 'f32' | 'u8-planar' | 's16-planar' | 's32-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'
+export type AvcBitstreamFormat = 'avc' | 'annexb'
 
 /** AVC (H.264) encoder configuration (W3C WebCodecs AVC Registration) */
 export interface AvcEncoderConfig {
@@ -1408,24 +1363,13 @@ export interface AvcEncoderConfig {
 }
 
 /** Bitrate mode for audio encoding (W3C WebCodecs spec) */
-export type BitrateMode = /** Variable bitrate (default) */
-  | 'variable'
-  /** Constant bitrate */
-  | 'constant'
+export type BitrateMode = 'variable' | 'constant'
 
 /** Encoder state per WebCodecs spec */
-export type CodecState = /** Encoder not configured */
-  | 'unconfigured'
-  /** Encoder configured and ready */
-  | 'configured'
-  /** Encoder closed */
-  | 'closed'
+export type CodecState = 'unconfigured' | 'configured' | 'closed'
 
 /** ColorSpaceConversion for ImageDecoder (W3C WebCodecs spec) */
-export type ColorSpaceConversion = /** Apply default color space conversion (spec default) */
-  | 'default'
-  /** No color space conversion */
-  | 'none'
+export type ColorSpaceConversion = 'default' | 'none'
 
 /** Audio decoder configuration exposed to JavaScript */
 export interface DemuxerAudioDecoderConfig {
@@ -1492,10 +1436,7 @@ 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'
+export type EncodedAudioChunkType = 'key' | 'delta'
 
 /** Output callback metadata per WebCodecs spec */
 export interface EncodedVideoChunkMetadata {
@@ -1522,10 +1463,7 @@ export interface EncodedVideoChunkMetadataJs {
 }
 
 /** Type of encoded video chunk */
-export type EncodedVideoChunkType = /** Keyframe - can be decoded independently */
-  | 'key'
-  /** Delta frame - depends on previous frames */
-  | 'delta'
+export type EncodedVideoChunkType = 'key' | 'delta'
 
 /** Options for removeEventListener (W3C DOM spec) */
 export interface EventListenerOptions {
@@ -1550,12 +1488,7 @@ export declare function getHardwareAccelerators(): Array<HardwareAccelerator>
 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'
+export type HardwareAcceleration = 'no-preference' | 'prefer-hardware' | 'prefer-software'
 
 /** Hardware accelerator information */
 export interface HardwareAccelerator {
@@ -1568,10 +1501,7 @@ 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'
+export type HevcBitstreamFormat = 'hevc' | 'annexb'
 
 /** HEVC (H.265) encoder configuration (W3C WebCodecs HEVC Registration) */
 export interface HevcEncoderConfig {
@@ -1579,6 +1509,9 @@ export interface HevcEncoderConfig {
   format?: HevcBitstreamFormat
 }
 
+/** HEVC sample-entry override for the MP4 muxer */
+export type HevcSampleEntryJs = 'hvc1' | 'hev1'
+
 /** Image decode options */
 export interface ImageDecodeOptions {
   /** Frame index to decode (for animated images) */
@@ -1591,10 +1524,7 @@ export interface ImageDecodeOptions {
 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'
+export type LatencyMode = 'quality' | 'realtime'
 
 /** Audio track configuration for MKV muxer */
 export interface MkvAudioTrackConfig {
@@ -1670,21 +1600,20 @@ export interface Mp4VideoTrackConfig {
   framerate?: number
   /** Codec-specific description data (avcC/hvcC/av1C from encoder metadata) */
   description?: Uint8Array
+  /**
+   * HEVC sample-entry override. Default picks "hvc1" when the hvcC
+   * description is well-formed, single-layer, and complete; "hev1" permits
+   * in-band parameter sets (e.g. remuxing hev1 streams with parameter-set
+   * updates); "hvc1" forces the tag and requires a qualifying description.
+   */
+  sampleEntry?: HevcSampleEntryJs
 }
 
 /** 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'
+export type OpusApplication = 'voip' | 'audio' | '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'
+export type OpusBitstreamFormat = 'opus' | 'ogg'
 
 /** Opus encoder configuration (W3C WebCodecs Opus Registration) */
 export interface OpusEncoderConfig {
@@ -1710,12 +1639,7 @@ 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'
+export type OpusSignal = 'auto' | 'music' | 'voice'
 
 /** Layout information for a single plane per WebCodecs spec */
 export interface PlaneLayout {
@@ -1738,7 +1662,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
 }
 
@@ -1755,16 +1682,7 @@ 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'
+export type VideoColorPrimaries = 'bt709' | 'bt470bg' | 'smpte170m' | 'bt2020' | 'smpte432'
 
 /** Options for addEventListener (W3C DOM spec) */
 export interface VideoDecoderAddEventListenerOptions {
@@ -1821,12 +1739,7 @@ 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'
+export type VideoEncoderBitrateMode = 'variable' | 'constant' | 'quantizer'
 
 /** Encode options per WebCodecs spec */
 export interface VideoEncoderEncodeOptions {
@@ -1921,76 +1834,34 @@ 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'
+export type VideoMatrixCoefficients = 'rgb' | 'bt709' | 'bt470bg' | 'smpte170m' | 'bt2020-ncl'
 
 /** Video pixel format (WebCodecs spec) */
-export type VideoPixelFormat = /** Planar YUV 4:2:0| 12bpp| (1 Cr & Cb sample per 2x2 Y samples) */
+export type VideoPixelFormat =
   | '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'
+export type VideoTransferCharacteristics = 'bt709' | 'smpte170m' | 'iec61966-2-1' | 'srgb' | 'linear' | 'pq' | 'hlg'
 
 /** Audio track configuration for WebM muxer */
 export interface WebMAudioTrackConfig {

package/index.js

@@ -1,9 +1,8 @@
-// prettier-ignore
 /* eslint-disable */
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { readFileSync } = require('node:fs')
+const { readFileSync } = require('fs')
 let nativeBinding = null
 const loadErrors = []
 
@@ -33,7 +32,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 +77,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -100,12 +99,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -118,8 +117,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 +129,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -152,12 +151,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -175,12 +174,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -197,12 +196,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -222,12 +221,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.1' &&
         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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
         )
       }
       return binding
@@ -244,12 +243,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -266,12 +265,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -292,12 +291,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -314,12 +313,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -341,12 +340,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -363,12 +362,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -387,12 +386,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -409,12 +408,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -433,12 +432,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -455,12 +454,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -479,12 +478,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -501,12 +500,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -525,12 +524,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -547,12 +546,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.1' &&
             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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
           return binding
@@ -570,12 +569,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -592,12 +591,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -618,12 +617,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -640,12 +639,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -662,12 +661,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.1' &&
           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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -682,54 +681,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.1') {
+            throw new Error(
+              `WASI binding package version mismatch, expected 1.4.1 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`)
 }
@@ -769,6 +879,7 @@ module.exports.getHardwareAccelerators = nativeBinding.getHardwareAccelerators
 module.exports.getPreferredHardwareAccelerator = nativeBinding.getPreferredHardwareAccelerator
 module.exports.HardwareAcceleration = nativeBinding.HardwareAcceleration
 module.exports.HevcBitstreamFormat = nativeBinding.HevcBitstreamFormat
+module.exports.HevcSampleEntryJs = nativeBinding.HevcSampleEntryJs
 module.exports.isHardwareAcceleratorAvailable = nativeBinding.isHardwareAcceleratorAvailable
 module.exports.LatencyMode = nativeBinding.LatencyMode
 module.exports.OpusApplication = nativeBinding.OpusApplication

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/webcodecs",
-  "version": "1.3.1",
+  "version": "1.4.1",
   "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": "^2.0.0-alpha.5",
+    "@emnapi/runtime": "^2.0.0-alpha.5",
+    "@napi-rs/canvas": "^1.0.9",
+    "@napi-rs/cli": "^3.9.1",
+    "@napi-rs/wasm-runtime": "^1.2.4",
+    "@oxc-node/cli": "^0.1.2",
+    "@oxc-node/core": "^0.1.2",
     "@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.4",
+    "@types/node": "^26.5.1",
+    "ava": "^8.0.1",
+    "chalk": "^6.0.0",
+    "emnapi": "^2.0.0-alpha.5",
     "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.5.1",
+    "mediabunny": "1.56.2",
+    "npm-run-all2": "^9.0.3",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "prettier": "^3.9.6",
+    "tinybench": "^6.2.0",
+    "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@12.4.1",
   "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.1",
+    "@napi-rs/webcodecs-darwin-arm64": "1.4.1",
+    "@napi-rs/webcodecs-linux-x64-gnu": "1.4.1",
+    "@napi-rs/webcodecs-linux-x64-musl": "1.4.1",
+    "@napi-rs/webcodecs-win32-x64-msvc": "1.4.1",
+    "@napi-rs/webcodecs-linux-arm64-gnu": "1.4.1",
+    "@napi-rs/webcodecs-linux-arm64-musl": "1.4.1",
+    "@napi-rs/webcodecs-win32-arm64-msvc": "1.4.1",
+    "@napi-rs/webcodecs-linux-arm-gnueabihf": "1.4.1"
   }
-}
+}