image

type DownloadOptions struct {
	OutputDir         string // Directory to save images
	OverwriteExisting bool   // Whether to overwrite existing files
	CreateDir         bool   // Create output directory if it doesn't exist
	FileNamePattern   string // Pattern for file naming (e.g., "{word}_{source}")
	MaxSizeBytes      int64  // Maximum file size to download (0 = no limit)
}

type Downloader struct {
	// contains filtered or unexported fields
}

type ImageSearcher interface {
	// Search performs an image search with the given options
	Search(ctx context.Context, opts *SearchOptions) ([]SearchResult, error)

	// Download downloads an image from the given URL
	Download(ctx context.Context, url string) (io.ReadCloser, error)

	// GetAttribution returns the required attribution text for an image
	GetAttribution(result *SearchResult) string

	// Name returns the name of the search provider
	Name() string
}

type OpenAIClient struct {

	// PromptCallback is called when the prompt is generated, before the image is created
	PromptCallback func(prompt string)
	// contains filtered or unexported fields
}

type OpenAIConfig struct {
	APIKey  string
	Model   string
	Size    string
	Quality string
	Style   string
}

type RateLimitError struct {
	Provider     string
	RetryAfter   int // Seconds to wait before retry
	LimitPerHour int
	LimitPerDay  int
}

type SearchError struct {
	Provider string
	Code     string
	Message  string
}

type SearchOptions struct {
	Query        string // Search query (Bulgarian word)
	Translation  string // English translation (if already available)
	Language     string // Language code (default: "bg")
	SafeSearch   bool   // Enable safe search filtering
	PerPage      int    // Number of results per page
	Page         int    // Page number (1-based)
	ImageType    string // Type: "photo", "illustration", "vector", "all"
	Orientation  string // Orientation: "horizontal", "vertical", "all"
	CustomPrompt string // Custom prompt for AI image generation (OpenAI)
}

type SearchResult struct {
	ID           string // Unique identifier
	URL          string // Direct URL to the image
	ThumbnailURL string // URL to thumbnail version
	Width        int    // Image width in pixels
	Height       int    // Image height in pixels
	Description  string // Image description or tags
	Attribution  string // Attribution text if required
	Source       string // Source provider (e.g., "pixabay", "unsplash")
}