Types

interface ClientOptions {
  baseURL?: string;
  debug?: boolean;
  headers?: Record<string, string>;
}

interface Video {
  id: string;
  playbackId: string;
  title: string;
  description?: string;
  duration: number;
  status: string;
  publishedAt: string;
  createdAt: string;
  updatedAt: string;
  captions?: VideoSubtitles[];
  chapters?: Chapter[];
  attachments?: VideoAttachment[];
  transcript?: VideoTranscript;
  downloadUrls?: VideoDownloadUrls;
  metadata?: VideoMetadata;
}

interface VideoAttachment {
  id: string;
  title: string;
  fileUrl: string;
  size: number;
  type: string;
}

interface VideoDownloadUrls {
  mp4?: string;
  audio?: string;
  legacyMp4?: string;
}

interface VideoSubtitles {
  language: string;
  engine: string;
  url: string;
}

interface VideoTranscript {
  text: string;
  json: TranscriptSegment[];
}

interface VideoMetadata {
  title?: string;
  description?: string;
  image?: string;
}

interface Playlist {
  id: string;
  title: string;
  description?: string;
  videos: Video[];
  createdAt: string;
  updatedAt: string;
}

interface ChatOptions {
  prompt: string;
  stream?: boolean;
  videoId?: string;
  currentTime?: number;
  conversationId?: string;
  collectionId?: string;
  tags?: string[];
}

interface SearchOptions {
  prompt: string;
  stream?: boolean;
  limit?: number;
  collectionId?: string;
  videoId?: string;
  tags?: string[];
  context?: ConversationMessage[];
}

interface RecommendationsOptions {
  topics: string[];
  stream?: boolean;
  limit?: number;
  collectionId?: string;
  tags?: string[];
  includeGuidance?: boolean;
  context?: ConversationMessage[];
}

interface AIResponse {
  text: string;
  sources?: Segment[];
  usage?: AIUsage;
}

interface AIUsage {
  inputTokens: number;
  outputTokens: number;
}

type AIEvent =
  | { type: 'message_start'; conversationId: string }
  | { type: 'text_delta'; text: string }
  | { type: 'sources'; sources: Segment[] }
  | { type: 'recommendations'; recommendations: Recommendation[] }
  | { type: 'message_complete'; usage: AIUsage }
  | { type: 'error'; error: string };

interface Segment {
  videoId: string;
  videoTitle: string;
  start: number;
  end: number;
  text: string;
  speaker?: string;
}

interface Recommendation {
  topic: string;
  videos: RecommendationVideo[];
}

interface RecommendationVideo {
  id: string;
  title: string;
  description?: string;
  duration: number;
  score: number;
}

interface Conversation {
  id: string;
  messages: ConversationMessage[];
  metadata: ConversationMetadata;
}

interface ConversationMessage {
  role: 'user' | 'assistant';
  content: string;
  sources?: Segment[];
}

interface ConversationMetadata {
  query: string;
  status: string;
}

interface Settings {
  account: Account;
  portal: Portal;
  metadata: VideoMetadata;
  theme: ThemeConfig;
  featuredPlaylists: Playlist[];
}

interface Account {
  ai: AccountAI;
  persona: Persona;
}

interface AccountAI {
  name?: string;
  greeting?: string;
  avatar?: string;
}

interface Persona {
  enabled: boolean;
  conversationStarters?: string[];
}

interface Portal {
  display: PortalDisplay;
  layout: PortalLayout;
  navigation: PortalNavigation;
  theme: PortalTheme;
  hero: PortalHero;
  redirects?: CustomRedirect[];
}

interface ThemeConfig {
  radius: number;
  colors: ThemeColors;
}

interface ThemeColors {
  light: ColorPalette;
  dark: ColorPalette;
}