storage_base

type Storage interface {
	BeginBlobUpload(blobID []byte) StorageUpload
	BeginDatabaseUpload(filename string) StorageUpload
	DownloadSection(path string, offset int64, length int64) io.ReadCloser

	// it is like always faster to get a large list of path, checksum, size than to do it one file at a time
	ListBlobs() []UploadedBlob

	Metadata(path string) (string, int64) // checksum (can be empty) and size

	GetID() []byte

	String() string
}

type StorageUpload interface {
	// simply calling BeginBlobUpload has already created the writer, this simply retrieves it
	Writer() io.Writer

	// flush and close the upload, **verify integrity by comparing the checksum**, then return the data
	End() UploadedBlob
}

type UploadedBlob struct {
	StorageID []byte
	BlobID    []byte // nil if fetched from a list operation, has data if fetched from database
	Path      string
	Checksum  string
	Size      int64
}