#![warn(clippy::nursery, clippy::pedantic)] //! Contains common functions and structures used by multiple projects // Copyright (c) 2021 Edward Shen // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. use std::fmt::Display; use std::str::FromStr; use bytes::Bytes; use chrono::{DateTime, Duration, Utc}; use headers::{Header, HeaderName, HeaderValue}; use lazy_static::lazy_static; pub use secrecy; use secrecy::Secret; use serde::{Deserialize, Serialize}; use thiserror::Error; pub use url::Url; use crate::crypto::Key; pub mod base64; pub mod crypto; pub const API_ENDPOINT: &str = "/api"; pub struct ParsedUrl { pub sanitized_url: Url, pub decryption_key: Secret, pub needs_password: bool, } #[derive(Default)] pub struct PartialParsedUrl { pub decryption_key: Option>, pub needs_password: bool, } impl From<&str> for PartialParsedUrl { fn from(fragment: &str) -> Self { // Short circuit if the fragment only contains the key. // Base64 has an interesting property that the length of an encoded text // is always 4/3rds larger than the original data. if !fragment.contains("key") { let decryption_key = base64::decode(fragment).ok().and_then(Key::new_secret); return Self { decryption_key, needs_password: false, }; } let args = fragment.split('!').filter_map(|kv| { let (k, v) = { let mut iter = kv.split(':'); (iter.next(), iter.next()) }; Some((k?, v)) }); let mut decryption_key = None; let mut needs_password = false; for (key, value) in args { match (key, value) { ("key", Some(value)) => { decryption_key = base64::decode(value).ok().and_then(Key::new_secret); } ("pw", _) => { needs_password = true; } _ => (), } } Self { decryption_key, needs_password, } } } #[derive(Debug, Error)] pub enum ParseUrlError { #[error("The provided url was bad")] BadUrl, #[error("Missing decryption key")] NeedKey, } impl FromStr for ParsedUrl { type Err = ParseUrlError; fn from_str(s: &str) -> Result { let mut url = Url::from_str(s).map_err(|_| ParseUrlError::BadUrl)?; let fragment = url.fragment().ok_or(ParseUrlError::NeedKey)?; if fragment.is_empty() { return Err(ParseUrlError::NeedKey); } let PartialParsedUrl { mut decryption_key, needs_password, } = PartialParsedUrl::from(fragment); url.set_fragment(None); let decryption_key = decryption_key.take().ok_or(ParseUrlError::NeedKey)?; Ok(Self { sanitized_url: url, decryption_key, needs_password, }) } } #[derive(Serialize, Deserialize, Clone, Copy, Debug)] pub enum Expiration { BurnAfterReading, BurnAfterReadingWithDeadline(DateTime), UnixTime(DateTime), } // This impl is used for the CLI impl FromStr for Expiration { type Err = String; fn from_str(s: &str) -> Result { match s { "read" => Ok(Self::BurnAfterReading), "5m" => Ok(Self::UnixTime(Utc::now() + Duration::minutes(5))), "10m" => Ok(Self::UnixTime(Utc::now() + Duration::minutes(10))), "1h" => Ok(Self::UnixTime(Utc::now() + Duration::hours(1))), "1d" => Ok(Self::UnixTime(Utc::now() + Duration::days(1))), // We disallow permanent pastes _ => Err(s.to_owned()), } } } impl Display for Expiration { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { match self { Expiration::BurnAfterReading | Expiration::BurnAfterReadingWithDeadline(_) => { write!(f, "This item has been burned. You now have the only copy.") } Expiration::UnixTime(time) => write!( f, "{}", time.format("This item will expire on %A, %B %-d, %Y at %T %Z.") ), } } } lazy_static! { pub static ref EXPIRATION_HEADER_NAME: HeaderName = HeaderName::from_static("burn-after"); } impl Header for Expiration { fn name() -> &'static HeaderName { &*EXPIRATION_HEADER_NAME } fn decode<'i, I>(values: &mut I) -> Result where Self: Sized, I: Iterator, { let bytes = values.next().ok_or_else(headers::Error::invalid)?; Self::try_from(bytes).map_err(|_| headers::Error::invalid()) } fn encode>(&self, container: &mut E) { container.extend(std::iter::once(self.into())); } } impl From<&Expiration> for HeaderValue { fn from(expiration: &Expiration) -> Self { // SAFETY: All possible values of `Expiration` are valid header values, // so we don't need the extra check. unsafe { Self::from_maybe_shared_unchecked(match expiration { Expiration::BurnAfterReadingWithDeadline(_) | Expiration::BurnAfterReading => { Bytes::from_static(b"0") } Expiration::UnixTime(duration) => Bytes::from(duration.to_rfc3339()), }) } } } impl From for HeaderValue { fn from(expiration: Expiration) -> Self { (&expiration).into() } } pub struct ParseHeaderValueError; #[cfg(feature = "wasm")] impl TryFrom for Expiration { type Error = ParseHeaderValueError; fn try_from(headers: web_sys::Headers) -> Result { headers .get(http::header::EXPIRES.as_str()) .ok() .flatten() .as_deref() .and_then(|v| Self::try_from(v).ok()) .ok_or(ParseHeaderValueError) } } impl TryFrom for Expiration { type Error = ParseHeaderValueError; fn try_from(value: HeaderValue) -> Result { Self::try_from(&value) } } impl TryFrom<&HeaderValue> for Expiration { type Error = ParseHeaderValueError; fn try_from(value: &HeaderValue) -> Result { std::str::from_utf8(value.as_bytes()) .map_err(|_| ParseHeaderValueError) .and_then(Self::try_from) } } impl TryFrom<&str> for Expiration { type Error = ParseHeaderValueError; fn try_from(value: &str) -> Result { if value == "0" { return Ok(Self::BurnAfterReading); } value .parse::>() .map_err(|_| ParseHeaderValueError) .map(Self::UnixTime) } } impl Default for Expiration { fn default() -> Self { Self::UnixTime(Utc::now() + Duration::days(1)) } }