datasource

type CollectSource interface {
	// GetDataSources returns a data source containing targets for the
	// collector to collect
	GetDataSources(ctx context.Context) (*DataSources, error)

	// DataSourcesUpdate will return a channel which will get an element
	// if the CollectSource has new data. This is heuristical and the
	// channel may get an element even if there is no new data.
	DataSourcesUpdate(ctx context.Context) (<-chan error, error)
}

type DataSources struct {
	OciDataSources         []Source
	OciRegistryDataSources []Source
	// NOTE: Git data sources should follow the URI scheme as defined in:
	// https://spdx.github.io/spdx-spec/v2.3/package-information/#771-description
	// <vcs_tool>+<transport>://<host_name>[/<path_to_repository>][@<revision_tag_or_branch>][#<sub_path>]
	// e.g. git+https://github.com/guacsec/guac@v1
	GitDataSources []Source
	// NOTE: It is expected that a GithubReleaseDataSource is of the form:
	// https://github.com/<org>/<repo>/releases/<tag> or
	// https://github.com/<org>/<repo>/releases/tag/<tag> or
	// https://github.com/<org>/<repo>/releases
	// Tag is optional and left off will assume latest.
	GithubReleaseDataSources []Source
	// PurlDataSources encodes the list of PURLs
	PurlDataSources []Source
}

type Source struct {
	Value string
}