use super::types::{
BalanceDetail, ConsumeRecordPage, EntitlementBalance, EntitlementItem, ModelBucket,
ModelByQuotaResponse, ModelCoefficient,
};
use crate::core::client::Client;
use crate::core::http::COEF_CACHE_TTL_MS;
use crate::shared::{Error, Result};
use tokio_util::sync::CancellationToken;
impl Client {
pub async fn get_balance(
&self,
signal: Option<CancellationToken>,
) -> Result<EntitlementBalance> {
self.billing_get("/entitlements/balance", signal).await
}
pub async fn get_balance_detail(
&self,
signal: Option<CancellationToken>,
) -> Result<BalanceDetail> {
self.billing_get("/entitlements/balance-detail", signal)
.await
}
pub async fn list_entitlements(
&self,
status: &str,
signal: Option<CancellationToken>,
) -> Result<Vec<EntitlementItem>> {
let path = if status.is_empty() {
"/entitlements".to_string()
} else {
format!("/entitlements?status={}", urlencoding(status))
};
self.billing_get(&path, signal).await
}
pub async fn list_consume_records(
&self,
page: i64,
page_size: i64,
signal: Option<CancellationToken>,
) -> Result<ConsumeRecordPage> {
let path = format!("/entitlements/consume-records?page={page}&pageSize={page_size}");
self.billing_get(&path, signal).await
}
pub async fn claim_monthly_free(
&self,
signal: Option<CancellationToken>,
) -> Result<EntitlementItem> {
self.billing_post("/entitlements/claim-monthly", signal)
.await
}
pub async fn get_by_model(
&self,
model_id: &str,
signal: Option<CancellationToken>,
) -> Result<ModelByQuotaResponse> {
if model_id.is_empty() {
return Err(Error::other("modelID required"));
}
let path = format!("/entitlements/by-model?modelId={}", urlencoding(model_id));
self.billing_get(&path, signal).await
}
pub async fn list_buckets(
&self,
signal: Option<CancellationToken>,
) -> Result<Vec<ModelBucket>> {
self.billing_get("/entitlements/buckets", signal).await
}
pub async fn list_coefficients(
&self,
signal: Option<CancellationToken>,
) -> Result<Vec<ModelCoefficient>> {
{
let cache = self.coef_cache().read().unwrap();
if let Some((data, t)) = cache.as_ref() {
if (t.elapsed().as_millis() as u64) < COEF_CACHE_TTL_MS {
return Ok(data.clone()); }
}
}
let data: Vec<ModelCoefficient> = self
.billing_get("/entitlements/coefficients", signal)
.await?;
*self.coef_cache().write().unwrap() = Some((data.clone(), std::time::Instant::now()));
Ok(data)
}
pub fn invalidate_coefficient_cache(&self) {
*self.coef_cache().write().unwrap() = None;
}
}
pub(crate) fn urlencoding(s: &str) -> String {
let mut out = String::with_capacity(s.len());
for b in s.bytes() {
match b {
b'A'..=b'Z'
| b'a'..=b'z'
| b'0'..=b'9'
| b'-'
| b'_'
| b'.'
| b'!'
| b'~'
| b'*'
| b'\''
| b'('
| b')' => out.push(b as char),
_ => out.push_str(&format!("%{b:02X}")),
}
}
out
}