objstore

type Config struct {
	Driver         string
	Bucket         string
	Region         string
	Endpoint       string
	AccessKey      string
	SecretKey      string
	ForcePathStyle bool
	BaseDir        string
	SignedURLTTL   time.Duration
	PublicURL      string // 公共访问 URL 前缀,如 https://cdn.example.com 或 https://example.com/uploads
}

type ListResult struct {
	Objects     []ObjectInfo
	Prefixes    []string
	IsTruncated bool
	NextMarker  string
}

type ObjectInfo struct {
	Key          string
	Size         int64
	LastModified time.Time
	ETag         string
	StorageClass string
}

type ReadSeeker interface {
	Read(p []byte) (int, error)
	Seek(offset int64, whence int) (int64, error)
}

type Store interface {
	Put(ctx context.Context, key string, r ReadSeeker, size int64, contentType string) error
	SignedURL(ctx context.Context, key string, method string, expiry time.Duration) (string, error)
	Delete(ctx context.Context, key string) error
	List(ctx context.Context, prefix, marker, delimiter string, limit int) (ListResult, error)
	CreatePrefix(ctx context.Context, prefix string) error
	RenamePrefix(ctx context.Context, oldPrefix, newPrefix string) error
}