gcs

type API interface {
	// Write stores data as a new object, checked against crc on the server.
	// It returns ErrPrecondition when the name already exists.
	Write(ctx context.Context, name string, data []byte, crc uint32) (Attrs, error)
	// Attrs returns an object's attributes, or blob.ErrNotFound.
	Attrs(ctx context.Context, name string) (Attrs, error)
	// Read opens the object from offset to the end, or blob.ErrNotFound.
	Read(ctx context.Context, name string, offset int64) (io.ReadCloser, error)
	// Compose concatenates srcs into a new object dst, optionally deleting
	// the sources. It returns ErrPrecondition when dst already exists.
	Compose(ctx context.Context, dst string, srcs []Source, deleteSources bool) (Attrs, error)
	// Delete removes an object, only at generation when it is non-zero. It
	// returns blob.ErrNotFound when the object is missing.
	Delete(ctx context.Context, name string, generation int64) error
	// List calls fn for every object whose name starts with prefix.
	List(ctx context.Context, prefix string, fn func(Attrs) error) error
	// SignedURL returns a V4 signed GET URL for name.
	SignedURL(name string, o SignedURLOptions) (string, error)
}

type Attrs struct {
	Name       string
	Size       int64
	CRC32C     uint32
	Generation int64
}

type ClientConfig struct {
	// Endpoint overrides the Cloud Storage JSON API endpoint, for emulators,
	// e.g. "http://localhost:4443". "/storage/v1/" is appended when missing.
	Endpoint string
	// CredentialsFile is a service-account JSON key. Empty means Application
	// Default Credentials, which covers GKE Workload Identity.
	CredentialsFile string
	// GoogleAccessID and PrivateKey (PEM) sign URLs locally. Without them
	// signing finds the service account from the credentials and calls IAM
	// signBlob, which needs iam.serviceAccounts.signBlob.
	GoogleAccessID string
	PrivateKey     []byte
	// WithoutAuthentication sends no credentials, for emulators.
	WithoutAuthentication bool
}

type Options struct {
	// Prefix is prepended to every object name; a trailing slash is added
	// if missing.
	Prefix string
	// PartSize is the part size; zero means DefaultPartSize. It must be a
	// multiple of 256 KiB and at least 1 MiB.
	PartSize int64
	// Sessions holds upload sessions between requests; session.InUploads
	// with a backend name such as "gcs:<store name>" keeps them durable.
	Sessions session.Store
	// Presign makes the store sign storage URLs (blob.Signer). Set it from
	// ClientConfig.CanSign: signing needs a key, or credentials that name a
	// service account and may call IAM signBlob.
	Presign bool
	// SignsOverNetwork marks every signature as an IAM signBlob request, so
	// the store caches the URLs it signs (decision 0029). Set it from
	// ClientConfig.SignsOverNetwork.
	SignsOverNetwork bool
	// CDN signs CDN URLs when set, such as a cdn.CloudCDN in front of the
	// bucket (decision 0029). It must reach every key under Prefix.
	CDN cdn.Signer
}

type SignedURLOptions struct {
	Expires            time.Time
	ContentDisposition string
	ContentType        string
}

type Source struct {
	Name       string
	Generation int64
}

type Store struct {
	// contains filtered or unexported fields
}