import { createRequest } from '@/utils/request'
import type { ResponseStructure } from '@/utils/request'

// ==================== 类型定义 ====================

/** 图片资源 */
export interface ApiImage {
  preview_url: string
  file_name: string
  id: number
}

/** 首页可点击链接项（轮播图 / 宫格导航共用） */
export interface HomeLinkItem {
  id: number
  title: string
  image: ApiImage
  link: string
  status: number // 0: 启用
  sort: number
  link_type: number // 0: 跳转 link 链接; 1: 跳转分类页
  category_id: number // link_type = 1 时携带的分类 ID
}

/** 首页活动项（结构与 HomeLinkItem 相同，额外多一个描述字段） */
export interface HomeActivityItem extends HomeLinkItem {
  description: string
}

/** 首页数据 */
export interface HomeData {
  carousel: HomeLinkItem[]
  gridNav: HomeLinkItem[]
  activity: HomeActivityItem[]
  site_title: string
}

/** 分类链接项（结构与 HomeLinkItem 相同，但不含 link_type / category_id，均为纯链接） */
export type CategoryLinkItem = Omit<HomeLinkItem, 'link_type' | 'category_id'> & {
  tag: string[]
}

// ==================== API ====================

/**
 * 获取首页数据（无需登录）
 */
export async function getHomeData(): Promise<ResponseStructure<HomeData>> {
  return createRequest<HomeData>({
    url: '/api/home',
    method: 'GET',
  })
}

/**
 * 获取指定分类下的链接列表（无需登录）
 * @param categoryId - 分类 ID
 */
export async function getCategoryLinks(categoryId: number): Promise<ResponseStructure<CategoryLinkItem[]>> {
  return createRequest<CategoryLinkItem[]>({
    url: `/api/category/${categoryId}`,
    method: 'GET',
  })
}