boris/api/video-meta.ts

import type { VercelRequest, VercelResponse } from '@vercel/node'
import { getSubtitles } from '@treeee/youtube-caption-extractor'

type Caption = { start: number; dur: number; text: string }

type Subtitle = { start: string | number; dur: string | number; text: string }

type CacheEntry = {
  body: unknown
  expires: number
}

type VimeoOEmbedResponse = {
  title: string
  description: string
  author_name: string
  author_url: string
  provider_name: string
  provider_url: string
  type: string
  version: string
  width: number
  height: number
  html: string
  thumbnail_url: string
  thumbnail_width: number
  thumbnail_height: number
}

// In-memory cache for 7 days
const WEEK_MS = 7 * 24 * 60 * 60 * 1000
const memoryCache = new Map<string, CacheEntry>()

function buildKey(videoId: string, lang: string, preferAuto?: string | string[], source?: string) {
  return `${source || 'video'}|${videoId}|${lang}|${preferAuto ? 'auto' : 'manual'}`
}

function ok(res: VercelResponse, data: unknown) {
  res.setHeader('Cache-Control', 'public, max-age=86400, s-maxage=604800') // client: 1d, CDN: 7d
  return res.status(200).json(data)
}

function bad(res: VercelResponse, code: number, message: string) {
  return res.status(code).json({ error: message })
}

function extractVideoId(url: string): { id: string; source: 'youtube' | 'vimeo' } | null {
  // YouTube patterns
  const youtubePatterns = [
    /(?:youtube\.com\/watch\?v=|youtu\.be\/|youtube\.com\/embed\/)([^&\n?#]+)/,
    /youtube\.com\/v\/([^&\n?#]+)/
  ]
  
  for (const pattern of youtubePatterns) {
    const match = url.match(pattern)
    if (match) {
      return { id: match[1], source: 'youtube' }
    }
  }
  
  // Vimeo patterns
  const vimeoPatterns = [
    /vimeo\.com\/(\d+)/,
    /player\.vimeo\.com\/video\/(\d+)/
  ]
  
  for (const pattern of vimeoPatterns) {
    const match = url.match(pattern)
    if (match) {
      return { id: match[1], source: 'vimeo' }
    }
  }
  
  return null
}

async function pickCaptions(videoID: string, preferredLangs: string[], manualFirst: boolean): Promise<{ caps: Caption[]; lang: string; isAuto: boolean } | null> {
  for (const lang of preferredLangs) {
    try {
      const caps = await getSubtitles({ videoID, lang })
      if (Array.isArray(caps) && caps.length > 0) {
        // Convert the returned subtitles to our Caption format
        const convertedCaps: Caption[] = caps.map((cap: Subtitle) => ({
          start: typeof cap.start === 'string' ? parseFloat(cap.start) : cap.start,
          dur: typeof cap.dur === 'string' ? parseFloat(cap.dur) : cap.dur,
          text: cap.text
        }))
        return { caps: convertedCaps, lang, isAuto: !manualFirst }
      }
    } catch {
      // try next
    }
  }
  return null
}

async function getVimeoMetadata(videoId: string): Promise<{ title: string; description: string; thumbnail_url?: string }> {
  const vimeoUrl = `https://vimeo.com/${videoId}`
  const oembedUrl = `https://vimeo.com/api/oembed.json?url=${encodeURIComponent(vimeoUrl)}`
  
  const response = await fetch(oembedUrl)
  if (!response.ok) {
    throw new Error(`Vimeo oEmbed API returned ${response.status}`)
  }
  
  const data: VimeoOEmbedResponse = await response.json()
  
  return {
    title: data.title || '',
    description: data.description || '',
    thumbnail_url: data.thumbnail_url || ''
  }
}

export default async function handler(req: VercelRequest, res: VercelResponse) {
  const url = (req.query.url as string | undefined)?.trim()
  const videoId = (req.query.videoId as string | undefined)?.trim()
  
  if (!url && !videoId) {
    return bad(res, 400, 'Missing url or videoId parameter')
  }

  // Extract video info from URL or use provided videoId
  let videoInfo: { id: string; source: 'youtube' | 'vimeo' }
  
  if (url) {
    const extracted = extractVideoId(url)
    if (!extracted) {
      return bad(res, 400, 'Unsupported video URL. Only YouTube and Vimeo are supported.')
    }
    videoInfo = extracted
  } else {
    // If only videoId is provided, assume YouTube for backward compatibility
    videoInfo = { id: videoId!, source: 'youtube' }
  }

  const lang = ((req.query.lang as string | undefined) || 'en').toLowerCase()
  const uiLocale = (req.headers['x-ui-locale'] as string | undefined)?.toLowerCase()
  const preferAuto = req.query.preferAuto === 'true'

  const cacheKey = buildKey(videoInfo.id, lang, preferAuto ? 'auto' : undefined, videoInfo.source)
  const now = Date.now()
  const cached = memoryCache.get(cacheKey)
  if (cached && cached.expires > now) {
    return ok(res, cached.body)
  }

  try {
    if (videoInfo.source === 'youtube') {
      // YouTube handling
      // Fetch basic metadata from YouTube page
      let title = ''
      let description = ''
      
      try {
        const response = await fetch(`https://www.youtube.com/watch?v=${videoInfo.id}`)
        if (response.ok) {
          const html = await response.text()
          // Extract title from HTML
          const titleMatch = html.match(/<title>([^<]+)<\/title>/)
          if (titleMatch) {
            title = titleMatch[1].replace(' - YouTube', '').trim()
          }
          // Extract description from meta tag
          const descMatch = html.match(/<meta name="description" content="([^"]+)"/)
          if (descMatch) {
            description = descMatch[1].trim()
          }
        }
      } catch (error) {
        console.warn('Failed to fetch YouTube metadata:', error)
      }

      // Language order: manual en -> uiLocale -> lang -> any manual, then auto with same order
      const langs: string[] = Array.from(new Set(['en', uiLocale, lang].filter(Boolean) as string[]))

      let selected = null as null | { caps: Caption[]; lang: string; isAuto: boolean }
      // Manual first
      selected = await pickCaptions(videoInfo.id, langs, true)
      if (!selected) {
        // Try auto
        selected = await pickCaptions(videoInfo.id, langs, false)
      }

      const captions = selected?.caps || []
      const transcript = captions.map(c => c.text).join(' ').trim()
      const response = {
        title,
        description,
        captions,
        transcript,
        lang: selected?.lang || lang,
        isAuto: selected?.isAuto || false,
        source: 'youtube'
      }

      memoryCache.set(cacheKey, { body: response, expires: now + WEEK_MS })
      return ok(res, response)
    } else if (videoInfo.source === 'vimeo') {
      // Vimeo handling
      const { title, description, thumbnail_url } = await getVimeoMetadata(videoInfo.id)
      
      const response = {
        title,
        description,
        thumbnail_url,
        captions: [], // Vimeo doesn't provide captions through oEmbed API
        transcript: '', // No transcript available
        lang: 'en', // Default language
        isAuto: false, // Not applicable for Vimeo
        source: 'vimeo'
      }

      memoryCache.set(cacheKey, { body: response, expires: now + WEEK_MS })
      return ok(res, response)
    } else {
      return bad(res, 400, 'Unsupported video source')
    }
  } catch (e) {
    return bad(res, 500, `Failed to fetch ${videoInfo.source} metadata`)
  }
}