xiaoxia-saas/apps/web/src/api/voice-clone.ts

/**
 * 音色克隆 API
 * 任务 3.11：替换 Mock 数据，对接后端真实 API（3.05）
 * 任务 3.15：新增 progress 字段用于进度展示
 */
import apiClient from "./client"

/* ── 前端兼容类型 ─────────────────────────────────────── */

/** 克隆音色状态（前端展示用） */
export type VoiceCloneStatus = "ready" | "processing" | "failed"

/** 克隆音色条目（前端展示用） */
export interface VoiceClone {
  id: string
  name: string
  description: string
  duration_seconds: number
  status: VoiceCloneStatus
  /** 克隆进度 0-100，仅 processing 状态时有值 */
  progress: number
  sample_url?: string
  language: string
  gender: string
  error_message: string | null
  created_at: string
  updated_at: string
}

/** 创建克隆请求（前端简化版） */
export interface CreateVoiceCloneRequest {
  name: string
  audio_url: string
  description?: string
}

/* ── 后端 API 类型 ────────────────────────────────────── */

/** 音色克隆元数据（克隆时附带的扩展信息） */
export interface VoiceCloneMetadata {
  /** 语音时长（秒） */
  duration?: number
  /** 采样率（Hz） */
  sample_rate?: number
  /** 音色 ID（克隆完成后分配） */
  voice_id?: string
  /** 其他扩展字段 */
  [key: string]: unknown
}

/** 后端克隆档案响应 */
export interface VoiceCloneProfile {
  id: string
  user_id: string
  name: string
  description: string
  source_audio_url: string
  voice_id: string | null
  voice_model: string
  language: string
  gender: string
  status: "pending" | "processing" | "ready" | "failed"
  error_message: string | null
  retry_count: number
  max_retries: number
  metadata_: VoiceCloneMetadata | null
  created_at: string
  updated_at: string
}

/** 后端克隆列表响应 */
export interface ListVoiceCloneResponse {
  items: VoiceCloneProfile[]
  total: number
}

/** 后端克隆状态响应 */
export interface VoiceCloneStatusResponse {
  id: string
  status: "pending" | "processing" | "ready" | "failed"
  error_message: string | null
  voice_id: string | null
  retry_count: number
}

/** 后端创建克隆请求（完整版） */
export interface CreateVoiceCloneRequestFull {
  name: string
  description?: string
  source_audio_url: string
  voice_model?: string
  language?: string
  gender?: string
  max_retries?: number
  metadata_?: VoiceCloneMetadata
}

/* ── 辅助函数 ─────────────────────────────────────────── */

/**
 * 将后端 VoiceCloneProfile 转换为前端 VoiceClone
 * 后端 status "pending" 映射为前端 "processing"
 */
export const toVoiceClone = (profile: VoiceCloneProfile): VoiceClone => ({
  id: profile.id,
  name: profile.name,
  description: profile.description || "",
  duration_seconds: 0,
  status: profile.status === "pending" ? "processing" : profile.status,
  progress: 0,
  sample_url: profile.source_audio_url || undefined,
  language: profile.language || "",
  gender: profile.gender || "",
  error_message: profile.error_message || null,
  created_at: profile.created_at,
  updated_at: profile.updated_at,
})

/** 格式化时长 */
export const formatDuration = (seconds: number): string => {
  const m = Math.floor(seconds / 60)
  const s = seconds % 60
  return `${m}:${String(s).padStart(2, "0")}`
}

/* ── 查询参数 ─────────────────────────────────────────── */

export interface VoiceCloneListParams {
  status?: string
  skip?: number
  limit?: number
}

/* ── API 函数 ─────────────────────────────────────────── */

/** 获取克隆音色列表（返回前端兼容数组） */
export const getVoiceClones = async (params?: VoiceCloneListParams): Promise<VoiceClone[]> => {
  const searchParams = new URLSearchParams()
  if (params?.status) searchParams.set("status", params.status)
  if (params?.skip !== undefined) searchParams.set("skip", String(params.skip))
  if (params?.limit !== undefined) searchParams.set("limit", String(params.limit))
  const qs = searchParams.toString()
  const response = await apiClient.get<ListVoiceCloneResponse>(`/voice-clones${qs ? `?${qs}` : ""}`)
  return response.data.items.map(toVoiceClone)
}

/** 获取克隆音色列表（返回完整响应含 total） */
export const getVoiceClonesWithTotal = async (
  params?: VoiceCloneListParams,
): Promise<ListVoiceCloneResponse> => {
  const searchParams = new URLSearchParams()
  if (params?.status) searchParams.set("status", params.status)
  if (params?.skip !== undefined) searchParams.set("skip", String(params.skip))
  if (params?.limit !== undefined) searchParams.set("limit", String(params.limit))
  const qs = searchParams.toString()
  const response = await apiClient.get<ListVoiceCloneResponse>(`/voice-clones${qs ? `?${qs}` : ""}`)
  return response.data
}

/** 获取单个克隆音色详情 */
export const getVoiceCloneDetail = async (id: string): Promise<VoiceCloneProfile> => {
  const response = await apiClient.get<VoiceCloneProfile>(`/voice-clones/${id}`)
  return response.data
}

/** 创建克隆音色 */
export const createVoiceClone = async (
  data: CreateVoiceCloneRequest,
): Promise<VoiceCloneProfile> => {
  const payload: CreateVoiceCloneRequestFull = {
    name: data.name,
    description: data.description,
    source_audio_url: data.audio_url,
  }
  const response = await apiClient.post<VoiceCloneProfile>("/voice-clones", payload)
  return response.data
}

/** 删除克隆音色 */
export const deleteVoiceClone = async (id: string): Promise<void> => {
  await apiClient.delete(`/voice-clones/${id}`)
}

/** 更新克隆音色名称（stub — 后端暂无 PATCH 端点） */
export const updateVoiceClone = async (
  id: string,
  data: Partial<Pick<VoiceClone, "name">>,
): Promise<VoiceClone> => {
  // 后端暂未提供更新端点，暂用详情接口模拟
  const response = await apiClient.get<VoiceCloneProfile>(`/voice-clones/${id}`)
  return toVoiceClone({
    ...response.data,
    ...data,
    updated_at: new Date().toISOString(),
  })
}

/** 获取克隆状态 */
export const getVoiceCloneStatus = async (id: string): Promise<VoiceCloneStatusResponse> => {
  const response = await apiClient.get<VoiceCloneStatusResponse>(`/voice-clones/${id}/status`)
  return response.data
}

/** 重试克隆 */
export const retryVoiceClone = async (id: string): Promise<VoiceCloneProfile> => {
  const response = await apiClient.post<VoiceCloneProfile>(`/voice-clones/${id}/retry`)
  return response.data
}