@napi-rs/webcodecs 1.4.0 → 1.4.1

package/index.d.ts

@@ -177,6 +177,7 @@ export type TypedArray =
   | Float64Array
   | BigInt64Array
   | BigUint64Array
+
 /**
  * AudioData - represents uncompressed audio data
  *
@@ -270,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) */
@@ -281,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 */
@@ -309,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 */
@@ -357,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
@@ -369,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 */
@@ -403,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 */
@@ -894,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) */
@@ -905,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
    *
@@ -946,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 */
@@ -992,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
@@ -1004,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 */
@@ -1030,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 */
@@ -1246,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 {
@@ -1268,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 {
@@ -1353,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 {
@@ -1383,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 {
@@ -1467,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 {
@@ -1497,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 {
@@ -1525,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 {
@@ -1543,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 {
@@ -1554,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) */
@@ -1566,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 {
@@ -1645,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 {
@@ -1685,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 {
@@ -1733,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 {
@@ -1799,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 {
@@ -1899,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) */
-| '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'
+export type VideoPixelFormat =
+  | 'I420'
+  | 'I420A'
+  | 'I422'
+  | 'I422A'
+  | 'I444'
+  | 'I444A'
+  | 'I420P10'
+  | 'I420AP10'
+  | 'I422P10'
+  | 'I422AP10'
+  | 'I444P10'
+  | 'I444AP10'
+  | 'I420P12'
+  | 'I422P12'
+  | 'I444P12'
+  | 'NV12'
+  | 'NV21'
+  | 'RGBA'
+  | 'RGBX'
+  | 'BGRA'
+  | '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,4 +1,3 @@
-// prettier-ignore
 /* eslint-disable */
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
@@ -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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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
@@ -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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+        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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+            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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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.4.0' &&
+          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.4.0 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
@@ -797,9 +796,9 @@ if (!nativeBinding || forceWasi) {
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
           const bindingPackageVersion = require('@napi-rs/webcodecs-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '1.4.0') {
+          if (bindingPackageVersion !== '1.4.1') {
             throw new Error(
-              `WASI binding package version mismatch, expected 1.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+              `WASI binding package version mismatch, expected 1.4.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
             )
           }
         }
@@ -880,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.4.0",
+  "version": "1.4.1",
   "description": "WebCodecs API implementation for Node.js using FFmpeg",
   "keywords": [
     "N-API",
@@ -62,28 +62,28 @@
     ]
   },
   "devDependencies": {
-    "@emnapi/core": "^1.11.3",
-    "@emnapi/runtime": "^1.11.3",
-    "@napi-rs/canvas": "^1.0.5",
-    "@napi-rs/cli": "^3.8.4",
-    "@napi-rs/wasm-runtime": "^1.2.2",
-    "@oxc-node/cli": "^0.1.0",
-    "@oxc-node/core": "^0.1.0",
+    "@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.3",
-    "@types/node": "^26.2.0",
+    "@tybys/wasm-util": "^0.10.4",
+    "@types/node": "^26.5.1",
     "ava": "^8.0.1",
     "chalk": "^6.0.0",
-    "emnapi": "^1.11.3",
+    "emnapi": "^2.0.0-alpha.5",
     "husky": "^9.1.7",
-    "lint-staged": "^17.3.0",
-    "mediabunny": "1.53.0",
+    "lint-staged": "^17.5.1",
+    "mediabunny": "1.56.2",
     "npm-run-all2": "^9.0.3",
-    "oxfmt": "^0.62.0",
-    "oxlint": "^1.77.0",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
     "oxlint-tsgolint": "^7.0.2001",
     "prettier": "^3.9.6",
-    "tinybench": "^6.1.2",
+    "tinybench": "^6.2.0",
     "typescript": "^7.0.2",
     "webcodecs-polyfill": "^1.0.1",
     "vite-plugin-mkcert": "^2.1.0"
@@ -112,7 +112,7 @@
       "armv7-unknown-linux-gnueabihf"
     ]
   },
-  "packageManager": "pnpm@11.21.0",
+  "packageManager": "pnpm@12.4.1",
   "ava": {
     "environmentVariables": {
       "TS_NODE_PROJECT": "./tsconfig.json"
@@ -138,14 +138,14 @@
     "registry": "https://registry.npmjs.org/"
   },
   "optionalDependencies": {
-    "@napi-rs/webcodecs-darwin-x64": "1.4.0",
-    "@napi-rs/webcodecs-darwin-arm64": "1.4.0",
-    "@napi-rs/webcodecs-linux-x64-gnu": "1.4.0",
-    "@napi-rs/webcodecs-linux-x64-musl": "1.4.0",
-    "@napi-rs/webcodecs-win32-x64-msvc": "1.4.0",
-    "@napi-rs/webcodecs-linux-arm64-gnu": "1.4.0",
-    "@napi-rs/webcodecs-linux-arm64-musl": "1.4.0",
-    "@napi-rs/webcodecs-win32-arm64-msvc": "1.4.0",
-    "@napi-rs/webcodecs-linux-arm-gnueabihf": "1.4.0"
+    "@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"
   }
-}
+}