import { defineComponent, ref } from 'vue' import { mount, flushPromises, type VueWrapper } from '@vue/test-utils' import { afterEach, describe, expect, it, vi } from 'vitest' import { ApiError } from '@/lib/http' import { useImageGenerationPreview, type ImageGenerationSubmission } from '@/features/subject-images/generation-preview' import { imagePreviewFixture } from '../../fixtures/image-preview' import { imageAuthorizationsFixture } from '../../fixtures/billing' /** 仅挂载实际状态逻辑,所有请求均为无费用替身。 */ let wrapper: VueWrapper | undefined /** 每个用例释放监听与未完成预览。 */ afterEach(() => wrapper?.unmount()) /** * 建立受控表单,测试确认、版本和异步边界。 * @param generate 生成请求的确定性替身 * @param load 只读预览的确定性替身 * @returns 表单状态及真实共用逻辑 */ function setup( generate = vi.fn<() => Promise>( async (): Promise => ({ accepted: true }) ), load = vi.fn<() => Promise>>(async () => imagePreviewFixture()), target = 'form-1' ) { const open = ref(true), prompt = ref('初始描述') let flow!: ReturnType>> wrapper = mount( defineComponent({ setup() { flow = useImageGenerationPreview({ open, target: () => target, input: () => ({ prompt: prompt.value }), disabled: () => false, load, generate }) return () => null } }) ) return { flow, open, prompt, generate, load } } describe('生图预览与版本确认', () => { it('规划来源409清除当前成功状态,保留输入并等待确认,不自动重复生成', async () => { const { flow, prompt, load, generate } = setup( vi.fn<() => Promise>(async () => ({ accepted: false, cause: new ApiError('SCENE_CONTINUITY_REVIEW_STALE: 来源已变化', 409, { code: 'SCENE_CONTINUITY_REVIEW_STALE' }) })), undefined, 'scene-stale-project:shot' ) prompt.value = '保留这份用户输入' await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(flow.preview.value).toBeNull() expect(prompt.value).toBe('保留这份用户输入') expect(flow.canSubmit.value).toBe(false) expect(flow.staleNotice.value).toContain('衔接规划来源已变化') expect(generate).toHaveBeenCalledOnce() expect(load).toHaveBeenCalledOnce() }) it('停留页面期间批准到期也清除成功预检,不把旧费用准入继续用于生成', async () => { vi.useFakeTimers() try { vi.setSystemTime(new Date('2026-11-18T00:00:00Z')) const list = imageAuthorizationsFixture(), open = ref(true), generate = vi.fn<() => Promise>(async () => ({ accepted: true })) list.authorizations[0]!.input.expiresAt = new Date(Date.now() + 1000).toISOString() vi.stubGlobal( 'fetch', vi.fn(async () => Response.json({ data: { provider: 'openai-image', model: 'gpt-image-2.5-flare', context: { projectId: 'expiry-project', scope: 'keyframe', targetId: 'expiry-shot', sourceFingerprint: 'c'.repeat(64) }, planFingerprint: 'b'.repeat(64), authorization: list } }) ) ) let flow!: ReturnType>> wrapper = mount( defineComponent({ setup() { flow = useImageGenerationPreview({ open, target: () => 'expiry-project:expiry-shot', input: () => ({}), disabled: () => false, chargeContext: () => ({ projectId: 'expiry-project', scope: 'keyframe', targetId: 'expiry-shot', exactPreview: true }), load: async () => ({ ...imagePreviewFixture(), provider: 'openai-image', model: 'gpt-image-2.5-flare' }), generate }) return () => null } }) ) await flow.loadPreview() expect(flow.canSubmit.value).toBe(true) await vi.advanceTimersByTimeAsync(1001) expect(flow.preview.value).toBeNull() expect(flow.canSubmit.value).toBe(false) await flow.submit() expect(generate).not.toHaveBeenCalled() expect(flow.staleNotice.value).toContain('授权已到期') } finally { vi.useRealTimers() } }) it('预览成功且确认后才携带版本提交,修改描述立即清除旧确认', async () => { const { flow, prompt, generate } = setup() flow.acknowledged.value = true await flow.submit() expect(generate).not.toHaveBeenCalled() await flow.loadPreview() flow.acknowledged.value = true prompt.value = '新描述' expect(flow.preview.value).toBeNull() expect(flow.acknowledged.value).toBe(false) await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(generate).toHaveBeenCalledExactlyOnceWith({ prompt: '新描述', expectedPreviewFingerprint: 'a'.repeat(64) }) }) it('明确的预览过期 409 只重新预览,不自动重复收费请求', async () => { const generate = vi.fn<() => Promise>(async () => ({ accepted: false, cause: new ApiError('IMAGE_PREVIEW_STALE: 来源已变化', 409, { code: 'IMAGE_PREVIEW_STALE' }) })) const { flow, open, load } = setup(generate) await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(open.value).toBe(true) expect(load).toHaveBeenCalledTimes(2) expect(generate).toHaveBeenCalledOnce() expect(flow.acknowledged.value).toBe(false) expect(flow.canSubmit.value).toBe(false) expect(flow.staleNotice.value).toContain('重新确认') }) it('普通 409 和未知网络结果均不自动预览或重新提交', async () => { const { flow, load, generate } = setup( vi.fn<() => Promise>(async () => ({ accepted: false, cause: new ApiError('活动任务冲突', 409) })) ) await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(load).toHaveBeenCalledOnce() expect(generate).toHaveBeenCalledOnce() expect(flow.error.value).toContain('活动任务') expect(flow.acknowledged.value).toBe(false) }) it.each(['IMAGE_REQUIRED_REFERENCE_MISSING', 'IMAGE_REFERENCE_CAPACITY_EXCEEDED'])( '参考图阻断 %s 时禁止生成', async code => { const { flow, generate } = setup( undefined, vi.fn(async () => { throw new ApiError(code, 409, { code }) }) ) await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(flow.canSubmit.value).toBe(false) expect(generate).not.toHaveBeenCalled() } ) it('计费未知后即使重读免费预览也不重复发起同一目标', async () => { const generate = vi.fn<() => Promise>(async () => ({ accepted: false, cause: new ApiError('连接中断', 0) })) const { flow, open, prompt } = setup(generate, undefined, 'form-unknown') await flow.loadPreview() flow.acknowledged.value = true await flow.submit() open.value = false open.value = true prompt.value = '新参数' await flow.loadPreview() flow.acknowledged.value = true await flow.submit() expect(flow.canSubmit.value).toBe(false) expect(generate).toHaveBeenCalledOnce() wrapper?.unmount() const restored = setup(generate, undefined, 'form-unknown').flow await restored.loadPreview() restored.acknowledged.value = true await restored.submit() expect(restored.recoveryNotice.value).toContain('费用待核对') expect(generate).toHaveBeenCalledOnce() }) it('发出生成请求前先持久化标记,未回执时重开不能再次提交', async () => { const key = 'short-drama:image-request-unknown:form:in-flight' let finish!: (value: ImageGenerationSubmission) => void const generate = vi.fn<() => Promise>( () => new Promise(resolve => { finish = resolve }) ) const first = setup(generate, undefined, 'form:in-flight').flow await first.loadPreview() first.acknowledged.value = true const request = first.submit() expect(sessionStorage.getItem(key)).not.toBeNull() wrapper?.unmount() const restored = setup(generate, undefined, 'form:in-flight').flow await restored.loadPreview() restored.acknowledged.value = true await restored.submit() expect(generate).toHaveBeenCalledTimes(1) finish({ accepted: true }) await request expect(sessionStorage.getItem(key)).toBeNull() }) it('关闭再打开相同参数后,旧预览响应不得回填', async () => { let resolve!: (value: ReturnType) => void const { flow, open } = setup( undefined, vi.fn<() => Promise>>( () => new Promise(done => { resolve = done }) ) ) const request = flow.loadPreview() open.value = false open.value = true resolve(imagePreviewFixture()) await request expect(flow.preview.value).toBeNull() expect(flow.loading.value).toBe(false) }) it('提交期间重复点击不会重复创建任务,参数变化后不关闭新表单', async () => { let resolve!: (value: ImageGenerationSubmission) => void const generate = vi.fn<() => Promise>( () => new Promise(done => { resolve = done }) ) const { flow, prompt, open } = setup(generate) await flow.loadPreview() flow.acknowledged.value = true const request = flow.submit() await flow.submit() expect(generate).toHaveBeenCalledOnce() prompt.value = '另一个目标的草稿' resolve({ accepted: true }) await request expect(open.value).toBe(true) }) it('缺失预览版本不能被确认成有效输入', async () => { const { flow } = setup( undefined, vi.fn<() => Promise>>(async () => ({ ...imagePreviewFixture(), previewFingerprint: '' })) ) await flow.loadPreview() await flushPromises() expect(flow.preview.value).toBeNull() expect(flow.error.value).toContain('不完整') }) })