From 394794b0be57355e61edbc5b1825a37e671eec3e Mon Sep 17 00:00:00 2001 From: Antfroze Date: Wed, 29 Apr 2026 18:31:37 -0500 Subject: [PATCH] =?UTF-8?q?first=20commit=20=F0=9F=8D=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 1 + Cargo.lock | 1363 +++++++++++++++++++++++++++++++++++++++++++++++ Cargo.toml | 12 + LICENSE | 21 + src/client.rs | 132 +++++ src/email.rs | 381 +++++++++++++ src/error.rs | 113 ++++ src/lib.rs | 11 + src/response.rs | 116 ++++ src/util.rs | 66 +++ src/wire.rs | 111 ++++ 11 files changed, 2327 insertions(+) create mode 100644 .gitignore create mode 100644 Cargo.lock create mode 100644 Cargo.toml create mode 100644 LICENSE create mode 100644 src/client.rs create mode 100644 src/email.rs create mode 100644 src/error.rs create mode 100644 src/lib.rs create mode 100644 src/response.rs create mode 100644 src/util.rs create mode 100644 src/wire.rs diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..ea8c4bf --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/target diff --git a/Cargo.lock b/Cargo.lock new file mode 100644 index 0000000..35c259e --- /dev/null +++ b/Cargo.lock @@ -0,0 +1,1363 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 4 + +[[package]] +name = "atomic-waker" +version = "1.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0" + +[[package]] +name = "base64" +version = "0.22.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6" + +[[package]] +name = "bitflags" +version = "2.11.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c4512299f36f043ab09a583e57bceb5a5aab7a73db1805848e8fef3c9e8c78b3" + +[[package]] +name = "bumpalo" +version = "3.20.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5d20789868f4b01b2f2caec9f5c4e0213b41e3e5702a50157d699ae31ced2fcb" + +[[package]] +name = "bytes" +version = "1.11.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33" + +[[package]] +name = "cc" +version = "1.2.61" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d16d90359e986641506914ba71350897565610e87ce0ad9e6f28569db3dd5c6d" +dependencies = [ + "find-msvc-tools", + "shlex", +] + +[[package]] +name = "cfg-if" +version = "1.0.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801" + +[[package]] +name = "cfg_aliases" +version = "0.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724" + +[[package]] +name = "displaydoc" +version = "0.2.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "find-msvc-tools" +version = "0.1.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582" + +[[package]] +name = "form_urlencoded" +version = "1.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf" +dependencies = [ + "percent-encoding", +] + +[[package]] +name = "futures-channel" +version = "0.3.32" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "07bbe89c50d7a535e539b8c17bc0b49bdb77747034daa8087407d655f3f7cc1d" +dependencies = [ + "futures-core", +] + +[[package]] +name = "futures-core" +version = "0.3.32" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7e3450815272ef58cec6d564423f6e755e25379b217b0bc688e295ba24df6b1d" + +[[package]] +name = "futures-task" +version = "0.3.32" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "037711b3d59c33004d3856fbdc83b99d4ff37a24768fa1be9ce3538a1cde4393" + +[[package]] +name = "futures-util" +version = "0.3.32" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "389ca41296e6190b48053de0321d02a77f32f8a5d2461dd38762c0593805c6d6" +dependencies = [ + "futures-core", + "futures-task", + "pin-project-lite", + "slab", +] + +[[package]] +name = "getrandom" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0" +dependencies = [ + "cfg-if", + "js-sys", + "libc", + "wasi", + "wasm-bindgen", +] + +[[package]] +name = "getrandom" +version = "0.3.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd" +dependencies = [ + "cfg-if", + "js-sys", + "libc", + "r-efi", + "wasip2", + "wasm-bindgen", +] + +[[package]] +name = "http" +version = "1.4.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e3ba2a386d7f85a81f119ad7498ebe444d2e22c2af0b86b069416ace48b3311a" +dependencies = [ + "bytes", + "itoa", +] + +[[package]] +name = "http-body" +version = "1.0.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184" +dependencies = [ + "bytes", + "http", +] + +[[package]] +name = "http-body-util" +version = "0.1.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a" +dependencies = [ + "bytes", + "futures-core", + "http", + "http-body", + "pin-project-lite", +] + +[[package]] +name = "httparse" +version = "1.10.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87" + +[[package]] +name = "hyper" +version = "1.9.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6299f016b246a94207e63da54dbe807655bf9e00044f73ded42c3ac5305fbcca" +dependencies = [ + "atomic-waker", + "bytes", + "futures-channel", + "futures-core", + "http", + "http-body", + "httparse", + "itoa", + "pin-project-lite", + "smallvec", + "tokio", + "want", +] + +[[package]] +name = "hyper-rustls" +version = "0.27.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "33ca68d021ef39cf6463ab54c1d0f5daf03377b70561305bb89a8f83aab66e0f" +dependencies = [ + "http", + "hyper", + "hyper-util", + "rustls", + "tokio", + "tokio-rustls", + "tower-service", + "webpki-roots", +] + +[[package]] +name = "hyper-util" +version = "0.1.20" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "96547c2556ec9d12fb1578c4eaf448b04993e7fb79cbaad930a656880a6bdfa0" +dependencies = [ + "base64", + "bytes", + "futures-channel", + "futures-util", + "http", + "http-body", + "hyper", + "ipnet", + "libc", + "percent-encoding", + "pin-project-lite", + "socket2", + "tokio", + "tower-service", + "tracing", +] + +[[package]] +name = "icu_collections" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2984d1cd16c883d7935b9e07e44071dca8d917fd52ecc02c04d5fa0b5a3f191c" +dependencies = [ + "displaydoc", + "potential_utf", + "utf8_iter", + "yoke", + "zerofrom", + "zerovec", +] + +[[package]] +name = "icu_locale_core" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "92219b62b3e2b4d88ac5119f8904c10f8f61bf7e95b640d25ba3075e6cac2c29" +dependencies = [ + "displaydoc", + "litemap", + "tinystr", + "writeable", + "zerovec", +] + +[[package]] +name = "icu_normalizer" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c56e5ee99d6e3d33bd91c5d85458b6005a22140021cc324cea84dd0e72cff3b4" +dependencies = [ + "icu_collections", + "icu_normalizer_data", + "icu_properties", + "icu_provider", + "smallvec", + "zerovec", +] + +[[package]] +name = "icu_normalizer_data" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "da3be0ae77ea334f4da67c12f149704f19f81d1adf7c51cf482943e84a2bad38" + +[[package]] +name = "icu_properties" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "bee3b67d0ea5c2cca5003417989af8996f8604e34fb9ddf96208a033901e70de" +dependencies = [ + "icu_collections", + "icu_locale_core", + "icu_properties_data", + "icu_provider", + "zerotrie", + "zerovec", +] + +[[package]] +name = "icu_properties_data" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8e2bbb201e0c04f7b4b3e14382af113e17ba4f63e2c9d2ee626b720cbce54a14" + +[[package]] +name = "icu_provider" +version = "2.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "139c4cf31c8b5f33d7e199446eff9c1e02decfc2f0eec2c8d71f65befa45b421" +dependencies = [ + "displaydoc", + "icu_locale_core", + "writeable", + "yoke", + "zerofrom", + "zerotrie", + "zerovec", +] + +[[package]] +name = "idna" +version = "1.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de" +dependencies = [ + "idna_adapter", + "smallvec", + "utf8_iter", +] + +[[package]] +name = "idna_adapter" +version = "1.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714" +dependencies = [ + "icu_normalizer", + "icu_properties", +] + +[[package]] +name = "ipnet" +version = "2.12.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d98f6fed1fde3f8c21bc40a1abb88dd75e67924f9cffc3ef95607bad8017f8e2" + +[[package]] +name = "iri-string" +version = "0.7.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "25e659a4bb38e810ebc252e53b5814ff908a8c58c2a9ce2fae1bbec24cbf4e20" +dependencies = [ + "memchr", + "serde", +] + +[[package]] +name = "itoa" +version = "1.0.18" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682" + +[[package]] +name = "js-sys" +version = "0.3.97" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a1840c94c045fbcf8ba2812c95db44499f7c64910a912551aaaa541decebcacf" +dependencies = [ + "cfg-if", + "futures-util", + "once_cell", + "wasm-bindgen", +] + +[[package]] +name = "libc" +version = "0.2.186" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66" + +[[package]] +name = "litemap" +version = "0.8.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0" + +[[package]] +name = "log" +version = "0.4.29" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897" + +[[package]] +name = "lru-slab" +version = "0.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154" + +[[package]] +name = "memchr" +version = "2.8.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79" + +[[package]] +name = "mio" +version = "1.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "50b7e5b27aa02a74bac8c3f23f448f8d87ff11f92d3aac1a6ed369ee08cc56c1" +dependencies = [ + "libc", + "wasi", + "windows-sys 0.61.2", +] + +[[package]] +name = "once_cell" +version = "1.21.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50" + +[[package]] +name = "percent-encoding" +version = "2.3.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220" + +[[package]] +name = "pin-project-lite" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd" + +[[package]] +name = "plunk-rs" +version = "0.1.0" +dependencies = [ + "reqwest", + "serde", + "serde_json", + "thiserror", + "url", +] + +[[package]] +name = "potential_utf" +version = "0.1.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0103b1cef7ec0cf76490e969665504990193874ea05c85ff9bab8b911d0a0564" +dependencies = [ + "zerovec", +] + +[[package]] +name = "ppv-lite86" +version = "0.2.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9" +dependencies = [ + "zerocopy", +] + +[[package]] +name = "proc-macro2" +version = "1.0.106" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934" +dependencies = [ + "unicode-ident", +] + +[[package]] +name = "quinn" +version = "0.11.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b9e20a958963c291dc322d98411f541009df2ced7b5a4f2bd52337638cfccf20" +dependencies = [ + "bytes", + "cfg_aliases", + "pin-project-lite", + "quinn-proto", + "quinn-udp", + "rustc-hash", + "rustls", + "socket2", + "thiserror", + "tokio", + "tracing", + "web-time", +] + +[[package]] +name = "quinn-proto" +version = "0.11.14" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "434b42fec591c96ef50e21e886936e66d3cc3f737104fdb9b737c40ffb94c098" +dependencies = [ + "bytes", + "getrandom 0.3.4", + "lru-slab", + "rand", + "ring", + "rustc-hash", + "rustls", + "rustls-pki-types", + "slab", + "thiserror", + "tinyvec", + "tracing", + "web-time", +] + +[[package]] +name = "quinn-udp" +version = "0.5.14" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "addec6a0dcad8a8d96a771f815f0eaf55f9d1805756410b39f5fa81332574cbd" +dependencies = [ + "cfg_aliases", + "libc", + "once_cell", + "socket2", + "tracing", + "windows-sys 0.60.2", +] + +[[package]] +name = "quote" +version = "1.0.45" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924" +dependencies = [ + "proc-macro2", +] + +[[package]] +name = "r-efi" +version = "5.3.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f" + +[[package]] +name = "rand" +version = "0.9.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "44c5af06bb1b7d3216d91932aed5265164bf384dc89cd6ba05cf59a35f5f76ea" +dependencies = [ + "rand_chacha", + "rand_core", +] + +[[package]] +name = "rand_chacha" +version = "0.9.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb" +dependencies = [ + "ppv-lite86", + "rand_core", +] + +[[package]] +name = "rand_core" +version = "0.9.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "76afc826de14238e6e8c374ddcc1fa19e374fd8dd986b0d2af0d02377261d83c" +dependencies = [ + "getrandom 0.3.4", +] + +[[package]] +name = "reqwest" +version = "0.12.28" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147" +dependencies = [ + "base64", + "bytes", + "futures-core", + "http", + "http-body", + "http-body-util", + "hyper", + "hyper-rustls", + "hyper-util", + "js-sys", + "log", + "percent-encoding", + "pin-project-lite", + "quinn", + "rustls", + "rustls-pki-types", + "serde", + "serde_json", + "serde_urlencoded", + "sync_wrapper", + "tokio", + "tokio-rustls", + "tower", + "tower-http", + "tower-service", + "url", + "wasm-bindgen", + "wasm-bindgen-futures", + "web-sys", + "webpki-roots", +] + +[[package]] +name = "ring" +version = "0.17.14" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7" +dependencies = [ + "cc", + "cfg-if", + "getrandom 0.2.17", + "libc", + "untrusted", + "windows-sys 0.52.0", +] + +[[package]] +name = "rustc-hash" +version = "2.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe" + +[[package]] +name = "rustls" +version = "0.23.40" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ef86cd5876211988985292b91c96a8f2d298df24e75989a43a3c73f2d4d8168b" +dependencies = [ + "once_cell", + "ring", + "rustls-pki-types", + "rustls-webpki", + "subtle", + "zeroize", +] + +[[package]] +name = "rustls-pki-types" +version = "1.14.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "30a7197ae7eb376e574fe940d068c30fe0462554a3ddbe4eca7838e049c937a9" +dependencies = [ + "web-time", + "zeroize", +] + +[[package]] +name = "rustls-webpki" +version = "0.103.13" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e" +dependencies = [ + "ring", + "rustls-pki-types", + "untrusted", +] + +[[package]] +name = "rustversion" +version = "1.0.22" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d" + +[[package]] +name = "ryu" +version = "1.0.23" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f" + +[[package]] +name = "serde" +version = "1.0.228" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e" +dependencies = [ + "serde_core", + "serde_derive", +] + +[[package]] +name = "serde_core" +version = "1.0.228" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad" +dependencies = [ + "serde_derive", +] + +[[package]] +name = "serde_derive" +version = "1.0.228" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "serde_json" +version = "1.0.149" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86" +dependencies = [ + "itoa", + "memchr", + "serde", + "serde_core", + "zmij", +] + +[[package]] +name = "serde_urlencoded" +version = "0.7.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd" +dependencies = [ + "form_urlencoded", + "itoa", + "ryu", + "serde", +] + +[[package]] +name = "shlex" +version = "1.3.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64" + +[[package]] +name = "slab" +version = "0.4.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5" + +[[package]] +name = "smallvec" +version = "1.15.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03" + +[[package]] +name = "socket2" +version = "0.6.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3a766e1110788c36f4fa1c2b71b387a7815aa65f88ce0229841826633d93723e" +dependencies = [ + "libc", + "windows-sys 0.61.2", +] + +[[package]] +name = "stable_deref_trait" +version = "1.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596" + +[[package]] +name = "subtle" +version = "2.6.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292" + +[[package]] +name = "syn" +version = "2.0.117" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + +[[package]] +name = "sync_wrapper" +version = "1.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263" +dependencies = [ + "futures-core", +] + +[[package]] +name = "synstructure" +version = "0.13.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "thiserror" +version = "2.0.18" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4" +dependencies = [ + "thiserror-impl", +] + +[[package]] +name = "thiserror-impl" +version = "2.0.18" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "tinystr" +version = "0.8.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c8323304221c2a851516f22236c5722a72eaa19749016521d6dff0824447d96d" +dependencies = [ + "displaydoc", + "zerovec", +] + +[[package]] +name = "tinyvec" +version = "1.11.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3e61e67053d25a4e82c844e8424039d9745781b3fc4f32b8d55ed50f5f667ef3" +dependencies = [ + "tinyvec_macros", +] + +[[package]] +name = "tinyvec_macros" +version = "0.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20" + +[[package]] +name = "tokio" +version = "1.52.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b67dee974fe86fd92cc45b7a95fdd2f99a36a6d7b0d431a231178d3d670bbcc6" +dependencies = [ + "bytes", + "libc", + "mio", + "pin-project-lite", + "socket2", + "windows-sys 0.61.2", +] + +[[package]] +name = "tokio-rustls" +version = "0.26.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61" +dependencies = [ + "rustls", + "tokio", +] + +[[package]] +name = "tower" +version = "0.5.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4" +dependencies = [ + "futures-core", + "futures-util", + "pin-project-lite", + "sync_wrapper", + "tokio", + "tower-layer", + "tower-service", +] + +[[package]] +name = "tower-http" +version = "0.6.8" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d4e6559d53cc268e5031cd8429d05415bc4cb4aefc4aa5d6cc35fbf5b924a1f8" +dependencies = [ + "bitflags", + "bytes", + "futures-util", + "http", + "http-body", + "iri-string", + "pin-project-lite", + "tower", + "tower-layer", + "tower-service", +] + +[[package]] +name = "tower-layer" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e" + +[[package]] +name = "tower-service" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3" + +[[package]] +name = "tracing" +version = "0.1.44" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100" +dependencies = [ + "pin-project-lite", + "tracing-core", +] + +[[package]] +name = "tracing-core" +version = "0.1.36" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a" +dependencies = [ + "once_cell", +] + +[[package]] +name = "try-lock" +version = "0.2.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b" + +[[package]] +name = "unicode-ident" +version = "1.0.24" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75" + +[[package]] +name = "untrusted" +version = "0.9.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1" + +[[package]] +name = "url" +version = "2.5.8" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed" +dependencies = [ + "form_urlencoded", + "idna", + "percent-encoding", + "serde", +] + +[[package]] +name = "utf8_iter" +version = "1.0.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be" + +[[package]] +name = "want" +version = "0.3.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e" +dependencies = [ + "try-lock", +] + +[[package]] +name = "wasi" +version = "0.11.1+wasi-snapshot-preview1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b" + +[[package]] +name = "wasip2" +version = "1.0.3+wasi-0.2.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "20064672db26d7cdc89c7798c48a0fdfac8213434a1186e5ef29fd560ae223d6" +dependencies = [ + "wit-bindgen", +] + +[[package]] +name = "wasm-bindgen" +version = "0.2.120" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "df52b6d9b87e0c74c9edfa1eb2d9bf85e5d63515474513aa50fa181b3c4f5db1" +dependencies = [ + "cfg-if", + "once_cell", + "rustversion", + "wasm-bindgen-macro", + "wasm-bindgen-shared", +] + +[[package]] +name = "wasm-bindgen-futures" +version = "0.4.70" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "af934872acec734c2d80e6617bbb5ff4f12b052dd8e6332b0817bce889516084" +dependencies = [ + "js-sys", + "wasm-bindgen", +] + +[[package]] +name = "wasm-bindgen-macro" +version = "0.2.120" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "78b1041f495fb322e64aca85f5756b2172e35cd459376e67f2a6c9dffcedb103" +dependencies = [ + "quote", + "wasm-bindgen-macro-support", +] + +[[package]] +name = "wasm-bindgen-macro-support" +version = "0.2.120" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9dcd0ff20416988a18ac686d4d4d0f6aae9ebf08a389ff5d29012b05af2a1b41" +dependencies = [ + "bumpalo", + "proc-macro2", + "quote", + "syn", + "wasm-bindgen-shared", +] + +[[package]] +name = "wasm-bindgen-shared" +version = "0.2.120" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "49757b3c82ebf16c57d69365a142940b384176c24df52a087fb748e2085359ea" +dependencies = [ + "unicode-ident", +] + +[[package]] +name = "web-sys" +version = "0.3.97" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2eadbac71025cd7b0834f20d1fe8472e8495821b4e9801eb0a60bd1f19827602" +dependencies = [ + "js-sys", + "wasm-bindgen", +] + +[[package]] +name = "web-time" +version = "1.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5a6580f308b1fad9207618087a65c04e7a10bc77e02c8e84e9b00dd4b12fa0bb" +dependencies = [ + "js-sys", + "wasm-bindgen", +] + +[[package]] +name = "webpki-roots" +version = "1.0.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "52f5ee44c96cf55f1b349600768e3ece3a8f26010c05265ab73f945bb1a2eb9d" +dependencies = [ + "rustls-pki-types", +] + +[[package]] +name = "windows-link" +version = "0.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5" + +[[package]] +name = "windows-sys" +version = "0.52.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d" +dependencies = [ + "windows-targets 0.52.6", +] + +[[package]] +name = "windows-sys" +version = "0.60.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb" +dependencies = [ + "windows-targets 0.53.5", +] + +[[package]] +name = "windows-sys" +version = "0.61.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc" +dependencies = [ + "windows-link", +] + +[[package]] +name = "windows-targets" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973" +dependencies = [ + "windows_aarch64_gnullvm 0.52.6", + "windows_aarch64_msvc 0.52.6", + "windows_i686_gnu 0.52.6", + "windows_i686_gnullvm 0.52.6", + "windows_i686_msvc 0.52.6", + "windows_x86_64_gnu 0.52.6", + "windows_x86_64_gnullvm 0.52.6", + "windows_x86_64_msvc 0.52.6", +] + +[[package]] +name = "windows-targets" +version = "0.53.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3" +dependencies = [ + "windows-link", + "windows_aarch64_gnullvm 0.53.1", + "windows_aarch64_msvc 0.53.1", + "windows_i686_gnu 0.53.1", + "windows_i686_gnullvm 0.53.1", + "windows_i686_msvc 0.53.1", + "windows_x86_64_gnu 0.53.1", + "windows_x86_64_gnullvm 0.53.1", + "windows_x86_64_msvc 0.53.1", +] + +[[package]] +name = "windows_aarch64_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3" + +[[package]] +name = "windows_aarch64_gnullvm" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53" + +[[package]] +name = "windows_aarch64_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469" + +[[package]] +name = "windows_aarch64_msvc" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006" + +[[package]] +name = "windows_i686_gnu" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b" + +[[package]] +name = "windows_i686_gnu" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3" + +[[package]] +name = "windows_i686_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66" + +[[package]] +name = "windows_i686_gnullvm" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c" + +[[package]] +name = "windows_i686_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66" + +[[package]] +name = "windows_i686_msvc" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2" + +[[package]] +name = "windows_x86_64_gnu" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78" + +[[package]] +name = "windows_x86_64_gnu" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499" + +[[package]] +name = "windows_x86_64_gnullvm" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d" + +[[package]] +name = "windows_x86_64_gnullvm" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1" + +[[package]] +name = "windows_x86_64_msvc" +version = "0.52.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec" + +[[package]] +name = "windows_x86_64_msvc" +version = "0.53.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650" + +[[package]] +name = "wit-bindgen" +version = "0.57.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1ebf944e87a7c253233ad6766e082e3cd714b5d03812acc24c318f549614536e" + +[[package]] +name = "writeable" +version = "0.6.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4" + +[[package]] +name = "yoke" +version = "0.8.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "abe8c5fda708d9ca3df187cae8bfb9ceda00dd96231bed36e445a1a48e66f9ca" +dependencies = [ + "stable_deref_trait", + "yoke-derive", + "zerofrom", +] + +[[package]] +name = "yoke-derive" +version = "0.8.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "de844c262c8848816172cef550288e7dc6c7b7814b4ee56b3e1553f275f1858e" +dependencies = [ + "proc-macro2", + "quote", + "syn", + "synstructure", +] + +[[package]] +name = "zerocopy" +version = "0.8.48" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "eed437bf9d6692032087e337407a86f04cd8d6a16a37199ed57949d415bd68e9" +dependencies = [ + "zerocopy-derive", +] + +[[package]] +name = "zerocopy-derive" +version = "0.8.48" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "70e3cd084b1788766f53af483dd21f93881ff30d7320490ec3ef7526d203bad4" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "zerofrom" +version = "0.1.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "69faa1f2a1ea75661980b013019ed6687ed0e83d069bc1114e2cc74c6c04c4df" +dependencies = [ + "zerofrom-derive", +] + +[[package]] +name = "zerofrom-derive" +version = "0.1.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "11532158c46691caf0f2593ea8358fed6bbf68a0315e80aae9bd41fbade684a1" +dependencies = [ + "proc-macro2", + "quote", + "syn", + "synstructure", +] + +[[package]] +name = "zeroize" +version = "1.8.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b97154e67e32c85465826e8bcc1c59429aaaf107c1e4a9e53c8d8ccd5eff88d0" + +[[package]] +name = "zerotrie" +version = "0.2.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0f9152d31db0792fa83f70fb2f83148effb5c1f5b8c7686c3459e361d9bc20bf" +dependencies = [ + "displaydoc", + "yoke", + "zerofrom", +] + +[[package]] +name = "zerovec" +version = "0.11.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "90f911cbc359ab6af17377d242225f4d75119aec87ea711a880987b18cd7b239" +dependencies = [ + "yoke", + "zerofrom", + "zerovec-derive", +] + +[[package]] +name = "zerovec-derive" +version = "0.11.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "625dc425cab0dca6dc3c3319506e6593dcb08a9f387ea3b284dbd52a92c40555" +dependencies = [ + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "zmij" +version = "1.0.21" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa" diff --git a/Cargo.toml b/Cargo.toml new file mode 100644 index 0000000..3a5eb8d --- /dev/null +++ b/Cargo.toml @@ -0,0 +1,12 @@ +[package] +name = "plunk-rs" +version = "0.1.0" +edition = "2024" +authors = ["Antfroze"] + +[dependencies] +reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] } +serde = { version = "1", features = ["derive"] } +serde_json = "1" +thiserror = "2" +url = "2" diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..71b6577 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Antfroze + +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. diff --git a/src/client.rs b/src/client.rs new file mode 100644 index 0000000..122f34b --- /dev/null +++ b/src/client.rs @@ -0,0 +1,132 @@ +use crate::email::Email; +use crate::error::{ApiError, Error, Result}; +use crate::response::SendResponse; +use crate::util::normalize_non_empty; +use crate::wire::{WireEmail, WireSendResponse}; +use reqwest::{Client as HttpClient, Url}; + +const DEFAULT_BASE_URL: &str = "https://api.useplunk.com/"; + +/// Async client for Plunk's transactional email API. +/// +/// ```no_run +/// use plunk_rs::{Client, Email, EmailAddress}; +/// +/// # async fn demo() -> Result<(), Box> { +/// let client = Client::new("sk_your_secret_key")?; +/// +/// let email = Email::html("user@example.com", "Welcome", "

Hello

")? +/// .from(EmailAddress::named("My App", "hello@example.com")?)? +/// .reply_to("support@example.com")?; +/// +/// let response = client.send(&email).await?; +/// assert_eq!(response.deliveries().len(), 1); +/// # Ok(()) +/// # } +/// ``` +#[derive(Clone, Debug)] +pub struct Client { + http: HttpClient, + api_key: String, + base_url: Url, +} + +impl Client { + /// Creates a client that targets Plunk's hosted API. + pub fn new(api_key: impl Into) -> Result { + Self::builder(api_key).build() + } + + /// Creates a builder for custom HTTP clients or self-hosted Plunk URLs. + pub fn builder(api_key: impl Into) -> ClientBuilder { + ClientBuilder::new(api_key) + } + + /// Sends a validated email via `POST /v1/send`. + pub async fn send(&self, email: &Email) -> Result { + let response = self + .http + .post(self.base_url.join("v1/send").expect("valid send endpoint")) + .bearer_auth(&self.api_key) + .json(&WireEmail::from(email)) + .send() + .await?; + + let status = response.status(); + + if !status.is_success() { + let body = response.text().await?; + return Err(Error::Api(ApiError::from_response(status, body))); + } + + let payload = response.json::().await?; + if !payload.success { + return Err(Error::UnexpectedResponse( + "success=false in a successful API response".to_string(), + )); + } + + Ok(SendResponse::from(payload.data)) + } + + pub fn base_url(&self) -> &Url { + &self.base_url + } +} + +#[derive(Clone, Debug)] +pub struct ClientBuilder { + api_key: String, + base_url: Url, + http: HttpClient, +} + +impl ClientBuilder { + pub fn new(api_key: impl Into) -> Self { + Self { + api_key: api_key.into(), + base_url: Url::parse(DEFAULT_BASE_URL).expect("default base URL must be valid"), + http: HttpClient::new(), + } + } + + pub fn base_url(mut self, base_url: impl AsRef) -> Result { + let mut parsed = Url::parse(base_url.as_ref())?; + if !parsed.path().ends_with('/') { + parsed.set_path(&format!("{}/", parsed.path())); + } + self.base_url = parsed; + Ok(self) + } + + pub fn http_client(mut self, http: HttpClient) -> Self { + self.http = http; + self + } + + pub fn build(self) -> Result { + let api_key = normalize_non_empty(self.api_key, Error::InvalidApiKey)?; + + Ok(Client { + http: self.http, + api_key, + base_url: self.base_url, + }) + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn builder_normalizes_base_url_for_self_hosting() { + let client = Client::builder("sk_test") + .base_url("https://plunk.example.com/api") + .unwrap() + .build() + .unwrap(); + + assert_eq!(client.base_url().as_str(), "https://plunk.example.com/api/"); + } +} diff --git a/src/email.rs b/src/email.rs new file mode 100644 index 0000000..00cf97c --- /dev/null +++ b/src/email.rs @@ -0,0 +1,381 @@ +use crate::error::{Error, Result}; +use crate::util::{normalize_email, normalize_header_key, normalize_non_empty, serialize_data_map}; +use serde::Serialize; +use serde_json::{Map, Value}; +use std::collections::BTreeMap; +use std::convert::Infallible; + +/// A validated email ready to send. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Email { + recipients: Recipients, + pub(crate) content: EmailContent, + pub(crate) from: Option, + pub(crate) reply_to: Option, + pub(crate) headers: BTreeMap, + pub(crate) data: Map, +} + +impl Email { + /// Creates an HTML email for a single recipient. + pub fn html(to: A, subject: impl Into, body: impl Into) -> Result + where + A: TryInto, + A::Error: Into, + { + Self::html_many([to.try_into().map_err(Into::into)?], subject, body) + } + + /// Creates an HTML email for multiple recipients. + pub fn html_many(to: I, subject: impl Into, body: impl Into) -> Result + where + I: IntoIterator, + { + Ok(Self { + recipients: Recipients::many(to)?, + content: EmailContent::Html { + subject: normalize_non_empty(subject.into(), Error::InvalidSubject)?, + body: normalize_non_empty(body.into(), Error::InvalidBody)?, + }, + from: None, + reply_to: None, + headers: BTreeMap::new(), + data: Map::new(), + }) + } + + /// Creates a template email for a single recipient. + pub fn template(to: A, template_id: impl Into) -> Result + where + A: TryInto, + A::Error: Into, + { + Self::template_many([to.try_into().map_err(Into::into)?], template_id) + } + + /// Creates a template email for multiple recipients. + pub fn template_many(to: I, template_id: impl Into) -> Result + where + I: IntoIterator, + { + Ok(Self { + recipients: Recipients::many(to)?, + content: EmailContent::Template { + template_id: normalize_non_empty(template_id.into(), Error::InvalidTemplateId)?, + }, + from: None, + reply_to: None, + headers: BTreeMap::new(), + data: Map::new(), + }) + } + + pub fn from(mut self, from: A) -> Result + where + A: TryInto, + A::Error: Into, + { + self.from = Some(from.try_into().map_err(Into::into)?); + Ok(self) + } + + pub fn reply_to(mut self, reply_to: A) -> Result + where + A: TryInto, + A::Error: Into, + { + self.reply_to = Some(reply_to.try_into().map_err(Into::into)?); + Ok(self) + } + + pub fn with_header(mut self, key: impl Into, value: impl Into) -> Result { + let key = normalize_header_key(key.into())?; + let value = normalize_non_empty(value.into(), Error::InvalidHeaderValue)?; + self.headers.insert(key, value); + Ok(self) + } + + pub fn with_data(mut self, data: T) -> Result + where + T: Serialize, + { + self.data = serialize_data_map(data)?; + Ok(self) + } + + pub fn recipients(&self) -> &[EmailAddress] { + self.recipients.as_slice() + } + + pub fn from_address(&self) -> Option<&EmailAddress> { + self.from.as_ref() + } + + pub fn reply_to_address(&self) -> Option<&EmailAddress> { + self.reply_to.as_ref() + } + + pub fn subject(&self) -> Option<&str> { + match &self.content { + EmailContent::Html { subject, .. } => Some(subject), + EmailContent::Template { .. } => None, + } + } + + pub fn body(&self) -> Option<&str> { + match &self.content { + EmailContent::Html { body, .. } => Some(body), + EmailContent::Template { .. } => None, + } + } + + pub fn template_id(&self) -> Option<&str> { + match &self.content { + EmailContent::Html { .. } => None, + EmailContent::Template { template_id } => Some(template_id), + } + } + + pub fn headers(&self) -> &BTreeMap { + &self.headers + } + + pub fn data(&self) -> &Map { + &self.data + } +} + +#[derive(Clone, Debug, PartialEq, Eq)] +pub(crate) enum EmailContent { + Html { subject: String, body: String }, + Template { template_id: String }, +} + +/// A validated recipient list. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Recipients(Vec); + +impl Recipients { + pub fn one(recipient: A) -> Result + where + A: TryInto, + A::Error: Into, + { + Ok(Self(vec![recipient.try_into().map_err(Into::into)?])) + } + + pub fn many(recipients: I) -> Result + where + I: IntoIterator, + { + let recipients: Vec<_> = recipients.into_iter().collect(); + if recipients.is_empty() { + return Err(Error::MissingRecipients); + } + Ok(Self(recipients)) + } + + pub fn as_slice(&self) -> &[EmailAddress] { + &self.0 + } +} + +/// A validated email address with an optional display name. +#[derive(Clone, Debug, PartialEq, Eq, Hash)] +pub struct EmailAddress { + pub(crate) email: String, + pub(crate) name: Option, +} + +impl EmailAddress { + pub fn new(email: impl Into) -> Result { + let email = normalize_email(email.into())?; + Ok(Self { email, name: None }) + } + + pub fn named(name: impl Into, email: impl Into) -> Result { + let name = normalize_non_empty(name.into(), Error::InvalidDisplayName)?; + let email = normalize_email(email.into())?; + Ok(Self { + email, + name: Some(name), + }) + } + + pub fn email(&self) -> &str { + &self.email + } + + pub fn name(&self) -> Option<&str> { + self.name.as_deref() + } +} + +impl TryFrom<&str> for EmailAddress { + type Error = Error; + + fn try_from(value: &str) -> Result { + Self::new(value) + } +} + +impl TryFrom for EmailAddress { + type Error = Error; + + fn try_from(value: String) -> Result { + Self::new(value) + } +} + +impl From for Error { + fn from(value: Infallible) -> Self { + match value {} + } +} + +#[cfg(test)] +mod tests { + use super::*; + use crate::wire::WireEmail; + use serde::Serialize; + use serde_json::json; + + #[derive(Serialize)] + struct WelcomeData<'a> { + first_name: &'a str, + } + + #[test] + fn html_email_validates_up_front() { + let email = Email::html("user@example.com", "Welcome", "

Hello from Plunk

") + .unwrap() + .from(EmailAddress::named("My App", "hello@example.com").unwrap()) + .unwrap() + .reply_to("reply@example.com") + .unwrap() + .with_header("X-Test", "true") + .unwrap(); + + let json = serde_json::to_value(WireEmail::from(&email)).unwrap(); + + assert_eq!( + json, + json!({ + "to": "user@example.com", + "subject": "Welcome", + "body": "

Hello from Plunk

", + "from": { + "name": "My App", + "email": "hello@example.com" + }, + "headers": { + "X-Test": "true" + }, + "reply": "reply@example.com" + }) + ); + } + + #[test] + fn template_email_serializes_cleanly() { + let recipients = vec![ + EmailAddress::new("one@example.com").unwrap(), + EmailAddress::new("two@example.com").unwrap(), + ]; + let email = Email::template_many(recipients, "tpl_123").unwrap(); + + let json = serde_json::to_value(WireEmail::from(&email)).unwrap(); + + assert_eq!( + json, + json!({ + "to": ["one@example.com", "two@example.com"], + "template": "tpl_123" + }) + ); + } + + #[test] + fn template_data_must_be_an_object() { + let error = Email::template("user@example.com", "tpl_123") + .unwrap() + .with_data(vec!["not", "an", "object"]) + .unwrap_err(); + + assert!(matches!(error, Error::TemplateDataMustBeObject)); + } + + #[test] + fn typed_template_data_serializes_from_struct() { + let email = Email::template("user@example.com", "tpl_123") + .unwrap() + .with_data(WelcomeData { first_name: "Ada" }) + .unwrap(); + + let json = serde_json::to_value(WireEmail::from(&email)).unwrap(); + + assert_eq!( + json, + json!({ + "to": "user@example.com", + "template": "tpl_123", + "data": { + "first_name": "Ada" + } + }) + ); + } + + #[test] + fn rejects_invalid_email_at_construction_time() { + let error = Email::html("not-an-email", "Welcome", "

Hello

").unwrap_err(); + + assert!(matches!(error, Error::InvalidEmailAddress { .. })); + } + + #[test] + fn rejects_empty_subject_at_construction_time() { + let error = Email::html("user@example.com", " ", "

Hello

").unwrap_err(); + + assert!(matches!(error, Error::InvalidSubject)); + } + + #[test] + fn rejects_empty_template_id_at_construction_time() { + let error = Email::template("user@example.com", " ").unwrap_err(); + + assert!(matches!(error, Error::InvalidTemplateId)); + } + + #[test] + fn email_accessors_are_consistent() { + let email = Email::html("user@example.com", "Welcome", "

Hello

") + .unwrap() + .from("hello@example.com") + .unwrap() + .reply_to(EmailAddress::named("Support", "reply@example.com").unwrap()) + .unwrap() + .with_header("X-Test", "true") + .unwrap() + .with_data(serde_json::json!({ "first_name": "Ada" })) + .unwrap(); + + assert_eq!( + email.recipients(), + &[EmailAddress::new("user@example.com").unwrap()] + ); + assert_eq!( + email.from_address(), + Some(&EmailAddress::new("hello@example.com").unwrap()) + ); + assert_eq!( + email.reply_to_address(), + Some(&EmailAddress::named("Support", "reply@example.com").unwrap()) + ); + assert_eq!(email.subject(), Some("Welcome")); + assert_eq!(email.body(), Some("

Hello

")); + assert_eq!(email.template_id(), None); + assert_eq!(email.headers().get("X-Test"), Some(&"true".to_string())); + assert_eq!(email.data().get("first_name"), Some(&json!("Ada"))); + } +} diff --git a/src/error.rs b/src/error.rs new file mode 100644 index 0000000..836421d --- /dev/null +++ b/src/error.rs @@ -0,0 +1,113 @@ +use reqwest::StatusCode; +use std::fmt; +use thiserror::Error as ThisError; + +pub type Result = std::result::Result; + +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct ApiError { + status: StatusCode, + code: Option, + kind: Option, + message: String, + body: String, +} + +impl ApiError { + pub(crate) fn from_response(status: StatusCode, body: String) -> Self { + match serde_json::from_str::(&body) { + Ok(payload) => Self { + status, + code: Some(payload.code), + kind: Some(payload.error), + message: payload.message, + body, + }, + Err(_) => Self { + status, + code: None, + kind: None, + message: "unparseable API error response".to_string(), + body, + }, + } + } + + pub fn status(&self) -> StatusCode { + self.status + } + + pub fn code(&self) -> Option { + self.code + } + + pub fn kind(&self) -> Option<&str> { + self.kind.as_deref() + } + + pub fn message(&self) -> &str { + &self.message + } + + pub fn body(&self) -> &str { + &self.body + } +} + +impl fmt::Display for ApiError { + fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { + match self.kind() { + Some(kind) => write!(f, "{} {}: {}", self.status, kind, self.message), + None => write!(f, "{}: {}", self.status, self.message), + } + } +} + +#[derive(Debug, ThisError)] +pub enum Error { + #[error("api key cannot be empty")] + InvalidApiKey, + #[error("base URL is invalid: {0}")] + InvalidBaseUrl(#[from] url::ParseError), + #[error("at least one recipient is required")] + MissingRecipients, + #[error("subject cannot be empty")] + InvalidSubject, + #[error("body cannot be empty")] + InvalidBody, + #[error("template id cannot be empty")] + InvalidTemplateId, + #[error("display name cannot be empty")] + InvalidDisplayName, + #[error("header name cannot be empty")] + InvalidHeaderName, + #[error("header value cannot be empty")] + InvalidHeaderValue, + #[error("email address is invalid: {reason} ({value})")] + InvalidEmailAddress { reason: &'static str, value: String }, + #[error("template data must serialize into a JSON object")] + TemplateDataMustBeObject, + #[error("failed to serialize template data: {0}")] + TemplateDataSerialization(serde_json::Error), + #[error("http request failed: {0}")] + Transport(#[from] reqwest::Error), + #[error("plunk API returned {0}")] + Api(ApiError), + #[error("unexpected API response: {0}")] + UnexpectedResponse(String), +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn api_error_preserves_raw_body_when_json_is_unparseable() { + let error = + ApiError::from_response(StatusCode::BAD_GATEWAY, "bad gateway".into()); + + assert_eq!(error.status(), StatusCode::BAD_GATEWAY); + assert_eq!(error.code(), None); + assert_eq!(error.body(), "bad gateway"); + } +} diff --git a/src/lib.rs b/src/lib.rs new file mode 100644 index 0000000..cd44e61 --- /dev/null +++ b/src/lib.rs @@ -0,0 +1,11 @@ +mod client; +mod email; +mod error; +mod response; +mod util; +mod wire; + +pub use client::{Client, ClientBuilder}; +pub use email::{Email, EmailAddress, Recipients}; +pub use error::{ApiError, Error, Result}; +pub use response::{Contact, Delivery, SendResponse}; diff --git a/src/response.rs b/src/response.rs new file mode 100644 index 0000000..2c9bc8b --- /dev/null +++ b/src/response.rs @@ -0,0 +1,116 @@ +use crate::wire::{WireContact, WireDeliveredEmail, WireSendResponseData}; + +/// Successful send result. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct SendResponse { + deliveries: Vec, + timestamp: String, +} + +impl SendResponse { + pub fn deliveries(&self) -> &[Delivery] { + &self.deliveries + } + + pub fn timestamp(&self) -> &str { + &self.timestamp + } +} + +impl From for SendResponse { + fn from(value: WireSendResponseData) -> Self { + Self { + deliveries: value.emails.into_iter().map(Delivery::from).collect(), + timestamp: value.timestamp, + } + } +} + +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Delivery { + contact: Contact, + id: String, +} + +impl Delivery { + pub fn contact(&self) -> &Contact { + &self.contact + } + + pub fn id(&self) -> &str { + &self.id + } +} + +impl From for Delivery { + fn from(value: WireDeliveredEmail) -> Self { + Self { + contact: Contact::from(value.contact), + id: value.email, + } + } +} + +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Contact { + id: String, + email: String, +} + +impl Contact { + pub fn id(&self) -> &str { + &self.id + } + + pub fn email(&self) -> &str { + &self.email + } +} + +impl From for Contact { + fn from(value: WireContact) -> Self { + Self { + id: value.id, + email: value.email, + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + use crate::wire::WireSendResponse; + use serde_json::json; + + #[test] + fn deserializes_success_response_into_domain_types() { + let response = serde_json::from_value::(json!({ + "success": true, + "data": { + "emails": [ + { + "contact": { + "id": "cnt_abc123", + "email": "user@example.com" + }, + "email": "ac32f08e-c6b9-45d3-9824-a73dff1e3bbf" + } + ], + "timestamp": "2025-01-15T10:30:00.000Z" + } + })) + .unwrap(); + + let response = SendResponse::from(response.data); + + assert_eq!(response.deliveries().len(), 1); + assert_eq!( + response.deliveries()[0].contact().email(), + "user@example.com" + ); + assert_eq!( + response.deliveries()[0].id(), + "ac32f08e-c6b9-45d3-9824-a73dff1e3bbf" + ); + } +} diff --git a/src/util.rs b/src/util.rs new file mode 100644 index 0000000..af0e48c --- /dev/null +++ b/src/util.rs @@ -0,0 +1,66 @@ +use crate::error::{Error, Result}; +use serde::Serialize; +use serde_json::{Map, Value}; + +pub(crate) fn serialize_data_map(data: T) -> Result> +where + T: Serialize, +{ + match serde_json::to_value(data).map_err(Error::TemplateDataSerialization)? { + Value::Object(map) => Ok(map), + _ => Err(Error::TemplateDataMustBeObject), + } +} + +pub(crate) fn normalize_email(value: String) -> Result { + let trimmed = value.trim(); + if trimmed.is_empty() { + return Err(Error::InvalidEmailAddress { + reason: "email cannot be empty", + value, + }); + } + if trimmed.contains(char::is_whitespace) { + return Err(Error::InvalidEmailAddress { + reason: "email cannot contain whitespace", + value, + }); + } + + let mut parts = trimmed.split('@'); + let local = parts.next().unwrap_or_default(); + let domain = parts.next().unwrap_or_default(); + if local.is_empty() || domain.is_empty() || parts.next().is_some() { + return Err(Error::InvalidEmailAddress { + reason: "email must contain exactly one @ with non-empty local and domain parts", + value, + }); + } + if !domain.contains('.') { + return Err(Error::InvalidEmailAddress { + reason: "email domain must contain a dot", + value, + }); + } + + Ok(trimmed.to_string()) +} + +pub(crate) fn normalize_non_empty(value: String, error: Error) -> Result { + let trimmed = value.trim(); + if trimmed.is_empty() { + return Err(error); + } + Ok(trimmed.to_string()) +} + +pub(crate) fn normalize_header_key(value: String) -> Result { + let trimmed = value.trim(); + if trimmed.is_empty() { + return Err(Error::InvalidHeaderName); + } + if trimmed.contains(':') { + return Err(Error::InvalidHeaderName); + } + Ok(trimmed.to_string()) +} diff --git a/src/wire.rs b/src/wire.rs new file mode 100644 index 0000000..9723386 --- /dev/null +++ b/src/wire.rs @@ -0,0 +1,111 @@ +use crate::email::{Email, EmailAddress, EmailContent}; +use serde::{Deserialize, Serialize}; +use serde_json::{Map, Value}; +use std::collections::BTreeMap; + +#[derive(Clone, Debug, Serialize)] +pub(crate) struct WireEmail { + to: WireRecipients, + #[serde(skip_serializing_if = "Option::is_none")] + subject: Option, + #[serde(skip_serializing_if = "Option::is_none")] + body: Option, + #[serde(skip_serializing_if = "Option::is_none")] + template: Option, + #[serde(skip_serializing_if = "Option::is_none")] + from: Option, + #[serde(skip_serializing_if = "Map::is_empty", default)] + data: Map, + #[serde(skip_serializing_if = "BTreeMap::is_empty", default)] + headers: BTreeMap, + #[serde(rename = "reply", skip_serializing_if = "Option::is_none")] + reply: Option, +} + +impl From<&Email> for WireEmail { + fn from(value: &Email) -> Self { + let (subject, body, template) = match &value.content { + EmailContent::Html { subject, body } => { + (Some(subject.clone()), Some(body.clone()), None) + } + EmailContent::Template { template_id } => (None, None, Some(template_id.clone())), + }; + + Self { + to: WireRecipients::from(value.recipients()), + subject, + body, + template, + from: value.from.as_ref().map(WireEmailAddress::from), + data: value.data.clone(), + headers: value.headers.clone(), + reply: value.reply_to.as_ref().map(|a| a.email.clone()), + } + } +} + +#[derive(Clone, Debug, Serialize)] +#[serde(untagged)] +enum WireRecipients { + One(WireEmailAddress), + Many(Vec), +} + +impl From<&[EmailAddress]> for WireRecipients { + fn from(value: &[EmailAddress]) -> Self { + match value { + [only] => Self::One(WireEmailAddress::from(only)), + many => Self::Many(many.iter().map(WireEmailAddress::from).collect()), + } + } +} + +#[derive(Clone, Debug, Serialize)] +#[serde(untagged)] +enum WireEmailAddress { + Plain(String), + Named { name: String, email: String }, +} + +impl From<&EmailAddress> for WireEmailAddress { + fn from(value: &EmailAddress) -> Self { + match &value.name { + Some(name) => Self::Named { + name: name.clone(), + email: value.email.clone(), + }, + None => Self::Plain(value.email.clone()), + } + } +} + +#[derive(Clone, Debug, Deserialize)] +pub(crate) struct WireSendResponse { + pub(crate) success: bool, + pub(crate) data: WireSendResponseData, +} + +#[derive(Clone, Debug, Deserialize)] +pub(crate) struct WireSendResponseData { + pub(crate) emails: Vec, + pub(crate) timestamp: String, +} + +#[derive(Clone, Debug, Deserialize)] +pub(crate) struct WireDeliveredEmail { + pub(crate) contact: WireContact, + pub(crate) email: String, +} + +#[derive(Clone, Debug, Deserialize)] +pub(crate) struct WireContact { + pub(crate) id: String, + pub(crate) email: String, +} + +#[derive(Clone, Debug, Deserialize)] +pub(crate) struct WireApiError { + pub(crate) code: i64, + pub(crate) error: String, + pub(crate) message: String, +}