interface Pipeline {
  toJSON(): ExecutionPlan;
  execute(config?: ExecuteOptions): Promise<PipelineExecution>;
  onProgress(callback: (progress: PipelineProgress) => void): Pipeline;
  onError(callback: (error: Error) => void): Pipeline;
  getOperations(): VideoOperation[];
}

interface ExecutionPlan {
  jobs: JobNode[];
  baseExecutionId?: string;
}

interface JobNode {
  id: string;
  type: OperationType;
  params: Record<string, unknown>;
  dependsOn?: string[];
  output: string;
}

type OperationType =
  | "generate" // Video generation
  | "generateImage" // Image generation
  | "generateAudio" // Audio/speech generation
  | "transcribe" // Audio transcription
  | "merge" // Merge media items
  | "addSubtitles" // Add subtitles
  | "layer"; // Composite layers

interface ExecuteOptions {
  apiKey?: string; // SYNTHOME_API_KEY
  apiUrl?: string; // API endpoint URL
  baseExecutionId?: string; // Reference to parent execution
  webhook?: string; // Webhook URL for async completion
  webhookSecret?: string; // HMAC secret for webhook verification
  providerApiKeys?: {
    replicate?: string;
    fal?: string;
  };
}

interface PipelineExecution {
  id: string;
  status: "pending" | "processing" | "completed" | "failed";
  result?: MediaResult;
  onComplete(callback: (result: MediaResult) => void): void;
  onError(callback: (error: Error) => void): void;
}

interface PipelineProgress {
  currentJob: string;
  progress: number;
  totalJobs: number;
  completedJobs: number;
}

interface MediaResult {
  url: string;
  type?: "video" | "audio" | "image";
  duration?: number;
  format?: string;
  size?: number;
}

interface ExecutionStatusResponse {
  id: string;
  status: "pending" | "processing" | "completed" | "failed";
  jobs: JobStatus[];
  result: MediaResult | null;
  error: string | null;
  createdAt: Date;
  completedAt: Date | null;
}

interface JobStatus {
  id: string;
  operation: string;
  status: string;
  result: any;
  error: string | null;
}

interface VideoOperation {
  type: OperationType;
  params: Record<string, unknown>;
  inputs?: VideoNode[];
}

interface ImageOperation {
  type: "generateImage";
  params: Record<string, unknown>;
}

interface AudioOperation {
  type: "generateAudio";
  params: Record<string, unknown>;
}

type VideoNode = Video | VideoOperation | Pipeline;

interface GenerateVideoOptions {
  model: VideoModel;
  prompt: string;
  image?: string | ImageOperation;
  audio?: string | AudioOperation;
  aspectRatio?: "16:9" | "9:16" | "1:1";
  duration?: number;
}

interface GenerateImageOptions {
  model: ImageModel;
  prompt: string;
  aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4";
  width?: number;
  height?: number;
}

interface GenerateAudioOptions {
  model: AudioModel;
  text: string;
  voice?: string;
}

type MergeItem = string | MergeOperation | MergeItemWithOptions;

interface MergeItemWithOptions {
  url: string | MergeOperation;
  type?: "video" | "image" | "audio";
  duration?: number; // Display duration (images) or trim duration (video)
  offset?: number; // Audio start position in timeline
  volume?: number; // Volume level 0-1
}

interface LayerItem {
  media?:
    | string
    | string[]
    | VideoOperation
    | ImageOperation
    | Array<VideoOperation | ImageOperation>;
  placement?: PlacementPreset | CustomPlacement;
  chromaKey?: boolean;
  chromaKeyColor?: string;
  similarity?: number;
  blend?: number;
  duration?: number;
  main?: boolean;
}

type PlacementPreset =
  | "full" // Full screen
  | "center" // Centered, original size
  | "pip" // Picture-in-picture (bottom-right)
  | "picture-in-picture" // Same as pip
  | string; // Tailwind-style (e.g., "w-1/4 bottom-right")

interface CustomPlacement {
  width?: string; // e.g., "50%", "1920", "iw/2"
  height?: string; // e.g., "50%", "1080", "ih/2"
  position?: {
    x?: string; // e.g., "0", "50%", "(W-w)/2"
    y?: string;
  };
  padding?: number;
  aspectRatio?: string;
}

interface LayersOptions {
  duration?: number; // Output duration
  width?: number; // Output width
  height?: number; // Output height
  mainLayer?: number; // Index of main layer for duration
}

type VideoModelName = "seedance" | "minimax" | "fabric" | "fabric-fast";

type ImageModelName =
  | "nano-banana"
  | "nano-banana-pro"
  | "seedream"
  | "background-remover";

type AudioModelName = "elevenlabs" | "hume" | "whisper" | "fast-whisper";

interface ExecuteResponse {
  executionId: string;
  status: "pending";
  createdAt: string;
}

interface ErrorResponse {
  error: string;
  details?: string;
}