Files
dacli/tests/unit/app_context_workflow.test.ts
sushub f403a7e80e import: ssw/dacli@eea0ebc (2026-08-12) 起点版本
本仓 2026-08-12 从 ssw main (192.168.1.18:13300/ssw/ssw-mvp) 的
dacli/ subpath 抽取,作为独立仓托管到 gitea:3000/ssw/dacli.git。

- 工作树为 ssw main dacli subpath 最新版 (110 commit, 08-12)
- 历史未带 ssw main 整体历史(避免大仓污染)
- 此为新仓基线 commit,未来以本仓历史为主
2026-08-12 15:58:06 +08:00

197 lines
7.7 KiB
TypeScript

/**
* tests/unit/app_context_workflow.test.ts
*
* 覆盖 src/commands/app/context.ts tryFetchWorkflows (2026-07-22 eventhub 阻断修复)
*
* 修复前 symptom:
* - `dacli app context --json` 启动时调 POST /workflow/Engine/list, 后端返 404.
* - 旧版直接套用 web 历史 fallback 端点, 没读 web .../api/workFlow/template.ts
* 权威定义 (GET /workflow/template).
* - 修复后改回 web 镜像权威端点, 跟 _auto_fix.ts:fetchExistingLists 一致.
*
* 测试目标:
* - tryFetchWorkflows 走 GET /workflow/template 而非 POST /workflow/Engine/list
* - 拉到 list 时返 `id:enCode` 字符串数组
* - 后端 code !== 200 → 返回 [] + warning 字符串 (不抛)
* - 异常 (network/throw) → 返回 [] + warning 字符串 (不抛)
* - 边界: list=[] / list 含无效项被过滤
*/
import { describe, it, expect, vi } from 'vitest'
// Mock JnpfClient 最小形状 (tryFetchWorkflows 只用 c.get)
const mocks = vi.hoisted(() => ({
get: vi.fn(),
}))
vi.mock('../../src/core/client.ts', () => ({
JnpfClient: {
fromToken: vi.fn(async () => ({ get: mocks.get })),
},
}))
vi.mock('../../src/core/log.ts', () => ({
log: {
setQuiet: vi.fn(),
setJsonMode: vi.fn(),
isJsonMode: vi.fn(),
flush: vi.fn(),
discard: vi.fn(),
info: vi.fn(),
warn: vi.fn(),
error: vi.fn(),
dim: vi.fn(),
raw: vi.fn(),
debug: vi.fn(),
},
}))
import { tryFetchWorkflows } from '../../src/commands/app/context.ts'
describe('tryFetchWorkflows — 走 web 权威 GET /workflow/template (eventhub blocker 修复核心)', () => {
it('调用 c.get 而非 c.postJson (端点权威 GET)', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } })
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
// 1. 必须走 GET (端点: GET /workflow/template, query 含 keyword/currentPage/pageSize)
expect(mocks.get).toHaveBeenCalledTimes(1)
const [url, query] = mocks.get.mock.calls[0]
expect(url).toBe('/workflow/template')
// query 应包含 keyword/currentPage/pageSize
expect(query).toMatchObject({
keyword: '',
currentPage: 1,
pageSize: expect.any(Number),
})
expect(result.workflows).toEqual([])
})
it('显式反断言: 不能走 POST /workflow/Engine/list (旧版 fallback 已禁用)', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } })
const fakeClient = { get: mocks.get } as any
await tryFetchWorkflows(fakeClient)
// 取 url 参数:
const url = mocks.get.mock.calls[0][0]
expect(url).not.toBe('/workflow/Engine/list')
expect(url).not.toMatch(/Engine\/list/)
})
it('拉取成功: list=[{id, enCode}] → 返回 `id:enCode` 字符串', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({
code: 200,
data: {
list: [
{ id: '123', enCode: 'leaveFlow' },
{ id: '456', enCode: 'approveFlow' },
],
},
})
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual(['123:leaveFlow', '456:approveFlow'])
expect(result.warning).toBeUndefined()
})
it('拉取成功: list 含无效项 → 跳过 null + 跳过纯空对 `":"`', async () => {
// 当前实现: 先 .filter 排除 null, 然后 map `${id}:${enCode}`, 最后 filter `s !== ':'`.
// 因此 `{id:'', enCode:''}` → `:` 被过滤;
// `{id:'3', enCode:''}` → `3:` 保留 (id 有值, 即使 enCode 空);
// 这里只验: null 项被跳, 全空对 `:` 被过滤 (空 enCode+空 id 仍能进).
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({
code: 200,
data: {
list: [
{ id: '1', enCode: 'good' },
{ id: '3', enCode: '' }, // 3: 保留 (id 非空)
{ id: '', enCode: '' }, // : → 被 filter 跳 (全空)
null, // null → 被 filter 跳
{ id: '5', enCode: 'real' },
],
},
})
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual(['1:good', '3:', '5:real'])
// 显式反断言: 纯空对 `:` 不进入 (避免产生 ":" 字符串噪声)
expect(result.workflows).not.toContain(':')
})
it('拉取成功: 后端返空 list → [], no warning', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } })
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toBeUndefined()
})
it('拉取成功: 后端无 data 字段 → fallback [] (容错)', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 200 }) // 无 data
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toBeUndefined()
})
})
describe('tryFetchWorkflows — 容错 (不抛, 返回 warning)', () => {
it('后端 code !== 200 → warning 字符串 + 空数组', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 500, msg: 'database down' })
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toContain('workflow list 失败')
expect(result.warning).toContain('500')
expect(result.warning).toContain('database down')
})
it('后端 code !== 200 但无 msg → warning 含默认 "未知错误" 痕迹', async () => {
// 用例保证不抛 → warning 至少描述事件 (容错 stdout)
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 500 }) // 无 msg
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toContain('workflow list 失败')
})
it('网络异常 (throw) → warning 含 "异常" 字样 + 空数组', async () => {
mocks.get.mockReset()
mocks.get.mockRejectedValueOnce(new Error('ECONNREFUSED 127.0.0.1:30000'))
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toContain('workflow list 异常')
expect(result.warning).toContain('ECONNREFUSED')
})
it('非 Error 类型异常 (字符串) → 不抛, warning 含"异常"字样 (不要求含原信息)', async () => {
// 注: 当前实现 `(e as Error).message` 对非 Error 类型取 message 失败 → "undefined".
// 这是 pre-existing 行为 (eventhub blocker 不要求修), 这里仅验证不抛 + warning 含 "异常".
mocks.get.mockReset()
mocks.get.mockRejectedValueOnce('network timeout')
const fakeClient = { get: mocks.get } as any
const result = await tryFetchWorkflows(fakeClient)
expect(result.workflows).toEqual([])
expect(result.warning).toContain('workflow list 异常')
})
})
describe('tryFetchWorkflows — PAGE_SIZE 默认 500 (与 _auto_fix.fetchExistingLists 一致)', () => {
it('pageSize ≥ 500 (一次拉完, 避免分页遗漏)', async () => {
mocks.get.mockReset()
mocks.get.mockResolvedValueOnce({ code: 200, data: { list: [] } })
const fakeClient = { get: mocks.get } as any
await tryFetchWorkflows(fakeClient)
const [, query] = mocks.get.mock.calls[0]
expect((query as { pageSize: number }).pageSize).toBeGreaterThanOrEqual(500)
})
})