storage

type Bucket interface {
	// Put stores the contents of r under key, replacing any file there.
	// size is the length of r, or -1 if unknown.
	Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) error
	// Get opens a file. The reader is an io.ReadSeeker when the bucket can
	// seek, which lets Serve answer range requests.
	Get(ctx context.Context, key string) (io.ReadCloser, Object, error)
	Stat(ctx context.Context, key string) (Object, error)
	// Delete removes a file; deleting a missing file is not an error.
	Delete(ctx context.Context, key string) error
	// List returns the files whose keys start with prefix, sorted by key.
	List(ctx context.Context, prefix string) ([]Object, error)
}

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

type InvalidUpload struct {
	Field   string
	Message string
}

type Object struct {
	Key         string    `json:"key"`
	Size        int64     `json:"size"`
	ContentType string    `json:"contentType"`
	Modified    time.Time `json:"modified"`
}

type Presigner interface {
	PresignGet(key string, ttl time.Duration) (string, error)
}

type ReceiveOptions struct {
	// MaxSize is the largest file accepted, in bytes; the default is 10 MB.
	MaxSize int64
	// MaxFiles is how many files the field may have; the default is 1.
	MaxFiles int
	// Types lists accepted content types, such as "image/*" or
	// "application/pdf"; by default any type is accepted.
	Types []string
	// Required makes an empty field an error.
	Required bool
}

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

type S3Options struct {
	// Endpoint is the service URL, such as
	// "https://s3.eu-central-1.amazonaws.com", "https://<account>.r2.cloudflarestorage.com"
	// or "http://localhost:9000" for MinIO.
	Endpoint string
	// Region is the bucket's region; "auto" for R2, "us-east-1" for MinIO.
	Region    string
	Bucket    string
	AccessKey string
	SecretKey string
	// PathStyle addresses the bucket as <endpoint>/<bucket>/<key> instead
	// of <bucket>.<endpoint host>/<key>. MinIO and most self-hosted servers
	// need it.
	PathStyle bool
	// HTTPClient is used for requests; the default has a 5 minute timeout.
	HTTPClient *http.Client
}

type ServeOptions struct {
	// Signer, if set, makes every file private: only links from
	// Signer.URL work. Without it, files are public.
	Signer *Signer
	// CacheControl is sent with files; the default is
	// "private, max-age=3600" for signed files and "public, max-age=3600"
	// otherwise.
	CacheControl string
	// Inline lists content types shown in the browser rather than
	// downloaded. The default is images (except SVG), video, audio, PDF and
	// plain text; everything else is sent as an attachment, so uploaded
	// HTML or SVG can't run scripts on your site.
	Inline []string
}

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

type Upload struct {
	// Filename is the name the browser sent, without directories. Use it
	// for display only; NewKey makes a safe key from it.
	Filename string
	Size     int64
	// ContentType is detected from the file's contents, not taken from
	// the browser.
	ContentType string
	// contains filtered or unexported fields
}