@mediabunny/server 1.45.0

package/dist/modules/src/audio-sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-sample.d.ts","sourceRoot":"","sources":["../../../src/audio-sample.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAIlC;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA2B,SAAQ,mBAAmB;IAIlE;;;OAGG;IACH,IAAI,KAAK,iBAMR;gBAEW,KAAK,EAAE,MAAM,CAAC,KAAK;IAU/B,SAAS,IAAI,iBAAiB;IAU9B,aAAa,IAAI,MAAM;IAIvB,mBAAmB,IAAI,MAAM;IAI7B,iBAAiB,IAAI,MAAM;IAI3B,YAAY,IAAI,MAAM;IAItB,KAAK,IAAI,IAAI;IAKb,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;CAI5C;AAED,eAAO,MAAM,wBAAwB,GAAI,QAAQ,WAAW,EAAE,OAAO,MAAM,CAAC,KAAK,SAYhF,CAAC"}

package/dist/modules/src/audio-sample.js

@@ -0,0 +1,119 @@
+"use strict";
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyAudioSampleToAvFrame = exports.AvFrameAudioSampleResource = void 0;
+const mediabunny_1 = require("mediabunny");
+const NodeAv = __importStar(require("node-av"));
+const misc_1 = require("./misc");
+const misc_2 = require("../../../src/misc");
+/**
+ * A custom `AudioSampleResource` backed by NodeAV's
+ * [`Frame`](https://seydx.github.io/node-av/api/lib/classes/Frame.html), which in turn is backed by FFmpeg's
+ * [`AVFrame`](https://ffmpeg.org/doxygen/2.7/structAVFrame.html). You can use this resource to create `AudioSample`
+ * instances that are directly backed by FFmpeg's `AVFrame` without data having to be copied.
+ *
+ * When passed, the `Frame` is now owned by resource, meaning it takes care of closing the frame later. If you want to
+ * keep a copy for your own use, clone the frame first.
+ *
+ * @group \@mediabunny/server
+ * @public
+ */
+class AvFrameAudioSampleResource extends mediabunny_1.AudioSampleResource {
+    /**
+     * The NodeAV [`Frame`](https://seydx.github.io/node-av/api/lib/classes/Frame.html) instance backing this resource.
+     * Access throws if the resource has already been closed.
+     */
+    get frame() {
+        if (!this._frame) {
+            throw new Error('AvFrameAudioSampleResource has been closed.');
+        }
+        return this._frame;
+    }
+    constructor(frame) {
+        super();
+        if (frame.getMediaType() !== NodeAv.AVMEDIA_TYPE_AUDIO) {
+            throw new Error('AvFrameAudioSampleResource must be initialized with an audio frame.');
+        }
+        this._frame = frame;
+    }
+    getFormat() {
+        const result = (0, misc_1.toAudioSampleFormat)(this.frame.format);
+        if (result === null) {
+            const name = NodeAv.avGetSampleFmtName(this.frame.format);
+            throw new TypeError(`Unsupported audio sample format: ${name} (${this.frame.format})`);
+        }
+        return result;
+    }
+    getSampleRate() {
+        return this.frame.sampleRate;
+    }
+    getNumberOfChannels() {
+        return this.frame.channels;
+    }
+    getNumberOfFrames() {
+        return this.frame.nbSamples;
+    }
+    getTimestamp() {
+        return Number(this.frame.pts) / this.frame.timeBase.den;
+    }
+    close() {
+        this.frame.free();
+        this._frame = null;
+    }
+    getDataPlane(planeIndex) {
+        (0, misc_2.assert)(this.frame.data && planeIndex < this.frame.data.length);
+        return (0, misc_2.toUint8Array)(this.frame.data[planeIndex]);
+    }
+}
+exports.AvFrameAudioSampleResource = AvFrameAudioSampleResource;
+const copyAudioSampleToAvFrame = (sample, frame) => {
+    frame.format = (0, misc_1.fromAudioSampleFormat)(sample.format);
+    frame.nbSamples = sample.numberOfFrames;
+    frame.sampleRate = sample.sampleRate;
+    frame.channelLayout = (0, misc_1.getChannelLayout)(sample.numberOfChannels);
+    frame.allocBuffer();
+    (0, misc_2.assert)(frame.data);
+    for (let i = 0; i < frame.data.length; i++) {
+        sample.copyTo(frame.data[i], { planeIndex: i });
+    }
+};
+exports.copyAudioSampleToAvFrame = copyAudioSampleToAvFrame;

package/dist/modules/src/index.d.ts

@@ -0,0 +1,39 @@
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { AudioSample, VideoSample } from 'mediabunny';
+import * as NodeAv from 'node-av';
+/**
+ * Registers video and audio decoders and encoders for all codecs, using FFmpeg's libavcodec under the hood.
+ * Additionally, a custom `VideoSample` transformer based on libavfilter is registered to enable resizing, rotation and
+ * cropping of video frames.
+ *
+ * Make sure to call this function before interacting with Mediabunny.
+ *
+ * The decoders and encoders will automatically detect hardware acceleration support for each codec and platform and
+ * make use of it if applicable.
+ *
+ * @group \@mediabunny/server
+ * @public
+ */
+export declare const registerMediabunnyServer: () => void;
+export { AvFrameVideoSampleResource } from './video-sample';
+export { AvFrameAudioSampleResource } from './audio-sample';
+/**
+ * Copies a `VideoSample` or `AudioSample` into the given NodeAV
+ * [`Frame`](https://seydx.github.io/node-av/api/lib/classes/Frame.html), setting up the frame's format, media type,
+ * timing and data. When the sample is already backed by an `AVFrame` (via `AvFrameVideoSampleResource` or
+ * `AvFrameAudioSampleResource`), the frame is ref'd instead of copied for zero-copy reuse.
+ *
+ * For video samples, the frame's time base is always set to 1/1000000 (microsecond accuracy). For audio samples, the
+ * frame's time base is always set to 1/sampleRate.
+ *
+ * @group \@mediabunny/server
+ * @public
+ */
+export declare const toAvFrame: (sample: VideoSample | AudioSample, frame: NodeAv.Frame) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAoE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxH,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAqBlC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,YAiBpC,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAU,QAAQ,WAAW,GAAG,WAAW,EAAE,OAAO,MAAM,CAAC,KAAK,kBA0BrF,CAAC"}

package/dist/modules/src/index.js

@@ -0,0 +1,132 @@
+"use strict";
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAvFrame = exports.AvFrameAudioSampleResource = exports.AvFrameVideoSampleResource = exports.registerMediabunnyServer = void 0;
+const mediabunny_1 = require("mediabunny");
+const NodeAv = __importStar(require("node-av"));
+const video_decoder_1 = require("./video-decoder");
+const video_encoder_1 = require("./video-encoder");
+const audio_decoder_1 = require("./audio-decoder");
+const audio_encoder_1 = require("./audio-encoder");
+const video_sample_1 = require("./video-sample");
+const audio_sample_1 = require("./audio-sample");
+const SERVER_LOADED_SYMBOL = Symbol.for('@mediabunny/server loaded');
+if (globalThis[SERVER_LOADED_SYMBOL]) {
+    console.error('[WARNING]\n@mediabunny/server was loaded twice.'
+        + ' This will likely cause the package not to work correctly.'
+        + ' Check if multiple dependencies are importing different versions of @mediabunny/server,'
+        + ' or if something is being bundled incorrectly.');
+}
+globalThis[SERVER_LOADED_SYMBOL] = true;
+let registered = false;
+/**
+ * Registers video and audio decoders and encoders for all codecs, using FFmpeg's libavcodec under the hood.
+ * Additionally, a custom `VideoSample` transformer based on libavfilter is registered to enable resizing, rotation and
+ * cropping of video frames.
+ *
+ * Make sure to call this function before interacting with Mediabunny.
+ *
+ * The decoders and encoders will automatically detect hardware acceleration support for each codec and platform and
+ * make use of it if applicable.
+ *
+ * @group \@mediabunny/server
+ * @public
+ */
+const registerMediabunnyServer = () => {
+    if (registered) {
+        return;
+    }
+    registered = true;
+    NodeAv.Log.setLevel(NodeAv.AV_LOG_ERROR);
+    // Video
+    (0, mediabunny_1.registerDecoder)(video_decoder_1.NodeAvVideoDecoder);
+    (0, mediabunny_1.registerEncoder)(video_encoder_1.NodeAvVideoEncoder);
+    // Audio
+    (0, mediabunny_1.registerDecoder)(audio_decoder_1.NodeAvAudioDecoder);
+    (0, mediabunny_1.registerEncoder)(audio_encoder_1.NodeAvAudioEncoder);
+    (0, mediabunny_1.registerVideoSampleTransformer)(video_sample_1.transformVideoSample);
+};
+exports.registerMediabunnyServer = registerMediabunnyServer;
+var video_sample_2 = require("./video-sample");
+Object.defineProperty(exports, "AvFrameVideoSampleResource", { enumerable: true, get: function () { return video_sample_2.AvFrameVideoSampleResource; } });
+var audio_sample_2 = require("./audio-sample");
+Object.defineProperty(exports, "AvFrameAudioSampleResource", { enumerable: true, get: function () { return audio_sample_2.AvFrameAudioSampleResource; } });
+/**
+ * Copies a `VideoSample` or `AudioSample` into the given NodeAV
+ * [`Frame`](https://seydx.github.io/node-av/api/lib/classes/Frame.html), setting up the frame's format, media type,
+ * timing and data. When the sample is already backed by an `AVFrame` (via `AvFrameVideoSampleResource` or
+ * `AvFrameAudioSampleResource`), the frame is ref'd instead of copied for zero-copy reuse.
+ *
+ * For video samples, the frame's time base is always set to 1/1000000 (microsecond accuracy). For audio samples, the
+ * frame's time base is always set to 1/sampleRate.
+ *
+ * @group \@mediabunny/server
+ * @public
+ */
+const toAvFrame = async (sample, frame) => {
+    if (sample instanceof mediabunny_1.VideoSample) {
+        if (sample._data instanceof video_sample_1.AvFrameVideoSampleResource) {
+            frame.ref(sample._data.frame);
+        }
+        else {
+            if (sample.format === null) {
+                throw new Error('Cannot convert foreign VideoSample with unknown (null) format.');
+            }
+            await (0, video_sample_1.copyVideoSampleToAvFrame)(sample, frame, null);
+        }
+        frame.pts = BigInt(sample.microsecondTimestamp);
+        frame.duration = BigInt(sample.microsecondDuration);
+        frame.timeBase = new NodeAv.Rational(1, 1e6);
+    }
+    else {
+        if (sample._data instanceof audio_sample_1.AvFrameAudioSampleResource) {
+            frame.ref(sample._data.frame);
+        }
+        else {
+            (0, audio_sample_1.copyAudioSampleToAvFrame)(sample, frame);
+        }
+        frame.timeBase = new NodeAv.Rational(1, sample.sampleRate);
+        frame.pts = BigInt(Math.round(sample.timestamp * sample.sampleRate));
+        frame.duration = BigInt(sample.numberOfFrames);
+    }
+};
+exports.toAvFrame = toAvFrame;

package/dist/modules/src/misc.d.ts

@@ -0,0 +1,26 @@
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { VideoSamplePixelFormat, MediaCodec } from 'mediabunny';
+import * as NodeAv from 'node-av';
+export declare const CODEC_TO_CODEC_ID: Partial<Record<MediaCodec, NodeAv.AVCodecID>>;
+export declare const getHardwareContext: () => NodeAv.HardwareContext | null;
+export declare const getHardwareDecoderCodec: (codecId: NodeAv.AVCodecID) => NodeAv.Codec | null;
+export declare const getHardwareEncoderCodec: (codecId: NodeAv.AVCodecID) => NodeAv.Codec | null;
+export declare const mapColorPrimaries: (primaries: string) => NodeAv.AVColorPrimaries | null;
+export declare const unmapColorPrimaries: (primaries: number) => "bt709" | "bt470bg" | "smpte170m" | "bt2020" | "smpte432" | null;
+export declare const mapTransferCharacteristics: (transfer: string) => NodeAv.AVColorTransferCharacteristic | null;
+export declare const unmapTransferCharacteristics: (transfer: number) => "bt709" | "smpte170m" | "iec61966-2-1" | "linear" | "pq" | "hlg" | null;
+export declare const mapMatrixCoefficients: (matrix: string) => NodeAv.AVColorSpace | null;
+export declare const unmapMatrixCoefficients: (matrix: number) => "bt709" | "bt470bg" | "smpte170m" | "rgb" | "bt2020-ncl" | null;
+export declare const toPixelFormat: (ffmpegPixelFormat: NodeAv.AVPixelFormat) => VideoSamplePixelFormat | null;
+export declare const fromPixelFormat: (pixelFormat: VideoSamplePixelFormat) => NodeAv.AVPixelFormat;
+export declare const toAudioSampleFormat: (ffmpegSampleFormat: NodeAv.AVSampleFormat) => AudioSampleFormat | null;
+export declare const fromAudioSampleFormat: (sampleFormat: AudioSampleFormat) => NodeAv.AVSampleFormat;
+export declare const getChannelLayout: (numChannels: number) => NodeAv.ChannelLayout;
+export declare const LIBVPX_VP9: (NodeAv.FFEncoderCodec & NodeAv.FFDecoderCodec);
+//# sourceMappingURL=misc.d.ts.map

package/dist/modules/src/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/misc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAElC,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAc3E,CAAC;AAGF,eAAO,MAAM,kBAAkB,QAAO,MAAM,CAAC,eAAe,GAAG,IAK9D,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,CAAC,SAAS,KAAG,MAAM,CAAC,KAAK,GAAG,IAMlF,CAAC;AAGF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,CAAC,SAAS,KAAG,MAAM,CAAC,KAAK,GAAG,IAMlF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,mCAUlD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,qEAUpD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,UAAU,MAAM,gDAW1D,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,UAAU,MAAM,4EAW5D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,+BAUnD,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,oEAUrD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,mBAAmB,MAAM,CAAC,aAAa,KAAG,sBAAsB,GAAG,IAqChG,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,aAAa,sBAAsB,yBA+BlE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,oBAAoB,MAAM,CAAC,cAAc,KAAG,iBAAiB,GAAG,IAanG,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,cAAc,iBAAiB,KAAG,MAAM,CAAC,cAa9E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,MAAM,CAAC,aAS7D,CAAC;AAGF,eAAO,MAAM,UAAU,EAAmB,CAAC,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/dist/modules/src/misc.js

@@ -0,0 +1,255 @@
+"use strict";
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIBVPX_VP9 = exports.getChannelLayout = exports.fromAudioSampleFormat = exports.toAudioSampleFormat = exports.fromPixelFormat = exports.toPixelFormat = exports.unmapMatrixCoefficients = exports.mapMatrixCoefficients = exports.unmapTransferCharacteristics = exports.mapTransferCharacteristics = exports.unmapColorPrimaries = exports.mapColorPrimaries = exports.getHardwareEncoderCodec = exports.getHardwareDecoderCodec = exports.getHardwareContext = exports.CODEC_TO_CODEC_ID = void 0;
+const NodeAv = __importStar(require("node-av"));
+exports.CODEC_TO_CODEC_ID = {
+    avc: NodeAv.AV_CODEC_ID_H264,
+    hevc: NodeAv.AV_CODEC_ID_HEVC,
+    vp8: NodeAv.AV_CODEC_ID_VP8,
+    vp9: NodeAv.AV_CODEC_ID_VP9,
+    av1: NodeAv.AV_CODEC_ID_AV1,
+    aac: NodeAv.AV_CODEC_ID_AAC,
+    opus: NodeAv.AV_CODEC_ID_OPUS,
+    mp3: NodeAv.AV_CODEC_ID_MP3,
+    vorbis: NodeAv.AV_CODEC_ID_VORBIS,
+    flac: NodeAv.AV_CODEC_ID_FLAC,
+    ac3: NodeAv.AV_CODEC_ID_AC3,
+    eac3: NodeAv.AV_CODEC_ID_EAC3,
+};
+let cachedHardwareContext = undefined;
+const getHardwareContext = () => {
+    if (cachedHardwareContext === undefined) {
+        cachedHardwareContext = NodeAv.HardwareContext.auto();
+    }
+    return cachedHardwareContext;
+};
+exports.getHardwareContext = getHardwareContext;
+const hardwareDecoderCodecCache = new Map();
+const getHardwareDecoderCodec = (codecId) => {
+    if (!hardwareDecoderCodecCache.has(codecId)) {
+        const hw = (0, exports.getHardwareContext)();
+        hardwareDecoderCodecCache.set(codecId, hw?.getDecoderCodec(codecId) ?? null);
+    }
+    return hardwareDecoderCodecCache.get(codecId);
+};
+exports.getHardwareDecoderCodec = getHardwareDecoderCodec;
+const hardwareEncoderCodecCache = new Map();
+const getHardwareEncoderCodec = (codecId) => {
+    if (!hardwareEncoderCodecCache.has(codecId)) {
+        const hw = (0, exports.getHardwareContext)();
+        hardwareEncoderCodecCache.set(codecId, hw?.getEncoderCodec(codecId) ?? null);
+    }
+    return hardwareEncoderCodecCache.get(codecId);
+};
+exports.getHardwareEncoderCodec = getHardwareEncoderCodec;
+const mapColorPrimaries = (primaries) => {
+    switch (primaries) {
+        case 'bt709': return NodeAv.AVCOL_PRI_BT709;
+        case 'bt470bg': return NodeAv.AVCOL_PRI_BT470BG;
+        case 'smpte170m': return NodeAv.AVCOL_PRI_SMPTE170M;
+        case 'bt2020': return NodeAv.AVCOL_PRI_BT2020;
+        case 'smpte432': return NodeAv.AVCOL_PRI_SMPTE432;
+    }
+    return null;
+};
+exports.mapColorPrimaries = mapColorPrimaries;
+const unmapColorPrimaries = (primaries) => {
+    switch (primaries) {
+        case NodeAv.AVCOL_PRI_BT709: return 'bt709';
+        case NodeAv.AVCOL_PRI_BT470BG: return 'bt470bg';
+        case NodeAv.AVCOL_PRI_SMPTE170M: return 'smpte170m';
+        case NodeAv.AVCOL_PRI_BT2020: return 'bt2020';
+        case NodeAv.AVCOL_PRI_SMPTE432: return 'smpte432';
+    }
+    return null;
+};
+exports.unmapColorPrimaries = unmapColorPrimaries;
+const mapTransferCharacteristics = (transfer) => {
+    switch (transfer) {
+        case 'bt709': return NodeAv.AVCOL_TRC_BT709;
+        case 'smpte170m': return NodeAv.AVCOL_TRC_SMPTE170M;
+        case 'iec61966-2-1': return NodeAv.AVCOL_TRC_IEC61966_2_1;
+        case 'linear': return NodeAv.AVCOL_TRC_LINEAR;
+        case 'pq': return NodeAv.AVCOL_TRC_SMPTE2084;
+        case 'hlg': return NodeAv.AVCOL_TRC_ARIB_STD_B67;
+    }
+    return null;
+};
+exports.mapTransferCharacteristics = mapTransferCharacteristics;
+const unmapTransferCharacteristics = (transfer) => {
+    switch (transfer) {
+        case NodeAv.AVCOL_TRC_BT709: return 'bt709';
+        case NodeAv.AVCOL_TRC_SMPTE170M: return 'smpte170m';
+        case NodeAv.AVCOL_TRC_IEC61966_2_1: return 'iec61966-2-1';
+        case NodeAv.AVCOL_TRC_LINEAR: return 'linear';
+        case NodeAv.AVCOL_TRC_SMPTE2084: return 'pq';
+        case NodeAv.AVCOL_TRC_ARIB_STD_B67: return 'hlg';
+    }
+    return null;
+};
+exports.unmapTransferCharacteristics = unmapTransferCharacteristics;
+const mapMatrixCoefficients = (matrix) => {
+    switch (matrix) {
+        case 'rgb': return NodeAv.AVCOL_SPC_RGB;
+        case 'bt709': return NodeAv.AVCOL_SPC_BT709;
+        case 'bt470bg': return NodeAv.AVCOL_SPC_BT470BG;
+        case 'smpte170m': return NodeAv.AVCOL_SPC_SMPTE170M;
+        case 'bt2020-ncl': return NodeAv.AVCOL_SPC_BT2020_NCL;
+    }
+    return null;
+};
+exports.mapMatrixCoefficients = mapMatrixCoefficients;
+const unmapMatrixCoefficients = (matrix) => {
+    switch (matrix) {
+        case NodeAv.AVCOL_SPC_RGB: return 'rgb';
+        case NodeAv.AVCOL_SPC_BT709: return 'bt709';
+        case NodeAv.AVCOL_SPC_BT470BG: return 'bt470bg';
+        case NodeAv.AVCOL_SPC_SMPTE170M: return 'smpte170m';
+        case NodeAv.AVCOL_SPC_BT2020_NCL: return 'bt2020-ncl';
+    }
+    return null;
+};
+exports.unmapMatrixCoefficients = unmapMatrixCoefficients;
+const toPixelFormat = (ffmpegPixelFormat) => {
+    switch (ffmpegPixelFormat) {
+        case NodeAv.AV_PIX_FMT_YUV420P: return 'I420';
+        // "deprecated in favor of AV_PIX_FMT_YUV420P and setting color_range"
+        case NodeAv.AV_PIX_FMT_YUVJ420P: return 'I420';
+        case NodeAv.AV_PIX_FMT_YUV420P10LE: return 'I420P10';
+        case NodeAv.AV_PIX_FMT_YUV420P12LE: return 'I420P12';
+        case NodeAv.AV_PIX_FMT_YUVA420P: return 'I420A';
+        case NodeAv.AV_PIX_FMT_YUVA420P10LE: return 'I420AP10';
+        case NodeAv.AV_PIX_FMT_YUV422P: return 'I422';
+        // "deprecated in favor of AV_PIX_FMT_YUV422P and setting color_range"
+        case NodeAv.AV_PIX_FMT_YUVJ422P: return 'I422';
+        case NodeAv.AV_PIX_FMT_YUV422P10LE: return 'I422P10';
+        case NodeAv.AV_PIX_FMT_YUV422P12LE: return 'I422P12';
+        case NodeAv.AV_PIX_FMT_YUVA422P: return 'I422A';
+        case NodeAv.AV_PIX_FMT_YUVA422P10LE: return 'I422AP10';
+        case NodeAv.AV_PIX_FMT_YUVA422P12LE: return 'I422AP12';
+        case NodeAv.AV_PIX_FMT_YUV444P: return 'I444';
+        // "deprecated in favor of AV_PIX_FMT_YUV444P and setting color_range"
+        case NodeAv.AV_PIX_FMT_YUVJ444P: return 'I444';
+        case NodeAv.AV_PIX_FMT_YUV444P10LE: return 'I444P10';
+        case NodeAv.AV_PIX_FMT_YUV444P12LE: return 'I444P12';
+        case NodeAv.AV_PIX_FMT_YUVA444P: return 'I444A';
+        case NodeAv.AV_PIX_FMT_YUVA444P10LE: return 'I444AP10';
+        case NodeAv.AV_PIX_FMT_YUVA444P12LE: return 'I444AP12';
+        case NodeAv.AV_PIX_FMT_NV12: return 'NV12';
+        case NodeAv.AV_PIX_FMT_RGBA: return 'RGBA';
+        case NodeAv.AV_PIX_FMT_RGB0: return 'RGBX';
+        case NodeAv.AV_PIX_FMT_BGRA: return 'BGRA';
+        case NodeAv.AV_PIX_FMT_BGR0: return 'BGRX';
+        default: return null;
+    }
+};
+exports.toPixelFormat = toPixelFormat;
+const fromPixelFormat = (pixelFormat) => {
+    switch (pixelFormat) {
+        case 'I420': return NodeAv.AV_PIX_FMT_YUV420P;
+        case 'I420P10': return NodeAv.AV_PIX_FMT_YUV420P10LE;
+        case 'I420P12': return NodeAv.AV_PIX_FMT_YUV420P12LE;
+        case 'I420A': return NodeAv.AV_PIX_FMT_YUVA420P;
+        case 'I420AP10': return NodeAv.AV_PIX_FMT_YUVA420P10LE;
+        case 'I422': return NodeAv.AV_PIX_FMT_YUV422P;
+        case 'I422P10': return NodeAv.AV_PIX_FMT_YUV422P10LE;
+        case 'I422P12': return NodeAv.AV_PIX_FMT_YUV422P12LE;
+        case 'I422A': return NodeAv.AV_PIX_FMT_YUVA422P;
+        case 'I422AP10': return NodeAv.AV_PIX_FMT_YUVA422P10LE;
+        case 'I422AP12': return NodeAv.AV_PIX_FMT_YUVA422P12LE;
+        case 'I444': return NodeAv.AV_PIX_FMT_YUV444P;
+        case 'I444P10': return NodeAv.AV_PIX_FMT_YUV444P10LE;
+        case 'I444P12': return NodeAv.AV_PIX_FMT_YUV444P12LE;
+        case 'I444A': return NodeAv.AV_PIX_FMT_YUVA444P;
+        case 'I444AP10': return NodeAv.AV_PIX_FMT_YUVA444P10LE;
+        case 'I444AP12': return NodeAv.AV_PIX_FMT_YUVA444P12LE;
+        case 'NV12': return NodeAv.AV_PIX_FMT_NV12;
+        case 'RGBA': return NodeAv.AV_PIX_FMT_RGBA;
+        case 'RGBX': return NodeAv.AV_PIX_FMT_RGB0;
+        case 'BGRA': return NodeAv.AV_PIX_FMT_BGRA;
+        case 'BGRX': return NodeAv.AV_PIX_FMT_BGR0;
+        default: return NodeAv.AV_PIX_FMT_NONE;
+    }
+};
+exports.fromPixelFormat = fromPixelFormat;
+const toAudioSampleFormat = (ffmpegSampleFormat) => {
+    switch (ffmpegSampleFormat) {
+        case NodeAv.AV_SAMPLE_FMT_U8: return 'u8';
+        case NodeAv.AV_SAMPLE_FMT_S16: return 's16';
+        case NodeAv.AV_SAMPLE_FMT_S32: return 's32';
+        case NodeAv.AV_SAMPLE_FMT_FLT: return 'f32';
+        case NodeAv.AV_SAMPLE_FMT_U8P: return 'u8-planar';
+        case NodeAv.AV_SAMPLE_FMT_S16P: return 's16-planar';
+        case NodeAv.AV_SAMPLE_FMT_S32P: return 's32-planar';
+        case NodeAv.AV_SAMPLE_FMT_FLTP: return 'f32-planar';
+        default: return null;
+    }
+};
+exports.toAudioSampleFormat = toAudioSampleFormat;
+const fromAudioSampleFormat = (sampleFormat) => {
+    switch (sampleFormat) {
+        case 'u8': return NodeAv.AV_SAMPLE_FMT_U8;
+        case 's16': return NodeAv.AV_SAMPLE_FMT_S16;
+        case 's32': return NodeAv.AV_SAMPLE_FMT_S32;
+        case 'f32': return NodeAv.AV_SAMPLE_FMT_FLT;
+        case 'u8-planar': return NodeAv.AV_SAMPLE_FMT_U8P;
+        case 's16-planar': return NodeAv.AV_SAMPLE_FMT_S16P;
+        case 's32-planar': return NodeAv.AV_SAMPLE_FMT_S32P;
+        case 'f32-planar': return NodeAv.AV_SAMPLE_FMT_FLTP;
+        default: return NodeAv.AV_SAMPLE_FMT_NONE;
+    }
+};
+exports.fromAudioSampleFormat = fromAudioSampleFormat;
+const getChannelLayout = (numChannels) => {
+    switch (numChannels) {
+        case 1: return NodeAv.AV_CHANNEL_LAYOUT_MONO;
+        case 2: return NodeAv.AV_CHANNEL_LAYOUT_STEREO;
+        case 4: return NodeAv.AV_CHANNEL_LAYOUT_QUAD;
+        case 6: return NodeAv.AV_CHANNEL_LAYOUT_5POINT1_BACK;
+        case 8: return NodeAv.AV_CHANNEL_LAYOUT_7POINT1;
+        default: return { nbChannels: numChannels, order: NodeAv.AV_CHANNEL_ORDER_UNSPEC, mask: 0n };
+    }
+};
+exports.getChannelLayout = getChannelLayout;
+// The value is incorrect in the node-av source code, so we do:
+exports.LIBVPX_VP9 = 'libvpx-vp9';

package/dist/modules/src/video-decoder.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Copyright (c) 2026-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import { CustomVideoDecoder, VideoCodec, EncodedPacket, type MaybePromise, Rational } from 'mediabunny';
+import * as NodeAv from 'node-av';
+export declare class NodeAvVideoDecoder extends CustomVideoDecoder {
+    frame: NodeAv.Frame;
+    packet: NodeAv.Packet;
+    codecContext: NodeAv.CodecContext | null;
+    pixelAspectRatio: Rational;
+    preciseTimings: {
+        microsecondTimestamp: number;
+        timestamp: number;
+        duration: number;
+        timestampIsValid: boolean;
+        durationIsValid: boolean;
+    }[];
+    static supports(codec: VideoCodec, config: VideoDecoderConfig): boolean;
+    init(): Promise<void>;
+    initCodecContext(packet: EncodedPacket): Promise<void>;
+    decode(packet: EncodedPacket): Promise<void>;
+    receiveFrame(ret: number): void;
+    flush(): Promise<void>;
+    close(): MaybePromise<void>;
+}
+//# sourceMappingURL=video-decoder.d.ts.map

package/dist/modules/src/video-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-decoder.d.ts","sourceRoot":"","sources":["../../../src/video-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAe,KAAK,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,KAAK,MAAM,MAAM,SAAS,CAAC;AAKlC,qBAAa,kBAAmB,SAAQ,kBAAkB;IACzD,KAAK,EAAG,MAAM,CAAC,KAAK,CAAC;IACrB,MAAM,EAAG,MAAM,CAAC,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAQ;IAChD,gBAAgB,EAAG,QAAQ,CAAC;IAG5B,cAAc,EAAE;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,eAAe,EAAE,OAAO,CAAC;KACzB,EAAE,CAAM;WAGO,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO;IAI1E,IAAI;IAOJ,gBAAgB,CAAC,MAAM,EAAE,aAAa;IAiDtC,MAAM,CAAC,MAAM,EAAE,aAAa;IAkElC,YAAY,CAAC,GAAG,EAAE,MAAM;IAuClB,KAAK;IAuBX,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC;CAK3B"}