use std::sync::Arc;
use serde_json::Value;
use url::Url;
use crate::envelope::Envelope;
use crate::error::Error;
use crate::links;
use crate::routes;
use crate::transport::{RequestBody, Transport};
#[derive(Debug)]
pub struct ForwardsApi {
transport: Arc<Transport>,
}
impl ForwardsApi {
#[must_use]
pub fn new(transport: Arc<Transport>) -> Self {
Self { transport }
}
pub async fn get_forwards(
&self,
network_id: &str,
parent: Option<&Value>,
) -> Result<Envelope, Error> {
self.transport
.resource(
&routes::forwards::FORWARDS_GET,
network_id,
parent,
&[],
RequestBody::None,
)
.await
}
pub async fn create_forward(
&self,
network_id: &str,
forward_data: Value,
parent: Option<&Value>,
) -> Result<Envelope, Error> {
let url = routes::forwards::FORWARDS_CREATE.resolve(
self.transport.api_host(),
network_id,
parent,
)?;
links::warn_uncharacterised_write("create forward for network");
self.transport
.request(
routes::forwards::FORWARDS_CREATE.method.clone(),
url,
&[],
RequestBody::Json(forward_data),
)
.await
}
pub async fn update_forward(
&self,
forward: &str,
data: Value,
network: Option<&str>,
parent: Option<&Value>,
) -> Result<Envelope, Error> {
let url = self.resolve_forward_url(forward, network, parent)?;
links::warn_uncharacterised_write("update_forward");
self.transport
.request(reqwest::Method::PUT, url, &[], RequestBody::Json(data))
.await
}
pub async fn delete_forward(&self, network_id: &str, forward: &str) -> Result<Envelope, Error> {
let url = routes::forwards::FORWARDS_DELETE.resolve(
self.transport.api_host(),
network_id,
forward,
None,
)?;
links::warn_uncharacterised_write("delete forward for network");
self.transport
.request(
routes::forwards::FORWARDS_DELETE.method.clone(),
url,
&[],
RequestBody::None,
)
.await
}
fn resolve_forward_url(
&self,
forward: &str,
network: Option<&str>,
parent: Option<&Value>,
) -> Result<Url, Error> {
let host = self.transport.api_host();
if let Some(parent) = parent {
return links::self_url(host, parent)?.ok_or_else(|| {
Error::validation("forward", "envelope has no resolvable 'url' field")
});
}
if forward.starts_with("http://")
|| forward.starts_with("https://")
|| forward.starts_with('/')
{
return routes::forwards::FORWARDS_UPDATE.resolve(
host,
network.unwrap_or(""),
forward,
None,
);
}
let network = network.ok_or_else(|| {
Error::validation(
"network",
"required when 'forward' is a bare ID rather than a path/URL",
)
})?;
routes::forwards::FORWARDS_UPDATE.resolve(host, network, forward, None)
}
}