websocket

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

type DialOptions struct {
	// HTTPClient performs the opening handshake. Its Transport, proxy,
	// cookie jar, redirect callback, and timeout are preserved. A successful
	// 101 response body must implement io.ReadWriteCloser; http.Transport does.
	// HTTPClient cannot be combined with NetDialer or TLSConfig.
	HTTPClient *http.Client

	// HTTPHeader is copied into the opening handshake. Dial owns the
	// WebSocket protocol headers and overwrites conflicting values.
	HTTPHeader http.Header

	// Subprotocols lists protocols in client preference order.
	Subprotocols []string

	// TLSConfig configures wss connections. It is cloned before use.
	TLSConfig *tls.Config

	// NetDialer controls the underlying TCP connection. The zero value uses
	// net.Dialer.
	NetDialer *net.Dialer

	// MaxMessageSize limits a complete message read from the peer. Values at
	// or below zero use the package default of 1 MiB.
	MaxMessageSize int64
}

type Frame struct {
	Fin     bool
	RSV1    bool
	RSV2    bool
	RSV3    bool
	Opcode  int
	Masked  bool
	Payload []byte
	MaskKey [4]byte
}

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

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

type HandshakeOptions struct {
	// CheckOrigin returns true if the request Origin header is acceptable
	CheckOrigin func(r *http.Request) bool
	// Subprotocols is the list of supported subprotocols
	Subprotocols []string
	// RequireProtocol rejects the handshake unless a supported subprotocol is negotiated.
	RequireProtocol bool
	// ResponseHeader is copied into the 101 Switching Protocols response.
	ResponseHeader http.Header
	// Extensions is the list of supported extensions
	Extensions []string
	// BeforeUpgrade is called before the upgrade response is sent
	BeforeUpgrade func(w http.ResponseWriter, r *http.Request) error
}

type Upgrader struct {
	// CheckOrigin returns true if the request Origin header is acceptable
	// If nil, a safe default is used that checks for same-origin requests
	CheckOrigin func(r *http.Request) bool

	// Subprotocols specifies the server's supported protocols in order of preference
	Subprotocols []string

	// Error specifies the function for generating HTTP error responses
	Error func(w http.ResponseWriter, r *http.Request, status int, reason error)

	// MaxMessageSize is the maximum size for a message read from the peer
	MaxMessageSize int64

	// HandshakeTimeout bounds writing the upgrade response after the
	// application-owned BeforeUpgrade hook returns.
	HandshakeTimeout time.Duration

	// BeforeUpgrade is called after origin check but before sending upgrade response
	// This can be used for authentication, rate limiting, or other pre-upgrade checks
	BeforeUpgrade func(w http.ResponseWriter, r *http.Request) error

	// AllowedOrigins is a list of allowed origins for CORS
	// If empty and CheckOrigin is nil, same-origin policy is enforced
	AllowedOrigins []string

	// RequireProtocol ensures the client specifies one of the supported subprotocols
	RequireProtocol bool
}