Skip to main content

acosmi/products/
client.rs

1//! 商品中心业务方法。端口自 `products/client.ts`(declaration-merging → `impl Client` 块)。
2//!
3//! 端点:tk-dist `/api/distribution/public/products/{by-family,by-slug}`,经 Go 反代。
4
5use super::types::{Audience, Product, ProductFamily, RegionScope};
6use crate::billing::entitlements::urlencoding;
7use crate::core::client::Client;
8use crate::shared::{Error, Result};
9use tokio_util::sync::CancellationToken;
10
11impl Client {
12    /// 按商品族查询在售商品。全参可空(后端无过滤即返全部在售)。对应 TS `listProductsByFamily`。
13    ///
14    /// `region` 命中时同时返回 GLOBAL 商品。空 data → 空数组。
15    pub async fn list_products_by_family(
16        &self,
17        family: Option<ProductFamily>,
18        audience: Option<Audience>,
19        region: Option<RegionScope>,
20        signal: Option<CancellationToken>,
21    ) -> Result<Vec<Product>> {
22        let mut params: Vec<String> = Vec::new();
23        if let Some(f) = family {
24            params.push(format!("family={}", urlencoding(f.as_str())));
25        }
26        if let Some(a) = audience {
27            params.push(format!("audience={}", urlencoding(a.as_str())));
28        }
29        if let Some(r) = region {
30            params.push(format!("region={}", urlencoding(r.as_str())));
31        }
32        let path = if params.is_empty() {
33            "/distribution/public/products/by-family".to_string()
34        } else {
35            format!(
36                "/distribution/public/products/by-family?{}",
37                params.join("&")
38            )
39        };
40        self.commerce_get_list(&path, signal).await
41    }
42
43    /// 按 slug 查询单个在售商品。slug = biz_product_id(UNIQUE)。对应 TS `getProductBySlug`。
44    ///
45    /// 找不到或已下架 → 抛 [`Error::Http`] 404(或空 data → Err)。
46    pub async fn get_product_by_slug(
47        &self,
48        slug: &str,
49        region: Option<RegionScope>,
50        signal: Option<CancellationToken>,
51    ) -> Result<Product> {
52        if slug.is_empty() {
53            return Err(Error::other("getProductBySlug: slug is required"));
54        }
55        let path = match region {
56            Some(r) => format!(
57                "/distribution/public/products/by-slug/{}?region={}",
58                urlencoding(slug),
59                urlencoding(r.as_str())
60            ),
61            None => format!(
62                "/distribution/public/products/by-slug/{}",
63                urlencoding(slug)
64            ),
65        };
66        // TS: `if (!resp.data) throw new Error(...)` —— 空 data 抛 Err。
67        self.commerce_get_opt::<Product>(&path, signal)
68            .await?
69            .ok_or_else(|| {
70                Error::other(format!("getProductBySlug: product not found (slug={slug})"))
71            })
72    }
73}