release

type Bundle struct {
	Package   string
	Version   Version
	Notes     string
	Metadata  map[string]string
	CreatedAt time.Time `firestore:",serverTimestamp"`
}

type IOProgress interface {
	Progress(progress, total int64, units string)
}

type IsDiscard interface {
	IsDiscard() bool
}

type Manager interface {
	// Create creates or updates a package.
	Create(context.Context, Package) error

	// UpdatePackageMetadata merges the given metadata keys into an existing
	// package's manifest without touching other fields (Notes, Latest).
	UpdatePackageMetadata(ctx context.Context, pkg string, metadata map[string]string) error

	// DeletePackage deletes a package but package bundles are not deleted.
	// Note that this does not prevent the next call to Upload to fail.
	// In order to delete all traces of a package, all bundles must be deleted
	// first via Delete.
	DeletePackage(context.Context, string) error

	// Get fetches a Package manifest.
	GetPackage(context.Context, string) (Package, error)

	// ListPackages lists all packages.
	ListPackages(context.Context, map[string]string) (iterator.Iterator[Package], error)

	// Upload uploads a package bundle and reports progress via ProgressReader.
	// It updates the Latest field of the Package.
	// If package has not been created via Create then it creates a new one.
	Upload(context.Context, Bundle, ProgressReader) error

	// Get downloads a Package bundle by package name and version and reports
	// progress via ProgressWriter.
	Get(context.Context, string, Version, ProgressWriter) (Bundle, error)

	// Delete deletes a package bundle by package name and version.
	Delete(context.Context, string, Version) error

	// List lists all bundles of a package.
	List(context.Context, string, map[string]string) (iterator.Iterator[Bundle], error)
}

type Package struct {
	Name      string
	Latest    Version
	Notes     string
	Metadata  map[string]string
	CreatedAt time.Time `firestore:",serverTimestamp"`
}

type ProgressReader interface {
	io.Reader
	Progress(progress, total int64, units string)
}

type ProgressWriter interface {
	io.Writer
	Progress(progress, total int64, units string)
}

type Version string