webcodecs-node 0.7.2 → 0.8.5

package/dist/encoders/audio/config.js

@@ -0,0 +1,169 @@
+/**
+ * AudioEncoder configuration validation and support checking
+ */
+import { getCodecBase } from '../../utils/codec-cache.js';
+import { AUDIO_ENCODER_CODEC_MAP } from '../../codec-utils/audio-codecs.js';
+/**
+ * Validate required AudioEncoderConfig fields
+ */
+export function validateRequiredFields(config) {
+    if (!config || typeof config !== 'object') {
+        throw new TypeError('config must be an object');
+    }
+    if (config.codec === undefined || config.codec === null) {
+        throw new TypeError("Failed to read the 'codec' property from 'AudioEncoderConfig': Required member is undefined.");
+    }
+    if (typeof config.codec !== 'string' || config.codec === '') {
+        throw new TypeError('codec must be a non-empty string');
+    }
+    if (config.sampleRate === undefined || config.sampleRate === null) {
+        throw new TypeError("Failed to read the 'sampleRate' property from 'AudioEncoderConfig': Required member is undefined.");
+    }
+    if (typeof config.sampleRate !== 'number' || !Number.isFinite(config.sampleRate) || config.sampleRate <= 0) {
+        throw new TypeError('sampleRate must be a finite positive number');
+    }
+    if (config.numberOfChannels === undefined || config.numberOfChannels === null) {
+        throw new TypeError("Failed to read the 'numberOfChannels' property from 'AudioEncoderConfig': Required member is undefined.");
+    }
+    if (typeof config.numberOfChannels !== 'number' || !Number.isFinite(config.numberOfChannels) || config.numberOfChannels <= 0 || !Number.isInteger(config.numberOfChannels)) {
+        throw new TypeError('numberOfChannels must be a positive integer');
+    }
+}
+/**
+ * Validate optional AudioEncoderConfig fields
+ */
+export function validateOptionalFields(config) {
+    if (config.bitrate !== undefined && (typeof config.bitrate !== 'number' || !Number.isFinite(config.bitrate) || config.bitrate <= 0)) {
+        throw new TypeError('bitrate must be a finite positive number');
+    }
+    if (config.bitrateMode !== undefined && !['constant', 'variable'].includes(config.bitrateMode)) {
+        throw new TypeError("bitrateMode must be 'constant' or 'variable'");
+    }
+    if (config.latencyMode !== undefined && !['quality', 'realtime'].includes(config.latencyMode)) {
+        throw new TypeError("latencyMode must be 'quality' or 'realtime'");
+    }
+}
+/**
+ * Validate Opus-specific config per WebCodecs Opus codec registration
+ * Returns false if config is unsupported (but valid)
+ */
+export function validateOpusConfig(config) {
+    if (config.opus?.format !== undefined) {
+        const format = config.opus.format; // Cast to handle runtime 'ogg' values
+        if (format === 'ogg') {
+            // 'ogg' format requests Ogg-encapsulated output, but encoders produce raw packets.
+            // Ogg containerization is handled by the muxer, not the encoder.
+            throw new TypeError("opus.format 'ogg' is not supported at encoder level - use 'opus' format and an Ogg muxer");
+        }
+        if (format !== 'opus') {
+            throw new TypeError("opus.format must be 'opus'");
+        }
+    }
+    if (config.opus?.packetlossperc !== undefined) {
+        if (typeof config.opus.packetlossperc !== 'number' || config.opus.packetlossperc < 0 || config.opus.packetlossperc > 100) {
+            throw new TypeError('opus.packetlossperc must be a number between 0 and 100');
+        }
+    }
+    const validFrameDurations = [2500, 5000, 10000, 20000, 40000, 60000, 80000, 100000, 120000];
+    if (config.opus?.frameDuration !== undefined) {
+        if (!validFrameDurations.includes(config.opus.frameDuration)) {
+            throw new TypeError(`opus.frameDuration must be one of: ${validFrameDurations.join(', ')}`);
+        }
+    }
+    if (config.opus?.complexity !== undefined) {
+        if (typeof config.opus.complexity !== 'number' || config.opus.complexity < 0 || config.opus.complexity > 10) {
+            throw new TypeError('opus.complexity must be a number between 0 and 10');
+        }
+    }
+    if (config.opus?.application !== undefined && !['voip', 'audio', 'lowdelay'].includes(config.opus.application)) {
+        throw new TypeError("opus.application must be 'voip', 'audio', or 'lowdelay'");
+    }
+    if (config.opus?.signal !== undefined && !['auto', 'music', 'voice'].includes(config.opus.signal)) {
+        throw new TypeError("opus.signal must be 'auto', 'music', or 'voice'");
+    }
+    // Validate Opus channel count (1-255 per RFC 6716)
+    if (config.numberOfChannels > 255) {
+        return false;
+    }
+    // Validate Opus bitrate bounds (6kbps - 510kbps per Opus spec)
+    if (config.bitrate !== undefined) {
+        if (config.bitrate < 6000 || config.bitrate > 510000) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Validate AAC-specific config
+ */
+export function validateAacConfig(config) {
+    if (config.aac?.format !== undefined && !['aac', 'adts'].includes(config.aac.format)) {
+        throw new TypeError("aac.format must be 'aac' or 'adts'");
+    }
+}
+/**
+ * Clone an AudioEncoderConfig per WebCodecs spec
+ */
+export function cloneConfig(config) {
+    const codecBase = getCodecBase(config.codec);
+    const clonedConfig = {
+        codec: config.codec,
+        sampleRate: config.sampleRate,
+        numberOfChannels: config.numberOfChannels,
+    };
+    // Copy optional properties if present
+    if (config.bitrate !== undefined)
+        clonedConfig.bitrate = config.bitrate;
+    if (config.bitrateMode !== undefined)
+        clonedConfig.bitrateMode = config.bitrateMode;
+    if (config.latencyMode !== undefined)
+        clonedConfig.latencyMode = config.latencyMode;
+    if (config.format !== undefined)
+        clonedConfig.format = config.format;
+    // Clone Opus config with defaults per WebCodecs Opus codec registration
+    if (codecBase === 'opus') {
+        const opusConfig = {
+            format: config.opus?.format ?? 'opus',
+            frameDuration: config.opus?.frameDuration ?? 20000,
+            application: config.opus?.application ?? 'audio',
+            packetlossperc: config.opus?.packetlossperc ?? 0,
+            useinbandfec: config.opus?.useinbandfec ?? false,
+            usedtx: config.opus?.usedtx ?? false,
+            signal: config.opus?.signal ?? 'auto',
+            complexity: config.opus?.complexity ?? 10,
+        };
+        clonedConfig.opus = opusConfig;
+    }
+    // Clone AAC config (strip unknown fields)
+    if (config.aac) {
+        const aacConfig = {};
+        if (config.aac.format !== undefined)
+            aacConfig.format = config.aac.format;
+        clonedConfig.aac = aacConfig;
+    }
+    return clonedConfig;
+}
+/**
+ * Check if an AudioEncoderConfig is supported
+ */
+export async function checkConfigSupport(config) {
+    // Validate required fields
+    validateRequiredFields(config);
+    // Validate optional fields
+    validateOptionalFields(config);
+    const codecBase = getCodecBase(config.codec);
+    // Validate Opus-specific config
+    if (codecBase === 'opus') {
+        const opusSupported = validateOpusConfig(config);
+        if (!opusSupported) {
+            return { supported: false, config };
+        }
+    }
+    // Validate AAC-specific config
+    validateAacConfig(config);
+    // Clone the config per WebCodecs spec
+    const clonedConfig = cloneConfig(config);
+    const supported = codecBase in AUDIO_ENCODER_CODEC_MAP || config.codec in AUDIO_ENCODER_CODEC_MAP;
+    return { supported, config: clonedConfig };
+}
+//# sourceMappingURL=config.js.map

package/dist/encoders/audio/config.js.map

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

package/dist/encoders/audio/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AudioEncoder constants
+ */
+export declare const DEFAULT_FLUSH_TIMEOUT = 30000;
+export declare const MAX_QUEUE_SIZE = 100;
+/** Opus always encodes at 48kHz regardless of input */
+export declare const OPUS_ENCODER_SAMPLE_RATE = 48000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/encoders/audio/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/encoders/audio/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,QAAQ,CAAC"}

package/dist/encoders/audio/constants.js

@@ -0,0 +1,8 @@
+/**
+ * AudioEncoder constants
+ */
+export const DEFAULT_FLUSH_TIMEOUT = 30000;
+export const MAX_QUEUE_SIZE = 100; // Prevent unbounded memory growth
+/** Opus always encodes at 48kHz regardless of input */
+export const OPUS_ENCODER_SAMPLE_RATE = 48000;
+//# sourceMappingURL=constants.js.map

package/dist/encoders/audio/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/encoders/audio/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,CAAC,kCAAkC;AAErE,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC"}

package/dist/encoders/audio/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * AudioEncoder type definitions
+ */
+import type { EncodedAudioChunk } from '../../core/EncodedAudioChunk.js';
+export type CodecState = 'unconfigured' | 'configured' | 'closed';
+/**
+ * Opus-specific encoder configuration
+ * https://www.w3.org/TR/webcodecs-opus-codec-registration/
+ */
+export interface OpusEncoderConfig {
+    /** Output format: only 'opus' (raw Opus packets) is supported at encoder level.
+     *  'ogg' encapsulation is handled by the muxer, not the encoder. */
+    format?: 'opus';
+    /** Frame duration in microseconds (2500, 5000, 10000, 20000, 40000, 60000, 80000, 100000, 120000) */
+    frameDuration?: number;
+    /** Opus application mode */
+    application?: 'voip' | 'audio' | 'lowdelay';
+    /** Packet loss percentage for forward error correction (0-100) - per WebCodecs spec (lowercase) */
+    packetlossperc?: number;
+    /** Use in-band forward error correction */
+    useinbandfec?: boolean;
+    /** Use discontinuous transmission mode (for silence suppression) */
+    usedtx?: boolean;
+    /** Signal type hint for encoder optimization */
+    signal?: 'auto' | 'music' | 'voice';
+    /** Complexity (0-10, higher = better quality but more CPU) */
+    complexity?: number;
+}
+/**
+ * AAC-specific encoder configuration
+ * https://www.w3.org/TR/webcodecs-aac-codec-registration/
+ */
+export interface AacEncoderConfig {
+    /** Output format: 'aac' for raw AAC, 'adts' for ADTS-framed */
+    format?: 'aac' | 'adts';
+}
+export interface AudioEncoderConfig {
+    codec: string;
+    sampleRate: number;
+    numberOfChannels: number;
+    bitrate?: number;
+    bitrateMode?: 'constant' | 'variable';
+    latencyMode?: 'quality' | 'realtime';
+    /**
+     * @deprecated Use codec-specific config (aac.format) instead.
+     * Top-level format for backwards compatibility.
+     */
+    format?: 'adts' | 'aac';
+    /** Opus-specific configuration */
+    opus?: OpusEncoderConfig;
+    /** AAC-specific configuration */
+    aac?: AacEncoderConfig;
+}
+export interface AudioEncoderInit {
+    output: (chunk: EncodedAudioChunk, metadata?: AudioEncoderOutputMetadata) => void;
+    error: (error: Error) => void;
+}
+export interface AudioEncoderOutputMetadata {
+    decoderConfig?: {
+        codec: string;
+        sampleRate: number;
+        numberOfChannels: number;
+        description?: Uint8Array;
+    };
+}
+export interface AudioEncoderSupport {
+    supported: boolean;
+    config: AudioEncoderConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/encoders/audio/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/encoders/audio/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;wEACoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC5C,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,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,GAAG,UAAU,CAAC;IACtC,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,kCAAkC;IAClC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,iCAAiC;IACjC,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAClF,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,UAAU,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC5B"}

package/dist/encoders/audio/types.js

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

package/dist/encoders/audio/types.js.map

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

package/dist/encoders/video/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * VideoEncoder configuration validation and support checking
+ */
+import type { VideoEncoderConfig, VideoEncoderSupport } from './types.js';
+/**
+ * Clone a VideoEncoderConfig per WebCodecs spec
+ */
+export declare function cloneConfig(config: VideoEncoderConfig): VideoEncoderConfig;
+/**
+ * Check dimension constraints for encoder config
+ */
+export declare function areDimensionsSupported(config: VideoEncoderConfig): boolean;
+/**
+ * Check if alpha channel is supported for the codec
+ */
+export declare function isAlphaSupported(config: VideoEncoderConfig): boolean;
+/**
+ * Check if quantizer bitrate mode is supported for the codec
+ */
+export declare function isQuantizerModeSupported(config: VideoEncoderConfig): boolean;
+/**
+ * Check if a VideoEncoderConfig is supported
+ */
+export declare function checkConfigSupport(config: VideoEncoderConfig): Promise<VideoEncoderSupport>;
+//# sourceMappingURL=config.d.ts.map

package/dist/encoders/video/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/encoders/video/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CA0B1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAwB1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CASpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAW5E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkCjG"}

package/dist/encoders/video/config.js

@@ -0,0 +1,132 @@
+/**
+ * VideoEncoder configuration validation and support checking
+ */
+import { parseCodec, getCodecBase } from '../../utils/codec-cache.js';
+import { validateVideoEncoderConfig, validateVideoCodec } from '../../utils/codec-validation.js';
+/**
+ * Clone a VideoEncoderConfig per WebCodecs spec
+ */
+export function cloneConfig(config) {
+    const clonedConfig = {
+        codec: config.codec,
+        width: config.width,
+        height: config.height,
+    };
+    // Copy optional properties if present
+    if (config.displayWidth !== undefined)
+        clonedConfig.displayWidth = config.displayWidth;
+    if (config.displayHeight !== undefined)
+        clonedConfig.displayHeight = config.displayHeight;
+    if (config.bitrate !== undefined)
+        clonedConfig.bitrate = config.bitrate;
+    if (config.framerate !== undefined)
+        clonedConfig.framerate = config.framerate;
+    if (config.hardwareAcceleration !== undefined)
+        clonedConfig.hardwareAcceleration = config.hardwareAcceleration;
+    if (config.alpha !== undefined)
+        clonedConfig.alpha = config.alpha;
+    if (config.scalabilityMode !== undefined)
+        clonedConfig.scalabilityMode = config.scalabilityMode;
+    if (config.bitrateMode !== undefined)
+        clonedConfig.bitrateMode = config.bitrateMode;
+    if (config.latencyMode !== undefined)
+        clonedConfig.latencyMode = config.latencyMode;
+    if (config.format !== undefined)
+        clonedConfig.format = config.format;
+    if (config.avc !== undefined)
+        clonedConfig.avc = { ...config.avc };
+    if (config.hevc !== undefined)
+        clonedConfig.hevc = { ...config.hevc };
+    if (config.av1 !== undefined)
+        clonedConfig.av1 = { ...config.av1 };
+    if (config.colorSpace !== undefined)
+        clonedConfig.colorSpace = { ...config.colorSpace };
+    if (config.maxQueueSize !== undefined)
+        clonedConfig.maxQueueSize = config.maxQueueSize;
+    if (config.contentHint !== undefined)
+        clonedConfig.contentHint = config.contentHint;
+    return clonedConfig;
+}
+/**
+ * Check dimension constraints for encoder config
+ */
+export function areDimensionsSupported(config) {
+    // Check for odd dimensions
+    // VP9 and AV1 (software) support odd dimensions, others require even for YUV420 subsampling
+    const hasOddDimension = config.width % 2 !== 0 || config.height % 2 !== 0;
+    if (hasOddDimension) {
+        const codecBase = getCodecBase(config.codec);
+        const isVp9 = codecBase === 'vp09';
+        const isAv1 = codecBase === 'av01';
+        const prefersHardware = config.hardwareAcceleration === 'prefer-hardware';
+        // VP9 and AV1 (software) can handle odd dimensions
+        // Hardware encoders generally cannot
+        const codecSupportsOddDimensions = (isVp9 || isAv1) && !prefersHardware;
+        if (!codecSupportsOddDimensions) {
+            return false;
+        }
+    }
+    // Check for unreasonably large dimensions
+    if (config.width > 16384 || config.height > 16384) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Check if alpha channel is supported for the codec
+ */
+export function isAlphaSupported(config) {
+    if (config.alpha !== 'keep') {
+        return true;
+    }
+    // Alpha channel support: only VP9 software encoding supports alpha
+    // H.264, HEVC, AV1 do not support alpha encoding
+    const parsed = parseCodec(config.codec);
+    return parsed.name === 'vp9' && config.hardwareAcceleration !== 'prefer-hardware';
+}
+/**
+ * Check if quantizer bitrate mode is supported for the codec
+ */
+export function isQuantizerModeSupported(config) {
+    if (config.bitrateMode !== 'quantizer') {
+        return true;
+    }
+    // Quantizer bitrate mode: only some codecs support CRF/CQ mode
+    // H.264, HEVC, VP9, AV1 support quantizer mode
+    // VP8 does not support quantizer mode (uses bitrate-based VBR only)
+    const parsed = parseCodec(config.codec);
+    return parsed.name === 'h264' || parsed.name === 'hevc' ||
+        parsed.name === 'vp9' || parsed.name === 'av1';
+}
+/**
+ * Check if a VideoEncoderConfig is supported
+ */
+export async function checkConfigSupport(config) {
+    // Validate config - throws TypeError for invalid configs per spec
+    validateVideoEncoderConfig(config);
+    // Clone the config per WebCodecs spec
+    const clonedConfig = cloneConfig(config);
+    // Check dimension constraints
+    if (!areDimensionsSupported(config)) {
+        return { supported: false, config: clonedConfig };
+    }
+    // Validate codec string format and check if supported
+    const codecValidation = validateVideoCodec(config.codec);
+    if (!codecValidation.supported) {
+        return { supported: false, config: clonedConfig };
+    }
+    // Check alpha support
+    if (!isAlphaSupported(config)) {
+        return { supported: false, config: clonedConfig };
+    }
+    // Check quantizer mode support
+    if (!isQuantizerModeSupported(config)) {
+        return { supported: false, config: clonedConfig };
+    }
+    // scalabilityMode (SVC) is not supported
+    if (config.scalabilityMode !== undefined && config.scalabilityMode !== '') {
+        return { supported: false, config: clonedConfig };
+    }
+    return { supported: true, config: clonedConfig };
+}
+//# sourceMappingURL=config.js.map

package/dist/encoders/video/config.js.map

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

package/dist/encoders/video/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * VideoEncoder constants
+ */
+/** Default framerate for AV1 timestamp quantization */
+export declare const DEFAULT_FRAMERATE = 30;
+export declare const DEFAULT_FLUSH_TIMEOUT = 30000;
+export declare const DEFAULT_MAX_QUEUE_SIZE = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/encoders/video/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/encoders/video/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/encoders/video/constants.js

@@ -0,0 +1,8 @@
+/**
+ * VideoEncoder constants
+ */
+/** Default framerate for AV1 timestamp quantization */
+export const DEFAULT_FRAMERATE = 30;
+export const DEFAULT_FLUSH_TIMEOUT = 30000;
+export const DEFAULT_MAX_QUEUE_SIZE = 100; // Fallback if resolution unknown
+//# sourceMappingURL=constants.js.map

package/dist/encoders/video/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/encoders/video/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC,CAAC,iCAAiC"}

package/dist/encoders/video/queue.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Queue size calculation utilities for VideoEncoder
+ */
+/**
+ * Calculate optimal queue size based on resolution to limit memory usage.
+ * Target: ~250-500MB max memory for queued frames (RGBA format).
+ */
+export declare function calculateMaxQueueSize(width: number, height: number): number;
+//# sourceMappingURL=queue.d.ts.map

package/dist/encoders/video/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/encoders/video/queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAU3E"}

package/dist/encoders/video/queue.js

@@ -0,0 +1,17 @@
+/**
+ * Queue size calculation utilities for VideoEncoder
+ */
+/**
+ * Calculate optimal queue size based on resolution to limit memory usage.
+ * Target: ~250-500MB max memory for queued frames (RGBA format).
+ */
+export function calculateMaxQueueSize(width, height) {
+    const pixels = width * height;
+    const rgbaFrameBytes = pixels * 4;
+    // Target max memory: ~300MB for queue
+    const targetMemory = 300 * 1024 * 1024;
+    const calculated = Math.floor(targetMemory / rgbaFrameBytes);
+    // Clamp between 4 (minimum for smooth operation) and 100 (legacy max)
+    return Math.max(4, Math.min(100, calculated));
+}
+//# sourceMappingURL=queue.js.map

package/dist/encoders/video/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/encoders/video/queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,CAAC;IAElC,sCAAsC;IACtC,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,cAAc,CAAC,CAAC;IAE7D,sEAAsE;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/encoders/video/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * VideoEncoder type definitions
+ */
+import type { EncodedVideoChunk } from '../../core/EncodedVideoChunk.js';
+import type { VideoColorSpaceInit } from '../../formats/color-space.js';
+export type CodecState = 'unconfigured' | 'configured' | 'closed';
+/**
+ * AVC/H.264-specific encoder configuration
+ * https://www.w3.org/TR/webcodecs-avc-codec-registration/
+ */
+export interface AvcEncoderConfig {
+    /** Output format: 'avc' for AVCC (length-prefixed), 'annexb' for Annex B (start codes) */
+    format?: 'avc' | 'annexb';
+}
+/**
+ * HEVC/H.265-specific encoder configuration
+ * https://www.w3.org/TR/webcodecs-hevc-codec-registration/
+ */
+export interface HevcEncoderConfig {
+    /** Output format: 'hevc' for HVCC (length-prefixed), 'annexb' for Annex B (start codes) */
+    format?: 'hevc' | 'annexb';
+}
+/**
+ * AV1-specific encoder configuration
+ * https://www.w3.org/TR/webcodecs-av1-codec-registration/
+ */
+export interface Av1EncoderConfig {
+    /** Whether to force all frames to be keyframes (for screen sharing use cases) */
+    forceScreenContentTools?: boolean;
+}
+export interface VideoEncoderConfig {
+    codec: string;
+    width: number;
+    height: number;
+    displayWidth?: number;
+    displayHeight?: number;
+    bitrate?: number;
+    framerate?: number;
+    hardwareAcceleration?: 'no-preference' | 'prefer-hardware' | 'prefer-software';
+    alpha?: 'discard' | 'keep';
+    scalabilityMode?: string;
+    bitrateMode?: 'constant' | 'variable' | 'quantizer';
+    latencyMode?: 'quality' | 'realtime';
+    /**
+     * Hint about the type of content being encoded.
+     * - 'text': Optimizes for text legibility (screen sharing with text)
+     * - 'detail': Optimizes for fine details (screen sharing with complex graphics)
+     * - 'motion': Optimizes for motion (camera video, animations)
+     */
+    contentHint?: 'text' | 'detail' | 'motion';
+    /**
+     * @deprecated Use codec-specific config (avc.format, hevc.format) instead.
+     * Top-level format for backwards compatibility.
+     */
+    format?: 'annexb' | 'mp4';
+    /** AVC/H.264-specific configuration */
+    avc?: AvcEncoderConfig;
+    /** HEVC/H.265-specific configuration */
+    hevc?: HevcEncoderConfig;
+    /** AV1-specific configuration */
+    av1?: Av1EncoderConfig;
+    /**
+     * Color space for HDR encoding. When provided with primaries, transfer, matrix,
+     * and HDR metadata (SMPTE ST 2086 / Content Light Level), the encoder will
+     * set appropriate color properties in the output stream.
+     */
+    colorSpace?: VideoColorSpaceInit;
+    /**
+     * Maximum number of frames that can be queued before encode() throws.
+     * If not specified, automatically calculated based on resolution:
+     * - 720p and below: 50 frames (~185MB for RGBA)
+     * - 1080p: 30 frames (~250MB for RGBA)
+     * - 4K: 10 frames (~330MB for RGBA)
+     * - 8K: 4 frames (~530MB for RGBA)
+     */
+    maxQueueSize?: number;
+}
+export interface VideoEncoderInit {
+    output: (chunk: EncodedVideoChunk, metadata?: VideoEncoderOutputMetadata) => void;
+    error: (error: Error) => void;
+}
+export interface VideoEncoderOutputMetadata {
+    decoderConfig?: {
+        codec: string;
+        description?: Uint8Array;
+        codedWidth?: number;
+        codedHeight?: number;
+        displayAspectWidth?: number;
+        displayAspectHeight?: number;
+        colorSpace?: VideoColorSpaceInit;
+        /** Frame rotation from first encoded frame */
+        rotation?: 0 | 90 | 180 | 270;
+        /** Frame flip from first encoded frame */
+        flip?: boolean;
+    };
+}
+export interface VideoEncoderSupport {
+    supported: boolean;
+    config: VideoEncoderConfig;
+}
+export interface VideoEncoderEncodeOptions {
+    keyFrame?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/encoders/video/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/encoders/video/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;IAC/E,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACpD,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,uCAAuC;IACvC,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,iCAAiC;IACjC,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAClF,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,UAAU,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,8CAA8C;QAC9C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;QAC9B,0CAA0C;QAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/encoders/video/types.js

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