Connection status

room.status() (same as room.status.current()) maps the socket onto attach names: attaching, attached, suspended, failed, detached.

subscribe fires { current, previous, retryIn, error } on each change. retryIn is set in milliseconds while the client is reconnecting or suspended.

const room = client.room("lobby");
const { current, change } = useRoomStatus(room);
const { currentStatus, retryIn } = useChatConnection(room.connection);

return (
  <p>
    {current} · socket {currentStatus}
    {retryIn ? ` · retry in ${retryIn}ms` : ""}
  </p>
);

Full page: Room status.

Close reasons map to the error catalog: auth refusals (token_expired, not_member) are terminal, network drops (connection_failed) are not.