@thunderkiller/video-clipper 1.5.5 → 1.6.0

package/README.md

@@ -1,8 +1,8 @@
-# video-clipper
+# @thunderkiller/video-clipper
 
-A TypeScript CLI tool that takes a YouTube URL, analyzes the transcript with an LLM, and returns the most interesting moments as ranked timestamp ranges. Optionally downloads the video and cuts clips automatically.
+A TypeScript CLI (and library) that analyzes a YouTube video with an LLM, finds the most interesting moments, and optionally downloads the video and cuts clips automatically.
 
-## How it works
+## How It Works
 
 ```
 YouTube URL
@@ -11,10 +11,10 @@ YouTube URL
 Parse URL → fetch transcript → group into chunks
     │
     ▼
-Parallel LLM analysis (Vercel AI SDK + gpt-4o)
+Parallel LLM analysis (Vercel AI SDK — OpenAI, Anthropic, Google, and more)
     │
     ▼
-Rank & deduplicate segments
+Merge with audio event detection → rank & deduplicate segments
     │
     ▼
 Refine clip boundaries (second LLM pass)
@@ -23,132 +23,80 @@ Refine clip boundaries (second LLM pass)
 (Optional) Download video + cut clips with ffmpeg
 ```
 
-## Tech Stack
-
-| Layer             | Choice                                                                                                                                                 |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Language          | TypeScript (Node.js 18+)                                                                                                                               |
-| Transcript        | `youtube-transcript`                                                                                                                                   |
-| LLM               | Vercel AI SDK (`ai` + `@ai-sdk/openai`, `@ai-sdk/anthropic`, `@ai-sdk/google`, `@ai-sdk/xai`, `@ai-sdk/mistral`, `@ai-sdk/groq`, `@ai-sdk/openrouter`) |
-| Structured output | `generateObject` + `zod`                                                                                                                               |
-| Video download    | `yt-dlp` via `execa`                                                                                                                                   |
-| Clip cutting      | `fluent-ffmpeg`                                                                                                                                        |
-| Config validation | `zod`                                                                                                                                                  |
-| Concurrency       | `p-limit`                                                                                                                                              |
-
 ## Requirements
 
 - Node.js 18+
-- `yt-dlp` (for video download)
-- `ffmpeg` (for clip cutting)
+- [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) — for video download
+- [`ffmpeg`](https://ffmpeg.org) — for clip cutting
 
 ```bash
 # macOS
 brew install yt-dlp ffmpeg
 ```
 
-## Audio/Video Sync
-
-Clips are generated by re-encoding with `libx264` (video) and `aac` (audio) to ensure perfect audio/video synchronization. This is slower than stream copy mode but prevents the common issue where video and audio become desynchronized in the output clips.
-
-**Performance vs Quality Trade-off:**
-
-Use the `FFMPEG_PRESET` environment variable to adjust encoding speed:
-
-| Preset           | Speed     | Quality | Use Case               |
-| ---------------- | --------- | ------- | ---------------------- |
-| `ultrafast`      | Very fast | Lowest  | Quick testing          |
-| `fast` (default) | Fast      | Good    | Balanced performance   |
-| `medium`         | Medium    | Better  | Higher quality clips   |
-| `slow`           | Slow      | High    | Final production clips |
-
-Example:
+## Installation
 
 ```bash
-# Faster processing (lower quality)
-FFMPEG_PRESET=ultrafast npm run start -- <url> --clip
+# Global CLI
+npm install -g @thunderkiller/video-clipper
+
+# One-off with npx (no install)
+npx @thunderkiller/video-clipper <url>
 
-# Higher quality (slower)
-FFMPEG_PRESET=medium npm run start -- <url> --clip
+# As a library
+npm install @thunderkiller/video-clipper
 ```
 
-## Setup
+## Quick Start
 
-```bash
-npm install
-cp .env.example .env
-```
+**1. Configure your LLM provider**
 
-Edit `.env` and configure your LLM provider:
+Create a `.env` file in your working directory:
 
 ```env
-# Choose your provider (openai, anthropic, google, xai, mistral, groq, zai, openrouter)
 LLM_PROVIDER=openai
-OPENAI_API_KEY=your_key_here
-
-# Or use a free model via OpenRouter:
-# LLM_PROVIDER=openrouter
-# OPENROUTER_API_KEY=sk-or-...
-# LLM_MODEL=meta-llama/llama-3.3-70b-instruct:free
+OPENAI_API_KEY=sk-...
 ```
 
-## Advanced Examples
+Or use a free model via OpenRouter:
 
-```bash
-# Analyze only (no download)
-npm run start -- <youtube-url>
+```env
+LLM_PROVIDER=openrouter
+OPENROUTER_API_KEY=sk-or-...
+LLM_MODEL=meta-llama/llama-3.3-70b-instruct:free
+```
 
-# Analyze and download full video
-npm run start -- <youtube-url> --download
+**2. Run**
 
-# Analyze and cut clips
-npm run start -- <youtube-url> --clip
+```bash
+# Analyze only — prints ranked segments as JSON
+video-clipper https://youtube.com/watch?v=VIDEO_ID
 
-# Limit number of clips to generate
-npm run start -- <youtube-url> --clip --max-clips 3
+# Analyze and cut clips (downloads video, runs ffmpeg)
+video-clipper https://youtube.com/watch?v=VIDEO_ID --clip
 
-# Use custom output directory
-OUTPUT_DIR=my-clips npm run start -- <youtube-url> --clip
+# Download only the top 3 segments (faster than full video)
+video-clipper https://youtube.com/watch?v=VIDEO_ID --download-sections 3
 ```
 
-## Configuration
-
-All parameters are set via `.env`:
+## CLI Flags
 
-| Variable                       | Default          | Description                                                                                            |
-| ------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------ |
-| **Provider selection**         |
-| `LLM_PROVIDER`                 | `openai`         | LLM provider (openai, anthropic, google, xai, mistral, groq, zai, openrouter)                          |
-| `OPENAI_API_KEY`               | —                | Your OpenAI API key (required if LLM_PROVIDER=openai)                                                  |
-| `ANTHROPIC_API_KEY`            | —                | Your Anthropic API key (required if LLM_PROVIDER=anthropic)                                            |
-| `GOOGLE_GENERATIVE_AI_API_KEY` | —                | Your Google API key (required if LLM_PROVIDER=google)                                                  |
-| `XAI_API_KEY`                  | —                | Your XAI API key (required if LLM_PROVIDER=xai)                                                        |
-| `MISTRAL_API_KEY`              | —                | Your Mistral API key (required if LLM_PROVIDER=mistral)                                                |
-| `GROQ_API_KEY`                 | —                | Your Groq API key (required if LLM_PROVIDER=groq)                                                      |
-| `ZAI_API_KEY`                  | —                | Your Zai API key (required if LLM_PROVIDER=zai)                                                        |
-| `OPENROUTER_API_KEY`           | —                | Your OpenRouter API key (required if LLM_PROVIDER=openrouter)                                          |
-| **Model & LLM**                |
-| `LLM_MODEL`                    | `gpt-4o`         | Model ID (depends on provider)                                                                         |
-| `LLM_MAX_RETRIES`              | `3`              | Max retries on rate-limit errors                                                                       |
-| `LLM_CONCURRENCY`              | `3`              | Max parallel LLM calls                                                                                 |
-| `LLM_SYSTEM_PROMPT`            | (default prompt) | Custom system prompt for LLM analysis                                                                  |
-| **Analysis parameters**        |
-| `SCORE_THRESHOLD`              | `7`              | Minimum score (1–10) to keep a segment                                                                 |
-| `TOP_N_SEGMENTS`               | `10`             | Max number of segments to return                                                                       |
-| `CHUNK_LENGTH_SEC`             | `120`            | LLM analysis window size in seconds                                                                    |
-| `CHUNK_OVERLAP_SEC`            | `20`             | Overlap between consecutive chunks                                                                     |
-| `MICRO_BLOCK_SEC`              | `15`             | Transcript grouping window in seconds                                                                  |
-| `MAX_CHUNKS`                   | —                | Limit number of chunks sent to LLM (optional)                                                          |
-| **Video download**             |
-| `DOWNLOAD_SECTIONS_MODE`       | `all`            | yt-dlp mode: all (full video) or N (top N segments only, e.g. 1, 2, 3...)                              |
-| `FFMPEG_PRESET`                | `fast`           | ffmpeg encoding preset: ultrafast, superfast, veryfast, fast (default), medium, slow, slower           |
-| `TIMESTAMP_OFFSET_SECONDS`     | `0`              | Adjust all clip timestamps (positive = later, negative = earlier) to fix transcript-video misalignment |
-| **Paths**                      |
-| `DOWNLOAD_DIR`                 | `downloads/`     | Where to store downloaded videos                                                                       |
-| `OUTPUT_DIR`                   | `outputs/`       | Where to store generated clips and dumps                                                               |
-| `CACHE_DIR`                    | `outputs/cache`  | Where to store transcript and LLM result cache                                                         |
-| **Output options**             |
-| `DUMP_OUTPUTS`                 | `true`           | Write transcript/analysis JSON dumps                                                                   |
+| Flag                       | Description                                                              |
+| -------------------------- | ------------------------------------------------------------------------ |
+| `--clip`                   | Download video and generate mp4 clips for each segment                   |
+| `--download-sections <n>`  | Download only top N segments via yt-dlp `--download-sections` (e.g. `3`) |
+| `--local-video <path>`     | Cut clips from a local video file — skips yt-dlp download entirely       |
+| `--video-path <path>`      | Custom output directory for downloaded videos and clips                  |
+| `--threshold <n>`          | Minimum score (1–10) to keep a segment (default: `7`)                    |
+| `--top-n <n>`              | Maximum number of segments to return (default: `10`)                     |
+| `--max-duration <s>`       | Abort if video is longer than N seconds                                  |
+| `--max-chunks <n>`         | Limit number of transcript chunks sent to LLM                            |
+| `--max-parallel <n>`       | Max parallel LLM calls                                                   |
+| `--no-audio`               | Disable audio event detection (transcript-only mode)                     |
+| `--game-profile <profile>` | Audio event profile: `valorant`, `fps`, `boss_fight`, `general`          |
+| `--output-json <path>`     | Write output JSON to file instead of stdout                              |
+| `--no-cache`               | Bypass all caches and force a fresh run                                  |
+| `--help, -h`               | Show help message                                                        |
 
 ## Output
 
@@ -163,267 +111,39 @@ All parameters are set via `.env`:
       "start": 120,
       "end": 150,
       "score": 9,
-      "reason": "strong controversial opinion"
+      "reason": "strong controversial opinion",
+      "source": "transcript"
     },
     {
       "rank": 2,
       "start": 420,
       "end": 455,
       "score": 8,
-      "reason": "funny storytelling moment"
+      "reason": "funny storytelling moment",
+      "source": "both"
     }
   ]
 }
 ```
 
-## Caching
-
-The CLI caches both transcript fetches and LLM chunk results to speed up subsequent runs:
-
-- **Transcript cache**: Stored per video ID in `CACHE_DIR`
-- **LLM chunk cache**: Stores successful chunk analyses to avoid re-analyzing the same content
-
-Cache is automatically used on re-runs. Use `--no-cache` to bypass.
-
-## Working with Pre-Downloaded Videos
-
-If you already have a video downloaded (from yt-dlp, browser download, or other tool), you can skip the download step and work directly with that file.
-
-**Workflow:**
-
-```bash
-# Step 1: Run analysis once to get segment timestamps
-npm run start -- <url> --output-json analysis.json
-
-# Step 2: (Optional) Edit timestamps in analysis.json if needed
-# Edit the "start" and "end" values for each segment
-
-# Step 3: Place your video in downloads/ directory
-cp /path/to/your/video.mp4 downloads/<videoId>.mp4
-
-# Step 4: Run again - will skip download and use your video
-npm run start -- <url> --clip
-```
-
-**Use cases:**
-
-- **Testing different settings** - Run different clip configurations without re-downloading
-- **Manual timestamp adjustment** - Fine-tune segment boundaries based on visual inspection
-- **Alternative video sources** - Work with videos downloaded from other tools or browsers
-- **Large video files** - If you have a high-quality version, use that instead
-
-**Notes:**
-
-- The video file must be named exactly `{videoId}.mp4` in the `DOWNLOAD_DIR`
-- You can apply `TIMESTAMP_OFFSET_SECONDS` globally instead of editing each timestamp
-- Transcript cache is used, so re-running is fast (no API calls)
-
-### Combining with Timestamp Offset
-
-For pre-downloaded videos with known sync issues:
-
-```bash
-# Skip download, apply 3-second offset to all clips
-TIMESTAMP_OFFSET_SECONDS=-3 npm run start -- <url> --clip
-```
-
-The CLI will find the existing video in `downloads/`, skip the download step, and apply the offset to all clip generation.
-
-## Usage
-
-### Basic analysis (no download)
-
-```bash
-npm run start -- https://youtube.com/watch?v=abc123
-```
-
-### Download full video and generate clips
-
-```bash
-npm run start -- https://youtube.com/watch?v=abc123 --clip
-```
+## Programmatic API
 
-### Download top N segments only
+```typescript
+import { runPipeline, parseArgs, config } from '@thunderkiller/video-clipper';
 
-```bash
-# Download top 3 segments
-npm run start -- https://youtube.com/watch?v=abc123 --download-sections 3
-
-# Download top 5 segments
-npm run start -- https://youtube.com/watch?v=abc123 --download-sections 5
-```
-
-### Custom output directory
-
-```bash
-# Store clips in custom directory
-npm run start -- https://youtube.com/watch?v=abc123 --clip --video-path ./my-clips
-
-# Download segments to custom path
-npm run start -- https://youtube.com/watch?v=abc123 --download-sections 3 --video-path ./downloads
-```
-
-### Custom thresholds
-
-```bash
-npm run start -- https://youtube.com/watch?v=abc123 --threshold 8 --top-n 5
-```
-
-### Testing with limited chunks
-
-```bash
-npm run start -- https://youtube.com/watch?v=abc123 --max-chunks 3
+const args = parseArgs(process.argv);
+await runPipeline(args);
 ```
 
-### Custom thresholds with timestamp offset
-
-```bash
-# Fix 3-second audio delay (shift earlier)
-TIMESTAMP_OFFSET_SECONDS=-3 npm run start -- <url> --clip
-
-# Fix 2-second early start (shift later)
-TIMESTAMP_OFFSET_SECONDS=2 npm run start -- <url> --clip
-
-# High quality, slower processing, with offset
-FFMPEG_PRESET=slow TIMESTAMP_OFFSET_SECONDS=-3 npm run start -- <url> --clip
-```
-
-## Troubleshooting Audio Sync Issues
-
-### Problem: Audio is delayed or starts early
-
-**Symptoms:**
-
-- Video starts at correct moment but audio plays 2-5 seconds later/earlier
-- Lip movements don't match speech in the clip
-- Content in clip doesn't match the transcript segment
-
-**Root Causes:**
-
-1. **Transcript misalignment** - Transcript timestamps don't perfectly match the video
-   - **Auto-generated captions**: Often have 1-3 second delays
-   - **Manual captions**: Usually more accurate but can have timing issues
-   - **Multiple caption tracks**: Transcripts from different video versions
-
-2. **Millisecond precision loss** - Old implementation lost decimal seconds
-   - Now fixed: `--download-sections` uses HH:MM:SS.mmm format
-
-3. **Version differences** - The transcript might be from a slightly different version of the video
-
-### Solution: Use `TIMESTAMP_OFFSET_SECONDS`
-
-**What it does:**
-Applies a global offset to all clip timestamps. Positive = shift later, negative = shift earlier.
-
-**How to use:**
-
-```bash
-# Add to .env
-TIMESTAMP_OFFSET_SECONDS=-3
-
-# Or inline
-TIMESTAMP_OFFSET_SECONDS=-3 npm run start -- <url> --clip
-```
-
-### Finding the Correct Offset
-
-**Step 1: Test with logging**
-
-Run a single segment and observe the logs:
-
-```bash
-TIMESTAMP_OFFSET_SECONDS=0 npm run start -- <url> --download-sections 1
-```
-
-Look for these log lines:
-
-```
-[info] Downloading segment 1: 00:02:00.500-00:02:30.000 (strong opinion...)
-[info]   Requested: 120.50s - 150.00s
-[info]   Adjusted: 117.50s - 147.00s (offset: -3s)
-[info] Cutting clip: start=117.50s, end=147.00s, duration=29.50s
-```
-
-**Step 2: Play and verify**
-
-- Open the generated clip
-- Check if the moment matches the transcript description
-- Note if it's too early or too late
-
-**Step 3: Adjust offset**
-
-If clip **starts 3 seconds late**:
-
-```bash
-TIMESTAMP_OFFSET_SECONDS=-3  # Negative = shift earlier
-```
-
-If clip **starts 2 seconds early**:
-
-```bash
-TIMESTAMP_OFFSET_SECONDS=2   # Positive = shift later
-```
-
-**Step 4: Verify with multiple clips**
-
-```bash
-TIMESTAMP_OFFSET_SECONDS=-3 npm run start -- <url> --download-sections 3
-```
-
-Check if the offset works consistently across different segments.
-
-### Binary Search for Optimal Offset
-
-If you're unsure of the exact offset:
-
-```bash
-# Try 0, -3, -6, -9 to see which is closest
-for offset in 0 -3 -6 -9; do
-  TIMESTAMP_OFFSET_SECONDS=$offset npm run start -- <url> --download-sections 1
-  echo "Tested offset: $offset"
-  # Play and check accuracy
-done
-```
-
-Then narrow down: `-3` seems good, try `-2` and `-4`, etc.
-
-### Common Scenarios
-
-| Scenario                | Likely Offset | Explanation                                         |
-| ----------------------- | ------------- | --------------------------------------------------- |
-| Auto-generated captions | `-1` to `-3`  | ASR timing often lags behind actual speech          |
-| Manual captions         | `0` to `-1`   | Usually more accurate, small sync issues            |
-| Multiple caption tracks | `-2` to `-5`  | Different versions may have systematic offset       |
-| Regional variations     | Varies        | Different regions may have different caption timing |
-
-### Verifying the Fix
-
-After applying `TIMESTAMP_OFFSET_SECONDS`, verify:
-
-1. **Watch the clip**: Audio and video should be synchronized
-2. **Check multiple clips**: Offset should work consistently
-3. **Compare with original**: Clip should match the described content
-
-If offset varies between segments, the issue might be video-specific rather than a global transcript offset.
-
-### CLI Flags
-
-| Flag                         | Description                                                                   |
-| ---------------------------- | ----------------------------------------------------------------------------- |
-| `--clip`                     | Download video and generate mp4 clips for each segment                        |
-| `--download-sections <mode>` | yt-dlp mode: `all` (full video) or `N` (top N segments only, e.g. 1, 2, 3...) |
-| `--video-path <path>`        | Custom output directory for downloaded videos and clips                       |
-| `--threshold <n>`            | Minimum score (1–10) to keep a segment                                        |
-| `--top-n <n>`                | Maximum number of segments to return                                          |
-| `--max-duration <s>`         | Abort if video is longer than N seconds                                       |
-| `--max-chunks <n>`           | Limit number of transcript chunks sent to LLM                                 |
-| `--max-parallel <n>`         | Max number of LLM calls to run in parallel                                    |
-| `--output-json <path>`       | Write output JSON to file instead of stdout                                   |
-| `--no-cache`                 | Bypass all caches and force a fresh run                                       |
-| `--help, -h`                 | Show help message                                                             |
-
-## Docs
+All public types and Zod schemas are exported from the package root. See [src/lib.ts](src/lib.ts) for the full surface.
 
-Full architecture and build plan: [docs/plan.md](docs/plan.md)
+## Documentation
 
-yt-dlp download modes: [docs/yt-downloader.md](docs/yt-downloader.md)
+| Doc                                              | Description                                                           |
+| ------------------------------------------------ | --------------------------------------------------------------------- |
+| [docs/configuration.md](docs/configuration.md)   | Full environment variable reference, provider setup, FFmpeg presets   |
+| [docs/advanced-usage.md](docs/advanced-usage.md) | Advanced CLI examples, caching, pre-downloaded videos                 |
+| [docs/audio-sync.md](docs/audio-sync.md)         | Audio/video sync troubleshooting and `TIMESTAMP_OFFSET_SECONDS` guide |
+| [docs/yt-downloader.md](docs/yt-downloader.md)   | yt-dlp download modes explained                                       |
+| [docs/free-models.md](docs/free-models.md)       | Free models that work well with this tool                             |
+| [docs/plan.md](docs/plan.md)                     | Full architecture and pipeline design                                 |

package/dist/config/env.d.ts

@@ -28,6 +28,9 @@ export declare const config: {
     AUDIO_LLM_BOOST_WINDOW: number;
     AUDIO_LLM_SCORE_BOOST: number;
     GAME_PROFILE: "valorant" | "fps" | "boss_fight" | "general";
+    CACHE_BACKEND: "file" | "mongodb";
+    MONGODB_DATABASE: string;
+    CACHE_TTL_SECONDS: number;
     OPENAI_API_KEY?: string | undefined;
     ANTHROPIC_API_KEY?: string | undefined;
     GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
@@ -45,5 +48,6 @@ export declare const config: {
     FFPROBE_PATH?: string | undefined;
     YT_DLP_COOKIES_FROM_BROWSER?: "chrome" | "firefox" | "safari" | "brave" | "edge" | "opera" | "chromium" | undefined;
     YT_DLP_COOKIES_FILE?: string | undefined;
+    MONGODB_URI?: string | undefined;
 };
 //# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAiBvB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAe,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAiBvB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAe,CAAC"}

package/dist/config/index.d.ts

@@ -1,3 +1,2 @@
 export { config } from './env.js';
-export type { Config } from '../types/config.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { log } from './utils/logger.js';
-import { formatConfig } from './utils/redactConfig.js';
+import { formatConfig } from './utils/format.js';
 import { config } from './config/index.js';
 import { parseArgs, printUsage } from './cli.js';
 import { runPipeline } from './pipeline/runner.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAErC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClC,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC7C,GAAG,CAAC,IAAI,CACN,8FAA8F,CAC/F,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,IAAI,CACN,kCAAkC,MAAM,CAAC,SAAS,GAAG;IACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK;QACrE,CAAC,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,GAAG;QACpD,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/D,CAAC;AACF,GAAG,CAAC,IAAI,CAAC,WAAW,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAErC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClC,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC7C,GAAG,CAAC,IAAI,CACN,8FAA8F,CAC/F,CAAC;AACJ,CAAC;AAED,GAAG,CAAC,IAAI,CACN,kCAAkC,MAAM,CAAC,SAAS,GAAG;IACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,KAAK;QACrE,CAAC,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,GAAG;QACpD,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/D,CAAC;AACF,GAAG,CAAC,IAAI,CAAC,WAAW,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/pipeline/dumper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumper.d.ts","sourceRoot":"","sources":["../../src/pipeline/dumper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzF"}

package/dist/{utils → pipeline}/dumper.js

@@ -1,7 +1,7 @@
 import { promises as fs } from 'fs';
 import path from 'path';
 import { config } from '../config/index.js';
-import { log } from './logger.js';
+import { log } from '../utils/logger.js';
 /**
  * Writes the raw normalized transcript lines to
  * `{OUTPUT_DIR}/transcript/{videoId}.json`.

package/dist/pipeline/dumper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumper.js","sourceRoot":"","sources":["../../src/pipeline/dumper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,KAAuB;IAC3E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,iCAAiC,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,MAAsB;IACxE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CACN,+BAA+B,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/pipeline/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/runner.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAejE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoG9D"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/runner.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAejE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwG9D"}