capnweb-transport 0.1.0

Transport layer implementations for Cap'n Web protocol (HTTP, WebSocket, WebTransport)
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

use async_trait::async_trait;
use bytes::Bytes;
use capnweb_core::Message;
use thiserror::Error;

#[derive(Debug, Error)]
pub enum TransportError {
    #[error("Connection closed")]
    ConnectionClosed,
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
    #[error("Codec error: {0}")]
    Codec(String),
    #[error("Protocol error: {0}")]
    Protocol(String),
}

#[derive(Debug)]
pub enum TransportEvent {
    Frame(Bytes),
    Closed(Option<TransportError>),
    Heartbeat,
}

#[async_trait]
pub trait RpcTransport: Send + Sync {
    async fn send(&mut self, msg: Message) -> Result<(), TransportError>;
    async fn recv(&mut self) -> Result<Option<Message>, TransportError>;
    async fn close(&mut self) -> Result<(), TransportError>;
}