Phase 3c-1 of the Clubhouse/nests integration. Lands a MoQ-transport
control-plane codec (draft-ietf-moq-transport) and a session wrapper
that runs the SETUP handshake over any WebTransportSession. Purely
commonMain + fully tested end-to-end against FakeWebTransport — no
network or Kwik dependency required.
commonMain (nestsclient.moq):
- `Varint` — QUIC variable-length integer codec per RFC 9000 §16.
Encode/decode/size, with typed truncation handling (decode returns
null so callers can buffer more and retry).
- `MoqWriter` / `MoqReader` — append-only byte writer + bounds-checked
reader used by the message codec.
- `MoqCodecException` — typed error for malformed frames.
- `MoqMessage` sealed class + `MoqMessageType` enum + `SetupParameter`.
Phase 3c-1 covers just `ClientSetup` / `ServerSetup` (message types
0x40 / 0x41).
- `MoqCodec.encode/decode` — wraps payload with `type (varint) +
length (varint)`. Rejects unknown types and trailing bytes inside a
declared payload window.
- `MoqSession.client/server` — attaches to a WebTransportSession and
runs the CLIENT_SETUP / SERVER_SETUP handshake with version
negotiation + configurable timeout.
- `MoqVersion` constants for draft-11 and draft-17.
Tests:
- `VarintTest` — all four RFC 9000 §A.1 sample vectors (1/2/4/8 byte),
boundary round-trips, negative/overflow rejection, short-buffer
returns null, bytesConsumed accuracy.
- `MoqCodecTest` — CLIENT_SETUP / SERVER_SETUP round-trip (empty and
multi-param), multi-version negotiation, exact wire layout for
ServerSetup(1L), truncated-frame returns null, concatenated frames
decode with offset, unknown type rejected, trailing bytes rejected,
zero-length parameter values allowed.
- `MoqSessionTest` — full SETUP exchange over FakeWebTransport (both
sides happy path, client falling back to older version, server
rejecting when no version overlap + client timing out cleanly).
SUBSCRIBE / ANNOUNCE / OBJECT_STREAM / OBJECT_DATAGRAM land in
Phase 3c-2 on top of the same MoqSession.
https://claude.ai/code/session_013nVLALALKaHVgHm9u5Cg8D
Claude
37e24ce4f3