s3

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

type Config struct {
	// Endpoint is the S3 endpoint host. For Cloudflare R2 use the
	// account-scoped endpoint (e.g. "<account>.r2.cloudflarestorage.com").
	// For AWS use the regional endpoint (e.g. "s3.us-east-1.amazonaws.com").
	// Must NOT include a scheme — set Insecure to toggle HTTPS/HTTP.
	Endpoint string `yaml:"endpoint"`

	// Bucket is the destination bucket name. Must already exist.
	Bucket string `yaml:"bucket"`

	// Region is the bucket region. Required by AWS, ignored by R2/MinIO
	// but harmless. Defaults to "auto" which works for R2.
	Region string `yaml:"region" default:"auto"`

	// AccessKeyID and SecretAccessKey authenticate the client. Required.
	AccessKeyID     string `yaml:"accessKeyId"`
	SecretAccessKey string `yaml:"secretAccessKey"`

	// Insecure disables HTTPS (plain HTTP). Defaults to false — i.e. SSL
	// is used. Modeled as opt-in plain-HTTP rather than opt-in SSL because
	// `bool` zero-value defaulting traps the opposite shape: an explicit
	// `useSsl: false` would be indistinguishable from "unset" and get
	// overridden back to true by the defaults loader.
	Insecure bool `yaml:"insecure"`
}

type PutOptions struct {
	// ContentType is the MIME type (e.g. "text/plain").
	ContentType string

	// ContentEncoding is the Content-Encoding header (e.g. "gzip" when
	// Body is already gzip-compressed).
	ContentEncoding string
}