Matchmaking reference

Game config

Top level: friends (default on), basePath (default /matchmaking). The queue block is the waiting queue’s dial set; the rest configures the other three ways in.

Routes

Shaped like every route in the kit, and refusing with an ordinary error code.

Every one is user — bearer or session.

There is no public surface. Every route binds to the authenticated user id, never to a client-supplied one. The friend routes mount only when friends is on.

Room codes

WXYZ-1234 — four letters, four digits.

Alphabets exclude I, O, 0 and 1. Join tolerates lowercase, whitespace and a missing dash.

Presence events

{ type: "match_found";    sessionId: string; gameKey: string }
{ type: "invite";         inviteId: string;  gameKey: string; from: string }
{ type: "friend_request"; from: string }

On connect: pending invites, and which friends are online.

Identity is a server-set header, stashed with serializeAttachment so it survives eviction.

Soft ceiling around 1,000 requests per second — one shared object. A throughput ceiling, not a bill.

Bindings

Both classes are exported from their own modules, never the package entry point.

Storage

Queue state is the queue object’s own storage. Presence is the live socket set. Neither is a row you keep.

Error codes

Seams