vidpipe 1.0.0

package/dist/index.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initConfig, validateRequiredKeys, getConfig } from './config/environment';
+import { FileWatcher } from './services/fileWatcher';
+import { processVideoSafe } from './pipeline';
+import logger, { setVerbose } from './config/logger';
+import path from 'path';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '..', 'package.json'), 'utf-8'));
+const BANNER = `
+╔══════════════════════════════════════╗
+║   Video Auto Note Taker  v${pkg.version.padEnd(10)}║
+╚══════════════════════════════════════╝
+`;
+const program = new Command();
+program
+    .name('video-auto-note-taker')
+    .description('Automatically process videos: transcribe, summarize, generate shorts, captions, and social posts')
+    .version(pkg.version, '-V, --version')
+    .argument('[video-path]', 'Path to a video file to process (implies --once)')
+    .option('--watch-dir <path>', 'Folder to watch for new recordings (default: env WATCH_FOLDER)')
+    .option('--output-dir <path>', 'Output directory for processed videos (default: ./recordings)')
+    .option('--openai-key <key>', 'OpenAI API key (default: env OPENAI_API_KEY)')
+    .option('--exa-key <key>', 'Exa AI API key for web search (default: env EXA_API_KEY)')
+    .option('--once', 'Process a single video and exit (no watching)')
+    .option('--brand <path>', 'Path to brand.json config (default: ./brand.json)')
+    .option('--no-git', 'Skip git commit/push stage')
+    .option('--no-silence-removal', 'Skip silence removal stage')
+    .option('--no-shorts', 'Skip shorts generation')
+    .option('--no-medium-clips', 'Skip medium clip generation')
+    .option('--no-social', 'Skip social media post generation')
+    .option('--no-captions', 'Skip caption generation/burning')
+    .option('-v, --verbose', 'Verbose logging');
+program.parse();
+const opts = program.opts();
+const videoArg = program.args[0];
+const onceMode = opts.once || !!videoArg;
+const cliOptions = {
+    watchDir: opts.watchDir,
+    outputDir: opts.outputDir,
+    openaiKey: opts.openaiKey,
+    exaKey: opts.exaKey,
+    brand: opts.brand,
+    verbose: opts.verbose,
+    git: opts.git,
+    silenceRemoval: opts.silenceRemoval,
+    shorts: opts.shorts,
+    mediumClips: opts.mediumClips,
+    social: opts.social,
+    captions: opts.captions,
+};
+const queue = [];
+let processing = false;
+let shutdownRequested = false;
+let watcher = null;
+async function processQueue() {
+    if (processing || queue.length === 0)
+        return;
+    processing = true;
+    try {
+        while (queue.length > 0) {
+            const videoPath = queue.shift();
+            logger.info(`Processing video: ${videoPath}`);
+            await processVideoSafe(videoPath);
+            if (onceMode) {
+                logger.info('--once flag set, exiting after first video.');
+                await shutdown();
+                return;
+            }
+            if (shutdownRequested)
+                break;
+        }
+    }
+    finally {
+        processing = false;
+    }
+}
+function enqueue(videoPath) {
+    queue.push(videoPath);
+    logger.info(`Queued video: ${videoPath} (queue length: ${queue.length})`);
+    processQueue().catch(err => logger.error('Queue processing error:', err));
+}
+async function shutdown() {
+    if (shutdownRequested)
+        return;
+    shutdownRequested = true;
+    logger.info('Shutting down...');
+    if (watcher) {
+        watcher.stop();
+    }
+    while (processing) {
+        await new Promise((resolve) => setTimeout(resolve, 500));
+    }
+    logger.info('Goodbye.');
+    process.exit(0);
+}
+async function main() {
+    logger.info(BANNER);
+    initConfig(cliOptions);
+    if (opts.verbose)
+        setVerbose();
+    validateRequiredKeys();
+    const config = getConfig();
+    logger.info(`Watch folder: ${config.WATCH_FOLDER}`);
+    logger.info(`Output dir:   ${config.OUTPUT_DIR}`);
+    // Direct file mode: process a specific video and exit
+    if (videoArg) {
+        const resolvedPath = path.resolve(videoArg);
+        logger.info(`Processing single video: ${resolvedPath}`);
+        await processVideoSafe(resolvedPath);
+        logger.info('Done.');
+        process.exit(0);
+    }
+    // Watch mode
+    watcher = new FileWatcher();
+    watcher.on('new-video', (filePath) => {
+        enqueue(filePath);
+    });
+    watcher.start();
+    if (onceMode) {
+        logger.info('Running in --once mode. Will exit after processing the next video.');
+    }
+    else {
+        logger.info('Watching for new videos. Press Ctrl+C to stop.');
+    }
+}
+process.on('SIGINT', () => shutdown());
+process.on('SIGTERM', () => shutdown());
+main().catch((err) => {
+    logger.error(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,57 @@
+import type { Transcript, StageResult, PipelineResult, PipelineStage } from './types';
+/**
+ * Execute a single pipeline stage with error isolation and timing.
+ *
+ * ### Stage contract
+ * - Each stage is wrapped in a try/catch so a failure **does not abort** the
+ *   pipeline. Subsequent stages proceed with whatever data is available.
+ * - Returns `undefined` on failure (callers must null-check before using the result).
+ * - Records success/failure, error message, and wall-clock duration in `stageResults`
+ *   for the pipeline summary.
+ *
+ * This design lets the pipeline produce partial results — e.g. if shorts
+ * generation fails, the summary and social posts can still be generated
+ * from the transcript.
+ *
+ * @param stageName - Enum value identifying the stage (used in logs and results)
+ * @param fn - Async function that performs the stage's work
+ * @param stageResults - Mutable array that accumulates per-stage outcome records
+ * @returns The stage result on success, or `undefined` on failure
+ */
+export declare function runStage<T>(stageName: PipelineStage, fn: () => Promise<T>, stageResults: StageResult[]): Promise<T | undefined>;
+/**
+ * Adjust transcript timestamps to account for removed silence segments.
+ * Shifts all timestamps by subtracting the cumulative removed duration before each point.
+ */
+export declare function adjustTranscript(transcript: Transcript, removals: {
+    start: number;
+    end: number;
+}[]): Transcript;
+/**
+ * Run the full video processing pipeline.
+ *
+ * ### Stage ordering and data flow
+ * 1. **Ingest** — extracts metadata (slug, duration, paths). Required; aborts if failed.
+ * 2. **Transcribe** — Whisper transcription with word-level timestamps.
+ * 3. **Silence removal** — trims dead air from the video and adjusts the transcript
+ *    timestamps accordingly. Produces an `adjustedTranscript` for captions.
+ * 4. **Captions** — generates SRT/VTT/ASS files from the (adjusted) transcript.
+ * 5. **Caption burn** — renders captions into the video using FFmpeg. Prefers a
+ *    single-pass approach (silence removal + captions in one encode) when possible.
+ * 6. **Shorts** — AI-selected short clips. Uses the **original** transcript because
+ *    clips are cut from the original (unedited) video.
+ * 7. **Medium clips** — longer AI-selected clips (same original-transcript reasoning).
+ * 8. **Chapters** — topic-boundary detection for YouTube chapters.
+ * 9. **Summary** — README generation (runs after shorts/chapters so it can reference them).
+ * 10–12. **Social posts** — platform-specific posts for the full video and each clip.
+ * 13. **Blog** — long-form blog post from transcript + summary.
+ * 14. **Git push** — commits all generated assets and pushes.
+ *
+ * ### Why failures don't abort
+ * Each stage runs through {@link runStage} which catches errors. This means a
+ * transcription failure still lets git-push run (committing whatever was produced),
+ * and a shorts failure doesn't block summary generation.
+ */
+export declare function processVideo(videoPath: string): Promise<PipelineResult>;
+export declare function processVideoSafe(videoPath: string): Promise<PipelineResult | null>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,UAAU,EAKV,WAAW,EACX,cAAc,EACd,aAAa,EAGd,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,SAAS,EAAE,aAAa,EACxB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAexB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,GACzC,UAAU,CAmCZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAwM7E;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAQxF"}

package/dist/pipeline.js

@@ -0,0 +1,287 @@
+import path from 'path';
+import { promises as fs } from 'fs';
+import logger from './config/logger';
+import { getConfig } from './config/environment';
+import { ingestVideo } from './services/videoIngestion';
+import { transcribeVideo } from './services/transcription';
+import { generateCaptions } from './services/captionGeneration';
+import { generateSummary } from './agents/SummaryAgent';
+import { generateShorts } from './agents/ShortsAgent';
+import { generateMediumClips } from './agents/MediumVideoAgent';
+import { generateSocialPosts, generateShortPosts } from './agents/SocialMediaAgent';
+import { generateBlogPost } from './agents/BlogAgent';
+import { generateChapters } from './agents/ChapterAgent';
+import { commitAndPush } from './services/gitOperations';
+import { removeDeadSilence } from './agents/SilenceRemovalAgent';
+import { burnCaptions } from './tools/ffmpeg/captionBurning';
+import { singlePassEditAndCaption } from './tools/ffmpeg/singlePassEdit';
+import { PipelineStage as Stage } from './types';
+/**
+ * Execute a single pipeline stage with error isolation and timing.
+ *
+ * ### Stage contract
+ * - Each stage is wrapped in a try/catch so a failure **does not abort** the
+ *   pipeline. Subsequent stages proceed with whatever data is available.
+ * - Returns `undefined` on failure (callers must null-check before using the result).
+ * - Records success/failure, error message, and wall-clock duration in `stageResults`
+ *   for the pipeline summary.
+ *
+ * This design lets the pipeline produce partial results — e.g. if shorts
+ * generation fails, the summary and social posts can still be generated
+ * from the transcript.
+ *
+ * @param stageName - Enum value identifying the stage (used in logs and results)
+ * @param fn - Async function that performs the stage's work
+ * @param stageResults - Mutable array that accumulates per-stage outcome records
+ * @returns The stage result on success, or `undefined` on failure
+ */
+export async function runStage(stageName, fn, stageResults) {
+    const start = Date.now();
+    try {
+        const result = await fn();
+        const duration = Date.now() - start;
+        stageResults.push({ stage: stageName, success: true, duration });
+        logger.info(`Stage ${stageName} completed in ${duration}ms`);
+        return result;
+    }
+    catch (err) {
+        const duration = Date.now() - start;
+        const message = err instanceof Error ? err.message : String(err);
+        stageResults.push({ stage: stageName, success: false, error: message, duration });
+        logger.error(`Stage ${stageName} failed after ${duration}ms: ${message}`);
+        return undefined;
+    }
+}
+/**
+ * Adjust transcript timestamps to account for removed silence segments.
+ * Shifts all timestamps by subtracting the cumulative removed duration before each point.
+ */
+export function adjustTranscript(transcript, removals) {
+    const sorted = [...removals].sort((a, b) => a.start - b.start);
+    function adjustTime(t) {
+        let offset = 0;
+        for (const r of sorted) {
+            if (t <= r.start)
+                break;
+            if (t >= r.end) {
+                offset += r.end - r.start;
+            }
+            else {
+                // timestamp is inside a removed region — snap to removal start
+                offset += t - r.start;
+            }
+        }
+        return t - offset;
+    }
+    return {
+        ...transcript,
+        duration: adjustTime(transcript.duration),
+        segments: transcript.segments
+            .filter(seg => !sorted.some(r => seg.start >= r.start && seg.end <= r.end))
+            .map(seg => ({
+            ...seg,
+            start: adjustTime(seg.start),
+            end: adjustTime(seg.end),
+        })),
+        words: transcript.words
+            .filter(w => !sorted.some(r => w.start >= r.start && w.end <= r.end))
+            .map(w => ({
+            ...w,
+            start: adjustTime(w.start),
+            end: adjustTime(w.end),
+        })),
+    };
+}
+/**
+ * Run the full video processing pipeline.
+ *
+ * ### Stage ordering and data flow
+ * 1. **Ingest** — extracts metadata (slug, duration, paths). Required; aborts if failed.
+ * 2. **Transcribe** — Whisper transcription with word-level timestamps.
+ * 3. **Silence removal** — trims dead air from the video and adjusts the transcript
+ *    timestamps accordingly. Produces an `adjustedTranscript` for captions.
+ * 4. **Captions** — generates SRT/VTT/ASS files from the (adjusted) transcript.
+ * 5. **Caption burn** — renders captions into the video using FFmpeg. Prefers a
+ *    single-pass approach (silence removal + captions in one encode) when possible.
+ * 6. **Shorts** — AI-selected short clips. Uses the **original** transcript because
+ *    clips are cut from the original (unedited) video.
+ * 7. **Medium clips** — longer AI-selected clips (same original-transcript reasoning).
+ * 8. **Chapters** — topic-boundary detection for YouTube chapters.
+ * 9. **Summary** — README generation (runs after shorts/chapters so it can reference them).
+ * 10–12. **Social posts** — platform-specific posts for the full video and each clip.
+ * 13. **Blog** — long-form blog post from transcript + summary.
+ * 14. **Git push** — commits all generated assets and pushes.
+ *
+ * ### Why failures don't abort
+ * Each stage runs through {@link runStage} which catches errors. This means a
+ * transcription failure still lets git-push run (committing whatever was produced),
+ * and a shorts failure doesn't block summary generation.
+ */
+export async function processVideo(videoPath) {
+    const pipelineStart = Date.now();
+    const stageResults = [];
+    const cfg = getConfig();
+    logger.info(`Pipeline starting for: ${videoPath}`);
+    // 1. Ingestion — required for all subsequent stages
+    const video = await runStage(Stage.Ingestion, () => ingestVideo(videoPath), stageResults);
+    if (!video) {
+        const totalDuration = Date.now() - pipelineStart;
+        logger.error('Ingestion failed — cannot proceed without video metadata');
+        return { video: { originalPath: videoPath, repoPath: '', videoDir: '', slug: '', filename: '', duration: 0, size: 0, createdAt: new Date() }, transcript: undefined, editedVideoPath: undefined, captions: undefined, captionedVideoPath: undefined, summary: undefined, shorts: [], mediumClips: [], socialPosts: [], blogPost: undefined, stageResults, totalDuration };
+    }
+    // 2. Transcription
+    let transcript;
+    transcript = await runStage(Stage.Transcription, () => transcribeVideo(video), stageResults);
+    // 3. Silence Removal (context-aware)
+    let editedVideoPath;
+    let adjustedTranscript;
+    let silenceRemovals = [];
+    let silenceKeepSegments;
+    if (transcript && !cfg.SKIP_SILENCE_REMOVAL) {
+        const result = await runStage(Stage.SilenceRemoval, () => removeDeadSilence(video, transcript), stageResults);
+        if (result && result.wasEdited) {
+            editedVideoPath = result.editedPath;
+            silenceRemovals = result.removals;
+            silenceKeepSegments = result.keepSegments;
+            adjustedTranscript = adjustTranscript(transcript, silenceRemovals);
+            // Validate: check that adjusted transcript duration is close to edited video duration
+            const totalRemoved = silenceRemovals.reduce((sum, r) => sum + (r.end - r.start), 0);
+            const expectedDuration = transcript.duration - totalRemoved;
+            const adjustedDuration = adjustedTranscript.duration;
+            const drift = Math.abs(expectedDuration - adjustedDuration);
+            logger.info(`[Pipeline] Silence removal: original=${transcript.duration.toFixed(1)}s, removed=${totalRemoved.toFixed(1)}s, expected=${expectedDuration.toFixed(1)}s, adjusted=${adjustedDuration.toFixed(1)}s, drift=${drift.toFixed(1)}s`);
+            await fs.writeFile(path.join(video.videoDir, 'transcript-edited.json'), JSON.stringify(adjustedTranscript, null, 2));
+        }
+    }
+    // Use adjusted transcript for captions (if silence was removed), original otherwise
+    const captionTranscript = adjustedTranscript ?? transcript;
+    // 4. Captions (fast, no AI needed) — generate from the right transcript
+    let captions;
+    if (captionTranscript && !cfg.SKIP_CAPTIONS) {
+        captions = await runStage(Stage.Captions, () => generateCaptions(video, captionTranscript), stageResults);
+    }
+    // 5. Caption Burn — use single-pass (silence removal + captions) when possible
+    let captionedVideoPath;
+    if (captions && !cfg.SKIP_CAPTIONS) {
+        const assFile = captions.find((p) => p.endsWith('.ass'));
+        if (assFile && silenceKeepSegments) {
+            // Single-pass: re-do silence removal + burn captions from ORIGINAL video in one encode
+            // This guarantees frame-accurate cuts with perfectly aligned captions
+            const captionedOutput = path.join(video.videoDir, `${video.slug}-captioned.mp4`);
+            captionedVideoPath = await runStage(Stage.CaptionBurn, () => singlePassEditAndCaption(video.repoPath, silenceKeepSegments, assFile, captionedOutput), stageResults);
+        }
+        else if (assFile) {
+            // No silence removal — just burn captions into original video
+            const videoToBurn = editedVideoPath ?? video.repoPath;
+            const captionedOutput = path.join(video.videoDir, `${video.slug}-captioned.mp4`);
+            captionedVideoPath = await runStage(Stage.CaptionBurn, () => burnCaptions(videoToBurn, assFile, captionedOutput), stageResults);
+        }
+    }
+    // 6. Shorts — use ORIGINAL transcript (shorts reference original video timestamps)
+    let shorts = [];
+    if (transcript && !cfg.SKIP_SHORTS) {
+        const result = await runStage(Stage.Shorts, () => generateShorts(video, transcript), stageResults);
+        if (result)
+            shorts = result;
+    }
+    // 7. Medium Clips — use ORIGINAL transcript (medium clips reference original video timestamps)
+    let mediumClips = [];
+    if (transcript && !cfg.SKIP_MEDIUM_CLIPS) {
+        const result = await runStage(Stage.MediumClips, () => generateMediumClips(video, transcript), stageResults);
+        if (result)
+            mediumClips = result;
+    }
+    // 8. Chapters — analyse transcript for topic boundaries
+    let chapters;
+    if (transcript) {
+        chapters = await runStage(Stage.Chapters, () => generateChapters(video, transcript), stageResults);
+    }
+    // 9. Summary (after shorts, medium clips, and chapters so the README can reference them)
+    let summary;
+    if (transcript) {
+        summary = await runStage(Stage.Summary, () => generateSummary(video, transcript, shorts, chapters), stageResults);
+    }
+    // 10. Social Media
+    let socialPosts = [];
+    if (transcript && summary && !cfg.SKIP_SOCIAL) {
+        const result = await runStage(Stage.SocialMedia, () => generateSocialPosts(video, transcript, summary, path.join(video.videoDir, 'social-posts')), stageResults);
+        if (result)
+            socialPosts = result;
+    }
+    // 11. Short Posts — generate social posts per short clip
+    if (transcript && shorts.length > 0 && !cfg.SKIP_SOCIAL) {
+        await runStage(Stage.ShortPosts, async () => {
+            for (const short of shorts) {
+                const posts = await generateShortPosts(video, short, transcript);
+                socialPosts.push(...posts);
+            }
+        }, stageResults);
+    }
+    // 12. Medium Clip Posts — generate social posts per medium clip
+    if (transcript && mediumClips.length > 0 && !cfg.SKIP_SOCIAL) {
+        await runStage(Stage.MediumClipPosts, async () => {
+            for (const clip of mediumClips) {
+                const asShortClip = {
+                    id: clip.id,
+                    title: clip.title,
+                    slug: clip.slug,
+                    segments: clip.segments,
+                    totalDuration: clip.totalDuration,
+                    outputPath: clip.outputPath,
+                    captionedPath: clip.captionedPath,
+                    description: clip.description,
+                    tags: clip.tags,
+                };
+                const posts = await generateShortPosts(video, asShortClip, transcript);
+                // Move posts to medium-clips/{slug}/posts/
+                const clipsDir = path.join(path.dirname(video.repoPath), 'medium-clips');
+                const postsDir = path.join(clipsDir, clip.slug, 'posts');
+                await fs.mkdir(postsDir, { recursive: true });
+                for (const post of posts) {
+                    const destPath = path.join(postsDir, path.basename(post.outputPath));
+                    await fs.copyFile(post.outputPath, destPath);
+                    await fs.unlink(post.outputPath).catch(() => { });
+                    post.outputPath = destPath;
+                }
+                socialPosts.push(...posts);
+            }
+        }, stageResults);
+    }
+    // 13. Blog Post
+    let blogPost;
+    if (transcript && summary) {
+        blogPost = await runStage(Stage.Blog, () => generateBlogPost(video, transcript, summary), stageResults);
+    }
+    // 14. Git
+    if (!cfg.SKIP_GIT) {
+        await runStage(Stage.GitPush, () => commitAndPush(video.slug), stageResults);
+    }
+    const totalDuration = Date.now() - pipelineStart;
+    logger.info(`Pipeline completed in ${totalDuration}ms`);
+    return {
+        video,
+        transcript,
+        editedVideoPath,
+        captions,
+        captionedVideoPath,
+        summary,
+        chapters,
+        shorts,
+        mediumClips,
+        socialPosts,
+        blogPost,
+        stageResults,
+        totalDuration,
+    };
+}
+export async function processVideoSafe(videoPath) {
+    try {
+        return await processVideo(videoPath);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`Pipeline failed with uncaught error: ${message}`);
+        return null;
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/services/captionGeneration.d.ts

@@ -0,0 +1,7 @@
+import { VideoFile, Transcript } from '../types';
+/**
+ * Generate SRT, VTT, and ASS caption files for a video and save them to disk.
+ * Returns the list of written file paths.
+ */
+export declare function generateCaptions(video: VideoFile, transcript: Transcript): Promise<string[]>;
+//# sourceMappingURL=captionGeneration.d.ts.map

package/dist/services/captionGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionGeneration.d.ts","sourceRoot":"","sources":["../../src/services/captionGeneration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAKhD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB"}

package/dist/services/captionGeneration.js

@@ -0,0 +1,29 @@
+import path from 'path';
+import fsp from 'fs/promises';
+import { generateSRT, generateVTT, generateStyledASS } from '../tools/captions/captionGenerator';
+import { getConfig } from '../config/environment';
+import logger from '../config/logger';
+/**
+ * Generate SRT, VTT, and ASS caption files for a video and save them to disk.
+ * Returns the list of written file paths.
+ */
+export async function generateCaptions(video, transcript) {
+    const config = getConfig();
+    const captionsDir = path.join(config.OUTPUT_DIR, video.slug, 'captions');
+    await fsp.mkdir(captionsDir, { recursive: true });
+    const srtPath = path.join(captionsDir, 'captions.srt');
+    const vttPath = path.join(captionsDir, 'captions.vtt');
+    const assPath = path.join(captionsDir, 'captions.ass');
+    const srt = generateSRT(transcript);
+    const vtt = generateVTT(transcript);
+    const ass = generateStyledASS(transcript);
+    await Promise.all([
+        fsp.writeFile(srtPath, srt, 'utf-8'),
+        fsp.writeFile(vttPath, vtt, 'utf-8'),
+        fsp.writeFile(assPath, ass, 'utf-8'),
+    ]);
+    const paths = [srtPath, vttPath, assPath];
+    logger.info(`Captions saved: ${paths.join(', ')}`);
+    return paths;
+}
+//# sourceMappingURL=captionGeneration.js.map

package/dist/services/captionGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionGeneration.js","sourceRoot":"","sources":["../../src/services/captionGeneration.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,GAAG,MAAM,aAAa,CAAA;AAE7B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAA;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,MAAM,MAAM,kBAAkB,CAAA;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAgB,EAChB,UAAsB;IAEtB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACxE,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAEjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAEtD,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IACnC,MAAM,GAAG,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAEzC,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC;QACpC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC;QACpC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC;KACrC,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACzC,MAAM,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/services/fileWatcher.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from 'events';
+export interface FileWatcherOptions {
+    processExisting?: boolean;
+}
+export declare class FileWatcher extends EventEmitter {
+    private watchFolder;
+    private watcher;
+    private processExisting;
+    constructor(options?: FileWatcherOptions);
+    private static readonly MIN_FILE_SIZE;
+    private static readonly EXTRA_STABILITY_DELAY;
+    /** Read file size, wait, read again — if it changed the file is still being written. */
+    private isFileStable;
+    private handleDetectedFile;
+    private scanExistingFiles;
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=fileWatcher.d.ts.map

package/dist/services/fileWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.d.ts","sourceRoot":"","sources":["../../src/services/fileWatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAKrC,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,GAAE,kBAAuB;IAY5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAc;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IAEpD,wFAAwF;YAC1E,YAAY;YAWZ,kBAAkB;IA8BhC,OAAO,CAAC,iBAAiB;IAYzB,KAAK,IAAI,IAAI;IAqDb,IAAI,IAAI,IAAI;CAOb"}