//! Collections API.

use alloc::sync::Arc;
use std::sync::RwLock;

use crate::api::exec_request;
use crate::model::Collection;
use crate::model::id::CollectionId;
use crate::{Cache, CachePolicy, Config};

use super::{Error, make_request};

/// TMDB Collections API client.
#[derive(Debug)]
pub struct Client {
	/// The client configuration.
	config: Arc<Config>,
	/// The request cache.
	cache: Arc<dyn Cache>,
	/// The cache policy to use for requests.
	policy: Arc<RwLock<CachePolicy>>,
}

impl Client {
	/// Create a new client with the given configuration.
	#[inline]
	pub fn new(
		config: Arc<Config>,
		cache: Arc<dyn Cache>,
		policy: Arc<RwLock<CachePolicy>>,
	) -> Self {
		Self {
			config,
			cache,
			policy,
		}
	}

	/// Fetch the details of the collection refered to by ID.
	///
	/// # Errors
	/// See [Error] for failure modes.
	#[inline]
	#[expect(clippy::impl_trait_in_params, reason = "turbofish is not expected")]
	pub async fn get_details(
		&self,
		id: impl Into<CollectionId>,
		language: Option<&str>,
	) -> Result<Collection, Error> {
		let request = make_request(
			&self.config,
			&format!("/3/collection/{}", id.into().into_raw()),
			language,
		)?;
		exec_request(&self.config, &*self.cache, &self.policy, request).await
	}
}