io

type Attributes struct {
	// ContentEncoding specifies the encoding used for the blob's content, if any.
	// https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Encoding
	ContentEncoding string
	// Size is the size of the blob's content in bytes.
	Size int64
	// Metadata includes user-metadata associated with the file
	Metadata map[string]string
}

type ObjectAttributes struct {
	// Name is the full path of the object or directory
	Name string
	// ObjName is the last segment of the name in case of an object
	ObjName string
	// IsDir is true if the object is a directory
	IsDir bool
}

type ObjectAttrsToUpdate struct {
	ContentEncoding *string
	Metadata        map[string]string
}

type ObjectIterator interface {
	Next(ctx context.Context) (attr ObjectAttributes, err error)
}

type Opener interface {
	Reader(ctx context.Context, path string) (ReadCloser, error)
	RangeReader(ctx context.Context, path string, offset, length int64) (io.ReadCloser, error)
	Writer(ctx context.Context, path string, opts ...WriterOptions) (WriteCloser, error)
	Attributes(ctx context.Context, path string) (Attributes, error)
	SignedURL(ctx context.Context, path string, opts SignedURLOptions) (string, error)
	Iterator(ctx context.Context, prefix, delimiter string) (ObjectIterator, error)
	UpdateAtributes(context.Context, string, ObjectAttrsToUpdate) (*Attributes, error)
}

type ReadCloser = io.ReadCloser

type SignedURLOptions struct {
	// UseGSCookieAuth defines if we should use cookie auth for GCS, see:
	// https://cloud.google.com/storage/docs/access-control/cookie-based-authentication
	UseGSCookieAuth bool
}

type WriteCloser = io.WriteCloser

type WriterOptions struct {
	BufferSize               *int64
	ContentEncoding          *string
	ContentType              *string
	Metadata                 map[string]string
	PreconditionDoesNotExist *bool
	CacheControl             *string
}