Skip to main content

qualia_core_db/net/peer/connectivity/
browser.rs

1//! Browser interoperability contract. Native boringtun is not a browser API.
2
3/// ICE transport policy as used by WebRTC.
4#[derive(Debug, Clone, Copy, PartialEq, Eq)]
5pub enum IceTransportPolicy {
6    All,
7    Relay,
8}
9
10/// How a browser peer reaches QSession.
11#[derive(Debug, Clone, Copy, PartialEq, Eq)]
12pub enum BrowserBearer {
13    /// WebRTC DataChannel + ICE + configured TURN.
14    WebrtcDataChannel,
15    /// WSS where WebRTC cannot work. Outer TLS terminates at the relay.
16    WssFallback,
17}
18
19#[derive(Debug, Clone, Copy, PartialEq, Eq)]
20pub struct BrowserProfile {
21    pub ice_transport: IceTransportPolicy,
22    pub bearer: BrowserBearer,
23    pub gateway_holds_qsession_keys: bool,
24}
25
26impl BrowserProfile {
27    pub const RELAY_ONLY: Self = Self {
28        ice_transport: IceTransportPolicy::Relay,
29        bearer: BrowserBearer::WebrtcDataChannel,
30        gateway_holds_qsession_keys: false,
31    };
32
33    /// A TURN service cannot convert DTLS/SCTP into WireGuard.
34    pub const fn turn_is_not_wireguard(self) -> bool {
35        true
36    }
37}
38
39#[cfg(test)]
40mod tests {
41    use super::*;
42
43    #[test]
44    fn relay_policy_and_no_gateway_keys() {
45        let p = BrowserProfile::RELAY_ONLY;
46        assert_eq!(p.ice_transport, IceTransportPolicy::Relay);
47        assert!(!p.gateway_holds_qsession_keys);
48        assert!(p.turn_is_not_wireguard());
49    }
50}