use crate::{
client::Client,
error::Result,
request::{
self,
channel::message::allowed_mentions::AllowedMentions,
validate::{self, EmbedValidationError},
AuditLogReason, AuditLogReasonError, Pending, Request,
},
routing::Route,
};
use serde::Serialize;
use std::{
error::Error,
fmt::{Display, Formatter, Result as FmtResult},
};
use twilight_model::{
channel::embed::Embed,
id::{MessageId, WebhookId},
};
#[derive(Clone, Debug)]
#[non_exhaustive]
pub enum UpdateWebhookMessageError {
ContentInvalid {
content: String,
},
EmbedTooLarge {
embeds: Vec<Embed>,
index: usize,
source: EmbedValidationError,
},
TooManyEmbeds {
embeds: Vec<Embed>,
},
}
impl Display for UpdateWebhookMessageError {
fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
match self {
Self::ContentInvalid { .. } => f.write_str("message content is invalid"),
Self::EmbedTooLarge { .. } => f.write_str("length of one of the embeds is too large"),
Self::TooManyEmbeds { embeds } => f.write_fmt(format_args!(
"{} embeds were provided, but only 10 may be provided",
embeds.len()
)),
}
}
}
impl Error for UpdateWebhookMessageError {
fn source(&self) -> Option<&(dyn Error + 'static)> {
match self {
Self::EmbedTooLarge { source, .. } => Some(source),
Self::ContentInvalid { .. } | Self::TooManyEmbeds { .. } => None,
}
}
}
#[derive(Default, Serialize)]
struct UpdateWebhookMessageFields {
#[serde(skip_serializing_if = "Option::is_none")]
allowed_mentions: Option<AllowedMentions>,
#[allow(clippy::option_option)]
#[serde(skip_serializing_if = "Option::is_none")]
content: Option<Option<String>>,
#[allow(clippy::option_option)]
#[serde(skip_serializing_if = "Option::is_none")]
embeds: Option<Option<Vec<Embed>>>,
}
pub struct UpdateWebhookMessage<'a> {
fields: UpdateWebhookMessageFields,
fut: Option<Pending<'a, ()>>,
http: &'a Client,
message_id: MessageId,
reason: Option<String>,
token: String,
webhook_id: WebhookId,
}
impl<'a> UpdateWebhookMessage<'a> {
pub const EMBED_COUNT_LIMIT: usize = 10;
pub(crate) fn new(
http: &'a Client,
webhook_id: WebhookId,
token: impl Into<String>,
message_id: MessageId,
) -> Self {
Self {
fields: UpdateWebhookMessageFields {
allowed_mentions: http.default_allowed_mentions(),
..UpdateWebhookMessageFields::default()
},
fut: None,
http,
message_id,
reason: None,
token: token.into(),
webhook_id,
}
}
pub fn allowed_mentions(mut self, allowed: AllowedMentions) -> Self {
self.fields.allowed_mentions.replace(allowed);
self
}
pub fn content(mut self, content: Option<String>) -> Result<Self, UpdateWebhookMessageError> {
if let Some(content_ref) = content.as_ref() {
if !validate::content_limit(content_ref) {
return Err(UpdateWebhookMessageError::ContentInvalid {
content: content.expect("content is known to be some"),
});
}
}
self.fields.content.replace(content);
Ok(self)
}
pub fn embeds(mut self, embeds: Option<Vec<Embed>>) -> Result<Self, UpdateWebhookMessageError> {
if let Some(embeds_present) = embeds.as_deref() {
if embeds_present.len() > Self::EMBED_COUNT_LIMIT {
return Err(UpdateWebhookMessageError::TooManyEmbeds {
embeds: embeds.expect("embeds are known to be present"),
});
}
for (idx, embed) in embeds_present.iter().enumerate() {
if let Err(source) = validate::embed(&embed) {
return Err(UpdateWebhookMessageError::EmbedTooLarge {
embeds: embeds.expect("embeds are known to be present"),
index: idx,
source,
});
}
}
}
self.fields.embeds.replace(embeds);
Ok(self)
}
fn request(&self) -> Result<Request> {
let body = crate::json_to_vec(&self.fields)?;
let route = Route::UpdateWebhookMessage {
message_id: self.message_id.0,
token: self.token.clone(),
webhook_id: self.webhook_id.0,
};
Ok(if let Some(reason) = &self.reason {
let headers = request::audit_header(&reason)?;
Request::from((body, headers, route))
} else {
Request::from((body, route))
})
}
fn start(&mut self) -> Result<()> {
let request = self.request()?;
self.fut.replace(Box::pin(self.http.verify(request)));
Ok(())
}
}
impl<'a> AuditLogReason for UpdateWebhookMessage<'a> {
fn reason(mut self, reason: impl Into<String>) -> Result<Self, AuditLogReasonError> {
self.reason
.replace(AuditLogReasonError::validate(reason.into())?);
Ok(self)
}
}
poll_req!(UpdateWebhookMessage<'_>, ());
#[cfg(test)]
mod tests {
use super::{UpdateWebhookMessage, UpdateWebhookMessageFields};
use crate::{
client::Client,
request::{AuditLogReason, Request},
routing::Route,
};
use twilight_model::id::{MessageId, WebhookId};
#[test]
fn test_request() {
let client = Client::new("token");
let builder = UpdateWebhookMessage::new(&client, WebhookId(1), "token", MessageId(2))
.content(Some("test".to_owned()))
.expect("'test' content couldn't be set")
.reason("reason")
.expect("'reason' is not a valid reason");
let actual = builder.request().expect("failed to create request");
let body = crate::json_to_vec(&UpdateWebhookMessageFields {
allowed_mentions: None,
content: Some(Some("test".to_owned())),
embeds: None,
})
.expect("failed to serialize fields");
let route = Route::UpdateWebhookMessage {
message_id: 2,
token: "token".to_owned(),
webhook_id: 1,
};
let expected = Request::from((body, route));
assert_eq!(expected.body, actual.body);
assert_eq!(expected.path, actual.path);
}
}