2023-04-30 14:45:15 +02:00
|
|
|
use std::sync::Arc;
|
2023-04-30 11:56:14 +02:00
|
|
|
use std::thread;
|
2023-04-28 20:29:40 +02:00
|
|
|
|
2023-04-28 18:18:32 +02:00
|
|
|
use crate::api::types::*;
|
|
|
|
use crate::api::WebSocketEvent;
|
|
|
|
use crate::errors::ObserverError;
|
|
|
|
use crate::gateway::events::Events;
|
|
|
|
use crate::URLBundle;
|
2023-04-30 11:56:14 +02:00
|
|
|
|
|
|
|
use futures_util::stream::{FilterMap, SplitSink, SplitStream};
|
2023-04-30 14:45:15 +02:00
|
|
|
use futures_util::SinkExt;
|
2023-04-28 23:21:55 +02:00
|
|
|
use futures_util::StreamExt;
|
2023-04-30 11:56:14 +02:00
|
|
|
use native_tls::TlsConnector;
|
2023-04-28 20:29:40 +02:00
|
|
|
use reqwest::Url;
|
2023-04-28 23:21:55 +02:00
|
|
|
use serde::Deserialize;
|
|
|
|
use serde::Serialize;
|
2023-04-30 12:17:35 +02:00
|
|
|
use serde_json::from_str;
|
2023-04-28 23:21:55 +02:00
|
|
|
use tokio::io;
|
2023-04-28 18:18:32 +02:00
|
|
|
use tokio::net::TcpStream;
|
2023-04-30 14:45:15 +02:00
|
|
|
use tokio::sync::mpsc::{channel, Receiver, Sender};
|
2023-04-30 11:56:14 +02:00
|
|
|
use tokio::sync::Mutex;
|
2023-04-30 14:45:15 +02:00
|
|
|
use tokio::task;
|
2023-04-28 23:21:55 +02:00
|
|
|
use tokio_tungstenite::tungstenite::error::UrlError;
|
2023-04-28 18:18:32 +02:00
|
|
|
use tokio_tungstenite::WebSocketStream;
|
2023-04-30 11:56:14 +02:00
|
|
|
use tokio_tungstenite::{connect_async, connect_async_tls_with_config};
|
|
|
|
use tokio_tungstenite::{Connector, MaybeTlsStream};
|
2023-04-27 22:38:41 +02:00
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
2023-04-28 18:18:32 +02:00
|
|
|
Represents a Gateway connection. A Gateway connection will create observable
|
|
|
|
[`GatewayEvents`](GatewayEvent), which you can subscribe to. Gateway events include all currently
|
|
|
|
implemented [Types] with the trait [`WebSocketEvent`]
|
|
|
|
*/
|
|
|
|
pub struct Gateway<'a> {
|
|
|
|
pub url: String,
|
2023-04-28 23:21:55 +02:00
|
|
|
pub token: String,
|
2023-04-28 18:18:32 +02:00
|
|
|
pub events: Events<'a>,
|
2023-05-04 20:05:33 +02:00
|
|
|
websocket: WebSocketConnection,
|
2023-04-28 18:18:32 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> Gateway<'a> {
|
2023-04-28 23:21:55 +02:00
|
|
|
pub async fn new(
|
|
|
|
websocket_url: String,
|
|
|
|
token: String,
|
|
|
|
) -> Result<Gateway<'a>, tokio_tungstenite::tungstenite::Error> {
|
2023-04-30 14:45:15 +02:00
|
|
|
return Ok(Gateway {
|
2023-05-04 20:05:33 +02:00
|
|
|
url: websocket_url.clone(),
|
2023-04-30 14:45:15 +02:00
|
|
|
token,
|
|
|
|
events: Events::default(),
|
2023-05-04 20:05:33 +02:00
|
|
|
websocket: WebSocketConnection::new(websocket_url).await,
|
2023-04-30 14:45:15 +02:00
|
|
|
});
|
|
|
|
}
|
2023-05-04 20:57:45 +02:00
|
|
|
|
|
|
|
/// This function reads all messages from the gateway's websocket and updates its events along with the events' observers
|
|
|
|
pub async fn update_events(&mut self) {
|
|
|
|
while let Some(msg) = self.websocket.rx.lock().await.recv().await {
|
|
|
|
let gateway_payload: GatewayPayload = serde_json::from_str(msg.to_text().unwrap()).unwrap();
|
|
|
|
|
|
|
|
// See https://discord.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-opcodes
|
|
|
|
match gateway_payload.op {
|
|
|
|
// Dispatch
|
|
|
|
// An event was dispatched, we need to look at the gateway event name t
|
|
|
|
0 => {
|
|
|
|
let gateway_payload_t = gateway_payload.t.unwrap();
|
|
|
|
|
|
|
|
// See https://discord.com/developers/docs/topics/gateway-events#receive-events
|
|
|
|
match gateway_payload_t.as_str() {
|
|
|
|
"APPLICATION_COMMAND_PERMISSIONS_UPDATE" => {}
|
|
|
|
"AUTO_MODERATION_RULE_CREATE" => {}
|
|
|
|
"AUTO_MODERATION_RULE_UPDATE" => {}
|
|
|
|
"AUTO_MODERATION_RULE_DELETE" => {}
|
|
|
|
"AUTO_MODERATION_ACTION_EXECUTION" => {}
|
|
|
|
"CHANNEL_CREATE" => {}
|
|
|
|
"CHANNEL_UPDATE" => {}
|
|
|
|
"CHANNEL_DELETE" => {}
|
|
|
|
"CHANNEL_PINS_UPDATE" => {}
|
|
|
|
"THREAD_CREATE" => {}
|
|
|
|
"THREAD_UPDATE" => {}
|
|
|
|
"THREAD_DELETE" => {}
|
|
|
|
"THREAD_LIST_SYNC" => {}
|
|
|
|
"THREAD_MEMBER_UPDATE" => {}
|
|
|
|
"THREAD_MEMBERS_UPDATE" => {}
|
|
|
|
"GUILD_CREATE" => {}
|
|
|
|
"GUILD_UPDATE" => {}
|
|
|
|
"GUILD_DELETE" => {}
|
|
|
|
"GUILD_AUDIT_LOG_ENTRY_CREATE" => {}
|
|
|
|
"GUILD_BAN_ADD" => {}
|
|
|
|
"GUILD_BAN_REMOVE" => {}
|
|
|
|
"GUILD_EMOJIS_UPDATE" => {}
|
|
|
|
"GUILD_STICKERS_UPDATE" => {}
|
|
|
|
"GUILD_INTEGRATIONS_UPDATE" => {}
|
|
|
|
"GUILD_MEMBER_ADD" => {}
|
|
|
|
"GUILD_MEMBER_REMOVE" => {}
|
|
|
|
"GUILD_MEMBER_UPDATE" => {}
|
|
|
|
"GUILD_MEMBERS_CHUNK" => {}
|
|
|
|
"GUILD_ROLE_CREATE" => {}
|
|
|
|
"GUILD_ROLE_UPDATE" => {}
|
|
|
|
"GUILD_ROLE_DELETE" => {}
|
|
|
|
"GUILD_SCHEDULED_EVENT_CREATE" => {}
|
|
|
|
"GUILD_SCHEDULED_EVENT_UPDATE" => {}
|
|
|
|
"GUILD_SCHEDULED_EVENT_DELETE" => {}
|
|
|
|
"GUILD_SCHEDULED_EVENT_USER_ADD" => {}
|
|
|
|
"GUILD_SCHEDULED_EVENT_USER_REMOVE" => {}
|
|
|
|
"INTEGRATION_CREATE" => {}
|
|
|
|
"INTEGRATION_UPDATE" => {}
|
|
|
|
"INTEGRATION_DELETE" => {}
|
|
|
|
"INTERACTION_CREATE" => {}
|
|
|
|
"INVITE_CREATE" => {}
|
|
|
|
"INVITE_DELETE" => {}
|
|
|
|
"MESSAGE_CREATE" => {}
|
|
|
|
"MESSAGE_UPDATE" => {}
|
|
|
|
"MESSAGE_DELETE" => {}
|
|
|
|
"MESSAGE_DELETE_BULK" => {}
|
|
|
|
"MESSAGE_REACTION_ADD" => {}
|
|
|
|
"MESSAGE_REACTION_REMOVE" => {}
|
|
|
|
"MESSAGE_REACTION_REMOVE_ALL" => {}
|
|
|
|
"MESSAGE_REACTION_REMOVE_EMOJI" => {}
|
|
|
|
"PRESENCE_UPDATE" => {}
|
|
|
|
"STAGE_INSTANCE_CREATE" => {}
|
|
|
|
"STAGE_INSTANCE_UPDATE" => {}
|
|
|
|
"STAGE_INSTANCE_DELETE" => {}
|
|
|
|
"TYPING_START" => {}
|
|
|
|
"USER_UPDATE" => {}
|
|
|
|
"VOICE_STATE_UPDATE" => {}
|
|
|
|
"VOICE_SERVER_UPDATE" => {}
|
|
|
|
"WEBHOOKS_UPDATE" => {}
|
|
|
|
_ => {panic!("Invalid gateway event ({})", &gateway_payload_t)}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
// Heartbeat
|
|
|
|
// We received a heartbeat from the server
|
2023-05-05 15:39:11 +02:00
|
|
|
1 => {}
|
2023-05-04 20:57:45 +02:00
|
|
|
// Reconnect
|
|
|
|
7 => {todo!()}
|
|
|
|
// Invalid Session
|
|
|
|
9 => {todo!()}
|
|
|
|
// Hello
|
|
|
|
// Should start our heartbeat
|
|
|
|
10 => {
|
2023-05-05 15:39:11 +02:00
|
|
|
let gateway_hello: HelloData = serde_json::from_str(gateway_payload.d.unwrap().as_ref()).unwrap();
|
2023-05-04 20:57:45 +02:00
|
|
|
}
|
|
|
|
// Heartbeat ACK
|
2023-05-05 15:39:11 +02:00
|
|
|
11 => {}
|
2023-05-04 20:57:45 +02:00
|
|
|
2 | 3 | 4 | 6 | 8 => {panic!("Received Gateway op code that's meant to be sent, not received ({})", gateway_payload.op)}
|
|
|
|
_ => {panic!("Received Invalid Gateway op code ({})", gateway_payload.op)}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2023-04-30 14:45:15 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
struct WebSocketConnection {
|
|
|
|
rx: Arc<Mutex<Receiver<tokio_tungstenite::tungstenite::Message>>>,
|
|
|
|
tx: Arc<Mutex<Sender<tokio_tungstenite::tungstenite::Message>>>,
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<'a> WebSocketConnection {
|
|
|
|
async fn new(websocket_url: String) -> WebSocketConnection {
|
2023-04-28 18:18:32 +02:00
|
|
|
let parsed_url = Url::parse(&URLBundle::parse_url(websocket_url.clone())).unwrap();
|
2023-04-30 14:45:15 +02:00
|
|
|
/*if parsed_url.scheme() != "ws" && parsed_url.scheme() != "wss" {
|
2023-04-28 23:21:55 +02:00
|
|
|
return Err(tokio_tungstenite::tungstenite::Error::Url(
|
|
|
|
UrlError::UnsupportedUrlScheme,
|
|
|
|
));
|
2023-04-30 14:45:15 +02:00
|
|
|
}*/
|
2023-04-30 12:17:35 +02:00
|
|
|
|
2023-04-30 14:45:15 +02:00
|
|
|
let (mut channel_write, mut channel_read): (
|
|
|
|
Sender<tokio_tungstenite::tungstenite::Message>,
|
|
|
|
Receiver<tokio_tungstenite::tungstenite::Message>,
|
|
|
|
) = channel(32);
|
2023-04-28 23:21:55 +02:00
|
|
|
|
2023-04-30 14:45:15 +02:00
|
|
|
let shared_channel_write = Arc::new(Mutex::new(channel_write));
|
|
|
|
let clone_shared_channel_write = shared_channel_write.clone();
|
|
|
|
let shared_channel_read = Arc::new(Mutex::new(channel_read));
|
|
|
|
let clone_shared_channel_read = shared_channel_read.clone();
|
2023-04-30 11:56:14 +02:00
|
|
|
|
2023-04-30 14:45:15 +02:00
|
|
|
task::spawn(async move {
|
|
|
|
let (mut ws_stream, _) = match connect_async_tls_with_config(
|
|
|
|
&websocket_url,
|
|
|
|
None,
|
|
|
|
Some(Connector::NativeTls(
|
|
|
|
TlsConnector::builder().build().unwrap(),
|
|
|
|
)),
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
{
|
|
|
|
Ok(ws_stream) => ws_stream,
|
|
|
|
Err(_) => return, /*return Err(tokio_tungstenite::tungstenite::Error::Io(
|
|
|
|
io::ErrorKind::ConnectionAborted.into(),
|
|
|
|
))*/
|
|
|
|
};
|
|
|
|
|
|
|
|
let (mut write_tx, mut write_rx) = ws_stream.split();
|
|
|
|
|
|
|
|
while let Some(msg) = shared_channel_read.lock().await.recv().await {
|
|
|
|
write_tx.send(msg).await.unwrap();
|
|
|
|
}
|
|
|
|
|
|
|
|
let event = while let Some(msg) = write_rx.next().await {
|
|
|
|
shared_channel_write
|
|
|
|
.lock()
|
|
|
|
.await
|
|
|
|
.send(msg.unwrap())
|
|
|
|
.await
|
|
|
|
.unwrap();
|
|
|
|
};
|
2023-04-28 23:21:55 +02:00
|
|
|
});
|
2023-04-30 14:45:15 +02:00
|
|
|
|
|
|
|
WebSocketConnection {
|
|
|
|
tx: clone_shared_channel_write,
|
|
|
|
rx: clone_shared_channel_read,
|
|
|
|
}
|
2023-04-28 18:18:32 +02:00
|
|
|
}
|
|
|
|
}
|
2023-04-27 17:57:10 +02:00
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Trait which defines the behaviour of an Observer. An Observer is an object which is subscribed to
|
|
|
|
an Observable. The Observer is notified when the Observable's data changes.
|
2023-04-28 18:18:32 +02:00
|
|
|
In this case, the Observable is a [`GatewayEvent`], which is a wrapper around a WebSocketEvent.
|
2023-04-28 13:40:29 +02:00
|
|
|
*/
|
2023-04-28 12:31:59 +02:00
|
|
|
pub trait Observer<T: WebSocketEvent> {
|
|
|
|
fn update(&self, data: &T);
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/** GatewayEvent is a wrapper around a WebSocketEvent. It is used to notify the observers of a
|
2023-04-28 18:18:32 +02:00
|
|
|
change in the WebSocketEvent. GatewayEvents are observable.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#[derive(Default)]
|
2023-04-28 12:31:59 +02:00
|
|
|
pub struct GatewayEvent<'a, T: WebSocketEvent> {
|
|
|
|
observers: Vec<&'a dyn Observer<T>>,
|
|
|
|
pub event_data: T,
|
2023-04-27 22:29:07 +02:00
|
|
|
pub is_observed: bool,
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
|
2023-04-28 12:31:59 +02:00
|
|
|
impl<'a, T: WebSocketEvent> GatewayEvent<'a, T> {
|
|
|
|
fn new(event_data: T) -> Self {
|
2023-04-27 17:57:10 +02:00
|
|
|
Self {
|
2023-04-27 22:29:07 +02:00
|
|
|
is_observed: false,
|
2023-04-27 17:57:10 +02:00
|
|
|
observers: Vec::new(),
|
2023-04-28 12:31:59 +02:00
|
|
|
event_data,
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Returns true if the GatewayEvent is observed by at least one Observer.
|
2023-04-28 18:18:32 +02:00
|
|
|
*/
|
2023-04-27 22:29:07 +02:00
|
|
|
pub fn is_observed(&self) -> bool {
|
|
|
|
self.is_observed
|
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Subscribes an Observer to the GatewayEvent. Returns an error if the GatewayEvent is already
|
|
|
|
observed.
|
|
|
|
# Errors
|
|
|
|
Returns an error if the GatewayEvent is already observed.
|
|
|
|
Error type: [`ObserverError::AlreadySubscribedError`]
|
2023-04-28 18:18:32 +02:00
|
|
|
*/
|
2023-04-28 12:31:59 +02:00
|
|
|
pub fn subscribe(&mut self, observable: &'a dyn Observer<T>) -> Option<ObserverError> {
|
2023-04-27 22:29:07 +02:00
|
|
|
if self.is_observed {
|
2023-04-27 22:38:41 +02:00
|
|
|
return Some(ObserverError::AlreadySubscribedError);
|
2023-04-27 22:29:07 +02:00
|
|
|
}
|
|
|
|
self.is_observed = true;
|
2023-04-27 22:38:41 +02:00
|
|
|
self.observers.push(observable);
|
|
|
|
None
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Unsubscribes an Observer from the GatewayEvent.
|
2023-04-28 18:18:32 +02:00
|
|
|
*/
|
2023-04-28 12:31:59 +02:00
|
|
|
pub fn unsubscribe(&mut self, observable: &'a dyn Observer<T>) {
|
|
|
|
// .retain()'s closure retains only those elements of the vector, which have a different
|
|
|
|
// pointer value than observable.
|
|
|
|
self.observers.retain(|obs| !std::ptr::eq(*obs, observable));
|
|
|
|
self.is_observed = !self.observers.is_empty();
|
2023-04-27 22:29:07 +02:00
|
|
|
return;
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Updates the GatewayEvent's data and notifies the observers.
|
2023-04-28 18:18:32 +02:00
|
|
|
*/
|
2023-04-28 12:31:59 +02:00
|
|
|
fn update_data(&mut self, new_event_data: T) {
|
|
|
|
self.event_data = new_event_data;
|
2023-04-27 17:57:10 +02:00
|
|
|
self.notify();
|
|
|
|
}
|
|
|
|
|
2023-04-28 13:40:29 +02:00
|
|
|
/**
|
|
|
|
Notifies the observers of the GatewayEvent.
|
2023-04-28 18:18:32 +02:00
|
|
|
*/
|
2023-04-27 22:29:07 +02:00
|
|
|
fn notify(&self) {
|
2023-04-27 17:57:10 +02:00
|
|
|
for observer in &self.observers {
|
2023-04-28 12:31:59 +02:00
|
|
|
observer.update(&self.event_data);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-04-28 18:18:32 +02:00
|
|
|
mod events {
|
|
|
|
use super::*;
|
|
|
|
#[derive(Default)]
|
|
|
|
pub struct Events<'a> {
|
|
|
|
pub message: Message<'a>,
|
|
|
|
pub user: User<'a>,
|
|
|
|
pub gateway_identify_payload: GatewayEvent<'a, GatewayIdentifyPayload>,
|
|
|
|
pub gateway_resume: GatewayEvent<'a, GatewayResume>,
|
|
|
|
}
|
|
|
|
|
|
|
|
#[derive(Default)]
|
|
|
|
pub struct Message<'a> {
|
|
|
|
pub create: GatewayEvent<'a, MessageCreate>,
|
|
|
|
pub update: GatewayEvent<'a, MessageUpdate>,
|
|
|
|
pub delete: GatewayEvent<'a, MessageDelete>,
|
|
|
|
pub delete_bulk: GatewayEvent<'a, MessageDeleteBulk>,
|
|
|
|
pub reaction_add: GatewayEvent<'a, MessageReactionAdd>,
|
|
|
|
pub reaction_remove: GatewayEvent<'a, MessageReactionRemove>,
|
|
|
|
pub reaction_remove_all: GatewayEvent<'a, MessageReactionRemoveAll>,
|
|
|
|
pub reaction_remove_emoji: GatewayEvent<'a, MessageReactionRemoveEmoji>,
|
|
|
|
}
|
|
|
|
|
|
|
|
#[derive(Default)]
|
|
|
|
pub struct User<'a> {
|
|
|
|
pub presence_update: GatewayEvent<'a, PresenceUpdate>,
|
|
|
|
pub typing_start_event: GatewayEvent<'a, TypingStartEvent>,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-04-28 12:31:59 +02:00
|
|
|
#[cfg(test)]
|
2023-04-28 12:39:58 +02:00
|
|
|
mod example {
|
2023-04-28 12:31:59 +02:00
|
|
|
use super::*;
|
|
|
|
use crate::api::types::GatewayResume;
|
|
|
|
|
|
|
|
struct Consumer;
|
|
|
|
impl Observer<GatewayResume> for Consumer {
|
|
|
|
fn update(&self, data: &GatewayResume) {
|
|
|
|
println!("{}", data.token)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_observer_behaviour() {
|
|
|
|
let mut event = GatewayEvent::new(GatewayResume {
|
|
|
|
token: "start".to_string(),
|
|
|
|
session_id: "start".to_string(),
|
|
|
|
seq: "start".to_string(),
|
|
|
|
});
|
|
|
|
|
|
|
|
let new_data = GatewayResume {
|
|
|
|
token: "token_3276ha37am3".to_string(),
|
|
|
|
session_id: "89346671230".to_string(),
|
|
|
|
seq: "3".to_string(),
|
|
|
|
};
|
|
|
|
|
|
|
|
let consumer = Consumer;
|
|
|
|
|
|
|
|
event.subscribe(&consumer);
|
|
|
|
|
|
|
|
event.notify();
|
|
|
|
|
|
|
|
event.update_data(new_data);
|
|
|
|
|
|
|
|
let second_consumer = Consumer;
|
|
|
|
|
|
|
|
match event.subscribe(&second_consumer) {
|
2023-04-28 12:39:58 +02:00
|
|
|
None => assert!(false),
|
2023-04-28 12:31:59 +02:00
|
|
|
Some(err) => println!("You cannot subscribe twice: {}", err),
|
2023-04-27 17:57:10 +02:00
|
|
|
}
|
|
|
|
}
|
2023-04-28 23:21:55 +02:00
|
|
|
|
|
|
|
#[tokio::test]
|
|
|
|
async fn test_gateway() {
|
|
|
|
let gateway = Gateway::new("ws://localhost:3001/".to_string(), "none".to_string())
|
|
|
|
.await
|
|
|
|
.unwrap();
|
|
|
|
}
|
2023-04-25 17:21:27 +02:00
|
|
|
}
|