@nodetool-ai/runtime 0.8.7 → 0.8.9-beta.1

package/dist/media/frames.js

@@ -0,0 +1,112 @@
+/**
+ * Video frames as PNG files, the in-process form of `ffmpeg -i in -vf <filter>
+ * frame_%d.png`, `-ss T -i in -frames:v 1 frame.png` and `-sseof`.
+ */
+import { Encoder } from "node-av";
+import { abortError, findEncoder, quietLibav } from "./av.js";
+import { openFilterGraph } from "./filter-graph.js";
+/**
+ * One frame as a PNG file. One encoder per frame: a PNG is a whole file, and
+ * the encoder's options (size, format) are fixed when it opens.
+ */
+async function encodePng(frame, signal) {
+    const codec = findEncoder("png");
+    if (!codec)
+        throw new Error("This libav build has no PNG encoder");
+    const encoder = await Encoder.create(codec, { signal });
+    try {
+        const packets = [...(await encoder.encodeAll(frame)), ...(await encoder.encodeAll(null))];
+        const parts = [];
+        for (const packet of packets) {
+            if (packet.data)
+                parts.push(new Uint8Array(packet.data));
+            packet.free();
+        }
+        if (parts.length !== 1)
+            throw new Error("The PNG encoder wrote no picture");
+        return parts[0];
+    }
+    finally {
+        encoder.close();
+    }
+}
+/**
+ * PNG bytes of every frame `filter` passes, in order. Frames are RGB, or RGBA
+ * with `alpha`, as the CLI's PNG encoder chose from the source. `seekSec`
+ * starts at the frame shown at that time; `limit` stops after that many.
+ * Yields nothing when the file has no video stream.
+ */
+export async function* pngFrames(opts) {
+    const { signal } = opts;
+    quietLibav();
+    const seekSec = opts.seekSec && opts.seekSec > 0 ? opts.seekSec : 0;
+    const run = await openFilterGraph({
+        filePath: opts.filePath,
+        kind: "video",
+        filter: [
+            seekSec > 0 ? "trim=start=0" : null,
+            opts.filter,
+            `format=${opts.alpha ? "rgba" : "rgb24"}`
+        ]
+            .filter((step) => step)
+            .join(","),
+        seekSec,
+        signal
+    });
+    if (!run)
+        return;
+    const limit = opts.limit ?? Number.POSITIVE_INFINITY;
+    let count = 0;
+    try {
+        for await (const frame of run.frames()) {
+            try {
+                if (signal?.aborted)
+                    throw abortError(signal);
+                if (count >= limit)
+                    break;
+                yield await encodePng(frame, signal);
+                count += 1;
+            }
+            finally {
+                frame.free();
+            }
+        }
+    }
+    finally {
+        await run.close();
+    }
+}
+/**
+ * The last frame of `filePath` as PNG, or null when it has no picture: the
+ * in-process form of `ffmpeg -sseof -1 -i in -update 1 -frames:v 1 out.png`.
+ * Decodes only the last `tailSec` seconds.
+ */
+export async function lastFramePng(opts) {
+    const { signal } = opts;
+    quietLibav();
+    const seekSec = Math.max(0, (opts.durationSec ?? 0) - (opts.tailSec ?? 1));
+    const run = await openFilterGraph({
+        filePath: opts.filePath,
+        kind: "video",
+        filter: [seekSec > 0 ? "trim=start=0" : null, `format=${opts.alpha ? "rgba" : "rgb24"}`]
+            .filter((step) => step)
+            .join(","),
+        seekSec,
+        signal
+    });
+    if (!run)
+        return null;
+    let last = null;
+    try {
+        for await (const frame of run.frames()) {
+            last?.free();
+            last = frame;
+        }
+        return last ? await encodePng(last, signal) : null;
+    }
+    finally {
+        last?.free();
+        await run.close();
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/media/frames.js.map

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

package/dist/media/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * In-process media: probes, decode, filter graphs and encode without the
+ * `ffmpeg` and `ffprobe` binaries.
+ *
+ * Mediabunny handles probes, timestamp decode, trims and whole-file
+ * conversions. node-av, the same libav Mediabunny's server adapter runs on,
+ * handles filter graphs, the audio mix, and raw RGBA decode and encode, so the
+ * CLI's filter strings and swscale flags carry over unchanged.
+ *
+ * Node only: every function here loads a native addon.
+ */
+export { hasEncoder, hasFilter } from "./codecs.js";
+export { packetTimes, probeDurationSec, probeHasAudio, probeMedia, probeVideoStream, type AudioStreamInfo, type MediaProbe, type MediaSource, type ProbeOptions, type VideoStreamInfo } from "./probe.js";
+export { decodeAudioChunks, decodeAudioToPcm, type PcmAudio, type PcmOptions } from "./audio.js";
+export { openFilterComplex, openFilterGraph, type FilterComplexInput, type FilterRun } from "./filter-graph.js";
+export { openDecodedStream, type DecodedStream, type MediaKind } from "./decode.js";
+export { openRgbaFrameReader, openVideoFrameEncoder, type RgbaFrame, type RgbaFrameReader, type VideoEncoderSpec, type VideoFrameEncoder } from "./rgba.js";
+export { copyContainerFor, muxAudioWithVideoCopy, muxStreamCopy, streamCodecs, type CopyContainer } from "./mux.js";
+export { convertAudioToWav, ensureMediabunnyServer, trimVideo } from "./convert.js";
+export { transcodeVideo } from "./transcode.js";
+export { AudioEncoder } from "./audio-encoder.js";
+export { concatCopy, concatSegments, type ConcatSegment } from "./concat.js";
+export { lastFramePng, pngFrames } from "./frames.js";
+export { verifyDecodes } from "./verify.js";
+export { DEFAULT_VIDEO_ENCODER, transformMedia, type StreamPlan, type TransformInput } from "./transform.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC"}

package/dist/media/index.js

@@ -0,0 +1,26 @@
+/**
+ * In-process media: probes, decode, filter graphs and encode without the
+ * `ffmpeg` and `ffprobe` binaries.
+ *
+ * Mediabunny handles probes, timestamp decode, trims and whole-file
+ * conversions. node-av, the same libav Mediabunny's server adapter runs on,
+ * handles filter graphs, the audio mix, and raw RGBA decode and encode, so the
+ * CLI's filter strings and swscale flags carry over unchanged.
+ *
+ * Node only: every function here loads a native addon.
+ */
+export { hasEncoder, hasFilter } from "./codecs.js";
+export { packetTimes, probeDurationSec, probeHasAudio, probeMedia, probeVideoStream } from "./probe.js";
+export { decodeAudioChunks, decodeAudioToPcm } from "./audio.js";
+export { openFilterComplex, openFilterGraph } from "./filter-graph.js";
+export { openDecodedStream } from "./decode.js";
+export { openRgbaFrameReader, openVideoFrameEncoder } from "./rgba.js";
+export { copyContainerFor, muxAudioWithVideoCopy, muxStreamCopy, streamCodecs } from "./mux.js";
+export { convertAudioToWav, ensureMediabunnyServer, trimVideo } from "./convert.js";
+export { transcodeVideo } from "./transcode.js";
+export { AudioEncoder } from "./audio-encoder.js";
+export { concatCopy, concatSegments } from "./concat.js";
+export { lastFramePng, pngFrames } from "./frames.js";
+export { verifyDecodes } from "./verify.js";
+export { DEFAULT_VIDEO_ENCODER, transformMedia } from "./transform.js";
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,gBAAgB,EAMjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EAGhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAsC,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EAKtB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,YAAY,EAEb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,cAAc,EAGf,MAAM,gBAAgB,CAAC"}

package/dist/media/mux.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Encode filtered audio onto an existing video without re-encoding the
+ * picture: the in-process form of `ffmpeg -i base ... -map 0:v -map [aout]
+ * -c:v copy -c:a <codec> -shortest out`.
+ */
+import { type Frame } from "node-av";
+/**
+ * Copy `videoPath`'s video stream into `outPath` and encode `audio` beside it
+ * as `codec` at `sampleRate`, stereo. The audio is cut at the end of the
+ * picture, as `-shortest` cut it, so a padded mix never outlasts the video.
+ * `audio`'s frames are consumed and freed.
+ */
+export declare function muxAudioWithVideoCopy(opts: {
+    videoPath: string;
+    audio: AsyncIterable<Frame>;
+    outPath: string;
+    codec: string;
+    sampleRate: number;
+    signal?: AbortSignal;
+}): Promise<void>;
+/** The video and audio codec of a file, in libav's names; `null` for none. */
+export declare function streamCodecs(filePath: string, signal?: AbortSignal): Promise<{
+    video: string | null;
+    audio: string | null;
+}>;
+/** A container `muxStreamCopy` writes. */
+export type CopyContainer = "mp4" | "mov" | "webm" | "mkv";
+/**
+ * The container a stream copy of `video` and `audio` goes into, as yt-dlp
+ * picked one when it merged: WebM when both are WebM codecs, else MP4 when
+ * MP4 holds both, else Matroska, which holds anything.
+ */
+export declare function copyContainerFor(video: string | null, audio: string | null): CopyContainer;
+/**
+ * Copy the video stream of `videoPath` and the audio stream of `audioPath`
+ * into one file, packets unchanged: the in-process form of
+ * `ffmpeg -i v -i a -map 0:v -map 1:a -c copy out`, which is what yt-dlp ran
+ * to merge formats.
+ *
+ * `container` is `auto` (see {@link copyContainerFor}) or a
+ * {@link CopyContainer}; the output is `<outStem>.<container>`. A container
+ * that cannot hold the codecs without re-encoding throws an error naming
+ * both codecs and the container, before any file is written. When the two
+ * paths are the same file, its audio stream is optional.
+ */
+export declare function muxStreamCopy(opts: {
+    videoPath: string;
+    audioPath: string;
+    outStem: string;
+    container: string;
+    signal?: AbortSignal;
+}): Promise<{
+    outPath: string;
+    container: CopyContainer;
+    video: string;
+    audio: string | null;
+}>;
+//# sourceMappingURL=mux.d.ts.map

package/dist/media/mux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux.d.ts","sourceRoot":"","sources":["../../src/media/mux.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA2B,KAAK,KAAK,EAAe,MAAM,SAAS,CAAC;AA2C3E;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFhB;AAED,8EAA8E;AAC9E,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAUzD;AAED,0CAA0C;AAC1C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AA8B3D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAI1F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAuC9F"}

package/dist/media/mux.js

@@ -0,0 +1,234 @@
+/**
+ * Encode filtered audio onto an existing video without re-encoding the
+ * picture: the in-process form of `ffmpeg -i base ... -map 0:v -map [aout]
+ * -c:v copy -c:a <codec> -shortest out`.
+ */
+import { avGetCodecName, Demuxer } from "node-av";
+import { AudioEncoder } from "./audio-encoder.js";
+import { abortError, openFileMuxer, quietLibav, startTimeSeconds, throwIfAborted } from "./av.js";
+import { transformMedia } from "./transform.js";
+function seconds(ts, timeBase) {
+    return (Number(ts) * timeBase.num) / timeBase.den;
+}
+/** The end of the video stream in seconds: last packet's pts plus its duration. */
+async function videoEndSec(filePath, signal) {
+    const demuxer = await Demuxer.open(filePath, { signal });
+    try {
+        const stream = demuxer.video();
+        if (!stream)
+            throw new Error(`${filePath} has no video stream`);
+        const formatStart = startTimeSeconds(demuxer.getFormatContext().startTime, {
+            num: 1,
+            den: 1_000_000
+        });
+        let end = 0;
+        for await (const packet of demuxer.packets(stream.index)) {
+            if (!packet)
+                continue;
+            throwIfAborted(signal);
+            end = Math.max(end, seconds(packet.pts + packet.duration, stream.timeBase) - formatStart);
+            packet.free();
+        }
+        return end;
+    }
+    finally {
+        await demuxer.close();
+    }
+}
+/**
+ * Copy `videoPath`'s video stream into `outPath` and encode `audio` beside it
+ * as `codec` at `sampleRate`, stereo. The audio is cut at the end of the
+ * picture, as `-shortest` cut it, so a padded mix never outlasts the video.
+ * `audio`'s frames are consumed and freed.
+ */
+export async function muxAudioWithVideoCopy(opts) {
+    const { signal } = opts;
+    quietLibav();
+    throwIfAborted(signal);
+    const endSec = await videoEndSec(opts.videoPath, signal);
+    const demuxer = await Demuxer.open(opts.videoPath, { signal });
+    let output = null;
+    let audioEncoder = null;
+    try {
+        const videoStream = demuxer.video();
+        if (!videoStream)
+            throw new Error(`${opts.videoPath} has no video stream`);
+        output = await openFileMuxer(opts.outPath, { signal });
+        const videoIndex = output.muxer.addStream(videoStream);
+        // The CLI converted at the output: `-ar` and `-ac 2` after the graph.
+        audioEncoder = await AudioEncoder.create(opts.codec, {
+            sampleRate: opts.sampleRate,
+            channels: 2,
+            signal
+        });
+        const audioIndex = output.muxer.addStream(audioEncoder.encoder);
+        const activeEncoder = audioEncoder;
+        const activeOutput = output;
+        const formatStart = startTimeSeconds(demuxer.getFormatContext().startTime, {
+            num: 1,
+            den: 1_000_000
+        });
+        const videoPackets = demuxer.packets(videoStream.index);
+        let pendingVideo = null;
+        let videoDone = false;
+        const nextVideo = async () => {
+            while (!pendingVideo && !videoDone) {
+                const { value, done } = await videoPackets.next();
+                if (done)
+                    videoDone = true;
+                else if (value)
+                    pendingVideo = value;
+            }
+        };
+        const pendingVideoSec = () => pendingVideo
+            ? seconds(pendingVideo.dts ?? pendingVideo.pts, videoStream.timeBase) - formatStart
+            : Number.POSITIVE_INFINITY;
+        /** Write every video packet that sorts before `untilSec`. */
+        const drainVideo = async (untilSec) => {
+            await nextVideo();
+            while (pendingVideo && pendingVideoSec() <= untilSec) {
+                const packet = pendingVideo;
+                pendingVideo = null;
+                await activeOutput.muxer.writePacket(packet, videoIndex);
+                packet.free();
+                await nextVideo();
+            }
+        };
+        const writePackets = async (packets) => {
+            for (const packet of packets) {
+                await drainVideo(seconds(packet.pts, packet.timeBase));
+                await activeOutput.muxer.writePacket(packet, audioIndex);
+                packet.free();
+            }
+        };
+        for await (const mixed of opts.audio) {
+            try {
+                if (signal?.aborted)
+                    throw abortError(signal);
+                const startSec = seconds(mixed.pts, mixed.timeBase);
+                if (startSec >= endSec)
+                    break;
+                const samples = mixed.nbSamples;
+                const keep = Math.min(samples, Math.ceil((endSec - startSec) * mixed.sampleRate));
+                if (keep < samples) {
+                    // The frame crosses the end of the picture: keep only what lies before it.
+                    mixed.nbSamples = keep;
+                }
+                await writePackets(await activeEncoder.encode(mixed));
+                if (keep < samples)
+                    break;
+            }
+            finally {
+                mixed.free();
+            }
+        }
+        await writePackets(await activeEncoder.flush());
+        await drainVideo(Number.POSITIVE_INFINITY);
+        await output.close();
+    }
+    finally {
+        audioEncoder?.close();
+        await output?.close();
+        await demuxer.close();
+    }
+}
+/** The video and audio codec of a file, in libav's names; `null` for none. */
+export async function streamCodecs(filePath, signal) {
+    quietLibav();
+    const demuxer = await Demuxer.open(filePath, { signal });
+    try {
+        const name = (stream) => stream ? (avGetCodecName(stream.codecpar.codecId) ?? "unknown") : null;
+        return { video: name(demuxer.video()), audio: name(demuxer.audio()) };
+    }
+    finally {
+        await demuxer.close();
+    }
+}
+/** The codecs each container takes without re-encoding; `null` takes any. */
+const COPY_CODECS = {
+    mp4: {
+        video: new Set(["h264", "hevc", "av1", "vp9", "mpeg4"]),
+        audio: new Set(["aac", "mp3", "opus", "flac", "alac", "ac3", "eac3"])
+    },
+    mov: {
+        video: new Set(["h264", "hevc", "av1", "vp9", "mpeg4", "prores"]),
+        audio: new Set(["aac", "mp3", "opus", "flac", "alac", "ac3", "eac3", "pcm_s16le"])
+    },
+    webm: {
+        video: new Set(["vp8", "vp9", "av1"]),
+        audio: new Set(["opus", "vorbis"])
+    },
+    mkv: null
+};
+function isCopyContainer(name) {
+    return Object.hasOwn(COPY_CODECS, name);
+}
+/** Whether `container` holds `video` and `audio` (either may be absent) as they are. */
+function holds(container, video, audio) {
+    const codecs = COPY_CODECS[container];
+    if (!codecs)
+        return true;
+    return (!video || codecs.video.has(video)) && (!audio || codecs.audio.has(audio));
+}
+/**
+ * The container a stream copy of `video` and `audio` goes into, as yt-dlp
+ * picked one when it merged: WebM when both are WebM codecs, else MP4 when
+ * MP4 holds both, else Matroska, which holds anything.
+ */
+export function copyContainerFor(video, audio) {
+    if (holds("webm", video, audio))
+        return "webm";
+    if (holds("mp4", video, audio))
+        return "mp4";
+    return "mkv";
+}
+/**
+ * Copy the video stream of `videoPath` and the audio stream of `audioPath`
+ * into one file, packets unchanged: the in-process form of
+ * `ffmpeg -i v -i a -map 0:v -map 1:a -c copy out`, which is what yt-dlp ran
+ * to merge formats.
+ *
+ * `container` is `auto` (see {@link copyContainerFor}) or a
+ * {@link CopyContainer}; the output is `<outStem>.<container>`. A container
+ * that cannot hold the codecs without re-encoding throws an error naming
+ * both codecs and the container, before any file is written. When the two
+ * paths are the same file, its audio stream is optional.
+ */
+export async function muxStreamCopy(opts) {
+    const { signal } = opts;
+    const sameFile = opts.videoPath === opts.audioPath;
+    const video = (await streamCodecs(opts.videoPath, signal)).video;
+    if (!video)
+        throw new Error(`${opts.videoPath} has no video stream`);
+    const audio = (await streamCodecs(opts.audioPath, signal)).audio;
+    if (!audio && !sameFile)
+        throw new Error(`${opts.audioPath} has no audio stream`);
+    const requested = opts.container.trim().toLowerCase().replace(/^\./, "");
+    const container = requested === "" || requested === "auto" ? copyContainerFor(video, audio) : requested;
+    if (!isCopyContainer(container)) {
+        throw new Error(`Cannot write container "${opts.container}": use auto, mp4, mov, webm or mkv`);
+    }
+    const pair = audio ? `${video} video with ${audio} audio` : `${video} video`;
+    if (!holds(container, video, audio)) {
+        throw new Error(`Cannot stream-copy ${pair} into ${container} without re-encoding. ` +
+            `Use container auto or mkv.`);
+    }
+    const outPath = `${opts.outStem}.${container}`;
+    try {
+        await transformMedia({
+            inputs: [{ filePath: opts.videoPath }, { filePath: opts.audioPath }],
+            outPath,
+            video: { copy: 0 },
+            audio: { copy: 1, optional: sameFile },
+            signal
+        });
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw error;
+        throw new Error(`Could not stream-copy ${pair} into ${container}: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+    return { outPath, container, video, audio };
+}
+//# sourceMappingURL=mux.js.map

package/dist/media/mux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux.js","sourceRoot":"","sources":["../../src/media/mux.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,OAAO,EAA2B,MAAM,SAAS,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,cAAc,EAEf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,SAAS,OAAO,CAAC,EAAU,EAAE,QAAsC;IACjE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,mFAAmF;AACnF,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAoB;IAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,sBAAsB,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE;YACzE,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;QACH,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,GAAG,GAAG,IAAI,CAAC,GAAG,CACZ,GAAG,EACH,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CACrE,CAAC;YACF,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAO3C;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC;IACb,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,YAAY,GAAwB,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,sBAAsB,CAAC,CAAC;QAC3E,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvD,sEAAsE;QACtE,YAAY,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE;YACnD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,CAAC;YACX,MAAM;SACP,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,aAAa,GAAG,YAAY,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,CAAC;QAC5B,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE;YACzE,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;YAC1C,OAAO,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;gBAClD,IAAI,IAAI;oBAAE,SAAS,GAAG,IAAI,CAAC;qBACtB,IAAI,KAAK;oBAAE,YAAY,GAAG,KAAK,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,eAAe,GAAG,GAAW,EAAE,CACnC,YAAY;YACV,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW;YACnF,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC/B,6DAA6D;QAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;YAC3D,MAAM,SAAS,EAAE,CAAC;YAClB,OAAO,YAAY,IAAI,eAAe,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACrD,MAAM,MAAM,GAAW,YAAY,CAAC;gBACpC,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,SAAS,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,KAAK,EAAE,OAAiB,EAAiB,EAAE;YAC9D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvD,MAAM,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,IAAI,MAAM,EAAE,OAAO;oBAAE,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpD,IAAI,QAAQ,IAAI,MAAM;oBAAE,MAAM;gBAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;gBAClF,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;oBACnB,2EAA2E;oBAC3E,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;gBACzB,CAAC;gBACD,MAAM,YAAY,CAAC,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtD,IAAI,IAAI,GAAG,OAAO;oBAAE,MAAM;YAC5B,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QACD,MAAM,YAAY,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,MAAM,UAAU,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,YAAY,EAAE,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,MAAoB;IAEpB,UAAU,EAAE,CAAC;IACb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAoC,EAAiB,EAAE,CACnE,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAKD,6EAA6E;AAC7E,MAAM,WAAW,GAA6E;IAC5F,GAAG,EAAE;QACH,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;KACtE;IACD,GAAG,EAAE;QACH,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjE,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;KACnF;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACrC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KACnC;IACD,GAAG,EAAE,IAAI;CACV,CAAC;AAEF,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,wFAAwF;AACxF,SAAS,KAAK,CAAC,SAAwB,EAAE,KAAoB,EAAE,KAAoB;IACjF,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB,EAAE,KAAoB;IACzE,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAMnC;IACC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,sBAAsB,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,sBAAsB,CAAC,CAAC;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,SAAS,GACb,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,SAAS,oCAAoC,CAC9E,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC;IAC7E,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,SAAS,SAAS,wBAAwB;YAClE,4BAA4B,CAC/B,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,cAAc,CAAC;YACnB,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACpE,OAAO;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YAClB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACtC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,KAAK,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,SAAS,SAAS,IAAI;YACjD,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC"}

package/dist/media/probe.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Container probes on Mediabunny: duration, picture size, frame rates,
+ * streams and packet timestamps, read without decoding anything.
+ */
+/** A file path or the file's bytes. */
+export type MediaSource = string | Uint8Array;
+export interface VideoStreamInfo {
+    codec: string | null;
+    /** Coded size before rotation, as ffprobe's `stream=width,height` reports it. */
+    width: number;
+    height: number;
+    /** Size after rotation metadata is applied. */
+    displayWidth: number;
+    displayHeight: number;
+    rotation: number;
+    /**
+     * The rate of the timestamp lattice the frames sit on, or `null` when the
+     * frames sit on none (a truly variable-rate source). Frames may be missing
+     * from the lattice: a 60 fps grid with two frames of every five kept still
+     * reports 60. This is what ffprobe calls `r_frame_rate` for files whose
+     * header carries a real rate.
+     */
+    nominalFps: number | null;
+    /** Frames per second over the probed packets, as ffprobe's `avg_frame_rate`. */
+    averageFps: number;
+    /** True only when every lattice slot holds a frame. */
+    constantFrameRate: boolean;
+    /** Whether the frames may carry alpha (a `yuva*` or RGBA stream). */
+    alpha: boolean;
+    /** Ticks per second of the track's timestamps. */
+    timeResolution: number;
+}
+export interface AudioStreamInfo {
+    codec: string | null;
+    sampleRate: number;
+    channels: number;
+}
+export interface MediaProbe {
+    /** Container name, e.g. `MP4`, `Matroska`, `WAVE`. */
+    format: string;
+    /** End of the last packet in seconds, or `null` when it cannot be known. */
+    durationSec: number | null;
+    video: VideoStreamInfo | null;
+    audio: AudioStreamInfo | null;
+}
+export interface ProbeOptions {
+    signal?: AbortSignal;
+    /**
+     * How many video packets the frame-rate measurement reads. Mediabunny needs
+     * about 256 for a reliable answer. `Infinity` reads the whole track.
+     */
+    frameRatePackets?: number;
+}
+/**
+ * Read `source`'s streams and timing. Throws when the bytes are not a
+ * container Mediabunny recognizes; callers that treat unreadable media as
+ * "no audio" or "no duration" catch that.
+ */
+export declare function probeMedia(source: MediaSource, options?: ProbeOptions): Promise<MediaProbe>;
+/**
+ * `source`'s duration in seconds, or `null` when it is not media Mediabunny
+ * reads or names no duration. An abort still throws.
+ */
+export declare function probeDurationSec(source: MediaSource, options?: ProbeOptions): Promise<number | null>;
+/**
+ * Whether `source` has an audio stream. Media Mediabunny cannot read has
+ * none. An abort still throws.
+ */
+export declare function probeHasAudio(source: MediaSource, options?: ProbeOptions): Promise<boolean>;
+/**
+ * `source`'s primary video stream, or `null` when it has none or is not media
+ * Mediabunny reads. An abort still throws.
+ */
+export declare function probeVideoStream(source: MediaSource, options?: ProbeOptions): Promise<VideoStreamInfo | null>;
+/**
+ * Presentation timestamps of the primary video track's packets in seconds, in
+ * file (decode) order, as ffprobe's `packet=pts_time` lists them. `null` when
+ * there is no video track or the track has more than `maxPackets` packets.
+ */
+export declare function packetTimes(source: MediaSource, options?: {
+    signal?: AbortSignal;
+    maxPackets?: number;
+}): Promise<number[] | null>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/media/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/media/probe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAmDrB;AAkBD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAEjC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAmB1B"}