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

/**
 * 模板相关 API
 * 对接后端模板管理接口：
 * - GET  /api/v1/templates              — 模板列表（分页/筛选）
 * - GET  /api/v1/templates/{id}         — 模板详情
 * - POST /api/v1/templates/{id}/copy    — 复制模板
 * - POST /api/v1/templates/{id}/generate — 从模板生成剪辑计划
 * - POST /api/v1/templates/{id}/toggle-favorite — 收藏/取消收藏
 */
import apiClient from "./client"
import type { TitleConfig, SubtitleConfig, BgmConfig } from "./editingPlanner"
import type { EditPlanConfig } from "./editPlans"

/* ──────────── 类型定义 ──────────── */

/** 模板条目（后端 TemplateResponse） */
export interface TemplateItem {
  id: string
  user_id?: string
  name: string
  description?: string
  mode?: string
  category: string
  tags?: string[]
  /** 预估时长（后端字段名 estimated_duration） */
  estimated_duration?: number
  /** @deprecated 后端已改名为 estimated_duration，保留兼容 */
  target_duration?: number
  clip_count?: number
  /** 使用次数 */
  usage_count?: number
  thumbnail_url?: string
  preview_url?: string
  is_active?: boolean
  is_favorite?: boolean
  /** 素材规则（片段配置） */
  segments?: TemplateSegment[]
  /** 字幕样式 */
  subtitle_config?: SubtitleConfig
  /** BGM 配置 */
  bgm_config?: BgmConfig
  /** 标题配置 */
  title_config?: TitleConfig
  /** 视频比例 */
  aspect_ratio?: string
  created_at?: string
  updated_at?: string
}

/** 模板片段（素材规则） */
export interface TemplateSegment {
  id?: string
  segment_order: number
  duration_min: number
  duration_max: number
  material_type: string | null
  description?: string
}

/** 模板列表查询参数 */
export interface TemplateListParams {
  page?: number
  page_size?: number
  category?: string
  tags?: string
  keyword?: string
  /** 时长筛选（秒）：short < 30, medium 30-120, long > 120 */
  duration_range?: "short" | "medium" | "long"
}

/** 模板列表分页响应 */
export interface TemplateListResponse {
  items: TemplateItem[]
  total: number
  page: number
  page_size: number
}

/** 从模板生成剪辑计划请求 */
export interface GenerateFromTemplateRequest {
  asset_ids?: string[]
  name?: string
  config?: EditPlanConfig
}

/** 从模板生成剪辑计划响应 */
export interface GenerateFromTemplateResponse {
  plan_id: string
  template_id: string
  status: string
  name: string
}

/** 复制模板响应 */
export interface CopyTemplateResponse {
  id: string
  name: string
  source_template_id: string
}

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

/** 获取模板列表（支持分页和筛选） */
export const getTemplates = async (params?: TemplateListParams): Promise<TemplateListResponse> => {
  const { data } = await apiClient.get<TemplateListResponse>("/templates", {
    params,
  })
  return data
}

/** 获取模板列表（兼容旧接口，返回数组） */
export const getTemplatesList = async (): Promise<TemplateItem[]> => {
  const response = await apiClient.get("/templates")
  return response.data.items || response.data || []
}

/** 获取单个模板详情 */
export const getTemplate = async (templateId: string): Promise<TemplateItem> => {
  const response = await apiClient.get(`/templates/${templateId}`)
  return response.data
}

/** 收藏 / 取消收藏模板 */
export const toggleFavoriteTemplate = async (
  templateId: string,
): Promise<{ is_favorite: boolean }> => {
  const response = await apiClient.post(`/templates/${templateId}/toggle-favorite`)
  return response.data
}

/** 复制模板（创建副本到我的模板） */
export const copyTemplate = async (templateId: string): Promise<CopyTemplateResponse> => {
  const response = await apiClient.post<CopyTemplateResponse>(`/templates/${templateId}/copy`)
  return response.data
}

/** 从模板生成剪辑计划 */
export const generateFromTemplate = async (
  templateId: string,
  data?: GenerateFromTemplateRequest,
): Promise<GenerateFromTemplateResponse> => {
  const response = await apiClient.post<GenerateFromTemplateResponse>(
    `/templates/${templateId}/generate`,
    data,
  )
  return response.data
}

/* ──────────── 常量 ──────────── */

/** 模板分类选项 */
export const TEMPLATE_CATEGORY_OPTIONS = [
  { value: "", label: "全部分类" },
  { value: "口播", label: "口播" },
  { value: "种草", label: "种草" },
  { value: "产品", label: "产品" },
  { value: "品牌", label: "品牌" },
  { value: "混剪", label: "混剪" },
  { value: "Vlog", label: "Vlog" },
]

/** 时长筛选选项 */
export const TEMPLATE_DURATION_OPTIONS = [
  { value: "", label: "全部时长" },
  { value: "short", label: "30秒以内" },
  { value: "medium", label: "30秒-2分钟" },
  { value: "long", label: "2分钟以上" },
]