providers

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

type BatchSMSRequest struct {
	Requests []*SendSMSRequest `json:"requests"` // 短信请求列表
	BatchID  string            `json:"batch_id"` // 批次ID
}

type BatchSMSResponse struct {
	BatchID    string            `json:"batch_id"`    // 批次ID
	Total      int               `json:"total"`       // 总数
	Success    int               `json:"success"`     // 成功数
	Failed     int               `json:"failed"`      // 失败数
	Results    []*BatchSMSResult `json:"results"`     // 结果列表
	StartedAt  time.Time         `json:"started_at"`  // 开始时间
	FinishedAt time.Time         `json:"finished_at"` // 完成时间
	Cost       float64           `json:"cost"`        // 总费用
}

type BatchSMSResult struct {
	Index        int        `json:"index"`                   // 索引
	Phone        string     `json:"phone"`                   // 手机号
	MessageID    string     `json:"message_id,omitempty"`    // 消息ID
	ProviderID   string     `json:"provider_id,omitempty"`   // 提供商消息ID
	Status       string     `json:"status"`                  // 状态
	Cost         float64    `json:"cost,omitempty"`          // 费用
	SentAt       *time.Time `json:"sent_at,omitempty"`       // 发送时间
	ErrorCode    string     `json:"error_code,omitempty"`    // 错误代码
	ErrorMessage string     `json:"error_message,omitempty"` // 错误消息
}

type ProviderError struct {
	Code      string `json:"code"`      // 错误代码
	Message   string `json:"message"`   // 错误消息
	Provider  string `json:"provider"`  // 提供商
	Retryable bool   `json:"retryable"` // 是否可重试
}

type ProviderFactory interface {
	// CreateProvider 创建提供商实例
	CreateProvider(providerType string, config interface{}) (SMSProvider, error)

	// GetSupportedProviders 获取支持的提供商列表
	GetSupportedProviders() []string

	// ValidateProviderConfig 验证提供商配置
	ValidateProviderConfig(providerType string, config interface{}) error
}

type QuerySMSRequest struct {
	MessageID  string `json:"message_id,omitempty"`  // 消息ID
	ProviderID string `json:"provider_id,omitempty"` // 提供商消息ID
	Phone      string `json:"phone,omitempty"`       // 手机号
}

type QuerySMSResponse struct {
	MessageID    string            `json:"message_id"`              // 消息ID
	ProviderID   string            `json:"provider_id"`             // 提供商消息ID
	Phone        string            `json:"phone"`                   // 手机号
	Content      string            `json:"content"`                 // 短信内容
	Status       string            `json:"status"`                  // 状态
	SentAt       *time.Time        `json:"sent_at,omitempty"`       // 发送时间
	DeliveredAt  *time.Time        `json:"delivered_at,omitempty"`  // 送达时间
	FailedAt     *time.Time        `json:"failed_at,omitempty"`     // 失败时间
	ErrorCode    string            `json:"error_code,omitempty"`    // 错误代码
	ErrorMessage string            `json:"error_message,omitempty"` // 错误消息
	Cost         float64           `json:"cost,omitempty"`          // 费用
	Metadata     map[string]string `json:"metadata,omitempty"`      // 元数据
}

type QuotaResponse struct {
	Total     int64     `json:"total"`     // 总配额
	Used      int64     `json:"used"`      // 已使用
	Remaining int64     `json:"remaining"` // 剩余
	ResetAt   time.Time `json:"reset_at"`  // 重置时间
}

type SMSProvider interface {
	// GetName 获取提供商名称
	GetName() string

	// SendSMS 发送单条短信
	SendSMS(ctx context.Context, req *SendSMSRequest) (*SendSMSResponse, error)

	// SendBatchSMS 批量发送短信
	SendBatchSMS(ctx context.Context, req *BatchSMSRequest) (*BatchSMSResponse, error)

	// QuerySMS 查询短信状态
	QuerySMS(ctx context.Context, req *QuerySMSRequest) (*QuerySMSResponse, error)

	// GetQuota 获取剩余配额
	GetQuota(ctx context.Context) (*QuotaResponse, error)

	// ValidateConfig 验证配置
	ValidateConfig() error

	// HealthCheck 健康检查
	HealthCheck(ctx context.Context) error
}

type SendSMSRequest struct {
	Phone     string            `json:"phone"`               // 手机号
	Content   string            `json:"content"`             // 短信内容
	Sign      string            `json:"sign,omitempty"`      // 短信签名
	Type      string            `json:"type,omitempty"`      // 短信类型
	Priority  int               `json:"priority,omitempty"`  // 优先级
	Scheduled *time.Time        `json:"scheduled,omitempty"` // 定时发送时间
	Metadata  map[string]string `json:"metadata,omitempty"`  // 元数据
	MessageID string            `json:"message_id"`          // 消息ID
}

type SendSMSResponse struct {
	MessageID    string            `json:"message_id"`              // 消息ID
	Status       string            `json:"status"`                  // 状态
	ProviderID   string            `json:"provider_id"`             // 提供商消息ID
	Cost         float64           `json:"cost,omitempty"`          // 费用
	SentAt       time.Time         `json:"sent_at"`                 // 发送时间
	DeliveredAt  *time.Time        `json:"delivered_at,omitempty"`  // 送达时间
	ErrorCode    string            `json:"error_code,omitempty"`    // 错误代码
	ErrorMessage string            `json:"error_message,omitempty"` // 错误消息
	Metadata     map[string]string `json:"metadata,omitempty"`      // 元数据
}

type SpaceIoTConfig struct {
	BaseURL string        `json:"base_url"` // API基础URL
	Sign    string        `json:"sign"`     // 签名
	Key     string        `json:"key"`      // 密钥
	Timeout time.Duration `json:"timeout"`  // 超时时间
}

type SpaceIoTProvider struct {
	*BaseProvider
	// contains filtered or unexported fields
}

type SpaceIoTQueryRequest struct {
	AccountName  string `json:"accountName"`  // 账户名称
	Phone        string `json:"phone"`        // 手机号
	Timestamp    string `json:"timestamp"`    // 时间戳
	RandomString string `json:"randomString"` // 随机字符串
	Sign         string `json:"sign"`         // 签名
}

type SpaceIoTQueryResponse struct {
	Code    int                      `json:"code"`    // 响应代码
	Message string                   `json:"message"` // 响应消息
	Data    *SpaceIoTQueryResultData `json:"data"`    // 响应数据
}

type SpaceIoTQueryResultData struct {
	Status      string `json:"status"`      // 状态
	SentAt      string `json:"sentAt"`      // 发送时间
	DeliveredAt string `json:"deliveredAt"` // 送达时间
	ErrorCode   string `json:"errorCode"`   // 错误代码
	ErrorMsg    string `json:"errorMsg"`    // 错误消息
}

type SpaceIoTSendRequest struct {
	AccountName  string `json:"accountName"`  // 账户名称
	Phone        string `json:"phone"`        // 手机号
	Content      string `json:"content"`      // 短信内容
	Timestamp    string `json:"timestamp"`    // 时间戳
	RandomString string `json:"randomString"` // 随机字符串
	Sign         string `json:"sign"`         // 签名
}

type SpaceIoTSendResponse struct {
	Code    int    `json:"code"`    // 响应代码
	Message string `json:"message"` // 响应消息
	Data    bool   `json:"data"`    // 响应数据
}