renet2_setup 0.14.0

Setup utilities for renet2
Documentation
use renet2_netcode::{ConnectToken, NetcodeError, ServerCertHash};
use serde::{Deserialize, Serialize};
use serde_with::{serde_as, Bytes};

//-------------------------------------------------------------------------------------------------------------------

pub fn connect_token_to_bytes(connect_token: &ConnectToken) -> Result<Vec<u8>, std::io::Error> {
    let mut bytes = Vec::<u8>::with_capacity(std::mem::size_of::<ConnectToken>());
    connect_token.write(&mut bytes)?;
    Ok(bytes)
}

//-------------------------------------------------------------------------------------------------------------------

pub fn connect_token_from_bytes(connect_token_bytes: &[u8]) -> Result<ConnectToken, NetcodeError> {
    ConnectToken::read(&mut &connect_token_bytes[..])
}

//-------------------------------------------------------------------------------------------------------------------

/// A token that a client can use to connect to a renet2 server.
///
/// Produced by [`ConnectMetas::new_connect_token`] and consumed by `ClientConnectPack::new`.
//todo: how to serialize the connect token more directly to reduce allocations?
#[serde_as]
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ServerConnectToken {
    Native {
        /// A renet2 [`ConnectToken`].
        #[serde_as(as = "Bytes")]
        token: Vec<u8>,
    },
    /// WebTransport
    //todo: consider making this more flexible in case you don't want the cert hash workflow
    WasmWt {
        /// A renet2 [`ConnectToken`].
        #[serde_as(as = "Bytes")]
        token: Vec<u8>,
        /// Cert hashes for connecting to self-signed servers.
        cert_hashes: Vec<ServerCertHash>,
    },
    /// WebSocket
    WasmWs {
        /// A renet2 [`ConnectToken`].
        #[serde_as(as = "Bytes")]
        token: Vec<u8>,
        /// Url for connecting to websocket server.
        url: url::Url,
    },
    #[cfg(feature = "memory_transport")]
    #[serde(skip)]
    Memory {
        /// A renet2 [`ConnectToken`].
        token: Vec<u8>,
        /// In-memory channel the client will use to talk to the renet2 server.
        client: renet2_netcode::MemorySocketClient,
    },
}

impl Default for ServerConnectToken {
    fn default() -> Self {
        Self::Native { token: vec![] }
    }
}

//-------------------------------------------------------------------------------------------------------------------