webcodecs-node 0.7.2 → 0.8.5

package/dist/backends/node-av/audio/encoder/channel-layout.js

@@ -0,0 +1,24 @@
+/**
+ * Channel layout utilities for audio encoding
+ */
+import { AV_CHANNEL_ORDER_NATIVE, AV_CH_LAYOUT_MONO, AV_CH_LAYOUT_STEREO, AV_CH_LAYOUT_5POINT1, AV_CH_LAYOUT_7POINT1, } from 'node-av/constants';
+/**
+ * Get channel layout for the given number of channels
+ */
+export function getChannelLayout(numChannels) {
+    // Standard channel layouts as ChannelLayout objects
+    // Order 1 = AV_CHANNEL_ORDER_NATIVE (required for FFmpeg)
+    switch (numChannels) {
+        case 1:
+            return { nbChannels: 1, order: AV_CHANNEL_ORDER_NATIVE, mask: AV_CH_LAYOUT_MONO };
+        case 2:
+            return { nbChannels: 2, order: AV_CHANNEL_ORDER_NATIVE, mask: AV_CH_LAYOUT_STEREO };
+        case 6:
+            return { nbChannels: 6, order: AV_CHANNEL_ORDER_NATIVE, mask: AV_CH_LAYOUT_5POINT1 };
+        case 8:
+            return { nbChannels: 8, order: AV_CHANNEL_ORDER_NATIVE, mask: AV_CH_LAYOUT_7POINT1 };
+        default:
+            return { nbChannels: numChannels, order: AV_CHANNEL_ORDER_NATIVE, mask: BigInt((1 << numChannels) - 1) };
+    }
+}
+//# sourceMappingURL=channel-layout.js.map

package/dist/backends/node-av/audio/encoder/channel-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-layout.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/channel-layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,oDAAoD;IACpD,0DAA0D;IAC1D,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,CAAC;YACJ,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QACpF,KAAK,CAAC;YACJ,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QACtF,KAAK,CAAC;YACJ,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACvF,KAAK,CAAC;YACJ,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACvF;YACE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IAC7G,CAAC;AACH,CAAC"}

package/dist/backends/node-av/audio/encoder/codec-description.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Audio codec description utilities
+ *
+ * Extracts and generates codec-specific description data (extradata)
+ * for AAC, Opus, FLAC, and Vorbis codecs.
+ */
+import type { Encoder } from 'node-av/api';
+/**
+ * Generate OpusHead (Identification Header) per RFC 7845 Section 5.1
+ * Used when FFmpeg doesn't provide extradata for Opus encoding
+ */
+export declare function generateOpusHead(channels: number, inputSampleRate: number): Buffer;
+/**
+ * Build FLAC description from extradata
+ * Prepends 'fLaC' magic and STREAMINFO block header
+ */
+export declare function buildFlacDescription(extraData: Uint8Array): Buffer;
+export interface CodecDescriptionContext {
+    codec: string;
+    numberOfChannels: number;
+    inputSampleRate: number;
+}
+/**
+ * Extract codec description (extradata) from encoder
+ *
+ * Different codecs have different description formats:
+ * - AAC: AudioSpecificConfig
+ * - Opus: OpusHead (Identification Header)
+ * - FLAC: fLaC magic + STREAMINFO block
+ * - Vorbis: identification + comment + setup headers
+ */
+export declare function extractCodecDescription(encoder: Encoder, context: CodecDescriptionContext): Buffer | null;
+//# sourceMappingURL=codec-description.d.ts.map

package/dist/backends/node-av/audio/encoder/codec-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-description.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/codec-description.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,MAAM,CAmER;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAKlE;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,GAC/B,MAAM,GAAG,IAAI,CAkDf"}

package/dist/backends/node-av/audio/encoder/codec-description.js

@@ -0,0 +1,137 @@
+/**
+ * Audio codec description utilities
+ *
+ * Extracts and generates codec-specific description data (extradata)
+ * for AAC, Opus, FLAC, and Vorbis codecs.
+ */
+import { createLogger } from '../../../../utils/logger.js';
+const logger = createLogger('audio-codec-description');
+/**
+ * Generate OpusHead (Identification Header) per RFC 7845 Section 5.1
+ * Used when FFmpeg doesn't provide extradata for Opus encoding
+ */
+export function generateOpusHead(channels, inputSampleRate) {
+    const sampleRate = inputSampleRate || 48000;
+    // OpusHead structure:
+    // - Magic Signature: "OpusHead" (8 bytes)
+    // - Version: 1 (1 byte)
+    // - Channel Count (1 byte)
+    // - Pre-skip: samples to skip at start (2 bytes, LE) - 312 is typical for 48kHz
+    // - Input Sample Rate (4 bytes, LE) - original sample rate
+    // - Output Gain: 0 dB (2 bytes, LE)
+    // - Channel Mapping Family (1 byte) - 0 for mono/stereo
+    const preSkip = 312;
+    const outputGain = 0;
+    const mappingFamily = channels <= 2 ? 0 : 1;
+    let headerSize = 19; // Base header size for mapping family 0
+    if (mappingFamily > 0) {
+        headerSize += 2 + channels;
+    }
+    const header = Buffer.alloc(headerSize);
+    let offset = 0;
+    // Magic Signature
+    header.write('OpusHead', offset);
+    offset += 8;
+    // Version
+    header.writeUInt8(1, offset);
+    offset += 1;
+    // Channel Count
+    header.writeUInt8(channels, offset);
+    offset += 1;
+    // Pre-skip (little-endian)
+    header.writeUInt16LE(preSkip, offset);
+    offset += 2;
+    // Input Sample Rate (little-endian)
+    header.writeUInt32LE(sampleRate, offset);
+    offset += 4;
+    // Output Gain (little-endian)
+    header.writeInt16LE(outputGain, offset);
+    offset += 2;
+    // Channel Mapping Family
+    header.writeUInt8(mappingFamily, offset);
+    offset += 1;
+    // For mapping family > 0, add stream info and channel mapping
+    if (mappingFamily > 0) {
+        const streamCount = channels > 2 ? Math.ceil(channels / 2) : 1;
+        const coupledCount = channels > 2 ? Math.floor(channels / 2) : 0;
+        header.writeUInt8(streamCount, offset);
+        offset += 1;
+        header.writeUInt8(coupledCount, offset);
+        offset += 1;
+        // Channel mapping (identity mapping)
+        for (let i = 0; i < channels; i++) {
+            header.writeUInt8(i, offset);
+            offset += 1;
+        }
+    }
+    return header;
+}
+/**
+ * Build FLAC description from extradata
+ * Prepends 'fLaC' magic and STREAMINFO block header
+ */
+export function buildFlacDescription(extraData) {
+    const magic = Buffer.from('fLaC');
+    // STREAMINFO block header: type (0x00) | last-block flag (0x80)
+    const blockHeader = Buffer.from([0x80, 0x00, 0x00, extraData.length]);
+    return Buffer.concat([magic, blockHeader, Buffer.from(extraData)]);
+}
+/**
+ * Extract codec description (extradata) from encoder
+ *
+ * Different codecs have different description formats:
+ * - AAC: AudioSpecificConfig
+ * - Opus: OpusHead (Identification Header)
+ * - FLAC: fLaC magic + STREAMINFO block
+ * - Vorbis: identification + comment + setup headers
+ */
+export function extractCodecDescription(encoder, context) {
+    const codecBase = context.codec.split('.')[0].toLowerCase();
+    try {
+        const ctx = encoder.getCodecContext();
+        if (!ctx)
+            return null;
+        const extraData = ctx.extraData;
+        if (codecBase === 'mp4a' || codecBase === 'aac') {
+            if (!extraData || extraData.length === 0)
+                return null;
+            // AAC: extradata contains AudioSpecificConfig
+            const description = Buffer.from(extraData);
+            logger.debug(`AAC description from extradata: ${description.length} bytes`);
+            return description;
+        }
+        if (codecBase === 'opus') {
+            // Opus: extradata contains OpusHead structure
+            if (extraData && extraData.length > 0) {
+                const description = Buffer.from(extraData);
+                logger.debug(`Opus description from extradata: ${description.length} bytes`);
+                return description;
+            }
+            // Generate OpusHead manually if FFmpeg didn't provide it
+            const description = generateOpusHead(context.numberOfChannels, context.inputSampleRate);
+            logger.debug(`Opus description generated: ${description.length} bytes`);
+            return description;
+        }
+        if (codecBase === 'flac') {
+            if (!extraData || extraData.length === 0)
+                return null;
+            const description = buildFlacDescription(extraData);
+            logger.debug(`FLAC description: ${description.length} bytes`);
+            return description;
+        }
+        if (codecBase === 'vorbis') {
+            if (!extraData || extraData.length === 0)
+                return null;
+            // Vorbis: extradata contains all three headers
+            const description = Buffer.from(extraData);
+            logger.debug(`Vorbis description: ${description.length} bytes`);
+            return description;
+        }
+        return null;
+    }
+    catch (err) {
+        logger.debug(`Failed to extract codec description: ${err}`);
+        return null;
+    }
+}
+//# sourceMappingURL=codec-description.js.map

package/dist/backends/node-av/audio/encoder/codec-description.js.map

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

package/dist/backends/node-av/audio/encoder/codec-mapping.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Audio codec name mapping utilities
+ */
+/**
+ * Get FFmpeg encoder name from WebCodecs codec string
+ */
+export declare function getEncoderName(codec: string): string;
+/**
+ * Get FFmpeg encoder codec from WebCodecs codec string
+ */
+export declare function getEncoderCodec(codec: string): string;
+//# sourceMappingURL=codec-mapping.d.ts.map

package/dist/backends/node-av/audio/encoder/codec-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/codec-mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgCrD"}

package/dist/backends/node-av/audio/encoder/codec-mapping.js

@@ -0,0 +1,61 @@
+/**
+ * Audio codec name mapping utilities
+ */
+/**
+ * Get FFmpeg encoder name from WebCodecs codec string
+ */
+export function getEncoderName(codec) {
+    const codecLower = codec.toLowerCase();
+    if (codecLower.startsWith('mp4a') || codecLower === 'aac') {
+        return 'aac';
+    }
+    else if (codecLower === 'opus') {
+        return 'libopus';
+    }
+    else if (codecLower === 'vorbis') {
+        return 'libvorbis';
+    }
+    else if (codecLower === 'flac') {
+        return 'flac';
+    }
+    else if (codecLower === 'mp3') {
+        return 'libmp3lame';
+    }
+    return 'aac';
+}
+/**
+ * Get FFmpeg encoder codec from WebCodecs codec string
+ */
+export function getEncoderCodec(codec) {
+    const codecBase = codec.split('.')[0].toLowerCase();
+    switch (codecBase) {
+        case 'opus':
+            return 'libopus';
+        case 'mp3':
+            return 'libmp3lame';
+        case 'flac':
+            return 'flac';
+        case 'mp4a':
+        case 'aac':
+            return 'aac';
+        case 'vorbis':
+            return 'libvorbis';
+        case 'pcm-s16':
+            return 'pcm_s16le';
+        case 'pcm-s24':
+            return 'pcm_s24le';
+        case 'pcm-s32':
+            return 'pcm_s32le';
+        case 'pcm-u8':
+            return 'pcm_u8';
+        case 'ulaw':
+            return 'pcm_mulaw';
+        case 'alaw':
+            return 'pcm_alaw';
+        case 'pcm-f32':
+            return 'pcm_f32le';
+        default:
+            return 'aac';
+    }
+}
+//# sourceMappingURL=codec-mapping.js.map

package/dist/backends/node-av/audio/encoder/codec-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-mapping.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/codec-mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;SAAM,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC;IACrB,CAAC;SAAM,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;SAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAChC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/backends/node-av/audio/encoder/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Audio encoder constants
+ */
+/** Default sample rate for Opus codec */
+export declare const OPUS_SAMPLE_RATE = 48000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/backends/node-av/audio/encoder/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,QAAQ,CAAC"}

package/dist/backends/node-av/audio/encoder/constants.js

@@ -0,0 +1,6 @@
+/**
+ * Audio encoder constants
+ */
+/** Default sample rate for Opus codec */
+export const OPUS_SAMPLE_RATE = 48000;
+//# sourceMappingURL=constants.js.map

package/dist/backends/node-av/audio/encoder/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC"}

package/dist/backends/node-av/audio/encoder/drain.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Audio packet drain utilities
+ *
+ * Handles draining encoded packets from the audio encoder
+ * and converting them to EncodedFrame output format.
+ */
+import type { Encoder } from 'node-av/api';
+import type { EncodedFrame } from '../../../types.js';
+export interface AudioDrainContext {
+    /** Codec description (AAC AudioSpecificConfig, OpusHead, etc.) */
+    codecDescription: Buffer | null;
+    /** Encoder sample rate for duration calculation */
+    encoderSampleRate: number;
+    /** Fallback frame index for timestamp */
+    frameIndex: number;
+    /** Whether this is the first frame (for attaching description) */
+    firstFrame: boolean;
+}
+export interface AudioDrainResult {
+    /** Encoded frames extracted from packets */
+    frames: EncodedFrame[];
+    /** Whether first frame was emitted */
+    firstFrameEmitted: boolean;
+}
+/**
+ * Drain all available packets from the audio encoder
+ *
+ * Converts packets to EncodedFrame format, attaching codec description
+ * to the first frame.
+ */
+export declare function drainAudioPackets(encoder: Encoder, context: AudioDrainContext): Promise<AudioDrainResult>;
+//# sourceMappingURL=drain.d.ts.map

package/dist/backends/node-av/audio/encoder/drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/drain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA0C3B"}

package/dist/backends/node-av/audio/encoder/drain.js

@@ -0,0 +1,51 @@
+/**
+ * Audio packet drain utilities
+ *
+ * Handles draining encoded packets from the audio encoder
+ * and converting them to EncodedFrame output format.
+ */
+import { AV_PKT_FLAG_KEY } from 'node-av/constants';
+import { createLogger } from '../../../../utils/logger.js';
+const logger = createLogger('audio-encoder-drain');
+/**
+ * Drain all available packets from the audio encoder
+ *
+ * Converts packets to EncodedFrame format, attaching codec description
+ * to the first frame.
+ */
+export async function drainAudioPackets(encoder, context) {
+    const frames = [];
+    let firstFrameEmitted = !context.firstFrame;
+    let packet = await encoder.receive();
+    while (packet) {
+        if (packet.data) {
+            const timestamp = packet.pts !== undefined ? Number(packet.pts) : context.frameIndex;
+            const keyFrame = (packet.flags & AV_PKT_FLAG_KEY) === AV_PKT_FLAG_KEY || packet.isKeyframe;
+            // Get actual duration from packet (in timebase units), convert to samples
+            let durationSamples;
+            if (packet.duration !== undefined && packet.duration > 0n) {
+                const tb = packet.timeBase;
+                if (tb && tb.den > 0) {
+                    // duration_samples = duration * (tb.num / tb.den) * sampleRate
+                    durationSamples = Number((packet.duration * BigInt(tb.num) * BigInt(context.encoderSampleRate)) / BigInt(tb.den));
+                }
+            }
+            const frameData = {
+                data: Buffer.from(packet.data),
+                timestamp,
+                keyFrame,
+                durationSamples,
+            };
+            // Include codec description on the first frame
+            if (!firstFrameEmitted && context.codecDescription) {
+                frameData.description = context.codecDescription;
+                firstFrameEmitted = true;
+            }
+            frames.push(frameData);
+        }
+        packet.unref();
+        packet = await encoder.receive();
+    }
+    return { frames, firstFrameEmitted };
+}
+//# sourceMappingURL=drain.js.map

package/dist/backends/node-av/audio/encoder/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/drain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAoBnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,OAA0B;IAE1B,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,iBAAiB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;IAE5C,IAAI,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,OAAO,MAAM,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YACrF,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,eAAe,IAAK,MAAc,CAAC,UAAU,CAAC;YAEpG,0EAA0E;YAC1E,IAAI,eAAmC,CAAC;YACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;gBAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAC3B,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;oBACrB,+DAA+D;oBAC/D,eAAe,GAAG,MAAM,CACtB,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CACxF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAiB;gBAC9B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC9B,SAAS;gBACT,QAAQ;gBACR,eAAe;aAChB,CAAC;YAEF,+CAA+C;YAC/C,IAAI,CAAC,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBACnD,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;gBACjD,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACvC,CAAC"}

package/dist/backends/node-av/audio/encoder/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Audio encoder helper utilities
+ *
+ * Organized into focused modules:
+ * - constants: Shared constants (OPUS_SAMPLE_RATE)
+ * - codec-mapping: Codec name/codec mapping
+ * - channel-layout: Channel layout utilities
+ * - sample-format-convert: Sample format conversion utilities
+ * - options: Encoder options building
+ * - codec-description: Codec description extraction
+ * - drain: Packet draining utilities
+ */
+export { OPUS_SAMPLE_RATE } from './constants.js';
+export { getEncoderName, getEncoderCodec } from './codec-mapping.js';
+export { getChannelLayout } from './channel-layout.js';
+export { convertToPlanar, convertToS16Interleaved, convertToS32Interleaved, convertToS16Planar, convertToU8Interleaved, convertFromPlanarToInterleaved, convertFromS16ToF32Interleaved, convertFromS16PlanarToF32Interleaved, convertFromS32ToF32Interleaved, } from './sample-format-convert.js';
+export { buildAudioEncoderOptions, getCodecSampleFormat, configureOpusOptions, configureAacOptions, type AudioEncoderOptions, } from './options.js';
+export { extractCodecDescription, generateOpusHead, buildFlacDescription, type CodecDescriptionContext, } from './codec-description.js';
+export { drainAudioPackets, type AudioDrainContext, type AudioDrainResult, } from './drain.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/node-av/audio/encoder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,8BAA8B,EAC9B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC"}

package/dist/backends/node-av/audio/encoder/index.js

@@ -0,0 +1,20 @@
+/**
+ * Audio encoder helper utilities
+ *
+ * Organized into focused modules:
+ * - constants: Shared constants (OPUS_SAMPLE_RATE)
+ * - codec-mapping: Codec name/codec mapping
+ * - channel-layout: Channel layout utilities
+ * - sample-format-convert: Sample format conversion utilities
+ * - options: Encoder options building
+ * - codec-description: Codec description extraction
+ * - drain: Packet draining utilities
+ */
+export { OPUS_SAMPLE_RATE } from './constants.js';
+export { getEncoderName, getEncoderCodec } from './codec-mapping.js';
+export { getChannelLayout } from './channel-layout.js';
+export { convertToPlanar, convertToS16Interleaved, convertToS32Interleaved, convertToS16Planar, convertToU8Interleaved, convertFromPlanarToInterleaved, convertFromS16ToF32Interleaved, convertFromS16PlanarToF32Interleaved, convertFromS32ToF32Interleaved, } from './sample-format-convert.js';
+export { buildAudioEncoderOptions, getCodecSampleFormat, configureOpusOptions, configureAacOptions, } from './options.js';
+export { extractCodecDescription, generateOpusHead, buildFlacDescription, } from './codec-description.js';
+export { drainAudioPackets, } from './drain.js';
+//# sourceMappingURL=index.js.map

package/dist/backends/node-av/audio/encoder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,8BAA8B,EAC9B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAGlB,MAAM,YAAY,CAAC"}

package/dist/backends/node-av/audio/encoder/options.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Audio encoder options building utilities
+ *
+ * Builds codec-specific encoder options for Opus, AAC, FLAC, Vorbis, and PCM codecs
+ */
+import type { Rational } from 'node-av/lib';
+import { type AVSampleFormat } from 'node-av/constants';
+import type { AudioEncoderBackendConfig } from '../../../types.js';
+/** Channel layout object for FFmpeg */
+export interface ChannelLayout {
+    nbChannels: number;
+    order: number;
+    mask: bigint;
+}
+export interface AudioEncoderOptions {
+    type: 'audio';
+    sampleRate: number;
+    channelLayout: ChannelLayout;
+    sampleFormat: AVSampleFormat;
+    timeBase: Rational;
+    bitrate?: number;
+    options: Record<string, string | number>;
+}
+/**
+ * Get the required sample format for a codec
+ */
+export declare function getCodecSampleFormat(codecBase: string): AVSampleFormat;
+/**
+ * Configure Opus-specific encoder options
+ */
+export declare function configureOpusOptions(options: Record<string, string | number>, config: AudioEncoderBackendConfig): void;
+/**
+ * Configure AAC-specific encoder options
+ */
+export declare function configureAacOptions(options: Record<string, string | number>, config: AudioEncoderBackendConfig): void;
+/**
+ * Build complete encoder options for a given audio codec
+ */
+export declare function buildAudioEncoderOptions(config: AudioEncoderBackendConfig, timeBase: Rational): AudioEncoderOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/backends/node-av/audio/encoder/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/audio/encoder/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,cAAc,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAuBtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACxC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAmDN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACxC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,yBAAyB,EACjC,QAAQ,EAAE,QAAQ,GACjB,mBAAmB,CA6BrB"}

package/dist/backends/node-av/audio/encoder/options.js

@@ -0,0 +1,127 @@
+/**
+ * Audio encoder options building utilities
+ *
+ * Builds codec-specific encoder options for Opus, AAC, FLAC, Vorbis, and PCM codecs
+ */
+import { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLT, AV_SAMPLE_FMT_U8, AV_SAMPLE_FMT_S32, } from 'node-av/constants';
+import { OPUS_SAMPLE_RATE, getChannelLayout } from './index.js';
+/**
+ * Get the required sample format for a codec
+ */
+export function getCodecSampleFormat(codecBase) {
+    if (codecBase === 'opus') {
+        // libopus only supports s16 or flt (interleaved)
+        return AV_SAMPLE_FMT_FLT;
+    }
+    if (codecBase === 'vorbis') {
+        return AV_SAMPLE_FMT_FLTP;
+    }
+    if (codecBase === 'flac' || codecBase === 'pcm-s16') {
+        // flac encoder requires interleaved s16 or s32
+        return AV_SAMPLE_FMT_S16;
+    }
+    if (codecBase === 'pcm-s24' || codecBase === 'pcm-s32') {
+        return AV_SAMPLE_FMT_S32;
+    }
+    if (codecBase === 'pcm-u8') {
+        return AV_SAMPLE_FMT_U8;
+    }
+    if (codecBase === 'ulaw' || codecBase === 'alaw') {
+        return AV_SAMPLE_FMT_S16;
+    }
+    // Most codecs work with float planar (aac, etc.)
+    return AV_SAMPLE_FMT_FLTP;
+}
+/**
+ * Configure Opus-specific encoder options
+ */
+export function configureOpusOptions(options, config) {
+    const opusConfig = config.opus;
+    const isRealtime = config.latencyMode === 'realtime';
+    const isConstantBitrate = config.bitrateMode === 'constant';
+    const isVariableBitrate = config.bitrateMode === 'variable';
+    // Application mode: explicit application takes precedence, then signal hint, then latency mode default
+    let application;
+    if (opusConfig?.application !== undefined) {
+        application = opusConfig.application;
+    }
+    else if (opusConfig?.signal !== undefined) {
+        // Map WebCodecs signal hint to libopus application mode
+        application = opusConfig.signal === 'voice' ? 'voip' : 'audio';
+    }
+    else {
+        application = isRealtime ? 'voip' : 'audio';
+    }
+    options.application = application;
+    // Frame duration
+    if (opusConfig?.frameDuration !== undefined) {
+        options.frame_duration = String(opusConfig.frameDuration / 1000);
+    }
+    else if (isRealtime) {
+        options.frame_duration = '10';
+    }
+    // VBR control
+    if (isConstantBitrate) {
+        options.vbr = 'off';
+    }
+    else if (isVariableBitrate) {
+        options.vbr = 'on';
+    }
+    // Packet loss percentage for FEC
+    if (opusConfig?.packetlossperc !== undefined) {
+        options.packet_loss = String(opusConfig.packetlossperc);
+    }
+    // In-band FEC
+    if (opusConfig?.useinbandfec !== undefined) {
+        options.fec = opusConfig.useinbandfec ? '1' : '0';
+    }
+    // Discontinuous transmission
+    if (opusConfig?.usedtx !== undefined) {
+        options.dtx = opusConfig.usedtx ? '1' : '0';
+    }
+    // Complexity (0-10)
+    if (opusConfig?.complexity !== undefined) {
+        options.compression_level = String(opusConfig.complexity);
+    }
+}
+/**
+ * Configure AAC-specific encoder options
+ */
+export function configureAacOptions(options, config) {
+    const isVariableBitrate = config.bitrateMode === 'variable';
+    if (isVariableBitrate && !config.bitrate) {
+        // VBR mode with quality-based encoding
+        options.global_quality = 4;
+    }
+}
+/**
+ * Build complete encoder options for a given audio codec
+ */
+export function buildAudioEncoderOptions(config, timeBase) {
+    const codecBase = config.codec.split('.')[0].toLowerCase();
+    const isOpus = codecBase === 'opus';
+    const isFlac = codecBase === 'flac';
+    const sampleFormat = getCodecSampleFormat(codecBase);
+    const options = {};
+    // Codec-specific options
+    if (isOpus) {
+        configureOpusOptions(options, config);
+    }
+    else if (codecBase === 'aac' || codecBase === 'mp4a') {
+        configureAacOptions(options, config);
+    }
+    // Frame size configuration for specific codecs
+    if (isFlac) {
+        options.frame_size = '1024';
+    }
+    return {
+        type: 'audio',
+        sampleRate: isOpus ? OPUS_SAMPLE_RATE : config.sampleRate,
+        channelLayout: getChannelLayout(config.numberOfChannels),
+        sampleFormat,
+        timeBase,
+        bitrate: config.bitrate,
+        options,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/backends/node-av/audio/encoder/options.js.map

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