request

type Config struct {
	Host               string
	Path               string
	Headers            map[string]string
	Query              map[string]string
	Body               any
	ExpectedStatusCode int
}

type FieldSource string

type OnError[T goservectx.Principal] func(ctx *goservectx.Request[T], err error)

type OnSuccess[B any, T goservectx.Principal] func(ctx *goservectx.Request[T], body B)

type RequestError struct {
	Field   string      `json:"field"`      // The original field name from request
	Source  FieldSource `json:"source"`     // Where the field came from
	Message string      `json:"message"`    // Human-readable error message
	Code    int         `json:"statusCode"` // HTTP status code
}

type Service interface {
	// Get sends an HTTP GET request with the provided configuration and returns the HTTP response or an error.
	Get(config *Config) (*http.Response, error)

	// Post sends an HTTP POST request with the provided configuration and returns the HTTP response or an error.
	Post(config *Config) (*http.Response, error)

	// Put sends an HTTP PUT request with the provided configuration and returns the HTTP response or an error.
	Put(config *Config) (*http.Response, error)

	// Delete sends an HTTP DELETE request with the provided configuration and returns the HTTP response or an error.
	Delete(config *Config) (*http.Response, error)

	// Patch sends an HTTP PATCH request with the provided configuration and returns the HTTP response or an error.
	Patch(config *Config) (*http.Response, error)

	// Head sends an HTTP HEAD request with the provided configuration and returns the HTTP response or an error.
	Head(config *Config) (*http.Response, error)

	// Exec sends an HTTP request using the specified method and configuration and returns the HTTP response and an error.
	Exec(method string, config *Config) (*http.Response, error)

	// ToString converts the body of the last HTTP response into a string and returns it along with an error if any.
	ToString() (string, error)

	// BodyDecode decodes the body of the last HTTP response into the given target interface and returns an error if any.
	// Example:
	//   ...
	//	 data := MyData{}
	//   err := client.BodyDecode(&data)
	BodyDecode(target any) error

	// Close closes the response body of the last HTTP response to release resources.
	Close()
}