1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

use error_chain::error_chain;
use reqwest::blocking::Response;
use reqwest::StatusCode;
use serde::de::DeserializeOwned;
use std::collections::HashMap;
use std::io::Read;

const BASE_URL: &str = "https://api.datamaxiplus.com/api/v1";

/// A trait that defines the required methods for interacting with the Datamaxi+ API.
pub trait Datamaxi {
    /// Creates a new instance of the implementing type using the provided API key.
    fn new(api_key: String) -> Self;

    /// Creates a new instance of the implementing type using the provided API key and base URL.
    fn new_with_base_url(api_key: String, base_url: String) -> Self;
}

/// The configuration for the Datamaxi+ API client.
pub struct Config {
    /// The base URL for the API.
    pub base_url: Option<String>,

    /// The API key used for authentication.
    pub api_key: String,
}

/// The client for interacting with the Datamaxi+ API.
#[derive(Clone)]
pub struct Client {
    base_url: String,
    api_key: String,
    inner_client: reqwest::blocking::Client,
}

impl Client {
    /// Creates a new instance of the `Client` struct with the provided configuration.
    pub fn new(config: Config) -> Self {
        Client {
            base_url: config.base_url.unwrap_or(BASE_URL.to_string()),
            api_key: config.api_key,
            inner_client: reqwest::blocking::Client::builder()
                .pool_idle_timeout(None)
                .build()
                .unwrap(),
        }
    }

    /// Builds a request string from a set of parameters.
    fn build_request(parameters: HashMap<String, String>) -> String {
        parameters
            .iter()
            .map(|(key, value)| format!("{}={}", key, value))
            .collect::<Vec<String>>()
            .join("&")
    }

    /// Sends a GET request to the specified endpoint with optional parameters.
    pub fn get<T: DeserializeOwned>(
        &self,
        endpoint: &'static str,
        parameters: Option<HashMap<String, String>>,
    ) -> Result<T> {
        let mut url: String = format!("{}{}", self.base_url, endpoint);

        if let Some(p) = parameters {
            let request = Self::build_request(p);

            if !request.is_empty() {
                url.push_str(format!("?{}", request).as_str());
            }
        }

        let client = &self.inner_client;
        let response = client
            .get(url.as_str())
            .header("X-DTMX-APIKEY", &self.api_key)
            .send()?;

        self.handle_response(response)
    }

    /// Processes the response from the API and returns the result.
    fn handle_response<T: DeserializeOwned>(&self, response: Response) -> Result<T> {
        match response.status() {
            StatusCode::OK => Ok(response.json::<T>()?),
            StatusCode::INTERNAL_SERVER_ERROR => {
                let mut response_text = String::new();
                response.take(1000).read_to_string(&mut response_text)?;
                Err(ErrorKind::InternalServerError(response_text).into())
            }
            StatusCode::UNAUTHORIZED => Err(ErrorKind::Unauthorized.into()),
            StatusCode::BAD_REQUEST => {
                let mut response_text = String::new();
                response.take(1000).read_to_string(&mut response_text)?;
                Err(ErrorKind::BadRequest(response_text).into())
            }
            status => Err(ErrorKind::UnexpectedStatusCode(status.as_u16()).into()),
        }
    }
}

error_chain! {
    errors {
        /// Represents an error that occurs when a request to the API returns a bad request status.
        BadRequest(msg: String) {
            description("Bad request")
            display("Bad request: {}", msg)
        }

        /// Represents an error that occurs when a request to the API returns an unauthorized status.
        Unauthorized {
            description("Unauthorized")
            display("Unauthorized")
        }

        /// Represents an error that occurs when a request to the API returns an internal server error status.
        InternalServerError(msg: String) {
            description("Internal server error")
            display("Internal server error: {}", msg)
        }

        /// Represents an error that occurs when a request to the API returns an unexpected status code.
        UnexpectedStatusCode(status: u16) {
            description("Unexpected status code")
            display("Received unexpected status code: {}", status)
        }
     }

    foreign_links {
        ReqError(reqwest::Error);
        InvalidHeaderError(reqwest::header::InvalidHeaderValue);
        IoError(std::io::Error);
        ParseFloatError(std::num::ParseFloatError);
        UrlParserError(url::ParseError);
        Json(serde_json::Error);
        Tungstenite(tungstenite::Error);
        TimestampError(std::time::SystemTimeError);
    }
}