@nodetool-ai/runtime 0.8.8 → 0.8.9-beta.2

package/dist/media/testing.js

@@ -0,0 +1,343 @@
+/**
+ * Test media without the ffmpeg CLI: generate inputs from libavfilter
+ * sources (`testsrc2`, `color`, `sine`, `anullsrc`) or from RGBA frames, and
+ * measure outputs (duration, size, frame times, pixels, PCM loudness).
+ *
+ * These run on the same node-av build the server uses, so a test that passes
+ * here needs no `ffmpeg` on PATH.
+ */
+import { ALL_FORMATS, EncodedPacketSink, FilePathSource, Input } from "mediabunny";
+import { avGetCodecName, avGetPixFmtName, Decoder, Demuxer, Encoder, FilterAPI } from "node-av";
+import { findEncoder, openFileMuxer, quietLibav } from "./av.js";
+import { decodeAudioToPcm } from "./audio.js";
+import { AudioEncoder } from "./audio-encoder.js";
+import { packetTimes, probeMedia } from "./probe.js";
+import { openRgbaFrameReader, openVideoFrameEncoder } from "./rgba.js";
+async function encodeSource(stream, kind, output) {
+    const codecName = stream.codec ?? (kind === "video" ? "libx264" : "aac");
+    const demuxer = await Demuxer.open(stream.source, { format: "lavfi" });
+    const source = demuxer.streams[0];
+    if (!source) {
+        await demuxer.close();
+        throw new Error(`lavfi source produced no stream: ${stream.source}`);
+    }
+    const decoder = await Decoder.create(source);
+    const steps = [stream.filter, kind === "video" ? `format=${stream.pixelFormat ?? "yuv420p"}` : undefined];
+    const chain = steps.filter((step) => Boolean(step)).join(",");
+    const filter = FilterAPI.create(chain.length > 0 ? chain : kind === "video" ? "null" : "anull");
+    let encode;
+    let flush;
+    let closeEncoder;
+    let index;
+    if (kind === "video") {
+        const codec = findEncoder(codecName);
+        if (!codec)
+            throw new Error(`This libav build has no ${codecName} encoder`);
+        const encoder = await Encoder.create(codec, { options: stream.options });
+        // The muxer sets the global-header flag, which only an unopened encoder takes.
+        index = output.muxer.addStream(encoder);
+        encode = (frame) => encoder.encodeAll(frame);
+        flush = () => encoder.encodeAll(null);
+        closeEncoder = () => encoder.close();
+    }
+    else {
+        const encoder = await AudioEncoder.create(codecName, {
+            sampleRate: source.codecpar.sampleRate,
+            channels: source.codecpar.channels,
+            options: stream.options
+        });
+        index = output.muxer.addStream(encoder.encoder);
+        encode = (frame) => encoder.encode(frame);
+        flush = () => encoder.flush();
+        closeEncoder = () => encoder.close();
+    }
+    const packets = [];
+    try {
+        for await (const decoded of decoder.frames(demuxer.packets(source.index))) {
+            if (!decoded)
+                continue;
+            for (const frame of await filter.processAll(decoded)) {
+                packets.push(...(await encode(frame)));
+                frame.free();
+            }
+            decoded.free();
+        }
+        for (const frame of await filter.processAll(null)) {
+            packets.push(...(await encode(frame)));
+            frame.free();
+        }
+        packets.push(...(await flush()));
+    }
+    finally {
+        filter.close();
+        decoder.close();
+        await demuxer.close();
+    }
+    return {
+        packets,
+        index,
+        close() {
+            for (const packet of packets)
+                packet.free();
+            closeEncoder();
+        }
+    };
+}
+/**
+ * Write a file holding the given streams, as
+ * `ffmpeg -f lavfi -i <video> -f lavfi -i <audio> <encoder args> out` did.
+ */
+export async function generateMedia(opts) {
+    quietLibav();
+    if (!opts.video && !opts.audio)
+        throw new Error("Give a video or an audio stream");
+    const output = await openFileMuxer(opts.outPath, { muxerOptions: opts.muxerOptions });
+    const encoded = [];
+    try {
+        if (opts.video)
+            encoded.push(await encodeSource(opts.video, "video", output));
+        if (opts.audio)
+            encoded.push(await encodeSource(opts.audio, "audio", output));
+        const timed = [];
+        for (const { packets, index } of encoded) {
+            for (const packet of packets) {
+                const { timeBase } = packet;
+                timed.push({
+                    packet,
+                    stream: index,
+                    sec: (Number(packet.dts) * timeBase.num) / timeBase.den
+                });
+            }
+        }
+        timed.sort((a, b) => a.sec - b.sec);
+        for (const { packet, stream } of timed) {
+            await output.muxer.writePacket(packet, stream);
+        }
+        await output.close();
+    }
+    finally {
+        await output.close();
+        for (const source of encoded)
+            source.close();
+    }
+}
+/**
+ * Encode frames produced by `frameAt` (packed RGBA8) at `fps`. Defaults to
+ * lossless FFV1 so a test reads back exactly what it wrote.
+ */
+export async function writeRgbaVideo(opts) {
+    const encoder = await openVideoFrameEncoder({
+        outPath: opts.outPath,
+        fps: opts.fps,
+        input: "rgba",
+        width: opts.width,
+        height: opts.height,
+        spec: opts.spec ?? { codec: "ffv1", pixelFormat: "bgra", options: { level: "3" } }
+    });
+    try {
+        for (let index = 0; index < opts.frames; index++) {
+            await encoder.write(opts.frameAt(index));
+        }
+        await encoder.finish();
+    }
+    catch (error) {
+        await encoder.abort();
+        throw error;
+    }
+}
+/** A solid RGBA frame. */
+export function solidRgba(width, height, [r, g, b, a]) {
+    const frame = new Uint8Array(width * height * 4);
+    for (let i = 0; i < frame.length; i += 4) {
+        frame[i] = r;
+        frame[i + 1] = g;
+        frame[i + 2] = b;
+        frame[i + 3] = a;
+    }
+    return frame;
+}
+/** Write 16-bit PCM WAV bytes for interleaved float `samples`. */
+export function encodeWav(samples, sampleRate, channels) {
+    const data = samples.length * 2;
+    const bytes = new Uint8Array(44 + data);
+    const view = new DataView(bytes.buffer);
+    const ascii = (offset, text) => {
+        for (let i = 0; i < text.length; i++)
+            view.setUint8(offset + i, text.charCodeAt(i));
+    };
+    ascii(0, "RIFF");
+    view.setUint32(4, 36 + data, true);
+    ascii(8, "WAVE");
+    ascii(12, "fmt ");
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true);
+    view.setUint16(22, channels, true);
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * channels * 2, true);
+    view.setUint16(32, channels * 2, true);
+    view.setUint16(34, 16, true);
+    ascii(36, "data");
+    view.setUint32(40, data, true);
+    for (let i = 0; i < samples.length; i++) {
+        const clamped = Math.max(-1, Math.min(1, samples[i] ?? 0));
+        view.setInt16(44 + i * 2, Math.round(clamped * 32767), true);
+    }
+    return bytes;
+}
+/** Interleaved samples of a sine, or silence at `amplitude: 0`. */
+export function sineSamples(opts) {
+    const frames = Math.round(opts.sampleRate * opts.durationSec);
+    const amplitude = opts.amplitude ?? 0.5;
+    const samples = new Float32Array(frames * opts.channels);
+    for (let i = 0; i < frames; i++) {
+        const value = amplitude * Math.sin((2 * Math.PI * opts.frequency * i) / opts.sampleRate);
+        for (let c = 0; c < opts.channels; c++)
+            samples[i * opts.channels + c] = value;
+    }
+    return samples;
+}
+/** Probe `filePath` and list its video frame times. */
+export async function inspectMedia(filePath) {
+    const probe = await probeMedia(filePath, { frameRatePackets: Number.POSITIVE_INFINITY });
+    const times = probe.video ? ((await packetTimes(filePath)) ?? []) : [];
+    return { ...probe, frameTimes: [...times].sort((a, b) => a - b) };
+}
+/**
+ * Every video packet's presentation time (seconds, rounded to the
+ * microsecond as ffprobe prints `pts_time`) and keyframe flag, in
+ * presentation order.
+ */
+export async function videoPacketInfo(filePath) {
+    const input = new Input({ source: new FilePathSource(filePath), formats: ALL_FORMATS });
+    try {
+        const track = await input.getPrimaryVideoTrack();
+        if (!track)
+            return [];
+        const packets = [];
+        for await (const packet of new EncodedPacketSink(track).packets(undefined, undefined, {
+            metadataOnly: true
+        })) {
+            packets.push({ pts: Math.round(packet.timestamp * 1e6) / 1e6, key: packet.type === "key" });
+        }
+        return packets.sort((a, b) => a.pts - b.pts);
+    }
+    finally {
+        input.dispose();
+    }
+}
+/** Every video frame of `filePath` as RGBA at `width`x`height`, in order. */
+export async function readRgbaFrames(filePath, size) {
+    const reader = await openRgbaFrameReader({
+        filePath,
+        filter: `scale=${size.width}:${size.height}:flags=accurate_rnd+full_chroma_int,format=rgba`
+    });
+    if (!reader)
+        return [];
+    const frames = [];
+    try {
+        for (let frame = await reader.next(); frame; frame = await reader.next()) {
+            frames.push(frame.rgba);
+        }
+    }
+    finally {
+        await reader.close();
+    }
+    return frames;
+}
+/** Mean of each RGBA channel over a frame. */
+export function meanRgba(rgba) {
+    const sums = [0, 0, 0, 0];
+    for (let i = 0; i < rgba.length; i += 4) {
+        for (let c = 0; c < 4; c++)
+            sums[c] += rgba[i + c] ?? 0;
+    }
+    const pixels = Math.max(1, rgba.length / 4);
+    return [sums[0] / pixels, sums[1] / pixels, sums[2] / pixels, sums[3] / pixels];
+}
+/** `filePath`'s audio as interleaved float PCM. */
+export function readPcm(filePath, options) {
+    return decodeAudioToPcm(filePath, options);
+}
+/** RMS of `audio` between two times, over every channel. */
+export function rmsBetween(audio, startSec, endSec) {
+    const first = Math.max(0, Math.floor(startSec * audio.sampleRate)) * audio.channels;
+    const last = Math.min(audio.samples.length, Math.floor(endSec * audio.sampleRate) * audio.channels);
+    if (last <= first)
+        return 0;
+    let sum = 0;
+    for (let i = first; i < last; i++)
+        sum += (audio.samples[i] ?? 0) ** 2;
+    return Math.sqrt(sum / (last - first));
+}
+/** ffprobe's names for the color tags a test checks; anything else reads as its number. */
+const COLOR_SPACES = { 0: "gbr", 1: "bt709", 2: "unknown", 5: "bt470bg", 6: "smpte170m", 9: "bt2020nc" };
+const COLOR_PRIMARIES = { 1: "bt709", 2: "unknown", 5: "bt470bg", 6: "smpte170m", 9: "bt2020" };
+const COLOR_TRANSFERS = { 1: "bt709", 2: "unknown", 6: "smpte170m", 13: "iec61966-2-1", 14: "bt2020-10" };
+const COLOR_RANGES = { 0: "unknown", 1: "tv", 2: "pc" };
+/** The first video stream's codec, pixel format and tags, or null without one. */
+export async function videoStreamFormat(filePath) {
+    const demuxer = await Demuxer.open(filePath);
+    try {
+        const stream = demuxer.video();
+        if (!stream)
+            return null;
+        const { codecpar } = stream;
+        const name = (table, value) => table[value] ?? String(value);
+        return {
+            codec: avGetCodecName(codecpar.codecId) ?? "",
+            // SAFETY: a video stream's `format` is a pixel format.
+            pixelFormat: avGetPixFmtName(codecpar.format) ?? "",
+            colorSpace: name(COLOR_SPACES, codecpar.colorSpace),
+            colorPrimaries: name(COLOR_PRIMARIES, codecpar.colorPrimaries),
+            colorTransfer: name(COLOR_TRANSFERS, codecpar.colorTrc),
+            colorRange: name(COLOR_RANGES, codecpar.colorRange),
+            tags: stream.metadata?.getAll() ?? {}
+        };
+    }
+    finally {
+        await demuxer.close();
+    }
+}
+/**
+ * Every video frame of `filePath` as RGBA at `width`x`height`, decoded by the
+ * named libav decoder rather than the default one. A test of VP9 alpha needs
+ * `libvpx-vp9`: libav's native vp9 decoder drops the alpha plane WebM keeps
+ * in BlockAdditions, as `ffmpeg -c:v libvpx-vp9 -i` was needed to read it.
+ */
+export async function readRgbaFramesWith(filePath, decoderName, size) {
+    quietLibav();
+    const demuxer = await Demuxer.open(filePath);
+    let decoder = null;
+    let filter = null;
+    try {
+        const stream = demuxer.video();
+        if (!stream)
+            return [];
+        // SAFETY: `decoderName` is a libav decoder name; an unknown one makes
+        // `create` throw, which fails the test that named it.
+        decoder = await Decoder.create(stream, decoderName);
+        const activeFilter = FilterAPI.create(`scale=${size.width}:${size.height}:flags=accurate_rnd+full_chroma_int,format=rgba`);
+        filter = activeFilter;
+        const frames = [];
+        const take = async (frame) => {
+            for (const out of await activeFilter.processAll(frame)) {
+                frames.push(new Uint8Array(out.toBuffer()));
+                out.free();
+            }
+        };
+        for await (const frame of decoder.frames(demuxer.packets(stream.index))) {
+            if (!frame)
+                continue;
+            await take(frame);
+            frame.free();
+        }
+        await take(null);
+        return frames;
+    }
+    finally {
+        filter?.close();
+        decoder?.close();
+        await demuxer.close();
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/media/testing.js.map

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

package/dist/media/transcode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Re-encode a file's video through a filter chain with node-av: the
+ * in-process form of `ffmpeg -i in -map 0:v:0 -vf <filter> <codec args> out`.
+ * Frame timestamps pass through, so a variable-rate source stays variable.
+ */
+import type { VideoEncoderSpec } from "./rgba.js";
+export declare function transcodeVideo(opts: {
+    inputPath: string;
+    outPath: string;
+    spec: VideoEncoderSpec;
+    /** Container muxer name; defaults to the one for the extension. */
+    format?: string;
+    /** Muxer AVOptions, e.g. `{ movflags: "+faststart" }`. */
+    muxerOptions?: Record<string, string>;
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=transcode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcode.d.ts","sourceRoot":"","sources":["../../src/media/transcode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB"}

package/dist/media/transcode.js

@@ -0,0 +1,19 @@
+/**
+ * Re-encode a file's video through a filter chain with node-av: the
+ * in-process form of `ffmpeg -i in -map 0:v:0 -vf <filter> <codec args> out`.
+ * Frame timestamps pass through, so a variable-rate source stays variable.
+ */
+import { transformMedia } from "./transform.js";
+export async function transcodeVideo(opts) {
+    await transformMedia({
+        inputs: [{ filePath: opts.inputPath }],
+        outPath: opts.outPath,
+        video: { filter: "null" },
+        audio: null,
+        videoEncoder: opts.spec,
+        format: opts.format,
+        muxerOptions: opts.muxerOptions,
+        signal: opts.signal
+    });
+}
+//# sourceMappingURL=transcode.js.map

package/dist/media/transcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcode.js","sourceRoot":"","sources":["../../src/media/transcode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IASpC;IACC,MAAM,cAAc,CAAC;QACnB,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QACzB,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI,CAAC,IAAI;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/media/transform.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One output file from filtered or copied input streams: the in-process form
+ * of the ffmpeg CLI invocations the video nodes ran, `-vf`, `-af`,
+ * `-filter_complex` with `-map`, `-c copy` and `-shortest`. The graph strings
+ * are the CLI's, unchanged.
+ */
+import type { VideoEncoderSpec } from "./rgba.js";
+/** An input file, as `-ss S -to E -i path` named it. */
+export interface TransformInput {
+    filePath: string;
+    /** Source seconds to start at (`-ss` before `-i`). */
+    seekSec?: number;
+    /** Source seconds to stop reading at (`-to` before `-i`). */
+    toSec?: number;
+}
+/**
+ * Where one output stream comes from.
+ *
+ * - `copy`: the input's first stream of the kind, packets unchanged (`-c copy`).
+ * - `filter`: a `-vf` or `-af` chain over the input's first stream of the kind.
+ * - `graph`: a `-filter_complex` graph whose inputs are labelled `[N:v]` and
+ *   `[N:a]` after the input index, read at link `output`.
+ *
+ * A missing stream throws, as the CLI failed on a stream specifier that
+ * matched nothing, unless `optional` is set: then the output has no such
+ * stream, as the CLI's default stream selection left it out.
+ */
+export type StreamPlan = {
+    copy: number;
+    optional?: boolean;
+} | {
+    filter: string;
+    input?: number;
+    optional?: boolean;
+} | {
+    graph: string;
+    output: string;
+};
+/** The CLI's defaults for an `.mp4` output: H.264 in yuv420p. */
+export declare const DEFAULT_VIDEO_ENCODER: VideoEncoderSpec;
+/**
+ * Write `outPath` from `inputs`. `video` and `audio` name where each output
+ * stream comes from, or `null` for none. Filtered streams are encoded with
+ * `videoEncoder` (H.264 yuv420p by default) and `audioCodec` (AAC by default,
+ * at the filtered rate and channel count). `shortest` ends the file when its
+ * first stream ends, as `-shortest` did.
+ */
+export declare function transformMedia(opts: {
+    inputs: TransformInput[];
+    outPath: string;
+    video: StreamPlan | null;
+    audio: StreamPlan | null;
+    videoEncoder?: VideoEncoderSpec;
+    audioCodec?: string;
+    shortest?: boolean;
+    /** Container muxer name; defaults to the one for the extension. */
+    format?: string;
+    muxerOptions?: Record<string, string>;
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/media/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,EAAE,gBAGnC,CAAC;AAmSF;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ChB"}