rest

type Client interface {
	// Request begins a new HTTP request.
	Request(ctx context.Context, url string, method string) ClientRequest

	// RoundTripper returns the used transport for the Client.
	RoundTripper() http.RoundTripper
}

type ClientRequest interface {
	// JSONBody includes a JSON string into a HTTP body request.
	JSONBody(data interface{}) ClientRequest

	// StringBody includes a string into a HTTP body request.
	StringBody(data string) ClientRequest

	// Header adds a header to the request.
	Header(key string, value ...string) ClientRequest

	// Send a request on its way.
	Send(okCode ...int) ClientResponse
}

type ClientResponse interface {
	// JSONBody extracts a JSON string from a HTTP body request.
	JSONBody(data interface{}) ClientResponse

	// ByteSliceBody extracts a byte slice from a HTTP body request.
	ByteSliceBody(data *[]byte) ClientResponse

	// StringBody extracts a string from a HTTP body request.
	StringBody(dst *string) ClientResponse

	// Check finalizes the request and returns an error on failure or unexpected status code.
	Check() error
}

type HTTPError struct {
	URL        string
	StatusCode int
	Text       string
}

type Mux interface {
	// Forward a path to some other host.
	Forward(client Client, path, host, redirect string)
	// AddDefaultResponseHeader to the given header.
	AddDefaultResponseHeader(header http.Header)
	// Endpoint provides a server end point for a rest application. The given handler is called on each invoction.
	Endpoint(path string, queryHandler func(query *Request))
	// ServeHTTP just calls net/http.ServeMux.ServeHTTP.
	ServeHTTP(w http.ResponseWriter, r *http.Request)
	// Handle just calls net/http.ServeMux.Handle.
	Handle(pattern string, handler http.Handler)
	// HandleFunc just calls net/http.ServeMux.HandleFunc.
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
}

type Request struct {
	Ctx                                 context.Context
	URL                                 url.URL
	RequestBody                         []byte
	ResponseBody                        []byte
	Status                              int
	RequestErr, InternalErr, GatewayErr error
	HasArgs                             bool
}