feat: Adds tunnel configuration endpoints

Author: ArturoGuerra

cloudflare/src/endpoints/cfd_tunnel/create_tunnel.rs

@@ -41,8 +41,9 @@ pub struct Params<'a> {
     pub name: &'a str,
     /// The byte array (with 32 or more bytes) representing a secret for the tunnel. This is
     /// encoded into JSON as a base64 String. This secret is necessary to run the tunnel.
-    #[serde_as(as = "Base64<Standard, Padded>")]
-    pub tunnel_secret: &'a Vec<u8>,
+    #[serde_as(as = "Option<Base64<Standard, Padded>>")]
+    #[serde(default)]
+    pub tunnel_secret: Option<&'a [u8]>,
 
     pub config_src: &'a ConfigurationSrc,
 

cloudflare/src/endpoints/cfd_tunnel/data_structures.rs

@@ -1,9 +1,23 @@
+use crate::framework::response::ApiResult;
 use chrono::{offset::Utc, DateTime};
 use serde::{Deserialize, Serialize};
 use std::net::IpAddr;
 use uuid::Uuid;
 
-use crate::framework::response::ApiResult;
+#[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq)]
+pub struct TunnelToken(String);
+
+impl From<String> for TunnelToken {
+    fn from(s: String) -> TunnelToken {
+        TunnelToken(s)
+    }
+}
+
+impl From<TunnelToken> for String {
+    fn from(s: TunnelToken) -> String {
+        s.0
+    }
+}
 
 /// A Cfd Tunnel
 /// This is an Cfd Tunnel that has been created. It can be used for routing and subsequent running.
@@ -127,6 +141,7 @@ pub struct OriginRequest {
 impl ApiResult for TunnelConfiguration {}
 impl ApiResult for Tunnel {}
 impl ApiResult for Vec<Tunnel> {}
+impl ApiResult for TunnelToken {}
 
 #[derive(Deserialize, Serialize, Debug, Clone, PartialEq, Eq)]
 pub struct TunnelConfigurationResult {

cloudflare/src/endpoints/cfd_tunnel/get_tunnel.rs

@@ -0,0 +1,35 @@
+use crate::endpoints::cfd_tunnel::{ConfigurationSrc, Tunnel};
+use serde::Serialize;
+use serde_with::{
+    base64::{Base64, Standard},
+    formats::Padded,
+    serde_as,
+};
+
+use crate::framework::endpoint::{EndpointSpec, Method};
+
+/// Create a Cfd Tunnel
+/// This creates the Tunnel, which can then be routed and ran. Creating the Tunnel per se is only
+/// a metadata operation (i.e. no Tunnel is running at this point).
+/// <https://developers.cloudflare.com/api/operations/cloudflare-tunnel-create-a-cloudflare-tunnel>
+#[derive(Debug)]
+pub struct GetTunnel<'a> {
+    pub account_identifier: &'a str,
+    pub tunnel_id: &'a str,
+}
+
+impl<'a> EndpointSpec<Tunnel> for GetTunnel<'a> {
+    fn method(&self) -> Method {
+        Method::GET
+    }
+    fn path(&self) -> String {
+        format!(
+            "accounts/{}/cfd_tunnel/{}",
+            self.account_identifier, self.tunnel_id
+        )
+    }
+    #[inline]
+    fn body(&self) -> Option<String> {
+        None
+    }
+}

cloudflare/src/endpoints/cfd_tunnel/get_tunnel_token.rs

@@ -0,0 +1,28 @@
+use crate::framework::endpoint::{serialize_query, EndpointSpec, Method};
+use serde::Serialize;
+
+use super::TunnelToken as TunnelTokenResult;
+
+/// Delete a tunnel
+/// <https://developers.cloudflare.com/api/operations/cloudflare-tunnel-delete-a-cloudflare-tunnel>
+#[derive(Debug)]
+pub struct TunnelToken<'a> {
+    pub account_identifier: &'a str,
+    pub tunnel_id: &'a str,
+}
+
+impl<'a> EndpointSpec<TunnelTokenResult> for TunnelToken<'a> {
+    fn method(&self) -> Method {
+        Method::GET
+    }
+    fn path(&self) -> String {
+        format!(
+            "accounts/{}/cfd_tunnel/{}/token",
+            self.account_identifier, self.tunnel_id
+        )
+    }
+    #[inline]
+    fn body(&self) -> Option<String> {
+        None
+    }
+}

cloudflare/src/endpoints/cfd_tunnel/mod.rs

@@ -2,6 +2,8 @@ pub mod create_tunnel;
 mod data_structures;
 pub mod delete_tunnel;
 pub mod get_configuration;
+pub mod get_tunnel;
+pub mod get_tunnel_token;
 pub mod list_tunnels;
 pub mod route_dns;
 pub mod update_configuration;