rp

type CertGetter interface {
	// GetCertificate returns the TLS certificate for the given client hello info.
	GetCertificate(*tls.ClientHelloInfo) (*tls.Certificate, error)
}

type ErrorHandler interface {
	// ErrorHandler handles the error returned by the upstream.
	// If this method is not implemented, the error will be returned to the client.
	ErrorHandler(http.ResponseWriter, *http.Request, error)
}

type Relayer interface {
	// GetUpstream returns the upstream URL for the given request.
	// If upstream is not determined, nil may be returned
	// DO NOT modify the request in this method.
	GetUpstream(*http.Request) (*url.URL, error)
}

type Rewriter interface {
	// Rewrite rewrites the request before sending it to the upstream.
	// For example, you can set `X-Forwarded-*` header here using [httputil.ProxyRequest.SetXForwarded](https://pkg.go.dev/net/http/httputil#ProxyRequest.SetXForwarded)
	Rewrite(*httputil.ProxyRequest) error
}

type RoundTipperOnErrorer interface {
	// RoundTripOnError performs the round trip of the request when the upstream returns an error.
	// If this method is not implemented, the request will be sent to the default transport error.
	RoundTripOnError(r *http.Request) (*http.Response, error)
}

type RoundTripper interface {
	// RoundTrip performs the round trip of the request.
	// It is necessary to implement the functions that http.Transport is responsible for (e.g. MaxIdleConnsPerHost).
	RoundTrip(r *http.Request) (*http.Response, error)
	RoundTripOnError(r *http.Request) (*http.Response, error)
}