@napi-rs/webcodecs 1.2.1 → 1.3.1

package/README.md

@@ -7,8 +7,8 @@ WebCodecs API implementation for Node.js using FFmpeg, built with [NAPI-RS](http
 ## Features
 
 - **W3C WebCodecs API compliant** - Full implementation of the WebCodecs specification with native `DOMException` errors
-- **Video encoding/decoding** - H.264, H.265, VP8, VP9 (with Alpha), AV1
-- **Encoding Alpha channel** - VP9 encoding/decoding with Alpha support(See [canvas-to-video.js](example/canvas-to-video.js) example and [video.html](example/video.html))
+- **Video encoding/decoding** - H.264, H.265 (with Alpha), VP8, VP9 (with Alpha), AV1
+- **Encoding Alpha channel** - VP9 and HEVC alpha encoding/decoding with transparency support (See [canvas-to-video.js](example/canvas-to-video.js) example and [video.html](example/video.html))
 - **Audio encoding/decoding** - AAC, Opus, MP3, FLAC, Vorbis, PCM variants
 - **Container muxing/demuxing** - MP4, WebM, MKV containers with seeking support
 - **Image decoding** - JPEG, PNG, WebP, GIF, BMP, AVIF, JPEG XL
@@ -343,12 +343,18 @@ frame.close()
 | Codec | Codec String            | Encoding | Encoding Alpha | Decoding | Decoding Alpha |
 | ----- | ----------------------- | -------- | -------------- | -------- | -------------- |
 | H.264 | `avc1.*`                | ✅       | 🙅🏻‍♀️             | ✅       | 🙅🏻‍♀️             |
-| H.265 | `hev1.*`, `hvc1.*`      | ✅       | ❓             | ✅       | ❓             |
+| H.265 | `hev1.*`, `hvc1.*`      | ✅       | ✅¹            | ✅       | ✅             |
 | VP8   | `vp8`                   | ✅       | 🙅🏻‍♀️             | ✅       | 🙅🏻‍♀️             |
 | VP9   | `vp09.*`, `vp9`         | ✅       | ✅             | ✅       | ✅             |
 | AV1   | `av01.*`, `av01`, `av1` | ✅       | 🙅🏻‍♀️             | ✅       | 🙅🏻‍♀️             |
 
-**Note:** Short form codec strings (`vp9`, `av01`, `av1`) are accepted for compatibility with browser implementations. VP9 encoding and decoding now supports Alpha channel (transparency).
+**Note:** Short form codec strings (`vp9`, `av01`, `av1`) are accepted for compatibility with browser implementations.
+
+¹ **HEVC Alpha Encoding Limitations:**
+
+- Requires software encoder (libx265) - set `hardwareAcceleration: 'prefer-software'`
+- Hardware encoders (VideoToolbox, NVENC, VAAPI, QSV) do not support alpha
+- Only YUVA420P (8-bit) and YUVA420P10 (10-bit Main 10 profile) pixel formats supported
 
 **Legend:**
 
@@ -448,14 +454,63 @@ encoder.configure({
   hardwareAcceleration: 'prefer-hardware', // 'no-preference' | 'prefer-hardware' | 'prefer-software'
   // Latency mode affects encoder tuning
   latencyMode: 'realtime', // 'quality' | 'realtime'
+  // Alpha channel preservation (VP9 and HEVC only)
+  alpha: 'discard', // 'keep' | 'discard' (default: 'discard')
 })
 ```
 
 - `latencyMode: 'realtime'` - Enables low-latency encoder options (smaller GOP, no B-frames, fast presets)
 - `latencyMode: 'quality'` - Enables quality-focused options (larger GOP, B-frames, lookahead)
+- `alpha: 'keep'` - Preserves alpha channel (VP9 and HEVC only). For HEVC, requires `hardwareAcceleration: 'prefer-software'`
 
 The encoder automatically applies optimal settings for each hardware encoder based on the latency mode.
 
+### Alpha Channel Encoding
+
+Encode video with transparency using VP9 or HEVC:
+
+```typescript
+import { VideoEncoder, VideoFrame } from '@napi-rs/webcodecs'
+
+const encoder = new VideoEncoder({
+  output: (chunk, metadata) => {
+    console.log(`Alpha chunk: ${chunk.byteLength} bytes`)
+  },
+  error: (e) => console.error(e),
+})
+
+// VP9 alpha - works with hardware or software
+encoder.configure({
+  codec: 'vp09.00.10.08',
+  width: 1920,
+  height: 1080,
+  alpha: 'keep',
+})
+
+// HEVC alpha - requires software encoder
+encoder.configure({
+  codec: 'hev1.1.6.L93.B0',
+  width: 1920,
+  height: 1080,
+  alpha: 'keep',
+  hardwareAcceleration: 'prefer-software', // Required for HEVC alpha
+})
+
+// Create frame with alpha channel (I420A format)
+const width = 1920
+const height = 1080
+const frameData = new Uint8Array(width * height * 1.5 + width * height) // Y + U + V + A
+const frame = new VideoFrame(frameData, {
+  format: 'I420A',
+  codedWidth: width,
+  codedHeight: height,
+  timestamp: 0,
+})
+
+encoder.encode(frame)
+frame.close()
+```
+
 ## Limitations
 
 ### Scalable Video Coding (SVC)
@@ -650,4 +705,4 @@ cargo clippy
 
 ## License
 
-MIT
+MIT

package/index.d.ts

@@ -137,6 +137,60 @@ export interface MkvMuxerInit {
   streaming?: { bufferCapacity?: number }
 }
 
+// ============================================================================
+// Async Iterator Types
+// ============================================================================
+
+/**
+ * Chunk yielded by demuxer async iterator.
+ *
+ * Contains either a video or audio chunk. Use the `chunkType` property
+ * to determine which type of chunk is present.
+ *
+ * @example
+ * ```typescript
+ * for await (const chunk of demuxer) {
+ *   if (chunk.chunkType === 'video') {
+ *     videoDecoder.decode(chunk.videoChunk!)
+ *   } else {
+ *     audioDecoder.decode(chunk.audioChunk!)
+ *   }
+ * }
+ * ```
+ */
+export interface DemuxerChunk {
+  /** Type of chunk: 'video' or 'audio' */
+  chunkType: 'video' | 'audio'
+  /** Video chunk (present when chunkType is 'video') */
+  videoChunk?: EncodedVideoChunk
+  /** Audio chunk (present when chunkType is 'audio') */
+  audioChunk?: EncodedAudioChunk
+}
+
+/**
+ * Adds async iterator support to Mp4Demuxer.
+ * Declaration merging allows using `for await...of` with the demuxer.
+ */
+export interface Mp4Demuxer {
+  [Symbol.asyncIterator](): AsyncGenerator<DemuxerChunk, void, void>
+}
+
+/**
+ * Adds async iterator support to WebMDemuxer.
+ * Declaration merging allows using `for await...of` with the demuxer.
+ */
+export interface WebMDemuxer {
+  [Symbol.asyncIterator](): AsyncGenerator<DemuxerChunk, void, void>
+}
+
+/**
+ * Adds async iterator support to MkvDemuxer.
+ * Declaration merging allows using `for await...of` with the demuxer.
+ */
+export interface MkvDemuxer {
+  [Symbol.asyncIterator](): AsyncGenerator<DemuxerChunk, void, void>
+}
+
 export type TypedArray =
   | Int8Array
   | Uint8Array
@@ -561,6 +615,11 @@ export declare class ImageTrackList {
  * MKV Demuxer for reading encoded video and audio from Matroska container
  *
  * MKV supports almost any video and audio codec.
+ *
+ * This type implements JavaScript's async iterable protocol.
+ * It can be used with `for await...of` loops.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols
  */
 export declare class MkvDemuxer {
   constructor(init: MkvDemuxerInit)
@@ -579,6 +638,8 @@ export declare class MkvDemuxer {
   selectVideoTrack(trackIndex: number): void
   selectAudioTrack(trackIndex: number): void
   demux(count?: number | undefined | null): void
+  /** Demux packets asynchronously (awaitable version of demux) */
+  demuxAsync(count?: number | undefined | null): Promise<void>
   seek(timestampUs: number): void
   close(): void
   get state(): string
@@ -673,6 +734,11 @@ export declare class MkvMuxer {
  *
  * demuxer.close();
  * ```
+ *
+ * This type implements JavaScript's async iterable protocol.
+ * It can be used with `for await...of` loops.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols
  */
 export declare class Mp4Demuxer {
   /** Create a new MP4 demuxer */
@@ -705,6 +771,20 @@ export declare class Mp4Demuxer {
    * Otherwise, reads all packets until end of stream.
    */
   demux(count?: number | undefined | null): void
+  /**
+   * Demux packets asynchronously (awaitable version of demux)
+   *
+   * If count is specified, reads up to that many packets.
+   * Otherwise, reads all packets until end of stream.
+   * Returns a Promise that resolves when demuxing is complete.
+   *
+   * This method is useful when you want to wait for demuxing to finish
+   * before proceeding with other operations.
+   *
+   * Note: For streaming use cases, prefer the async iterator pattern:
+   * `for await (const chunk of demuxer) { ... }`
+   */
+  demuxAsync(count?: number | undefined | null): Promise<void>
   /** Seek to a timestamp in microseconds */
   seek(timestampUs: number): void
   /** Close the demuxer and release resources */
@@ -1100,6 +1180,11 @@ export declare class VideoFrame {
  * WebM Demuxer for reading encoded video and audio from WebM container
  *
  * WebM typically contains VP8, VP9, or AV1 video with Opus or Vorbis audio.
+ *
+ * This type implements JavaScript's async iterable protocol.
+ * It can be used with `for await...of` loops.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols
  */
 export declare class WebMDemuxer {
   constructor(init: WebMDemuxerInit)
@@ -1118,6 +1203,8 @@ export declare class WebMDemuxer {
   selectVideoTrack(trackIndex: number): void
   selectAudioTrack(trackIndex: number): void
   demux(count?: number | undefined | null): void
+  /** Demux packets asynchronously (awaitable version of demux) */
+  demuxAsync(count?: number | undefined | null): Promise<void>
   seek(timestampUs: number): void
   close(): void
   get state(): string
@@ -1537,6 +1624,8 @@ export interface MkvVideoTrackConfig {
   width: number
   /** Video height in pixels */
   height: number
+  /** Frame rate (frames per second) */
+  framerate?: number
   /** Codec-specific description data */
   description?: Uint8Array
 }
@@ -1577,6 +1666,8 @@ export interface Mp4VideoTrackConfig {
   width: number
   /** Video height in pixels */
   height: number
+  /** Frame rate (frames per second) */
+  framerate?: number
   /** Codec-specific description data (avcC/hvcC/av1C from encoder metadata) */
   description?: Uint8Array
 }
@@ -1929,6 +2020,8 @@ export interface WebMVideoTrackConfig {
   width: number
   /** Video height in pixels */
   height: number
+  /** Frame rate (frames per second) */
+  framerate?: number
   /** Codec-specific description data */
   description?: Uint8Array
   /** Whether the video has alpha channel (VP9 alpha support) */

package/index.js

@@ -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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+        bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+          `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+            bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 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.2.1' &&
+          bindingPackageVersion !== '1.3.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.2.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+            `Native binding package version mismatch, expected 1.3.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
           )
         }
         return binding
@@ -695,13 +695,17 @@ if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
       wasiBindingError = err
     }
   }
-  if (!nativeBinding) {
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
     try {
       wasiBinding = require('@napi-rs/webcodecs-wasm32-wasi')
       nativeBinding = wasiBinding
     } catch (err) {
       if (process.env.NAPI_RS_FORCE_WASI) {
-        wasiBindingError.cause = err
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
         loadErrors.push(err)
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/webcodecs",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "WebCodecs API implementation for Node.js using FFmpeg",
   "keywords": [
     "N-API",
@@ -43,56 +43,51 @@
   ],
   "scripts": {
     "artifacts": "napi artifacts",
-    "bench": "node --import @oxc-node/core/register benchmark/bench.ts",
-    "build": "napi build --platform --release",
-    "build:debug": "napi build --platform",
-    "format": "run-p format:rs format:toml format:oxfmt format:prettier",
-    "format:prettier": "prettier . \"!**/*.{js,jsx,ts,tsx}\" -w",
+    "bench": "node --import @oxc-node/core/register benchmark/compare.ts",
+    "build": "oxnode ./build.ts --platform --release",
+    "build:debug": "oxnode ./build.ts --platform",
+    "format": "run-p format:rs format:oxfmt",
     "format:oxfmt": "oxfmt",
-    "format:toml": "taplo format",
     "format:rs": "cargo fmt",
     "lint": "oxlint --type-aware",
     "prepublishOnly": "napi prepublish -t npm",
     "test": "ava",
+    "demo": "cd example && vite",
     "typecheck": "tsc -b tsconfig.json && tsc ./index.d.ts",
-    "preversion": "napi build --platform && git add .",
+    "preversion": "oxnode ./build.ts --platform && git add .",
     "version": "napi version"
   },
   "lint-staged": {
     "*.@(js|ts|tsx)": [
-      "oxlint --fix",
-      "oxfmt"
-    ],
-    "*.@(yml|yaml|md|json)": [
-      "prettier --write"
-    ],
-    "*.toml": [
-      "taplo format"
+      "oxlint --fix"
     ]
   },
   "devDependencies": {
-    "@emnapi/core": "^1.7.1",
-    "@emnapi/runtime": "^1.7.1",
-    "@napi-rs/canvas": "^0.1.86",
-    "@napi-rs/cli": "^3.5.0",
-    "@napi-rs/wasm-runtime": "^1.1.0",
+    "@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",
     "@taplo/cli": "^0.7.0",
     "@tybys/wasm-util": "^0.10.1",
-    "@types/node": "^25.0.2",
+    "@types/node": "^25.0.10",
     "ava": "^6.4.1",
     "chalk": "^5.6.2",
-    "emnapi": "^1.7.1",
+    "emnapi": "^1.8.1",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
-    "mediabunny": "1.26.0",
+    "mediabunny": "1.30.1",
     "npm-run-all2": "^8.0.4",
-    "oxfmt": "^0.18.0",
-    "oxlint": "^1.33.0",
-    "oxlint-tsgolint": "^0.9.1",
-    "prettier": "^3.7.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"
+    "typescript": "^5.9.3",
+    "webcodecs-polyfill": "^1.0.1",
+    "vite-plugin-mkcert": "^1.17.9"
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.0"
@@ -118,14 +113,7 @@
       "armv7-unknown-linux-gnueabihf"
     ]
   },
-  "packageManager": "pnpm@10.26.0",
-  "prettier": {
-    "arrowParens": "always",
-    "printWidth": 120,
-    "semi": false,
-    "singleQuote": true,
-    "trailingComma": "all"
-  },
+  "packageManager": "pnpm@10.28.1",
   "ava": {
     "environmentVariables": {
       "TS_NODE_PROJECT": "./tsconfig.json"
@@ -150,15 +138,28 @@
     "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.2.1",
-    "@napi-rs/webcodecs-darwin-arm64": "1.2.1",
-    "@napi-rs/webcodecs-linux-x64-gnu": "1.2.1",
-    "@napi-rs/webcodecs-linux-x64-musl": "1.2.1",
-    "@napi-rs/webcodecs-win32-x64-msvc": "1.2.1",
-    "@napi-rs/webcodecs-linux-arm64-gnu": "1.2.1",
-    "@napi-rs/webcodecs-linux-arm64-musl": "1.2.1",
-    "@napi-rs/webcodecs-win32-arm64-msvc": "1.2.1",
-    "@napi-rs/webcodecs-linux-arm-gnueabihf": "1.2.1"
+    "@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"
   }
 }