upload

type Driver interface {
	// Save 保存文件内容到指定路径，返回访问 URL。
	// relPath 是相对路径（不含 basePath），如 "plugin_cms/site_1/media/2024/06/xxx.png"。
	Save(file *multipart.FileHeader, relPath string) (url string, err error)

	// Delete 删除指定路径的文件。
	// relPath 是相对路径，删除失败时返回错误（文件不存在视为成功）。
	Delete(relPath string) error

	// URL 生成文件的访问 URL。
	// relPath 是相对路径，domain 为 true 时返回完整 URL（含域名）。
	URL(relPath string, domain bool) string

	// Exists 判断文件是否存在。
	Exists(relPath string) bool

	// Read 读取文件内容（用于下载或处理）。
	Read(relPath string) ([]byte, error)

	// Name 返回驱动名称（如 "local", "oss"）。
	Name() string
}

type FileInfo struct {
	Filename     string
	OriginalName string
	Path         string // 相对路径
	URL          string // 访问 URL
	MimeType     string
	Size         int64
	Width        int
	Height       int
}

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

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

type OSSDriverConfig struct {
	Endpoint        string // OSS endpoint，如 "oss-cn-hangzhou.aliyuncs.com"
	AccessKeyID     string // AccessKey ID
	AccessKeySecret string // AccessKey Secret
	BucketName      string // Bucket 名称
	BaseURL         string // 自定义域名（可选）
}

type SaveOptions struct {
	PluginCode string
	SiteID     uint
	SubPath    string
	DatePath   bool
}

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