#![deny(missing_docs)] #![feature(impl_trait_in_assoc_type)] #![cfg_attr(docsrs, feature(doc_cfg))] //! A library for easily creating [Wisp] clients and servers. //! //! [Wisp]: https://github.com/MercuryWorkshop/wisp-protocol #[cfg(feature = "fastwebsockets")] #[cfg_attr(docsrs, doc(cfg(feature = "fastwebsockets")))] mod fastwebsockets; mod packet; mod sink_unfold; mod stream; #[cfg(feature = "hyper_tower")] #[cfg_attr(docsrs, doc(cfg(feature = "hyper_tower")))] pub mod tokioio; #[cfg(feature = "hyper_tower")] #[cfg_attr(docsrs, doc(cfg(feature = "hyper_tower")))] pub mod tower; pub mod ws; pub use crate::packet::*; pub use crate::stream::*; use event_listener::Event; use futures::{channel::mpsc, lock::Mutex, Future, FutureExt, StreamExt}; use std::{ collections::HashMap, sync::{ atomic::{AtomicBool, AtomicU32, Ordering}, Arc, }, }; /// The role of the multiplexor. #[derive(Debug, PartialEq, Copy, Clone)] pub enum Role { /// Client side, can create new channels to proxy. Client, /// Server side, can listen for channels to proxy. Server, } /// Errors the Wisp implementation can return. #[derive(Debug)] pub enum WispError { /// The packet recieved did not have enough data. PacketTooSmall, /// The packet recieved had an invalid type. InvalidPacketType, /// The stream had an invalid type. InvalidStreamType, /// The stream had an invalid ID. InvalidStreamId, /// The close packet had an invalid reason. InvalidCloseReason, /// The URI recieved was invalid. InvalidUri, /// The URI recieved had no host. UriHasNoHost, /// The URI recieved had no port. UriHasNoPort, /// The max stream count was reached. MaxStreamCountReached, /// The stream had already been closed. StreamAlreadyClosed, /// The websocket frame recieved had an invalid type. WsFrameInvalidType, /// The websocket frame recieved was not finished. WsFrameNotFinished, /// Error specific to the websocket implementation. WsImplError(Box), /// The websocket implementation socket closed. WsImplSocketClosed, /// The websocket implementation did not support the action. WsImplNotSupported, /// The string was invalid UTF-8. Utf8Error(std::str::Utf8Error), /// Other error. Other(Box), } impl From for WispError { fn from(err: std::str::Utf8Error) -> WispError { WispError::Utf8Error(err) } } impl std::fmt::Display for WispError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> Result<(), std::fmt::Error> { use WispError::*; match self { PacketTooSmall => write!(f, "Packet too small"), InvalidPacketType => write!(f, "Invalid packet type"), InvalidStreamType => write!(f, "Invalid stream type"), InvalidStreamId => write!(f, "Invalid stream id"), InvalidCloseReason => write!(f, "Invalid close reason"), InvalidUri => write!(f, "Invalid URI"), UriHasNoHost => write!(f, "URI has no host"), UriHasNoPort => write!(f, "URI has no port"), MaxStreamCountReached => write!(f, "Maximum stream count reached"), StreamAlreadyClosed => write!(f, "Stream already closed"), WsFrameInvalidType => write!(f, "Invalid websocket frame type"), WsFrameNotFinished => write!(f, "Unfinished websocket frame"), WsImplError(err) => write!(f, "Websocket implementation error: {:?}", err), WsImplSocketClosed => write!(f, "Websocket implementation error: websocket closed"), WsImplNotSupported => write!(f, "Websocket implementation error: unsupported feature"), Utf8Error(err) => write!(f, "UTF-8 error: {:?}", err), Other(err) => write!(f, "Other error: {:?}", err), } } } impl std::error::Error for WispError {} struct MuxMapValue { stream: mpsc::UnboundedSender, flow_control: Arc, flow_control_event: Arc, } struct ServerMuxInner where W: ws::WebSocketWrite + Send + 'static, { tx: ws::LockedWebSocketWrite, stream_map: Arc>>, close_tx: mpsc::UnboundedSender, } impl ServerMuxInner { pub async fn into_future( self, rx: R, close_rx: mpsc::UnboundedReceiver, muxstream_sender: mpsc::UnboundedSender<(ConnectPacket, MuxStream)>, buffer_size: u32, ) -> Result<(), WispError> where R: ws::WebSocketRead, { let ret = futures::select! { x = self.server_close_loop(close_rx).fuse() => x, x = self.server_msg_loop(rx, muxstream_sender, buffer_size).fuse() => x }; self.stream_map.lock().await.iter().for_each(|x| { let _ = x.1.stream .unbounded_send(MuxEvent::Close(ClosePacket::new(CloseReason::Unknown))); }); ret } async fn server_close_loop( &self, mut close_rx: mpsc::UnboundedReceiver, ) -> Result<(), WispError> { while let Some(msg) = close_rx.next().await { match msg { WsEvent::Close(stream_id, reason, channel) => { if self.stream_map.lock().await.remove(&stream_id).is_some() { let _ = channel.send( self.tx .write_frame(Packet::new_close(stream_id, reason).into()) .await, ); } else { let _ = channel.send(Err(WispError::InvalidStreamId)); } } } } Ok(()) } async fn server_msg_loop( &self, mut rx: R, muxstream_sender: mpsc::UnboundedSender<(ConnectPacket, MuxStream)>, buffer_size: u32, ) -> Result<(), WispError> where R: ws::WebSocketRead, { self.tx .write_frame(Packet::new_continue(0, buffer_size).into()) .await?; while let Ok(frame) = rx.wisp_read_frame(&self.tx).await { if let Ok(packet) = Packet::try_from(frame) { use PacketType::*; match packet.packet { Connect(inner_packet) => { let (ch_tx, ch_rx) = mpsc::unbounded(); let stream_type = inner_packet.stream_type; let flow_control: Arc = AtomicU32::new(buffer_size).into(); let flow_control_event: Arc = Event::new().into(); self.stream_map.lock().await.insert( packet.stream_id, MuxMapValue { stream: ch_tx, flow_control: flow_control.clone(), flow_control_event: flow_control_event.clone(), }, ); muxstream_sender .unbounded_send(( inner_packet, MuxStream::new( packet.stream_id, Role::Server, stream_type, ch_rx, self.tx.clone(), self.close_tx.clone(), AtomicBool::new(false).into(), flow_control, flow_control_event, ), )) .map_err(|x| WispError::Other(Box::new(x)))?; } Data(data) => { if let Some(stream) = self.stream_map.lock().await.get(&packet.stream_id) { let _ = stream.stream.unbounded_send(MuxEvent::Send(data)); stream.flow_control.store( stream.flow_control .load(Ordering::Acquire) .saturating_sub(1), Ordering::Release, ); } } Continue(_) => unreachable!(), Close(inner_packet) => { if let Some(stream) = self.stream_map.lock().await.get(&packet.stream_id) { let _ = stream.stream.unbounded_send(MuxEvent::Close(inner_packet)); } self.stream_map.lock().await.remove(&packet.stream_id); } } } else { break; } } drop(muxstream_sender); Ok(()) } } /// Server-side multiplexor. /// /// # Example /// ``` /// use wisp_mux::ServerMux; /// /// let (mux, fut) = ServerMux::new(rx, tx, 128); /// tokio::spawn(async move { /// if let Err(e) = fut.await { /// println!("error in multiplexor: {:?}", e); /// } /// }); /// while let Some((packet, stream)) = mux.server_new_stream().await { /// tokio::spawn(async move { /// let url = format!("{}:{}", packet.destination_hostname, packet.destination_port); /// // do something with `url` and `packet.stream_type` /// }); /// } /// ``` pub struct ServerMux where W: ws::WebSocketWrite + Send + 'static, { muxstream_recv: mpsc::UnboundedReceiver<(ConnectPacket, MuxStream)>, } impl ServerMux { /// Create a new server-side multiplexor. pub fn new( read: R, write: W, buffer_size: u32, ) -> (Self, impl Future>) where R: ws::WebSocketRead, { let (close_tx, close_rx) = mpsc::unbounded::(); let (tx, rx) = mpsc::unbounded::<(ConnectPacket, MuxStream)>(); let write = ws::LockedWebSocketWrite::new(write); let map = Arc::new(Mutex::new(HashMap::new())); ( Self { muxstream_recv: rx }, ServerMuxInner { tx: write, close_tx, stream_map: map.clone(), } .into_future(read, close_rx, tx, buffer_size), ) } /// Wait for a stream to be created. pub async fn server_new_stream(&mut self) -> Option<(ConnectPacket, MuxStream)> { self.muxstream_recv.next().await } } struct ClientMuxInner where W: ws::WebSocketWrite, { tx: ws::LockedWebSocketWrite, stream_map: Arc>>, } impl ClientMuxInner { pub(crate) async fn into_future( self, rx: R, close_rx: mpsc::UnboundedReceiver, ) -> Result<(), WispError> where R: ws::WebSocketRead, { futures::select! { x = self.client_bg_loop(close_rx).fuse() => x, x = self.client_loop(rx).fuse() => x } } async fn client_bg_loop( &self, mut close_rx: mpsc::UnboundedReceiver, ) -> Result<(), WispError> { while let Some(msg) = close_rx.next().await { match msg { WsEvent::Close(stream_id, reason, channel) => { if self.stream_map.lock().await.remove(&stream_id).is_some() { let _ = channel.send( self.tx .write_frame(Packet::new_close(stream_id, reason).into()) .await, ); } else { let _ = channel.send(Err(WispError::InvalidStreamId)); } } } } Ok(()) } async fn client_loop(&self, mut rx: R) -> Result<(), WispError> where R: ws::WebSocketRead, { while let Ok(frame) = rx.wisp_read_frame(&self.tx).await { if let Ok(packet) = Packet::try_from(frame) { use PacketType::*; match packet.packet { Connect(_) => unreachable!(), Data(data) => { if let Some(stream) = self.stream_map.lock().await.get(&packet.stream_id) { let _ = stream.stream.unbounded_send(MuxEvent::Send(data)); } } Continue(inner_packet) => { if let Some(stream) = self.stream_map.lock().await.get(&packet.stream_id) { stream .flow_control .store(inner_packet.buffer_remaining, Ordering::Release); let _ = stream.flow_control_event.notify(u32::MAX); } } Close(inner_packet) => { if let Some(stream) = self.stream_map.lock().await.get(&packet.stream_id) { let _ = stream.stream.unbounded_send(MuxEvent::Close(inner_packet)); } self.stream_map.lock().await.remove(&packet.stream_id); } } } } Ok(()) } } /// Client side multiplexor. /// /// # Example /// ``` /// use wisp_mux::{ClientMux, StreamType}; /// /// let (mux, fut) = ClientMux::new(rx, tx).await?; /// tokio::spawn(async move { /// if let Err(e) = fut.await { /// println!("error in multiplexor: {:?}", e); /// } /// }); /// let stream = mux.client_new_stream(StreamType::Tcp, "google.com", 80); /// ``` pub struct ClientMux where W: ws::WebSocketWrite, { tx: ws::LockedWebSocketWrite, stream_map: Arc>>, next_free_stream_id: AtomicU32, close_tx: mpsc::UnboundedSender, buf_size: u32, } impl ClientMux { /// Create a new client side multiplexor. pub async fn new( mut read: R, write: W, ) -> Result<(Self, impl Future>), WispError> where R: ws::WebSocketRead, { let write = ws::LockedWebSocketWrite::new(write); let first_packet = Packet::try_from(read.wisp_read_frame(&write).await?)?; if first_packet.stream_id != 0 { return Err(WispError::InvalidStreamId); } if let PacketType::Continue(packet) = first_packet.packet { let (tx, rx) = mpsc::unbounded::(); let map = Arc::new(Mutex::new(HashMap::new())); Ok(( Self { tx: write.clone(), stream_map: map.clone(), next_free_stream_id: AtomicU32::new(1), close_tx: tx, buf_size: packet.buffer_remaining, }, ClientMuxInner { tx: write.clone(), stream_map: map.clone(), } .into_future(read, rx), )) } else { Err(WispError::InvalidPacketType) } } /// Create a new stream, multiplexed through Wisp. pub async fn client_new_stream( &self, stream_type: StreamType, host: String, port: u16, ) -> Result, WispError> { let (ch_tx, ch_rx) = mpsc::unbounded(); let evt: Arc = Event::new().into(); let flow_control: Arc = AtomicU32::new(self.buf_size).into(); let stream_id = self.next_free_stream_id.load(Ordering::Acquire); self.tx .write_frame(Packet::new_connect(stream_id, stream_type, port, host).into()) .await?; self.next_free_stream_id.store( stream_id .checked_add(1) .ok_or(WispError::MaxStreamCountReached)?, Ordering::Release, ); self.stream_map.lock().await.insert( stream_id, MuxMapValue { stream: ch_tx, flow_control: flow_control.clone(), flow_control_event: evt.clone(), }, ); Ok(MuxStream::new( stream_id, Role::Client, stream_type, ch_rx, self.tx.clone(), self.close_tx.clone(), AtomicBool::new(false).into(), flow_control, evt, )) } }