provider

type CacheEntry struct {
	Versions  []string  `json:"versions"`
	Timestamp time.Time `json:"timestamp"`
}

type ContentEntry struct {
	Name        string `json:"name"`
	Path        string `json:"path"`
	Type        string `json:"type"` // "file" or "dir"
	DownloadURL string `json:"download_url,omitempty"`
}

type GitCloneProvider struct {
	RepoURL   string
	LocalPath string
	Branch    string
	RepoName  string

	// UpdateInterval is how often to pull updates (default: 24h)
	UpdateInterval time.Duration
	// contains filtered or unexported fields
}

type GitHubProvider struct {
	BaseURL    string
	Repository string // e.g., "gentoo/gentoo"
	UserAgent  string
	Token      string
	HTTPClient *http.Client
	CacheDir   string
	CacheTTL   time.Duration
}

type GitLabProvider struct {
	BaseURL    string // e.g., "https://gitlab.com" or "https://gitlab.gentoo.org"
	ProjectID  string // URL-encoded project path or numeric ID
	Token      string
	UserAgent  string
	HTTPClient *http.Client
	CacheDir   string
	CacheTTL   time.Duration
}

type GitLabTreeEntry struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Type string `json:"type"` // "blob" or "tree"
	Path string `json:"path"`
	Mode string `json:"mode"`
}

type PackageDirProvider interface {
	LocalPackagePath(category, pkg string) (string, error)
}

type Provider interface {
	// GetPackageVersions returns all ebuild versions for a package. ctx ends
	// the lookup: an HTTP implementation sends its request with it.
	GetPackageVersions(ctx context.Context, category, pkg string) ([]string, error)

	// GetName returns a human-readable name for this provider
	GetName() string

	// SupportsAPI returns true if this provider uses an API (vs git clone)
	SupportsAPI() bool

	// Close cleans up any resources (e.g., temporary directories)
	Close() error
}

type RepositoryInfo struct {
	Name     string // e.g., "gentoo", "guru", "my-overlay"
	Provider string // "github", "gitlab", "git", "local"
	URL      string // Full URL or org/repo for GitHub/GitLab/git (remote)
	Path     string // On-disk tree for provider "local" (read in place, no clone)
	Token    string // Optional auth token
	Branch   string // Branch to use (default: master/main)
}

type RepositoryRegistry struct {
	CacheDir string
	CacheTTL time.Duration
	XMLPath  string
	// contains filtered or unexported fields
}