valorant_api_official 0.2.2

#![deny(warnings)]
#![deny(unused)]
#![deny(clippy::expect_used)]
#![deny(clippy::get_unwrap)]
#![deny(clippy::exit)]
#![deny(clippy::indexing_slicing)]
#![deny(clippy::panic)]
#![deny(clippy::panic_in_result_fn)]
#![deny(clippy::unreachable)]
#![deny(clippy::unwrap_used)]
#![deny(clippy::unwrap_in_result)]
#![deny(clippy::print_stdout)]
#![allow(clippy::upper_case_acronyms)]

//! # Valorant API
//! This crate is a wrapper for the In-Game Valorant API.
//!
//! ## Usage
//!
//! ```rust no_run
//! use valorant_api_official::utils::credentials_manager::CredentialsManager;
//! use valorant_api_official::enums::region::Region;
//!
//! let http_client = reqwest::Client::new();
//! let credentials_manager = valorant_api_official::utils::credentials_manager::CredentialsManager::new();
//!
//! let puuid = "";
//! let region = Region::EU;
//! let result = valorant_api_official::get_accounts_by_puuid_v1(credentials_manager, &http_client,  &puuid).await;
//! println!("Result: {:#?}", result);
//! ```
//!
//! ## Endpoints
//!
//! ### Account V1
//!
//! Function: [`get_accounts_by_name_v1`] or [`get_accounts_by_puuid_v1`]
//!
//! Result Type: [`AccountV1`]
//!
//! ### Active Shards V1
//!
//! Function: [`get_active_shards_v1`]
//!
//! Result Type: [`ActiveShardsV1`]
//!
//! ### Match Details V1
//!
//! Function: [`get_match_details_v1`]
//!
//! Result Type: [`MatchDetailsV1`]
//!
//! ### Match History V1
//!
//! Function: [`get_match_lists_v1`]
//!
//! Result Type: [`MatchListsV1`]
//!
//! ### Recent Matches V1
//!
//! Function: [`get_recent_matches_v1`]
//!
//! Result Type: [`RecentMatchesV1`]
//!
//! ### Leaderboard V1
//!
//! Function: [`get_leaderboard_v1`]
//!
//! Result Type: [`LeaderboardV1`]
//!
//! ### Content V1
//!
//! Function: [`get_content_v1`]
//!
//! Result Type: [`ContentV1`]

use std::collections::HashMap;
use std::str::FromStr;

use url::Url;
use uuid::Uuid;

use crate::enums::platform::Platform;
use crate::enums::query_arg::{ContentQueryArg, LeaderboardQueryArg};
use crate::enums::queue::Queue;
use crate::enums::region::Region;
use crate::errors::response_error::RequestError;
use crate::response_types::account_v1::AccountV1;
use crate::response_types::activeshards_v1::ActiveShardsV1;
use crate::response_types::content_v1::ContentV1;
use crate::response_types::leaderboard_v1::LeaderboardV1;
use crate::response_types::matchdetails_v1::MatchDetailsV1;
use crate::response_types::matchlists_v1::MatchListsV1;
use crate::response_types::platformdata_v1::PlatformDataV1;
use crate::response_types::recentmatches_v1::RecentMatchesV1;
use crate::utils::credentials_manager::CredentialsManager;
use crate::utils::fetch::fetch_endpoint;
use crate::utils::functions::set_query_args;

pub mod enums;
pub mod errors;
pub mod response_types;
pub mod utils;

pub async fn get_platform_data_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
) -> Result<PlatformDataV1, RequestError> {
    //! Get Platform Data V1
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the match
    //! # Example
    //! ```rust no_run
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_platform_data_v1(credentials_manager, &http_client, region).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/status/v1/platform-data",).as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_match_details_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    match_id: &Uuid,
) -> Result<MatchDetailsV1, RequestError> {
    //! Get the match details of a match
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the match
    //! * `match_id` - The match id of the match
    //! # Example
    //! ```rust no_run
    //! let match_id = Uuid::parse_str("3100c02b-17d2-4adb-97b5-e45dee67d292").expect("Invalid UUID");
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_match_details_v1(credentials_manager, &http_client,  &match_id).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/match/v1/matches/{match_id}",).as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_match_details_console_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    match_id: &Uuid,
) -> Result<MatchDetailsV1, RequestError> {
    //! Get the match details of a match for console
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the match
    //! * `match_id` - The match id of the match
    //! # Example
    //! ```rust no_run
    //! let match_id = Uuid::parse_str("3100c02b-17d2-4adb-97b5-e45dee67d292").expect("Invalid UUID");
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_match_details_console_v1(credentials_manager, &http_client,  &match_id).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/match/console/v1/matches/{match_id}",)
            .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_match_lists_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    puuid: &str,
) -> Result<MatchListsV1, RequestError> {
    //! Get the match lists of a player
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the player
    //! * `puuid` - The puuid of the player
    //! # Example
    //! ```rust no_run
    //! let puuid = "";
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_match_lists_v1(credentials_manager, &http_client,  &puuid).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/match/v1/matchlists/by-puuid/{puuid}",)
            .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_match_lists_console_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    platform_type: Platform,
    puuid: &str,
) -> Result<MatchListsV1, RequestError> {
    //! Get the match lists of a player for console
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the player
    //! * `platform_type` - The platform of the player
    //! * `puuid` - The puuid of the player
    //! # Example
    //! ```rust no_run
    //! let puuid = "";
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_match_lists_console_v1(credentials_manager, &http_client,  &puuid).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!(
            "https://{region}.api.riotgames.com/val/match/console/v1/matchlists/by-puuid/{puuid}?platformType={platform_type}",
        )
        .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_accounts_by_puuid_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    cluster: &str,
    puuid: &str,
) -> Result<AccountV1, RequestError> {
    //! Get the account of a player
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the player
    //! * `puuid` - The puuid of the player
    //! # Example
    //! ```rust no_run
    //! let puuid = "";
    //! let result = valorant_api_official::get_accounts_v1(credentials_manager, &http_client, &puuid).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{cluster}.api.riotgames.com/riot/account/v1/accounts/by-puuid/{puuid}",)
            .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_accounts_by_name_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    cluster: &str,
    name: &str,
    tag: &str,
) -> Result<AccountV1, RequestError> {
    //! Get the account of a player
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the player
    //! * `name` - The name of the player
    //! * `tag` - The tag of the player
    //! # Example
    //! ```rust no_run
    //! let name = "";
    //! let tag = "";
    //! let result = valorant_api_official::get_accounts_v1(credentials_manager, &http_client, &name, &tag).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!(
            "https://{cluster}.api.riotgames.com/riot/account/v1/accounts/by-riot-id/{name}/{tag}",
        )
        .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_active_shards_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    cluster: &str,
    puuid: &str,
) -> Result<ActiveShardsV1, RequestError> {
    //! Get the shards of a player
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `puuid` - The puuid of the player
    //! # Example
    //! ```rust no_run
    //! let puuid = "";
    //! let result = valorant_api_official::get_active_shards_v1(credentials_manager, &http_client, &puuid).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!(
            "https://{cluster}.api.riotgames.com/riot/account/v1/active-shards/by-game/val/by-puuid/{puuid}",
        )
        .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_recent_matches_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    queue: Queue,
) -> Result<RecentMatchesV1, RequestError> {
    //! Get the recent matches of a queue
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the queue
    //! * `queue` - The queue of the matches
    //! # Example
    //! ```rust no_run
    //! let queue = Queue::Competitive;
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_recent_matches_v1(credentials_manager, &http_client,  queue).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/match/v1/recent-matches/by-queue/{queue}",)
            .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_recent_matches_console_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    queue: Queue,
) -> Result<RecentMatchesV1, RequestError> {
    //! Get the recent matches of a queue for console
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the queue
    //! * `queue` - The queue of the matches
    //! # Example
    //! ```rust no_run
    //! let queue = Queue::Competitive;
    //! let region = Region::EU;
    //! let result = valorant_api_official::get_recent_matches_console_v1(credentials_manager, &http_client,  queue).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let url = Url::from_str(
        format!(
            "https://{region}.api.riotgames.com/val/match/console/v1/recent-matches/by-queue/{queue}",

        )
        .as_str(),
    )?;

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_content_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    query_args: &HashMap<ContentQueryArg, &str>,
) -> Result<ContentV1, RequestError> {
    //! Get the content of the game
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the player
    //! * `query_args` - The query arguments
    //! # Example
    //! ```rust no_run
    //! let region = Region::EU;
    //! let query_args = HashMap::new();
    //! let result = valorant_api_official::get_content_v1(credentials_manager, &http_client,  query_args).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let mut url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/content/v1/contents",).as_str(),
    )?;
    set_query_args(&mut url, query_args.iter());

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_leaderboard_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    act: &Uuid,
    query_args: HashMap<LeaderboardQueryArg, String>,
) -> Result<LeaderboardV1, RequestError> {
    //! Get the leaderboard of a region
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the leaderboard
    //! * `act` - The season of the leaderboard
    //! * `query_args` - The query arguments
    //! # Errors
    //! `RequestError` - If the request failed
    //! # Example
    //! ```rust no_run
    //! let act = Uuid::parse_str("34093c29-4306-43de-452f-3f944bde22be").expect("Invalid UUID");
    //! let region = Region::EU;
    //! let queries = HashMap::new();
    //! let result = valorant_api_official::get_leaderboard_v1(credentials_manager, &http_client,  &act, queries).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let mut url = Url::from_str(
        format!("https://{region}.api.riotgames.com/val/ranked/v1/leaderboards/by-act/{act}",)
            .as_str(),
    )?;
    set_query_args(&mut url, query_args.into_iter());

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}

pub async fn get_leaderboard_console_v1(
    credentials_manager: &CredentialsManager,
    http_client: &reqwest::Client,
    region: Region,
    act: &Uuid,
    query_args: HashMap<LeaderboardQueryArg, String>,
) -> Result<LeaderboardV1, RequestError> {
    //! Get the leaderboard of a region for console
    //! # Arguments
    //! * `credentials_manager` - The credentials manager
    //! * `region` - The region of the leaderboard
    //! * `act` - The season of the leaderboard
    //! * `query_args` - The query arguments
    //! # Errors
    //! `RequestError` - If the request failed
    //! # Example
    //! ```rust no_run
    //! let act = Uuid::parse_str("34093c29-4306-43de-452f-3f944bde22be").expect("Invalid UUID");
    //! let region = Region::EU;
    //! let queries = HashMap::new();
    //! let result = valorant_api_official::get_leaderboard_console_v1(credentials_manager, &http_client,  &act, queries).await;
    //! println!("Result: {:#?}", result);
    //! ```

    let mut url = Url::from_str(
        format!(
            "https://{region}.api.riotgames.com/val/console/ranked/v1/leaderboards/by-act/{act}",
        )
        .as_str(),
    )?;
    set_query_args(&mut url, query_args.into_iter());

    fetch_endpoint(
        credentials_manager,
        http_client,
        url,
        "GET",
        "",
        &HashMap::new(),
    )
    .await
}