feat(all): expand

.github/dependabot.yaml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      timezone: "Europe/Amsterdam"
+      day: "friday"
+      time: "18:00"

.gitignore

@@ -1,16 +1,23 @@
+# OS
+Thumbs.db
+.DS_Store
+*.pdb
+
+# Editors
+.vs/
+.vscode/
+.idea/
+.fleet/
+
 # Generated by Cargo
 # will have compiled files and executables
 debug/
 target/
-
+gen/
 
 # Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
 # More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
 Cargo.lock
 
-
 # These are backup files generated by rustfmt
 **/*.rs.bk
-
-# MSVC Windows builds of rustc generate these, which store debugging information
-*.pdb

CHANGELOG.md

@@ -1,17 +1,19 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 <!-- ## [Unreleased] -->
 
 ## [0.3.0] - 2024-02-06
 
 ### Changed
 
-- `Mail::new` now accepts a list of `to` addresses and thus supports sending an email to multiple
-  recipients.
+- `Mail::new` now accepts a list of `to` addresses and thus supports sending an
+  email to multiple recipients.
 
   ```rs
   // Before:

Cargo.toml

@@ -1,16 +1,37 @@
+# https://doc.rust-lang.org/cargo/reference/manifest.html
+
 [package]
 name = "resend-rs"
-description = "A very minimal Resend client for sending emails."
-version = "0.3.0"
+version = "0.4.0"
 edition = "2021"
-repository = "https://github.com/AntoniosBarotsis/resend-rs"
 license = "GPL-3.0"
+readme = "./README.md"
+
+authors = ["Antonios Barotsis <[email protected]>"]
+repository = "https://github.com/AntoniosBarotsis/resend-rs"
+homepage = "https://github.com/AntoniosBarotsis/resend-rs"
+documentation = "https://docs.rs/resend-rs"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+categories = ["email", "web-programming"]
+keywords = ["email", "resend"]
+description = "A minimal Resend client."
+
+[package.metadata.docs.rs]
+all-features = false
+rustdoc-args = ["--cfg", "docsrs"]
 
 [features]
-async = []
+default = ["native-tls"]
+
+blocking = ["reqwest/blocking"]
+native-tls = ["reqwest/native-tls"]
+rustls-tls = ["reqwest/rustls-tls"]
 
 [dependencies]
-reqwest = { version = "0.11", default-features = false, features = ["rustls-tls", "blocking"] }
-thiserror = "1.0.43"
+reqwest = { version = "0.12.3", default-features = false, features = ["json"] }
+serde = { version = "1.0.197", features = ["derive"] }
+serde_json = { version = "1.0.115", features = [] }
+thiserror = { version = "1.0.58", features = [] }
+
+[dev-dependencies]
+tokio = { version = "1.37.0", features = ["macros", "test-util", "rt-multi-thread"] }

README.md

@@ -1,13 +1,37 @@
-# resend-rs
+## resend-rs
 
-[![Crates.io](https://img.shields.io/crates/v/resend-rs)](https://crates.io/crates/resend-rs)
-[![docs.rs](https://img.shields.io/docsrs/resend-rs)](https://docs.rs/resend-rs)
+[![Build Status][action-badge]][action-url]
+[![Crate Docs][docs-badge]][docs-url]
+[![Crate Version][crates-badge]][crates-url]
 
-A *very* minimal [Resend](https://resend.com) client for sending emails.
+A minimal [Resend](https://resend.com) client.
 
-Emails are sent via the [`resend_client::ResendClient`] which provides both a synchronous and
-asynchronous send method. The two are mutually exclusive and accessible via the `async` feature. The
-crate uses [`reqwest`](https://github.com/seanmonstar/reqwest) internally.
+[action-badge]: https://img.shields.io/github/actions/workflow/status/AntoniosBarotsis/resend-rs/ci.yml
+[action-url]: https://github.com/spire-rs/AntoniosBarotsis/resend-rs/workflows/build.yaml
+[crates-badge]: https://img.shields.io/crates/v/resend-rs
+[crates-url]: https://crates.io/crates/resend-rs
+[docs-badge]: https://img.shields.io/docsrs/resend-rs
+[docs-url]: https://docs.rs/resend-rs
 
-Currently, this only supports the `html` Resend parameter as I built this for my own use and
-that's all I need. If anyone else is looking into this, however, I would not mind expanding it.
+Emails are sent via the `Client` which provides both a synchronous and
+asynchronous send method. The two are mutually exclusive and accessible via the
+`blocking` feature. The crate uses [reqwest][reqwest] and [serde][serde]
+internally.
+
+[reqwest]: https://github.com/seanmonstar/reqwest
+[serde]: https://github.com/serde-rs/serde
+
+If anyone else is looking into this, however, I would not mind expanding it.
+
+#### Features
+
+- `blocking` to enable the blocking client.
+- `native-tls` to use system-native TLS. **Enabled by default**.
+- `rustls-tls` to use TLS backed by rustls .
+
+#### Variables
+
+- `RESEND_API_KEY` to enable `impl Default` for a `Client`.
+- `RESEND_BASE_URL` to override the default base address:
+  `https://api.resend.com`.
+- `RESEND_USER_AGENT` to override the default user-agent: `resend-rs/0.1.0`.

rustfmt.toml

@@ -1,2 +1,2 @@
-tab_spaces = 2
+# tab_spaces = 2
 edition ="2021"

src/api_keys.rs

@@ -0,0 +1,192 @@
+use std::fmt;
+use std::sync::Arc;
+
+use reqwest::Method;
+
+use crate::types::{CreateApiKeyRequest, CreateApiKeyResponse, ListApiKeysResponse};
+use crate::{Config, Result};
+
+/// `Resend` APIs for `METHOD /api-keys` endpoints.
+#[derive(Clone)]
+pub struct ApiKeys(pub(crate) Arc<Config>);
+
+impl ApiKeys {
+    /// Add a new API key to authenticate communications with Resend.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/create-api-key>
+    #[cfg(not(feature = "blocking"))]
+    #[cfg_attr(docsrs, doc(cfg(not(feature = "blocking"))))]
+    pub async fn create(&self, api_key: CreateApiKeyRequest) -> Result<CreateApiKeyResponse> {
+        let request = self.0.build(Method::POST, "/api-keys");
+        let response = request.json(&api_key).send().await?;
+        let content = response.json::<CreateApiKeyResponse>().await?;
+
+        Ok(content)
+    }
+
+    /// Retrieve a list of API keys for the authenticated user.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/list-api-keys>
+    #[cfg(not(feature = "blocking"))]
+    #[cfg_attr(docsrs, doc(cfg(not(feature = "blocking"))))]
+    pub async fn list(&self) -> Result<ListApiKeysResponse> {
+        let request = self.0.build(Method::GET, "/api-keys");
+        let response = request.send().await?;
+        let content = response.json::<ListApiKeysResponse>().await?;
+
+        Ok(content)
+    }
+
+    /// Remove an existing API key.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/delete-api-key>
+    #[cfg(not(feature = "blocking"))]
+    #[cfg_attr(docsrs, doc(cfg(not(feature = "blocking"))))]
+    pub async fn delete(&self, api_key_id: &str) -> Result<()> {
+        let path = format!("/api-keys/{api_key_id}");
+
+        let request = self.0.build(Method::DELETE, &path);
+        let _response = request.send().await?;
+
+        Ok(())
+    }
+
+    /// Add a new API key to authenticate communications with Resend.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/create-api-key>
+    #[cfg(feature = "blocking")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "blocking")))]
+    pub fn create(&self, api_key: CreateApiKeyRequest) -> Result<CreateApiKeyResponse> {
+        let request = self.0.build(Method::POST, "/api-keys");
+        let response = request.json(&api_key).send()?;
+        let content = response.json::<CreateApiKeyResponse>()?;
+
+        Ok(content)
+    }
+
+    /// Retrieve a list of API keys for the authenticated user.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/list-api-keys>
+    #[cfg(feature = "blocking")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "blocking")))]
+    pub fn list(&self) -> Result<ListApiKeysResponse> {
+        let request = self.0.build(Method::GET, "/api-keys");
+        let response = request.send()?;
+        let content = response.json::<ListApiKeysResponse>()?;
+
+        Ok(content)
+    }
+
+    /// Remove an existing API key.
+    ///
+    /// <https://resend.com/docs/api-reference/api-keys/delete-api-key>
+    #[cfg(feature = "blocking")]
+    #[cfg_attr(docsrs, doc(cfg(feature = "blocking")))]
+    pub fn delete(&self, api_key_id: &str) -> Result<()> {
+        let path = format!("/api-keys/{api_key_id}");
+
+        let request = self.0.build(Method::DELETE, &path);
+        let _response = request.send()?;
+
+        Ok(())
+    }
+}
+
+impl fmt::Debug for ApiKeys {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        fmt::Debug::fmt(&self.0, f)
+    }
+}
+
+pub mod types {
+    use serde::{Deserialize, Serialize};
+
+    #[must_use]
+    #[derive(Debug, Clone, Serialize)]
+    pub struct CreateApiKeyRequest {
+        /// The API key name.
+        pub name: String,
+
+        /// The API key can have full access to Resend’s API or be only restricted to send emails.
+        /// * `full_access` - Can create, delete, get, and update any resource.
+        /// * `sending_access` - Can only send emails.
+        #[serde(skip_serializing_if = "Option::is_none")]
+        pub permission: Option<Permission>,
+        /// Restrict an API key to send emails only from a specific domain.
+        /// Only used when the permission is `sending_access`.
+        #[serde(skip_serializing_if = "Option::is_none")]
+        pub domain_id: Option<String>,
+    }
+
+    impl CreateApiKeyRequest {
+        /// Creates a new [`CreateApiKeyRequest`].
+        #[inline]
+        pub fn new(name: &str) -> Self {
+            Self {
+                name: name.to_owned(),
+                permission: None,
+                domain_id: None,
+            }
+        }
+
+        /// Allows an API key to create, delete, get, and update any resource.
+        #[inline]
+        pub fn with_full_access(mut self) -> Self {
+            self.permission = Some(Permission::FullAccess);
+            self
+        }
+
+        /// Restricts an API key to only sending emails
+        #[inline]
+        pub fn with_sending_access(mut self) -> Self {
+            self.permission = Some(Permission::SendingAccess);
+            self
+        }
+
+        /// Restricts an API key to send emails only from a specific domain.
+        #[inline]
+        pub fn with_domain_access(mut self, domain_id: &str) -> Self {
+            self.permission = Some(Permission::SendingAccess);
+            self.domain_id = Some(domain_id.to_owned());
+            self
+        }
+    }
+
+    /// Full access to Resend’s API or restricted to only send emails.
+    /// * `full_access` - Can create, delete, get, and update any resource.
+    /// * `sending_access` - Can only send emails.
+    #[must_use]
+    #[derive(Debug, Copy, Clone, Serialize)]
+    pub enum Permission {
+        #[serde(rename = "full_access")]
+        FullAccess,
+        #[serde(rename = "sending_access")]
+        SendingAccess,
+    }
+
+    #[must_use]
+    #[derive(Debug, Clone, Deserialize)]
+    pub struct CreateApiKeyResponse {
+        /// The ID of the API key.
+        pub id: String,
+        /// The token of the API key.
+        pub token: String,
+    }
+
+    #[must_use]
+    #[derive(Debug, Clone, Deserialize)]
+    pub struct ListApiKeysResponse {
+        pub data: Vec<ApiKey>,
+    }
+
+    #[must_use]
+    #[derive(Debug, Clone, Deserialize)]
+    pub struct ApiKey {
+        /// The ID of the API key.
+        pub id: String,
+        /// The name of the API key.
+        pub name: String,
+        /// The date and time the API key was created.
+        pub created_at: String,
+    }
+}