roam-core 7.3.0

Core implementations: ReliableLink, ReliableAcceptor, Session
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use roam_types::{Link, MessageFamily, MsgFamily};

use crate::BareConduit;

/// Converts a value into a [`roam_types::Conduit`].
///
/// Implemented for:
/// - Any [`Link`] → wraps it in a [`BareConduit`] automatically
/// - [`BareConduit`] → identity (pass-through)
/// - [`crate::StableConduit`] → identity (pass-through)
///
/// This allows [`crate::session::initiator`] and [`crate::session::acceptor`]
/// to accept raw links directly, without requiring callers to wrap them in
/// `BareConduit::new()` manually.
pub trait IntoConduit {
    /// The conduit type produced by this conversion.
    type Conduit;

    /// Convert into a conduit.
    fn into_conduit(self) -> Self::Conduit;
}

/// Any [`Link`] becomes a [`BareConduit`] over [`MessageFamily`].
impl<L: Link> IntoConduit for L {
    type Conduit = BareConduit<MessageFamily, L>;

    fn into_conduit(self) -> Self::Conduit {
        BareConduit::new(self)
    }
}

/// [`BareConduit`] passes through unchanged.
impl<F: MsgFamily, L: Link> IntoConduit for BareConduit<F, L> {
    type Conduit = BareConduit<F, L>;

    fn into_conduit(self) -> Self::Conduit {
        self
    }
}

/// [`crate::StableConduit`] passes through unchanged.
#[cfg(not(target_arch = "wasm32"))]
impl<F: MsgFamily, LS: crate::LinkSource> IntoConduit for crate::StableConduit<F, LS> {
    type Conduit = crate::StableConduit<F, LS>;

    fn into_conduit(self) -> Self::Conduit {
        self
    }
}