package http

import (
	"bufio"
	"fmt"
	"net"
	"time"
)

// A ResponseController is used by an HTTP handler to control the response.
//
// A ResponseController may not be used after the [Handler.ServeHTTP] method has returned.
type ResponseController struct {
	rw ResponseWriter
}

// NewResponseController creates a [ResponseController] for a request.
//

pkg math/big, method (*Int) Float64() (float64, Accuracy) #56984
pkg net/http, method (*ProtocolError) Is(error) bool #41198
pkg net/http, method (*ResponseController) EnableFullDuplex() error #57786
pkg net/http, var ErrSchemeMismatch error #44855
pkg net, method (*Dialer) MultipathTCP() bool #56539
pkg net, method (*Dialer) SetMultipathTCP(bool) #56539

func (pe *ProtocolError) Is(err error) bool {
	return pe == ErrNotSupported && err == errors.ErrUnsupported
}

var (
	// ErrNotSupported indicates that a feature is not supported.
	//
	// It is returned by ResponseController methods to indicate that
	// the handler does not support the method, and by the Push method
	// of Pusher implementations to indicate that HTTP/2 Push support
	// is not available.

		{"(*Response).ProtoAtLeast", Method, 0},
		{"(*Response).Write", Method, 0},
		{"(*ResponseController).EnableFullDuplex", Method, 21},
		{"(*ResponseController).Flush", Method, 20},
		{"(*ResponseController).Hijack", Method, 20},
		{"(*ResponseController).SetReadDeadline", Method, 20},
		{"(*ResponseController).SetWriteDeadline", Method, 20},
		{"(*ServeMux).Handle", Method, 0},
		{"(*ServeMux).HandleFunc", Method, 0},

pkg net/http, method (*ResponseController) Flush() error #54136
pkg net/http, method (*ResponseController) Hijack() (net.Conn, *bufio.ReadWriter, error) #54136
pkg net/http, method (*ResponseController) SetReadDeadline(time.Time) error #54136
pkg net/http, method (*ResponseController) SetWriteDeadline(time.Time) error #54136
pkg net/http, type ResponseController struct #54136

	// can deadlock if we start writing the response with unconsumed body
	// remaining. See Issue 15527 for some history.
	//
	// If full duplex mode has been enabled with ResponseController.EnableFullDuplex,
	// then leave the request body alone.
	//
	// We don't take this path when w.closeAfterReply is set.
	// We may not need to consume the request to get ready for the next one