foundation_deployment_cloudflare 0.1.3

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

#![cfg(feature = "cloudflare_apps")]
#![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
// =============================================================================

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

/// `AbuseReportsMessage` type.
///
/// Same shape as `super::shared::MessageObject`.
pub type AbuseReportsMessage = super::shared::MessageObject;

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

/// `AbuseReportsMitigationAppeal` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct AbuseReportsMitigationAppeal {
    /// `id` property.
    pub id: String,
    /// `reason` property.
    pub reason: String,
}

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

/// `AbuseReportsMitigationAppealResult` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct AbuseReportsMitigationAppealResult {
    /// `errors` property.
    pub errors: Option<Vec<AbuseReportsMessage>>,
    /// `messages` property.
    pub messages: Option<Vec<AbuseReportsMessage>>,
    /// `result` property.
    pub result: Option<Vec<AbuseReportsMitigationListItem>>,
    /// `result_info` property.
    pub result_info: std::collections::HashMap<String, serde_json::Value>,
    /// `success` property.
    pub success: bool,
}

/// `AbuseReportsMitigationListItem` type.
///
/// Same shape as `super::shared::AbuseReportsMitigationListItemShape`.
pub type AbuseReportsMitigationListItem = super::shared::AbuseReportsMitigationListItemShape;

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

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

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

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

/// `AlexandriaApplication` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct AlexandriaApplication {
    /// `application_source` property.
    pub application_source: String,
    /// `application_type` property.
    pub application_type: String,
    /// `application_type_description` property.
    pub application_type_description: String,
    /// `created_at` property.
    pub created_at: String,
    /// `hostnames` property.
    pub hostnames: Vec<String>,
    /// `human_id` property.
    pub human_id: String,
    /// `id` property.
    pub id: String,
    /// `ip_subnets` property.
    pub ip_subnets: Vec<String>,
    /// `name` property.
    pub name: String,
    /// `port_protocols` property.
    pub port_protocols: Vec<String>,
    /// `support_domains` property.
    pub support_domains: Vec<String>,
    /// `updated_at` property.
    pub updated_at: String,
    /// `version` property.
    pub version: String,
}

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

/// `AlexandriaApplicationHostnames` type.
pub type AlexandriaApplicationHostnames = Vec<String>;

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

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

/// `AlexandriaApplicationIpSubnets` type.
pub type AlexandriaApplicationIpSubnets = Vec<String>;

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

/// `AlexandriaApplicationPortProtocols` type.
pub type AlexandriaApplicationPortProtocols = Vec<String>;

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

/// `AlexandriaApplicationSupportDomains` type.
pub type AlexandriaApplicationSupportDomains = Vec<String>;

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

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

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

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

/// `AlexandriaApplications` type.
pub type AlexandriaApplications = Vec<AlexandriaApplication>;

/// `AlexandriaCreateApplicationRequest` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct AlexandriaCreateApplicationRequest {
    /// `application_type_id` property.
    pub application_type_id: String,
    /// `hostnames` property.
    pub hostnames: Option<serde_json::Value>,
    /// `human_id` property.
    pub human_id: String,
    /// `ip_subnets` property.
    pub ip_subnets: Option<Vec<String>>,
    /// `name` property.
    pub name: String,
    /// `port_protocols` property.
    pub port_protocols: Option<Vec<String>>,
    /// `support_domains` property.
    pub support_domains: Option<Vec<String>>,
}

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

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

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

/// `AlexandriaUpdateApplicationVersionRequest` type.
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonHash)]
pub struct AlexandriaUpdateApplicationVersionRequest {
    /// `hostnames` property.
    pub hostnames: Option<Vec<String>>,
    /// `ip_subnets` property.
    pub ip_subnets: Option<Vec<String>>,
    /// `port_protocols` property.
    pub port_protocols: Option<Vec<String>>,
    /// `support_domains` property.
    pub support_domains: Option<Vec<String>>,
}

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

/// Arguments for [`getApplications_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct GetApplicationsArgs {
    /// Path parameter: `accountId`.
    pub account_id: String,
    /// Query parameter: `filter`.
    pub filter: Option<String>,
    /// Query parameter: `limit`.
    pub limit: Option<String>,
    /// Query parameter: `offset`.
    pub offset: Option<String>,
    /// Query parameter: `order_by`.
    pub order_by: Option<String>,
}

/// Arguments for [`createApplication_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct CreateApplicationArgs {
    /// Path parameter: `accountId`.
    pub account_id: String,
    /// Request body.
    pub body: AlexandriaCreateApplicationRequest,
}

/// Arguments for [`getApplicationById_request`].
///
/// Same shape as `super::shared::AccountIdIdArgs`.
pub type GetApplicationByIdArgs = super::shared::AccountIdIdArgs;

/// Arguments for [`updateApplicationVersion_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct UpdateApplicationVersionArgs {
    /// Path parameter: `accountId`.
    pub account_id: String,
    /// Path parameter: `id`.
    pub id: String,
    /// Request body.
    pub body: AlexandriaUpdateApplicationVersionRequest,
}

/// Arguments for [`RequestReview_request`].
#[derive(Debug, Clone, Default, Serialize, JsonHash)]
pub struct RequestReviewArgs {
    /// Path parameter: `account_id`.
    pub account_id: String,
    /// Path parameter: `report_id`.
    pub report_id: String,
    /// Request body.
    pub body: AbuseReportsMitigationAppealRequest,
}

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

// -----------------------------------------------------------------------------
// GET /accounts/{accountId}/resource-library/applications
// -----------------------------------------------------------------------------

/// GET /accounts/{accountId}/resource-library/applications.
///
/// 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 = get_applications_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn get_applications_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &GetApplicationsArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<AlexandriaGetApplicationsResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/resource-library/applications",
        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("filter", args.filter.as_deref());
    builder = builder.query("limit", args.limit.as_deref());
    builder = builder.query("offset", args.offset.as_deref());
    builder = builder.query("order_by", args.order_by.as_deref());

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

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

// -----------------------------------------------------------------------------
// POST /accounts/{accountId}/resource-library/applications
// -----------------------------------------------------------------------------

/// POST /accounts/{accountId}/resource-library/applications.
///
/// 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 = create_application_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn create_application_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &CreateApplicationArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<AlexandriaGetApplicationResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/resource-library/applications",
        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
}

// -----------------------------------------------------------------------------
// GET /accounts/{accountId}/resource-library/applications/{id}
// -----------------------------------------------------------------------------

/// GET /accounts/{accountId}/resource-library/applications/{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 = get_application_by_id_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn get_application_by_id_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &GetApplicationByIdArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<AlexandriaGetApplicationResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/resource-library/applications/{}",
        args.account_id, args.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
}

// -----------------------------------------------------------------------------
// PATCH /accounts/{accountId}/resource-library/applications/{id}
// -----------------------------------------------------------------------------

/// PATCH /accounts/{accountId}/resource-library/applications/{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 = update_application_version_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn update_application_version_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &UpdateApplicationVersionArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<AlexandriaGetApplicationResponse>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/resource-library/applications/{}",
        args.account_id, args.id,
    );
    let endpoint_url = format!("{}{}", base_url, path);

    let mut builder = PreparedRequestBuilder::patch(&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}/abuse-reports/{report_id}/mitigations/appeal
// -----------------------------------------------------------------------------

/// POST /accounts/{account_id}/abuse-reports/{report_id}/mitigations/appeal.
///
/// 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 = request_review_request(client.clone(), &args, Some(|b: &mut PreparedRequestBuilder| {
///     b.header("X-Custom-Header", "value");
/// })).await?;
/// ```
pub async fn request_review_request<F>(
    client: impl Into<super::shared::ApiClient>,
    args: &RequestReviewArgs,
    base_url: &str,
    builder_mod: Option<F>,
) -> Result<ApiResponse<AbuseReportsMitigationAppealResult>, super::shared::ApiError>
where
    F: FnOnce(&mut PreparedRequestBuilder),
{
    let path = format!(
        "/accounts/{}/abuse-reports/{}/mitigations/appeal",
        args.account_id, args.report_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
}