From b74d7b46f7cc0bcb9a1e31fe4f0b75f32635a495 Mon Sep 17 00:00:00 2001
From: Oghenemarho Orukele <orukele.dev@gmail.com>
Date: Wed, 14 Aug 2024 20:20:18 +0200
Subject: [PATCH 1/2] finished data models for the send event route of terminal
 endpoint

---
 .github/workflows/rust.yml         | 29 +++---------
 README.md                          |  4 +-
 src/client.rs                      |  8 +++-
 src/endpoints/mod.rs               |  2 +
 src/endpoints/subaccount.rs        |  2 +-
 src/endpoints/terminal.rs          | 40 ++++++++++++++++
 src/endpoints/transaction.rs       |  2 +-
 src/endpoints/transaction_split.rs |  2 +-
 src/models/mod.rs                  |  2 +
 src/models/terminal_model.rs       | 74 ++++++++++++++++++++++++++++++
 10 files changed, 136 insertions(+), 29 deletions(-)
 create mode 100644 src/endpoints/terminal.rs
 create mode 100644 src/models/terminal_model.rs

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 8ce7e1a..655634b 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -1,7 +1,7 @@
 name: Rust
 on:
   push:
-    branches: [ "main", "master" ]
+    branches: ["main", "master"]
 env:
   CARGO_TERM_COLOR: always
   PAYSTACK_API_KEY: ${{secrets.PAYSTACK_API_KEY}}
@@ -12,25 +12,8 @@ jobs:
   build-and-test:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: Build
-      run: cargo build --verbose
-    - name: Run tests
-      run: cargo test --verbose
-  coverage:
-    runs-on: ubuntu-latest
-    env:
-      CARGO_TERM_COLOR: always
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install Rust
-        run: rustup update stable
-      - name: Install cargo-llvm-cov
-        uses: taiki-e/install-action@cargo-llvm-cov
-      - name: Generate code coverage
-        run: cargo llvm-cov --all-features --workspace --lcov --output-path lcov.info
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v3
-        with:
-          files: lcov.info
-          fail_ci_if_error: true
\ No newline at end of file
+      - uses: actions/checkout@v3
+      - name: Build
+        run: cargo build --verbose
+      - name: Run tests
+        run: cargo test --verbose
diff --git a/README.md b/README.md
index 826aa9b..dbf36be 100644
--- a/README.md
+++ b/README.md
@@ -94,8 +94,8 @@ async fn main() -> Result<(), PaystackAPIError> {
 ```
 
 ### Examples
-We provide some examples of use cases for the Paystack-rs crate. The examples are located in the [examples](examples) folder.
 
+We provide some examples of use cases for the Paystack-rs crate. The examples are located in the [examples](examples) folder.
 
 ## Contributing
 
@@ -105,13 +105,13 @@ We use Github actions to conduct CI/CD for the crate. It ensure that code is for
 as proper linting using `cargo clippy`, and finally run all the integration and unit test using `cargo test`.
 
 ### Crate module schematic diagram
+
 A conceptual overview of the crate is illustrated below. This is to help improve the understanding of how the different
 parts of the crate interact with each other to work efficiently. The `PaystackClient` module is the central module of
 the crate and the best entry point to explore the different parts of the crate.
 
 ![Crate Schematic](docs/images/paystack-rs.png)
 
-
 ## License
 
 Licensed under MIT license ([LICENSE-MIT](/LICENSE-MIT)).
diff --git a/src/client.rs b/src/client.rs
index 80ed181..ca82acf 100644
--- a/src/client.rs
+++ b/src/client.rs
@@ -1,7 +1,10 @@
 //! Client
 //! =========
 //! This file contains the Paystack API client, and it associated endpoints.
-use crate::{HttpClient, SubaccountEndpoints, TransactionEndpoints, TransactionSplitEndpoints};
+use crate::{
+    HttpClient, SubaccountEndpoints, TerminalEndpoints, TransactionEndpoints,
+    TransactionSplitEndpoints,
+};
 use std::sync::Arc;
 
 /// This is the entry level struct for the paystack API.
@@ -13,6 +16,8 @@ pub struct PaystackClient<T: HttpClient + Default> {
     pub transaction_split: TransactionSplitEndpoints<T>,
     /// Subaccount API route
     pub subaccount: SubaccountEndpoints<T>,
+    /// Terminal API route
+    pub terminal: TerminalEndpoints<T>,
 }
 
 impl<T: HttpClient + Default> PaystackClient<T> {
@@ -23,6 +28,7 @@ impl<T: HttpClient + Default> PaystackClient<T> {
             transaction: TransactionEndpoints::new(api_key.clone(), Arc::clone(&http)),
             transaction_split: TransactionSplitEndpoints::new(api_key.clone(), Arc::clone(&http)),
             subaccount: SubaccountEndpoints::new(api_key.clone(), Arc::clone(&http)),
+            terminal: TerminalEndpoints::new(api_key.clone(), Arc::clone(&http)),
         }
     }
 }
diff --git a/src/endpoints/mod.rs b/src/endpoints/mod.rs
index 568ab91..652fe1f 100644
--- a/src/endpoints/mod.rs
+++ b/src/endpoints/mod.rs
@@ -1,8 +1,10 @@
 pub mod subaccount;
+pub mod terminal;
 pub mod transaction;
 pub mod transaction_split;
 
 // public re-export
 pub use subaccount::*;
+pub use terminal::*;
 pub use transaction::*;
 pub use transaction_split::*;
diff --git a/src/endpoints/subaccount.rs b/src/endpoints/subaccount.rs
index f98d7de..4a3c38e 100644
--- a/src/endpoints/subaccount.rs
+++ b/src/endpoints/subaccount.rs
@@ -18,7 +18,7 @@ pub struct SubaccountEndpoints<T: HttpClient + Default> {
 }
 
 impl<T: HttpClient + Default> SubaccountEndpoints<T> {
-    /// Constructor for the Subaccount object
+    /// Constructor
     pub fn new(key: String, http: Arc<T>) -> SubaccountEndpoints<T> {
         let base_url = String::from("https://api.paystack.co/subaccount");
         SubaccountEndpoints {
diff --git a/src/endpoints/terminal.rs b/src/endpoints/terminal.rs
new file mode 100644
index 0000000..4317be2
--- /dev/null
+++ b/src/endpoints/terminal.rs
@@ -0,0 +1,40 @@
+//! Terminal
+//! ========
+//! The Terminal API allows you to build delightful in-person payment experiences.
+
+use std::sync::Arc;
+
+use crate::{EventRequest, HttpClient, PaystackResult, SendEventResponseData};
+
+/// A struct to hold all the functions of the terminal API endpoint
+#[derive(Debug, Clone)]
+pub struct TerminalEndpoints<T: HttpClient + Default> {
+    key: String,
+    base_url: String,
+    http: Arc<T>,
+}
+
+impl<T: HttpClient + Default> TerminalEndpoints<T> {
+    /// Constructor
+    pub fn new(key: String, http: Arc<T>) -> TerminalEndpoints<T> {
+        let base_url = String::from("https://api.paystack.co/terminal");
+        TerminalEndpoints {
+            key,
+            base_url,
+            http,
+        }
+    }
+
+    /// Send an event from your application to the Paystack Terminal
+    ///
+    /// Takes in the following:
+    ///     - `terminal_id`: The ID of the Terminal the event should be sent to.
+    ///     - `EventRequest`: A struct containing the information of the event to send to the terminal. It is created with the `EventRequestBuilder`.
+    pub fn send_event(
+        &self,
+        terminal_id: String,
+        event_request: EventRequest,
+    ) -> PaystackResult<SendEventResponseData> {
+        todo!()
+    }
+}
diff --git a/src/endpoints/transaction.rs b/src/endpoints/transaction.rs
index b3ecac5..102606e 100644
--- a/src/endpoints/transaction.rs
+++ b/src/endpoints/transaction.rs
@@ -21,7 +21,7 @@ pub struct TransactionEndpoints<T: HttpClient + Default> {
 }
 
 impl<T: HttpClient + Default> TransactionEndpoints<T> {
-    /// Constructor for the transaction object
+    /// Constructor
     pub fn new(key: String, http: Arc<T>) -> TransactionEndpoints<T> {
         let base_url = String::from("https://api.paystack.co/transaction");
         TransactionEndpoints {
diff --git a/src/endpoints/transaction_split.rs b/src/endpoints/transaction_split.rs
index ce19082..4431ae4 100644
--- a/src/endpoints/transaction_split.rs
+++ b/src/endpoints/transaction_split.rs
@@ -18,7 +18,7 @@ pub struct TransactionSplitEndpoints<T: HttpClient + Default> {
 }
 
 impl<T: HttpClient + Default> TransactionSplitEndpoints<T> {
-    /// Constructor for the transaction object
+    /// Constructor
     pub fn new(key: String, http: Arc<T>) -> TransactionSplitEndpoints<T> {
         let base_url = String::from("https://api.paystack.co/split");
         TransactionSplitEndpoints {
diff --git a/src/models/mod.rs b/src/models/mod.rs
index 96695a1..d8ec405 100644
--- a/src/models/mod.rs
+++ b/src/models/mod.rs
@@ -7,6 +7,7 @@ pub mod response;
 pub mod split;
 pub mod status;
 pub mod subaccount_model;
+pub mod terminal_model;
 pub mod transaction_model;
 pub mod transaction_split_model;
 
@@ -20,5 +21,6 @@ pub use response::*;
 pub use split::*;
 pub use status::*;
 pub use subaccount_model::*;
+pub use terminal_model::*;
 pub use transaction_model::*;
 pub use transaction_split_model::*;
diff --git a/src/models/terminal_model.rs b/src/models/terminal_model.rs
new file mode 100644
index 0000000..7d17c7c
--- /dev/null
+++ b/src/models/terminal_model.rs
@@ -0,0 +1,74 @@
+//! Terminal
+//! ==========
+//! This file contains the models and options for the Terminal endpoint of the Paystack
+
+use derive_builder::Builder;
+use serde::{Deserialize, Serialize};
+use std::fmt;
+
+/// The request body to send an event from your application to the Paystack Terminal
+#[derive(Debug, Clone, Builder, Serialize, Deserialize)]
+pub struct EventRequest {
+    #[serde(rename = "type")]
+    pub event_type: EventType,
+    pub action: TerminalAction,
+    pub data: EventRequestData,
+}
+
+/// The paramters needed to perform the specified action.
+///
+/// For the invoice type, you need to pass the invoice id and offline reference: {id: invoice_id, reference: offline_reference}.
+///
+/// For the transaction type, you can pass the transaction id: {id: transaction_id}, reference field can be `None`
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct EventRequestData {
+    pub id: String,
+    pub reference: Option<String>,
+}
+
+/// The type of event to push.
+/// Paystack currently support `invoice` and `transaction`
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub enum EventType {
+    Invoice,
+    Transaction,
+}
+
+/// The action the Terminal needs to perform.
+///
+/// - For the `Invoice` type, the action can either be `Process` or `View`.
+///
+/// - For the `Transaction` type, the action can either be `Process` or `Print`.
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub enum TerminalAction {
+    Process,
+    View,
+    Print,
+}
+
+impl fmt::Display for TerminalAction {
+    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
+        let action = match self {
+            TerminalAction::Process => "process",
+            TerminalAction::Print => "print",
+            TerminalAction::View => "view",
+        };
+        write!(f, "{}", action)
+    }
+}
+
+impl fmt::Display for EventType {
+    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
+        let event = match self {
+            EventType::Invoice => "invoice",
+            EventType::Transaction => "transaction",
+        };
+        write!(f, "{}", event)
+    }
+}
+
+/// Contains response data for the send event route in the terminal endpoint.
+#[derive(Serialize, Deserialize, Debug, Clone)]
+pub struct SendEventResponseData {
+    pub id: String,
+}

From 0b4527f4c71e9edb28c1474471c17f8755ee6311 Mon Sep 17 00:00:00 2001
From: Oghenemarho Orukele <orukele.dev@gmail.com>
Date: Mon, 9 Jun 2025 23:13:51 +0200
Subject: [PATCH 2/2] updated diagrams to use mermaid instead of a static one

---
 README.md                   |  39 ++++++++++++++++---
 docs/images/paystack-rs.png | Bin 25079 -> 0 bytes
 docs/uml/paystack-rs.drawio |  72 ------------------------------------
 src/http/base.rs            |   1 -
 4 files changed, 34 insertions(+), 78 deletions(-)
 delete mode 100644 docs/images/paystack-rs.png
 delete mode 100644 docs/uml/paystack-rs.drawio

diff --git a/README.md b/README.md
index dbf36be..c8c06e1 100644
--- a/README.md
+++ b/README.md
@@ -5,9 +5,9 @@
 [![paystack-rs  on docs.rs](https://docs.rs/paystack-rs/badge.svg)](https://docs.rs/paystack-rs)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
->*NB: a core rewrite of the project is being carried out, the goal is to make the crate easier to maintain,  
-improve the performance, abstract certain features to improve flexibility, and support for both blocking and non-blocking
-operations.*
+> _NB: a core rewrite of the project is being carried out, the goal is to make the crate easier to maintain,  
+> improve the performance, abstract certain features to improve flexibility, and support for both blocking and non-blocking
+> operations._
 
 Convenient Rust bindings and types for the [Paystack](https://paystack.com) HTTP API aiming to support the entire API surface. Not the case? Please open an issue. I update the definitions on a weekly basis.
 
@@ -68,7 +68,7 @@ async fn main() -> Result<(), PaystackAPIError> {
     let api_key = env::var("PAYSTACK_API_KEY").unwrap();
     let client = PaystackClient<ReqwestClient>::new(api_key);
 
-    
+
     let email = "email@example.com".to_string();
     let amount ="10_000".to_string();
     let body = TransactionRequestBuilder::default()
@@ -110,7 +110,36 @@ A conceptual overview of the crate is illustrated below. This is to help improve
 parts of the crate interact with each other to work efficiently. The `PaystackClient` module is the central module of
 the crate and the best entry point to explore the different parts of the crate.
 
-![Crate Schematic](docs/images/paystack-rs.png)
+```mermaid
+---
+config:
+  layout: dagre
+  theme: default
+---
+flowchart TD
+ subgraph subGraph0["HTTP Layer"]
+        HTTPClient["&lt;Trait&gt; HTTPClient"]
+        ReqwestClient["ReqwestClient"]
+        OtherClients["OtherClients"]
+  end
+ subgraph Core["Core"]
+        Models["Models"]
+        APIEndpoints["APIEndpoints"]
+        Macros["Macros"]
+  end
+ subgraph Types["Types"]
+        Response["Response"]
+        Request["Request"]
+        Error["Error"]
+  end
+    ReqwestClient --> HTTPClient
+    OtherClients --> HTTPClient
+    HTTPClient --> PaystackClient["PaystackClient"]
+    PaystackClient --> APIEndpoints
+    APIEndpoints --> Models
+    Macros --> Models & APIEndpoints
+    Models --> Response & Request & Error
+```
 
 ## License
 
diff --git a/docs/images/paystack-rs.png b/docs/images/paystack-rs.png
deleted file mode 100644
index bb20ceeea98938d2483ee6c9afd0181cab1d5ab9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 25079
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
WtLF8COYlt&6vuQ==sY}X8}?s`7n!F3

diff --git a/docs/uml/paystack-rs.drawio b/docs/uml/paystack-rs.drawio
deleted file mode 100644
index ce84b80..0000000
--- a/docs/uml/paystack-rs.drawio
+++ /dev/null
@@ -1,72 +0,0 @@
-<mxfile host="app.diagrams.net" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36" version="24.7.4">
-  <diagram name="Page-1" id="9f46799a-70d6-7492-0946-bef42562c5a5">
-    <mxGraphModel dx="1294" dy="795" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="1100" pageHeight="850" math="0" shadow="0">
-      <root>
-        <mxCell id="0" />
-        <mxCell id="1" parent="0" />
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-4" value="PaystackClient" style="html=1;shadow=0;rounded=1;strokeWidth=2;fillColor=#ffe6cc;strokeColor=#d79b00;" parent="1" vertex="1">
-          <mxGeometry x="490" y="320" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-27" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;shadow=0;endSize=10;startSize=10;endArrow=blockThin;endFill=1;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-5" target="fZQMMibaLwoMHF9H-6lI-4" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-35" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;shadow=0;endArrow=block;endFill=1;endSize=10;startSize=10;dashed=1;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-5" target="fZQMMibaLwoMHF9H-6lI-17" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-36" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;shadow=0;endArrow=block;endFill=1;endSize=10;startSize=10;dashed=1;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-5" target="fZQMMibaLwoMHF9H-6lI-18" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-5" value="«Trait»&lt;br&gt;&lt;b&gt;HTTPClient&lt;/b&gt;" style="html=1;shadow=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="330" y="320" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-17" value="ReqwestClient" style="html=1;shadow=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="180" y="390" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-18" value="Other Clients" style="html=1;shadow=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="180" y="250" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-28" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;shadow=0;endArrow=diamondThin;endFill=1;jumpSize=6;startSize=10;endSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-19" target="fZQMMibaLwoMHF9H-6lI-4" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-29" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-19" target="fZQMMibaLwoMHF9H-6lI-20" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-19" value="APIEnpoints" style="html=1;rounded=1;shadow=0;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="490" y="420" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-20" value="Models" style="html=1;shadow=0;glass=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="660" y="420" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-31" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-21" edge="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="770" y="445" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-21" value="Request" style="html=1;shadow=0;glass=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="820" y="420" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-30" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-22" target="fZQMMibaLwoMHF9H-6lI-20" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-22" value="Response" style="html=1;shadow=0;glass=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="820" y="340" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-32" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-23" target="fZQMMibaLwoMHF9H-6lI-20" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-23" value="Error" style="html=1;shadow=0;glass=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="820" y="500" width="110" height="50" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-33" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-24" target="fZQMMibaLwoMHF9H-6lI-20" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-34" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;shadow=0;endSize=10;startSize=10;strokeWidth=2;" parent="1" source="fZQMMibaLwoMHF9H-6lI-24" target="fZQMMibaLwoMHF9H-6lI-19" edge="1">
-          <mxGeometry relative="1" as="geometry" />
-        </mxCell>
-        <mxCell id="fZQMMibaLwoMHF9H-6lI-24" value="Macros" style="html=1;shadow=0;glass=0;rounded=1;strokeWidth=2;" parent="1" vertex="1">
-          <mxGeometry x="660" y="540" width="110" height="50" as="geometry" />
-        </mxCell>
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>
diff --git a/src/http/base.rs b/src/http/base.rs
index ef266c2..a3655a0 100644
--- a/src/http/base.rs
+++ b/src/http/base.rs
@@ -13,7 +13,6 @@ pub type Query<'a> = Vec<(&'a str, &'a str)>;
 /// with their preferred HTTP client.
 /// To be as generic as possible, the U generic stands for the HTTP response.
 /// Ideally, it should be bounded to specific traits common in all response.
-/// TODO: Bound the U generic to the appropriate traits.
 
 #[async_trait]
 pub trait HttpClient: Debug + Default + Clone + Send {