fetchers

type FetchOptions struct {
	// LastHash is the previous hash to check for changes
	// If current hash matches, fetch can be skipped
	LastHash string

	// Extensions filters files by extension (e.g., []string{".yaml", ".yml"})
	Extensions []string

	// MaxFileSize limits individual file size (0 = no limit)
	MaxFileSize int64

	// MaxTotalSize limits total download size (0 = no limit)
	MaxTotalSize int64
}

type FetchResult struct {
	// Files contains the fetched files (path -> content)
	Files map[string][]byte

	// Hash is a unique identifier for this version (commit hash, ETag, etc.)
	Hash string

	// FetchedAt is when the fetch completed
	FetchedAt time.Time

	// TotalFiles is the number of files found
	TotalFiles int

	// TotalSize is the total size of all files in bytes
	TotalSize int64
}

type Fetcher interface {
	// Fetch downloads files from the source
	Fetch(ctx context.Context, opts FetchOptions) (*FetchResult, error)

	// CheckForUpdates returns the current hash without downloading
	// Returns nil if unable to determine (fetch required)
	CheckForUpdates(ctx context.Context, lastHash string) (string, bool, error)

	// Close releases any resources
	Close() error
}

type FileReader interface {
	// ReadFile reads a single file by path
	ReadFile(ctx context.Context, path string) (io.ReadCloser, error)

	// ListFiles returns all file paths matching the criteria
	ListFiles(ctx context.Context, extensions []string) ([]string, error)
}

type GitConfig struct {
	URL        string
	Branch     string
	Path       string // Subdirectory to fetch from
	AuthType   string // none, token, ssh
	Token      string
	SSHKey     []byte
	SSHKeyPass string
}

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

type HTTPConfig struct {
	URL      string
	AuthType string            // none, bearer, basic, api_key
	Token    string            // Bearer token or API key
	Username string            // For basic auth
	Password string            // For basic auth
	Headers  map[string]string // Additional headers
	Timeout  time.Duration
}

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

type S3Config struct {
	Bucket     string
	Region     string
	Prefix     string // Object prefix (folder path)
	Endpoint   string // Custom endpoint for S3-compatible services
	AuthType   string // keys, sts_role
	AccessKey  string
	SecretKey  string
	RoleARN    string
	ExternalID string
}

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