/** 教程包列表加载模型:解析 /api/admin/tutorials data.items(snake);纯逻辑。 */ import { unwrap } from '../../api/envelope.ts' import { type TutorialPackageItem, type TutorialPackageList } from './tutorial-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 toTutorialPackageItem(raw: unknown): TutorialPackageItem | null { if (!raw || typeof raw !== 'object') return null const r = raw as Record const id = numberOrNull(r.id) if (id === null) return null return { id, fileName: text(r.file_name ?? r.fileName), objectKey: text(r.object_key ?? r.objectKey), fileSize: numberOrNull(r.file_size ?? r.fileSize) ?? 0, fileUrl: text(r.file_url ?? r.fileUrl), createdAt: text(r.created_at ?? r.createdAt), } } /** 归一化教程包列表负载为前端结果;缺省回空列表。 */ export function parseTutorialPackageList(payload: unknown): TutorialPackageList { const data = unwrap(payload) const record = data && typeof data === 'object' ? (data as Record) : {} const items = Array.isArray(record.items) ? record.items.map((raw) => toTutorialPackageItem(raw)).filter((item): item is TutorialPackageItem => item !== null) : [] return { items } } /** 上传成功后返回的新记录行(data.item);无 item 回 null。 */ export function parseTutorialPackageUpload(payload: unknown): TutorialPackageItem | null { const data = unwrap(payload) if (!data || typeof data !== 'object') return null const item = (data as Record).item return item ? toTutorialPackageItem(item) : null } /** 字节数展示:0=未知展示为 -,其余按 KB/MB/GB 人性化。 */ export function formatFileSize(bytes: number): string { if (!Number.isFinite(bytes) || bytes <= 0) return '—' if (bytes < 1024) return `${bytes} B` const units = ['KB', 'MB', 'GB'] let value = bytes / 1024 let unitIndex = 0 while (value >= 1024 && unitIndex < units.length - 1) { value /= 1024 unitIndex += 1 } return `${value >= 100 ? value.toFixed(0) : value.toFixed(1)} ${units[unitIndex]}` }