jackett

type ActivityStatus struct {
	Scheduler        *SchedulerStatus        `json:"scheduler,omitempty"`
	CooldownIndexers []IndexerCooldownStatus `json:"cooldownIndexers"`
}

type CategoryInfo struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
}

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

type DiscoveryResult struct {
	Indexers []JackettIndexer `json:"indexers"`
	Warnings []string         `json:"warnings,omitempty"`
}

type DownloadError struct {
	StatusCode int
	URL        string
}

type DownloadRateLimitError struct {
	IndexerID   int
	IndexerName string
	ResumeAt    time.Time
	// Queued indicates whether the request was queued for automatic retry.
	// TODO: Set to true when download retry queue is implemented.
	Queued bool
}

type EnabledIndexerInfo struct {
	ID     int
	Name   string
	Domain string
}

type HistoryRecorder interface {
	Record(entry SearchHistoryEntry)
}

type IndexerCooldownStatus struct {
	IndexerID   int       `json:"indexerId"`
	IndexerName string    `json:"indexerName"`
	CooldownEnd time.Time `json:"cooldownEnd"`
	Reason      string    `json:"reason,omitempty"`
}

type IndexerInfo struct {
	// ID of the indexer
	ID string `json:"id"`
	// Name of the indexer
	Name string `json:"name"`
	// Description
	Description string `json:"description,omitempty"`
	// Type (public, semi-private, private)
	Type string `json:"type"`
	// Configured (whether the indexer is configured)
	Configured bool `json:"configured"`
	// Supported categories
	Categories []CategoryInfo `json:"categories,omitempty"`
}

type IndexerOutcome struct {
	Outcome    string    `json:"outcome"`              // "added", "failed", "no_match", ""
	AddedCount int       `json:"addedCount,omitempty"` // Number of torrents added from this indexer
	Message    string    `json:"message,omitempty"`
	RecordedAt time.Time `json:"recordedAt"`
}

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

type IndexerStore interface {
	Get(ctx context.Context, id int) (*models.TorznabIndexer, error)
	List(ctx context.Context) ([]*models.TorznabIndexer, error)
	ListEnabled(ctx context.Context) ([]*models.TorznabIndexer, error)
	GetDecryptedAPIKey(indexer *models.TorznabIndexer) (string, error)
	GetDecryptedBasicPassword(indexer *models.TorznabIndexer) (string, error)
	GetCapabilities(ctx context.Context, indexerID int) ([]string, error)
	SetCapabilities(ctx context.Context, indexerID int, capabilities []string) error
	SetCategories(ctx context.Context, indexerID int, categories []models.TorznabIndexerCategory) error
	SetLimits(ctx context.Context, indexerID, limitDefault, limitMax int) error
	RecordLatency(ctx context.Context, indexerID int, operationType string, latencyMs int, success bool) error
	RecordError(ctx context.Context, indexerID int, errorMessage, errorCode string) error
	ListRateLimitCooldowns(ctx context.Context) ([]models.TorznabIndexerCooldown, error)
	UpsertRateLimitCooldown(ctx context.Context, indexerID int, resumeAt time.Time, cooldown time.Duration, reason string) error
	DeleteRateLimitCooldown(ctx context.Context, indexerID int) error
}

type IndexersResponse struct {
	Indexers []IndexerInfo `json:"indexers"`
}

type JackettIndexer struct {
	ID          string                          `json:"id"`
	Name        string                          `json:"name"`
	Description string                          `json:"description"`
	Type        string                          `json:"type"`
	Configured  bool                            `json:"configured"`
	Backend     models.TorznabBackend           `json:"backend"`
	Caps        []string                        `json:"caps,omitempty"`
	Categories  []models.TorznabIndexerCategory `json:"categories,omitempty"`
}

type JobCallbacks struct {
	// OnComplete fires for each indexer when it finishes (success or error).
	// Called in a goroutine - safe to do blocking work.
	OnComplete func(jobID uint64, indexer *models.TorznabIndexer, results []Result, coverage []int, err error)
	// OnJobDone fires once after ALL indexers complete (optional, can be nil).
	// Called in a goroutine - safe to do blocking work.
	OnJobDone func(jobID uint64)
}

type MagnetDownloadError struct {
	MagnetURL string
}

type RateLimitOptions struct {
	Priority    RateLimitPriority
	MinInterval time.Duration
	MaxWait     time.Duration
}

type RateLimitPriority string

type RateLimitWaitError struct {
	IndexerID   int
	IndexerName string
	Wait        time.Duration
	MaxWait     time.Duration
	Priority    RateLimitPriority
}

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

type Result struct {
	Tracker              string
	IndexerID            int
	Title                string
	Link                 string
	Details              string
	GUID                 string
	PublishDate          time.Time
	Category             string
	Size                 int64
	Seeders              int
	Peers                int
	DownloadVolumeFactor float64
	UploadVolumeFactor   float64
	Imdb                 string
	// Attributes stores every Torznab attribute with lowercase keys from RSS item attr entries (see convertRssToResults normalization).
	Attributes map[string]string
}

type SchedulerJobStatus struct {
	JobID          uint64 `json:"jobId"`
	TotalTasks     int    `json:"totalTasks"`
	CompletedTasks int    `json:"completedTasks"`
}

type SchedulerStatus struct {
	QueuedTasks   []SchedulerTaskStatus `json:"queuedTasks"`
	InFlightTasks []SchedulerTaskStatus `json:"inFlightTasks"`
	ActiveJobs    []SchedulerJobStatus  `json:"activeJobs"`
	QueueLength   int                   `json:"queueLength"`
	WorkerCount   int                   `json:"workerCount"`
	WorkersInUse  int                   `json:"workersInUse"`
}

type SchedulerTaskStatus struct {
	JobID       uint64    `json:"jobId"`
	TaskID      uint64    `json:"taskId"`
	IndexerID   int       `json:"indexerId"`
	IndexerName string    `json:"indexerName"`
	Priority    string    `json:"priority"`
	CreatedAt   time.Time `json:"createdAt"`
	IsRSS       bool      `json:"isRss"`
}

type SearchCacheConfig struct {
	TTL time.Duration
}

type SearchCacheMetadata struct {
	Hit       bool       `json:"hit"`
	Scope     string     `json:"scope"`
	Source    string     `json:"source"`
	CachedAt  time.Time  `json:"cachedAt"`
	ExpiresAt time.Time  `json:"expiresAt"`
	LastUsed  *time.Time `json:"lastUsed,omitempty"`
}

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

type SearchHistoryEntry struct {
	ID     uint64 `json:"id"`
	JobID  uint64 `json:"jobId"`
	TaskID uint64 `json:"taskId"`

	// Indexer details
	IndexerID   int    `json:"indexerId"`
	IndexerName string `json:"indexerName"`

	// Search parameters
	Query       string            `json:"query,omitempty"`
	ReleaseName string            `json:"releaseName,omitempty"` // Original full release name
	Params      map[string]string `json:"params,omitempty"`      // Raw params sent to indexer
	Categories  []int             `json:"categories,omitempty"`
	ContentType string            `json:"contentType,omitempty"`
	Priority    string            `json:"priority"`
	SearchMode  string            `json:"searchMode,omitempty"`

	// Results
	Status      string `json:"status"` // success, error, skipped, rate_limited
	ResultCount int    `json:"resultCount"`

	// Timing
	StartedAt   time.Time `json:"startedAt"`
	CompletedAt time.Time `json:"completedAt"`
	DurationMs  int       `json:"durationMs"`

	// Error details (if applicable)
	ErrorMessage string `json:"errorMessage,omitempty"`
}

type SearchHistoryEntryWithOutcome struct {
	SearchHistoryEntry
	Outcome    string `json:"outcome,omitempty"`    // "added", "failed", "no_match", ""
	AddedCount int    `json:"addedCount,omitempty"` // Torrents added from this indexer
}

type SearchHistoryResponse struct {
	Entries []SearchHistoryEntry `json:"entries"`
	Total   int                  `json:"total"`
	Source  string               `json:"source"` // "memory" or "database"
}

type SearchHistoryResponseWithOutcome struct {
	Entries []SearchHistoryEntryWithOutcome `json:"entries"`
	Total   int                             `json:"total"`
	Source  string                          `json:"source"` // "memory" or "database"
}

type SearchHistoryStats struct {
	Count       int            `json:"count"`
	Capacity    int            `json:"capacity"`
	ByStatus    map[string]int `json:"byStatus"`
	ByPriority  map[string]int `json:"byPriority"`
	AvgDuration float64        `json:"avgDurationMs"`
}

type SearchResponse struct {
	Results []SearchResult       `json:"results"`
	Total   int                  `json:"total"`
	Cache   *SearchCacheMetadata `json:"cache,omitempty"`
	Partial bool                 `json:"partial,omitempty"`
	// JobID identifies this search for outcome tracking (cross-seed)
	JobID uint64 `json:"jobId,omitempty"`
}

type SearchResult struct {
	// Indexer name
	Indexer string `json:"indexer"`
	// Indexer identifier
	IndexerID int `json:"indexer_id"`
	// Title of the release
	Title string `json:"title"`
	// Download URL for the torrent
	DownloadURL string `json:"download_url"`
	// Info URL (details page)
	InfoURL string `json:"info_url,omitempty"`
	// Size in bytes
	Size int64 `json:"size"`
	// Seeders count
	Seeders int `json:"seeders"`
	// Leechers count
	Leechers int `json:"leechers"`
	// Category ID
	CategoryID int `json:"category_id"`
	// Category name
	CategoryName string `json:"category_name"`
	// Published date
	PublishDate time.Time `json:"publish_date"`
	// Download volume factor (0.0 = free, 1.0 = normal)
	DownloadVolumeFactor float64 `json:"download_volume_factor"`
	// Upload volume factor
	UploadVolumeFactor float64 `json:"upload_volume_factor"`
	// GUID (unique identifier)
	GUID string `json:"guid"`
	// InfoHashV1 if available
	InfoHashV1 string `json:"infohash_v1,omitempty"`
	// InfoHashV2 if available
	InfoHashV2 string `json:"infohash_v2,omitempty"`
	// IMDb ID if available
	IMDbID string `json:"imdb_id,omitempty"`
	// TVDb ID if available
	TVDbID string `json:"tvdb_id,omitempty"`
	// Source parsed from release name (e.g., "WEB-DL", "BluRay", "HDTV")
	Source string `json:"source,omitempty"`
	// Collection/streaming service parsed from release name (e.g., "AMZN", "NF", "HULU", "MAX")
	Collection string `json:"collection,omitempty"`
	// Release group parsed from release name
	Group string `json:"group,omitempty"`
}

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

type ServiceOption func(*Service)

type SubmitRequest struct {
	Indexers  []*models.TorznabIndexer
	Params    url.Values
	Meta      *searchContext
	Callbacks JobCallbacks
	ExecFn    func(context.Context, []*models.TorznabIndexer, url.Values, *searchContext) ([]Result, []int, error)
}

type TorrentDownloadRequest struct {
	IndexerID   int
	DownloadURL string
	GUID        string
	Title       string
	Size        int64
	// Pace applies per-indexer min-interval pacing before contacting the backend.
	// This is useful for background/automated workflows (e.g. dirscan) to avoid bursts of .torrent downloads.
	Pace bool
}

type TorznabSearchRequest struct {
	// Query is the search term
	Query string `json:"query"`
	// ReleaseName is the original full release name (for debugging/logging)
	ReleaseName string `json:"release_name,omitempty"`
	// Categories to search
	Categories []int `json:"categories,omitempty"`
	// IMDbID for movies/shows (optional)
	IMDbID string `json:"imdb_id,omitempty"`
	// TVDbID for TV shows (optional)
	TVDbID string `json:"tvdb_id,omitempty"`
	// TMDbID for movies (optional, from ARR lookup)
	TMDbID int `json:"tmdb_id,omitempty"`
	// TVMazeID for TV shows (optional, from ARR lookup)
	TVMazeID int `json:"tvmaze_id,omitempty"`
	// Year for movies/shows/music (optional)
	Year int `json:"year,omitempty"`
	// Season for TV shows (optional)
	Season *int `json:"season,omitempty"`
	// Episode for TV shows (optional)
	Episode *int `json:"episode,omitempty"`
	// Artist for music searches (optional)
	Artist string `json:"artist,omitempty"`
	// Album for music searches (optional)
	Album string `json:"album,omitempty"`
	// Limit the number of results
	Limit int `json:"limit,omitempty"`
	// Offset for pagination
	Offset int `json:"offset,omitempty"`
	// IndexerIDs to search (empty = all enabled indexers)
	IndexerIDs []int `json:"indexer_ids,omitempty"`
	// CacheMode controls cache behaviour (""=default, "bypass" = skip cache)
	CacheMode string `json:"cache_mode,omitempty"`
	// OmitQueryForIDs when true, omits the q parameter if IDs are present (for cross-seed ID-driven searches)
	OmitQueryForIDs bool `json:"-"`
	// SkipHistory prevents recording this search in the history buffer
	SkipHistory bool `json:"-"`
	// OnComplete is called when a search job for an indexer completes
	OnComplete func(jobID uint64, indexerID int, err error) `json:"-"`
	// OnAllComplete is called when all search jobs complete with the final results
	OnAllComplete func(*SearchResponse, error) `json:"-"`
}

type TrackerDomainInfo struct {
	Domain    string `json:"domain"`
	IndexerID int    `json:"indexer_id"`
	Name      string `json:"name"`
	BaseURL   string `json:"base_url"`
	JackettID string `json:"jackett_id,omitempty"`
	Backend   string `json:"backend"`
	Enabled   bool   `json:"enabled"`
}