webcodecs-node 0.7.2 → 0.7.5

package/dist/containers/NodeAvMuxer.js

@@ -0,0 +1,338 @@
+/**
+ * Node-av Muxer - Fast muxer using node-av's FormatContext API
+ *
+ * Uses node-av's low-level FormatContext API to provide a WebCodecs-compatible interface
+ * that accepts EncodedVideoChunk and EncodedAudioChunk objects. This is the fast path
+ * (~5ms muxing time) used by the main Muxer class.
+ */
+import { FormatContext, Packet, Rational, Demuxer as NodeAvDemuxerInternal, Muxer as NodeAvMuxerInternal, AV_CODEC_ID_H264, AV_CODEC_ID_HEVC, AV_CODEC_ID_VP8, AV_CODEC_ID_VP9, AV_CODEC_ID_AV1, AV_CODEC_ID_AAC, AV_CODEC_ID_OPUS, AV_CODEC_ID_MP3, AV_CODEC_ID_VORBIS, AV_CODEC_ID_FLAC, AVMEDIA_TYPE_VIDEO, AVMEDIA_TYPE_AUDIO, } from 'node-av';
+import { withTimeout, DEFAULT_TIMEOUTS } from '../utils/timeout.js';
+import { Logger } from '../utils/logger.js';
+import { inferFormat } from './muxer-types.js';
+const logger = new Logger('NodeAvMuxer');
+/**
+ * Maps WebCodecs codec strings to FFmpeg codec IDs
+ */
+function mapVideoCodecId(codec) {
+    const codecLower = codec.toLowerCase();
+    if (codecLower.startsWith('avc1') || codecLower.startsWith('avc3') || codecLower === 'h264') {
+        return AV_CODEC_ID_H264;
+    }
+    else if (codecLower.startsWith('hvc1') || codecLower.startsWith('hev1') || codecLower === 'hevc') {
+        return AV_CODEC_ID_HEVC;
+    }
+    else if (codecLower === 'vp8') {
+        return AV_CODEC_ID_VP8;
+    }
+    else if (codecLower.startsWith('vp09') || codecLower === 'vp9') {
+        return AV_CODEC_ID_VP9;
+    }
+    else if (codecLower.startsWith('av01') || codecLower === 'av1') {
+        return AV_CODEC_ID_AV1;
+    }
+    throw new Error(`Unsupported video codec: ${codec}`);
+}
+function mapAudioCodecId(codec) {
+    const codecLower = codec.toLowerCase();
+    if (codecLower.startsWith('mp4a') || codecLower === 'aac') {
+        return AV_CODEC_ID_AAC;
+    }
+    else if (codecLower === 'mp3') {
+        return AV_CODEC_ID_MP3;
+    }
+    else if (codecLower === 'opus') {
+        return AV_CODEC_ID_OPUS;
+    }
+    else if (codecLower === 'vorbis') {
+        return AV_CODEC_ID_VORBIS;
+    }
+    else if (codecLower === 'flac') {
+        return AV_CODEC_ID_FLAC;
+    }
+    throw new Error(`Unsupported audio codec: ${codec}`);
+}
+/**
+ * Node-av based muxer that accepts WebCodecs-compatible chunks
+ *
+ * Uses node-av's low-level FormatContext API for direct packet writing.
+ * This is the fast implementation (~5ms) used internally by the main Muxer class.
+ *
+ * @example
+ * ```typescript
+ * const muxer = new NodeAvMuxer({ path: 'output.mp4' });
+ * await muxer.open();
+ * await muxer.addVideoTrack({
+ *   codec: 'avc1.42001E',
+ *   codedWidth: 640,
+ *   codedHeight: 480,
+ *   framerate: 30,
+ *   description: spsNaluBuffer, // Optional: H.264 SPS/PPS
+ * });
+ *
+ * // Write encoded chunks from VideoEncoder
+ * await muxer.writeVideoChunk(chunk);
+ *
+ * await muxer.close();
+ * ```
+ */
+export class NodeAvMuxer {
+    formatContext = null;
+    config;
+    _videoStreamIndex = -1;
+    _audioStreamIndex = -1;
+    _videoConfig = null;
+    _audioConfig = null;
+    _videoChunkCount = 0;
+    _audioChunkCount = 0;
+    _headerWritten = false;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Open the muxer for writing
+     *
+     * @param timeout - Operation timeout in milliseconds (default: 15000)
+     */
+    async open(timeout = DEFAULT_TIMEOUTS.open) {
+        const format = this.config.format || inferFormat(this.config.path);
+        // Create and configure FormatContext
+        this.formatContext = new FormatContext();
+        this.formatContext.allocOutputContext2(null, format, this.config.path);
+        // Open output file
+        await withTimeout(this.formatContext.openOutput(this.config.path), timeout, `Muxer open (${this.config.path})`);
+    }
+    /**
+     * Add a video track to the output
+     *
+     * @param config - Video track configuration
+     * @returns Stream index for the video track
+     */
+    async addVideoTrack(config) {
+        if (!this.formatContext) {
+            throw new Error('Muxer not opened');
+        }
+        this._videoConfig = config;
+        const codecId = mapVideoCodecId(config.codec);
+        // Create a new stream
+        const stream = this.formatContext.newStream(null);
+        this._videoStreamIndex = stream.index;
+        // Set codec parameters on the stream
+        const cp = stream.codecpar;
+        cp.codecType = AVMEDIA_TYPE_VIDEO;
+        cp.codecId = codecId;
+        cp.width = config.codedWidth;
+        cp.height = config.codedHeight;
+        cp.bitRate = BigInt(config.bitrate || 1_000_000);
+        cp.format = 0; // YUV420P
+        // Set extradata if description is provided (SPS/PPS for H.264, etc.)
+        if (config.description && config.description.length > 0) {
+            cp.extradata = Buffer.from(config.description);
+        }
+        // Set stream time base to microseconds (WebCodecs uses microseconds)
+        stream.timeBase = new Rational(1, 1_000_000);
+        return this._videoStreamIndex;
+    }
+    /**
+     * Add an audio track to the output
+     *
+     * @param config - Audio track configuration
+     * @returns Stream index for the audio track
+     */
+    async addAudioTrack(config) {
+        if (!this.formatContext) {
+            throw new Error('Muxer not opened');
+        }
+        this._audioConfig = config;
+        const codecId = mapAudioCodecId(config.codec);
+        // Create a new stream
+        const stream = this.formatContext.newStream(null);
+        this._audioStreamIndex = stream.index;
+        // Set codec parameters on the stream
+        const cp = stream.codecpar;
+        cp.codecType = AVMEDIA_TYPE_AUDIO;
+        cp.codecId = codecId;
+        cp.sampleRate = config.sampleRate;
+        cp.channels = config.numberOfChannels;
+        cp.bitRate = BigInt(config.bitrate || 128_000);
+        // Set extradata if description is provided (AudioSpecificConfig for AAC, etc.)
+        if (config.description && config.description.length > 0) {
+            cp.extradata = Buffer.from(config.description);
+        }
+        // Set stream time base to microseconds (WebCodecs uses microseconds)
+        stream.timeBase = new Rational(1, 1_000_000);
+        return this._audioStreamIndex;
+    }
+    /**
+     * Write header if not already written
+     */
+    writeHeaderIfNeeded() {
+        if (!this._headerWritten && this.formatContext) {
+            const ret = this.formatContext.writeHeaderSync();
+            if (ret < 0) {
+                throw new Error(`Failed to write header: ${ret}`);
+            }
+            this._headerWritten = true;
+        }
+    }
+    /**
+     * Write an encoded video chunk to the output container
+     *
+     * @param chunk - EncodedVideoChunk from VideoEncoder
+     */
+    async writeVideoChunk(chunk) {
+        if (!this.formatContext || this._videoStreamIndex < 0) {
+            throw new Error('Video track not configured. Call addVideoTrack() first.');
+        }
+        // Write header on first chunk
+        this.writeHeaderIfNeeded();
+        // Get the output stream's actual time base (may differ from what we set)
+        const stream = this.formatContext.streams[this._videoStreamIndex];
+        const streamTimeBase = stream.timeBase;
+        // Create a proper node-av Packet from the chunk data
+        const packet = new Packet();
+        packet.alloc();
+        packet.data = Buffer.from(chunk._buffer);
+        // Convert timestamps from microseconds to stream timebase
+        const usToStreamTs = (us) => {
+            // ts_out = ts_in * (timebase_in / timebase_out)
+            // ts_out = us * (1/1000000) / (streamTimeBase.num / streamTimeBase.den)
+            // ts_out = us * streamTimeBase.den / (1000000 * streamTimeBase.num)
+            return BigInt(Math.round(us * streamTimeBase.den / (1_000_000 * streamTimeBase.num)));
+        };
+        packet.pts = usToStreamTs(chunk.timestamp);
+        packet.dts = usToStreamTs(chunk.timestamp);
+        if (chunk.duration) {
+            packet.duration = usToStreamTs(chunk.duration);
+        }
+        packet.streamIndex = this._videoStreamIndex;
+        packet.isKeyframe = chunk.type === 'key';
+        packet.timeBase = streamTimeBase;
+        const ret = this.formatContext.interleavedWriteFrameSync(packet);
+        packet.free();
+        if (ret < 0) {
+            throw new Error(`Failed to write video packet: ${ret}`);
+        }
+        this._videoChunkCount++;
+    }
+    /**
+     * Write an encoded audio chunk to the output container
+     *
+     * @param chunk - EncodedAudioChunk from AudioEncoder
+     */
+    async writeAudioChunk(chunk) {
+        if (!this.formatContext || this._audioStreamIndex < 0 || !this._audioConfig) {
+            throw new Error('Audio track not configured. Call addAudioTrack() first.');
+        }
+        // Write header on first chunk
+        this.writeHeaderIfNeeded();
+        // Get the output stream's actual time base (may differ from what we set)
+        const stream = this.formatContext.streams[this._audioStreamIndex];
+        const streamTimeBase = stream.timeBase;
+        // Create a proper node-av Packet from the chunk data
+        const packet = new Packet();
+        packet.alloc();
+        packet.data = Buffer.from(chunk._rawData);
+        // Convert timestamps from microseconds to stream timebase
+        // For audio, the stream timebase is typically 1/sampleRate
+        const usToStreamTs = (us) => {
+            // ts_out = ts_in * (timebase_in / timebase_out)
+            // ts_out = us * (1/1000000) / (streamTimeBase.num / streamTimeBase.den)
+            // ts_out = us * streamTimeBase.den / (1000000 * streamTimeBase.num)
+            return BigInt(Math.round(us * streamTimeBase.den / (1_000_000 * streamTimeBase.num)));
+        };
+        packet.pts = usToStreamTs(chunk.timestamp);
+        packet.dts = usToStreamTs(chunk.timestamp);
+        if (chunk.duration) {
+            packet.duration = usToStreamTs(chunk.duration);
+        }
+        packet.streamIndex = this._audioStreamIndex;
+        packet.isKeyframe = chunk.type === 'key';
+        packet.timeBase = streamTimeBase;
+        const ret = this.formatContext.interleavedWriteFrameSync(packet);
+        packet.free();
+        if (ret < 0) {
+            throw new Error(`Failed to write audio packet: ${ret}`);
+        }
+        this._audioChunkCount++;
+    }
+    /**
+     * Finalize and close the muxer
+     *
+     * @param timeout - Operation timeout in milliseconds (default: 10000)
+     */
+    async close(timeout = DEFAULT_TIMEOUTS.close) {
+        if (this.formatContext) {
+            // Write trailer
+            if (this._headerWritten) {
+                const ret = this.formatContext.writeTrailerSync();
+                if (ret < 0) {
+                    logger.warn(`writeTrailer returned error code ${ret}`);
+                }
+            }
+            // Close output and free context
+            await withTimeout(this.formatContext.closeOutput(), timeout, 'Muxer close output');
+            this.formatContext.freeContext();
+            this.formatContext = null;
+        }
+    }
+    /**
+     * Get the underlying FormatContext (for advanced use)
+     */
+    get native() {
+        return this.formatContext;
+    }
+    /**
+     * Get number of video chunks written
+     */
+    get videoChunkCount() {
+        return this._videoChunkCount;
+    }
+    /**
+     * Get number of audio chunks written
+     */
+    get audioChunkCount() {
+        return this._audioChunkCount;
+    }
+}
+/**
+ * Helper class for stream copy (remux) operations
+ * This copies encoded data from one container to another without re-encoding
+ */
+export class StreamCopier {
+    srcDemuxer = null;
+    dstMuxer = null;
+    /**
+     * Remux a file from one container format to another
+     * This performs a stream copy without re-encoding
+     */
+    static async remux(inputPath, outputPath, options) {
+        const demuxer = await NodeAvDemuxerInternal.open(inputPath);
+        const format = options?.format || inferFormat(outputPath);
+        const muxer = await NodeAvMuxerInternal.open(outputPath, { format });
+        const streamMap = new Map();
+        // Copy video stream
+        const videoStream = demuxer.video();
+        if (videoStream) {
+            const outIndex = muxer.addStream(videoStream);
+            streamMap.set(videoStream.index, outIndex);
+        }
+        // Copy audio stream
+        const audioStream = demuxer.audio();
+        if (audioStream) {
+            const outIndex = muxer.addStream(audioStream);
+            streamMap.set(audioStream.index, outIndex);
+        }
+        // Copy packets
+        for await (const packet of demuxer.packets()) {
+            if (!packet)
+                continue;
+            const outIndex = streamMap.get(packet.streamIndex);
+            if (outIndex !== undefined) {
+                await muxer.writePacket(packet, outIndex);
+            }
+        }
+        await demuxer.close();
+        await muxer.close();
+    }
+}
+//# sourceMappingURL=NodeAvMuxer.js.map

package/dist/containers/NodeAvMuxer.js.map

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

package/dist/containers/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/containers/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CA8CvF"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/containers/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CA8CvF"}

package/dist/containers/extract.js

@@ -5,6 +5,8 @@
  */
 import { Demuxer } from './Demuxer.js';
 import { VideoDecoder } from '../decoders/VideoDecoder.js';
+import { Logger } from '../utils/logger.js';
+const logger = new Logger('Extract');
 /**
  * Extract video frames from a container file as VideoFrame objects
  *
@@ -36,7 +38,7 @@ export async function* extractVideoFrames(inputPath) {
         output: (frame) => {
             frames.push(frame);
         },
-        error: (err) => console.error('Decode error:', err),
+        error: (err) => logger.error('Decode error:', err),
     });
     decoder.configure({
         codec: videoConfig.codec,

package/dist/containers/extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/containers/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,SAAiB;IACzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IAErB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;QAC/B,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO,CAAC,SAAS,CAAC;QAChB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,WAAW,EAAE,WAAW,CAAC,WAAW;KACrC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtB,2BAA2B;QAC3B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAC;QACxB,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/containers/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAErC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,SAAiB;IACzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IAErB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;QAC/B,MAAM,EAAE,CAAC,KAAiB,EAAE,EAAE;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC;KACnD,CAAC,CAAC;IAEH,OAAO,CAAC,SAAS,CAAC;QAChB,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,WAAW,EAAE,WAAW,CAAC,WAAW;KACrC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtB,2BAA2B;QAC3B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAC;QACxB,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/containers/index.d.ts

@@ -6,11 +6,7 @@
  *
  * @example
  * ```typescript
- * import { Demuxer, transcode, getMediaInfo } from 'webcodecs-node/containers';
- *
- * // Get media info
- * const info = await getMediaInfo('video.mp4');
- * console.log(info.video.codec, info.video.width, info.video.height);
+ * import { Demuxer, Muxer, muxChunks } from 'webcodecs-node/containers';
  *
  * // Demux video chunks for WebCodecs processing
  * const demuxer = new Demuxer({ path: 'video.mp4' });
@@ -20,20 +16,30 @@
  * }
  * await demuxer.close();
  *
- * // Transcode to different codec/settings
- * await transcode('input.mp4', 'output.mp4', {
- *   videoCodec: 'h264',
- *   videoBitrate: 1_000_000,
- * });
+ * // Mux encoded chunks to a file (with automatic fallback)
+ * const muxer = new Muxer({ path: 'output.mp4' });
+ * await muxer.open();
+ * await muxer.addVideoTrack({ codec: 'avc1.64001E', ... });
+ * // ... write chunks
+ * const result = await muxer.closeWithResult();
+ * console.log(`Used ${result.backend} in ${result.durationMs}ms`);
  *
- * // Remux to different container (no re-encoding)
- * await remux('input.mp4', 'output.mkv');
+ * // Or use the convenience function
+ * const result = await muxChunks({
+ *   path: 'output.mp4',
+ *   video: { config, chunks },
+ *   audio: { config, chunks },
+ * });
  * ```
  */
 export { Demuxer } from './Demuxer.js';
 export type { DemuxerConfig, VideoStreamConfig, AudioStreamConfig, VideoChunkCallback, AudioChunkCallback, } from './Demuxer.js';
-export { Muxer, StreamCopier } from './Muxer.js';
-export type { MuxerConfig, VideoTrackConfig, AudioTrackConfig } from './Muxer.js';
+export type { IMuxer, MuxerConfig, VideoTrackConfig, AudioTrackConfig, MuxResult, } from './muxer-types.js';
+export { MuxerError, inferFormat } from './muxer-types.js';
+export { Muxer, muxChunks } from './Muxer.js';
+export type { MuxerOptions } from './Muxer.js';
+export { NodeAvMuxer, StreamCopier } from './NodeAvMuxer.js';
+export { FFmpegMuxer } from './FFmpegMuxer.js';
 export { remux, transcode, getMediaInfo } from './transcode.js';
 export type { TranscodeOptions, TranscodeProgress, TranscodeResult, MediaInfo, VideoCodec, AudioCodec, HardwareAcceleration, } from './transcode.js';
 export { extractVideoFrames } from './extract.js';

package/dist/containers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/containers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/containers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG3D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/containers/index.js

@@ -6,11 +6,7 @@
  *
  * @example
  * ```typescript
- * import { Demuxer, transcode, getMediaInfo } from 'webcodecs-node/containers';
- *
- * // Get media info
- * const info = await getMediaInfo('video.mp4');
- * console.log(info.video.codec, info.video.width, info.video.height);
+ * import { Demuxer, Muxer, muxChunks } from 'webcodecs-node/containers';
  *
  * // Demux video chunks for WebCodecs processing
  * const demuxer = new Demuxer({ path: 'video.mp4' });
@@ -20,20 +16,31 @@
  * }
  * await demuxer.close();
  *
- * // Transcode to different codec/settings
- * await transcode('input.mp4', 'output.mp4', {
- *   videoCodec: 'h264',
- *   videoBitrate: 1_000_000,
- * });
+ * // Mux encoded chunks to a file (with automatic fallback)
+ * const muxer = new Muxer({ path: 'output.mp4' });
+ * await muxer.open();
+ * await muxer.addVideoTrack({ codec: 'avc1.64001E', ... });
+ * // ... write chunks
+ * const result = await muxer.closeWithResult();
+ * console.log(`Used ${result.backend} in ${result.durationMs}ms`);
  *
- * // Remux to different container (no re-encoding)
- * await remux('input.mp4', 'output.mkv');
+ * // Or use the convenience function
+ * const result = await muxChunks({
+ *   path: 'output.mp4',
+ *   video: { config, chunks },
+ *   audio: { config, chunks },
+ * });
  * ```
  */
 // Demuxer
 export { Demuxer } from './Demuxer.js';
-// Muxer
-export { Muxer, StreamCopier } from './Muxer.js';
+export { MuxerError, inferFormat } from './muxer-types.js';
+// Main Muxer (with automatic fallback - recommended)
+export { Muxer, muxChunks } from './Muxer.js';
+// Node-av Muxer (fast, direct implementation)
+export { NodeAvMuxer, StreamCopier } from './NodeAvMuxer.js';
+// FFmpeg Muxer (subprocess-based, more compatible)
+export { FFmpegMuxer } from './FFmpegMuxer.js';
 // Transcoding utilities
 export { remux, transcode, getMediaInfo } from './transcode.js';
 // Frame extraction

package/dist/containers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/containers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGjD,wBAAwB;AACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAWhE,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/containers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiBvC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,qDAAqD;AACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG9C,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,wBAAwB;AACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAWhE,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/containers/muxer-types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Shared types and interfaces for muxers
+ *
+ * This module defines common interfaces that both NodeAvMuxer and FFmpegSpawnMuxer
+ * implement, enabling a clean fallback mechanism.
+ */
+import type { EncodedVideoChunk } from '../core/EncodedVideoChunk.js';
+import type { EncodedAudioChunk } from '../core/EncodedAudioChunk.js';
+/**
+ * Video track configuration for muxing
+ */
+export interface VideoTrackConfig {
+    /** WebCodecs codec string (e.g., 'avc1.64001E', 'hvc1.1.6.L93.B0') */
+    codec: string;
+    /** Video width in pixels */
+    codedWidth: number;
+    /** Video height in pixels */
+    codedHeight: number;
+    /** Frame rate (optional, used for timing) */
+    framerate?: number;
+    /** Target bitrate in bits/second (optional, for container hints) */
+    bitrate?: number;
+    /** Codec-specific description (SPS/PPS for H.264, etc.) */
+    description?: Uint8Array;
+}
+/**
+ * Audio track configuration for muxing
+ */
+export interface AudioTrackConfig {
+    /** WebCodecs codec string (e.g., 'mp4a.40.2', 'opus') */
+    codec: string;
+    /** Sample rate in Hz */
+    sampleRate: number;
+    /** Number of audio channels */
+    numberOfChannels: number;
+    /** Target bitrate in bits/second (optional) */
+    bitrate?: number;
+    /** Codec-specific description (AudioSpecificConfig for AAC, etc.) */
+    description?: Uint8Array;
+}
+/**
+ * Muxer configuration
+ */
+export interface MuxerConfig {
+    /** Path to the output file */
+    path: string;
+    /** Container format (mp4, webm, mkv) - inferred from extension if not specified */
+    format?: string;
+}
+/**
+ * Result of a muxing operation
+ */
+export interface MuxResult {
+    /** Path to the output file */
+    path: string;
+    /** Number of video chunks written */
+    videoChunkCount: number;
+    /** Number of audio chunks written */
+    audioChunkCount: number;
+    /** Time taken for muxing in milliseconds */
+    durationMs: number;
+    /** Which muxer backend was used */
+    backend: 'node-av' | 'ffmpeg-spawn';
+}
+/**
+ * Common interface for all muxer implementations
+ */
+export interface IMuxer {
+    /**
+     * Open the muxer for writing
+     */
+    open(timeout?: number): Promise<void>;
+    /**
+     * Add a video track to the output
+     * @returns Stream index for the video track
+     */
+    addVideoTrack(config: VideoTrackConfig): Promise<number>;
+    /**
+     * Add an audio track to the output
+     * @returns Stream index for the audio track
+     */
+    addAudioTrack(config: AudioTrackConfig): Promise<number>;
+    /**
+     * Write an encoded video chunk
+     */
+    writeVideoChunk(chunk: EncodedVideoChunk): Promise<void>;
+    /**
+     * Write an encoded audio chunk
+     */
+    writeAudioChunk(chunk: EncodedAudioChunk): Promise<void>;
+    /**
+     * Finalize and close the muxer
+     */
+    close(timeout?: number): Promise<void>;
+    /**
+     * Get number of video chunks written
+     */
+    readonly videoChunkCount: number;
+    /**
+     * Get number of audio chunks written
+     */
+    readonly audioChunkCount: number;
+}
+/**
+ * Muxer error with additional context
+ */
+export declare class MuxerError extends Error {
+    readonly backend: 'node-av' | 'ffmpeg-spawn';
+    readonly operation: 'open' | 'addTrack' | 'write' | 'close';
+    readonly cause?: Error | undefined;
+    constructor(message: string, backend: 'node-av' | 'ffmpeg-spawn', operation: 'open' | 'addTrack' | 'write' | 'close', cause?: Error | undefined);
+}
+/**
+ * Infer container format from file extension
+ */
+export declare function inferFormat(path: string): string;
+//# sourceMappingURL=muxer-types.d.ts.map

package/dist/containers/muxer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muxer-types.d.ts","sourceRoot":"","sources":["../../src/containers/muxer-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,OAAO,EAAE,SAAS,GAAG,cAAc;aACnC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO;aAClD,KAAK,CAAC,EAAE,KAAK;gBAH7B,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,SAAS,GAAG,cAAc,EACnC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,EAClD,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBhD"}