providers

type Client interface {
	Upload(ctx context.Context, key string, reader io.Reader, opts ...UploadOptionFunc) error
	Download(ctx context.Context, key string, opts ...DownloadOptionFunc) (io.ReadCloser, error)
	Delete(ctx context.Context, key string) error
	Exists(ctx context.Context, key string) (bool, error)
	Stat(ctx context.Context, key string) (*ObjectInfo, error)
	SignedURL(ctx context.Context, key string, expire time.Duration, opts ...SignOptionFunc) (string, error)
	InitMultipart(ctx context.Context, key string, opts ...UploadOptionFunc) (*MultipartUpload, error)
	UploadPart(ctx context.Context, uploadID string, partNum int, reader io.Reader, opts ...UploadOptionFunc) (*PartInfo, error)
	CompleteMultipart(ctx context.Context, uploadID string, parts []*PartInfo, opts ...UploadOptionFunc) error
	AbortMultipart(ctx context.Context, uploadID string) error
	DeleteBatch(ctx context.Context, keys []string) error
}

type Config struct {
	Type              string
	AccessKeyID       string
	AccessKeySecret   string
	Bucket            string
	Region            string
	Endpoint          string
	DefaultSignExpire time.Duration
}

type DirectUploadAuthorization struct {
	Provider    string
	Mode        DirectUploadMode
	ObjectKey   string
	URL         string
	Method      string
	Headers     map[string]string
	FormFields  map[string]string
	ExpiresAt   time.Time
	Constraints DirectUploadConstraints
}

type DirectUploadAuthorizer interface {
	AuthorizeDirectUpload(ctx context.Context, req DirectUploadRequest) (*DirectUploadAuthorization, error)
}

type DirectUploadChecksum struct {
	Algorithm DirectUploadChecksumAlgorithm
	Value     string
}

type DirectUploadChecksumAlgorithm string

type DirectUploadConstraints struct {
	ContentType string
	Metadata    map[string]string
	Size        *DirectUploadSize
	Checksum    *DirectUploadChecksum
}

type DirectUploadMismatch struct {
	Field    string
	Expected string
	Actual   string
}

type DirectUploadMode string

type DirectUploadRequest struct {
	ObjectKey   string
	Expire      time.Duration
	ContentType string
	Metadata    map[string]string
	Size        *DirectUploadSize
	Checksum    *DirectUploadChecksum
	Mode        DirectUploadMode
}

type DirectUploadSize struct {
	Exact int64
	Min   int64
	Max   int64
}

type DirectUploadVerificationRequest struct {
	ObjectKey   string
	ContentType string
	Metadata    map[string]string
	Size        *DirectUploadSize
	Checksum    *DirectUploadChecksum
}

type DirectUploadVerificationResult struct {
	Exists     bool
	Matched    bool
	Mismatches []DirectUploadMismatch
	Object     *ObjectInfo
}

type DownloadOption struct{}

type DownloadOptionFunc func(*DownloadOption)

type MultipartUpload struct {
	UploadID string
	Key      string
	Bucket   string
}

type ObjectInfo struct {
	Key          string
	Size         int64
	LastModified time.Time
	ETag         string
	ContentType  string
	Metadata     map[string]string
	Checksums    map[string]string
}

type PartInfo struct {
	PartNumber int
	ETag       string
}

type SignOption struct {
	Method string
}

type SignOptionFunc func(*SignOption)

type UploadOption struct {
	ContentType string
	Metadata    map[string]string
}

type UploadOptionFunc func(*UploadOption)