xiaoxia-saas/apps/web/src/api/subscription.ts

/**
 * 订阅 API 模块
 * 对接后端订阅管理接口
 */
import apiClient from "./client"

/** 套餐类型 */
export type PlanType = "free" | "standard" | "pro" | "enterprise"

/** 订阅状态 */
export type SubscriptionStatus = "active" | "expired" | "cancelled" | "trial"

/** 账单状态 */
export type BillingStatus = "paid" | "pending" | "failed" | "refunded"

/** 计费周期 */
export type BillingCycle = "monthly" | "yearly"

/** 套餐信息 */
export interface Plan {
  id: PlanType
  name: string
  price: number | null
  yearly_price?: number | null
  description: string
  recommended: boolean
  features: string[]
}

/** 当前订阅信息 */
export interface SubscriptionInfo {
  id: string
  plan_id: PlanType
  plan_name: string
  status: SubscriptionStatus
  billing_cycle: BillingCycle
  current_period_start: string
  current_period_end: string
  amount: number
  auto_renew: boolean
  created_at: string
}

/** 账单记录 */
export interface BillingRecord {
  id: string
  plan_name: string
  amount: number
  billing_cycle: BillingCycle
  status: BillingStatus
  payment_method: string
  created_at: string
  invoice_url?: string
}

/** 升级/降级请求 */
export interface ChangePlanRequest {
  target_plan_id: PlanType
  billing_cycle: BillingCycle
}

/** 升级/降级响应 */
export interface ChangePlanResponse {
  success: boolean
  message: string
  new_subscription?: SubscriptionInfo
}

// ============ API 函数 ============

/** 获取当前订阅信息 */
export const getCurrentSubscription = async (): Promise<SubscriptionInfo> => {
  const response = await apiClient.get("/subscription/current")
  return response.data
}

/** 获取账单记录列表 */
export const getBillingRecords = async (): Promise<BillingRecord[]> => {
  const response = await apiClient.get("/subscription/billing-records")
  return response.data
}

/** 升级/降级套餐 */
export const changePlan = async (request: ChangePlanRequest): Promise<ChangePlanResponse> => {
  const response = await apiClient.post("/subscription/change-plan", request)
  return response.data
}

/** 取消订阅 */
export const cancelSubscription = async (): Promise<{
  success: boolean
  message: string
}> => {
  const response = await apiClient.post("/subscription/cancel")
  return response.data
}

/** 切换自动续费 */
export const toggleAutoRenew = async (
  enabled: boolean,
): Promise<{ success: boolean; message: string }> => {
  const response = await apiClient.post("/subscription/toggle-auto-renew", {
    enabled,
  })
  return response.data
}