webcodecs-node 0.7.5 → 0.8.5

package/dist/backends/node-av/image/decoder/constants.js

@@ -0,0 +1,24 @@
+/**
+ * Image decoder constants
+ */
+import { AV_CODEC_ID_PNG, AV_CODEC_ID_MJPEG, AV_CODEC_ID_WEBP, AV_CODEC_ID_GIF, AV_CODEC_ID_BMP, AV_CODEC_ID_TIFF, AV_CODEC_ID_AV1, } from 'node-av/constants';
+/** MIME type to AVCodecID mapping */
+export const MIME_TO_CODEC_ID = {
+    'image/png': AV_CODEC_ID_PNG,
+    'image/apng': AV_CODEC_ID_PNG,
+    'image/jpeg': AV_CODEC_ID_MJPEG,
+    'image/jpg': AV_CODEC_ID_MJPEG,
+    'image/webp': AV_CODEC_ID_WEBP,
+    'image/gif': AV_CODEC_ID_GIF,
+    'image/bmp': AV_CODEC_ID_BMP,
+    'image/tiff': AV_CODEC_ID_TIFF,
+    'image/avif': AV_CODEC_ID_AV1,
+};
+/**
+ * Formats that require Demuxer for proper decoding (container formats)
+ * Note: WebP is excluded because FFmpeg's webp demuxer doesn't support ANIM/ANMF
+ */
+export const DEMUXER_FORMATS = ['image/gif', 'image/apng', 'image/avif'];
+/** Default frame duration in microseconds (100ms) */
+export const DEFAULT_FRAME_DURATION = 100000;
+//# sourceMappingURL=constants.js.map

package/dist/backends/node-av/image/decoder/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,GAEhB,MAAM,mBAAmB,CAAC;AAE3B,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,iBAAiB;IAC9B,YAAY,EAAE,gBAAgB;IAC9B,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,gBAAgB;IAC9B,YAAY,EAAE,eAAe;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AAEzE,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC"}

package/dist/backends/node-av/image/decoder/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Image decoder helper utilities
+ */
+export type { DecodedImageFrame, ImageDecoderConfig } from './types.js';
+export { MIME_TO_CODEC_ID, DEMUXER_FORMATS, DEFAULT_FRAME_DURATION } from './constants.js';
+export { probeImageDimensions } from './probe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/node-av/image/decoder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/backends/node-av/image/decoder/index.js

@@ -0,0 +1,6 @@
+/**
+ * Image decoder helper utilities
+ */
+export { MIME_TO_CODEC_ID, DEMUXER_FORMATS, DEFAULT_FRAME_DURATION } from './constants.js';
+export { probeImageDimensions } from './probe.js';
+//# sourceMappingURL=index.js.map

package/dist/backends/node-av/image/decoder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/backends/node-av/image/decoder/probe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Image dimension probing utilities
+ */
+/**
+ * Probe image dimensions using node-av
+ * Returns { width, height } or { width: 0, height: 0 } if probing fails
+ */
+export declare function probeImageDimensions(data: Uint8Array, mimeType: string): Promise<{
+    width: number;
+    height: number;
+}>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/backends/node-av/image/decoder/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/probe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD5C"}

package/dist/backends/node-av/image/decoder/probe.js

@@ -0,0 +1,57 @@
+/**
+ * Image dimension probing utilities
+ */
+import { Decoder } from 'node-av/api';
+import { FormatContext, Packet, Rational } from 'node-av/lib';
+import { AVMEDIA_TYPE_VIDEO } from 'node-av/constants';
+import { MIME_TO_CODEC_ID } from './constants.js';
+/**
+ * Probe image dimensions using node-av
+ * Returns { width, height } or { width: 0, height: 0 } if probing fails
+ */
+export async function probeImageDimensions(data, mimeType) {
+    const codecId = MIME_TO_CODEC_ID[mimeType.toLowerCase()];
+    if (!codecId) {
+        return { width: 0, height: 0 };
+    }
+    let formatContext = null;
+    let stream = null;
+    let decoder = null;
+    try {
+        formatContext = new FormatContext();
+        formatContext.allocContext();
+        stream = formatContext.newStream();
+        stream.timeBase = new Rational(1, 25);
+        const params = stream.codecpar;
+        params.codecType = AVMEDIA_TYPE_VIDEO;
+        params.codecId = codecId;
+        params.width = 0;
+        params.height = 0;
+        decoder = await Decoder.create(stream, { exitOnError: false });
+        const packet = new Packet();
+        packet.alloc();
+        packet.streamIndex = stream.index;
+        packet.pts = 0n;
+        packet.dts = 0n;
+        packet.timeBase = new Rational(1, 25);
+        packet.data = Buffer.from(data);
+        packet.duration = 1n;
+        await decoder.decode(packet);
+        packet.unref();
+        const frame = await decoder.receive();
+        if (frame) {
+            const width = frame.width;
+            const height = frame.height;
+            frame.unref();
+            return { width, height };
+        }
+        return { width: 0, height: 0 };
+    }
+    catch {
+        return { width: 0, height: 0 };
+    }
+    finally {
+        decoder?.close();
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/backends/node-av/image/decoder/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/probe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAU,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAgB,EAChB,QAAgB;IAEhB,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,aAAa,GAAyB,IAAI,CAAC;IAC/C,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,OAAO,GAAmB,IAAI,CAAC;IAEnC,IAAI,CAAC;QACH,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,aAAa,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC/B,MAAM,CAAC,SAAS,GAAG,kBAAkB,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAElB,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;QAChB,MAAM,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QAErB,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/backends/node-av/image/decoder/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Image decoder type definitions
+ */
+import type { VideoColorSpaceInit } from '../../../../formats/index.js';
+import type { VideoPixelFormat } from '../../../../core/VideoFrame.js';
+export interface DecodedImageFrame {
+    data: Uint8Array;
+    width: number;
+    height: number;
+    timestamp: number;
+    duration: number;
+    complete: boolean;
+    colorSpace?: VideoColorSpaceInit;
+    format: VideoPixelFormat;
+}
+export interface ImageDecoderConfig {
+    mimeType: string;
+    data: Uint8Array;
+    desiredWidth?: number;
+    desiredHeight?: number;
+    colorSpace?: VideoColorSpaceInit;
+    /** Preferred output pixel format. If not specified, defaults to RGBA. */
+    preferredFormat?: VideoPixelFormat;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backends/node-av/image/decoder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,yEAAyE;IACzE,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/backends/node-av/image/decoder/types.js

@@ -0,0 +1,5 @@
+/**
+ * Image decoder type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backends/node-av/image/decoder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/image/decoder/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/backends/node-av/video/NodeAvVideoDecoder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * NodeAvVideoDecoder - Video decoder using node-av native bindings
+ *
+ * Implements the VideoDecoderBackend interface for decoding video streams
+ * using FFmpeg's libav* libraries via node-av.
+ */
+import { EventEmitter } from 'events';
+import type { VideoDecoderBackend, VideoDecoderBackendConfig } from '../../types.js';
+/**
+ * NodeAV-backed video decoder implementing VideoDecoderBackend interface
+ */
+export declare class NodeAvVideoDecoder extends EventEmitter implements VideoDecoderBackend {
+    private decoder;
+    private hardware;
+    private formatContext;
+    private stream;
+    private filter;
+    private config;
+    private queue;
+    private processing;
+    private processingPromise;
+    private shuttingDown;
+    private packetIndex;
+    private packetTimeBase;
+    private outputPixelFormat;
+    private filterDescription;
+    private hardwarePreference;
+    private pendingTimestamps;
+    get isHealthy(): boolean;
+    startDecoder(config: VideoDecoderBackendConfig): void;
+    write(data: Buffer | Uint8Array, timestamp?: number, duration?: number): boolean;
+    end(): void;
+    kill(): void;
+    shutdown(): Promise<void>;
+    private processQueue;
+    private ensureDecoder;
+    private logDecoderSelection;
+    private decodeBuffer;
+    private drainFrames;
+    private toOutput;
+    private finish;
+    private cleanup;
+}
+//# sourceMappingURL=NodeAvVideoDecoder.d.ts.map

package/dist/backends/node-av/video/NodeAvVideoDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAvVideoDecoder.d.ts","sourceRoot":"","sources":["../../../../src/backends/node-av/video/NodeAvVideoDecoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AAkBxB;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAAoE;IACjF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,iBAAiB,CAAqC;IAC9D,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,kBAAkB,CAA4E;IAGtG,OAAO,CAAC,iBAAiB,CAAgB;IAEzC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI;IAOrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAmBhF,GAAG,IAAI,IAAI;IAMX,IAAI,IAAI,IAAI;IAMN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,YAAY;YA4BZ,aAAa;IA8C3B,OAAO,CAAC,mBAAmB;YAab,YAAY;YA2BZ,WAAW;YAmCX,QAAQ;YAqFR,MAAM;IAmBpB,OAAO,CAAC,OAAO;CAahB"}

package/dist/backends/node-av/video/NodeAvVideoDecoder.js

@@ -0,0 +1,326 @@
+/**
+ * NodeAvVideoDecoder - Video decoder using node-av native bindings
+ *
+ * Implements the VideoDecoderBackend interface for decoding video streams
+ * using FFmpeg's libav* libraries via node-av.
+ */
+import { EventEmitter } from 'events';
+import { Decoder, FilterAPI } from 'node-av/api';
+import { FormatContext, Packet, Rational } from 'node-av/lib';
+import { AVMEDIA_TYPE_VIDEO, AV_PKT_FLAG_KEY, AV_PIX_FMT_YUV420P, } from 'node-av/constants';
+import { extractColorSpaceFromFrame } from '../../../formats/color-space.js';
+import { parseCodecString } from '../../../hardware/index.js';
+import { createLogger } from '../../../utils/logger.js';
+import { selectBestFilterChain, getNextFilterChain, describePipeline } from '../HardwarePipeline.js';
+import { acquireHardwareContext, releaseHardwareContext } from '../../../utils/hardware-pool.js';
+import { MAX_FILTER_CHAIN_ATTEMPTS, SKIP_HARDWARE_CODECS, mapCodecId, mapPixelFormat, pixelFormatToFFmpegName, } from './decoder/index.js';
+const logger = createLogger('NodeAvVideoDecoder');
+/**
+ * NodeAV-backed video decoder implementing VideoDecoderBackend interface
+ */
+export class NodeAvVideoDecoder extends EventEmitter {
+    decoder = null;
+    hardware = null;
+    formatContext = null;
+    stream = null;
+    filter = null;
+    config = null;
+    queue = [];
+    processing = false;
+    processingPromise = null;
+    shuttingDown = false;
+    packetIndex = 0;
+    // Use microsecond timebase to preserve input timestamps exactly
+    packetTimeBase = new Rational(1, 1_000_000);
+    outputPixelFormat = AV_PIX_FMT_YUV420P;
+    filterDescription = null;
+    hardwarePreference = 'no-preference';
+    // Track input timestamps - sorted by presentation order (ascending)
+    // Used to recover timestamps since node-av decoder doesn't preserve packet PTS
+    pendingTimestamps = [];
+    get isHealthy() {
+        return !this.shuttingDown;
+    }
+    startDecoder(config) {
+        this.config = { ...config };
+        // Use microsecond timebase for timestamp preservation (set in constructor)
+        this.outputPixelFormat = mapPixelFormat(config.outputPixelFormat ?? 'yuv420p');
+        this.hardwarePreference = config.hardwareAcceleration ?? 'no-preference';
+    }
+    write(data, timestamp, duration) {
+        if (!this.config || this.shuttingDown) {
+            return false;
+        }
+        const ts = timestamp ?? 0;
+        this.queue.push({ data: Buffer.from(data), timestamp: ts, duration: duration ?? 0 });
+        // Insert timestamp into sorted pending list (ascending order = display order)
+        // Binary search to find insertion point
+        let lo = 0, hi = this.pendingTimestamps.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            if (this.pendingTimestamps[mid] < ts)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        this.pendingTimestamps.splice(lo, 0, ts);
+        void this.processQueue();
+        return true;
+    }
+    end() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        void this.finish().catch((err) => this.emit('error', err));
+    }
+    kill() {
+        this.shuttingDown = true;
+        this.cleanup();
+        this.emit('close', null);
+    }
+    async shutdown() {
+        this.end();
+    }
+    async processQueue() {
+        if (this.processingPromise) {
+            return this.processingPromise;
+        }
+        this.processingPromise = (async () => {
+            if (this.processing)
+                return;
+            this.processing = true;
+            try {
+                while (this.queue.length > 0) {
+                    const item = this.queue.shift();
+                    // Emit chunkAccepted when chunk starts processing (for dequeue event)
+                    // Use setImmediate to ensure emit happens after write() returns
+                    setImmediate(() => this.emit('chunkAccepted'));
+                    await this.decodeBuffer(item.data, item.timestamp, item.duration);
+                }
+            }
+            catch (err) {
+                this.emit('error', err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                this.processing = false;
+                this.processingPromise = null;
+            }
+        })();
+        return this.processingPromise;
+    }
+    async ensureDecoder() {
+        if (this.decoder || !this.config) {
+            return;
+        }
+        const codecName = parseCodecString(this.config.codec) ?? this.config.codec ?? 'h264';
+        const codecId = mapCodecId(codecName);
+        if (!codecId) {
+            throw new Error(`Unsupported codec: ${this.config.codec}`);
+        }
+        this.formatContext = new FormatContext();
+        this.formatContext.allocContext();
+        this.stream = this.formatContext.newStream();
+        this.stream.timeBase = this.packetTimeBase;
+        const params = this.stream.codecpar;
+        params.codecType = AVMEDIA_TYPE_VIDEO;
+        params.codecId = codecId;
+        // Width/height can be 0 for size-less configs - FFmpeg will determine from bitstream
+        params.width = this.config.width ?? 0;
+        params.height = this.config.height ?? 0;
+        if (this.config.description) {
+            params.extradata = Buffer.from(this.config.description);
+        }
+        // Try hardware decoding unless explicitly disabled or codec is on skip list
+        // 'no-preference' and 'prefer-hardware' both enable hardware acceleration
+        // 'prefer-software' disables hardware acceleration
+        const shouldTryHardware = this.hardwarePreference !== 'prefer-software' &&
+            !SKIP_HARDWARE_CODECS.includes(codecName);
+        if (shouldTryHardware) {
+            // Use pooled hardware context instead of creating new one
+            this.hardware = acquireHardwareContext();
+        }
+        this.decoder = await Decoder.create(this.stream, {
+            hardware: this.hardware ?? undefined,
+            exitOnError: true,
+        });
+        this.logDecoderSelection(codecName);
+    }
+    logDecoderSelection(codecName) {
+        const hwName = this.hardware?.deviceTypeName;
+        if (hwName && this.decoder?.isHardware()) {
+            logger.info(`Using hardware decoder (${hwName}) for ${codecName}`);
+        }
+        else if (hwName) {
+            logger.info(`Hardware context ${hwName} unavailable, decoding in software`);
+        }
+        else if (this.hardwarePreference === 'prefer-hardware') {
+            logger.info('Hardware requested but not available, decoding in software');
+        }
+        else {
+            logger.debug(`Using software decoder for ${codecName}`);
+        }
+    }
+    async decodeBuffer(buffer, timestamp, duration) {
+        await this.ensureDecoder();
+        if (!this.decoder || !this.stream) {
+            throw new Error('Decoder not initialized');
+        }
+        const packet = new Packet();
+        packet.alloc();
+        packet.streamIndex = this.stream.index;
+        // Use input timestamp as PTS (in microseconds, matching our timebase)
+        packet.pts = BigInt(Math.round(timestamp));
+        packet.dts = BigInt(Math.round(timestamp));
+        packet.timeBase = this.packetTimeBase;
+        packet.data = buffer;
+        // Use actual duration from chunk (in microseconds), fallback to 1 if not provided
+        packet.duration = duration > 0 ? BigInt(Math.round(duration)) : 1n;
+        if (this.packetIndex === 0) {
+            // Cast to any to handle strict type checking on flags
+            packet.flags |= AV_PKT_FLAG_KEY;
+        }
+        await this.decoder.decode(packet);
+        packet.unref();
+        await this.drainFrames();
+        this.packetIndex++;
+    }
+    async drainFrames() {
+        if (!this.decoder)
+            return;
+        let frame = await this.decoder.receive();
+        while (frame) {
+            if (frame === undefined) {
+                break;
+            }
+            // The node-av decoder doesn't preserve packet PTS in output frames.
+            // Frames come out in display order (lowest PTS first), so we pop
+            // from our sorted timestamp list to recover the original timestamp.
+            const timestamp = this.pendingTimestamps.shift() ?? 0;
+            // Extract colorSpace from the native frame BEFORE filtering
+            // (filtering destroys color info as it converts to target format)
+            const colorSpace = extractColorSpaceFromFrame({
+                colorPrimaries: frame.colorPrimaries,
+                colorTrc: frame.colorTrc,
+                colorSpace: frame.colorSpace,
+                colorRange: frame.colorRange,
+            });
+            const output = await this.toOutput(frame);
+            if (!output.nativeFrame) {
+                frame.unref();
+            }
+            if (output.buffer) {
+                this.emit('frame', { buffer: output.buffer, timestamp, colorSpace });
+            }
+            else if (output.nativeFrame) {
+                this.emit('frame', { nativeFrame: output.nativeFrame, format: this.outputPixelFormat, timestamp, colorSpace });
+            }
+            frame = await this.decoder.receive();
+        }
+    }
+    async toOutput(frame) {
+        const outputFormatName = pixelFormatToFFmpegName(this.outputPixelFormat);
+        const isHardwareFrame = Boolean(frame.hwFramesCtx);
+        // If frame already matches requested format and is software, just export
+        if (!isHardwareFrame && frame.format === this.outputPixelFormat) {
+            // Keep frame alive for the caller; they are responsible for unref()
+            return { buffer: null, nativeFrame: frame };
+        }
+        // Try to process with current or new filter chain
+        // If it fails, automatically try the next chain in the fallback sequence
+        let attempts = 0;
+        while (attempts < MAX_FILTER_CHAIN_ATTEMPTS) {
+            attempts++;
+            // Get filter chain (either current or select new one)
+            let description;
+            if (!this.filter || this.filterDescription === null) {
+                description = selectBestFilterChain(this.hardware, outputFormatName, isHardwareFrame);
+            }
+            else {
+                description = this.filterDescription;
+            }
+            // Create filter if needed
+            if (!this.filter || this.filterDescription !== description) {
+                this.filter?.close();
+                // Log the selected pipeline
+                const hwType = this.hardware?.deviceTypeName ?? 'software';
+                logger.debug(`Pipeline: ${describePipeline(description, hwType)}`);
+                try {
+                    this.filter = FilterAPI.create(description, {
+                        hardware: this.hardware ?? undefined,
+                    });
+                    this.filterDescription = description;
+                }
+                catch (err) {
+                    // Filter creation failed, try next chain
+                    logger.debug('Filter creation failed, trying next chain...');
+                    this.filter = null;
+                    this.filterDescription = null;
+                    const nextChain = getNextFilterChain(this.hardware, outputFormatName, isHardwareFrame);
+                    if (!nextChain) {
+                        throw err; // No more chains to try
+                    }
+                    continue;
+                }
+            }
+            // Try to process the frame
+            try {
+                await this.filter.process(frame);
+                // Drain a single frame from the filter
+                let filtered = await this.filter.receive();
+                while (filtered === null) {
+                    filtered = await this.filter.receive();
+                }
+                if (!filtered) {
+                    return { buffer: null };
+                }
+                const buffer = filtered.toBuffer();
+                filtered.unref();
+                return { buffer };
+            }
+            catch (err) {
+                // Processing failed - close filter and try next chain
+                logger.debug(`Filter processing failed: ${err instanceof Error ? err.message : err}`);
+                this.filter?.close();
+                this.filter = null;
+                this.filterDescription = null;
+                const nextChain = getNextFilterChain(this.hardware, outputFormatName, isHardwareFrame);
+                if (!nextChain) {
+                    throw err; // No more chains to try
+                }
+                // Loop will continue with next chain
+            }
+        }
+        throw new Error(`Failed to find working filter chain after ${MAX_FILTER_CHAIN_ATTEMPTS} attempts`);
+    }
+    async finish() {
+        await this.processQueue();
+        if (this.processingPromise) {
+            await this.processingPromise;
+        }
+        if (this.decoder) {
+            try {
+                await this.decoder.flush();
+                await this.drainFrames();
+            }
+            catch (err) {
+                this.emit('error', err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        this.emit('close', 0);
+        this.cleanup();
+    }
+    cleanup() {
+        this.filter?.close();
+        this.filter = null;
+        this.decoder?.close();
+        this.decoder = null;
+        // Release hardware context back to pool for reuse
+        releaseHardwareContext(this.hardware);
+        this.hardware = null;
+        this.formatContext = null;
+        this.stream = null;
+        this.queue = [];
+        this.pendingTimestamps = [];
+    }
+}
+//# sourceMappingURL=NodeAvVideoDecoder.js.map

package/dist/backends/node-av/video/NodeAvVideoDecoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAvVideoDecoder.js","sourceRoot":"","sources":["../../../../src/backends/node-av/video/NodeAvVideoDecoder.ts"],"names":[],"mappings":"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"}

package/dist/backends/node-av/video/NodeAvVideoEncoder.d.ts

@@ -0,0 +1,49 @@
+/**
+ * NodeAvVideoEncoder - Video encoder using node-av native bindings
+ *
+ * Implements the VideoEncoderBackend interface for encoding video frames
+ * using FFmpeg's libav* libraries via node-av.
+ */
+import { EventEmitter } from 'events';
+import { Frame } from 'node-av/lib';
+import type { VideoEncoderBackend, VideoEncoderBackendConfig } from '../../types.js';
+/**
+ * NodeAV-backed video encoder implementing VideoEncoderBackend interface
+ */
+export declare class NodeAvVideoEncoder extends EventEmitter implements VideoEncoderBackend {
+    private encoder;
+    private hardware;
+    private filter;
+    private config;
+    private frameIndex;
+    private queue;
+    private processing;
+    private processingPromise;
+    private shuttingDown;
+    private inputPixelFormat;
+    private encoderPixelFormat;
+    private timeBase;
+    private codecDescription;
+    private isHevcCodec;
+    private isAvcCodec;
+    private needsFormatConversion;
+    private needsRescaling;
+    private outputFormat;
+    private targetFormatName;
+    get isHealthy(): boolean;
+    startEncoder(config: VideoEncoderBackendConfig): void;
+    write(data: Buffer | Uint8Array, timestamp?: number, keyFrame?: boolean): boolean;
+    writeFrame(frame: Frame, timestamp?: number, keyFrame?: boolean): boolean;
+    end(): void;
+    kill(): void;
+    shutdown(): Promise<void>;
+    private processQueue;
+    private ensureEncoder;
+    private encodeBuffer;
+    private encodeFrame;
+    private createFrame;
+    private drainPackets;
+    private finish;
+    private cleanup;
+}
+//# sourceMappingURL=NodeAvVideoEncoder.d.ts.map

package/dist/backends/node-av/video/NodeAvVideoEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAvVideoEncoder.d.ts","sourceRoot":"","sources":["../../../../src/backends/node-av/video/NodeAvVideoEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAY,MAAM,aAAa,CAAC;AAO9C,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAwBxB;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAyG;IACtH,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAgD;IAChE,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,gBAAgB,CAAa;IAErC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI;IAYrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAWjF,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAUzE,GAAG,IAAI,IAAI;IAMX,IAAI,IAAI,IAAI;IAMN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAQjB,YAAY;YA8BZ,aAAa;YAqFb,YAAY;YAoBZ,WAAW;YAsBX,WAAW;YAuEX,YAAY;YAsBZ,MAAM;IAmBpB,OAAO,CAAC,OAAO;CAShB"}