import { fetchTranscript } from 'ytranscript';

const transcript = await fetchTranscript('dQw4w9WgXcQ', {
  languages: ['en', 'es'], // Preference order
  includeAutoGenerated: true,
});

console.log(transcript.text); // Full transcript text
console.log(transcript.segments); // Array of { text, start, duration }
console.log(transcript.language); // 'en'
console.log(transcript.isAutoGenerated); // true/false

import {
  loadWatchHistory,
  loadWatchLater,
  mergeVideoSources,
  processVideos,
} from 'ytranscript';

// Load from Google Takeout
const history = await loadWatchHistory('./watch-history.json');
const watchLater = await loadWatchLater('./watch-later.csv');

// Merge and deduplicate
const videos = mergeVideoSources(history, watchLater);

// Process with progress callback
const results = await processVideos(videos, {
  concurrency: 4,
  pauseAfter: 10,
  pauseDuration: 5000,
  onProgress: (completed, total, result) => {
    const status = result.transcript ? 'OK' : 'FAIL';
    console.log(`[${completed}/${total}] ${result.meta.videoId}: ${status}`);
  },
});

// Filter successful results
const transcripts = results.filter((r) => r.transcript);

import { streamVideos, appendJsonl } from 'ytranscript';

for await (const result of streamVideos(videos, { concurrency: 4 })) {
  // Write each result immediately (resume-safe)
  await appendJsonl(result, 'output.jsonl');
}

import { fetchTranscript, formatSrt, formatVtt, formatText } from 'ytranscript';

const transcript = await fetchTranscript('dQw4w9WgXcQ');

// SRT subtitles
const srt = formatSrt(transcript);
await Bun.write('video.srt', srt);

// VTT subtitles
const vtt = formatVtt(transcript);
await Bun.write('video.vtt', vtt);

// Plain text with timestamps
const text = formatText(transcript, true);
// [0:00] First line of transcript
// [0:05] Second line...

interface Transcript {
  videoId: string;
  text: string;
  segments: TranscriptSegment[];
  language: string;
  isAutoGenerated: boolean;
}

interface TranscriptSegment {
  text: string;
  start: number;  // seconds
  duration: number;  // seconds
}

interface TranscriptResult {
  meta: WatchHistoryMeta;
  transcript: Transcript | null;
  error?: string;
}

interface FetchOptions {
  languages?: string[];
  timeout?: number;
  includeAutoGenerated?: boolean;
}

interface BulkOptions extends FetchOptions {
  concurrency?: number;
  pauseAfter?: number;
  pauseDuration?: number;
  skipIds?: Set<string>;
  onProgress?: (completed: number, total: number, result: TranscriptResult) => void;
}