webcodecs-node 0.2.2

package/dist/hardware/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hardware acceleration type definitions
+ */
+export type HardwareAccelerationMethod = 'none' | 'vaapi' | 'cuda' | 'nvenc' | 'nvdec' | 'qsv' | 'videotoolbox' | 'v4l2m2m' | 'drm';
+export type VideoCodecName = 'h264' | 'hevc' | 'vp8' | 'vp9' | 'av1';
+export interface HardwareEncoderInfo {
+    name: string;
+    hwaccel: HardwareAccelerationMethod;
+    codec: VideoCodecName;
+    available: boolean;
+    priority: number;
+}
+export interface HardwareDecoderInfo {
+    name: string;
+    hwaccel: HardwareAccelerationMethod;
+    codec: VideoCodecName;
+    available: boolean;
+    priority: number;
+}
+export interface HardwareCapabilities {
+    methods: HardwareAccelerationMethod[];
+    encoders: HardwareEncoderInfo[];
+    decoders: HardwareDecoderInfo[];
+    detected: boolean;
+}
+export declare const HARDWARE_ENCODERS: Omit<HardwareEncoderInfo, 'available'>[];
+export declare const HARDWARE_DECODERS: Omit<HardwareDecoderInfo, 'available'>[];
+export declare const SOFTWARE_ENCODERS: Record<VideoCodecName, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/hardware/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hardware/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,0BAA0B,GAClC,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,cAAc,GACd,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,0BAA0B,CAAC;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,0BAA0B,CAAC;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,EA2BrE,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,EAoBrE,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAM5D,CAAC"}

package/dist/hardware/types.js

@@ -0,0 +1,58 @@
+/**
+ * Hardware acceleration type definitions
+ */
+// Hardware encoder definitions (ordered by priority)
+// Lower priority = preferred. VAAPI is generally most reliable on Linux.
+export const HARDWARE_ENCODERS = [
+    // H.264 encoders (VAAPI first as it's most reliable on Linux)
+    { name: 'h264_vaapi', hwaccel: 'vaapi', codec: 'h264', priority: 1 },
+    { name: 'h264_nvenc', hwaccel: 'nvenc', codec: 'h264', priority: 2 },
+    { name: 'h264_qsv', hwaccel: 'qsv', codec: 'h264', priority: 3 },
+    { name: 'h264_videotoolbox', hwaccel: 'videotoolbox', codec: 'h264', priority: 1 }, // macOS
+    { name: 'h264_v4l2m2m', hwaccel: 'v4l2m2m', codec: 'h264', priority: 5 },
+    // HEVC encoders
+    { name: 'hevc_vaapi', hwaccel: 'vaapi', codec: 'hevc', priority: 1 },
+    { name: 'hevc_nvenc', hwaccel: 'nvenc', codec: 'hevc', priority: 2 },
+    { name: 'hevc_qsv', hwaccel: 'qsv', codec: 'hevc', priority: 3 },
+    { name: 'hevc_videotoolbox', hwaccel: 'videotoolbox', codec: 'hevc', priority: 1 }, // macOS
+    { name: 'hevc_v4l2m2m', hwaccel: 'v4l2m2m', codec: 'hevc', priority: 5 },
+    // VP8 encoders
+    { name: 'vp8_vaapi', hwaccel: 'vaapi', codec: 'vp8', priority: 1 },
+    { name: 'vp8_v4l2m2m', hwaccel: 'v4l2m2m', codec: 'vp8', priority: 5 },
+    // VP9 encoders
+    { name: 'vp9_vaapi', hwaccel: 'vaapi', codec: 'vp9', priority: 1 },
+    { name: 'vp9_qsv', hwaccel: 'qsv', codec: 'vp9', priority: 3 },
+    // AV1 encoders (newer hardware only)
+    { name: 'av1_vaapi', hwaccel: 'vaapi', codec: 'av1', priority: 1 },
+    { name: 'av1_nvenc', hwaccel: 'nvenc', codec: 'av1', priority: 2 },
+    { name: 'av1_qsv', hwaccel: 'qsv', codec: 'av1', priority: 3 },
+];
+// Hardware decoder definitions
+// VAAPI is preferred on Linux as it's most reliable without requiring specific GPU drivers
+// Note: VAAPI decoding uses -hwaccel vaapi, not a specific decoder name
+export const HARDWARE_DECODERS = [
+    // H.264 decoders - QSV tends to be more reliable than CUDA
+    { name: 'h264_qsv', hwaccel: 'qsv', codec: 'h264', priority: 1 },
+    { name: 'h264_cuvid', hwaccel: 'cuda', codec: 'h264', priority: 3 },
+    // HEVC decoders
+    { name: 'hevc_qsv', hwaccel: 'qsv', codec: 'hevc', priority: 1 },
+    { name: 'hevc_cuvid', hwaccel: 'cuda', codec: 'hevc', priority: 3 },
+    // VP8 decoders
+    { name: 'vp8_qsv', hwaccel: 'qsv', codec: 'vp8', priority: 1 },
+    { name: 'vp8_cuvid', hwaccel: 'cuda', codec: 'vp8', priority: 3 },
+    // VP9 decoders
+    { name: 'vp9_qsv', hwaccel: 'qsv', codec: 'vp9', priority: 1 },
+    { name: 'vp9_cuvid', hwaccel: 'cuda', codec: 'vp9', priority: 3 },
+    // AV1 decoders
+    { name: 'av1_qsv', hwaccel: 'qsv', codec: 'av1', priority: 1 },
+    { name: 'av1_cuvid', hwaccel: 'cuda', codec: 'av1', priority: 3 },
+];
+// Software encoder fallbacks
+export const SOFTWARE_ENCODERS = {
+    h264: 'libx264',
+    hevc: 'libx265',
+    vp8: 'libvpx',
+    vp9: 'libvpx-vp9',
+    av1: 'libaom-av1',
+};
+//# sourceMappingURL=types.js.map

package/dist/hardware/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WebCodecs API implementation for Node.js
+ *
+ * This module provides a Node.js implementation of the WebCodecs API
+ * using FFmpeg as the underlying codec engine.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/WebCodecs_API
+ */
+export type { BufferSource, CodecState } from './types/index.js';
+export { DOMException, DOMRectReadOnly } from './types/index.js';
+export type { PlaneLayout, DOMRectInit } from './types/index.js';
+export type { VideoPixelFormat, VideoFrameBufferInit, VideoFrameInit, VideoFrameCopyToOptions, } from './types/index.js';
+export { VideoFrame } from './core/index.js';
+export { AudioData } from './core/index.js';
+export type { AudioSampleFormat, AudioDataInit, AudioDataCopyToOptions, } from './core/AudioData.js';
+export { EncodedVideoChunk } from './core/index.js';
+export type { EncodedVideoChunkType, EncodedVideoChunkInit, } from './core/EncodedVideoChunk.js';
+export { EncodedAudioChunk } from './core/index.js';
+export type { EncodedAudioChunkType, EncodedAudioChunkInit, } from './core/EncodedAudioChunk.js';
+export { VideoColorSpace } from './formats/index.js';
+export type { VideoColorSpaceInit } from './formats/index.js';
+export { VideoEncoder } from './encoders/index.js';
+export type { VideoEncoderConfig, VideoEncoderInit, VideoEncoderSupport, VideoEncoderOutputMetadata, VideoEncoderEncodeOptions, } from './encoders/VideoEncoder.js';
+export { AudioEncoder } from './encoders/index.js';
+export type { AudioEncoderConfig, AudioEncoderInit, AudioEncoderSupport, AudioEncoderOutputMetadata, } from './encoders/AudioEncoder.js';
+export { VideoDecoder } from './decoders/index.js';
+export type { VideoDecoderConfig, VideoDecoderInit, VideoDecoderSupport, } from './decoders/VideoDecoder.js';
+export { AudioDecoder } from './decoders/index.js';
+export type { AudioDecoderConfig, AudioDecoderInit, AudioDecoderSupport, } from './decoders/AudioDecoder.js';
+export { ImageDecoder, ImageTrack, ImageTrackList } from './decoders/index.js';
+export type { ImageDecoderInit, ImageDecodeOptions, ImageDecodeResult, ColorSpaceConversion, PremultiplyAlpha, } from './decoders/ImageDecoder.js';
+export { FFmpegProcess } from './ffmpeg/index.js';
+export type { FFmpegConfig, FFmpegInputConfig, FFmpegOutputConfig } from './ffmpeg/index.js';
+export { pixelFormatToFFmpeg, ffmpegToPixelFormat, webCodecToFFmpegCodec, webCodecToContainerFormat, calculateFrameSize, } from './ffmpeg/index.js';
+export { detectHardwareAcceleration, getBestEncoder, getBestDecoder, getHardwareAccelerationSummary, testEncoder, parseCodecString, clearCapabilitiesCache, getEncoderArgs, getDecoderArgs, } from './hardware/index.js';
+export type { HardwareAccelerationMethod, VideoCodecName, HardwareEncoderInfo, HardwareDecoderInfo, HardwareCapabilities, } from './hardware/index.js';
+export { MediaCapabilities, mediaCapabilities } from './MediaCapabilities.js';
+export type { VideoConfiguration, AudioConfiguration, MediaDecodingConfiguration, MediaEncodingConfiguration, MediaCapabilitiesInfo, MediaCapabilitiesDecodingInfo, MediaCapabilitiesEncodingInfo, } from './MediaCapabilities.js';
+export { Logger, createLogger, setDebugMode, isDebugMode } from './utils/index.js';
+export type { LogLevel, LogEntry } from './utils/index.js';
+export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, } from './utils/index.js';
+export { installWebCodecsPolyfill } from './polyfill.js';
+export { installOffscreenCanvasPolyfill } from './polyfills/OffscreenCanvas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * WebCodecs API implementation for Node.js
+ *
+ * This module provides a Node.js implementation of the WebCodecs API
+ * using FFmpeg as the underlying codec engine.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/WebCodecs_API
+ */
+export { DOMException, DOMRectReadOnly } from './types/index.js';
+// Core data structures
+export { VideoFrame } from './core/index.js';
+export { AudioData } from './core/index.js';
+export { EncodedVideoChunk } from './core/index.js';
+export { EncodedAudioChunk } from './core/index.js';
+// Formats
+export { VideoColorSpace } from './formats/index.js';
+// Encoders
+export { VideoEncoder } from './encoders/index.js';
+export { AudioEncoder } from './encoders/index.js';
+// Decoders
+export { VideoDecoder } from './decoders/index.js';
+export { AudioDecoder } from './decoders/index.js';
+export { ImageDecoder, ImageTrack, ImageTrackList } from './decoders/index.js';
+// FFmpeg utilities (for advanced use)
+export { FFmpegProcess } from './ffmpeg/index.js';
+export { pixelFormatToFFmpeg, ffmpegToPixelFormat, webCodecToFFmpegCodec, webCodecToContainerFormat, calculateFrameSize, } from './ffmpeg/index.js';
+// Hardware acceleration
+export { detectHardwareAcceleration, getBestEncoder, getBestDecoder, getHardwareAccelerationSummary, testEncoder, parseCodecString, clearCapabilitiesCache, getEncoderArgs, getDecoderArgs, } from './hardware/index.js';
+// MediaCapabilities API
+export { MediaCapabilities, mediaCapabilities } from './MediaCapabilities.js';
+// Utilities
+export { Logger, createLogger, setDebugMode, isDebugMode } from './utils/index.js';
+export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, } from './utils/index.js';
+// Polyfills
+export { installWebCodecsPolyfill } from './polyfill.js';
+export { installOffscreenCanvasPolyfill } from './polyfills/OffscreenCanvas.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASjE,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAS/E,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,wBAAwB;AACxB,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,8BAA8B,EAC9B,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAS7B,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAW9E,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY;AACZ,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/mediabunny/FFmpegAudioDecoder.d.ts

@@ -0,0 +1,37 @@
+/**
+ * FFmpeg-backed AudioDecoder for Mediabunny
+ *
+ * Implements Mediabunny's CustomAudioDecoder interface using FFmpeg child process.
+ */
+import { CustomAudioDecoder, EncodedPacket, AudioCodec } from 'mediabunny';
+export declare class FFmpegAudioDecoder extends CustomAudioDecoder {
+    private process;
+    private accumulatedData;
+    private frameIndex;
+    private resolveFlush;
+    private aacConfig;
+    private baseTimestamp;
+    private hasBaseTimestamp;
+    static supports(codec: AudioCodec, _config: AudioDecoderConfig): boolean;
+    init(): Promise<void>;
+    /**
+     * Parse AAC AudioSpecificConfig from description buffer
+     */
+    private parseAacAudioSpecificConfig;
+    decode(packet: EncodedPacket): Promise<void>;
+    /**
+     * Wrap raw AAC frame with ADTS header (7 bytes)
+     */
+    private wrapWithAdtsHeader;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Emit decoded audio samples
+     */
+    private emitDecodedSamples;
+    /**
+     * Emit an AudioSample via Mediabunny callback
+     */
+    private emitAudioSample;
+}
+//# sourceMappingURL=FFmpegAudioDecoder.d.ts.map

package/dist/mediabunny/FFmpegAudioDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FFmpegAudioDecoder.d.ts","sourceRoot":"","sources":["../../src/mediabunny/FFmpegAudioDecoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAElB,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AA+BpB,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,SAAS,CAAsF;IAEvG,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAAkB;IAE1C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsE3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAwB7B,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqDpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,eAAe;CA0BxB"}

package/dist/mediabunny/FFmpegAudioDecoder.js

@@ -0,0 +1,254 @@
+/**
+ * FFmpeg-backed AudioDecoder for Mediabunny
+ *
+ * Implements Mediabunny's CustomAudioDecoder interface using FFmpeg child process.
+ */
+import { spawn } from 'child_process';
+import { CustomAudioDecoder, AudioSample, } from 'mediabunny';
+// Codec mapping: Mediabunny codec -> FFmpeg decoder and input format
+const CODEC_MAP = {
+    'aac': { decoder: 'aac', format: 'aac' },
+    'opus': { decoder: 'libopus', format: 'ogg' },
+    'mp3': { decoder: 'mp3', format: 'mp3' },
+    'flac': { decoder: 'flac', format: 'flac' },
+    'vorbis': { decoder: 'libvorbis', format: 'ogg' },
+    'pcm-s16': { decoder: 'pcm_s16le', format: 's16le' },
+    'pcm-s16be': { decoder: 'pcm_s16be', format: 's16be' },
+    'pcm-s24': { decoder: 'pcm_s24le', format: 's24le' },
+    'pcm-s24be': { decoder: 'pcm_s24be', format: 's24be' },
+    'pcm-s32': { decoder: 'pcm_s32le', format: 's32le' },
+    'pcm-s32be': { decoder: 'pcm_s32be', format: 's32be' },
+    'pcm-f32': { decoder: 'pcm_f32le', format: 'f32le' },
+    'pcm-f32be': { decoder: 'pcm_f32be', format: 'f32be' },
+    'pcm-f64': { decoder: 'pcm_f64le', format: 'f64le' },
+    'pcm-f64be': { decoder: 'pcm_f64be', format: 'f64be' },
+    'pcm-u8': { decoder: 'pcm_u8', format: 'u8' },
+    'pcm-s8': { decoder: 'pcm_s8', format: 's8' },
+    'ulaw': { decoder: 'pcm_mulaw', format: 'mulaw' },
+    'alaw': { decoder: 'pcm_alaw', format: 'alaw' },
+};
+// AAC frequency table for ADTS header
+const AAC_FREQUENCIES = [
+    96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050,
+    16000, 12000, 11025, 8000, 7350
+];
+export class FFmpegAudioDecoder extends CustomAudioDecoder {
+    process = null;
+    accumulatedData = Buffer.alloc(0);
+    frameIndex = 0;
+    resolveFlush = null;
+    aacConfig = null;
+    // Track base timestamp from first input packet
+    baseTimestamp = 0;
+    hasBaseTimestamp = false;
+    static supports(codec, _config) {
+        return codec in CODEC_MAP;
+    }
+    async init() {
+        const codecInfo = CODEC_MAP[this.codec] || { decoder: 'aac', format: 'aac' };
+        const sampleRate = this.config.sampleRate ?? 44100;
+        const numberOfChannels = this.config.numberOfChannels ?? 2;
+        // Parse AAC AudioSpecificConfig if available
+        if (this.codec === 'aac' && this.config.description) {
+            this.aacConfig = this.parseAacAudioSpecificConfig(this.config.description);
+        }
+        else if (this.codec === 'aac') {
+            // Build default AAC config from sample rate and channels
+            const frequencyIndex = AAC_FREQUENCIES.indexOf(sampleRate);
+            this.aacConfig = {
+                objectType: 2, // AAC-LC
+                frequencyIndex: frequencyIndex >= 0 ? frequencyIndex : 4, // Default to 44100
+                channelConfig: numberOfChannels,
+            };
+        }
+        // Use 'adts' format for AAC since we'll wrap packets with ADTS headers
+        const inputFormat = this.codec === 'aac' ? 'aac' : codecInfo.format;
+        const args = [
+            '-hide_banner',
+            '-loglevel', 'error',
+            // Input from pipe
+            '-f', inputFormat,
+            '-i', 'pipe:0',
+            // Output: raw PCM f32le
+            '-f', 'f32le',
+            '-ar', String(sampleRate),
+            '-ac', String(numberOfChannels),
+            'pipe:1',
+        ];
+        this.process = spawn('ffmpeg', args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.process.stdout?.on('data', (data) => {
+            this.accumulatedData = Buffer.concat([this.accumulatedData, data]);
+            this.emitDecodedSamples();
+        });
+        this.process.stderr?.on('data', (data) => {
+            const msg = data.toString();
+            // Ignore common warnings, but log real errors for debugging
+            if (!msg.includes('Discarding') && !msg.includes('Last message repeated')) {
+                console.error('FFmpeg audio decoder:', msg);
+            }
+        });
+        this.process.on('close', () => {
+            // Emit any remaining samples
+            if (this.accumulatedData.length > 0) {
+                this.emitAudioSample(this.accumulatedData);
+                this.accumulatedData = Buffer.alloc(0);
+            }
+            if (this.resolveFlush) {
+                this.resolveFlush();
+                this.resolveFlush = null;
+            }
+        });
+        this.process.stdin?.on('error', () => {
+            // Ignore EPIPE errors
+        });
+    }
+    /**
+     * Parse AAC AudioSpecificConfig from description buffer
+     */
+    parseAacAudioSpecificConfig(description) {
+        let data;
+        if (description instanceof ArrayBuffer) {
+            data = new Uint8Array(description);
+        }
+        else {
+            data = new Uint8Array(description.buffer, description.byteOffset, description.byteLength);
+        }
+        if (data.length < 2) {
+            // Default config
+            return { objectType: 2, frequencyIndex: 4, channelConfig: 2 };
+        }
+        // Parse AudioSpecificConfig
+        // 5 bits: objectType
+        // 4 bits: frequencyIndex
+        // 4 bits: channelConfiguration
+        const objectType = (data[0] >> 3) & 0x1f;
+        const frequencyIndex = ((data[0] & 0x07) << 1) | ((data[1] >> 7) & 0x01);
+        const channelConfig = (data[1] >> 3) & 0x0f;
+        return { objectType, frequencyIndex, channelConfig };
+    }
+    async decode(packet) {
+        if (!this.process?.stdin?.writable) {
+            throw new Error('Decoder not initialized');
+        }
+        // Capture the base timestamp from the first packet
+        if (!this.hasBaseTimestamp) {
+            this.baseTimestamp = packet.timestamp;
+            this.hasBaseTimestamp = true;
+        }
+        // For AAC, wrap with ADTS header
+        if (this.codec === 'aac' && this.aacConfig) {
+            const adtsFrame = this.wrapWithAdtsHeader(packet.data);
+            this.process.stdin.write(adtsFrame);
+        }
+        else {
+            // Write encoded data directly to FFmpeg
+            this.process.stdin.write(Buffer.from(packet.data));
+        }
+    }
+    /**
+     * Wrap raw AAC frame with ADTS header (7 bytes)
+     */
+    wrapWithAdtsHeader(rawAac) {
+        if (!this.aacConfig) {
+            return Buffer.from(rawAac);
+        }
+        const frameLength = rawAac.length + 7; // 7-byte ADTS header
+        const header = Buffer.alloc(7);
+        // ADTS header structure (7 bytes, no CRC):
+        // Syncword: 12 bits (0xFFF)
+        // ID: 1 bit (0 = MPEG-4, 1 = MPEG-2)
+        // Layer: 2 bits (always 0)
+        // Protection absent: 1 bit (1 = no CRC)
+        // Profile: 2 bits (objectType - 1)
+        // Sampling frequency index: 4 bits
+        // Private bit: 1 bit (0)
+        // Channel configuration: 3 bits
+        // Original/copy: 1 bit (0)
+        // Home: 1 bit (0)
+        // Copyright ID bit: 1 bit (0)
+        // Copyright ID start: 1 bit (0)
+        // Frame length: 13 bits
+        // Buffer fullness: 11 bits (0x7FF = variable)
+        // Number of AAC frames - 1: 2 bits (0 = 1 frame)
+        const profile = this.aacConfig.objectType - 1; // Profile is objectType - 1
+        const freqIdx = this.aacConfig.frequencyIndex;
+        const chanCfg = this.aacConfig.channelConfig;
+        // Byte 0: Syncword high (0xFF)
+        header[0] = 0xff;
+        // Byte 1: Syncword low (0xF) + ID (0) + Layer (00) + Protection absent (1)
+        header[1] = 0xf1; // 0xF0 | 0x01
+        // Byte 2: Profile (2 bits) + Frequency index (4 bits) + Private (1 bit) + Channel config high (1 bit)
+        header[2] = ((profile & 0x03) << 6) | ((freqIdx & 0x0f) << 2) | ((chanCfg >> 2) & 0x01);
+        // Byte 3: Channel config low (2 bits) + Original (1 bit) + Home (1 bit) + Copyright ID (1 bit) + Copyright start (1 bit) + Frame length high (2 bits)
+        header[3] = ((chanCfg & 0x03) << 6) | ((frameLength >> 11) & 0x03);
+        // Byte 4: Frame length middle (8 bits)
+        header[4] = (frameLength >> 3) & 0xff;
+        // Byte 5: Frame length low (3 bits) + Buffer fullness high (5 bits)
+        header[5] = ((frameLength & 0x07) << 5) | 0x1f; // Buffer fullness = 0x7FF
+        // Byte 6: Buffer fullness low (6 bits) + Number of frames - 1 (2 bits)
+        header[6] = 0xfc; // (0x3F << 2) | 0x00
+        return Buffer.concat([header, Buffer.from(rawAac)]);
+    }
+    async flush() {
+        return new Promise((resolve) => {
+            this.resolveFlush = resolve;
+            if (this.process?.stdin) {
+                this.process.stdin.end();
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async close() {
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            this.process = null;
+        }
+    }
+    /**
+     * Emit decoded audio samples
+     */
+    emitDecodedSamples() {
+        const sampleRate = this.config.sampleRate ?? 44100;
+        const numberOfChannels = this.config.numberOfChannels ?? 2;
+        // Calculate chunk size (emit ~20ms chunks)
+        const samplesPerChunk = Math.floor(sampleRate * 0.02); // 20ms
+        const bytesPerSample = 4; // f32
+        const bytesPerChunk = samplesPerChunk * numberOfChannels * bytesPerSample;
+        while (this.accumulatedData.length >= bytesPerChunk) {
+            const chunkData = Buffer.from(this.accumulatedData.subarray(0, bytesPerChunk));
+            this.accumulatedData = this.accumulatedData.subarray(bytesPerChunk);
+            this.emitAudioSample(chunkData);
+        }
+    }
+    /**
+     * Emit an AudioSample via Mediabunny callback
+     */
+    emitAudioSample(data) {
+        if (data.length === 0)
+            return;
+        const sampleRate = this.config.sampleRate ?? 44100;
+        const numberOfChannels = this.config.numberOfChannels ?? 2;
+        const bytesPerSample = 4; // f32
+        const numberOfFrames = Math.floor(data.length / (numberOfChannels * bytesPerSample));
+        if (numberOfFrames === 0)
+            return;
+        // Calculate timestamp in seconds, preserving base timestamp from input
+        const offsetSeconds = this.frameIndex / sampleRate;
+        const timestampSeconds = this.baseTimestamp + offsetSeconds;
+        // Create AudioSample from raw f32 interleaved data
+        const sample = new AudioSample({
+            format: 'f32',
+            sampleRate,
+            numberOfChannels,
+            timestamp: timestampSeconds,
+            data: new Uint8Array(data),
+        });
+        this.frameIndex += numberOfFrames;
+        this.onSample(sample);
+    }
+}
+//# sourceMappingURL=FFmpegAudioDecoder.js.map

package/dist/mediabunny/FFmpegAudioDecoder.js.map

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

package/dist/mediabunny/FFmpegAudioEncoder.d.ts

@@ -0,0 +1,77 @@
+/**
+ * FFmpeg-backed AudioEncoder for Mediabunny
+ *
+ * Implements Mediabunny's CustomAudioEncoder interface using FFmpeg child process.
+ */
+import { CustomAudioEncoder, AudioSample, AudioCodec } from 'mediabunny';
+export declare class FFmpegAudioEncoder extends CustomAudioEncoder {
+    private process;
+    private accumulatedData;
+    private frameIndex;
+    private resolveFlush;
+    private ffmpegCodec;
+    private metadataEmitted;
+    private codecDescription;
+    private audioOutputFormat;
+    static supports(codec: AudioCodec, _config: AudioEncoderConfig): boolean;
+    init(): Promise<void>;
+    encode(audioSample: AudioSample): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Extract raw PCM data from AudioSample
+     */
+    private getSampleData;
+    /**
+     * Parse encoded audio frames from FFmpeg output
+     */
+    private parseEncodedFrames;
+    /**
+     * Find the end of an audio frame
+     */
+    private findFrameEnd;
+    private findADTSFrame;
+    private findMP3Frame;
+    /**
+     * Parse Ogg pages and extract individual Opus packets
+     * Ogg page structure:
+     * - 4 bytes: "OggS" magic
+     * - 1 byte: version
+     * - 1 byte: header type
+     * - 8 bytes: granule position
+     * - 4 bytes: serial number
+     * - 4 bytes: page sequence number
+     * - 4 bytes: checksum
+     * - 1 byte: number of segments
+     * - N bytes: segment table (one byte per segment)
+     * - data: concatenated segments
+     */
+    private findOggPage;
+    /**
+     * Extract individual Opus packets from Ogg page segments
+     */
+    private extractOggPackets;
+    /**
+     * Emit an encoded packet via Mediabunny callback
+     */
+    private emitPacket;
+    /**
+     * Get the number of samples per frame based on codec
+     */
+    private getFrameSamples;
+    /**
+     * Get codec string for the output format
+     */
+    private getCodecString;
+    /**
+     * Build Opus identification header for decoder config description
+     */
+    private buildOpusDescription;
+    /**
+     * Build AAC AudioSpecificConfig for decoder config description
+     * ISO 14496-3 section 1.6.2.1
+     */
+    private buildAacDescription;
+    private stripAdtsHeader;
+}
+//# sourceMappingURL=FFmpegAudioEncoder.d.ts.map

package/dist/mediabunny/FFmpegAudioEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FFmpegAudioEncoder.d.ts","sourceRoot":"","sources":["../../src/mediabunny/FFmpegAudioEncoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,WAAW,EAEX,UAAU,EACX,MAAM,YAAY,CAAC;AAkDpB,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,iBAAiB,CAA0B;IAEnD,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErB,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;YACW,aAAa;IAiC3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,YAAY;IAmCpB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IAgDnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiDlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;CAYxB"}