storage

type Disk interface {
	// Put writes r to the given path, creating directories as needed.
	Put(ctx context.Context, path string, r io.Reader, opts ...PutOptions) error
	// Get returns a reader for the object at path.
	Get(ctx context.Context, path string) (io.ReadCloser, error)
	// Delete removes the object at path.
	Delete(ctx context.Context, path string) error
	// Exists reports whether an object exists at path.
	Exists(ctx context.Context, path string) (bool, error)
	// URL returns the public URL for path. For signed URLs, use SignedURL.
	URL(path string) string
	// SignedURL returns a pre-signed URL valid for ttl.
	SignedURL(ctx context.Context, path string, ttl time.Duration) (string, error)
	// List returns the keys under prefix.
	List(ctx context.Context, prefix string) ([]string, error)
	// Size returns the byte size of the object at path.
	Size(ctx context.Context, path string) (int64, error)
	// Copy duplicates src to dst within the same disk.
	Copy(ctx context.Context, src, dst string) error
	// Move renames src to dst within the same disk.
	Move(ctx context.Context, src, dst string) error
}

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

type Manager struct {
	Default string
	// contains filtered or unexported fields
}

type PutOptions struct {
	ContentType string
	ACL         string // e.g. "public-read", "private"
	Metadata    map[string]string
}

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

type S3Config struct {
	Bucket          string
	Region          string
	AccessKeyID     string
	SecretAccessKey string
	// Endpoint is the base URL for S3-compatible services (MinIO, Wasabi, R2).
	// Leave empty for AWS S3.
	Endpoint string
	// BaseURL is the public CDN/bucket URL used by URL(). If empty, the S3 URL is used.
	BaseURL string
	// DefaultACL is the default ACL for new objects (default: "private").
	DefaultACL string
	// ForcePathStyle enables path-style addressing (required by MinIO).
	ForcePathStyle bool
}