cms-website/packages/contracts/test/manifests.test.ts

import { describe, it, expect } from 'vitest'
import {
  ROUTE_MANIFEST_VERSION, RENDER_SNAPSHOT_VERSION, THEME_MANIFEST_VERSION,
  RENDER_SNAPSHOT_FILES, isRouteManifest, isThemeManifest,
} from '../src/index.js'

const validRouteManifest: any = {
  manifest_version: 1, site_id: 's1', build_job_id: 'b1', origin: 'https://fixture.example',
  generated_from_route_snapshot_hash: 'abc',
  routes: [{ exact_key: '/', query_policy: 'ignore', kind: 'html', target_file: 'index.html', status: 200, indexable: true }],
}

const validThemeManifest: any = {
  key: 'pilot-minimal', version: '0.1.0', renderContractVersion: '1',
  supportedContentTypes: ['news_article', 'product', 'basic_page'],
  requiredSiteConfig: ['origin', 'listPaths'],
  templates: [{ key: 'home', appliesTo: 'home' }],
}

describe('manifest 契约', () => {
  it('三个版本号冻结为 1', () => {
    expect([ROUTE_MANIFEST_VERSION, RENDER_SNAPSHOT_VERSION, THEME_MANIFEST_VERSION]).toEqual([1, 1, 1])
  })
  it('Render Snapshot 文件清单冻结（spec §9.2）', () => {
    expect(RENDER_SNAPSHOT_FILES).toEqual([
      'site.json', 'content.json', 'taxonomies.json', 'routes.json', 'assets.json', 'render-manifest.json',
    ])
  })
  it('合法 RouteManifest 通过守卫', () => {
    expect(isRouteManifest({
      manifest_version: 1, site_id: 's1', build_job_id: 'b1', origin: 'https://fixture.example',
      generated_from_route_snapshot_hash: 'abc',
      routes: [{ exact_key: '/', query_policy: 'ignore', kind: 'html', target_file: 'index.html', status: 200, indexable: true }],
    })).toBe(true)
  })
  it('非法 kind 拒绝', () => {
    const m: any = { manifest_version: 1, site_id: 's', build_job_id: 'b', origin: 'o', generated_from_route_snapshot_hash: 'h', routes: [{ exact_key: '/', query_policy: 'ignore', kind: 'weird', status: 200, indexable: true }] }
    expect(isRouteManifest(m)).toBe(false)
  })
  it('合法 ThemeManifest 通过守卫', () => {
    expect(isThemeManifest({
      key: 'pilot-minimal', version: '0.1.0', renderContractVersion: '1',
      supportedContentTypes: ['news_article', 'product', 'basic_page'],
      requiredSiteConfig: ['origin', 'listPaths'],
      templates: [{ key: 'home', appliesTo: 'home' }],
    })).toBe(true)
  })
})

describe('RouteManifest 守卫拒绝路径', () => {
  it('manifest_version ≠ 1 拒绝（2 与字符串 "1"）', () => {
    expect(isRouteManifest({ ...validRouteManifest, manifest_version: 2 })).toBe(false)
    expect(isRouteManifest({ ...validRouteManifest, manifest_version: '1' })).toBe(false)
  })

  it('routes 非数组拒绝（字符串）', () => {
    expect(isRouteManifest({ ...validRouteManifest, routes: 'x' })).toBe(false)
  })

  it('routes 元素缺 exact_key / 元素为 null 拒绝', () => {
    const { exact_key: _omit, ...route } = validRouteManifest.routes[0]
    expect(isRouteManifest({ ...validRouteManifest, routes: [route] })).toBe(false)
    expect(isRouteManifest({ ...validRouteManifest, routes: [null] })).toBe(false)
  })

  it('status 非数字拒绝（status: "200"）', () => {
    expect(isRouteManifest({
      ...validRouteManifest,
      routes: [{ ...validRouteManifest.routes[0], status: '200' }],
    })).toBe(false)
  })

  it('status 非整数拒绝（200.5）', () => {
    expect(isRouteManifest({
      ...validRouteManifest,
      routes: [{ ...validRouteManifest.routes[0], status: 200.5 }],
    })).toBe(false)
  })

  it('status 超域拒绝（999）', () => {
    expect(isRouteManifest({
      ...validRouteManifest,
      routes: [{ ...validRouteManifest.routes[0], status: 999 }],
    })).toBe(false)
  })

  it('indexable 非布尔拒绝（indexable: 1）', () => {
    expect(isRouteManifest({
      ...validRouteManifest,
      routes: [{ ...validRouteManifest.routes[0], indexable: 1 }],
    })).toBe(false)
  })

  it('query_policy 非四值之一拒绝', () => {
    expect(isRouteManifest({
      ...validRouteManifest,
      routes: [{ ...validRouteManifest.routes[0], query_policy: 'loose' }],
    })).toBe(false)
  })

  it('顶层必填字符串字段非字符串拒绝（site_id 数字）', () => {
    expect(isRouteManifest({ ...validRouteManifest, site_id: 101 })).toBe(false)
  })

  it('非对象输入拒绝（null / number / array）', () => {
    expect(isRouteManifest(null)).toBe(false)
    expect(isRouteManifest(42)).toBe(false)
    expect(isRouteManifest([])).toBe(false)
  })
})

describe('ThemeManifest 守卫拒绝路径', () => {
  it('version 非 semver 拒绝（"abc" 与 "1"）', () => {
    expect(isThemeManifest({ ...validThemeManifest, version: 'abc' })).toBe(false)
    expect(isThemeManifest({ ...validThemeManifest, version: '1' })).toBe(false)
  })

  it('key 非字符串拒绝（数字）', () => {
    expect(isThemeManifest({ ...validThemeManifest, key: 42 })).toBe(false)
  })

  it('templates 非数组拒绝', () => {
    expect(isThemeManifest({ ...validThemeManifest, templates: 'x' })).toBe(false)
  })

  it('templates 元素缺 appliesTo 拒绝（查值类型，不只查键存在）', () => {
    expect(isThemeManifest({
      ...validThemeManifest,
      templates: [{ key: 'home', appliesTo: 42 }],
    })).toBe(false)
  })

  it('renderContractVersion 非字符串拒绝', () => {
    expect(isThemeManifest({ ...validThemeManifest, renderContractVersion: 1 })).toBe(false)
  })

  it('非对象输入拒绝（null / number）', () => {
    expect(isThemeManifest(null)).toBe(false)
    expect(isThemeManifest(42)).toBe(false)
  })
})