errors.go

package moderyo

import "fmt"

// ModeryoError is the interface all SDK errors implement.
type ModeryoError interface {
	error
	ErrorCode() string
}

// APIError represents a generic API error.
type APIError struct {
	Code       string
	Message    string
	StatusCode int
	RequestID  string
}

func (e *APIError) Error() string {
	return fmt.Sprintf("moderyo: API error %d: %s", e.StatusCode, e.Message)
}
func (e *APIError) ErrorCode() string { return e.Code }

// AuthenticationError represents a 401 error.
type AuthenticationError struct {
	Message   string
	RequestID string
}

func (e *AuthenticationError) Error() string {
	return fmt.Sprintf("moderyo: authentication error: %s", e.Message)
}
func (e *AuthenticationError) ErrorCode() string { return "AUTHENTICATION_ERROR" }

// RateLimitError represents a 429 error.
type RateLimitError struct {
	Message    string
	RetryAfter float64
	Limit      int
	Remaining  int
	RequestID  string
}

func (e *RateLimitError) Error() string {
	return fmt.Sprintf("moderyo: rate limit exceeded: %s (retry after %.0fs)", e.Message, e.RetryAfter)
}
func (e *RateLimitError) ErrorCode() string { return "RATE_LIMIT_ERROR" }

// ValidationError represents a 400/422 error.
type ValidationError struct {
	Message   string
	Field     string
	RequestID string
}

func (e *ValidationError) Error() string {
	return fmt.Sprintf("moderyo: validation error: %s", e.Message)
}
func (e *ValidationError) ErrorCode() string { return "VALIDATION_ERROR" }

// QuotaExceededError represents a 402 error.
type QuotaExceededError struct {
	Message   string
	RequestID string
}

func (e *QuotaExceededError) Error() string {
	return fmt.Sprintf("moderyo: quota exceeded: %s", e.Message)
}
func (e *QuotaExceededError) ErrorCode() string { return "QUOTA_EXCEEDED_ERROR" }

// NetworkError represents connection/DNS/timeout errors.
type NetworkError struct {
	Message   string
	IsTimeout bool
	Cause     error
}

func (e *NetworkError) Error() string {
	return fmt.Sprintf("moderyo: network error: %s", e.Message)
}
func (e *NetworkError) ErrorCode() string { return "NETWORK_ERROR" }
func (e *NetworkError) Unwrap() error     { return e.Cause }