# event.ts

**路径**：`src/api/event.ts`

## 功能用途

Event（预测市场事件）相关接口与类型定义，对接 XTrader API 的 `/PmEvent/*` 接口。提供事件列表、详情查询，以及将接口数据映射为首页卡片所需结构的工具函数。

## 核心能力

- `getPmEventPublic`：分页获取公开事件列表（无需鉴权）；请求时固定传入 **startDateMax**、**endDateMin** 为当前时间戳（Unix 秒），**startDateMin**、**endDateMax** 不传；当后端支持入参 `q` 时，`q` 用作搜索关键词
- `findPmEvent`：按 id/slug 查询事件详情（需鉴权）
- `mapEventItemToCard`：将 `PmEventListItem` 转为 `EventCardItem`（供 MarketCard 使用）
- 内存缓存：`getEventListCache`、`setEventListCache`、`clearEventListCache`，用于列表切换页面时复用

## 类型说明

| 类型 | 说明 |
|------|------|
| `PmEventListItem` | 接口返回的事件项 |
| `PmEventMarketItem` | 市场项，含 outcomes、outcomePrices、clobTokenIds |
| `EventCardItem` | 首页卡片所需结构，含 displayType（single/multi） |
| `EventCardOutcome` | 多选项卡片中单个选项 |
| `PageResult<T>` | 分页结果（来自 `@/api/types`） |

## 使用方式

```typescript
import {
  getPmEventPublic,
  findPmEvent,
  mapEventItemToCard,
  clearEventListCache,
} from '@/api/event'

// 获取列表
const res = await getPmEventPublic({ page: 1, pageSize: 10, q: 'btc' })
const cards = res.data.list.map(mapEventItemToCard)

// 获取详情（需鉴权）
const detail = await findPmEvent({ id: 123 }, { headers: authHeaders })

// 下拉刷新时清空缓存
clearEventListCache()
```

## 扩展方式

1. **新增筛选参数**：在 `GetPmEventListParams` 中增加字段，并在 `getPmEventPublic` 的 query 中传入
2. **缓存策略**：可改为 sessionStorage 或带 TTL 的缓存
3. **多选项展示**：`mapEventItemToCard` 已支持 multi 类型，内部拆分为 `formatVolume`、`formatExpiresAt`、`parseOutcomePrices`、`mapMarketToOutcome` 等小函数，可扩展 `EventCardOutcome` 字段

## 参数传递方式

### tagIds 参数（数组）

`tagIds` 使用传统数组方式传递，不再是逗号分隔的字符串：

```typescript
// 正确方式 - 直接传递数组
const res = await getPmEventPublic({
  page: 1,
  pageSize: 10,
  tagIds: [1, 2, 3]  // 会作为多个同名参数传递：?tagIds=1&tagIds=2&tagIds=3
})
```