Skip to main content

acosmi/subscription/
client.rs

1//! 订阅域业务方法。端口自 `subscription/client.ts`(declaration-merging → `impl Client` 块)。
2//!
3//! 端点对应 tk-dist `/api/distribution/public/pricing/plans` 等,经 Go 网关 `/api/v4/...` 反代。
4//! 当前订阅规范入口是网关 GET /entitlements/membership(get_membership)。
5
6use super::types::{
7    Membership, SubscriptionAudience, SubscriptionPlan, SubscriptionPrecheckResult,
8    SubscriptionTier,
9};
10use crate::billing::entitlements::urlencoding;
11use crate::core::client::Client;
12use crate::shared::Result;
13use tokio_util::sync::CancellationToken;
14
15impl Client {
16    /// 列出当前可售订阅计划;`audience` 可选过滤。对应 TS `listPlans`。
17    ///
18    /// 空 data → 空数组(对应 TS `Array.isArray(resp.data) ? resp.data : []`)。
19    pub async fn list_plans(
20        &self,
21        audience: Option<SubscriptionAudience>,
22        signal: Option<CancellationToken>,
23    ) -> Result<Vec<SubscriptionPlan>> {
24        let path = match audience {
25            Some(a) => format!(
26                "/distribution/public/pricing/plans?audience={}",
27                urlencoding(a.as_str())
28            ),
29            None => "/distribution/public/pricing/plans".to_string(),
30        };
31        self.commerce_get_list(&path, signal).await
32    }
33
34    /// 查询当前用户会员/订阅概览(C 端会员中心)。对应 TS `getMembership`。
35    ///
36    /// 无活跃订阅时 has_active=false / is_free=true。
37    pub async fn get_membership(&self, signal: Option<CancellationToken>) -> Result<Membership> {
38        self.commerce_get("/entitlements/membership", signal).await
39    }
40
41    /// 由活跃权益推导订阅层级(free/pro)。对应 TS `getSubscriptionTier`。
42    pub async fn get_subscription_tier(
43        &self,
44        signal: Option<CancellationToken>,
45    ) -> Result<SubscriptionTier> {
46        self.commerce_get("/entitlements/subscription", signal)
47            .await
48    }
49
50    /// 订阅支付前绑定硬闸。对应 TS `subscriptionPrecheck`。
51    ///
52    /// 返回 `{ok:true}` 表示已绑定手机/邮箱可放行支付;未绑定时网关返回 HTTP 403 + 业务码
53    /// 41001([`crate::Error::Http`] / [`crate::Error::Business`]),调用方据此引导用户先绑定联系方式。
54    pub async fn subscription_precheck(
55        &self,
56        signal: Option<CancellationToken>,
57    ) -> Result<SubscriptionPrecheckResult> {
58        self.commerce_get("/consumer/subscriptions/precheck", signal)
59            .await
60    }
61
62    /// **@deprecated** 网关无订阅列表端点;现委托 `get_membership()`:有活跃订阅返回单元素数组,
63    /// 否则空数组。对应 TS `listUserSubscriptions`。
64    pub async fn list_user_subscriptions(
65        &self,
66        signal: Option<CancellationToken>,
67    ) -> Result<Vec<Membership>> {
68        let m = self.get_membership(signal).await?;
69        if m.has_active {
70            Ok(vec![m])
71        } else {
72            Ok(Vec::new())
73        }
74    }
75
76    /// 按 planCode 精确取单个可售订阅计划(复用 list_plans 客户端过滤)。对应 TS `getPlanByCode`。
77    ///
78    /// 未命中返回 `None`。空 plan_code 直接返回 `None`。
79    pub async fn get_plan_by_code(
80        &self,
81        plan_code: &str,
82        signal: Option<CancellationToken>,
83    ) -> Result<Option<SubscriptionPlan>> {
84        if plan_code.is_empty() {
85            return Ok(None);
86        }
87        let plans = self.list_plans(None, signal).await?;
88        Ok(plans.into_iter().find(|p| p.plan_code == plan_code))
89    }
90}