v2

type AggregatedStats struct {
	// TotalUploaded is the sum of all uploaded bytes
	TotalUploaded int64 `json:"totalUploaded"`
	// TotalDownloaded is the sum of all downloaded bytes
	TotalDownloaded int64 `json:"totalDownloaded"`
	// AverageRatio is the average ratio across all sites
	AverageRatio float64 `json:"averageRatio"`
	// TotalSeeding is the sum of all seeding torrents
	TotalSeeding int `json:"totalSeeding"`
	// TotalLeeching is the sum of all leeching torrents
	TotalLeeching int `json:"totalLeeching"`
	// TotalBonus is the sum of all bonus points
	TotalBonus float64 `json:"totalBonus"`
	// SiteCount is the number of sites included
	SiteCount int `json:"siteCount"`
	// LastUpdate is when this was last calculated (Unix seconds)
	LastUpdate int64 `json:"lastUpdate"`
	// PerSiteStats contains individual site statistics
	PerSiteStats []UserInfo `json:"perSiteStats"`
	// TotalBonusPerHour is the sum of all bonus per hour
	TotalBonusPerHour float64 `json:"totalBonusPerHour,omitempty"`
	// TotalSeedingBonus is the sum of all seeding bonus points
	TotalSeedingBonus float64 `json:"totalSeedingBonus,omitempty"`
	// TotalUnreadMessages is the sum of all unread messages
	TotalUnreadMessages int `json:"totalUnreadMessages,omitempty"`
	// TotalSeederSize is the sum of all seeding sizes
	TotalSeederSize int64 `json:"totalSeederSize,omitempty"`
	// TotalLeecherSize is the sum of all leeching sizes
	TotalLeecherSize int64 `json:"totalLeecherSize,omitempty"`
}

type AlternativeRequirement struct {
	SeedingBonus float64 `json:"seedingBonus,omitempty"`
	Uploads      int     `json:"uploads,omitempty"`
	Bonus        float64 `json:"bonus,omitempty"`
	Downloaded   string  `json:"downloaded,omitempty"`
	Ratio        float64 `json:"ratio,omitempty"`
}

type BaseSite[Req any, Res any] struct {
	// contains filtered or unexported fields
}

type BaseSiteConfig struct {
	ID        string
	Name      string
	Kind      SiteKind
	RateLimit float64 // Requests per second
	RateBurst int     // Maximum burst size
	Logger    *zap.Logger
}

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

type CacheEntry struct {
	Key       string
	Value     any
	ExpiresAt time.Time
}

type CachedSearchOrchestrator struct {
	*SearchOrchestrator
	// contains filtered or unexported fields
}

type CategoryDefinition struct {
	Name    string           `json:"name"`
	Key     string           `json:"key"`
	Options []CategoryOption `json:"options"`
	Notes   string           `json:"notes,omitempty"`
}

type CategoryOption struct {
	Value any    `json:"value"`
	Name  string `json:"name"`
	Type  string `json:"type,omitempty"` // e.g., "normal", "adult" for mteam
}

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

type CircuitBreakerConfig struct {
	// FailureThreshold is the number of failures before opening the circuit
	FailureThreshold int
	// SuccessThreshold is the number of successes in half-open to close the circuit
	SuccessThreshold int
	// Timeout is how long to wait before transitioning from open to half-open
	Timeout time.Duration
	// MaxHalfOpenRequests is the max concurrent requests in half-open state
	MaxHalfOpenRequests int
}

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

type CircuitBreakerStats struct {
	Name            string    `json:"name"`
	State           string    `json:"state"`
	Failures        int       `json:"failures"`
	Successes       int       `json:"successes"`
	LastFailureTime time.Time `json:"lastFailureTime,omitempty"`
}

type CircuitState int

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

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

type Credentials struct {
	Username string `json:"username,omitempty"`
	Password string `json:"password,omitempty"`
	Cookie   string `json:"cookie,omitempty"`
	APIKey   string `json:"apiKey,omitempty"`
}

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

type Deduper struct{}

type DeprecationWarning struct {
	Field       string `json:"field"`
	Message     string `json:"message"`
	Replacement string `json:"replacement"`
	Version     string `json:"version"` // Version when it will be removed
}

type DiscountLevel string

type DownloadFeasibility struct {
	// CanComplete indicates if the download can complete before discount ends
	CanComplete bool `json:"canComplete"`
	// EstimatedTime is the estimated download time
	EstimatedTime time.Duration `json:"estimatedTime"`
	// TimeRemaining is the time remaining before discount ends
	TimeRemaining time.Duration `json:"timeRemaining"`
	// EffectiveSize is the size that counts towards download quota
	EffectiveSize int64 `json:"effectiveSize"`
	// Margin is the time margin (positive = can complete with time to spare)
	Margin time.Duration `json:"margin"`
}

type Driver[Req any, Res any] interface {
	// PrepareSearch converts a standard SearchQuery to site-specific request
	PrepareSearch(query SearchQuery) (Req, error)
	// Execute performs the actual network call
	Execute(ctx context.Context, req Req) (Res, error)
	// ParseSearch converts the raw response into standard TorrentItem list
	ParseSearch(res Res) ([]TorrentItem, error)
	// GetUserInfo fetches complete user information (including extended info if supported)
	// This method is responsible for making all necessary API calls
	GetUserInfo(ctx context.Context) (UserInfo, error)
	// PrepareDownload prepares request for downloading a torrent
	PrepareDownload(torrentID string) (Req, error)
	// ParseDownload extracts torrent file data from response
	ParseDownload(res Res) ([]byte, error)
}

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

type FailoverOption func(*FailoverHTTPClient)

type FieldSelector struct {
	// Selector is CSS selector(s) for HTML or JSON path for API
	Selector []string `json:"selector,omitempty"`
	// Text is the default value if selector doesn't match
	Text string `json:"text,omitempty"`
	// Attr is the attribute to extract (for HTML elements)
	Attr string `json:"attr,omitempty"`
	// Filters to apply to extracted value
	Filters []Filter `json:"filters,omitempty"`
	// ElementProcess is a custom processing function name
	ElementProcess string `json:"elementProcess,omitempty"`
	// SwitchFilters for different selectors
	SwitchFilters map[string][]Filter `json:"switchFilters,omitempty"`
}

type Filter struct {
	// Name is the filter function name
	Name string `json:"name"`
	// Args are optional arguments
	Args []any `json:"args,omitempty"`
}

type FilterFunc func(value any, args ...any) any

type FlexInt int

type FlexibleCode string

type FreeTorrentBatchResult struct {
	// ArchivePath is the path to the created archive file
	ArchivePath string `json:"archivePath"`
	// ArchiveType is the type of archive (tar.gz or zip)
	ArchiveType string `json:"archiveType"`
	// TorrentCount is the number of torrents in the archive
	TorrentCount int `json:"torrentCount"`
	// TotalSize is the total size of all torrents (bytes)
	TotalSize int64 `json:"totalSize"`
	// Manifest contains metadata for all torrents
	Manifest []TorrentManifest `json:"manifest"`
}

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

type GazelleDriver struct {
	BaseURL string
	APIKey  string
	Cookie  string
	// contains filtered or unexported fields
}

type GazelleDriverConfig struct {
	BaseURL    string
	APIKey     string
	Cookie     string
	HTTPClient *SiteHTTPClient // Use SiteHTTPClient instead of *http.Client
	UserAgent  string
}

type GazelleOptions struct {
	APIKey string `json:"apiKey,omitempty"`
	Cookie string `json:"cookie,omitempty"`
}

type GazelleRequest struct {
	// Action is the API action
	Action string
	// Params are the query parameters
	Params url.Values
}

type GazelleResponse struct {
	// Status is the response status ("success" or "failure")
	Status string `json:"status"`
	// Error is the error message (if status is "failure")
	Error string `json:"error,omitempty"`
	// Response is the response data
	Response json.RawMessage `json:"response"`
	// RawBody is the raw response body
	RawBody []byte `json:"-"`
	// StatusCode is the HTTP status code
	StatusCode int `json:"-"`
}

type GazelleSearchResponse struct {
	CurrentPage int                   `json:"currentPage"`
	Pages       int                   `json:"pages"`
	Results     []GazelleTorrentGroup `json:"results"`
}

type GazelleTorrent struct {
	TorrentID int `json:"torrentId"`
	EditionID int `json:"editionId,omitempty"`
	Artists   []struct {
		ID   int    `json:"id"`
		Name string `json:"name"`
	} `json:"artists,omitempty"`
	Remastered     bool   `json:"remastered"`
	RemasterYear   int    `json:"remasterYear,omitempty"`
	RemasterTitle  string `json:"remasterTitle,omitempty"`
	Media          string `json:"media"`
	Encoding       string `json:"encoding"`
	Format         string `json:"format"`
	HasLog         bool   `json:"hasLog"`
	LogScore       int    `json:"logScore"`
	HasCue         bool   `json:"hasCue"`
	Scene          bool   `json:"scene"`
	VanityHouse    bool   `json:"vanityHouse"`
	FileCount      int    `json:"fileCount"`
	Time           string `json:"time"`
	Size           int64  `json:"size"`
	Snatches       int    `json:"snatches"`
	Seeders        int    `json:"seeders"`
	Leechers       int    `json:"leechers"`
	IsFreeleech    bool   `json:"isFreeleech"`
	IsNeutralLeech bool   `json:"isNeutralLeech"`
	IsPersonalFL   bool   `json:"isPersonalFreeleech"`
	CanUseToken    bool   `json:"canUseToken"`
}

type GazelleTorrentGroup struct {
	GroupID   int              `json:"groupId"`
	GroupName string           `json:"groupName"`
	Artist    string           `json:"artist,omitempty"`
	Tags      []string         `json:"tags"`
	Torrents  []GazelleTorrent `json:"torrents"`
}

type GazelleUserResponse struct {
	Username string `json:"username"`
	ID       int    `json:"id"`
	Stats    struct {
		Uploaded   int64   `json:"uploaded"`
		Downloaded int64   `json:"downloaded"`
		Ratio      float64 `json:"ratio"`
		Buffer     int64   `json:"buffer"`
	} `json:"stats"`
	Ranks struct {
		Class string `json:"class"`
	} `json:"ranks"`
	Personal struct {
		Bonus float64 `json:"bonus"`
	} `json:"personal"`
	Community struct {
		Seeding  int `json:"seeding"`
		Leeching int `json:"leeching"`
	} `json:"community"`
}

type HDSkyParser struct {
	Config NexusPHPParserConfig
}

type HTTPClientConfig struct {
	// Timeout is the request timeout
	Timeout time.Duration
	// MaxIdleConns is the maximum number of idle connections
	MaxIdleConns int
	// MaxIdleConnsPerHost is the maximum idle connections per host
	MaxIdleConnsPerHost int
	// IdleConnTimeout is the idle connection timeout
	IdleConnTimeout time.Duration
	// DisableKeepAlives disables HTTP keep-alives
	DisableKeepAlives bool
}

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

type HTTPResponse struct {
	StatusCode int
	Body       []byte
	Headers    http.Header
}

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

type HistogramStats struct {
	Count int64   `json:"count"`
	Sum   float64 `json:"sum"`
	Min   float64 `json:"min"`
	Max   float64 `json:"max"`
	Avg   float64 `json:"avg"`
}

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

type L2Cache interface {
	Get(key string) ([]byte, error)
	Set(key string, value []byte, ttl time.Duration) error
	Delete(key string) error
}

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

type LevelGroupType string

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

type LevelProgress struct {
	// CurrentLevel is the user's current level/rank
	CurrentLevel string `json:"currentLevel"`
	// NextLevel is the next level to achieve
	NextLevel string `json:"nextLevel"`
	// UploadNeeded is the additional upload needed (bytes)
	UploadNeeded int64 `json:"uploadNeeded,omitempty"`
	// DownloadNeeded is the additional download needed (bytes)
	DownloadNeeded int64 `json:"downloadNeeded,omitempty"`
	// RatioNeeded is the additional ratio needed
	RatioNeeded float64 `json:"ratioNeeded,omitempty"`
	// TimeNeeded is the additional time needed
	TimeNeeded time.Duration `json:"timeNeeded,omitempty"`
	// ProgressPercent is the overall progress percentage (0-100)
	ProgressPercent float64 `json:"progressPercent"`
}

type LevelRequirement struct {
	// Level is the level name (e.g., "Power User", "Elite", "Master")
	Level string
	// MinUpload is the minimum upload amount in bytes
	MinUpload int64
	// MinRatio is the minimum ratio required
	MinRatio float64
	// MinDays is the minimum account age in days
	MinDays int
	// MinSeedingTorrents is the minimum number of seeding torrents
	MinSeedingTorrents int
	// MinSeedingTime is the minimum total seeding time in hours
	MinSeedingTime int
	// Order is the level order (higher = better)
	Order int
}

type MTorrentBonusResponse struct {
	Code    FlexibleCode `json:"code"`
	Message string       `json:"message"`
	Data    struct {
		FormulaParams struct {
			FinalBs json.Number `json:"finalBs"` // Bonus per hour (时魔) - can be string or number
		} `json:"formulaParams"`
	} `json:"data"`
}

type MTorrentDriver struct {
	BaseURL string // API URL (e.g., https://api.m-team.cc)
	WebURL  string // Web URL for detail pages (e.g., https://kp.m-team.cc)
	APIKey  string
	// contains filtered or unexported fields
}

type MTorrentDriverConfig struct {
	BaseURL     string
	WebURL      string // Optional: Web URL for detail pages, defaults to "https://kp.m-team.cc"
	APIKey      string
	HTTPClient  *SiteHTTPClient // Use SiteHTTPClient instead of *http.Client
	UserAgent   string
	UseFailover bool // Enable multi-URL failover
}

type MTorrentMemberCount struct {
	Uploaded   string `json:"uploaded"`
	Downloaded string `json:"downloaded"`
	Bonus      string `json:"bonus"`
	ShareRate  string `json:"shareRate"`
	Seedtime   string `json:"seedtime"`
	Leechtime  string `json:"leechtime"`
}

type MTorrentMemberStatus struct {
	LastLogin  string `json:"lastLogin"`
	LastBrowse string `json:"lastBrowse"`
	Vip        bool   `json:"vip"`
}

type MTorrentMessageStatResponse struct {
	Code    FlexibleCode `json:"code"`
	Message string       `json:"message"`
	Data    struct {
		Count  string `json:"count"`  // Total message count
		UnMake string `json:"unMake"` // Unread message count (string in API response)
	} `json:"data"`
}

type MTorrentOptions struct {
	APIKey string `json:"apiKey"`
}

type MTorrentPeerStatResponse struct {
	Code    FlexibleCode `json:"code"`
	Message string       `json:"message"`
	Data    struct {
		UID          string `json:"uid"`
		SeederCount  string `json:"seederCount"`
		SeederSize   string `json:"seederSize"`
		LeecherCount string `json:"leecherCount"`
		LeecherSize  string `json:"leecherSize"`
		UploadCount  string `json:"uploadCount"`
	} `json:"data"`
}

type MTorrentRequest struct {
	// Endpoint is the API endpoint path
	Endpoint string
	// Method is the HTTP method
	Method string
	// Body is the request body (will be JSON encoded or form-urlencoded based on ContentType)
	Body any
	// ContentType specifies the request content type (default: "application/json")
	// Use "application/x-www-form-urlencoded" for form data
	ContentType string
}

type MTorrentResponse struct {
	// Code is the response code ("0" for success)
	Code FlexibleCode `json:"code"`
	// Message is the response message
	Message string `json:"message"`
	// Data is the response data
	Data json.RawMessage `json:"data"`
	// RawBody is the raw response body (for downloads)
	RawBody []byte `json:"-"`
	// StatusCode is the HTTP status code
	StatusCode int `json:"-"`
}

type MTorrentSearchData struct {
	Data  []MTorrentTorrent `json:"data"`
	Total FlexInt           `json:"total"`
}

type MTorrentSearchRequest struct {
	Mode       string   `json:"mode"`
	Categories []string `json:"categories,omitempty"`
	Keyword    string   `json:"keyword,omitempty"`
	PageNumber int      `json:"pageNumber"`
	PageSize   int      `json:"pageSize"`
}

type MTorrentTorrent struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	SmallDescr  string `json:"smallDescr"`
	Size        string `json:"size"`
	CreatedDate string `json:"createdDate"`
	Status      struct {
		Seeders         FlexInt `json:"seeders"`
		Leechers        FlexInt `json:"leechers"`
		TimesCompleted  FlexInt `json:"timesCompleted"`
		Discount        string  `json:"discount"`
		DiscountEndTime string  `json:"discountEndTime,omitempty"`
	} `json:"status"`
	Category string `json:"category"`
}

type MTorrentUserInfo struct {
	ID           string               `json:"id"`
	Username     string               `json:"username"`
	CreatedDate  string               `json:"createdDate"`
	Role         string               `json:"role"`
	MemberCount  MTorrentMemberCount  `json:"memberCount"`
	MemberStatus MTorrentMemberStatus `json:"memberStatus"`
}

type MetricType string

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

type MetricsSnapshot struct {
	Counters   map[string]int64          `json:"counters"`
	Gauges     map[string]int64          `json:"gauges"`
	Histograms map[string]HistogramStats `json:"histograms"`
	Timestamp  time.Time                 `json:"timestamp"`
}

type MigrationStatus struct {
	SiteID            string `json:"siteId"`
	SiteName          string `json:"siteName"`
	OldImplementation bool   `json:"oldImplementation"`
	NewImplementation bool   `json:"newImplementation"`
	MigrationReady    bool   `json:"migrationReady"`
	Notes             string `json:"notes,omitempty"`
}

type MultiSiteSearchQuery struct {
	SearchQuery
	// Sites specifies which sites to search (empty means all)
	Sites []string `json:"sites,omitempty"`
	// Timeout is the maximum time to wait for all searches
	Timeout time.Duration `json:"timeout,omitempty"`
	// MinSeeders filters results by minimum seeders
	MinSeeders int `json:"minSeeders,omitempty"`
	// MaxSizeBytes filters results by maximum size
	MaxSizeBytes int64 `json:"maxSizeBytes,omitempty"`
	// MinSizeBytes filters results by minimum size
	MinSizeBytes int64 `json:"minSizeBytes,omitempty"`
}

type MultiSiteSearchResult struct {
	// Items contains deduplicated and ranked torrent items
	Items []TorrentItem `json:"items"`
	// TotalResults is the total number of results before deduplication
	TotalResults int `json:"totalResults"`
	// SiteResults contains per-site result counts
	SiteResults map[string]int `json:"siteResults"`
	// Errors contains any errors that occurred during search
	Errors []SearchError `json:"errors,omitempty"`
	// Duration is how long the search took
	Duration time.Duration `json:"duration"`
}

type NewDownloaderConfig struct {
	Type        string `json:"type"`        // "qbittorrent", "transmission"
	Name        string `json:"name"`        // Downloader name
	URL         string `json:"url"`         // Downloader URL
	Username    string `json:"username"`    // Username for authentication
	Password    string `json:"password"`    // Password for authentication
	AddAtPaused bool   `json:"addAtPaused"` // New field: true = add paused
}

type NexusPHPDetailParser interface {
	// ParseTitleAndID parses title and torrent ID from the page
	ParseTitleAndID(doc *goquery.Selection) (title, torrentID string)
	// ParseDiscount parses discount type and end time
	ParseDiscount(doc *goquery.Selection) (DiscountLevel, time.Time)
	// ParseHR parses HR (Hit and Run) status
	ParseHR(doc *goquery.Selection) bool
	// ParseSizeMB parses torrent size in MB
	ParseSizeMB(doc *goquery.Selection) float64
	// ParseAll parses all information from the page
	ParseAll(doc *goquery.Selection) *TorrentDetailInfo
}

type NexusPHPDriver struct {
	BaseURL   string
	Cookie    string
	Selectors SiteSelectors
	// contains filtered or unexported fields
}

type NexusPHPDriverConfig struct {
	BaseURL     string
	Cookie      string
	Selectors   *SiteSelectors
	HTTPClient  *SiteHTTPClient // Use SiteHTTPClient instead of *http.Client
	UserAgent   string
	UseFailover bool     // Enable multi-URL failover
	SiteName    SiteName // Site name for failover URL lookup
}

type NexusPHPOptions struct {
	Cookie    string         `json:"cookie"`
	Selectors *SiteSelectors `json:"selectors,omitempty"`
}

type NexusPHPParserConfig struct {
	TimeLayout string
}

type NexusPHPParserOption func(*NexusPHPParserConfig)

type NexusPHPRequest struct {
	// Path is the URL path (e.g., "/torrents.php")
	Path string
	// Params are the query parameters
	Params url.Values
	// Method is the HTTP method (default: GET)
	Method string
}

type NexusPHPResponse struct {
	// Document is the parsed HTML document
	Document *goquery.Document
	// RawBody is the raw response body (for downloads)
	RawBody []byte
	// StatusCode is the HTTP status code
	StatusCode int
}

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

type OldDownloaderConfig struct {
	Type      string `json:"type"`      // "qbittorrent", "transmission"
	Name      string `json:"name"`      // Downloader name
	URL       string `json:"url"`       // Downloader URL
	Username  string `json:"username"`  // Username for authentication
	Password  string `json:"password"`  // Password for authentication
	AutoStart bool   `json:"autoStart"` // Old field: true = start immediately
}

type OldSiteConfig struct {
	Name       string `json:"name"`
	Type       string `json:"type"` // "nexusphp", "mteam", etc.
	URL        string `json:"url"`
	Cookie     string `json:"cookie,omitempty"`
	APIKey     string `json:"apiKey,omitempty"`
	RateLimit  int    `json:"rateLimit,omitempty"`
	Selectors  any    `json:"selectors,omitempty"`
	AuthMethod string `json:"authMethod,omitempty"` // Old field name
}

type ParsedTorrent struct {
	// Name is the torrent name
	Name string `json:"name"`
	// InfoHash is the 40-character hex info hash
	InfoHash string `json:"infoHash"`
	// Size is the total size in bytes
	Size int64 `json:"size"`
	// Files is the list of files in the torrent
	Files []TorrentFile `json:"files,omitempty"`
	// PieceLength is the piece size in bytes
	PieceLength int64 `json:"pieceLength"`
	// Comment is the torrent comment
	Comment string `json:"comment,omitempty"`
	// CreatedBy is the creator of the torrent
	CreatedBy string `json:"createdBy,omitempty"`
	// CreationDate is when the torrent was created
	CreationDate time.Time `json:"creationDate,omitempty"`
	// Announce is the primary tracker URL
	Announce string `json:"announce,omitempty"`
	// AnnounceList is the list of tracker URLs
	AnnounceList [][]string `json:"announceList,omitempty"`
	// RawMetadata is the raw torrent file bytes
	RawMetadata []byte `json:"-"`
}

type PeerStatistics struct {
	// SeederCount is the number of torrents being seeded
	SeederCount int `json:"seederCount"`
	// SeederSize is the total size of seeding torrents (bytes)
	SeederSize int64 `json:"seederSize"`
	// LeecherCount is the number of torrents being downloaded
	LeecherCount int `json:"leecherCount"`
	// LeecherSize is the total size of leeching torrents (bytes)
	LeecherSize int64 `json:"leecherSize"`
}

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

type RankerConfig struct {
	// SeederWeight is the weight for seeders in scoring (default: 1.0)
	SeederWeight float64 `json:"seederWeight,omitempty"`
	// LeecherWeight is the weight for leechers in scoring (default: 0.5)
	LeecherWeight float64 `json:"leecherWeight,omitempty"`
	// FreeBonus is the bonus score for free torrents (default: 100)
	FreeBonus float64 `json:"freeBonus,omitempty"`
	// SizeWeight is the weight for size in scoring (default: 0.1)
	SizeWeight float64 `json:"sizeWeight,omitempty"`
	// RecencyWeight is the weight for recency in scoring (default: 0.2)
	RecencyWeight float64 `json:"recencyWeight,omitempty"`
	// SiteReliability maps site IDs to reliability scores (0-1)
	SiteReliability map[string]float64 `json:"siteReliability,omitempty"`
}

type RequestConfig struct {
	// URL is the request path (e.g., "/index.php")
	URL string `json:"url"`
	// Method is the HTTP method (default: GET)
	Method string `json:"method,omitempty"`
	// Params are query parameters
	Params map[string]string `json:"params,omitempty"`
	// Data is the request body for POST requests
	Data map[string]any `json:"data,omitempty"`
	// ResponseType is "document" for HTML or "json" for JSON
	ResponseType string `json:"responseType,omitempty"`
	// Headers are additional HTTP headers
	Headers map[string]string `json:"headers,omitempty"`
}

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

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

type RetryConfig struct {
	// MaxRetries is the maximum number of retries
	MaxRetries int
	// InitialBackoff is the initial backoff duration
	InitialBackoff time.Duration
	// MaxBackoff is the maximum backoff duration
	MaxBackoff time.Duration
	// BackoffMultiplier is the backoff multiplier
	BackoffMultiplier float64
	// Jitter adds randomness to backoff
	Jitter bool
	// RetryableStatusCodes are HTTP status codes that should trigger a retry
	RetryableStatusCodes []int
}

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

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

type SearchCacheConfig struct {
	// TTL is the time-to-live for cache entries (default: 5 minutes)
	TTL time.Duration `json:"ttl,omitempty"`
	// MaxSize is the maximum number of entries (default: 1000)
	MaxSize int `json:"maxSize,omitempty"`
}

type SearchError struct {
	Site  string `json:"site"`
	Error string `json:"error"`
}

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

type SearchOrchestratorConfig struct {
	Logger *zap.Logger
}

type SearchQuery struct {
	// Keyword is the search term
	Keyword string `json:"keyword"`
	// Category filters by torrent category
	Category string `json:"category,omitempty"`
	// FreeOnly filters to only show free torrents
	FreeOnly bool `json:"freeOnly,omitempty"`
	// Page is the page number (1-indexed)
	Page int `json:"page,omitempty"`
	// PageSize is the number of results per page
	PageSize int `json:"pageSize,omitempty"`
	// SortBy specifies the sort field
	SortBy string `json:"sortBy,omitempty"`
	// OrderDesc specifies descending order when true
	OrderDesc bool `json:"orderDesc,omitempty"`
}

type Session struct {
	SiteID     string
	Cookie     string
	APIKey     string
	SessionID  string // For Transmission
	ExpiresAt  time.Time
	LastUsed   time.Time
	LoginCount int
	// contains filtered or unexported fields
}

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

type Site interface {
	// ID returns the unique site identifier
	ID() string
	// Name returns the human-readable site name
	Name() string
	// Kind returns the site architecture type
	Kind() SiteKind
	// Login authenticates with the site
	Login(ctx context.Context, creds Credentials) error
	// Search searches for torrents
	Search(ctx context.Context, query SearchQuery) ([]TorrentItem, error)
	// GetUserInfo fetches the current user's information
	GetUserInfo(ctx context.Context) (UserInfo, error)
	// Download downloads a torrent file by ID
	Download(ctx context.Context, torrentID string) ([]byte, error)
	// Close releases any resources held by the site
	Close() error
}

type SiteAdapter struct {
	// OldSite is the old site implementation (if any)
	OldSite any
	// NewSite is the new v2 site implementation
	NewSite Site
	// UseNew indicates whether to use the new implementation
	UseNew bool
}

type SiteCategoryConfig struct {
	SiteID     string               `json:"siteId"`
	SiteName   string               `json:"siteName"`
	Categories []CategoryDefinition `json:"categories"`
}

type SiteConfig struct {
	// Type is the site type (nexusphp, unit3d, gazelle, mtorrent)
	Type string `json:"type"`
	// ID is the unique site identifier
	ID string `json:"id"`
	// Name is the human-readable site name
	Name string `json:"name"`
	// BaseURL is the site's base URL
	BaseURL string `json:"baseUrl"`
	// Options contains type-specific configuration
	Options json.RawMessage `json:"options"`
	// RateLimit is the requests per second limit (optional)
	RateLimit float64 `json:"rateLimit,omitempty"`
	// RateBurst is the maximum burst size (optional)
	RateBurst int `json:"rateBurst,omitempty"`
}

type SiteCredentials struct {
	Cookie string
	APIKey string
}

type SiteDefinition struct {
	// ID is the unique site identifier (e.g., "hdsky")
	ID string `json:"id"`
	// Name is the human-readable site name (e.g., "HDSky")
	Name string `json:"name"`
	// Aka contains alternative names for the site
	Aka []string `json:"aka,omitempty"`
	// Description is a brief description of the site
	Description string `json:"description,omitempty"`
	// Schema is the base schema type (e.g., "NexusPHP", "mTorrent")
	Schema string `json:"schema"`

	// URLs are the primary site URLs
	URLs []string `json:"urls"`
	// LegacyURLs are alternative/legacy URLs
	LegacyURLs []string `json:"legacyUrls,omitempty"`
	// FaviconURL is the site's favicon URL for caching
	FaviconURL string `json:"faviconUrl,omitempty"`

	// TimezoneOffset is the site's timezone (e.g., "+0800")
	TimezoneOffset string `json:"timezoneOffset,omitempty"`

	// UserInfo contains user info fetching configuration
	UserInfo *UserInfoConfig `json:"userInfo,omitempty"`

	// LevelRequirements defines user level requirements
	LevelRequirements []SiteLevelRequirement `json:"levelRequirements,omitempty"`

	// Selectors contains custom CSS selectors (merged with schema defaults)
	Selectors *SiteSelectors `json:"selectors,omitempty"`
}

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

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

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

type SiteHTTPClientConfig struct {
	Timeout           time.Duration
	MaxIdleConns      int
	IdleConnTimeout   time.Duration
	DisableKeepAlives bool
	UserAgent         string
	Logger            *zap.Logger
}

type SiteKind string

type SiteLevelProgressInfo struct {
	// CurrentLevel is the current level requirement
	CurrentLevel *SiteLevelRequirement `json:"currentLevel,omitempty"`
	// NextLevel is the next level requirement
	NextLevel *SiteLevelRequirement `json:"nextLevel,omitempty"`
	// UnmetRequirements contains what's still needed
	UnmetRequirements map[string]any `json:"unmetRequirements,omitempty"`
	// ProgressPercent is the overall progress percentage (0-100)
	ProgressPercent float64 `json:"progressPercent"`
}

type SiteLevelRequirement struct {
	// ID is the numeric level identifier
	ID int `json:"id"`
	// Name is the level name (e.g., "Power User")
	Name string `json:"name"`
	// NameAka contains alternative names for matching
	NameAka []string `json:"nameAka,omitempty"`
	// GroupType: "user", "vip", "manager"
	GroupType LevelGroupType `json:"groupType,omitempty"`

	// Requirements (all optional)
	// Interval is ISO 8601 duration (e.g., "P5W" for 5 weeks)
	Interval string `json:"interval,omitempty"`
	// Downloaded is size string (e.g., "200GB")
	Downloaded string `json:"downloaded,omitempty"`
	// Uploaded is size string
	Uploaded string `json:"uploaded,omitempty"`
	// Ratio is minimum ratio
	Ratio float64 `json:"ratio,omitempty"`
	// Bonus is minimum bonus points
	Bonus float64 `json:"bonus,omitempty"`

	// Extended requirements
	// SeedingBonus is seeding bonus points requirement
	SeedingBonus float64 `json:"seedingBonus,omitempty"`
	// Uploads is number of uploads requirement
	Uploads int `json:"uploads,omitempty"`
	// Seeding is number of seeding torrents requirement
	Seeding int `json:"seeding,omitempty"`
	// SeedingSize is total seeding size requirement
	SeedingSize string `json:"seedingSize,omitempty"`

	// Alternative contains OR-based alternative requirements
	Alternative []AlternativeRequirement `json:"alternative,omitempty"`

	// Privilege describes the privileges granted at this level
	Privilege string `json:"privilege,omitempty"`
}

type SiteMeta struct {
	// ID is the unique site identifier (e.g., "mteam", "hdsky")
	ID string
	// Name is the human-readable site name
	Name string
	// Kind is the site architecture type
	Kind SiteKind
	// DefaultBaseURL is the default base URL for the site
	DefaultBaseURL string
	// AuthMethod is the authentication method (cookie, api_key)
	AuthMethod string
	// RateLimit is the default rate limit (requests per second)
	RateLimit float64
	// RateBurst is the default rate burst
	RateBurst int
}

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

type SiteMigrationGuide struct {
	SiteType        string   `json:"siteType"`
	OldFormat       string   `json:"oldFormat"`
	NewFormat       string   `json:"newFormat"`
	Steps           []string `json:"steps"`
	Notes           []string `json:"notes,omitempty"`
	BreakingChanges []string `json:"breakingChanges,omitempty"`
}

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

type SiteName string

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

type SiteSelectors struct {
	// TableRows selects torrent rows in the search results
	TableRows string `json:"tableRows"`
	// Title selects the torrent title
	Title string `json:"title"`
	// TitleLink selects the link containing torrent ID
	TitleLink string `json:"titleLink"`
	// Size selects the torrent size
	Size string `json:"size"`
	// Seeders selects the seeder count
	Seeders string `json:"seeders"`
	// Leechers selects the leecher count
	Leechers string `json:"leechers"`
	// Snatched selects the snatch count
	Snatched string `json:"snatched"`
	// DiscountIcon selects the discount icon element
	DiscountIcon string `json:"discountIcon"`
	// DiscountEndTime selects the discount end time
	DiscountEndTime string `json:"discountEndTime"`
	// DownloadLink selects the download link
	DownloadLink string `json:"downloadLink"`
	// Category selects the category
	Category string `json:"category"`
	// UploadTime selects the upload time
	UploadTime string `json:"uploadTime"`
	// HRIcon selects the H&R icon
	HRIcon string `json:"hrIcon"`
	// Subtitle selects the subtitle in search results
	Subtitle string `json:"subtitle"`
	// UserInfo selectors for user page
	UserInfoUsername   string `json:"userInfoUsername"`
	UserInfoUploaded   string `json:"userInfoUploaded"`
	UserInfoDownloaded string `json:"userInfoDownloaded"`
	UserInfoRatio      string `json:"userInfoRatio"`
	UserInfoBonus      string `json:"userInfoBonus"`
	UserInfoRank       string `json:"userInfoRank"`
	// Detail page selectors
	// DetailDownloadLink selects the download link from details page
	DetailDownloadLink string `json:"detailDownloadLink"`
	// DetailSubtitle selects the subtitle from details page
	DetailSubtitle string `json:"detailSubtitle"`
}