intel

type FeedRequest struct {
	Since     time.Duration
	Ecosystem string
	Limit     int
	CacheDir  string
	CacheTTL  time.Duration
	Timeout   time.Duration
}

type FeedResponse struct {
	Entries     []source.PackageEntry
	WindowStats source.WindowStats
	Total       int
	FromCache   bool
}

type Provider interface {
	Name() string

	GetVuln(ctx context.Context, id string) (*malindex.Vulnerability, error)
	Query(ctx context.Context, q malindex.QueryRequest) (*malindex.QueryResponse, error)
	QueryBatch(ctx context.Context, queries []malindex.QueryRequest) (*malindex.BatchQueryResponse, error)

	Feed(ctx context.Context, req FeedRequest) (*FeedResponse, error)
	Search(ctx context.Context, req SearchRequest) (*SearchResponse, error)
	LoadMaliciousIndex(ctx context.Context, onProgress malindex.IndexLoadProgress, onStatus malindex.IndexLoadStatus) (*malindex.MaliciousIndex, error)

	VulnPageURL(id string) string

	StartBackgroundSync(ctx context.Context)
	// WaitBackgroundSync blocks until any in-flight background refresh finishes
	// so it persists before the process exits. Bounded by the network timeout.
	WaitBackgroundSync()
	SyncStatus() sync.Status
}

type SearchRequest struct {
	Query      string
	Ecosystem  string
	Limit      int
	OnProgress malindex.IndexLoadProgress
	OnStatus   malindex.IndexLoadStatus
}

type SearchResponse struct {
	Entries []source.PackageEntry
	Total   int
}