providers

type CertificateMaterial struct {
	Name           string // Name 云厂商证书备注或别名。
	Domain         string // Domain 证书申请主域名，仅用于展示和兼容旧业务。
	CertificatePEM string // CertificatePEM 完整 PEM 证书链。
	PrivateKeyPEM  string // PrivateKeyPEM PEM 私钥。
}

type CertificateUploader interface {
	UploadCertificate(name, domain, cert, key string) error
}

type ConnectionTester interface {
	TestConnection() (bool, error)
}

type DeploymentError struct {
	Message   string // Message 可安全返回后端的脱敏错误说明。
	Retryable bool   // Retryable 表示后端是否可以自动重试。
	RequestID string // RequestID 云厂商请求 ID。
	Cause     error  // Cause 原始错误，仅用于本地错误链和日志。
}

type DeploymentResource struct {
	TargetRef string // TargetRef 客户端根据资源身份自动生成的不透明稳定引用。
	Label     string // Label 本地展示名称。
	Domain    string // Domain 实际绑定证书的域名。
	Region    string // Region 对象存储地域。
	Endpoint  string // Endpoint OSS endpoint 覆盖值。
	Bucket    string // Bucket 对象存储 Bucket。
	SiteID    string // SiteID 阿里云 ESA Site ID。
	ZoneID    string // ZoneID 腾讯云 EdgeOne Zone ID。
}

type DeploymentResourceDeployer interface {
	DeployCertificate(ctx context.Context, certificate CertificateMaterial, business deployPB.ExecuteBusinesType, resource DeploymentResource) (DeploymentResult, error)
}

type DeploymentResult struct {
	RequestID string // RequestID 云厂商请求 ID。
	Message   string // Message 不包含凭据或敏感资源定位参数的结果说明。
}

type ProviderHandler interface {
	ConnectionTester
	CertificateUploader
}

type RequestOptions struct {
	Method  string            // HTTP 请求方法
	Path    string            // API 路径 (例如: "/v1/resource")
	Query   map[string]string // URL 查询参数
	Body    any               // 请求体 (将被 JSON 编码)
	Headers map[string]string // 自定义请求头
	Timeout time.Duration     // 请求超时时间 (默认: 30s)
	BaseURL string            // 覆盖默认 Base URL
}

type Response struct {
	StatusCode int            // HTTP 状态码
	Body       map[string]any // 响应体
	Headers    http.Header    // 响应头
}