task-10: types/task.ts 共享类型（TaskStatus/ResultFilePhase/PageResult/TaskProgressBatchVo）

2026-08-31 19:24:26 +08:00
parent 9349f8ff33
commit 22422bc9d2
2 changed files with 99 additions and 0 deletions
@@ -0,0 +1,62 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import type {
+  TaskStatus,
+  ResultFilePhase,
+  PageResult,
+  TaskProgressBatchVo,
+} from '../src/shared/api/types/task.ts'
+
+test('test_type_task_status_assignable', () => {
+  const values: TaskStatus[] = ['PENDING', 'RUNNING', 'SUCCESS', 'FAILED', 'CANCELLED']
+  assert.equal(values.length, 5)
+  // @ts-expect-error 未知状态字符串不应可赋值
+  const invalid: TaskStatus = 'SYNCING'
+  assert.ok(invalid)
+})
+
+test('test_type_result_file_phase_all_optional', () => {
+  const empty: ResultFilePhase = {}
+  const partial: ResultFilePhase = { fileReady: true }
+  const full: ResultFilePhase = {
+    fileReady: true,
+    fileStatus: 'SUCCESS',
+    fileProgress: 100,
+    fileProgressLabel: '完成',
+    fileProgressStage: 'done',
+    freshDownloadUrl: '/newApi/api/x',
+  }
+  assert.deepEqual(empty, {})
+  assert.equal(partial.fileReady, true)
+  assert.equal(full.fileProgress, 100)
+})
+
+test('test_type_page_result_shape', () => {
+  const page: PageResult<{ id: number }> = {
+    items: [{ id: 1 }],
+    total: 1,
+    page: 1,
+    pageSize: 20,
+  }
+  assert.equal(page.items.length, 1)
+  assert.equal(page.total, 1)
+  // @ts-expect-error items 必须是元素数组，不是裸对象
+  const invalid: PageResult<{ id: number }> = { items: { id: 1 }, total: 1 }
+  assert.ok(invalid)
+})
+
+test('test_type_progress_batch_shape', () => {
+  const batch: TaskProgressBatchVo<{ taskId: number }> = {
+    items: [{ taskId: 1 }],
+    missingTaskIds: [99],
+  }
+  assert.equal(batch.items.length, 1)
+  assert.deepEqual(batch.missingTaskIds, [99])
+})
+
+test('test_type_compat_compile', () => {
+  // 类型与值在同一包内可被引用；运行时检查命名导出存在性由 vue-tsc 全量检查兜底
+  const s: TaskStatus = 'SUCCESS'
+  const statuses: string[] = [s, 'FAILED', 'CANCELLED']
+  assert.deepEqual(statuses, ['SUCCESS', 'FAILED', 'CANCELLED'])
+})