/** 数字人版本列表加载模型(任务 132):解析 /api/digital-human/versions 数组负载(camel);纯逻辑。 */ import { unwrap } from '../../api/envelope.ts' import { normalizeDigitalHumanStatus, type DigitalHumanVersion, type DigitalHumanVersionList } from './digitalhuman-dto.ts' function text(value: unknown): string { return typeof value === 'string' ? value.trim() : '' } function numberOrNull(value: unknown): number | null { return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null } /** 解析单条数字人版本;缺 id 视为无效。 */ export function toDigitalHumanVersion(raw: unknown): DigitalHumanVersion | null { if (!raw || typeof raw !== 'object') return null const r = raw as Record const id = numberOrNull(r.id) if (id === null) return null const version: DigitalHumanVersion = { id, version: text(r.version), status: normalizeDigitalHumanStatus(r.status) } const fileSize = numberOrNull(r.fileSize) if (fileSize !== null) version.fileSize = fileSize const md5 = text(r.md5) if (md5) version.md5 = md5 const changelog = text(r.changelog) if (changelog) version.changelog = changelog const minClientVersion = text(r.minClientVersion) if (minClientVersion) version.minClientVersion = minClientVersion const downloadUrl = text(r.downloadUrl) if (downloadUrl) version.downloadUrl = downloadUrl const createdBy = text(r.createdBy) if (createdBy) version.createdBy = createdBy const createdAt = text(r.createdAt) if (createdAt) version.createdAt = createdAt const releasedAt = text(r.releasedAt) if (releasedAt) version.releasedAt = releasedAt if (typeof r.isLatest === 'boolean') version.isLatest = r.isLatest return version } /** 归一化版本列表负载(data 数组)为前端列表;缺省回空。 */ export function parseDigitalHumanVersions(payload: unknown): DigitalHumanVersionList { const data = unwrap(payload) const list = Array.isArray(data) ? data : data && typeof data === 'object' ? (data as Record).items : null if (!Array.isArray(list)) return { items: [] } return { items: list .map((raw) => toDigitalHumanVersion(raw)) .filter((version): version is DigitalHumanVersion => version !== null), } }