vidpipe 1.0.0

package/dist/tools/ffmpeg/aspectRatio.js

@@ -0,0 +1,338 @@
+import { execFile } from 'child_process';
+import { promises as fs } from 'fs';
+import pathMod from 'path';
+import logger from '../../config/logger';
+import { detectWebcamRegion, getVideoResolution } from './faceDetection';
+const ffmpegPath = process.env.FFMPEG_PATH || 'ffmpeg';
+/**
+ * Maps each platform to its preferred aspect ratio.
+ * Multiple platforms may share a ratio (e.g. TikTok + Reels both use 9:16),
+ * which lets {@link generatePlatformVariants} deduplicate encodes.
+ */
+export const PLATFORM_RATIOS = {
+    'tiktok': '9:16',
+    'youtube-shorts': '9:16',
+    'instagram-reels': '9:16',
+    'instagram-feed': '4:5',
+    'linkedin': '1:1',
+    'youtube': '16:9',
+    'twitter': '1:1',
+};
+/**
+ * Canonical pixel dimensions for each aspect ratio.
+ * Width is always 1080 px for non-landscape ratios (the standard vertical
+ * video width); landscape stays at 1920×1080 for full HD.
+ */
+export const DIMENSIONS = {
+    '16:9': { width: 1920, height: 1080 },
+    '9:16': { width: 1080, height: 1920 },
+    '1:1': { width: 1080, height: 1080 },
+    '4:5': { width: 1080, height: 1350 },
+};
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Build the FFmpeg `-vf` filter string for a simple center-crop conversion.
+ *
+ * This is the **fallback** used when smart layout (webcam detection + split-screen)
+ * is unavailable. It center-crops the source frame to the target aspect ratio,
+ * discarding content on the sides (or top/bottom).
+ *
+ * **Letterbox mode**: instead of cropping, scales the video to fit inside the
+ * target dimensions and pads the remaining space with black bars. Useful when
+ * you don't want to lose any content (e.g. screen recordings with important
+ * edges).
+ *
+ * **Crop formulas** assume a 16:9 landscape source. `ih` = input height,
+ * `iw` = input width. We compute the crop width from the height to maintain
+ * the target ratio, then center the crop horizontally.
+ *
+ * @param targetRatio - The desired output aspect ratio
+ * @param letterbox - If true, pad with black bars instead of cropping
+ * @returns An FFmpeg `-vf` filter string
+ */
+function buildCropFilter(targetRatio, letterbox) {
+    if (letterbox) {
+        const { width, height } = DIMENSIONS[targetRatio];
+        // Scale to fit within target dimensions, then pad with black bars
+        return `scale=${width}:${height}:force_original_aspect_ratio=decrease,pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2:black`;
+    }
+    switch (targetRatio) {
+        case '9:16':
+            // Center-crop landscape to portrait: crop width = ih*9/16, keep full height
+            return 'crop=ih*9/16:ih:(iw-ih*9/16)/2:0,scale=1080:1920';
+        case '1:1':
+            // Center-crop to square: use height as the dimension (smaller axis for 16:9)
+            return 'crop=ih:ih:(iw-ih)/2:0,scale=1080:1080';
+        case '4:5':
+            // Center-crop landscape to 4:5: crop width = ih*4/5, keep full height
+            return 'crop=ih*4/5:ih:(iw-ih*4/5)/2:0,scale=1080:1350';
+        case '16:9':
+            // Same ratio — just ensure standard dimensions
+            return 'scale=1920:1080';
+    }
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Convert a video's aspect ratio using FFmpeg center-crop.
+ *
+ * - 16:9 → 9:16: crops the center column to portrait
+ * - 16:9 → 1:1:  crops to a center square
+ * - Same ratio:  stream-copies without re-encoding
+ *
+ * @returns The output path on success
+ */
+export async function convertAspectRatio(inputPath, outputPath, targetRatio, options = {}) {
+    const outputDir = pathMod.dirname(outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    const sourceRatio = '16:9'; // our videos are always landscape
+    // Same ratio — stream copy
+    if (sourceRatio === targetRatio && !options.letterbox) {
+        logger.info(`Aspect ratio already ${targetRatio}, copying → ${outputPath}`);
+        await fs.copyFile(inputPath, outputPath);
+        return outputPath;
+    }
+    const vf = buildCropFilter(targetRatio, options.letterbox ?? false);
+    logger.info(`Converting aspect ratio to ${targetRatio} (filter: ${vf}) → ${outputPath}`);
+    const args = [
+        '-y',
+        '-i', inputPath,
+        '-vf', vf,
+        '-c:v', 'libx264',
+        '-preset', 'ultrafast',
+        '-crf', '23',
+        '-c:a', 'copy',
+        '-threads', '4',
+        outputPath,
+    ];
+    return new Promise((resolve, reject) => {
+        execFile(ffmpegPath, args, { maxBuffer: 10 * 1024 * 1024 }, (error, _stdout, stderr) => {
+            if (error) {
+                logger.error(`Aspect ratio conversion failed: ${stderr || error.message}`);
+                reject(new Error(`Aspect ratio conversion failed: ${stderr || error.message}`));
+                return;
+            }
+            logger.info(`Aspect ratio conversion complete: ${outputPath}`);
+            resolve(outputPath);
+        });
+    });
+}
+/**
+ * Shared smart conversion: detects a webcam overlay in the source video and
+ * builds a **split-screen** layout (screen on top, webcam on bottom).
+ *
+ * ### Why split-screen?
+ * Screen recordings with a webcam overlay (e.g. top-right corner) waste space
+ * when naively center-cropped to portrait/square. The split-screen approach
+ * gives the screen content and webcam each their own dedicated panel, making
+ * both fully visible in a narrow frame.
+ *
+ * ### Algorithm
+ * 1. Run {@link detectWebcamRegion} to find the webcam bounding box.
+ * 2. **Screen crop**: exclude the webcam columns so only the screen content
+ *    remains, then scale to `targetW × screenH` (letterboxing if needed).
+ * 3. **Webcam crop**: aspect-ratio-match the webcam region to `targetW × camH`.
+ *    If the webcam is wider than the target, we keep full height and
+ *    center-crop width; if taller, we keep full width and center-crop height.
+ *    This ensures the webcam fills its panel edge-to-edge with **no black bars**.
+ * 4. **vstack**: vertically stack `[screen][cam]` into the final frame.
+ *
+ * Falls back to simple center-crop ({@link buildCropFilter}) if no webcam is
+ * detected.
+ *
+ * @param inputPath - Source video (assumed 16:9 landscape with optional webcam overlay)
+ * @param outputPath - Destination path for the converted video
+ * @param config - Layout geometry (see {@link SmartLayoutConfig})
+ * @returns The output path on success
+ */
+async function convertWithSmartLayout(inputPath, outputPath, config) {
+    const { label, targetW, screenH, camH, fallbackRatio } = config;
+    const outputDir = pathMod.dirname(outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    const webcam = await detectWebcamRegion(inputPath);
+    if (!webcam) {
+        logger.info(`[${label}] No webcam found, falling back to center-crop`);
+        return convertAspectRatio(inputPath, outputPath, fallbackRatio);
+    }
+    const resolution = await getVideoResolution(inputPath);
+    // Determine screen crop region (exclude webcam area using detected bounds)
+    let screenCropX;
+    let screenCropW;
+    if (webcam.position === 'top-right' || webcam.position === 'bottom-right') {
+        screenCropX = 0;
+        screenCropW = webcam.x;
+    }
+    else {
+        screenCropX = webcam.x + webcam.width;
+        screenCropW = Math.max(0, resolution.width - screenCropX);
+    }
+    // Crop webcam to match target bottom-section aspect ratio, then scale to fill
+    const targetAR = targetW / camH;
+    const webcamAR = webcam.width / webcam.height;
+    let faceX, faceY, faceW, faceH;
+    if (webcamAR > targetAR) {
+        // Webcam wider than target: keep full height, center-crop width
+        faceH = webcam.height;
+        faceW = Math.round(faceH * targetAR);
+        faceX = webcam.x + Math.round((webcam.width - faceW) / 2);
+        faceY = webcam.y;
+    }
+    else {
+        // Webcam taller than target: keep full width, center-crop height
+        faceW = webcam.width;
+        faceH = Math.round(faceW / targetAR);
+        faceX = webcam.x;
+        faceY = webcam.y + Math.round((webcam.height - faceH) / 2);
+    }
+    const filterComplex = [
+        `[0:v]crop=${screenCropW}:ih:${screenCropX}:0,scale=${targetW}:${screenH}:force_original_aspect_ratio=decrease,` +
+            `pad=${targetW}:${screenH}:(ow-iw)/2:(oh-ih)/2:black[screen]`,
+        `[0:v]crop=${faceW}:${faceH}:${faceX}:${faceY},scale=${targetW}:${camH}[cam]`,
+        '[screen][cam]vstack[out]',
+    ].join(';');
+    logger.info(`[${label}] Split-screen layout: webcam at ${webcam.position} → ${outputPath}`);
+    const args = [
+        '-y',
+        '-i', inputPath,
+        '-filter_complex', filterComplex,
+        '-map', '[out]',
+        '-map', '0:a',
+        '-c:v', 'libx264',
+        '-preset', 'ultrafast',
+        '-crf', '23',
+        '-c:a', 'aac',
+        '-b:a', '128k',
+        '-threads', '4',
+        outputPath,
+    ];
+    return new Promise((resolve, reject) => {
+        execFile(ffmpegPath, args, { maxBuffer: 10 * 1024 * 1024 }, (error, _stdout, stderr) => {
+            if (error) {
+                logger.error(`[${label}] FFmpeg failed: ${stderr || error.message}`);
+                reject(new Error(`${label} conversion failed: ${stderr || error.message}`));
+                return;
+            }
+            logger.info(`[${label}] Complete: ${outputPath}`);
+            resolve(outputPath);
+        });
+    });
+}
+/**
+ * Smart portrait (9:16) conversion → 1080×1920.
+ *
+ * Screen panel: 1080×1248 (65%), Webcam panel: 1080×672 (35%).
+ * Total: 1080×1920 — standard TikTok / Reels / Shorts dimensions.
+ *
+ * Falls back to center-crop 9:16 if no webcam is detected.
+ *
+ * @param inputPath - Source landscape video
+ * @param outputPath - Destination path for the portrait video
+ */
+export async function convertToPortraitSmart(inputPath, outputPath) {
+    return convertWithSmartLayout(inputPath, outputPath, {
+        label: 'SmartPortrait',
+        targetW: 1080,
+        screenH: 1248,
+        camH: 672,
+        fallbackRatio: '9:16',
+    });
+}
+/**
+ * Smart square (1:1) conversion → 1080×1080.
+ *
+ * Screen panel: 1080×700 (65%), Webcam panel: 1080×380 (35%).
+ * Total: 1080×1080 — standard LinkedIn / Twitter square format.
+ *
+ * Falls back to center-crop 1:1 if no webcam is detected.
+ *
+ * @param inputPath - Source landscape video
+ * @param outputPath - Destination path for the square video
+ */
+export async function convertToSquareSmart(inputPath, outputPath) {
+    return convertWithSmartLayout(inputPath, outputPath, {
+        label: 'SmartSquare',
+        targetW: 1080,
+        screenH: 700,
+        camH: 380,
+        fallbackRatio: '1:1',
+    });
+}
+/**
+ * Smart feed (4:5) conversion → 1080×1350.
+ *
+ * Screen panel: 1080×878 (65%), Webcam panel: 1080×472 (35%).
+ * Total: 1080×1350 — Instagram feed's preferred tall format.
+ *
+ * Falls back to center-crop 4:5 if no webcam is detected.
+ *
+ * @param inputPath - Source landscape video
+ * @param outputPath - Destination path for the 4:5 video
+ */
+export async function convertToFeedSmart(inputPath, outputPath) {
+    return convertWithSmartLayout(inputPath, outputPath, {
+        label: 'SmartFeed',
+        targetW: 1080,
+        screenH: 878,
+        camH: 472,
+        fallbackRatio: '4:5',
+    });
+}
+/**
+ * Generate platform-specific aspect-ratio variants of a short clip.
+ *
+ * ### Routing logic
+ * 1. Maps each requested platform to its aspect ratio via {@link PLATFORM_RATIOS}.
+ * 2. **Deduplicates by ratio** — if TikTok and Reels both need 9:16, only one
+ *    encode is performed and both platforms reference the same output file.
+ * 3. Skips 16:9 entirely since the source is already landscape.
+ * 4. Routes each ratio to its smart converter (portrait / square / feed) for
+ *    split-screen layout, falling back to {@link convertAspectRatio} for any
+ *    ratio without a smart converter.
+ *
+ * @param inputPath - Source video (16:9 landscape)
+ * @param outputDir - Directory to write variant files into
+ * @param slug - Base filename slug (e.g. "my-video-short-1")
+ * @param platforms - Platforms to generate for (default: tiktok + linkedin)
+ * @returns Array of variant metadata (one entry per platform, deduplicated files)
+ */
+export async function generatePlatformVariants(inputPath, outputDir, slug, platforms = ['tiktok', 'linkedin']) {
+    await fs.mkdir(outputDir, { recursive: true });
+    // Deduplicate by aspect ratio to avoid redundant encodes
+    const ratioMap = new Map();
+    for (const p of platforms) {
+        const ratio = PLATFORM_RATIOS[p];
+        if (ratio === '16:9')
+            continue; // skip — original is already 16:9
+        const list = ratioMap.get(ratio) ?? [];
+        list.push(p);
+        ratioMap.set(ratio, list);
+    }
+    const variants = [];
+    for (const [ratio, associatedPlatforms] of ratioMap) {
+        const suffix = ratio === '9:16' ? 'portrait' : ratio === '4:5' ? 'feed' : 'square';
+        const outPath = pathMod.join(outputDir, `${slug}-${suffix}.mp4`);
+        try {
+            if (ratio === '9:16') {
+                await convertToPortraitSmart(inputPath, outPath);
+            }
+            else if (ratio === '1:1') {
+                await convertToSquareSmart(inputPath, outPath);
+            }
+            else if (ratio === '4:5') {
+                await convertToFeedSmart(inputPath, outPath);
+            }
+            else {
+                await convertAspectRatio(inputPath, outPath, ratio);
+            }
+            const dims = DIMENSIONS[ratio];
+            for (const p of associatedPlatforms) {
+                variants.push({ platform: p, aspectRatio: ratio, path: outPath, width: dims.width, height: dims.height });
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.warn(`Skipping ${ratio} variant for ${slug}: ${message}`);
+        }
+    }
+    return variants;
+}
+//# sourceMappingURL=aspectRatio.js.map

package/dist/tools/ffmpeg/aspectRatio.js.map

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

package/dist/tools/ffmpeg/audioExtraction.d.ts

@@ -0,0 +1,16 @@
+export interface ExtractAudioOptions {
+    /** Output format: 'mp3' (default, smaller) or 'wav' */
+    format?: 'mp3' | 'wav';
+}
+/**
+ * Extract audio from a video file to mono MP3 at 64kbps (small enough for Whisper).
+ * A 10-minute video produces ~5MB MP3 vs ~115MB WAV.
+ */
+export declare function extractAudio(videoPath: string, outputPath: string, options?: ExtractAudioOptions): Promise<string>;
+/**
+ * Split an audio file into chunks of approximately `maxChunkSizeMB` each.
+ * Uses ffmpeg to split by duration calculated from the file size.
+ * Returns an array of chunk file paths.
+ */
+export declare function splitAudioIntoChunks(audioPath: string, maxChunkSizeMB?: number): Promise<string[]>;
+//# sourceMappingURL=audioExtraction.d.ts.map

package/dist/tools/ffmpeg/audioExtraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioExtraction.d.ts","sourceRoot":"","sources":["../../../src/tools/ffmpeg/audioExtraction.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAW,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAyCnB"}

package/dist/tools/ffmpeg/audioExtraction.js

@@ -0,0 +1,86 @@
+import ffmpeg from 'fluent-ffmpeg';
+import { promises as fs } from 'fs';
+import path from 'path';
+import logger from '../../config/logger';
+const ffmpegPath = process.env.FFMPEG_PATH || 'ffmpeg';
+const ffprobePath = process.env.FFPROBE_PATH || 'ffprobe';
+ffmpeg.setFfmpegPath(ffmpegPath);
+ffmpeg.setFfprobePath(ffprobePath);
+/**
+ * Extract audio from a video file to mono MP3 at 64kbps (small enough for Whisper).
+ * A 10-minute video produces ~5MB MP3 vs ~115MB WAV.
+ */
+export async function extractAudio(videoPath, outputPath, options = {}) {
+    const { format = 'mp3' } = options;
+    const outputDir = path.dirname(outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    logger.info(`Extracting audio (${format}): ${videoPath} → ${outputPath}`);
+    return new Promise((resolve, reject) => {
+        const command = ffmpeg(videoPath).noVideo().audioChannels(1);
+        if (format === 'mp3') {
+            command.audioCodec('libmp3lame').audioBitrate('64k').audioFrequency(16000);
+        }
+        else {
+            command.audioCodec('pcm_s16le').audioFrequency(16000);
+        }
+        command
+            .output(outputPath)
+            .on('end', () => {
+            logger.info(`Audio extraction complete: ${outputPath}`);
+            resolve(outputPath);
+        })
+            .on('error', (err) => {
+            logger.error(`Audio extraction failed: ${err.message}`);
+            reject(new Error(`Audio extraction failed: ${err.message}`));
+        })
+            .run();
+    });
+}
+/**
+ * Split an audio file into chunks of approximately `maxChunkSizeMB` each.
+ * Uses ffmpeg to split by duration calculated from the file size.
+ * Returns an array of chunk file paths.
+ */
+export async function splitAudioIntoChunks(audioPath, maxChunkSizeMB = 24) {
+    const stats = await fs.stat(audioPath);
+    const fileSizeMB = stats.size / (1024 * 1024);
+    if (fileSizeMB <= maxChunkSizeMB) {
+        return [audioPath];
+    }
+    const duration = await getAudioDuration(audioPath);
+    const numChunks = Math.ceil(fileSizeMB / maxChunkSizeMB);
+    const chunkDuration = duration / numChunks;
+    const ext = path.extname(audioPath);
+    const base = audioPath.slice(0, -ext.length);
+    const chunkPaths = [];
+    logger.info(`Splitting ${fileSizeMB.toFixed(1)}MB audio into ${numChunks} chunks ` +
+        `(~${chunkDuration.toFixed(0)}s each)`);
+    for (let i = 0; i < numChunks; i++) {
+        const startTime = i * chunkDuration;
+        const chunkPath = `${base}_chunk${i}${ext}`;
+        chunkPaths.push(chunkPath);
+        await new Promise((resolve, reject) => {
+            const cmd = ffmpeg(audioPath)
+                .setStartTime(startTime)
+                .setDuration(chunkDuration)
+                .audioCodec('copy')
+                .output(chunkPath)
+                .on('end', () => resolve())
+                .on('error', (err) => reject(new Error(`Chunk split failed: ${err.message}`)));
+            cmd.run();
+        });
+        logger.info(`Created chunk ${i + 1}/${numChunks}: ${chunkPath}`);
+    }
+    return chunkPaths;
+}
+/** Get the duration of an audio file in seconds using ffprobe. */
+function getAudioDuration(audioPath) {
+    return new Promise((resolve, reject) => {
+        ffmpeg.ffprobe(audioPath, (err, metadata) => {
+            if (err)
+                return reject(new Error(`ffprobe failed: ${err.message}`));
+            resolve(metadata.format.duration ?? 0);
+        });
+    });
+}
+//# sourceMappingURL=audioExtraction.js.map

package/dist/tools/ffmpeg/audioExtraction.js.map

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

package/dist/tools/ffmpeg/captionBurning.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Burn ASS subtitles into video (hard-coded subtitles).
+ * Uses direct execFile instead of fluent-ffmpeg to avoid Windows path escaping issues.
+ * Copies the ASS file to a temp dir and uses a relative path to dodge the Windows
+ * drive-letter colon being parsed as an FFmpeg filter option separator.
+ */
+export declare function burnCaptions(videoPath: string, assPath: string, outputPath: string): Promise<string>;
+//# sourceMappingURL=captionBurning.d.ts.map

package/dist/tools/ffmpeg/captionBurning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionBurning.d.ts","sourceRoot":"","sources":["../../../src/tools/ffmpeg/captionBurning.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA6DjB"}

package/dist/tools/ffmpeg/captionBurning.js

@@ -0,0 +1,71 @@
+import { execFile } from 'child_process';
+import { promises as fs } from 'fs';
+import pathMod from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+import logger from '../../config/logger';
+const ffmpegPath = process.env.FFMPEG_PATH || 'ffmpeg';
+const __dirname = pathMod.dirname(fileURLToPath(import.meta.url));
+const FONTS_DIR = pathMod.resolve(__dirname, '..', '..', '..', 'assets', 'fonts');
+/**
+ * Burn ASS subtitles into video (hard-coded subtitles).
+ * Uses direct execFile instead of fluent-ffmpeg to avoid Windows path escaping issues.
+ * Copies the ASS file to a temp dir and uses a relative path to dodge the Windows
+ * drive-letter colon being parsed as an FFmpeg filter option separator.
+ */
+export async function burnCaptions(videoPath, assPath, outputPath) {
+    const outputDir = pathMod.dirname(outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    logger.info(`Burning captions into video → ${outputPath}`);
+    // Create a dedicated temp dir so we can use colon-free relative paths
+    const workDir = await fs.mkdtemp(pathMod.join(os.tmpdir(), 'caption-'));
+    const tempAss = pathMod.join(workDir, 'captions.ass');
+    const tempOutput = pathMod.join(workDir, 'output.mp4');
+    await fs.copyFile(assPath, tempAss);
+    // Copy bundled fonts so libass can find them via fontsdir=.
+    const fontFiles = await fs.readdir(FONTS_DIR);
+    for (const f of fontFiles) {
+        if (f.endsWith('.ttf') || f.endsWith('.otf')) {
+            await fs.copyFile(pathMod.join(FONTS_DIR, f), pathMod.join(workDir, f));
+        }
+    }
+    // Use just the filename — no drive letter, no colons
+    const args = [
+        '-y',
+        '-i', videoPath,
+        '-vf', 'ass=captions.ass:fontsdir=.',
+        '-c:a', 'copy',
+        '-c:v', 'libx264',
+        '-preset', 'ultrafast',
+        '-crf', '23',
+        '-threads', '4',
+        tempOutput,
+    ];
+    return new Promise((resolve, reject) => {
+        execFile(ffmpegPath, args, { cwd: workDir, maxBuffer: 10 * 1024 * 1024 }, async (error, _stdout, stderr) => {
+            const cleanup = async () => {
+                const files = await fs.readdir(workDir).catch(() => []);
+                for (const f of files) {
+                    await fs.unlink(pathMod.join(workDir, f)).catch(() => { });
+                }
+                await fs.rmdir(workDir).catch(() => { });
+            };
+            if (error) {
+                await cleanup();
+                logger.error(`Caption burning failed: ${stderr || error.message}`);
+                reject(new Error(`Caption burning failed: ${stderr || error.message}`));
+                return;
+            }
+            try {
+                await fs.rename(tempOutput, outputPath);
+            }
+            catch {
+                await fs.copyFile(tempOutput, outputPath);
+            }
+            await cleanup();
+            logger.info(`Captions burned: ${outputPath}`);
+            resolve(outputPath);
+        });
+    });
+}
+//# sourceMappingURL=captionBurning.js.map

package/dist/tools/ffmpeg/captionBurning.js.map

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

package/dist/tools/ffmpeg/clipExtraction.d.ts

@@ -0,0 +1,23 @@
+import { ShortSegment } from '../../types';
+/**
+ * Extract a single clip segment using stream copy (-c copy) for speed.
+ * @param buffer Seconds of padding added before start and after end (default 1.0)
+ */
+export declare function extractClip(videoPath: string, start: number, end: number, outputPath: string, buffer?: number): Promise<string>;
+/**
+ * Extract multiple non-contiguous segments and concatenate them into one clip.
+ * Each segment is padded by `buffer` seconds on both sides for smoother cuts.
+ * Re-encodes and uses concat demuxer for clean joins.
+ * @param buffer Seconds of padding added before start and after end of each segment (default 1.0)
+ */
+export declare function extractCompositeClip(videoPath: string, segments: ShortSegment[], outputPath: string, buffer?: number): Promise<string>;
+/**
+ * Extract multiple non-contiguous segments and concatenate them with crossfade
+ * transitions using FFmpeg xfade/acrossfade filters.
+ * Falls back to extractCompositeClip if only one segment is provided.
+ *
+ * @param transitionDuration Crossfade duration in seconds (default 0.5)
+ * @param buffer Seconds of padding added before/after each segment (default 1.0)
+ */
+export declare function extractCompositeClipWithTransitions(videoPath: string, segments: ShortSegment[], outputPath: string, transitionDuration?: number, buffer?: number): Promise<string>;
+//# sourceMappingURL=clipExtraction.d.ts.map

package/dist/tools/ffmpeg/clipExtraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipExtraction.d.ts","sourceRoot":"","sources":["../../../src/tools/ffmpeg/clipExtraction.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAgEjB;AAED;;;;;;;GAOG;AACH,wBAAsB,mCAAmC,CACvD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,EAAE,EACxB,UAAU,EAAE,MAAM,EAClB,kBAAkB,GAAE,MAAY,EAChC,MAAM,GAAE,MAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CA0FjB"}