storage.go RawHistoryFolder

1package out
2
3import (
4	"io"
5)
6
7// BlobStorage defines the contract for blob storage operations.
8type BlobStorage interface {
9	// GetBlob retrieves a blob by digest.
10	GetBlob(digest string) (io.ReadCloser, error)
11
12	// GetBlobPath returns the filesystem path to a blob.
13	GetBlobPath(digest string) (string, error)
14
15	// PutBlob stores a blob with the given digest.
16	PutBlob(digest string, data io.Reader, size int64) error
17
18	// DeleteBlob removes a blob by digest.
19	DeleteBlob(digest string) error
20
21	// BlobExists checks if a blob exists.
22	BlobExists(digest string) bool
23
24	// StartBlobUpload starts a new blob upload and returns the upload UUID.
25	StartBlobUpload(name string) (string, error)
26
27	// AppendBlobChunk appends data to an in-progress upload.
28	AppendBlobChunk(name, uuid string, data io.Reader) (int64, error)
29
30	// GetBlobUpload returns a writer for the upload.
31	GetBlobUpload(uuid string) (io.WriteCloser, error)
32
33	// FinishBlobUpload completes an upload and moves it to blob storage.
34	FinishBlobUpload(uuid, digest string) error
35
36	// CancelBlobUpload cancels an in-progress upload.
37	CancelBlobUpload(uuid string) error
38}
39
40// ManifestStorage defines the contract for manifest storage operations.
41type ManifestStorage interface {
42	// GetManifest retrieves a manifest by name and reference.
43	// Returns the manifest data and content type.
44	GetManifest(name, reference string) ([]byte, string, error)
45
46	// PutManifest stores a manifest.
47	PutManifest(name, reference, contentType string, data []byte) error
48
49	// DeleteManifest removes a manifest.
50	DeleteManifest(name, reference string) error
51
52	// ListTags returns all tags for a repository.
53	ListTags(name string) ([]string, error)
54
55	// ListRepositories returns all repository names.
56	ListRepositories() ([]string, error)
57}