errors.go

package ramp

import (
	"errors"

	"github.com/iamkanishka/ramp-go/shared"
)

// Re-export error types from shared so callers only need one import.

// ErrorType classifies the category of a Ramp API error.
type ErrorType = shared.ErrorType

const (
	ErrorTypeAuthentication = shared.ErrorTypeAuthentication
	ErrorTypeAuthorization  = shared.ErrorTypeAuthorization
	ErrorTypeNotFound       = shared.ErrorTypeNotFound
	ErrorTypeValidation     = shared.ErrorTypeValidation
	ErrorTypeRateLimit      = shared.ErrorTypeRateLimit
	ErrorTypeServer         = shared.ErrorTypeServer
	ErrorTypeTimeout        = shared.ErrorTypeTimeout
	ErrorTypeNetwork        = shared.ErrorTypeNetwork
	ErrorTypeDeferred       = shared.ErrorTypeDeferred
	ErrorTypeUnknown        = shared.ErrorTypeUnknown
)

// Error is the structured error type returned by all SDK operations.
type Error = shared.Error

// APIError constructs an Error from an HTTP response status and body.
func APIError(statusCode int, body []byte, traceID string) *Error {
	return shared.APIError(statusCode, body, traceID)
}

// IsNotFound reports whether err is a Ramp 404 error.
func IsNotFound(err error) bool { return isType(err, ErrorTypeNotFound) }

// IsRateLimit reports whether err is a Ramp 429 rate-limit error.
func IsRateLimit(err error) bool { return isType(err, ErrorTypeRateLimit) }

// IsAuth reports whether err is a Ramp authentication or authorization error.
func IsAuth(err error) bool {
	return isType(err, ErrorTypeAuthentication) || isType(err, ErrorTypeAuthorization)
}

// IsValidation reports whether err is a Ramp 400 validation error.
func IsValidation(err error) bool { return isType(err, ErrorTypeValidation) }

func isType(err error, t ErrorType) bool {
	var re *Error
	if errors.As(err, &re) {
		return re.Type == t
	}
	return false
}