webcodecs-node 0.3.0 → 0.5.1

package/dist/containers/Demuxer.js

@@ -0,0 +1,256 @@
+/**
+ * Container Demuxer - Extracts encoded chunks from container files (MP4, WebM, MKV)
+ *
+ * Wraps node-av's Demuxer to provide a WebCodecs-compatible interface that outputs
+ * EncodedVideoChunk and EncodedAudioChunk objects.
+ */
+import { Demuxer as NodeAvDemuxer } from 'node-av';
+import { EncodedVideoChunk } from '../core/EncodedVideoChunk.js';
+import { EncodedAudioChunk } from '../core/EncodedAudioChunk.js';
+import { withTimeout, DEFAULT_TIMEOUTS } from '../utils/timeout.js';
+/**
+ * Maps FFmpeg codec IDs to WebCodecs codec strings
+ */
+function mapVideoCodecId(codecId, extradata) {
+    // Common FFmpeg codec IDs
+    switch (codecId) {
+        case 27: // AV_CODEC_ID_H264
+            // Try to extract profile/level from extradata
+            if (extradata && extradata.length >= 4) {
+                const profile = extradata[1];
+                const constraints = extradata[2];
+                const level = extradata[3];
+                return `avc1.${profile.toString(16).padStart(2, '0')}${constraints.toString(16).padStart(2, '0')}${level.toString(16).padStart(2, '0')}`;
+            }
+            return 'avc1.42001E'; // Baseline level 3.0 default
+        case 173: // AV_CODEC_ID_HEVC
+            return 'hvc1.1.6.L93.B0';
+        case 225: // AV_CODEC_ID_VP8
+            return 'vp8';
+        case 167: // AV_CODEC_ID_VP9
+            return 'vp09.00.10.08';
+        case 226: // AV_CODEC_ID_AV1
+            return 'av01.0.01M.08';
+        default:
+            return `unknown-${codecId}`;
+    }
+}
+function mapAudioCodecId(codecId) {
+    switch (codecId) {
+        case 86018: // AV_CODEC_ID_AAC
+            return 'mp4a.40.2';
+        case 86017: // AV_CODEC_ID_MP3
+            return 'mp3';
+        case 86076: // AV_CODEC_ID_OPUS
+            return 'opus';
+        case 86028: // AV_CODEC_ID_VORBIS
+            return 'vorbis';
+        case 86030: // AV_CODEC_ID_FLAC
+            return 'flac';
+        default:
+            return `unknown-${codecId}`;
+    }
+}
+/**
+ * Container demuxer that outputs WebCodecs-compatible chunks
+ */
+export class Demuxer {
+    demuxer = null;
+    path;
+    _videoConfig = null;
+    _audioConfig = null;
+    _videoStreamIndex = -1;
+    _audioStreamIndex = -1;
+    _videoTimeBase = null;
+    _audioTimeBase = null;
+    constructor(config) {
+        this.path = config.path;
+    }
+    /**
+     * Open the container file and parse stream information
+     */
+    async open(timeout = DEFAULT_TIMEOUTS.open) {
+        this.demuxer = await withTimeout(NodeAvDemuxer.open(this.path), timeout, `Demuxer open (${this.path})`);
+        // Extract video stream info
+        const videoStream = this.demuxer.video();
+        if (videoStream) {
+            this._videoStreamIndex = videoStream.index;
+            this._videoTimeBase = {
+                num: videoStream.timeBase.num,
+                den: videoStream.timeBase.den,
+            };
+            const cp = videoStream.codecpar;
+            this._videoConfig = {
+                codec: mapVideoCodecId(cp.codecId, cp.extradata),
+                codedWidth: cp.width,
+                codedHeight: cp.height,
+                description: cp.extradata ? new Uint8Array(cp.extradata) : undefined,
+            };
+        }
+        // Extract audio stream info
+        const audioStream = this.demuxer.audio();
+        if (audioStream) {
+            this._audioStreamIndex = audioStream.index;
+            this._audioTimeBase = {
+                num: audioStream.timeBase.num,
+                den: audioStream.timeBase.den,
+            };
+            const cp = audioStream.codecpar;
+            this._audioConfig = {
+                codec: mapAudioCodecId(cp.codecId),
+                sampleRate: cp.sampleRate,
+                numberOfChannels: cp.channels,
+                description: cp.extradata ? new Uint8Array(cp.extradata) : undefined,
+            };
+        }
+    }
+    /**
+     * Get video stream configuration (null if no video stream)
+     */
+    get videoConfig() {
+        return this._videoConfig;
+    }
+    /**
+     * Get audio stream configuration (null if no audio stream)
+     */
+    get audioConfig() {
+        return this._audioConfig;
+    }
+    /**
+     * Get container format name (e.g., "mp4", "webm")
+     */
+    get format() {
+        return this.demuxer?.formatName;
+    }
+    /**
+     * Get duration in seconds
+     */
+    get duration() {
+        return this.demuxer?.duration;
+    }
+    /**
+     * Convert timestamp from stream time base to microseconds
+     */
+    toMicroseconds(pts, timeBase) {
+        const ptsNum = typeof pts === 'bigint' ? Number(pts) : pts;
+        return Math.round((ptsNum * timeBase.num * 1_000_000) / timeBase.den);
+    }
+    /**
+     * Iterate over video chunks
+     */
+    async *videoChunks() {
+        if (!this.demuxer || this._videoStreamIndex < 0 || !this._videoConfig || !this._videoTimeBase) {
+            return;
+        }
+        for await (const packet of this.demuxer.packets()) {
+            if (!packet || !packet.data)
+                continue;
+            if (packet.streamIndex === this._videoStreamIndex) {
+                const timestamp = this.toMicroseconds(packet.pts, this._videoTimeBase);
+                const duration = packet.duration
+                    ? this.toMicroseconds(packet.duration, this._videoTimeBase)
+                    : undefined;
+                const chunk = new EncodedVideoChunk({
+                    type: packet.isKeyframe ? 'key' : 'delta',
+                    timestamp,
+                    duration,
+                    data: new Uint8Array(packet.data),
+                });
+                yield chunk;
+            }
+        }
+    }
+    /**
+     * Iterate over audio chunks
+     */
+    async *audioChunks() {
+        if (!this.demuxer || this._audioStreamIndex < 0 || !this._audioConfig || !this._audioTimeBase) {
+            return;
+        }
+        for await (const packet of this.demuxer.packets()) {
+            if (!packet || !packet.data)
+                continue;
+            if (packet.streamIndex === this._audioStreamIndex) {
+                const timestamp = this.toMicroseconds(packet.pts, this._audioTimeBase);
+                const duration = packet.duration
+                    ? this.toMicroseconds(packet.duration, this._audioTimeBase)
+                    : undefined;
+                const chunk = new EncodedAudioChunk({
+                    type: packet.isKeyframe ? 'key' : 'delta',
+                    timestamp,
+                    duration,
+                    data: new Uint8Array(packet.data),
+                });
+                yield chunk;
+            }
+        }
+    }
+    /**
+     * Iterate over all chunks (video and audio interleaved)
+     * Returns both the chunk and its type/config for proper routing
+     */
+    async *chunks() {
+        if (!this.demuxer) {
+            return;
+        }
+        for await (const packet of this.demuxer.packets()) {
+            if (!packet || !packet.data)
+                continue;
+            if (packet.streamIndex === this._videoStreamIndex && this._videoConfig && this._videoTimeBase) {
+                const timestamp = this.toMicroseconds(packet.pts, this._videoTimeBase);
+                const duration = packet.duration
+                    ? this.toMicroseconds(packet.duration, this._videoTimeBase)
+                    : undefined;
+                const chunk = new EncodedVideoChunk({
+                    type: packet.isKeyframe ? 'key' : 'delta',
+                    timestamp,
+                    duration,
+                    data: new Uint8Array(packet.data),
+                });
+                yield { type: 'video', chunk, config: this._videoConfig };
+            }
+            else if (packet.streamIndex === this._audioStreamIndex && this._audioConfig && this._audioTimeBase) {
+                const timestamp = this.toMicroseconds(packet.pts, this._audioTimeBase);
+                const duration = packet.duration
+                    ? this.toMicroseconds(packet.duration, this._audioTimeBase)
+                    : undefined;
+                const chunk = new EncodedAudioChunk({
+                    type: packet.isKeyframe ? 'key' : 'delta',
+                    timestamp,
+                    duration,
+                    data: new Uint8Array(packet.data),
+                });
+                yield { type: 'audio', chunk, config: this._audioConfig };
+            }
+        }
+    }
+    /**
+     * Demux all chunks with callbacks (alternative API)
+     */
+    async demux(options) {
+        for await (const item of this.chunks()) {
+            if (item.type === 'video' && options.onVideoChunk) {
+                options.onVideoChunk(item.chunk, item.config);
+            }
+            else if (item.type === 'audio' && options.onAudioChunk) {
+                options.onAudioChunk(item.chunk, item.config);
+            }
+        }
+    }
+    /**
+     * Close the demuxer and release resources
+     */
+    async close() {
+        if (this.demuxer) {
+            await this.demuxer.close();
+            this.demuxer = null;
+        }
+    }
+    /**
+     * Get the underlying node-av demuxer (for advanced use)
+     */
+    get native() {
+        return this.demuxer;
+    }
+}
+//# sourceMappingURL=Demuxer.js.map

package/dist/containers/Demuxer.js.map

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

package/dist/containers/Muxer.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Container Muxer - Writes encoded chunks to container files (MP4, WebM, MKV)
+ *
+ * Wraps node-av's Muxer to provide a WebCodecs-compatible interface that accepts
+ * EncodedVideoChunk and EncodedAudioChunk objects.
+ */
+import { Muxer as NodeAvMuxer } from 'node-av';
+import { EncodedVideoChunk } from '../core/EncodedVideoChunk.js';
+import { EncodedAudioChunk } from '../core/EncodedAudioChunk.js';
+/**
+ * Video track configuration for muxing
+ */
+export interface VideoTrackConfig {
+    codec: string;
+    codedWidth: number;
+    codedHeight: number;
+    framerate?: number;
+    bitrate?: number;
+    description?: Uint8Array;
+}
+/**
+ * Audio track configuration for muxing
+ */
+export interface AudioTrackConfig {
+    codec: string;
+    sampleRate: number;
+    numberOfChannels: number;
+    bitrate?: number;
+    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;
+}
+/**
+ * Container muxer that accepts WebCodecs-compatible chunks
+ *
+ * @example
+ * ```typescript
+ * const muxer = new Muxer({ 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
+ * encoder.configure({ codec: 'avc1.42001E', ... });
+ * encoder.encode(frame);
+ * // In output callback:
+ * await muxer.writeVideoChunk(chunk);
+ *
+ * await muxer.close();
+ * ```
+ */
+export declare class Muxer {
+    private muxer;
+    private config;
+    private _videoStreamIndex;
+    private _audioStreamIndex;
+    private _videoEncoder;
+    private _audioEncoder;
+    private _videoConfig;
+    private _audioConfig;
+    private _videoChunkCount;
+    private _audioChunkCount;
+    constructor(config: MuxerConfig);
+    /**
+     * Open the muxer for writing
+     *
+     * @param timeout - Operation timeout in milliseconds (default: 15000)
+     */
+    open(timeout?: number): Promise<void>;
+    /**
+     * Add a video track to the output
+     *
+     * @param config - Video track configuration
+     * @returns Stream index for the video track
+     */
+    addVideoTrack(config: VideoTrackConfig): Promise<number>;
+    /**
+     * Add an audio track to the output
+     *
+     * @param config - Audio track configuration
+     * @returns Stream index for the audio track
+     */
+    addAudioTrack(config: AudioTrackConfig): Promise<number>;
+    /**
+     * Write an encoded video chunk to the output container
+     *
+     * @param chunk - EncodedVideoChunk from VideoEncoder
+     */
+    writeVideoChunk(chunk: EncodedVideoChunk): Promise<void>;
+    /**
+     * Write an encoded audio chunk to the output container
+     *
+     * @param chunk - EncodedAudioChunk from AudioEncoder
+     */
+    writeAudioChunk(chunk: EncodedAudioChunk): Promise<void>;
+    /**
+     * Finalize and close the muxer
+     *
+     * @param timeout - Operation timeout in milliseconds (default: 10000)
+     */
+    close(timeout?: number): Promise<void>;
+    /**
+     * Get the underlying node-av muxer (for advanced use)
+     */
+    get native(): NodeAvMuxer | null;
+    /**
+     * Get number of video chunks written
+     */
+    get videoChunkCount(): number;
+    /**
+     * Get number of audio chunks written
+     */
+    get audioChunkCount(): number;
+}
+/**
+ * Helper class for stream copy (remux) operations
+ * This copies encoded data from one container to another without re-encoding
+ */
+export declare class StreamCopier {
+    private srcDemuxer;
+    private dstMuxer;
+    /**
+     * Remux a file from one container format to another
+     * This performs a stream copy without re-encoding
+     */
+    static remux(inputPath: string, outputPath: string, options?: {
+        format?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=Muxer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Muxer.d.ts","sourceRoot":"","sources":["../../src/containers/Muxer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,IAAI,WAAW,EAerB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;AA6DD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,EAAE,WAAW;IAI/B;;;;OAIG;IACG,IAAI,CAAC,OAAO,GAAE,MAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IA2B9D;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB9D;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D;;;;OAIG;IACG,KAAK,CAAC,OAAO,GAAE,MAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpE;;OAEG;IACH,IAAI,MAAM,IAAI,WAAW,GAAG,IAAI,CAE/B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;CACF;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;OAGG;WACU,KAAK,CAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC,IAAI,CAAC;CAiCjB"}