h1_upgrade (h1 v0.2.1)
View SourceHTTP/1.1 Upgrade + capsule passthrough helpers.
Upgrade handshake itself is done by h1_connection (client: h1:upgrade/3,4; server: h1:accept_upgrade/3). After a successful handshake the caller owns the raw socket and any leftover buffer.
This module provides the thin capsule-over-socket helpers a consumer (e.g. masque for RFC 9298 CONNECT-UDP) needs on that raw socket: framing a capsule and reading one back, with an incremental buffer so partial reads don't drop bytes.
The capsule wire format (RFC 9297) lives in h1_capsule. This module stays protocol-agnostic — it knows nothing about connect-udp, connect-ip, or any specific capsule type.
Summary
Functions
Read exactly one capsule from the socket, reusing any bytes already in Buffer. Returns the decoded capsule plus the leftover buffer, ready to be passed back into the next call.
Encode a capsule and send it on the raw socket.
Types
-type capsule() :: {atom() | non_neg_integer(), binary()}.
-type socket() :: gen_tcp:socket() | ssl:sslsocket().
-type transport() :: gen_tcp | ssl.
Functions
Read exactly one capsule from the socket, reusing any bytes already in Buffer. Returns the decoded capsule plus the leftover buffer, ready to be passed back into the next call.
-spec send_capsule(transport(), socket(), atom() | non_neg_integer(), iodata()) -> ok | {error, term()}.
Encode a capsule and send it on the raw socket.