@amritk/nish-x86_64-linux 0.16.0 → 0.18.0

package/std/net/http3.ts

@@ -0,0 +1,2145 @@
+/**
+ * `nish/net/http3` — the server side of an HTTP/3 connection (RFC 9114) on
+ * the streams of a `QuicConnection` (`nish/net/quic`): the control stream
+ * and SETTINGS both ways, the QPACK encoder and decoder streams (opened, at
+ * dynamic table capacity 0), requests and responses on bidirectional streams
+ * with their bodies streamed both ways, GOAWAY, and RFC 9114's error codes.
+ * Field sections are encoded and decoded by `nish/net/qpack` and checked by
+ * `nish/net/http-fields`.
+ *
+ * It is sans-IO in the way the QUIC connection under it is: the carrier
+ * hands the `QuicConnection` its datagrams and takes the ones it sends, and
+ * this module reads and writes that connection's streams. `nish/net/http3-server`
+ * runs it over a UDP socket with ALPN `h3`.
+ *
+ *     import { Http3Config, Http3Connection, H3_NEED_MORE, H3_ERROR, H3_REQUEST, H3_DATA, H3_END } from "nish/net/http3";
+ *
+ *     const h3 = new Http3Connection(new Http3Config(), quic);   // once per slot; restart() per connection
+ *     // after quic.receive(...):
+ *     let event: i32 = h3.next();
+ *     while (event !== H3_NEED_MORE && event !== H3_ERROR) {
+ *       // H3_REQUEST: h3.stream, h3.fields (method, path, get("accept"))
+ *       // H3_DATA: h3.data[h3.dataStart .. h3.dataStart + h3.dataLength)
+ *       // H3_END: the request is whole; respond
+ *       event = h3.next();
+ *     }
+ *     h3.respond(stream, 200, names, values, false);
+ *     h3.writeData(stream, body, 0, n, true);   // answers how much it took
+ *
+ * **Events.** `next()` reads the streams the QUIC connection has news for and
+ * answers the first thing that means something to the program: `H3_REQUEST`
+ * (a request's field section, in `fields`), `H3_DATA` (a piece of its body, a
+ * window onto `data` valid until the next call), `H3_TRAILERS`, `H3_END` (the
+ * request ended, and its `content-length`, if any, matched), `H3_RESET` (the
+ * stream is gone: the client reset it or stopped it, or it broke a rule that
+ * resets it — `errorCode` says which, `resetByPeer` who), `H3_WRITABLE` (a
+ * stream whose write was held back can take more), `H3_GOAWAY` (the client is
+ * going away; `lastStreamId` is its push ID), and `H3_ERROR`, final: the
+ * connection broke a rule, it is closed with `errorCode`, and every later call
+ * answers it again. `H3_NEED_MORE` asks for more datagrams. A request's events
+ * come in order — REQUEST, DATA…, TRAILERS, END — and after `H3_RESET` its
+ * stream has no more.
+ *
+ * **Back-pressure** is QUIC's flow control. A body is read only as the
+ * program calls `next()`, `bodyChunk` bytes at most at a time, and QUIC gives
+ * the client more credit only as its receive buffer is read. `writeData`
+ * takes as much as the stream's send buffer has room for and answers how much;
+ * when it took less, `H3_WRITABLE` names the stream once acknowledgements free
+ * room. HEADERS and trailers go whole or not at all (`H3_AGAIN`).
+ *
+ * **ALPN.** A QUIC connection whose handshake chose anything but `h3` is
+ * closed with CRYPTO_ERROR no_application_protocol (0x0178) on the first
+ * `next()` after it connects, before any HTTP/3 byte (§3.1).
+ *
+ * **Streams** (§6). The connection opens its control stream, sends SETTINGS
+ * first on it (SETTINGS_QPACK_MAX_TABLE_CAPACITY 0, SETTINGS_QPACK_BLOCKED_STREAMS
+ * 0 and SETTINGS_MAX_FIELD_SECTION_SIZE), and opens its QPACK encoder and
+ * decoder streams, on which it sends nothing but their types. The client's
+ * encoder and decoder streams go to `nish/net/qpack`'s capacity-0 handling.
+ * A unidirectional stream of a type it does not know is asked to stop
+ * (H3_STREAM_CREATION_ERROR) and read to its end (§6.2).
+ *
+ * **What it refuses.** A connection error closes the QUIC connection with
+ * the code: a second control, encoder or decoder stream, or a push stream
+ * from a client (H3_STREAM_CREATION_ERROR, §6.2.1, §6.2.2); a control stream
+ * whose first frame is not SETTINGS (H3_MISSING_SETTINGS); the end, reset or
+ * STOP_SENDING of any critical stream, either side's (H3_CLOSED_CRITICAL_STREAM);
+ * a frame where it may not be — DATA or HEADERS on the control stream, a
+ * control frame on a request stream, a second SETTINGS, DATA before HEADERS,
+ * anything but the end after trailers, any PUSH_PROMISE from a client, and an
+ * HTTP/2 type HTTP/3 reserves (H3_FRAME_UNEXPECTED, §7.2.8); a frame cut off
+ * by its stream's end or a payload of the wrong length (H3_FRAME_ERROR, §7.1);
+ * a SETTINGS frame `nish/net/http3-frame` refuses (H3_SETTINGS_ERROR); a
+ * GOAWAY whose push ID rose, a MAX_PUSH_ID that fell, a CANCEL_PUSH past the
+ * push IDs allowed (H3_ID_ERROR, §5.2, §7.2.7, §7.2.3); a control frame past
+ * `H3_CONTROL_FRAME_MAX` (H3_EXCESSIVE_LOAD); and QPACK's three. A stream
+ * error resets one request, both ways, and the connection lives: a field
+ * section `nish/net/http-fields` refuses, and a body that disagrees with
+ * `content-length` (H3_MESSAGE_ERROR, §4.1.2); a request stream that ends
+ * before its HEADERS (H3_REQUEST_INCOMPLETE, §4.1.1); a request on a stream at
+ * or past the ID of the GOAWAY this side sent (H3_REQUEST_REJECTED, §5.2).
+ * A request whose field section is longer than `maxFieldSectionSize` — the
+ * frame, or the section once decoded — is answered with a 431, never reaches
+ * the program, and its stream is asked to stop with H3_NO_ERROR (§4.2.2,
+ * §4.1.2).
+ *
+ * **No server push.** It never sends PUSH_PROMISE; a client's MAX_PUSH_ID is
+ * allowed, checked and ignored.
+ *
+ * **Caps are start-up numbers**, all in `Http3Config`, and every buffer is
+ * made by the constructor: the stream state for every QUIC stream slot, the
+ * field section, the body chunk and the control frame. A field section's
+ * names and values are copied into arrays the connection keeps, which grow to
+ * the largest section seen and are then reused, so a warm connection
+ * allocates nothing per request (`docs/security/http3.md`, H3-2). A peer's
+ * counters saturate, and the lookup of a stream's state is the QUIC
+ * connection's own hash index (`QuicStreams.slotOf`), never a scan.
+ *
+ * **Extended CONNECT and WebTransport.** With `extendedConnect` the
+ * connection sends SETTINGS_ENABLE_CONNECT_PROTOCOL 1 and a request may carry
+ * `:protocol` (RFC 9220); without it `:protocol` is malformed,
+ * H3_MESSAGE_ERROR. `webtransportSessions` above 0 turns that on and also
+ * sends SETTINGS_H3_DATAGRAM 1, draft-02's SETTINGS_ENABLE_WEBTRANSPORT 1 and
+ * draft-07's SETTINGS_WEBTRANSPORT_MAX_SESSIONS, and `nish/net/webtransport`
+ * runs its sessions on top: a request then waits for the client's SETTINGS
+ * (draft-02 §3.1), and a stream that opens with WebTransport's unidirectional
+ * type (0x54) or bidirectional signal (0x41) is read as far as its session ID,
+ * held unread and named in `H3_STREAM` until the program calls
+ * `acceptStream` (its bytes then come as H3_DATA, H3_END, H3_RESET and
+ * H3_STOPPED, and `writeStream` writes them as they are) or `refuseStream`.
+ * `openStream` opens one of this side's; `writeDataWhole` writes a capsule;
+ * a GOAWAY still lets a session's new stream in, and `H3_DROPPED` names a
+ * request stream that ended before its request reached the program. The
+ * client's SETTINGS_ENABLE_CONNECT_PROTOCOL and SETTINGS_H3_DATAGRAM must be
+ * 0 or 1 (H3_SETTINGS_ERROR), a session ID that is no client-initiated
+ * bidirectional stream is H3_ID_ERROR, and the signal anywhere but a stream's
+ * start is H3_FRAME_ERROR. Holding every request, not only an extended
+ * CONNECT, until the client's SETTINGS keeps a decoded field section from
+ * having to be held per stream; it costs a request only when the client's
+ * control stream is lost or reordered.
+ *
+ * Private helpers share the importing program's flat symbol namespace
+ * (`docs/wp26-stdlib.md` §3e), which is why each one carries the module's name.
+ *
+ * Written from RFC 9114 and RFC 9204, not ported from another implementation.
+ */
+import {
+  HTTP_FIELDS_OK,
+  HttpFields,
+  httpFieldBytes,
+  httpFieldSensitive,
+  httpFieldsCheckOutgoing,
+} from "nish/net/http-fields"
+import {
+  QPACK_FIELD_OVERHEAD,
+  QPACK_OK,
+  QPACK_SECTION_TOO_LARGE,
+  QpackDecoder,
+  QpackEncoder,
+} from "nish/net/qpack"
+import {
+  H3_CLOSED_CRITICAL_STREAM,
+  H3_EXCESSIVE_LOAD,
+  H3_FRAME_WEBTRANSPORT_STREAM,
+  H3_FRAME_CANCEL_PUSH,
+  H3_FRAME_DATA,
+  H3_FRAME_ERROR,
+  H3_FRAME_GOAWAY,
+  H3_FRAME_HEADERS,
+  H3_FRAME_MAX_PUSH_ID,
+  H3_FRAME_PUSH_PROMISE,
+  H3_FRAME_SETTINGS,
+  H3_FRAME_UNEXPECTED,
+  H3_ID_ERROR,
+  H3_INTERNAL_ERROR,
+  H3_MESSAGE_ERROR,
+  H3_MISSING_SETTINGS,
+  H3_NO_ERROR,
+  H3_REQUEST_CANCELLED,
+  H3_REQUEST_INCOMPLETE,
+  H3_REQUEST_REJECTED,
+  H3_SETTINGS_ENABLE_CONNECT_PROTOCOL,
+  H3_SETTINGS_ENABLE_WEBTRANSPORT,
+  H3_SETTINGS_ERROR,
+  H3_SETTINGS_H3_DATAGRAM,
+  H3_SETTINGS_MAX_FIELD_SECTION_SIZE,
+  H3_SETTINGS_OK,
+  H3_SETTINGS_QPACK_BLOCKED_STREAMS,
+  H3_SETTINGS_QPACK_MAX_TABLE_CAPACITY,
+  H3_SETTINGS_WEBTRANSPORT_MAX_SESSIONS,
+  H3_STREAM_CONTROL,
+  H3_STREAM_CREATION_ERROR,
+  H3_STREAM_PUSH,
+  H3_STREAM_QPACK_DECODER,
+  H3_STREAM_QPACK_ENCODER,
+  H3_STREAM_WEBTRANSPORT,
+  H3_WT_SESSION_GONE,
+  Http3FrameHeader,
+  Http3Settings,
+  h3CheckWindow,
+  h3Count,
+  h3FrameHeaderSize,
+  h3PutFrameHeader,
+  h3PutIdFrame,
+  h3PutSettings,
+  h3PutVarint,
+  h3ReadFrameHeader,
+  h3ReadIdPayload,
+  h3ReadSettings,
+  h3ReadVarint,
+  h3ReservedHttp2Frame,
+  h3VarintLength,
+} from "nish/net/http3-frame"
+import { QUIC_STATE_CONNECTED, QuicConnection } from "nish/net/quic"
+import { QUIC_STREAM_END, QUIC_STREAM_ERR_RESET, QuicStream } from "nish/net/quic-stream"
+import { quicVarintPut } from "nish/net/quic-packet"
+
+/** The ALPN protocol identifier of HTTP/3 (RFC 9114 §3.1). */
+export const H3_ALPN: string = "h3"
+
+/** `next` has nothing more until more datagrams arrive. */
+export const H3_NEED_MORE: i32 = 0
+/** A request's field section: `stream`, `fields`. */
+export const H3_REQUEST: i32 = 1
+/** Request body bytes: `stream`, `data[dataStart .. dataStart + dataLength)`. */
+export const H3_DATA: i32 = 2
+/** A trailer section: `stream`, `fields`. */
+export const H3_TRAILERS: i32 = 3
+/** The request ended whole: `stream`. */
+export const H3_END: i32 = 4
+/** The stream is gone: `stream`, `errorCode`, `resetByPeer`. */
+export const H3_RESET: i32 = 5
+/** A stream whose write was held back can take more: `stream`. */
+export const H3_WRITABLE: i32 = 6
+/** The client sent GOAWAY: `lastStreamId`, its push ID. */
+export const H3_GOAWAY: i32 = 7
+/** The connection failed with `errorCode` and is closed. Final. */
+export const H3_ERROR: i32 = 8
+/**
+ * A WebTransport stream arrived (only with `webtransportSessions` on):
+ * `stream`, and `session`, the session ID its first bytes named. It is held,
+ * unread, until the program calls `acceptStream` or `refuseStream`.
+ */
+export const H3_STREAM: i32 = 9
+/** The client sent STOP_SENDING for a WebTransport stream this side writes, and QUIC reset it: `stream`, `errorCode`. */
+export const H3_STOPPED: i32 = 10
+/**
+ * A request stream ended before its request reached the program (only with
+ * `webtransportSessions` on): `stream`. Nothing is owed the program; a
+ * WebTransport layer lets go of the streams that waited for it as a session.
+ */
+export const H3_DROPPED: i32 = 11
+
+/** A write that can take nothing yet: Linux's EAGAIN, as `nish:net` spells it. */
+export const H3_AGAIN: i32 = -11
+/** A write of fields or a status the program may not send, or out of order: Linux's EINVAL. */
+export const H3_INVALID: i32 = -22
+/** A write to a stream that is not an open request: Linux's EPIPE. */
+export const H3_CLOSED: i32 = -32
+/** A field section past what the client takes, or past a stream's buffer: Linux's EMSGSIZE. */
+export const H3_TOO_LARGE: i32 = -90
+
+/** CRYPTO_ERROR with TLS's no_application_protocol alert (RFC 9001 §4.8): a handshake that did not choose `h3`. */
+export const H3_NO_APPLICATION_PROTOCOL: i64 = 0x0178
+
+/** The largest control-stream frame read whole: SETTINGS, GOAWAY, MAX_PUSH_ID, CANCEL_PUSH. */
+export const H3_CONTROL_FRAME_MAX: i32 = 1024
+
+/** The most WebTransport sessions a configuration may advertise. */
+export const H3_MAX_SESSIONS: i32 = 256
+
+/** The request streams' phases, and the unidirectional streams'. */
+const H3_PHASE_HEADERS: i32 = 0
+const H3_PHASE_BODY: i32 = 1
+const H3_PHASE_TRAILED: i32 = 2
+const H3_PHASE_SKIP: i32 = 3
+const H3_PHASE_DISCARD: i32 = 4
+const H3_PHASE_DONE: i32 = 5
+const H3_PHASE_UNI_TYPE: i32 = 6
+const H3_PHASE_CONTROL: i32 = 7
+const H3_PHASE_ENCODER: i32 = 8
+const H3_PHASE_DECODER: i32 = 9
+/** A WebTransport unidirectional stream whose session ID is being read, one held for the program, and one read raw. */
+const H3_PHASE_WT_SESSION: i32 = 10
+const H3_PHASE_WT_HELD: i32 = 11
+const H3_PHASE_WT: i32 = 12
+
+/** A stream slot's flags. */
+const H3_FLAG_DELIVERED: i32 = 1
+const H3_FLAG_HEADERS_SENT: i32 = 2
+const H3_FLAG_SEND_DONE: i32 = 4
+const H3_FLAG_RECV_DONE: i32 = 8
+const H3_FLAG_BLOCKED: i32 = 32
+const H3_FLAG_COUNTED: i32 = 64
+/** On the ring of streams `next` steps again before asking QUIC, or waiting for the client's SETTINGS. */
+const H3_FLAG_AGAIN: i32 = 128
+const H3_FLAG_WAITING: i32 = 16
+/** A WebTransport stream: its bytes are the session's, read and written raw. */
+const H3_FLAG_WT: i32 = 256
+/** A request stream past this side's GOAWAY, refused unless its first bytes make it a WebTransport stream. */
+const H3_FLAG_LATE: i32 = 512
+
+/** The connection's states. */
+const H3_STATE_OPEN: i32 = 0
+const H3_STATE_FAILED: i32 = 1
+
+/** What `requestFrame` answers when it read a frame header and the stream has more to read. */
+const H3_CONTINUE: i32 = -1
+
+/** A frame type no frame has, for a payload being skipped. */
+const H3_SKIP_TYPE: i64 = -1
+
+/** A reserved frame type (0x1f * 0 + 0x21) the connection pads a stream's send buffer with to be told when it drains. */
+const H3_FILLER_TYPE: i32 = 0x21
+
+/** Typed constants, since a bare literal is an `f64` under `--number-mode f64`. */
+const H3_ZERO: i32 = 0
+const H3_ONE: i32 = 1
+const H3_NONE: i64 = -1
+const H3_NONE32: i32 = -1
+const H3_STATUS_TOO_LARGE: i32 = 431
+const H3_DIGIT_ZERO: i32 = 48
+
+/** The largest body chunk or DATA frame a configuration may ask for. */
+const H3_MAX_CHUNK: i32 = 1048576
+
+/** The size classes of a field's copy: up to 2^23 bytes, past any stream buffer QUIC allows. */
+const H3_FIELD_CLASSES: i32 = 24
+
+/** The bytes a slot keeps for a frame header being read or written. */
+const H3_HEAD: i32 = 16
+
+/**
+ * The connection's caps, fixed when it is made. `maxFieldSectionSize` is
+ * advertised in SETTINGS and is the largest HEADERS frame read and the
+ * largest section decoded; `bodyChunk` the most body handed to the program at
+ * once; `writeChunk` the largest DATA frame written.
+ */
+export class Http3Config {
+  /** SETTINGS_MAX_FIELD_SECTION_SIZE (§4.2.2): past it a request is answered with a 431. */
+  maxFieldSectionSize: i32 = 16384
+  /** The body buffer: the largest `H3_DATA` window. */
+  bodyChunk: i32 = 16384
+  /** The largest DATA frame `writeData` starts. */
+  writeChunk: i32 = 16384
+  /**
+   * The WebTransport sessions this side takes at once
+   * (`nish/net/webtransport`), 0 for none. Above 0 it turns on extended
+   * CONNECT and sends SETTINGS_H3_DATAGRAM, SETTINGS_ENABLE_WEBTRANSPORT and
+   * SETTINGS_WEBTRANSPORT_MAX_SESSIONS, and the QUIC connection must take
+   * DATAGRAM frames; at 0 it must not (RFC 9297 §2.1.1).
+   */
+  webtransportSessions: i32 = 0
+  /**
+   * Whether `:protocol` is accepted (RFC 9220's extended CONNECT), and
+   * SETTINGS_ENABLE_CONNECT_PROTOCOL sent. WebTransport turns it on.
+   */
+  extendedConnect: boolean = false
+}
+
+/** Panics unless `value` lies in `[low, high]`: a cap out of range is the program's mistake. */
+const http3CheckCap = (what: string, value: i32, low: i32, high: i32): void => {
+  if (value < low || value > high) {
+    panic(`Http3Connection: ${what} of ${value}, outside ${low} to ${high}`)
+  }
+}
+
+/** Empties `bytes`, keeping its storage for the next fill. */
+const http3Empty = (bytes: u8[]): void => {
+  while (toI32(bytes.length) > 0) {
+    bytes.pop()
+  }
+}
+
+/** Empties `list`, keeping its storage for the next fill. */
+const http3EmptyList = (list: u8[][]): void => {
+  while (toI32(list.length) > 0) {
+    list.pop()
+  }
+}
+
+/** Whether `id` is a stream the client opened carrying data both ways: a request stream. */
+const http3IsRequest = (id: i64): boolean => (id & 3) === 0
+
+/** The smaller of two `i64`s. */
+const http3Min = (a: i64, b: i64): i64 => (a < b ? a : b)
+
+/**
+ * One HTTP/3 connection, server side, over `quic`. The fields after the
+ * buffers are the last event's; the module comment says which event sets
+ * which.
+ */
+export class Http3Connection {
+  // Pointers and 64-bit fields first, then 32-bit ones, then flags: the
+  // order the layout packs without padding.
+  config: Http3Config
+  quic: QuicConnection
+  decoder: QpackDecoder
+  encoder: QpackEncoder
+  /** The last request's or trailers' fields, valid until the next of either. */
+  fields: HttpFields
+  /** The client's SETTINGS. */
+  peer: Http3Settings
+  header: Http3FrameHeader
+  /** H3_DATA's bytes, and where a payload being skipped is read to. */
+  data: u8[]
+  /** A HEADERS payload read whole, for the decoder. */
+  section: u8[]
+  /** A control frame's payload, read whole. */
+  control: u8[]
+  /** Frame headers, SETTINGS and GOAWAY on their way out. */
+  scratch: u8[]
+  /** Zeros, the payload of a filler frame. */
+  zeros: u8[]
+  /** A response's field section, encoded, emptied and reused. */
+  encoded: u8[]
+  /** Copies of the decoded names and values, in arrays by size class (`copyOf`), and the lists handed to `fields`. */
+  pools: u8[][][]
+  poolUsed: i32[]
+  nameList: u8[][]
+  valueList: u8[][]
+  statusName: u8[]
+  statusValue: u8[]
+  /** The SETTINGS this side sends. */
+  settingIds: i64[]
+  settingValues: i64[]
+  /** Per QUIC stream slot: the stream the state is for, or -1. */
+  slotId: i64[]
+  /** The frame being read: its type, and what is left of its payload (-1 between frames). */
+  frameType: i64[]
+  frameLeft: i64[]
+  /** DATA bytes received on the request, and its `content-length` or -1. */
+  dataTotal: i64[]
+  contentLength: i64[]
+  /** Bytes still owed on the stream: a filler's payload, and the DATA frame's payload the program is writing. */
+  fillLeft: i64[]
+  dataLeft: i64[]
+  phase: i32[]
+  flags: i32[]
+  /** A frame header (or a stream type) being read, `headLen[k]` bytes of `head[k * 16 ..]`. */
+  headLen: i32[]
+  head: u8[]
+  /** Frame-header bytes owed before anything else, `pendLen[k]` of `pend[k * 16 + pendAt[k] ..]`. */
+  pendAt: i32[]
+  pendLen: i32[]
+  pend: u8[]
+  /**
+   * Streams `next` steps again before asking QUIC for news, a ring of
+   * `againCount` from `againHead`: WebTransport streams the program let go,
+   * and requests that waited for the client's SETTINGS. And those waiting,
+   * `waitCount` of them. A stream is on each at most once (its flags say),
+   * so neither needs more room than there are stream slots.
+   */
+  again: i64[]
+  waiting: i64[]
+  /** This side's streams, and the client's critical ones; -1 until there. */
+  ownControl: i64 = -1
+  ownEncoder: i64 = -1
+  ownDecoder: i64 = -1
+  peerControl: i64 = -1
+  peerEncoder: i64 = -1
+  peerDecoder: i64 = -1
+  /** The stream `next` is reading, or -1. */
+  active: i64 = -1
+  /** The ID this side's GOAWAY named, or -1; the client's last GOAWAY push ID, and its MAX_PUSH_ID. */
+  goawayId: i64 = -1
+  peerGoaway: i64 = -1
+  maxPushId: i64 = -1
+  /** The last event's stream. */
+  stream: i64 = -1
+  /** H3_RESET's and H3_ERROR's code. */
+  errorCode: i64 = 0
+  /** H3_GOAWAY's push ID. */
+  lastStreamId: i64 = 0
+  /** H3_STREAM's session ID. */
+  session: i64 = -1
+  /** The QUIC stream slot of the last event's stream: still right when the read that made the event freed it. */
+  slot: i32 = -1
+  /** H3_DATA's window onto `data`. */
+  dataStart: i32 = 0
+  dataLength: i32 = 0
+  /** How much of `control` is filled. */
+  controlFill: i32 = 0
+  state: i32 = 0
+  /** Requests open: taken and not yet finished both ways. */
+  live: i32 = 0
+  /** Counters for a log or a test, each saturating: requests refused after GOAWAY, answered 431, and reset for a rule. */
+  rejected: i32 = 0
+  tooLarge: i32 = 0
+  streamErrors: i32 = 0
+  againHead: i32 = 0
+  againCount: i32 = 0
+  waitCount: i32 = 0
+  /** How many times `restart` ran: a layer above that keeps state per connection compares it to know when to forget its own. */
+  generation: i32 = 0
+  /** Whether the client's SETTINGS have arrived. */
+  settingsSeen: boolean = false
+  /** Whether H3_RESET came from the client. */
+  resetByPeer: boolean = false
+  /** Whether extended CONNECT is on, and WebTransport. */
+  connect: boolean = false
+  webtransport: boolean = false
+
+  /**
+   * A connection under `config` over `quic`, whose configuration must let a
+   * HEADERS frame of `maxFieldSectionSize` fit half a stream's buffer, and
+   * one on every request stream fit half the connection's window, and let
+   * the client open the three unidirectional streams it needs and this side
+   * open its own three (§6.2). A cap out of range panics.
+   */
+  constructor(config: Http3Config, quic: QuicConnection) {
+    const buffer: i32 = quic.streams.bufferSize
+    // A HEADERS frame is read once all of it is in the stream's buffer, and QUIC
+    // gives more credit only once half a buffer has been read, so the frame
+    // may be at most half a buffer, its header aside, or it could stall.
+    http3CheckCap("maxFieldSectionSize", config.maxFieldSectionSize, 1, buffer / 2 - H3_HEAD)
+    // The connection's credit too: every request stream may hold a HEADERS
+    // frame not yet whole, and QUIC raises MAX_DATA once half the window is read.
+    const held: i64 = quic.streams.maxBidi * toI64(config.maxFieldSectionSize + H3_HEAD) * toI64(2)
+    if (quic.streams.windowData < held) {
+      panic(
+        `Http3Connection: a connection window of ${quic.streams.windowData}, under the ${held} that ${quic.streams.maxBidi} request streams' field sections need`
+      )
+    }
+    http3CheckCap("bodyChunk", config.bodyChunk, 1, H3_MAX_CHUNK)
+    http3CheckCap("writeChunk", config.writeChunk, 1, H3_MAX_CHUNK)
+    http3CheckCap("the QUIC unidirectional stream limit", toI32(quic.streams.maxUni), 3, 1024)
+    http3CheckCap("the QUIC local stream limit", toI32(quic.streams.localStreams), 3, 1024)
+    http3CheckCap("webtransportSessions", config.webtransportSessions, 0, H3_MAX_SESSIONS)
+    // RFC 9297 §2.1.1: QUIC datagrams carry HTTP datagrams, which only WebTransport uses here.
+    const datagrams: boolean = quic.datagramsIn.capacity() > 0
+    if (config.webtransportSessions > 0 && !datagrams) {
+      panic("Http3Connection: WebTransport needs QUIC datagrams, and the QUIC maxDatagramFrameSize is 0")
+    }
+    if (config.webtransportSessions === 0 && datagrams) {
+      panic("Http3Connection: QUIC datagrams advertised with WebTransport off (webtransportSessions 0)")
+    }
+    this.webtransport = config.webtransportSessions > 0
+    this.connect = config.extendedConnect || this.webtransport
+    this.config = config
+    this.quic = quic
+    this.decoder = new QpackDecoder(config.maxFieldSectionSize)
+    this.encoder = new QpackEncoder()
+    this.fields = new HttpFields()
+    this.peer = new Http3Settings()
+    this.header = new Http3FrameHeader()
+    this.data = new Array<u8>(config.bodyChunk)
+    this.section = new Array<u8>(config.maxFieldSectionSize)
+    this.control = new Array<u8>(H3_CONTROL_FRAME_MAX)
+    this.scratch = new Array<u8>(64)
+    this.zeros = new Array<u8>(256)
+    this.encoded = []
+    this.pools = []
+    for (let j: i32 = 0; j < H3_FIELD_CLASSES; j++) {
+      const pool: u8[][] = []
+      this.pools.push(pool)
+    }
+    this.poolUsed = new Array<i32>(H3_FIELD_CLASSES)
+    this.nameList = []
+    this.valueList = []
+    this.statusName = httpFieldBytes(":status")
+    this.statusValue = [48, 48, 48]
+    this.settingIds = [
+      H3_SETTINGS_QPACK_MAX_TABLE_CAPACITY,
+      H3_SETTINGS_QPACK_BLOCKED_STREAMS,
+      H3_SETTINGS_MAX_FIELD_SECTION_SIZE,
+    ]
+    this.settingValues = [toI64(0), toI64(0), toI64(config.maxFieldSectionSize)]
+    if (this.connect) {
+      this.settingIds.push(H3_SETTINGS_ENABLE_CONNECT_PROTOCOL)
+      this.settingValues.push(toI64(1))
+    }
+    if (this.webtransport) {
+      this.settingIds.push(H3_SETTINGS_H3_DATAGRAM)
+      this.settingValues.push(toI64(1))
+      this.settingIds.push(H3_SETTINGS_ENABLE_WEBTRANSPORT)
+      this.settingValues.push(toI64(1))
+      this.settingIds.push(H3_SETTINGS_WEBTRANSPORT_MAX_SESSIONS)
+      this.settingValues.push(toI64(config.webtransportSessions))
+    }
+    const n: i32 = toI32(quic.streams.slots.length)
+    this.slotId = new Array<i64>(n)
+    this.frameType = new Array<i64>(n)
+    this.frameLeft = new Array<i64>(n)
+    this.dataTotal = new Array<i64>(n)
+    this.contentLength = new Array<i64>(n)
+    this.fillLeft = new Array<i64>(n)
+    this.dataLeft = new Array<i64>(n)
+    this.phase = new Array<i32>(n)
+    this.flags = new Array<i32>(n)
+    this.headLen = new Array<i32>(n)
+    this.head = new Array<u8>(n * H3_HEAD)
+    this.pendAt = new Array<i32>(n)
+    this.pendLen = new Array<i32>(n)
+    this.pend = new Array<u8>(n * H3_HEAD)
+    this.again = new Array<i64>(n > 0 ? n : H3_ONE)
+    this.waiting = new Array<i64>(n > 0 ? n : H3_ONE)
+    this.restart()
+  }
+
+  /**
+   * Puts the connection back as the constructor left it, for the QUIC
+   * connection's next peer (call it after `quic.reset`): no stream known,
+   * QPACK's state and the client's SETTINGS forgotten. It allocates nothing.
+   */
+  restart(): void {
+    this.slotId.fill(H3_NONE)
+    this.flags.fill(H3_ZERO)
+    this.headLen.fill(H3_ZERO)
+    this.pendLen.fill(H3_ZERO)
+    this.fillLeft.fill(toI64(0))
+    this.dataLeft.fill(toI64(0))
+    this.decoder.failed = QPACK_OK
+    this.decoder.reason = 0
+    this.decoder.capacityInstructions = 0
+    this.encoder.failed = QPACK_OK
+    this.encoder.reason = 0
+    this.encoder.cancellations = 0
+    this.encoder.lastCancelled = -1
+    this.encoder.pendingId = 0
+    this.encoder.pendingShift = -1
+    this.fields.clear()
+    this.peer.reset()
+    this.ownControl = -1
+    this.ownEncoder = -1
+    this.ownDecoder = -1
+    this.peerControl = -1
+    this.peerEncoder = -1
+    this.peerDecoder = -1
+    this.active = -1
+    this.goawayId = -1
+    this.peerGoaway = -1
+    this.maxPushId = -1
+    this.stream = -1
+    this.errorCode = 0
+    this.lastStreamId = 0
+    this.session = -1
+    this.slot = -1
+    this.againHead = 0
+    this.againCount = 0
+    this.waitCount = 0
+    this.generation = this.generation < 2147483647 ? this.generation + 1 : H3_ONE
+    this.dataStart = 0
+    this.dataLength = 0
+    this.controlFill = 0
+    this.state = H3_STATE_OPEN
+    this.live = 0
+    this.rejected = 0
+    this.tooLarge = 0
+    this.streamErrors = 0
+    this.settingsSeen = false
+    this.resetByPeer = false
+  }
+
+  // ---- The connection -----------------------------------------------------------
+
+  /** Closes the connection with `code` (a connection error) and answers H3_ERROR. */
+  fail(code: i64): i32 {
+    if (this.state !== H3_STATE_FAILED) {
+      this.state = H3_STATE_FAILED
+      this.errorCode = code
+      this.quic.close(code)
+    }
+    return H3_ERROR
+  }
+
+  /**
+   * Whether this side sent GOAWAY and every request it took has finished
+   * both ways, every byte of each response acknowledged: the carrier may
+   * close the connection.
+   */
+  isDone(): boolean {
+    const streams = this.quic.streams
+    return this.goawayId >= 0 && this.live === 0 && streams.peerBidiClosed >= streams.peerBidiOpened
+  }
+
+  /** Writes `buf[0 .. n)` to this side's new stream `id` whole, as its first bytes; answers whether it took them. */
+  writeNew(id: i64, buf: u8[], n: i32): boolean {
+    return n > 0 && this.quic.streamWrite(id, buf, H3_ZERO, n, false) === n
+  }
+
+  /**
+   * Opens this side's control stream with its type and SETTINGS, and its
+   * QPACK encoder and decoder streams with their types (§6.2.1, RFC 9204
+   * §4.2). A stream the client's MAX_STREAMS does not allow yet is opened on
+   * a later call.
+   */
+  start(): void {
+    const end: i32 = toI32(this.scratch.length)
+    if (this.ownControl < 0) {
+      const id: i64 = this.quic.openStream(false)
+      if (id < 0) {
+        return
+      }
+      this.ownControl = id
+      const p: i32 = h3PutVarint(this.scratch, H3_ZERO, end, H3_STREAM_CONTROL)
+      const q: i32 = h3PutSettings(this.scratch, p, end, this.settingIds, this.settingValues)
+      if (!this.writeNew(id, this.scratch, q)) {
+        this.fail(H3_INTERNAL_ERROR)
+        return
+      }
+    }
+    if (this.ownEncoder < 0) {
+      const id: i64 = this.quic.openStream(false)
+      if (id < 0) {
+        return
+      }
+      this.ownEncoder = id
+      if (
+        !this.writeNew(id, this.scratch, h3PutVarint(this.scratch, H3_ZERO, end, H3_STREAM_QPACK_ENCODER))
+      ) {
+        this.fail(H3_INTERNAL_ERROR)
+        return
+      }
+    }
+    if (this.ownDecoder < 0) {
+      const id: i64 = this.quic.openStream(false)
+      if (id < 0) {
+        return
+      }
+      this.ownDecoder = id
+      if (
+        !this.writeNew(id, this.scratch, h3PutVarint(this.scratch, H3_ZERO, end, H3_STREAM_QPACK_DECODER))
+      ) {
+        this.fail(H3_INTERNAL_ERROR)
+        return
+      }
+    }
+  }
+
+  /**
+   * Reads what the QUIC connection has for the program and answers the next
+   * event (see the module comment). Call it after every datagram the QUIC
+   * connection takes, until it answers H3_NEED_MORE or H3_ERROR.
+   */
+  next(): i32 {
+    if (this.state === H3_STATE_FAILED) {
+      return H3_ERROR
+    }
+    if (this.quic.closed()) {
+      this.state = H3_STATE_FAILED
+      this.errorCode = this.quic.error
+      return H3_ERROR
+    }
+    if (this.quic.state !== QUIC_STATE_CONNECTED) {
+      return H3_NEED_MORE
+    }
+    if (this.ownDecoder < 0) {
+      // RFC 9114 §3.1: HTTP/3 only where the handshake chose it.
+      if (this.quic.alpn !== H3_ALPN) {
+        this.quic.fail(H3_NO_APPLICATION_PROTOCOL, toI64(0))
+        return this.fail(H3_NO_APPLICATION_PROTOCOL)
+      }
+      this.start()
+    }
+    while (this.state !== H3_STATE_FAILED) {
+      if (this.active < 0) {
+        this.active = this.againCount > 0 ? this.takeAgain() : this.quic.nextStreamEvent()
+        if (this.active < 0) {
+          return H3_NEED_MORE
+        }
+      }
+      const event: i32 = this.step(this.active)
+      if (event !== H3_NEED_MORE) {
+        return event
+      }
+      this.active = -1
+    }
+    return H3_ERROR
+  }
+
+  /** The oldest stream on the `again` ring, taken off it. */
+  takeAgain(): i64 {
+    const size: i32 = toI32(this.again.length)
+    const id: i64 = this.again[this.againHead]
+    this.againHead = (this.againHead + 1) % size
+    this.againCount = this.againCount - 1
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (k >= 0 && k < toI32(this.flags.length) && this.slotId[k] === id) {
+      this.flags[k] = this.flags[k] & ~H3_FLAG_AGAIN
+    }
+    return id
+  }
+
+  /** Puts stream `id`, slot `k`, on the `again` ring, unless it is there. */
+  stepAgain(k: i32, id: i64): void {
+    const size: i32 = toI32(this.again.length)
+    if ((this.flags[k] & H3_FLAG_AGAIN) !== 0 || this.againCount >= size) {
+      return
+    }
+    this.again[(this.againHead + this.againCount) % size] = id
+    this.againCount = this.againCount + 1
+    this.flags[k] = this.flags[k] | H3_FLAG_AGAIN
+  }
+
+  /** The next event stream `id` has, or H3_NEED_MORE when it has nothing more to say now. */
+  step(id: i64): i32 {
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (k < 0 || k >= toI32(this.slotId.length)) {
+      return H3_NEED_MORE
+    }
+    this.slot = k
+    if (this.slotId[k] === id && (this.flags[k] & H3_FLAG_WT) !== 0) {
+      return this.wtStep(k, id)
+    }
+    const kind: i64 = id & 3
+    if (kind === 3) {
+      return this.ownStream(k)
+    }
+    if (kind === 1) {
+      return H3_NEED_MORE
+    }
+    if (this.slotId[k] !== id) {
+      this.open(k, id)
+    }
+    const phase: i32 = this.phase[k]
+    if (phase >= H3_PHASE_UNI_TYPE) {
+      return this.uniStep(k, id)
+    }
+    return this.requestStep(k, id)
+  }
+
+  /** The state of a stream the client just opened in slot `k`. */
+  open(k: i32, id: i64): void {
+    this.slotId[k] = id
+    this.frameType[k] = H3_SKIP_TYPE
+    this.frameLeft[k] = -1
+    this.dataTotal[k] = 0
+    this.contentLength[k] = -1
+    this.fillLeft[k] = 0
+    this.dataLeft[k] = 0
+    this.flags[k] = 0
+    this.headLen[k] = 0
+    this.pendAt[k] = 0
+    this.pendLen[k] = 0
+    if (!http3IsRequest(id)) {
+      this.phase[k] = H3_PHASE_UNI_TYPE
+      return
+    }
+    this.phase[k] = H3_PHASE_HEADERS
+    if (this.goawayId >= 0 && id >= this.goawayId) {
+      if (this.webtransport) {
+        // A session's new stream may still come after GOAWAY: its first bytes decide.
+        this.flags[k] = H3_FLAG_LATE
+        return
+      }
+      this.reject(k, id)
+      return
+    }
+    this.flags[k] = H3_FLAG_COUNTED
+    this.live = this.live + 1
+  }
+
+  /** §5.2: a request past the GOAWAY this side sent is refused, both ways, unprocessed. */
+  reject(k: i32, id: i64): void {
+    this.quic.streamReset(id, H3_REQUEST_REJECTED)
+    this.quic.streamStopSending(id, H3_REQUEST_REJECTED)
+    this.flags[k] = H3_FLAG_SEND_DONE
+    this.phase[k] = H3_PHASE_DISCARD
+    this.rejected = h3Count(this.rejected)
+  }
+
+  /** One of this side's own streams has news: the client may not stop it (§6.2.1, RFC 9204 §4.2). */
+  ownStream(k: i32): i32 {
+    const stream: QuicStream = this.quic.streams.slots[k]
+    if (stream.stopCode >= 0) {
+      return this.fail(H3_CLOSED_CRITICAL_STREAM)
+    }
+    return H3_NEED_MORE
+  }
+
+  /** Lets a slot's request count as finished once both of its sides are done. */
+  settle(k: i32): void {
+    const done: i32 = H3_FLAG_SEND_DONE | H3_FLAG_RECV_DONE | H3_FLAG_COUNTED
+    if ((this.flags[k] & done) === done) {
+      this.flags[k] = this.flags[k] & ~H3_FLAG_COUNTED
+      this.live = this.live - 1
+    }
+  }
+
+  /** Marks flags on slot `k` and settles it. */
+  mark(k: i32, bits: i32): void {
+    this.flags[k] = this.flags[k] | bits
+    this.settle(k)
+  }
+
+  /**
+   * Reads a frame header of stream `id` into slot `k`'s `head`, a varint at
+   * a time — its first byte, which says its size, then the rest — so a
+   * header split across STREAM frames costs nothing to keep. Answers 1 with
+   * `header` filled, 0 when more is needed, or the `QUIC_STREAM_*` answer
+   * that ended the read.
+   */
+  readHeader(k: i32, id: i64): i32 {
+    const base: i32 = k * H3_HEAD
+    while (this.headLen[k] < H3_HEAD) {
+      const have: i32 = this.headLen[k]
+      // The type's size from its first byte, then the length's from its.
+      let need: i32 = 1
+      if (have > 0) {
+        const typeSize: i32 = h3VarintLength(this.head, base)
+        need = have < typeSize ? typeSize - have : 1
+        if (have > typeSize) {
+          need = typeSize + h3VarintLength(this.head, base + typeSize) - have
+        }
+      }
+      const n: i32 = this.quic.streamRead(id, this.head, base + have, need)
+      if (n <= 0) {
+        return n
+      }
+      this.headLen[k] = have + n
+      if (h3ReadFrameHeader(this.header, this.head, base, this.headLen[k]) > 0) {
+        this.headLen[k] = 0
+        return 1
+      }
+    }
+    return H3_ZERO
+  }
+
+  // ---- Unidirectional streams ------------------------------------------------------
+
+  /** The next event of the client's unidirectional stream `id` in slot `k`. */
+  uniStep(k: i32, id: i64): i32 {
+    while (this.state !== H3_STATE_FAILED) {
+      const phase: i32 = this.phase[k]
+      if (phase === H3_PHASE_UNI_TYPE) {
+        const base: i32 = k * H3_HEAD
+        const n: i32 = this.quic.streamRead(id, this.head, base + this.headLen[k], H3_ONE)
+        if (n !== 1) {
+          // §6.2: a stream may end or be reset before its type; nothing is owed.
+          if (n < 0) {
+            this.phase[k] = H3_PHASE_DONE
+          }
+          return H3_NEED_MORE
+        }
+        this.headLen[k] = this.headLen[k] + 1
+        const type: i64 = h3ReadVarint(this.head, base, base + this.headLen[k])
+        if (type >= 0) {
+          this.headLen[k] = 0
+          const event: i32 = this.typed(k, id, type)
+          if (event !== H3_NEED_MORE) {
+            return event
+          }
+        }
+      } else if (phase === H3_PHASE_CONTROL) {
+        return this.controlStep(k, id)
+      } else if (phase === H3_PHASE_ENCODER || phase === H3_PHASE_DECODER) {
+        const n: i32 = this.quic.streamRead(id, this.data, H3_ZERO, toI32(this.data.length))
+        if (n === 0) {
+          return H3_NEED_MORE
+        }
+        if (n < 0) {
+          return this.fail(H3_CLOSED_CRITICAL_STREAM)
+        }
+        const result: i64 =
+          phase === H3_PHASE_ENCODER
+            ? this.decoder.receiveEncoderStream(this.data, H3_ZERO, n)
+            : this.encoder.receiveDecoderStream(this.data, H3_ZERO, n)
+        if (result !== QPACK_OK) {
+          return this.fail(result)
+        }
+      } else if (phase === H3_PHASE_DISCARD) {
+        return this.discard(k, id)
+      } else {
+        return H3_NEED_MORE
+      }
+    }
+    return H3_ERROR
+  }
+
+  /** The client's unidirectional stream `id` turned out to be of `type` (§6.2). */
+  typed(k: i32, id: i64, type: i64): i32 {
+    if (type === H3_STREAM_CONTROL) {
+      if (this.peerControl >= 0) {
+        return this.fail(H3_STREAM_CREATION_ERROR)
+      }
+      this.peerControl = id
+      this.phase[k] = H3_PHASE_CONTROL
+      return H3_NEED_MORE
+    }
+    if (type === H3_STREAM_QPACK_ENCODER) {
+      if (this.peerEncoder >= 0) {
+        return this.fail(H3_STREAM_CREATION_ERROR)
+      }
+      this.peerEncoder = id
+      this.phase[k] = H3_PHASE_ENCODER
+      return H3_NEED_MORE
+    }
+    if (type === H3_STREAM_QPACK_DECODER) {
+      if (this.peerDecoder >= 0) {
+        return this.fail(H3_STREAM_CREATION_ERROR)
+      }
+      this.peerDecoder = id
+      this.phase[k] = H3_PHASE_DECODER
+      return H3_NEED_MORE
+    }
+    if (type === H3_STREAM_PUSH) {
+      // §6.2.2: only a server pushes.
+      return this.fail(H3_STREAM_CREATION_ERROR)
+    }
+    if (type === H3_STREAM_WEBTRANSPORT && this.webtransport) {
+      // draft-02 §4.1: the session ID follows the type. The stream has no side for this one to write.
+      this.flags[k] = H3_FLAG_WT | H3_FLAG_SEND_DONE
+      this.phase[k] = H3_PHASE_WT_SESSION
+      return this.wtStep(k, id)
+    }
+    // §6.2: a type this side does not know is read and dropped, and its sender asked to stop.
+    this.quic.streamStopSending(id, H3_STREAM_CREATION_ERROR)
+    this.phase[k] = H3_PHASE_DISCARD
+    return H3_NEED_MORE
+  }
+
+  /** Frames on the client's control stream (§6.2.1, §7.2). */
+  controlStep(k: i32, id: i64): i32 {
+    while (this.state !== H3_STATE_FAILED) {
+      if (this.frameLeft[k] < 0) {
+        const got: i32 = this.readHeader(k, id)
+        if (got === 0) {
+          return H3_NEED_MORE
+        }
+        if (got < 0) {
+          return this.fail(H3_CLOSED_CRITICAL_STREAM)
+        }
+        const type: i64 = this.header.type
+        const length: i64 = this.header.length
+        if (!this.settingsSeen && type !== H3_FRAME_SETTINGS) {
+          return this.fail(H3_MISSING_SETTINGS)
+        }
+        if (
+          type === H3_FRAME_DATA ||
+          type === H3_FRAME_HEADERS ||
+          type === H3_FRAME_PUSH_PROMISE ||
+          h3ReservedHttp2Frame(type) ||
+          (type === H3_FRAME_SETTINGS && this.settingsSeen)
+        ) {
+          return this.fail(H3_FRAME_UNEXPECTED)
+        }
+        const whole: boolean =
+          type === H3_FRAME_SETTINGS ||
+          type === H3_FRAME_GOAWAY ||
+          type === H3_FRAME_MAX_PUSH_ID ||
+          type === H3_FRAME_CANCEL_PUSH
+        if (whole && length > toI64(H3_CONTROL_FRAME_MAX)) {
+          return this.fail(type === H3_FRAME_SETTINGS ? H3_EXCESSIVE_LOAD : H3_FRAME_ERROR)
+        }
+        this.frameType[k] = whole ? type : H3_SKIP_TYPE
+        this.frameLeft[k] = length
+        this.controlFill = 0
+      }
+      if (this.frameLeft[k] > 0) {
+        const into: u8[] = this.frameType[k] === H3_SKIP_TYPE ? this.data : this.control
+        const at: i32 = this.frameType[k] === H3_SKIP_TYPE ? H3_ZERO : this.controlFill
+        const want: i32 = toI32(http3Min(this.frameLeft[k], toI64(toI32(into.length) - at)))
+        const n: i32 = this.quic.streamRead(id, into, at, want)
+        if (n === 0) {
+          return H3_NEED_MORE
+        }
+        if (n < 0) {
+          return this.fail(H3_CLOSED_CRITICAL_STREAM)
+        }
+        this.frameLeft[k] = this.frameLeft[k] - toI64(n)
+        if (this.frameType[k] !== H3_SKIP_TYPE) {
+          this.controlFill = this.controlFill + n
+        }
+      }
+      if (this.frameLeft[k] === 0) {
+        this.frameLeft[k] = -1
+        const event: i32 = this.controlFrame(this.frameType[k])
+        if (event !== H3_NEED_MORE) {
+          return event
+        }
+      }
+    }
+    return H3_ERROR
+  }
+
+  /** Acts on a whole control frame of `type` in `control[0 .. controlFill)`. */
+  controlFrame(type: i64): i32 {
+    if (type === H3_FRAME_SETTINGS) {
+      const result: i64 = h3ReadSettings(this.peer, this.control, H3_ZERO, this.controlFill)
+      if (result !== H3_SETTINGS_OK) {
+        return this.fail(result)
+      }
+      // RFC 9220 §5 and RFC 9297 §2.1.1: each is 0 or 1.
+      if (this.peer.enableConnectProtocol > 1 || this.peer.h3Datagram > 1) {
+        return this.fail(H3_SETTINGS_ERROR)
+      }
+      this.settingsSeen = true
+      // The requests that waited for these SETTINGS are stepped again.
+      for (let j: i32 = 0; j < this.waitCount && j < toI32(this.waiting.length); j++) {
+        const id: i64 = this.waiting[j]
+        const w: i32 = this.quic.streams.slotOf(id)
+        if (w >= 0 && w < toI32(this.flags.length) && this.slotId[w] === id) {
+          this.flags[w] = this.flags[w] & ~H3_FLAG_WAITING
+          this.stepAgain(w, id)
+        }
+      }
+      this.waitCount = 0
+      return H3_NEED_MORE
+    }
+    if (type === H3_SKIP_TYPE) {
+      return H3_NEED_MORE
+    }
+    const value: i64 = h3ReadIdPayload(this.control, H3_ZERO, this.controlFill)
+    if (value < 0) {
+      return this.fail(H3_FRAME_ERROR)
+    }
+    if (type === H3_FRAME_GOAWAY) {
+      // §5.2: a client's GOAWAY names a push ID, which may only fall.
+      if (this.peerGoaway >= 0 && value > this.peerGoaway) {
+        return this.fail(H3_ID_ERROR)
+      }
+      this.peerGoaway = value
+      this.lastStreamId = value
+      return H3_GOAWAY
+    }
+    if (type === H3_FRAME_MAX_PUSH_ID) {
+      // §7.2.7: it may not fall. This side never pushes, so that is all it means.
+      if (value < this.maxPushId) {
+        return this.fail(H3_ID_ERROR)
+      }
+      this.maxPushId = value
+      return H3_NEED_MORE
+    }
+    // CANCEL_PUSH (§7.2.3): no push was ever promised, so only one past the
+    // push IDs allowed is an error; any other is a no-op.
+    return value > this.maxPushId ? this.fail(H3_ID_ERROR) : H3_NEED_MORE
+  }
+
+  /** Reads and drops what is left of stream `id`, slot `k`, to its end or reset. */
+  discard(k: i32, id: i64): i32 {
+    const n: i32 = this.drop(id)
+    if (n < 0) {
+      this.phase[k] = H3_PHASE_DONE
+      this.mark(k, H3_FLAG_RECV_DONE)
+    }
+    return this.writable(k, id)
+  }
+
+  /** Reads stream `id` into `data` until nothing more is there; answers 0, or the `QUIC_STREAM_*` that ended it. */
+  drop(id: i64): i32 {
+    let n: i32 = this.quic.streamRead(id, this.data, H3_ZERO, toI32(this.data.length))
+    while (n > 0) {
+      n = this.quic.streamRead(id, this.data, H3_ZERO, toI32(this.data.length))
+    }
+    return n
+  }
+
+  // ---- WebTransport streams ----------------------------------------------------------
+
+  /**
+   * Stream `id`, slot `k`, named session `session` in its first bytes: it is
+   * held, unread, and the program told with H3_STREAM. A session ID that is
+   * not a client-initiated bidirectional stream is H3_ID_ERROR (draft-02 §4).
+   */
+  held(k: i32, id: i64, session: i64): i32 {
+    if (!http3IsRequest(session)) {
+      return this.fail(H3_ID_ERROR)
+    }
+    if (this.goawayId >= 0 && session >= this.goawayId) {
+      // A session at or past this side's GOAWAY can never come (its CONNECT is refused), so its stream is gone.
+      this.abandon(k, id, H3_WT_SESSION_GONE)
+      this.stopReading(k, id, H3_WT_SESSION_GONE)
+      this.rejected = h3Count(this.rejected)
+      return H3_NEED_MORE
+    }
+    this.phase[k] = H3_PHASE_WT_HELD
+    this.frameLeft[k] = -1
+    this.stream = id
+    this.session = session
+    return H3_STREAM
+  }
+
+  /**
+   * The next event of WebTransport stream `id` in slot `k`: its session ID
+   * (a unidirectional stream's), then its bytes as H3_DATA, H3_END at its
+   * FIN and H3_RESET at the client's RESET_STREAM; H3_STOPPED once for the
+   * client's STOP_SENDING; and H3_WRITABLE.
+   */
+  wtStep(k: i32, id: i64): i32 {
+    const stream: QuicStream = this.quic.streams.slots[k]
+    if (stream.stopCode >= 0 && (this.flags[k] & H3_FLAG_SEND_DONE) === 0) {
+      this.mark(k, H3_FLAG_SEND_DONE)
+      this.stream = id
+      this.errorCode = stream.stopCode
+      return H3_STOPPED
+    }
+    const phase: i32 = this.phase[k]
+    if (phase === H3_PHASE_WT_SESSION) {
+      const base: i32 = k * H3_HEAD
+      while (this.headLen[k] < 8) {
+        const n: i32 = this.quic.streamRead(id, this.head, base + this.headLen[k], H3_ONE)
+        if (n !== 1) {
+          // Ended or reset before its session ID: nothing is owed (§6.2).
+          if (n < 0) {
+            this.phase[k] = H3_PHASE_DONE
+            this.mark(k, H3_FLAG_RECV_DONE)
+          }
+          return H3_NEED_MORE
+        }
+        this.headLen[k] = this.headLen[k] + 1
+        const session: i64 = h3ReadVarint(this.head, base, base + this.headLen[k])
+        if (session >= 0) {
+          this.headLen[k] = 0
+          return this.held(k, id, session)
+        }
+      }
+      return H3_NEED_MORE
+    }
+    if (phase === H3_PHASE_WT) {
+      if ((this.flags[k] & H3_FLAG_RECV_DONE) === 0) {
+        const resetCode: i64 = stream.resetCode
+        const n: i32 = this.quic.streamRead(id, this.data, H3_ZERO, toI32(this.data.length))
+        if (n > 0) {
+          this.stream = id
+          this.dataStart = 0
+          this.dataLength = n
+          return H3_DATA
+        }
+        if (n < 0) {
+          this.phase[k] = H3_PHASE_DONE
+          this.mark(k, H3_FLAG_RECV_DONE)
+          if (n === QUIC_STREAM_END) {
+            this.stream = id
+            return H3_END
+          }
+          if (n === QUIC_STREAM_ERR_RESET) {
+            return this.resetEvent(id, resetCode, true)
+          }
+        }
+      }
+      return this.writable(k, id)
+    }
+    if (phase === H3_PHASE_DISCARD) {
+      return this.discard(k, id)
+    }
+    return phase === H3_PHASE_DONE ? this.writable(k, id) : H3_NEED_MORE
+  }
+
+  /** The slot of WebTransport stream `id` when it is known here, else -1. */
+  wtSlot(id: i64): i32 {
+    if (this.state === H3_STATE_FAILED) {
+      return -1
+    }
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (
+      k < 0 ||
+      k >= toI32(this.slotId.length) ||
+      this.slotId[k] !== id ||
+      (this.flags[k] & H3_FLAG_WT) === 0
+    ) {
+      return -1
+    }
+    return k
+  }
+
+  /**
+   * Lets a stream H3_STREAM held go: its bytes come as H3_DATA from the next
+   * `next()`, and the program may write it. Answers 0, or H3_CLOSED for a
+   * stream that is not one held.
+   */
+  acceptStream(id: i64): i32 {
+    const k: i32 = this.wtSlot(id)
+    if (k < 0 || this.phase[k] !== H3_PHASE_WT_HELD) {
+      return H3_CLOSED
+    }
+    this.phase[k] = H3_PHASE_WT
+    this.stepAgain(k, id)
+    return 0
+  }
+
+  /**
+   * Refuses WebTransport stream `id` with `code`: its side here is reset,
+   * the client's asked to stop, and what it sent read and dropped. Answers 0,
+   * or H3_CLOSED for a stream that is not a WebTransport one.
+   */
+  refuseStream(id: i64, code: i64): i32 {
+    const k: i32 = this.wtSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    this.abandon(k, id, code)
+    this.stopReading(k, id, code)
+    return 0
+  }
+
+  /** Asks the client to stop stream `id`, slot `k`, with `code`, and drops what it still sends, unless its side is over or being dropped. */
+  stopReading(k: i32, id: i64, code: i64): void {
+    if (this.phase[k] !== H3_PHASE_DONE && this.phase[k] !== H3_PHASE_DISCARD) {
+      this.quic.streamStopSending(id, code)
+      this.phase[k] = H3_PHASE_DISCARD
+      this.stepAgain(k, id)
+    }
+  }
+
+  /**
+   * Opens a WebTransport stream of this side's for `session` (draft-02
+   * §4.1, §4.2): unidirectional with the type 0x54, or bidirectional with
+   * the signal 0x41, and the session ID, which go before anything written.
+   * Answers its ID, H3_AGAIN while the client's MAX_STREAMS allows no more,
+   * or H3_CLOSED with WebTransport off or the connection failed.
+   */
+  openStream(session: i64, bidirectional: boolean): i64 {
+    if (!this.webtransport || this.state === H3_STATE_FAILED || !http3IsRequest(session) || session < 0) {
+      return toI64(H3_CLOSED)
+    }
+    const id: i64 = this.quic.openStream(bidirectional)
+    const k: i32 = id >= 0 ? this.quic.streams.slotOf(id) : H3_NONE32
+    if (k < 0 || k >= toI32(this.slotId.length)) {
+      return toI64(H3_AGAIN)
+    }
+    this.open(k, id)
+    // A unidirectional stream of this side's has no side for the client to write.
+    this.flags[k] = bidirectional ? H3_FLAG_WT : H3_FLAG_WT | H3_FLAG_RECV_DONE
+    this.phase[k] = bidirectional ? H3_PHASE_WT : H3_PHASE_DONE
+    const end: i32 = toI32(this.scratch.length)
+    const p: i32 = h3PutVarint(
+      this.scratch,
+      H3_ZERO,
+      end,
+      bidirectional ? H3_FRAME_WEBTRANSPORT_STREAM : H3_STREAM_WEBTRANSPORT
+    )
+    this.owe(k, this.scratch, h3PutVarint(this.scratch, p, end, session))
+    if (!this.drain(k, id)) {
+      this.mark(k, H3_FLAG_BLOCKED)
+    }
+    return id
+  }
+
+  /**
+   * Writes up to `len` bytes of `buf` from `off` to WebTransport stream `id`,
+   * as they are, and its FIN when `fin` and every byte was taken. Answers how
+   * many it took — fewer only when the send buffer filled, and H3_WRITABLE
+   * then names the stream — or H3_AGAIN when it took none, or H3_CLOSED for
+   * a stream with no side here to write, finished, reset, held or stopped.
+   */
+  writeStream(id: i64, buf: u8[], off: i32, len: i32, fin: boolean): i32 {
+    h3CheckWindow("Http3Connection.writeStream", buf, off, len)
+    const k: i32 = this.wtSlot(id)
+    if (
+      k < 0 ||
+      (this.flags[k] & H3_FLAG_SEND_DONE) !== 0 ||
+      this.phase[k] === H3_PHASE_WT_HELD ||
+      this.quic.streams.slots[k].stopCode >= 0
+    ) {
+      return H3_CLOSED
+    }
+    if (!this.drain(k, id)) {
+      this.mark(k, H3_FLAG_BLOCKED)
+      return H3_AGAIN
+    }
+    const n: i32 = this.quic.streamWrite(id, buf, off, len, fin)
+    if (n < 0) {
+      return H3_CLOSED
+    }
+    if (n < len) {
+      this.mark(k, H3_FLAG_BLOCKED)
+    } else if (fin) {
+      this.mark(k, H3_FLAG_SEND_DONE)
+    }
+    return n > 0 || (fin && len === 0) ? n : H3_AGAIN
+  }
+
+  /** Resets this side of WebTransport stream `id` with `code`; the client's side goes on. Answers 0 or H3_CLOSED. */
+  resetStream(id: i64, code: i64): i32 {
+    const k: i32 = this.wtSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    this.abandon(k, id, code)
+    return 0
+  }
+
+  /**
+   * Asks the client to stop its side of WebTransport stream `id` with
+   * `code`, and drops what it still sends; this side's goes on. Answers 0 or
+   * H3_CLOSED.
+   */
+  stopStream(id: i64, code: i64): i32 {
+    const k: i32 = this.wtSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    this.stopReading(k, id, code)
+    return 0
+  }
+
+  // ---- Request streams ------------------------------------------------------------
+
+  /** The next event of request stream `id` in slot `k`. */
+  requestStep(k: i32, id: i64): i32 {
+    const stream: QuicStream = this.quic.streams.slots[k]
+    while (this.state !== H3_STATE_FAILED) {
+      const phase: i32 = this.phase[k]
+      if (stream.stopCode >= 0 && (this.flags[k] & H3_FLAG_SEND_DONE) === 0) {
+        // The client stopped the response (QUIC answered with RESET_STREAM, §3.5 of RFC 9000).
+        const told: boolean = (this.flags[k] & H3_FLAG_DELIVERED) !== 0
+        this.mark(k, H3_FLAG_SEND_DONE)
+        if (told) {
+          if (phase !== H3_PHASE_DONE) {
+            this.phase[k] = H3_PHASE_DISCARD
+          }
+          return this.resetEvent(id, stream.stopCode, true)
+        }
+      }
+      if (phase === H3_PHASE_DONE) {
+        return this.writable(k, id)
+      }
+      if (phase === H3_PHASE_DISCARD) {
+        return this.discard(k, id)
+      }
+      if (this.webtransport && !this.settingsSeen && phase === H3_PHASE_HEADERS && this.headLen[k] === 0) {
+        // draft-02 §3.1: with WebTransport on, a request waits for the client's SETTINGS, which say whether it may be a session.
+        if ((this.flags[k] & H3_FLAG_WAITING) === 0 && this.waitCount < toI32(this.waiting.length)) {
+          this.waiting[this.waitCount] = id
+          this.waitCount = this.waitCount + 1
+          this.flags[k] = this.flags[k] | H3_FLAG_WAITING
+        }
+        return H3_NEED_MORE
+      }
+      if (this.frameLeft[k] < 0) {
+        const event: i32 = this.requestFrame(k, id)
+        if (event === H3_CONTINUE) {
+          continue
+        }
+        if (event !== H3_NEED_MORE) {
+          return event
+        }
+        // The header is not all in yet, unless the stream moved on to another phase.
+        if (this.phase[k] === phase) {
+          return this.writable(k, id)
+        }
+        continue
+      }
+      const type: i64 = this.frameType[k]
+      if (type === H3_FRAME_HEADERS) {
+        // A field section is decoded whole: wait until all of it is in.
+        if (stream.resetCode < 0 && stream.readable() < this.frameLeft[k]) {
+          if (stream.recvFinal >= 0 && stream.recvRead + this.frameLeft[k] > stream.recvFinal) {
+            return this.fail(H3_FRAME_ERROR)
+          }
+          return this.writable(k, id)
+        }
+        const length: i32 = toI32(this.frameLeft[k])
+        const n: i32 = this.quic.streamRead(id, this.section, H3_ZERO, length)
+        if (n < 0) {
+          return this.ended(k, id, n, stream.resetCode)
+        }
+        if (n !== length) {
+          return this.writable(k, id)
+        }
+        this.frameLeft[k] = -1
+        const event: i32 = this.fieldSection(k, id, length)
+        if (event !== H3_NEED_MORE) {
+          return event
+        }
+        continue
+      }
+      // DATA, a payload being skipped, or an unknown frame's.
+      const want: i32 = toI32(http3Min(this.frameLeft[k], toI64(toI32(this.data.length))))
+      const resetCode: i64 = stream.resetCode
+      const n: i32 = this.quic.streamRead(id, this.data, H3_ZERO, want)
+      if (n === 0) {
+        return this.writable(k, id)
+      }
+      if (n < 0) {
+        return n === QUIC_STREAM_END ? this.fail(H3_FRAME_ERROR) : this.ended(k, id, n, resetCode)
+      }
+      this.frameLeft[k] = this.frameLeft[k] - toI64(n)
+      if (type === H3_FRAME_DATA) {
+        if (this.frameLeft[k] === 0) {
+          this.frameLeft[k] = -1
+        }
+        this.dataTotal[k] = this.dataTotal[k] + toI64(n)
+        if (this.contentLength[k] >= 0 && this.dataTotal[k] > this.contentLength[k]) {
+          return this.streamError(k, id, H3_MESSAGE_ERROR)
+        }
+        this.stream = id
+        this.dataStart = 0
+        this.dataLength = n
+        return H3_DATA
+      }
+      if (this.frameLeft[k] === 0) {
+        this.frameLeft[k] = -1
+        if (this.phase[k] === H3_PHASE_SKIP) {
+          return this.answerTooLarge(k, id)
+        }
+      }
+    }
+    return H3_ERROR
+  }
+
+  /**
+   * Reads the next frame header of request stream `id` and decides what its
+   * payload is (§4.1, §7.2): DATA after HEADERS, HEADERS first or as
+   * trailers, and anything else unknown and skipped, or refused where
+   * RFC 9114 says so. A stream that ends here ends the request.
+   */
+  requestFrame(k: i32, id: i64): i32 {
+    const stream: QuicStream = this.quic.streams.slots[k]
+    const resetCode: i64 = stream.resetCode
+    const got: i32 = this.readHeader(k, id)
+    if (got === 0) {
+      return H3_NEED_MORE
+    }
+    if (got < 0) {
+      if (got === QUIC_STREAM_END && this.headLen[k] > 0) {
+        return this.fail(H3_FRAME_ERROR)
+      }
+      if ((this.flags[k] & H3_FLAG_LATE) !== 0) {
+        this.reject(k, id)
+        return this.dropped(id)
+      }
+      return this.ended(k, id, got, resetCode)
+    }
+    const type: i64 = this.header.type
+    const length: i64 = this.header.length
+    const phase: i32 = this.phase[k]
+    if (type === H3_FRAME_WEBTRANSPORT_STREAM && this.webtransport) {
+      if (phase !== H3_PHASE_HEADERS) {
+        // draft-02 §4.2: the signal opens a stream, and is nothing anywhere else.
+        return this.fail(H3_FRAME_ERROR)
+      }
+      // Its "length" is the session ID. A stream past this side's GOAWAY counts once it is held, for a session below it.
+      this.flags[k] = this.flags[k] | H3_FLAG_WT
+      const event: i32 = this.held(k, id, length)
+      if (event === H3_STREAM && (this.flags[k] & H3_FLAG_LATE) !== 0) {
+        this.flags[k] = (this.flags[k] & ~H3_FLAG_LATE) | H3_FLAG_COUNTED
+        this.live = this.live + 1
+      }
+      return event
+    }
+    if ((this.flags[k] & H3_FLAG_LATE) !== 0) {
+      this.reject(k, id)
+      return this.dropped(id)
+    }
+    if (type === H3_FRAME_DATA) {
+      if (phase !== H3_PHASE_BODY) {
+        return this.fail(H3_FRAME_UNEXPECTED)
+      }
+      this.frameType[k] = type
+      this.frameLeft[k] = length > 0 ? length : -1
+      return H3_CONTINUE
+    }
+    if (type === H3_FRAME_HEADERS) {
+      if (phase === H3_PHASE_TRAILED) {
+        return this.fail(H3_FRAME_UNEXPECTED)
+      }
+      if (length > toI64(this.config.maxFieldSectionSize)) {
+        if (phase === H3_PHASE_HEADERS) {
+          // §4.2.2: the section is skipped and answered with a 431.
+          this.phase[k] = H3_PHASE_SKIP
+          this.frameType[k] = H3_SKIP_TYPE
+          this.frameLeft[k] = length
+          return H3_CONTINUE
+        }
+        return this.streamError(k, id, H3_EXCESSIVE_LOAD)
+      }
+      this.frameType[k] = type
+      this.frameLeft[k] = length
+      if (length === 0) {
+        // An empty section has no prefix, which QPACK refuses.
+        this.frameLeft[k] = -1
+        return this.fieldSection(k, id, H3_ZERO)
+      }
+      return H3_CONTINUE
+    }
+    if (
+      type === H3_FRAME_SETTINGS ||
+      type === H3_FRAME_GOAWAY ||
+      type === H3_FRAME_MAX_PUSH_ID ||
+      type === H3_FRAME_CANCEL_PUSH ||
+      type === H3_FRAME_PUSH_PROMISE ||
+      h3ReservedHttp2Frame(type)
+    ) {
+      return this.fail(H3_FRAME_UNEXPECTED)
+    }
+    // §9: an unknown frame type is skipped, wherever it comes.
+    this.frameType[k] = H3_SKIP_TYPE
+    this.frameLeft[k] = length > 0 ? length : -1
+    return H3_CONTINUE
+  }
+
+  /**
+   * A whole HEADERS payload of `length` bytes is in `section`: the request's
+   * field section, or its trailers. Decodes it, copies it into `fields` and
+   * checks it there.
+   */
+  fieldSection(k: i32, id: i64, length: i32): i32 {
+    const result: i64 = this.decoder.decode(this.section, H3_ZERO, length)
+    const first: boolean = this.phase[k] === H3_PHASE_HEADERS
+    if (result === QPACK_SECTION_TOO_LARGE) {
+      return first ? this.answerTooLarge(k, id) : this.streamError(k, id, H3_EXCESSIVE_LOAD)
+    }
+    if (result !== QPACK_OK) {
+      return this.fail(result)
+    }
+    this.copyFields()
+    if (!first) {
+      if (this.fields.readTrailers(this.nameList, this.valueList) !== HTTP_FIELDS_OK) {
+        return this.streamError(k, id, H3_MESSAGE_ERROR)
+      }
+      this.phase[k] = H3_PHASE_TRAILED
+      this.stream = id
+      return H3_TRAILERS
+    }
+    if (this.fields.readRequest(this.nameList, this.valueList, this.connect) !== HTTP_FIELDS_OK) {
+      return this.streamError(k, id, H3_MESSAGE_ERROR)
+    }
+    // An extended CONNECT reaches the program like any request, `fields.protocol` set:
+    // `nish/net/webtransport` makes a session of one whose protocol is `webtransport`.
+    this.contentLength[k] = this.fields.contentLength
+    this.phase[k] = H3_PHASE_BODY
+    this.flags[k] = this.flags[k] | H3_FLAG_DELIVERED
+    this.stream = id
+    return H3_REQUEST
+  }
+
+  /** Copies the decoder's fields into the connection's own arrays and the lists `fields` reads. */
+  copyFields(): void {
+    const d: QpackDecoder = this.decoder
+    http3EmptyList(this.nameList)
+    http3EmptyList(this.valueList)
+    this.poolUsed.fill(H3_ZERO)
+    for (let i: i32 = 0; i < d.count; i++) {
+      this.nameList.push(this.copyOf(d, d.nameStart[i], d.nameLength[i]))
+      this.valueList.push(this.copyOf(d, d.valueStart[i], d.valueLength[i]))
+    }
+  }
+
+  /**
+   * A copy of the decoder's bytes `[start, start + length)`, in an array of
+   * the size class `length` falls in: class `j` holds arrays made with room
+   * for 2^j bytes, for strings shorter than that and at least half as long.
+   * A section takes the arrays of each class in order and the next takes the
+   * same ones again, so a class grows only when one section needs more of its
+   * size than any before it, and the total stays bounded by the field-section
+   * cap (`docs/security/http3.md`, H3-2).
+   */
+  copyOf(d: QpackDecoder, start: i32, length: i32): u8[] {
+    let j: i32 = 0
+    while (j < H3_FIELD_CLASSES - 1 && 1 << j <= length) {
+      j++
+    }
+    const pool: u8[][] = this.pools[j]
+    const used: i32 = this.poolUsed[j]
+    if (used >= toI32(pool.length)) {
+      // Made with room for the class, then emptied below like any reused one.
+      pool.push(new Array<u8>(1 << j))
+    }
+    this.poolUsed[j] = used + 1
+    const out: u8[] = pool[used]
+    http3Empty(out)
+    const from: i32 = start > 0 ? start : H3_ZERO
+    const end: i32 = start + length < toI32(d.bytes.length) ? start + length : toI32(d.bytes.length)
+    for (let k: i32 = from; k < end; k++) {
+      out.push(d.bytes[k])
+    }
+    return out
+  }
+
+  /**
+   * The request stream ended, cleanly (`n` is `QUIC_STREAM_END`) or by the
+   * client's RESET_STREAM with `resetCode`, at a frame boundary.
+   */
+  ended(k: i32, id: i64, n: i32, resetCode: i64): i32 {
+    const phase: i32 = this.phase[k]
+    this.phase[k] = H3_PHASE_DONE
+    this.mark(k, H3_FLAG_RECV_DONE)
+    const delivered: boolean = (this.flags[k] & H3_FLAG_DELIVERED) !== 0
+    if (n === QUIC_STREAM_ERR_RESET) {
+      // §4.1.1: a response to a request that will not finish is abandoned too.
+      this.abandon(k, id, resetCode === H3_REQUEST_CANCELLED ? H3_REQUEST_CANCELLED : H3_REQUEST_INCOMPLETE)
+      return delivered ? this.resetEvent(id, resetCode, true) : this.dropped(id)
+    }
+    if (n !== QUIC_STREAM_END) {
+      return H3_NEED_MORE
+    }
+    if (phase === H3_PHASE_HEADERS || phase === H3_PHASE_SKIP) {
+      // §4.1.1: the stream ended before a whole request.
+      this.abandon(k, id, H3_REQUEST_INCOMPLETE)
+      this.streamErrors = h3Count(this.streamErrors)
+      return this.dropped(id)
+    }
+    if (this.contentLength[k] >= 0 && this.dataTotal[k] !== this.contentLength[k]) {
+      // §4.1.2: the body is shorter than its content-length.
+      this.abandon(k, id, H3_MESSAGE_ERROR)
+      this.streamErrors = h3Count(this.streamErrors)
+      return this.resetEvent(id, H3_MESSAGE_ERROR, false)
+    }
+    this.stream = id
+    return H3_END
+  }
+
+  /** Resets this side's half of request stream `id` with `code`, unless it is done already. */
+  abandon(k: i32, id: i64, code: i64): void {
+    if ((this.flags[k] & H3_FLAG_SEND_DONE) === 0) {
+      this.quic.streamReset(id, code)
+    }
+    this.mark(k, H3_FLAG_SEND_DONE)
+  }
+
+  /** A stream error (§8): the request is reset both ways with `code`, and the program told when it knew the request. */
+  streamError(k: i32, id: i64, code: i64): i32 {
+    this.streamErrors = h3Count(this.streamErrors)
+    this.abandon(k, id, code)
+    this.quic.streamStopSending(id, code)
+    this.phase[k] = H3_PHASE_DISCARD
+    if ((this.flags[k] & H3_FLAG_DELIVERED) !== 0) {
+      return this.resetEvent(id, code, false)
+    }
+    return this.dropped(id)
+  }
+
+  /** H3_DROPPED for request stream `id` with WebTransport on, which waits on such a stream; H3_NEED_MORE without. */
+  dropped(id: i64): i32 {
+    if (!this.webtransport) {
+      return H3_NEED_MORE
+    }
+    this.stream = id
+    return H3_DROPPED
+  }
+
+  /** H3_RESET for `id` with `code`. */
+  resetEvent(id: i64, code: i64, byPeer: boolean): i32 {
+    this.stream = id
+    this.errorCode = code
+    this.resetByPeer = byPeer
+    return H3_RESET
+  }
+
+  /**
+   * A request whose field section is past `maxFieldSectionSize`: answered
+   * with a 431 and its stream asked to stop with H3_NO_ERROR (§4.2.2,
+   * §4.1.2). The program never sees it.
+   */
+  answerTooLarge(k: i32, id: i64): i32 {
+    this.tooLarge = h3Count(this.tooLarge)
+    const empty: u8[][] = this.nameList
+    http3EmptyList(empty)
+    if (this.writeHead(k, id, H3_STATUS_TOO_LARGE, empty, empty, true) !== 0) {
+      this.abandon(k, id, H3_EXCESSIVE_LOAD)
+    }
+    this.quic.streamStopSending(id, H3_NO_ERROR)
+    this.phase[k] = H3_PHASE_DISCARD
+    return this.dropped(id)
+  }
+
+  /**
+   * The stream's write side, when a write was held back: owed bytes are
+   * written, and once the buffer has room again the program is told with
+   * H3_WRITABLE. Answers that, or H3_NEED_MORE.
+   */
+  writable(k: i32, id: i64): i32 {
+    if ((this.flags[k] & H3_FLAG_BLOCKED) === 0 || (this.flags[k] & H3_FLAG_SEND_DONE) !== 0) {
+      return H3_NEED_MORE
+    }
+    if (!this.drain(k, id) || this.quic.streams.slots[k].room() <= 0) {
+      return H3_NEED_MORE
+    }
+    this.flags[k] = this.flags[k] & ~H3_FLAG_BLOCKED
+    this.stream = id
+    return H3_WRITABLE
+  }
+
+  // ---- Writing ----------------------------------------------------------------------
+
+  /** The slot of request stream `id` when the program may write to it, else -1. */
+  writeSlot(id: i64): i32 {
+    if (this.state === H3_STATE_FAILED || !http3IsRequest(id)) {
+      return -1
+    }
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (k < 0 || k >= toI32(this.slotId.length) || this.slotId[k] !== id) {
+      return -1
+    }
+    const flags: i32 = this.flags[k]
+    if ((flags & H3_FLAG_DELIVERED) === 0 || (flags & H3_FLAG_SEND_DONE) !== 0) {
+      return -1
+    }
+    return this.quic.streams.slots[k].stopCode >= 0 ? -1 : k
+  }
+
+  /**
+   * Writes the bytes owed on stream `id` before anything else — the rest of
+   * a frame header, a filler's payload — as far as the send buffer takes
+   * them. Answers whether none are owed now.
+   */
+  drain(k: i32, id: i64): boolean {
+    const base: i32 = k * H3_HEAD
+    while (this.pendLen[k] > 0) {
+      const n: i32 = this.quic.streamWrite(id, this.pend, base + this.pendAt[k], this.pendLen[k], false)
+      if (n <= 0) {
+        return false
+      }
+      this.pendAt[k] = this.pendAt[k] + n
+      this.pendLen[k] = this.pendLen[k] - n
+    }
+    while (this.fillLeft[k] > 0) {
+      const want: i32 = toI32(http3Min(this.fillLeft[k], toI64(toI32(this.zeros.length))))
+      const n: i32 = this.quic.streamWrite(id, this.zeros, H3_ZERO, want, false)
+      if (n <= 0) {
+        return false
+      }
+      this.fillLeft[k] = this.fillLeft[k] - toI64(n)
+    }
+    return true
+  }
+
+  /** Queues `buf[0 .. n)`, a frame header, as the bytes owed first on slot `k`. */
+  owe(k: i32, buf: u8[], n: i32): void {
+    const base: i32 = k * H3_HEAD
+    for (let j: i32 = 0; j < n && j < H3_HEAD && j < toI32(buf.length); j++) {
+      this.pend[base + j] = buf[j]
+    }
+    this.pendAt[k] = 0
+    this.pendLen[k] = n < H3_HEAD ? n : H3_HEAD
+  }
+
+  /**
+   * A frame of `need` bytes must go whole and the send buffer has less room:
+   * the room left is filled with a reserved frame the client skips (§7.2.8),
+   * so that QUIC names the stream again once acknowledgements free room.
+   */
+  arm(k: i32, id: i64): void {
+    const stream: QuicStream = this.quic.streams.slots[k]
+    const room: i64 = stream.room()
+    this.mark(k, H3_FLAG_BLOCKED)
+    if (room > 0) {
+      // A reserved frame of exactly `room` bytes: its type, its length in
+      // the varint size that makes the sum come out (RFC 9000 §16 lets a
+      // varint be longer than it needs), and zeros. One byte of room cannot
+      // hold a frame, so it takes the type and owes the length.
+      let size: i32 = 1
+      if (room > 65) {
+        size = 2
+      }
+      if (room > 16386) {
+        size = 4
+      }
+      const payload: i64 = room > 1 ? room - toI64(1 + size) : toI64(0)
+      this.scratch[0] = toU8(H3_FILLER_TYPE)
+      const n: i32 = quicVarintPut(this.scratch, H3_ONE, payload, size)
+      this.owe(k, this.scratch, n)
+      this.fillLeft[k] = payload
+      if (!this.drain(k, id)) {
+        return
+      }
+    }
+    // The room is filled: a write that takes nothing asks QUIC for the event.
+    if (stream.room() === toI64(0)) {
+      this.quic.streamWrite(id, this.zeros, H3_ZERO, H3_ONE, false)
+    }
+  }
+
+  /**
+   * Encodes `:status` (unless it is 0, for trailers) and `names`/`values` into a HEADERS
+   * frame and writes it whole to stream `id`, with the FIN when `fin`.
+   * Answers 0, H3_AGAIN, or H3_TOO_LARGE.
+   */
+  writeHead(k: i32, id: i64, status: i32, names: u8[][], values: u8[][], fin: boolean): i32 {
+    const out: u8[] = this.encoded
+    http3Empty(out)
+    this.encoder.beginSection(out)
+    let size: i64 = 0
+    if (status > 0) {
+      const ten: i32 = 10
+      this.statusValue[0] = toU8(H3_DIGIT_ZERO + status / (ten * ten))
+      this.statusValue[1] = toU8(H3_DIGIT_ZERO + ((status / ten) % ten))
+      this.statusValue[2] = toU8(H3_DIGIT_ZERO + (status % ten))
+      const nameLength: i32 = toI32(this.statusName.length)
+      const valueLength: i32 = toI32(this.statusValue.length)
+      this.encoder.encodeField(
+        out,
+        this.statusName,
+        H3_ZERO,
+        nameLength,
+        this.statusValue,
+        H3_ZERO,
+        valueLength,
+        false,
+        true
+      )
+      size = toI64(nameLength + valueLength + QPACK_FIELD_OVERHEAD)
+    }
+    const n: i32 = toI32(names.length)
+    for (let j: i32 = 0; j < n && j < toI32(names.length) && j < toI32(values.length); j++) {
+      const name: u8[] = names[j]
+      const value: u8[] = values[j]
+      const nl: i32 = toI32(name.length)
+      const vl: i32 = toI32(value.length)
+      this.encoder.encodeField(out, name, H3_ZERO, nl, value, H3_ZERO, vl, httpFieldSensitive(name), true)
+      size = size + toI64(nl + vl + QPACK_FIELD_OVERHEAD)
+    }
+    const limit: i64 = this.peer.maxFieldSectionSize
+    const length: i64 = toI64(toI32(out.length))
+    const total: i64 = toI64(h3FrameHeaderSize(H3_FRAME_HEADERS, length)) + length
+    if ((limit >= 0 && size > limit) || total > toI64(this.quic.streams.bufferSize)) {
+      return H3_TOO_LARGE
+    }
+    if (!this.drain(k, id)) {
+      this.mark(k, H3_FLAG_BLOCKED)
+      return H3_AGAIN
+    }
+    if (this.quic.streams.slots[k].room() < total) {
+      this.arm(k, id)
+      return H3_AGAIN
+    }
+    const hp: i32 = h3PutFrameHeader(
+      this.scratch,
+      H3_ZERO,
+      toI32(this.scratch.length),
+      H3_FRAME_HEADERS,
+      length
+    )
+    this.quic.streamWrite(id, this.scratch, H3_ZERO, hp, false)
+    this.quic.streamWrite(id, out, H3_ZERO, toI32(length), fin)
+    this.flags[k] = this.flags[k] | H3_FLAG_HEADERS_SENT
+    if (fin) {
+      this.mark(k, H3_FLAG_SEND_DONE)
+    }
+    return 0
+  }
+
+  /**
+   * Sends the response head on request stream `id`: `status` (200 to 599)
+   * and the fields `names`/`values` (lowercase names, no pseudo-headers),
+   * ending the stream when `endStream`. Answers 0; H3_CLOSED for a stream
+   * that is not an open request; H3_INVALID for a second head, a status out
+   * of range or a field `httpFieldsCheckOutgoing` refuses; H3_TOO_LARGE for a
+   * section past the client's SETTINGS_MAX_FIELD_SECTION_SIZE; or H3_AGAIN.
+   */
+  respond(id: i64, status: i32, names: u8[][], values: u8[][], endStream: boolean): i32 {
+    const k: i32 = this.writeSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    if (
+      (this.flags[k] & H3_FLAG_HEADERS_SENT) !== 0 ||
+      status < 200 ||
+      status > 599 ||
+      httpFieldsCheckOutgoing(names, values) !== HTTP_FIELDS_OK
+    ) {
+      return H3_INVALID
+    }
+    return this.writeHead(k, id, status, names, values, endStream)
+  }
+
+  /**
+   * Writes a trailer section on request stream `id` after its body, which
+   * ends the stream. Answers as `respond` does; H3_INVALID before the head
+   * or inside a DATA frame `writeData` has not finished.
+   */
+  writeTrailers(id: i64, names: u8[][], values: u8[][]): i32 {
+    const k: i32 = this.writeSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    if (
+      (this.flags[k] & H3_FLAG_HEADERS_SENT) === 0 ||
+      this.dataLeft[k] > 0 ||
+      httpFieldsCheckOutgoing(names, values) !== HTTP_FIELDS_OK
+    ) {
+      return H3_INVALID
+    }
+    return this.writeHead(k, id, H3_ZERO, names, values, true)
+  }
+
+  /**
+   * Writes up to `len` bytes of `buf` from `off` as the response body of
+   * stream `id`, in DATA frames of at most `writeChunk`, and ends the stream
+   * when `endStream` and every byte was taken. Answers how many bytes it
+   * took — fewer than `len` only when the send buffer filled, and
+   * H3_WRITABLE then names the stream once it has room — or H3_AGAIN when it
+   * took none;
+   * H3_CLOSED, or H3_INVALID before the head or when `endStream` would cut
+   * short the DATA frame the last call started.
+   */
+  writeData(id: i64, buf: u8[], off: i32, len: i32, endStream: boolean): i32 {
+    h3CheckWindow("Http3Connection.writeData", buf, off, len)
+    const k: i32 = this.writeSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    if ((this.flags[k] & H3_FLAG_HEADERS_SENT) === 0 || (endStream && toI64(len) < this.dataLeft[k])) {
+      return H3_INVALID
+    }
+    if (!this.drain(k, id)) {
+      this.mark(k, H3_FLAG_BLOCKED)
+      return H3_AGAIN
+    }
+    if (len === 0) {
+      if (endStream && this.dataLeft[k] === 0) {
+        this.quic.streamWrite(id, this.zeros, H3_ZERO, H3_ZERO, true)
+        this.mark(k, H3_FLAG_SEND_DONE)
+      }
+      return 0
+    }
+    // DATA frame after DATA frame, until every byte is taken or the send buffer is full.
+    let total: i32 = 0
+    while (total < len) {
+      if (this.dataLeft[k] === 0) {
+        const rest: i32 = len - total
+        const frame: i64 = toI64(rest < this.config.writeChunk ? rest : this.config.writeChunk)
+        const n: i32 = h3PutFrameHeader(
+          this.scratch,
+          H3_ZERO,
+          toI32(this.scratch.length),
+          H3_FRAME_DATA,
+          frame
+        )
+        this.owe(k, this.scratch, n)
+        this.dataLeft[k] = frame
+        if (!this.drain(k, id)) {
+          this.mark(k, H3_FLAG_BLOCKED)
+          break
+        }
+      }
+      const take: i32 = toI32(http3Min(toI64(len - total), this.dataLeft[k]))
+      const fin: boolean = endStream && total + take === len && toI64(take) === this.dataLeft[k]
+      const n: i32 = this.quic.streamWrite(id, buf, off + total, take, fin)
+      if (n < 0) {
+        return total > 0 ? total : H3_CLOSED
+      }
+      this.dataLeft[k] = this.dataLeft[k] - toI64(n)
+      total = total + n
+      if (n < take) {
+        this.mark(k, H3_FLAG_BLOCKED)
+        break
+      }
+      if (fin) {
+        this.mark(k, H3_FLAG_SEND_DONE)
+      }
+    }
+    return total > 0 ? total : H3_AGAIN
+  }
+
+  /**
+   * Writes `buf[off .. off + len)` as one DATA frame on request stream `id`,
+   * whole or not at all, with the FIN when `fin`: a capsule (RFC 9297 §3.2)
+   * goes this way, so the client never reads half of one. Answers 0;
+   * H3_AGAIN while the send buffer lacks room, and H3_WRITABLE then names the
+   * stream; or as `writeData` refuses, and H3_TOO_LARGE for a frame past the
+   * stream's buffer.
+   */
+  writeDataWhole(id: i64, buf: u8[], off: i32, len: i32, fin: boolean): i32 {
+    h3CheckWindow("Http3Connection.writeDataWhole", buf, off, len)
+    const k: i32 = this.writeSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    if ((this.flags[k] & H3_FLAG_HEADERS_SENT) === 0 || this.dataLeft[k] > 0) {
+      return H3_INVALID
+    }
+    const length: i64 = toI64(len)
+    const total: i64 = toI64(h3FrameHeaderSize(H3_FRAME_DATA, length)) + length
+    if (total > toI64(this.quic.streams.bufferSize)) {
+      return H3_TOO_LARGE
+    }
+    if (!this.drain(k, id)) {
+      this.mark(k, H3_FLAG_BLOCKED)
+      return H3_AGAIN
+    }
+    if (this.quic.streams.slots[k].room() < total) {
+      this.arm(k, id)
+      return H3_AGAIN
+    }
+    const hp: i32 = h3PutFrameHeader(this.scratch, H3_ZERO, toI32(this.scratch.length), H3_FRAME_DATA, length)
+    this.quic.streamWrite(id, this.scratch, H3_ZERO, hp, false)
+    this.quic.streamWrite(id, buf, off, len, fin)
+    if (fin) {
+      this.mark(k, H3_FLAG_SEND_DONE)
+    }
+    return 0
+  }
+
+  /**
+   * Resets request stream `id` both ways with `code` — H3_REQUEST_CANCELLED,
+   * or H3_REQUEST_REJECTED for one the program did not process (§4.1.1).
+   * Answers 0 or H3_CLOSED.
+   */
+  reset(id: i64, code: i64): i32 {
+    const k: i32 = this.writeSlot(id)
+    if (k < 0) {
+      return H3_CLOSED
+    }
+    this.abandon(k, id, code)
+    if (this.phase[k] !== H3_PHASE_DONE) {
+      this.quic.streamStopSending(id, code)
+      this.phase[k] = H3_PHASE_DISCARD
+    }
+    return 0
+  }
+
+  /**
+   * Whether request stream `id` has not yet had its field section read:
+   * not opened, opened by a later stream's frame (RFC 9000 §3.2), or still
+   * waiting for its HEADERS. A WebTransport stream that names it as its
+   * session may wait for it.
+   */
+  awaitsRequest(id: i64): boolean {
+    if (!http3IsRequest(id) || id < 0 || (this.goawayId >= 0 && id >= this.goawayId)) {
+      return false
+    }
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (k < 0 || k >= toI32(this.slotId.length)) {
+      // Not opened yet, and one the client's MAX_STREAMS lets it open now.
+      const streams = this.quic.streams
+      return id >= streams.peerBidiOpened << 2 && id < streams.peerBidiLimit << 2
+    }
+    if (this.slotId[k] !== id) {
+      return true
+    }
+    return this.phase[k] === H3_PHASE_HEADERS && (this.flags[k] & H3_FLAG_WT) === 0
+  }
+
+  /**
+   * Stops reading request stream `id`: the client is asked to stop with
+   * `code` and what it still sends is dropped unseen, whether or not this
+   * side has finished its response — a refused WebTransport session's
+   * stream, after its status. Answers 0, or H3_CLOSED for a stream that is
+   * not a request here.
+   */
+  discardRequest(id: i64, code: i64): i32 {
+    if (this.state === H3_STATE_FAILED || !http3IsRequest(id)) {
+      return H3_CLOSED
+    }
+    const k: i32 = this.quic.streams.slotOf(id)
+    if (k < 0 || k >= toI32(this.slotId.length) || this.slotId[k] !== id) {
+      return H3_CLOSED
+    }
+    this.stopReading(k, id, code)
+    return 0
+  }
+
+  /**
+   * Sends GOAWAY (§5.2): the client's requests on streams below the ID it
+   * names — every stream the client has opened so far — are processed, and
+   * any it opens from there on is refused with H3_REQUEST_REJECTED. A second
+   * call never raises the ID, and sends nothing when the ID has not fallen.
+   * Answers 0, or H3_AGAIN before this side's control stream is open or while
+   * it has no room for the frame.
+   */
+  goaway(): i32 {
+    if (this.ownControl < 0 || this.state === H3_STATE_FAILED) {
+      return H3_AGAIN
+    }
+    let id: i64 = this.quic.streams.peerBidiOpened << 2
+    if (this.goawayId >= 0 && id > this.goawayId) {
+      id = this.goawayId
+    }
+    if (id === this.goawayId) {
+      // The client has this ID already: nothing new to say.
+      return 0
+    }
+    const n: i32 = h3PutIdFrame(this.scratch, H3_ZERO, toI32(this.scratch.length), H3_FRAME_GOAWAY, id)
+    const k: i32 = this.quic.streams.slotOf(this.ownControl)
+    // Whole or not at all: half a GOAWAY on the control stream would be a frame error.
+    if (k < 0 || k >= toI32(this.quic.streams.slots.length) || this.quic.streams.slots[k].room() < toI64(n)) {
+      return H3_AGAIN
+    }
+    this.quic.streamWrite(this.ownControl, this.scratch, H3_ZERO, n, false)
+    this.goawayId = id
+    return 0
+  }
+}