oci

type APIError struct {
	Status     string
	StatusCode int
	Code       APIErrorCode
	Message    string
	Detail     string
}

type APIErrorCode string

type Annotations map[string]string

type Blob interface {
	io.Reader
	io.Closer
	// Digest returns the blob's digest so far.
	// Valid once the entire blob has been read.
	// It is the caller's responsibility to ensure the entire blob has been read.
	Digest() string
	Info() BlobInfo
}

type BlobInfo struct {
	// ContentType is the blob's content type.
	ContentType string
	// ContentLength is the size of the blob as reported by the server, if
	// reported at all. SHOULD be reported by all servers.
	ContentLength int64
	// Digest is the digest of the blob as reported by the server, if reported at
	// all. SHOULD be reported by all servers. If it is reported MUST match the
	// blob's actual digest.
	Digest string
}

type Client struct {
	Client   httputil.Requester
	AuthFunc func(*http.Request) error
}

type GetAnnotationsOptions struct {
	Manifests    []ImageManifest
	Digest       string
	Architecture string
	OS           string
	Variant      string
}

type GetTagsOptions struct {
	// Last is the name of the last tag of the previous page. Used for pagination.
	Last string
	// Count is the number of tags to return.
	// The server might not respect the choice.
	Count int
	// AllPages determines if the pagination is automatically handled to return
	// all available tags.
	AllPages bool
}

type ImageIndex struct {
	// ContentType is the MIME type as returned by the server providing the
	// index.
	ContentType string
	// SchemaVersion specifies the image manifest schema version.
	SchemaVersion int
	// MediaType is the MIME type of the image index.
	MediaType string
	// Manifests contains the manifests provided by the index. Note that these may
	// or may not hold the same information as if each manifest was retrieved
	// individually.
	Manifests []ImageManifest
	// Digest is the digest of the index, including the "sha256:" prefix.
	Digest string
	// Annotations contains user-defined labels of the index.
	Annotations Annotations
}

type ImageManifest struct {
	// ContentType is the MIME type as returned by the server providing the
	// manifest.
	ContentType string
	// SchemaVersion specifies the image manifest schema version.
	SchemaVersion int
	// MediaType is the MIME type of the image manifest.
	MediaType string
	// Platform optionally holds details about the platform the image supports.
	Platform *Platform
	// Digest is the digest of the index, including the "sha256:" prefix.
	Digest string
	// Annotations contains user-defined labels of the manifest.
	Annotations Annotations
}

type Platform struct {
	// OS is the operating system supported by the manifest.
	OS string
	// Architecture is the architecture supported by the manifest.
	Architecture string
	// Variant is the architecture variant supported by the manifest.
	// Typically a value such as "v8" for ARM images.
	Variant string
}

type Reference struct {
	// Domain is the hostname of the registry.
	Domain string
	// Path is the namespace / project path of the reference.
	Path string

	// HasTag is true if the reference includes a tag.
	HasTag bool
	// Tag holds the tag specified in the reference.
	Tag string

	// HasDigest is true if the reference includes a digest.
	HasDigest bool
	// Digest holds the digest specified in the reference.
	Digest string
}