const LatestVersion = "latest"

var (
	// ErrNotFound indicates that the requested module was not found.
	ErrNotFound = errors.New("not found")

	// ErrInvalidPath indicates that the requested module path is invalid.
	ErrInvalidPath = errors.New("invalid path")

	// ErrInvalidVersion indicates that the requested version is invalid.
	ErrInvalidVersion = errors.New("invalid version")

	// ErrBadModule indicates a problem with a module.
	ErrBadModule = errors.New("bad module")

	// ErrTooLarge indicates that the requested module is too large to fetch.
	ErrTooLarge = errors.New("too large")
)

type Module struct {
	ModulePath    string
	RawModulePath string
	SeriesPath    string
	Version       string
	RawVersion    string
	Reference     string
	CommitTime    time.Time
	LatestVersion string
	Versions      []string
	Deprecated    string
	Updated       time.Time // TODO: remove this
	ZipSize       int64
}

type Source interface {
	Module(modulePath, version string) (*Module, error)
	Files(module *Module) (fs.FS, error)
}

type SourceList []Source