request

type Config struct {
	// Endpoint is hostname or fully qualified URI of the service being called
	Endpoint string

	// Name of the external service being called
	ServiceName string

	// Set this to `true` to disable SSL when sending requests. Defaults
	// to `false`
	DisableSSL bool

	// The HTTP client to use when sending requests
	HTTPClient *http.Client

	DisableFollowRedirects bool

	LogLevel LogLevel
	// The logger writer interface to write logging messages to. Defaults to
	// standard out.
	Logger Logger

	// Unique ID to trace a request attempt
	RequestID string
}

type Hook struct {
	Name string
	Fn   func(*Request)
}

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

type Hooks struct {
	Validate  HookList
	Build     HookList
	Send      HookList
	Unmarshal HookList
	Retry     HookList
	Complete  HookList
}

type LogLevel uint

type Logger interface {
	Log(...any)
}

type LoggerFunc func(...any)

type Operation struct {
	Name   string
	Method string
	Path   string
}

type Option func(*Request)

type Request struct {
	Config Config

	// request payload
	Params any

	// response body
	Body any
	Data any

	Hooks Hooks

	Error error

	Retryer
	RetryConfig RetryConfig

	Operation *Operation
	Request   *http.Request
	Response  *http.Response

	AttemptTime time.Time
	// contains filtered or unexported fields
}

type RetryConfig struct {
	// InitialDelay before the first retry.
	InitialDelay time.Duration
	// Multiplier to apply to the delay interval between retries.
	// Values >1 increase the delay interval exponentially, values <1 decrease it.
	Multiplier float64
	// MaximumDelay n at which to cap the delay interval between retries.
	// As the delay interval increases, the highest interval will be capped
	// at this value.
	MaxDelay time.Duration
	// Jitter is the amount of random jitter to apply to the delay interval
	// between retries to prevent exact timing between retries.
	// Valid values are between 0 and 1. A value of 0 disables Jitter.
	Jitter float64
	// CurrentDelay tracks the current delay interval between retries.
	CurrentDelay time.Duration

	// Number of retries attempted. Value should be incremented with each retry
	RetryCount int
	// Number of maximum allowed retries
	MaxRetries int
	// Maximum allowed time for retries
	MaxElapsedTime time.Duration

	// Additional API error codes that should be retried. IsErrorRetryable
	// will consider these codes in addition to its built-in cases.
	RetryErrorCodes []string
}

type Retryer interface {
	// Delay returns the duration to wait before making another attempt for the
	// failed request.
	Delay(*Request) time.Duration

	// Retryable returns true if the request should be retried
	Retryable(*Request) bool
}