webcodecs-node 0.2.2 → 0.5.0

package/dist/node-av/NodeAvVideoDecoder.js

@@ -0,0 +1,365 @@
+/**
+ * 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_CODEC_ID_H264, AV_CODEC_ID_HEVC, AV_CODEC_ID_VP8, AV_CODEC_ID_VP9, AV_CODEC_ID_AV1, AV_PIX_FMT_BGRA, AV_PIX_FMT_BGR0, AV_PIX_FMT_NV12, AV_PIX_FMT_RGBA, AV_PIX_FMT_RGB0, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUVA420P, } from 'node-av/constants';
+import { DEFAULT_FRAMERATE } from '../backends/types.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';
+const logger = createLogger('NodeAvVideoDecoder');
+/** Maximum filter chain fallback attempts */
+const MAX_FILTER_CHAIN_ATTEMPTS = 10;
+/** Known problematic hardware decoders */
+const SKIP_HARDWARE_CODECS = ['vp9', 'av1'];
+/**
+ * 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;
+    packetTimeBase = new Rational(1, DEFAULT_FRAMERATE);
+    outputPixelFormat = AV_PIX_FMT_YUV420P;
+    filterDescription = null;
+    hardwarePreference = 'no-preference';
+    get isHealthy() {
+        return !this.shuttingDown;
+    }
+    startDecoder(config) {
+        this.config = { ...config };
+        const framerate = config.framerate ?? DEFAULT_FRAMERATE;
+        this.packetTimeBase = new Rational(1, framerate);
+        this.outputPixelFormat = mapPixelFormat(config.outputPixelFormat ?? 'yuv420p');
+        this.hardwarePreference = config.hardwareAcceleration ?? 'no-preference';
+    }
+    write(data) {
+        if (!this.config || this.shuttingDown) {
+            return false;
+        }
+        this.queue.push(Buffer.from(data));
+        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 data = 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(data);
+                }
+            }
+            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;
+        params.width = this.config.width;
+        params.height = this.config.height;
+        if (this.config.description) {
+            params.extradata = Buffer.from(this.config.description);
+        }
+        // Only try hardware if explicitly requested and not a known problematic codec
+        const shouldTryHardware = this.hardwarePreference === 'prefer-hardware' &&
+            !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) {
+        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;
+        packet.pts = BigInt(this.packetIndex);
+        packet.dts = BigInt(this.packetIndex);
+        packet.timeBase = this.packetTimeBase;
+        packet.data = buffer;
+        packet.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;
+            }
+            const output = await this.toOutput(frame);
+            if (!output.nativeFrame) {
+                frame.unref();
+            }
+            if (output.buffer) {
+                this.emit('frame', output.buffer);
+            }
+            else if (output.nativeFrame) {
+                this.emit('frame', { nativeFrame: output.nativeFrame, format: this.outputPixelFormat });
+            }
+            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 = [];
+    }
+}
+function mapCodecId(codec) {
+    switch (codec.toLowerCase()) {
+        case 'h264':
+            return AV_CODEC_ID_H264;
+        case 'hevc':
+        case 'h265':
+            return AV_CODEC_ID_HEVC;
+        case 'vp8':
+            return AV_CODEC_ID_VP8;
+        case 'vp9':
+            return AV_CODEC_ID_VP9;
+        case 'av1':
+            return AV_CODEC_ID_AV1;
+        default:
+            return null;
+    }
+}
+function mapPixelFormat(format) {
+    const fmt = format.toUpperCase();
+    switch (fmt) {
+        case 'I420':
+        case 'YUV420P':
+            return AV_PIX_FMT_YUV420P;
+        case 'I420A':
+        case 'YUVA420P':
+            return AV_PIX_FMT_YUVA420P;
+        case 'I422':
+        case 'YUV422P':
+            return AV_PIX_FMT_YUV422P;
+        case 'I444':
+        case 'YUV444P':
+            return AV_PIX_FMT_YUV444P;
+        case 'NV12':
+            return AV_PIX_FMT_NV12;
+        case 'BGRA':
+            return AV_PIX_FMT_BGRA;
+        case 'BGRX':
+            return AV_PIX_FMT_BGR0;
+        case 'RGBA':
+            return AV_PIX_FMT_RGBA;
+        case 'RGBX':
+            return AV_PIX_FMT_RGB0;
+        default:
+            return AV_PIX_FMT_YUV420P;
+    }
+}
+function pixelFormatToFFmpegName(fmt) {
+    switch (fmt) {
+        case AV_PIX_FMT_BGRA:
+            return 'bgra';
+        case AV_PIX_FMT_BGR0:
+            return 'bgr0';
+        case AV_PIX_FMT_RGBA:
+            return 'rgba';
+        case AV_PIX_FMT_RGB0:
+            return 'rgb0';
+        case AV_PIX_FMT_NV12:
+            return 'nv12';
+        case AV_PIX_FMT_YUV422P:
+            return 'yuv422p';
+        case AV_PIX_FMT_YUV444P:
+            return 'yuv444p';
+        case AV_PIX_FMT_YUVA420P:
+            return 'yuva420p';
+        case AV_PIX_FMT_YUV420P:
+        default:
+            return 'yuv420p';
+    }
+}
+//# sourceMappingURL=NodeAvVideoDecoder.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * 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 '../backends/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 needsFormatConversion;
+    get isHealthy(): boolean;
+    startEncoder(config: VideoEncoderBackendConfig): void;
+    write(data: Buffer | Uint8Array): boolean;
+    writeFrame(frame: Frame): boolean;
+    end(): void;
+    kill(): void;
+    shutdown(): Promise<void>;
+    private processQueue;
+    private ensureEncoder;
+    private configurePixelFormat;
+    /**
+     * Build GPU-accelerated filter chain for format conversion
+     * Returns null if no GPU filter is available for this hardware type
+     */
+    private buildGpuFilterChain;
+    private selectEncoderCodec;
+    private buildEncoderOptions;
+    private configureVpxOptions;
+    private configureSvtAv1Options;
+    private configureX26xOptions;
+    private encodeBuffer;
+    private encodeFrame;
+    private createFrame;
+    private drainPackets;
+    private finish;
+    private cleanup;
+}
+//# sourceMappingURL=NodeAvVideoEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAvVideoEncoder.d.ts","sourceRoot":"","sources":["../../src/node-av/NodeAvVideoEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAY,MAAM,aAAa,CAAC;AAc9C,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAE1B,MAAM,sBAAsB,CAAC;AA4E9B;;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,CAAkE;IAC/E,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,qBAAqB,CAAS;IAEtC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI;IAOrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO;IAUzC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAUjC,GAAG,IAAI,IAAI;IAMX,IAAI,IAAI,IAAI;IAMN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAQjB,YAAY;YAgCZ,aAAa;IAoC3B,OAAO,CAAC,oBAAoB;IA0C5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YAgBb,kBAAkB;IA8BhC,OAAO,CAAC,mBAAmB;IA4C3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,oBAAoB;YAgBd,YAAY;YAgBZ,WAAW;YAkBX,WAAW;YAgEX,YAAY;YA+CZ,MAAM;IAmBpB,OAAO,CAAC,OAAO;CAUhB"}