scraper

type Config struct {
	// System
	SystemID string

	// Media selection
	MediaTypes []string // ES-DE media type names

	// Region preferences
	PreferredRegions []string

	// Output directory for media files
	MediaOutputDir string

	// Cache settings
	SkipCacheRead  bool // --no-cache
	SkipCacheWrite bool // --cache-only

	// Overwrite behavior
	Overwrite bool // --overwrite

	// Rate limiting (from user info)
	MaxThreads        int
	MaxRequestsPerMin int

	// Filter for which entries to scrape
	Filter       *Filter
	FilterConfig *FilterConfig
}

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

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

type FilterConfig struct {
	GamelistPath string          // Path to existing gamelist.xml (for metadata checks)
	MediaDir     string          // Path to media directory (for media file checks)
	GamelistMap  map[string]bool // Map of ROM paths that exist in gamelist
}

type FilterContext struct {
	Missing MissingContext `expr:"missing"`
}

type Hashes struct {
	SHA1  string
	MD5   string
	CRC32 string
}

type LookupEntry struct {
	// Identification
	Name     string // Display name (from DAT or filename)
	FileName string // ROM filename with extension (for API)
	Hashes   Hashes // SHA1, MD5, CRC32
	Serial   string // Game code (from DAT serial or ROM header)
	Size     int64  // File size in bytes

	// Region info (parsed from name or ROM header)
	Regions []string // e.g., ["us", "eu"]

	// Output path (for media naming)
	BaseName string // Filename without extension

	// Source info
	Source  LookupSource
	ROMPath string // Only for ROM source
}

type LookupSource int

type MissingContext struct {
	Metadata      bool `expr:"metadata"`
	Screenshots   bool `expr:"screenshots"`
	Titlescreens  bool `expr:"titlescreens"`
	Covers        bool `expr:"covers"`
	Boxes3D       bool `expr:"3dboxes"`
	Marquees      bool `expr:"marquees"`
	Fanart        bool `expr:"fanart"`
	Videos        bool `expr:"videos"`
	Physicalmedia bool `expr:"physicalmedia"`
	Backcovers    bool `expr:"backcovers"`
}

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

type ProgressUpdate struct {
	Type         UpdateType
	EntryName    string
	WorkerID     int
	MediaTotal   int    // total media types to download
	MediaDone    int    // media types downloaded successfully
	CacheHits    int    // API calls avoided due to cache (game info + media)
	MediaFailed  int    // media types that failed (error/timeout)
	MediaMissing int    // media types not available
	CurrentMedia string // currently downloading (for display)
	Error        error
}

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

type RateLimiterStats struct {
	ActiveThreads     int
	MaxThreads        int
	RequestsLastMin   int
	MaxPerMinute      int
	BackoffLevel      int
	BackoffRemaining  time.Duration
	TotalRequests     int     // total API calls completed
	RequestsPerSecond float64 // completed API calls per second (30s sliding window)
	InFlightRequests  int     // requests started but not yet completed
}

type ScrapeResult struct {
	Entry     *LookupEntry
	Game      *screenscraper.Game // nil if not found
	Media     map[string]string   // mediaType -> local path (downloaded)
	Error     error
	Cached    bool   // true if game info from cache
	Skipped   bool   // true if skipped (BIOS, etc.)
	Reason    string // reason for skip/error
	CacheHits int    // total API calls avoided due to cache
}

type ScrapeResults struct {
	Results         []*ScrapeResult
	TotalEntries    int
	Found           int
	NotFound        int
	Skipped         int
	Errors          int
	MediaTotal      int
	MediaDownloaded int
	CacheHits       int
	FilteredOut     int // entries excluded by --filter expression
}

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

type Status int

type UpdateType int

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