foundation_deployment_cloudflare 0.1.3

//! Auto-generated API module for cloudflare targets.
//!
//! Generated by `cargo run --bin ewe_platform gen_api`.
//! DO NOT EDIT MANUALLY.
//!
//! Feature flag: `cloudflare_targets `

#![cfg(feature = "cloudflare_targets")]
#![allow(clippy::too_many_arguments, clippy::type_complexity)]
#![allow(
    clippy::missing_errors_doc,
    clippy::doc_markdown,
    clippy::useless_format
)]
#![allow(unused_imports)]

use foundation_macros::JsonHash;
use foundation_netio::shared::client::http_client::HttpClient;
use foundation_netio::{DynNetClient, PreparedRequestBuilder};
use serde::{Deserialize, Serialize};

use super::shared::ApiResponse;

// =============================================================================
// TYPE DECLARATIONS
// =============================================================================

/// `InfraApiResponseCollection` type.
///
/// Same shape as `super::shared::AddressingApiResponseCollectionShape`.
pub type InfraApiResponseCollection = super::shared::AddressingApiResponseCollectionShape;

/// `InfraApiResponseCommon` type.
///
/// Same shape as `super::shared::ErrorsMessagesSuccessObject`.
pub type InfraApiResponseCommon = super::shared::ErrorsMessagesSuccessObject;

/// `InfraApiResponseSingle` type.
///
/// Same shape as `super::shared::ErrorsMessagesSuccessObject`.
pub type InfraApiResponseSingle = super::shared::ErrorsMessagesSuccessObject;

/// `InfraIPInfo` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct InfraIPInfo {
    /// `ipv4` property.
    pub ipv4: Option<std::collections::HashMap<String, serde_json::Value>>,
    /// `ipv6` property.
    pub ipv6: Option<std::collections::HashMap<String, serde_json::Value>>,
}

/// `InfraMessages` type.
pub type InfraMessages = Vec<std::collections::HashMap<String, serde_json::Value>>;

/// `InfraTarget` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct InfraTarget {
    /// `created_at` property.
    pub created_at: String,
    /// `hostname` property.
    pub hostname: String,
    /// `id` property.
    pub id: String,
    /// `ip` property.
    pub ip: InfraIPInfo,
    /// `modified_at` property.
    pub modified_at: String,
}

/// `InfraTargetArray` type.
pub type InfraTargetArray = Vec<InfraTarget>;

/// `InfraTargetId` type.
pub type InfraTargetId = String;

/// `InfraTargetsDeleteBatchPostRequest` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct InfraTargetsDeleteBatchPostRequest {
    /// `target_ids` property.
    pub target_ids: Vec<String>,
}

/// `InfraTargetsGetResponse` type.
///
/// Same shape as `super::shared::ApiEnvelope<Option<InfraTarget>>`.
pub type InfraTargetsGetResponse = super::shared::ApiEnvelope<Option<InfraTarget>>;

/// `InfraTargetsListResponse` type.
///
/// Same shape as `super::shared::ApiEnvelopeErrorsMessagesResultInfoSuccess<Option<Vec<InfraTarget>>>`.
pub type InfraTargetsListResponse =
    super::shared::ApiEnvelopeErrorsMessagesResultInfoSuccess<Option<Vec<InfraTarget>>>;

/// `InfraTargetsPostRequest` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct InfraTargetsPostRequest {
    /// `hostname` property.
    pub hostname: String,
    /// `ip` property.
    pub ip: InfraIPInfo,
}

/// `InfraTargetsPostResponse` type.
///
/// Same shape as `super::shared::ApiEnvelope<Option<InfraTarget>>`.
pub type InfraTargetsPostResponse = super::shared::ApiEnvelope<Option<InfraTarget>>;

/// `InfraTargetsPutBatchRequestItem` type.
///
/// Same shape as `InfraTargetsPostRequest`.
pub type InfraTargetsPutBatchRequestItem = InfraTargetsPostRequest;

/// `InfraTargetsPutBatchResponse` type.
///
/// Same shape as `super::shared::ApiEnvelope<Option<Vec<InfraTarget>>>`.
pub type InfraTargetsPutBatchResponse = super::shared::ApiEnvelope<Option<Vec<InfraTarget>>>;

/// `InfraTargetsPutRequest` type.
///
/// Same shape as `InfraTargetsPostRequest`.
pub type InfraTargetsPutRequest = InfraTargetsPostRequest;

/// `InfraTargetsPutResponse` type.
///
/// Same shape as `super::shared::ApiEnvelope<Option<InfraTarget>>`.
pub type InfraTargetsPutResponse = super::shared::ApiEnvelope<Option<InfraTarget>>;

// =============================================================================
// ARGS TYPES (per-endpoint)
// =============================================================================

/// Arguments for [`infra-targets-list_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct InfraTargetsListArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Query parameter: `hostname`.
    pub hostname: Option<String>,
    /// Query parameter: `hostname_contains`.
    pub hostname_contains: Option<String>,
    /// Query parameter: `virtual_network_id`.
    pub virtual_network_id: Option<String>,
    /// Query parameter: `ip_v4`.
    pub ip_v4: Option<String>,
    /// Query parameter: `ip_v6`.
    pub ip_v6: Option<String>,
    /// Query parameter: `created_before`.
    pub created_before: Option<String>,
    /// Query parameter: `created_after`.
    pub created_after: Option<String>,
    /// Query parameter: `modified_before`.
    pub modified_before: Option<String>,
    /// Query parameter: `modified_after`.
    pub modified_after: Option<String>,
    /// Query parameter: `ips` (one per value).
    pub ips: Vec<String>,
    /// Query parameter: `target_ids` (one per value).
    pub target_ids: Vec<String>,
    /// Query parameter: `ip_like`.
    pub ip_like: Option<String>,
    /// Query parameter: `ipv4_start`.
    pub ipv4_start: Option<String>,
    /// Query parameter: `ipv4_end`.
    pub ipv4_end: Option<String>,
    /// Query parameter: `ipv6_start`.
    pub ipv6_start: Option<String>,
    /// Query parameter: `ipv6_end`.
    pub ipv6_end: Option<String>,
    /// Query parameter: `page`.
    pub page: Option<String>,
    /// Query parameter: `per_page`.
    pub per_page: Option<String>,
    /// Query parameter: `order`.
    pub order: Option<String>,
    /// Query parameter: `direction`.
    pub direction: Option<String>,
}

/// Arguments for [`infra-targets-post_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct InfraTargetsPostArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Request body.
    pub body: InfraTargetsPostRequest,
}

/// Arguments for [`infra-targets-put-batch_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct InfraTargetsPutBatchArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Request body.
    pub body: Vec<InfraTargetsPutBatchRequestItem>,
}

/// Arguments for [`infra-targets-delete-batch-post_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct InfraTargetsDeleteBatchPostArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Request body.
    pub body: InfraTargetsDeleteBatchPostRequest,
}

/// Arguments for [`infra-targets-get_request`].
///
/// Same shape as `super::shared::AccountIdTargetIdArgs`.
pub type InfraTargetsGetArgs = super::shared::AccountIdTargetIdArgs;

/// Arguments for [`infra-targets-put_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct InfraTargetsPutArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Path parameter: `target_id`.
    pub target_id: String,
    /// Request body.
    pub body: InfraTargetsPutRequest,
}

/// Arguments for [`infra-targets-delete_request`].
///
/// Same shape as `super::shared::AccountIdTargetIdArgs`.
pub type InfraTargetsDeleteArgs = super::shared::AccountIdTargetIdArgs;

// =============================================================================
// CLIENT FUNCTIONS (per-endpoint)
// =============================================================================

// -----------------------------------------------------------------------------
// GET /accounts/{account_id}/infrastructure/targets
// -----------------------------------------------------------------------------

/// GET /accounts/{account_id}/infrastructure/targets.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_list_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_list_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsListArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<InfraTargetsListResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!("/accounts/{}/infrastructure/targets", args.account_id,);
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::get(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    builder = builder.query("hostname", args.hostname.as_deref());
    builder = builder.query("hostname_contains", args.hostname_contains.as_deref());
    builder = builder.query("virtual_network_id", args.virtual_network_id.as_deref());
    builder = builder.query("ip_v4", args.ip_v4.as_deref());
    builder = builder.query("ip_v6", args.ip_v6.as_deref());
    builder = builder.query("created_before", args.created_before.as_deref());
    builder = builder.query("created_after", args.created_after.as_deref());
    builder = builder.query("modified_before", args.modified_before.as_deref());
    builder = builder.query("modified_after", args.modified_after.as_deref());
    for value in &args.ips {
        builder = builder.query("ips", Some(value.as_str()));
    }
    for value in &args.target_ids {
        builder = builder.query("target_ids", Some(value.as_str()));
    }
    builder = builder.query("ip_like", args.ip_like.as_deref());
    builder = builder.query("ipv4_start", args.ipv4_start.as_deref());
    builder = builder.query("ipv4_end", args.ipv4_end.as_deref());
    builder = builder.query("ipv6_start", args.ipv6_start.as_deref());
    builder = builder.query("ipv6_end", args.ipv6_end.as_deref());
    builder = builder.query("page", args.page.as_deref());
    builder = builder.query("per_page", args.per_page.as_deref());
    builder = builder.query("order", args.order.as_deref());
    builder = builder.query("direction", args.direction.as_deref());

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_json(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// POST /accounts/{account_id}/infrastructure/targets
// -----------------------------------------------------------------------------

/// POST /accounts/{account_id}/infrastructure/targets.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_post_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_post_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsPostArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<InfraTargetsPostResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!("/accounts/{}/infrastructure/targets", args.account_id,);
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::post(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    builder = builder
        .body_json(&args.body)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_json(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// PUT /accounts/{account_id}/infrastructure/targets/batch
// -----------------------------------------------------------------------------

/// PUT /accounts/{account_id}/infrastructure/targets/batch.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_put_batch_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_put_batch_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsPutBatchArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<InfraTargetsPutBatchResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!("/accounts/{}/infrastructure/targets/batch", args.account_id,);
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::put(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    builder = builder
        .body_json(&args.body)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_json(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// POST /accounts/{account_id}/infrastructure/targets/batch_delete
// -----------------------------------------------------------------------------

/// POST /accounts/{account_id}/infrastructure/targets/batch_delete.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_delete_batch_post_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_delete_batch_post_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsDeleteBatchPostArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<()>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/infrastructure/targets/batch_delete",
        args.account_id,
    );
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::post(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    builder = builder
        .body_json(&args.body)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_without_body(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// GET /accounts/{account_id}/infrastructure/targets/{target_id}
// -----------------------------------------------------------------------------

/// GET /accounts/{account_id}/infrastructure/targets/{target_id}.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_get_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_get_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsGetArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<InfraTargetsGetResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/infrastructure/targets/{}",
        args.account_id, args.target_id,
    );
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::get(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_json(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// PUT /accounts/{account_id}/infrastructure/targets/{target_id}
// -----------------------------------------------------------------------------

/// PUT /accounts/{account_id}/infrastructure/targets/{target_id}.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_put_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_put_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsPutArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<InfraTargetsPutResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/infrastructure/targets/{}",
        args.account_id, args.target_id,
    );
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::put(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    builder = builder
        .body_json(&args.body)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_json(client.into(), builder.build()).await
}

// -----------------------------------------------------------------------------
// DELETE /accounts/{account_id}/infrastructure/targets/{target_id}
// -----------------------------------------------------------------------------

/// DELETE /accounts/{account_id}/infrastructure/targets/{target_id}.
///
/// Takes a client and args, builds the request, optionally applies
/// modifications, then sends it via `send_async().await`.
///
/// # Arguments
///
/// * `client` - HTTP client for making the request: a `DynNetClient`, or an `ApiClient` carrying the `BodyLimits` the response is read under
/// * `args` - Request arguments (path params, query params, body)
/// * `builder_mod` - Optional closure to modify the request builder (e.g., add headers)
///
/// # Example
///
/// ```ignore
/// let response = infra_targets_delete_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn infra_targets_delete_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &InfraTargetsDeleteArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<()>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/infrastructure/targets/{}",
        args.account_id, args.target_id,
    );
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::delete(&endpoint_url)
        .map_err(|e| super::shared::ApiError::RequestBuildFailed(e.to_string()))?;

    if let Some(f) = builder_mod {
        f(&mut builder);
    }

    super::shared::send_without_body(client.into(), builder.build()).await
}