registry

type AquaOverride struct {
	GOOS         string            `yaml:"goos"`
	GOARCH       string            `yaml:"goarch"`
	URL          string            `yaml:"url"`
	Asset        string            `yaml:"asset"`
	Format       string            `yaml:"format"`
	Files        []File            `yaml:"files"`
	Replacements map[string]string `yaml:"replacements"`
}

type AquaPackage struct {
	Type       string `yaml:"type"`
	RepoOwner  string `yaml:"repo_owner"`
	RepoName   string `yaml:"repo_name"`
	Name       string `yaml:"name"`  // Used by http and some go_install types.
	Path       string `yaml:"path"`  // Used by go_install types (Go module path).
	Asset      string `yaml:"asset"` // Used by github_release types.
	URL        string `yaml:"url"`   // Used by http types (complete URL).
	Format     string `yaml:"format"`
	BinaryName string `yaml:"binary_name"`
	// Files specifies which files to extract from archive with their destination names.
	Files []File `yaml:"files"`
	// Overrides provides platform-specific (goos/goarch) configuration overrides.
	Overrides []AquaOverride `yaml:"overrides"`
	// Replacements provides OS/Arch string mappings (e.g., amd64 -> x86_64).
	Replacements map[string]string `yaml:"replacements"`
	// Additional Aqua fields.
	Description       string            `yaml:"description"`
	SupportedEnvs     []string          `yaml:"supported_envs"`
	Checksum          ChecksumConfig    `yaml:"checksum"`
	VersionConstraint string            `yaml:"version_constraint"`
	VersionOverrides  []VersionOverride `yaml:"version_overrides"`
	VersionPrefix     string            `yaml:"version_prefix"` // GitHub tag prefix (e.g., "v", "kustomize/").
}

type AquaRegistryFile struct {
	Packages []AquaPackage `yaml:"packages"`
}

type ChecksumConfig struct {
	Type      string `yaml:"type"`
	URL       string `yaml:"url"`
	Algorithm string `yaml:"algorithm"`
}

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

type File struct {
	Name string `yaml:"name"`
	Src  string `yaml:"src"`
}

type ListConfig struct {
	Limit  int
	Offset int
	Sort   string // "name", "date", "popularity"
}

type ListOption func(*ListConfig)

type Override struct {
	GOOS         string            `yaml:"goos"`
	GOARCH       string            `yaml:"goarch"`
	Asset        string            `yaml:"asset"`
	Format       string            `yaml:"format"`
	Files        []File            `yaml:"files"`
	Replacements map[string]string `yaml:"replacements"`
}

type PrioritizedRegistry struct {
	Name     string
	Registry ToolRegistry
	Priority int
}

type RegistryMetadata struct {
	Name        string
	Type        string // "aqua", "atmos"
	Source      string // URL
	Priority    int
	ToolCount   int
	LastUpdated time.Time
}

type SearchConfig struct {
	Limit         int
	Offset        int
	InstalledOnly bool
	AvailableOnly bool
}

type SearchOption func(*SearchConfig)

type SearchTotalProvider interface {
	GetLastSearchTotal() int
}

type SupportedIf struct {
	GOOS   string `yaml:"goos"`
	GOARCH string `yaml:"goarch"`
}

type Tool struct {
	Name             string            `yaml:"name"`
	Registry         string            `yaml:"registry"`
	Version          string            `yaml:"version"`
	Type             string            `yaml:"type"`
	RepoOwner        string            `yaml:"repo_owner"`
	RepoName         string            `yaml:"repo_name"`
	Asset            string            `yaml:"asset"`
	URL              string            `yaml:"url"`
	Format           string            `yaml:"format"`
	Files            []File            `yaml:"files"`
	Overrides        []Override        `yaml:"overrides"`
	VersionOverrides []VersionOverride `yaml:"version_overrides"`
	SupportedIf      *SupportedIf      `yaml:"supported_if"`
	Replacements     map[string]string `yaml:"replacements"`
	BinaryName       string            `yaml:"binary_name"`
	VersionPrefix    string            `yaml:"version_prefix"` // GitHub tag prefix (e.g., "v", "kustomize/"). Defaults to "v".
	SourceURL        string            `yaml:"-"`              // URL where the registry file was found (not serialized).
	SupportedEnvs    []string          `yaml:"supported_envs"` // Supported platforms (e.g., "darwin", "linux", "windows", "darwin/amd64").
}

type ToolRegistry interface {
	// GetTool fetches tool metadata from the registry.
	GetTool(owner, repo string) (*Tool, error)

	// GetToolWithVersion fetches tool metadata and resolves version-specific overrides.
	GetToolWithVersion(owner, repo, version string) (*Tool, error)

	// GetLatestVersion fetches the latest non-prerelease version for a tool.
	GetLatestVersion(owner, repo string) (string, error)

	// LoadLocalConfig is deprecated and will be removed. Returns nil for compatibility.
	LoadLocalConfig(configPath string) error

	// Search searches for tools matching the query string.
	// The query is matched against tool owner, repo, aliases, and description.
	// Results are sorted by relevance score.
	Search(ctx context.Context, query string, opts ...SearchOption) ([]*Tool, error)

	// ListAll returns all tools available in the registry.
	// Results can be paginated and sorted using options.
	ListAll(ctx context.Context, opts ...ListOption) ([]*Tool, error)

	// GetMetadata returns metadata about the registry itself.
	GetMetadata(ctx context.Context) (*RegistryMetadata, error)
}

type ToolRegistryFile struct {
	Tools []Tool `yaml:"tools"`
}

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

type VersionOverride struct {
	VersionConstraint   string            `yaml:"version_constraint"`
	Asset               string            `yaml:"asset"`
	Format              string            `yaml:"format"`
	Rosetta2            bool              `yaml:"rosetta2"`
	WindowsArmEmulation bool              `yaml:"windows_arm_emulation"`
	SupportedEnvs       []string          `yaml:"supported_envs"`
	Checksum            ChecksumConfig    `yaml:"checksum"`
	Files               []File            `yaml:"files"`
	Replacements        map[string]string `yaml:"replacements"`
}