filedownloader

type Downloader interface {
	// Download fetches a remote file and writes it to the specified destination path.
	Download(ctx context.Context, destination, source string) error

	// DownloadWithFallback tries to download from the primary source first,
	// then falls back to alternative sources in order if the primary fails.
	DownloadWithFallback(ctx context.Context, destination, source string, fallbackSources ...string) error

	// Get returns a streaming reader for the remote content without buffering the entire response in memory.
	// Caller is responsible for closing the returned io.ReadCloser.
	Get(ctx context.Context, source string) (io.ReadCloser, error)
}