task-139(记录与版本中心): 补充版本接口公开契约回归夹具

新增 public-version-contract.ts：/api/version(/latest) 字段与空语义匹配夹具。

TDD: task-139.test.ts 8 用例 RED→GREEN。

admin-frontend-vue/src/pages/records/public-version-contract.ts

@@ -0,0 +1,24 @@
+/** 客户端公开版本接口回归契约（任务 139，细则见 09 模块）：字段名/空语义固定夹具；纯逻辑。 */
+
+/** 公开接口契约键：/api/version {version,desc,url}；/api/version/latest {version,file_url}。 */
+export function publicContractKeys(): string[] {
+  return ['version', 'desc', 'url', 'file_url']
+}
+
+function hasOwn(record: Record<string, unknown>, key: string): boolean {
+  return Object.prototype.hasOwnProperty.call(record, key)
+}
+
+/** 最新版本契约：顶层必须带 version 与 file_url(允许 null/空串)，且不被 success 信封包裹。 */
+export function matchesPublicLatestContract(payload: unknown): boolean {
+  if (!payload || typeof payload !== 'object') return false
+  const record = payload as Record<string, unknown>
+  return hasOwn(record, 'version') && hasOwn(record, 'file_url') && !hasOwn(record, 'success')
+}
+
+/** 基础版本契约：顶层必须带 version、desc、url，不被 success 信封包裹。 */
+export function matchesPublicVersionContract(payload: unknown): boolean {
+  if (!payload || typeof payload !== 'object') return false
+  const record = payload as Record<string, unknown>
+  return hasOwn(record, 'version') && hasOwn(record, 'desc') && hasOwn(record, 'url') && !hasOwn(record, 'success')
+}

admin-frontend-vue/tests/task-139.test.ts

@@ -0,0 +1,52 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+import {
+  matchesPublicLatestContract,
+  matchesPublicVersionContract,
+  publicContractKeys,
+} from '../src/pages/records/public-version-contract.ts'
+
+test('test_task_139_public_contract_normal_primary_path', () => {
+  // 正常主路径：最新版本负载满足公开契约键。
+  assert.equal(matchesPublicLatestContract({ version: '1.0.46', file_url: 'https://a.zip' }), true)
+  assert.equal(matchesPublicVersionContract({ version: '1.0.0', desc: 'x', url: 'https://a' }), true)
+})
+
+test('test_task_139_public_contract_normal_variant_input', () => {
+  // 正常变体：允许空语义(null/空串)。
+  assert.equal(matchesPublicLatestContract({ version: null, file_url: null }), true)
+  assert.equal(matchesPublicLatestContract({ version: '', file_url: '' }), true)
+})
+
+test('test_task_139_public_contract_repeated_is_idempotent', () => {
+  // 正常重复：键集合稳定。
+  assert.deepEqual(publicContractKeys(), publicContractKeys())
+})
+
+test('test_task_139_public_contract_boundary_empty_input', () => {
+  // 边界空值：非对象不满足契约。
+  assert.equal(matchesPublicLatestContract(null), false)
+})
+
+test('test_task_139_public_contract_boundary_single_item', () => {
+  // 边界单元素：缺失 file_url 不满足。
+  assert.equal(matchesPublicLatestContract({ version: '1.0.0' }), false)
+})
+
+test('test_task_139_public_contract_boundary_limit_or_missing_field', () => {
+  // 边界上限/缺字段：多余字段不影响契约匹配。
+  assert.equal(matchesPublicLatestContract({ version: '1', file_url: 'u', extra: 1 }), true)
+})
+
+test('test_task_139_public_contract_invalid_input_rejected', () => {
+  // 异常输入：不把 /api/admin/version 上传响应当成公开契约。
+  assert.equal(matchesPublicLatestContract({ success: true, data: { version: 'x', file_url: 'u' } }), false)
+})
+
+test('test_task_139_public_contract_dependency_failure_returns_actionable_message', () => {
+  // 依赖失败/可操作：契约纯逻辑、无框架/http。
+  const mod = readSource('src/pages/records/public-version-contract.ts')
+  assert.equal(/axios|http\.|vue/.test(mod), false, '契约保持纯逻辑')
+  assert.match(mod, /file_url/)
+})