waha-shared 1.0.335 → 1.0.336

package/dist/data/languageAssets/languageAssets.schema.json

@@ -1,19 +0,0 @@
-{
-  "description": "This file is auto-generated by scripts/prep. Do not edit manually.",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "$schema": { "type": "string" },
-    "data": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "object",
-      "propertyNames": { "type": "string", "pattern": "^[a-z]{3}$" },
-      "additionalProperties": {
-        "type": "array",
-        "items": { "type": "string" },
-        "description": "Language code (3-letter ISO code) containing assets"
-      }
-    }
-  },
-  "required": ["$schema", "data"]
-}

package/dist/data/languageAssets/languageAssets.zod.d.ts

@@ -1,3 +0,0 @@
-import { z } from 'zod';
-export declare const LanguageAssets: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
-export type LanguageAssets = z.infer<typeof LanguageAssets>;

package/dist/data/languageAssets/languageAssets.zod.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LanguageAssets = void 0;
-const zod_1 = require("zod");
-exports.LanguageAssets = zod_1.z.record(zod_1.z.string().regex(new RegExp('^[a-z]{3}$')), zod_1.z
-    .array(zod_1.z.string())
-    .describe('Language code (3-letter ISO code) containing assets'));

package/dist/functions/ffmpeg.d.ts

@@ -1,104 +0,0 @@
-/** Concatenate audio files using ffmpeg's concat demuxer. */
-export declare function concatAudio(files: string[], output: string): Promise<void>;
-/** Generate a silence MP3 of the given duration in seconds. */
-export declare function generateSilence(duration: number, output: string): Promise<void>;
-/** Extract an audio segment from a file by start/end times (seconds). */
-export declare function extractAudioSegment({ endTime, input, output, startTime, }: {
-    input: string;
-    startTime: number;
-    endTime: number;
-    output: string;
-}): Promise<void>;
-/** Extract the audio track from a video file and re-encode to MP3. */
-export declare function extractVideoAudio(input: string, output: string): Promise<void>;
-/**
- * Normalize audio to EBU R128 standard using ffmpeg-normalize. Returns the path
- * to the normalized file. Skips if already exists.
- */
-export declare function normalizeAudio(input: string): Promise<string>;
-/**
- * Source-of-truth for our standard H.264 / AAC video encode profile. Use these
- * named values when calling APIs that take typed options (e.g. Remotion's
- * `renderMedia`, which surfaces some flags as `codec` / `x264Preset` / `crf` /
- * `pixelFormat` / `audioCodec` / `audioBitrate`). For direct ffmpeg shell-out,
- * use the pre-flattened arg arrays below.
- *
- * The settings are tuned for concat-safe output:
- *
- * - `gop` of 30 puts a keyframe every 1s at 30fps, required for seekability and
- *   `-c:v copy` concat
- * - `bFrames: 0` prevents non-monotonic DTS at concat seams
- * - `videoTrackTimescale` of 90000 matches Remotion's default timebase
- */
-export declare const VIDEO_ENCODE_SETTINGS: {
-    readonly videoCodec: "libx264";
-    /**
-     * Value for Remotion's `codec` option (which uses short names, not ffmpeg
-     * codec ids).
-     */
-    readonly remotionCodec: "h264";
-    readonly crf: 23;
-    readonly x264Preset: "medium";
-    readonly gop: 30;
-    readonly bFrames: 0;
-    readonly pixelFormat: "yuv420p";
-    readonly videoTrackTimescale: 90000;
-    readonly audioCodec: "aac";
-    readonly audioSampleRate: 48000;
-    readonly audioBitrate: "128k";
-};
-/**
- * Ffmpeg args for H.264 video encoding (concat-safe). Includes `-movflags
- * +faststart` so the muxed MP4 supports progressive HTTP playback.
- */
-export declare const VIDEO_ENCODE_ARGS: string[];
-/** Standard AAC audio encode args to pair with {@link VIDEO_ENCODE_ARGS}. */
-export declare const VIDEO_AUDIO_ENCODE_ARGS: string[];
-/**
- * Args for use inside Remotion's `ffmpegOverride` — just the flags that
- * `renderMedia`'s typed options don't surface natively. Currently only `-bf 0`
- * (no B-frames), which prevents non-monotonic DTS at concat seams between
- * Remotion-rendered clips and the B-frame-free training videos compressed by
- * {@link compressVideo}. Pair with the typed options fed from
- * {@link VIDEO_ENCODE_SETTINGS} for a render that matches our standard profile.
- *
- * Example:
- *
- *     renderMedia({
- *       codec: VIDEO_ENCODE_SETTINGS.remotionCodec,
- *       x264Preset: VIDEO_ENCODE_SETTINGS.x264Preset,
- *       crf: VIDEO_ENCODE_SETTINGS.crf,
- *       pixelFormat: VIDEO_ENCODE_SETTINGS.pixelFormat,
- *       audioCodec: VIDEO_ENCODE_SETTINGS.audioCodec,
- *       audioBitrate: VIDEO_ENCODE_SETTINGS.audioBitrate,
- *       ffmpegOverride: ({ args }) => {
- *         const out = args[args.length - 1]
- *         const yflag = args[args.length - 2]
- *         return [...args.slice(0, -2), ...VIDEO_REMOTION_OVERRIDE_ARGS, yflag, out]
- *       },
- *       ...
- *     })
- */
-export declare const VIDEO_REMOTION_OVERRIDE_ARGS: string[];
-/**
- * Compress a video using the standard H.264 settings. If `audio` is provided,
- * its track replaces the source video's audio.
- */
-export declare function compressVideo({ input, output, audio, }: {
-    input: string;
-    output: string;
-    audio?: string;
-}): Promise<void>;
-/**
- * Mix narration audio with background music at a fixed volume ratio. Music is
- * trimmed to the shorter of the two inputs; if `targetDuration` is provided,
- * the output is padded with silence to match exactly.
- */
-export declare function mixAudioWithMusic({ music, narration, output, targetDuration, }: {
-    narration: string;
-    music: string;
-    output: string;
-    targetDuration: number;
-}): Promise<void>;
-/** Get the duration of an audio file in seconds using ffprobe. */
-export declare function getDurationFromFile(file: string): Promise<number>;

package/dist/functions/ffmpeg.js

@@ -1,307 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VIDEO_REMOTION_OVERRIDE_ARGS = exports.VIDEO_AUDIO_ENCODE_ARGS = exports.VIDEO_ENCODE_ARGS = exports.VIDEO_ENCODE_SETTINGS = void 0;
-exports.concatAudio = concatAudio;
-exports.generateSilence = generateSilence;
-exports.extractAudioSegment = extractAudioSegment;
-exports.extractVideoAudio = extractVideoAudio;
-exports.normalizeAudio = normalizeAudio;
-exports.compressVideo = compressVideo;
-exports.mixAudioWithMusic = mixAudioWithMusic;
-exports.getDurationFromFile = getDurationFromFile;
-const child_process_1 = require("child_process");
-const fs_1 = require("fs");
-const promises_1 = require("fs/promises");
-const os_1 = require("os");
-const path_1 = require("path");
-function exec(cmd, args) {
-    return new Promise((resolve, reject) => {
-        (0, child_process_1.execFile)(cmd, args, { maxBuffer: 10 * 1024 * 1024 }, (err, stdout, stderr) => {
-            if (err)
-                reject(new Error(`${cmd} failed: ${stderr}`));
-            else
-                resolve({ stdout, stderr });
-        });
-    });
-}
-/** MP3 encoder used across all ffmpeg commands. */
-const CODEC = ['-c:a', 'libmp3lame'];
-/**
- * Target audio bitrate — 64 kbps is a good balance of quality and file size for
- * speech.
- */
-const BITRATE = ['-b:a', '64k'];
-/** Sample rate — 22050 Hz is sufficient for speech content. */
-const SAMPLE_RATE = ['-ar', '22050'];
-/** Audio channels: stereo (2 channels). */
-const CHANNELS = ['-ac', '2'];
-/** Concatenate audio files using ffmpeg's concat demuxer. */
-async function concatAudio(files, output) {
-    const dir = await (0, promises_1.mkdtemp)((0, path_1.join)((0, os_1.tmpdir)(), 'ffconcat-'));
-    const listFile = (0, path_1.join)(dir, 'list.txt');
-    await (0, promises_1.writeFile)(listFile, files.map((f) => `file '${f}'`).join('\n'));
-    await exec('ffmpeg', [
-        // Use the concat demuxer to join multiple input files
-        '-f',
-        'concat',
-        // Allow absolute paths and paths outside the working directory in the list file
-        '-safe',
-        '0',
-        // Input: the generated list file containing paths to all audio segments
-        '-i',
-        listFile,
-        // FFmpeg 8.0 introduced stricter AVFrame buffer alignment requirements for
-        // libmp3lame. The concat demuxer produces frames that don't meet this new
-        // padding requirement, causing "inadequate AVFrame plane padding" errors.
-        // aresample forces frames to be reallocated with proper alignment as a workaround.
-        '-af',
-        'aresample=resampler=swr',
-        ...CODEC,
-        ...BITRATE,
-        ...SAMPLE_RATE,
-        ...CHANNELS,
-        '-y',
-        output,
-    ]);
-}
-/** Generate a silence MP3 of the given duration in seconds. */
-async function generateSilence(duration, output) {
-    await exec('ffmpeg', [
-        // Use the Libavfilter virtual device as the input format
-        '-f',
-        'lavfi',
-        // Input: null audio source generating silence at 22050 Hz in stereo
-        '-i',
-        'anullsrc=r=22050:cl=stereo',
-        // Duration: stop after this many seconds
-        '-t',
-        String(duration),
-        ...CODEC,
-        ...BITRATE,
-        ...CHANNELS,
-        '-y',
-        output,
-    ]);
-}
-/** Extract an audio segment from a file by start/end times (seconds). */
-async function extractAudioSegment({ endTime, input, output, startTime, }) {
-    await exec('ffmpeg', [
-        // Seek to this start time (seconds) before reading input — placed before -i for fast seeking
-        '-ss',
-        String(startTime),
-        // Duration: read this many seconds of audio (endTime - startTime)
-        '-t',
-        String(endTime - startTime),
-        // Input audio file to extract from
-        '-i',
-        input,
-        // FFmpeg 8.0 workaround: force frame reallocation to satisfy libmp3lame's
-        // stricter AVFrame buffer alignment requirements (see concatAudio).
-        '-af',
-        'aresample=resampler=swr',
-        ...CODEC,
-        ...BITRATE,
-        ...SAMPLE_RATE,
-        ...CHANNELS,
-        '-y',
-        output,
-    ]);
-}
-/** Extract the audio track from a video file and re-encode to MP3. */
-async function extractVideoAudio(input, output) {
-    await exec('ffmpeg', [
-        '-i',
-        input,
-        // Drop the video stream — we only want the audio track.
-        '-vn',
-        '-af',
-        'aresample=resampler=swr',
-        ...CODEC,
-        ...BITRATE,
-        ...SAMPLE_RATE,
-        ...CHANNELS,
-        '-y',
-        output,
-    ]);
-}
-/**
- * Normalize audio to EBU R128 standard using ffmpeg-normalize. Returns the path
- * to the normalized file. Skips if already exists.
- */
-async function normalizeAudio(input) {
-    const output = input.replace(/\.mp3$/, '.normalized.mp3');
-    if ((0, fs_1.existsSync)(output))
-        return output;
-    await exec('ffmpeg-normalize', [
-        // Input file to normalize
-        input,
-        // Output file path
-        '-o',
-        output,
-        // Normalization type: EBU R128 loudness standard
-        '-nt',
-        'ebu',
-        // Target integrated loudness level: -15 LUFS
-        '-t',
-        '-15',
-        // True peak ceiling: -1.0 dBTP (prevents clipping after encoding)
-        '-tp',
-        '-1.0',
-        // Loudness range target: 7.0 LU (controls dynamic range)
-        '-lrt',
-        '7.0',
-        ...CODEC,
-        ...SAMPLE_RATE,
-    ]);
-    return output;
-}
-/**
- * Source-of-truth for our standard H.264 / AAC video encode profile. Use these
- * named values when calling APIs that take typed options (e.g. Remotion's
- * `renderMedia`, which surfaces some flags as `codec` / `x264Preset` / `crf` /
- * `pixelFormat` / `audioCodec` / `audioBitrate`). For direct ffmpeg shell-out,
- * use the pre-flattened arg arrays below.
- *
- * The settings are tuned for concat-safe output:
- *
- * - `gop` of 30 puts a keyframe every 1s at 30fps, required for seekability and
- *   `-c:v copy` concat
- * - `bFrames: 0` prevents non-monotonic DTS at concat seams
- * - `videoTrackTimescale` of 90000 matches Remotion's default timebase
- */
-exports.VIDEO_ENCODE_SETTINGS = {
-    videoCodec: 'libx264',
-    /**
-     * Value for Remotion's `codec` option (which uses short names, not ffmpeg
-     * codec ids).
-     */
-    remotionCodec: 'h264',
-    crf: 23,
-    x264Preset: 'medium',
-    gop: 30,
-    bFrames: 0,
-    pixelFormat: 'yuv420p',
-    videoTrackTimescale: 90000,
-    audioCodec: 'aac',
-    audioSampleRate: 48000,
-    audioBitrate: '128k',
-};
-/**
- * Ffmpeg args for H.264 video encoding (concat-safe). Includes `-movflags
- * +faststart` so the muxed MP4 supports progressive HTTP playback.
- */
-exports.VIDEO_ENCODE_ARGS = [
-    '-c:v',
-    exports.VIDEO_ENCODE_SETTINGS.videoCodec,
-    '-crf',
-    String(exports.VIDEO_ENCODE_SETTINGS.crf),
-    '-preset',
-    exports.VIDEO_ENCODE_SETTINGS.x264Preset,
-    '-g',
-    String(exports.VIDEO_ENCODE_SETTINGS.gop),
-    '-bf',
-    String(exports.VIDEO_ENCODE_SETTINGS.bFrames),
-    '-pix_fmt',
-    exports.VIDEO_ENCODE_SETTINGS.pixelFormat,
-    '-video_track_timescale',
-    String(exports.VIDEO_ENCODE_SETTINGS.videoTrackTimescale),
-    '-movflags',
-    '+faststart',
-];
-/** Standard AAC audio encode args to pair with {@link VIDEO_ENCODE_ARGS}. */
-exports.VIDEO_AUDIO_ENCODE_ARGS = [
-    '-c:a',
-    exports.VIDEO_ENCODE_SETTINGS.audioCodec,
-    '-ar',
-    String(exports.VIDEO_ENCODE_SETTINGS.audioSampleRate),
-    '-b:a',
-    exports.VIDEO_ENCODE_SETTINGS.audioBitrate,
-];
-/**
- * Args for use inside Remotion's `ffmpegOverride` — just the flags that
- * `renderMedia`'s typed options don't surface natively. Currently only `-bf 0`
- * (no B-frames), which prevents non-monotonic DTS at concat seams between
- * Remotion-rendered clips and the B-frame-free training videos compressed by
- * {@link compressVideo}. Pair with the typed options fed from
- * {@link VIDEO_ENCODE_SETTINGS} for a render that matches our standard profile.
- *
- * Example:
- *
- *     renderMedia({
- *       codec: VIDEO_ENCODE_SETTINGS.remotionCodec,
- *       x264Preset: VIDEO_ENCODE_SETTINGS.x264Preset,
- *       crf: VIDEO_ENCODE_SETTINGS.crf,
- *       pixelFormat: VIDEO_ENCODE_SETTINGS.pixelFormat,
- *       audioCodec: VIDEO_ENCODE_SETTINGS.audioCodec,
- *       audioBitrate: VIDEO_ENCODE_SETTINGS.audioBitrate,
- *       ffmpegOverride: ({ args }) => {
- *         const out = args[args.length - 1]
- *         const yflag = args[args.length - 2]
- *         return [...args.slice(0, -2), ...VIDEO_REMOTION_OVERRIDE_ARGS, yflag, out]
- *       },
- *       ...
- *     })
- */
-exports.VIDEO_REMOTION_OVERRIDE_ARGS = [
-    '-bf',
-    String(exports.VIDEO_ENCODE_SETTINGS.bFrames),
-];
-/**
- * Compress a video using the standard H.264 settings. If `audio` is provided,
- * its track replaces the source video's audio.
- */
-async function compressVideo({ input, output, audio, }) {
-    const args = ['-i', input];
-    if (audio)
-        args.push('-i', audio, '-map', '0:v:0', '-map', '1:a:0');
-    args.push(...exports.VIDEO_ENCODE_ARGS, ...exports.VIDEO_AUDIO_ENCODE_ARGS, '-y', output);
-    await exec('ffmpeg', args);
-}
-/**
- * Mix narration audio with background music at a fixed volume ratio. Music is
- * trimmed to the shorter of the two inputs; if `targetDuration` is provided,
- * the output is padded with silence to match exactly.
- */
-async function mixAudioWithMusic({ music, narration, output, targetDuration, }) {
-    const narrationDuration = await getDurationFromFile(narration);
-    const musicDuration = await getDurationFromFile(music);
-    const minDuration = Math.min(narrationDuration, musicDuration);
-    const filterComplex = [
-        `[0:a]volume=1.0[a1]`,
-        `[1:a]atrim=0:${minDuration},volume=0.1[a2]`,
-        // duration=first keeps narration length; normalize=0 preserves its volume.
-        // apad pads the mix with silence to the exact target duration.
-        `[a1][a2]amix=inputs=2:duration=first:dropout_transition=0:normalize=0,apad=whole_dur=${targetDuration}`,
-    ].join(';');
-    await exec('ffmpeg', [
-        '-i',
-        narration,
-        '-i',
-        music,
-        '-filter_complex',
-        filterComplex,
-        ...CODEC,
-        ...BITRATE,
-        ...SAMPLE_RATE,
-        ...CHANNELS,
-        '-y',
-        output,
-    ]);
-}
-/** Get the duration of an audio file in seconds using ffprobe. */
-async function getDurationFromFile(file) {
-    const { stdout } = await exec('ffprobe', [
-        // Verbosity: only show errors (suppress informational output)
-        '-v',
-        'error',
-        // Only extract the duration field from the format section
-        '-show_entries',
-        'format=duration',
-        // Output format: plain value with no section wrappers or key name
-        '-of',
-        'default=noprint_wrappers=1:nokey=1',
-        // Input file to probe
-        file,
-    ]);
-    return parseFloat(stdout.trim());
-}

package/dist/functions/upload.d.ts

@@ -1,34 +0,0 @@
-/**
- * Minimal structural shape of `@google-cloud/storage`'s `Bucket`. Defined
- * structurally so this module doesn't pull `@google-cloud/storage` into the
- * shared package's dependency graph — callers pass the real bucket.
- */
-export interface UploadBucket {
-    file(path: string): {
-        exists(): Promise<[boolean]>;
-        setMetadata(meta: {
-            metadata: Record<string, string>;
-        }): Promise<unknown>;
-    };
-    upload(localPath: string, options: {
-        destination: string;
-        contentType: string;
-        public?: boolean;
-    }): Promise<unknown>;
-}
-export type UploadResult = 'uploaded' | 'skipped';
-/**
- * Upload a local file to a Cloud Storage bucket. The content type is inferred
- * from the file extension via {@link CONTENT_TYPE_BY_EXTENSION}. Returns
- * `'skipped'` if the remote file already exists and `overwrite` is falsy,
- * `'uploaded'` otherwise. Throws if the underlying bucket operation fails.
- *
- * Sets a `duration` metadata field (in seconds) from ffprobe when probing
- * succeeds; metadata failures are swallowed since they're non-fatal.
- */
-export declare function uploadFile({ bucket, localPath, overwrite, remotePath, }: {
-    bucket: UploadBucket;
-    localPath: string;
-    remotePath: string;
-    overwrite?: boolean;
-}): Promise<UploadResult>;

package/dist/functions/upload.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadFile = uploadFile;
-const path_1 = require("path");
-const ffmpeg_1 = require("./ffmpeg");
-const CONTENT_TYPE_BY_EXTENSION = {
-    '.mp3': 'audio/mpeg',
-    '.mp4': 'video/mp4',
-};
-function contentTypeFor(path) {
-    const ext = (0, path_1.extname)(path).toLowerCase();
-    const contentType = CONTENT_TYPE_BY_EXTENSION[ext];
-    if (!contentType)
-        throw new Error(`uploadFile: no content type mapped for extension '${ext}' (path: ${path}). ` +
-            `Add it to CONTENT_TYPE_BY_EXTENSION in shared/functions/upload.ts.`);
-    return contentType;
-}
-/**
- * Upload a local file to a Cloud Storage bucket. The content type is inferred
- * from the file extension via {@link CONTENT_TYPE_BY_EXTENSION}. Returns
- * `'skipped'` if the remote file already exists and `overwrite` is falsy,
- * `'uploaded'` otherwise. Throws if the underlying bucket operation fails.
- *
- * Sets a `duration` metadata field (in seconds) from ffprobe when probing
- * succeeds; metadata failures are swallowed since they're non-fatal.
- */
-async function uploadFile({ bucket, localPath, overwrite, remotePath, }) {
-    const contentType = contentTypeFor(localPath);
-    const [exists] = await bucket.file(remotePath).exists();
-    if (exists && !overwrite)
-        return 'skipped';
-    await bucket.upload(localPath, {
-        destination: remotePath,
-        contentType,
-        public: true,
-    });
-    try {
-        const duration = await (0, ffmpeg_1.getDurationFromFile)(localPath);
-        if (!isNaN(duration) && duration > 0) {
-            await bucket.file(remotePath).setMetadata({
-                metadata: { duration: duration.toString() },
-            });
-        }
-    }
-    catch {
-        // Non-fatal — proceed even if setting duration metadata fails.
-    }
-    return 'uploaded';
-}