@skopon-cool/form-sdk 0.2.2 → 0.2.4

package/src/submit/submit.test.ts

@@ -8,6 +8,7 @@ import {
   buildAskUserSubmitCurlFromPayload,
   buildCurlStatement,
 } from '../submit/buildCurlStatement'
+import { buildAnswerAgentBody, validateAnswerAgentBody } from '../submit/buildAnswerAgentBody'
 import {
   extractExtraBlockValues,
   getPayloadInputFieldNames,
@@ -16,6 +17,10 @@ import {
   parsePayloadBlocksJson,
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 import { submitFormJson } from '../submit/submitFormJson'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { FormSchema } from '../types/index'
@@ -261,6 +266,151 @@ describe('payload fallback helpers', () => {
   })
 })
 
+describe('buildAnswerAgentBody', () => {
+  it('maps context and payload into answer-agent body', () => {
+    const payload = {
+      title: '需求描述',
+      blocks: [
+        { id: 'b1', type: 'textarea', name: 'field_b6ba0dbb', label: '需求描述' },
+      ],
+    }
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 12,
+        tenantId: 1001,
+        tenantUserId: 'user-1',
+        requestId: 'req-1',
+        askUserQueryDescription: '请确认',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload,
+      answer: { field_b6ba0dbb: 'hello' },
+    })
+    expect(body.mission_id).toBe(12)
+    expect(body.tenant_id).toBe(1001)
+    expect(body.tenant_user_id).toBe('user-1')
+    expect(body.request_id).toBe('req-1')
+    expect(body.ask_user_query_description).toBe('请确认')
+    expect(body.callback_url).toBe('https://example.com/cb')
+    expect(body.answer).toEqual({ field_b6ba0dbb: 'hello' })
+    expect(body.question).toMatchObject({ title: '需求描述' })
+    expect(body.form).toMatchObject({ title: '需求描述' })
+    expect((body.question as { blocks: Array<{ name: string }> }).blocks[0]?.name).toBe(
+      'field_b6ba0dbb',
+    )
+  })
+})
+
+describe('validateAnswerAgentBody', () => {
+  it('rejects missing request_id', () => {
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 1,
+        tenantId: 1001,
+        tenantUserId: 'u1',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload: {},
+      answer: {},
+    })
+    expect(validateAnswerAgentBody(body)).toBe('request_id 缺失，无法提交')
+  })
+
+  it('accepts mission_id 0', () => {
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 0,
+        tenantId: 1001,
+        tenantUserId: 'u1',
+        requestId: 'req-1',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload: {},
+      answer: {},
+    })
+    expect(validateAnswerAgentBody(body)).toBeNull()
+  })
+})
+
+describe('submitAnswerAgent', () => {
+  it('POSTs to explicit answer agent callback url with auth headers', async () => {
+    const fetchMock = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      headers: { get: () => 'application/json' },
+      json: async () => ({
+        success: true,
+        data: { callback_ok: true },
+      }),
+    })) as unknown as typeof fetch
+
+    const result = await submitAnswerAgent(
+      {
+        mission_id: 1,
+        tenant_id: 1001,
+        tenant_user_id: 'u1',
+        request_id: 'req-1',
+        callback_url: 'https://example.com/cb',
+        answer: { a: 1 },
+      },
+      {
+        answerAgentCallbackUrl: '/api/v1/mock/ask_user_answer_mock',
+        headers: { Authorization: 'Bearer tok' },
+        fetch: fetchMock,
+      },
+    )
+    expect(result.ok).toBe(true)
+    expect(fetchMock).toHaveBeenCalledWith(
+      '/api/v1/mock/ask_user_answer_mock',
+      expect.objectContaining({
+        method: 'POST',
+        headers: expect.objectContaining({
+          Authorization: 'Bearer tok',
+          'Content-Type': 'application/json',
+        }),
+      }),
+    )
+  })
+
+  it('marks result not ok when callback_ok is false', async () => {
+    const fetchMock = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      headers: { get: () => 'application/json' },
+      json: async () => ({
+        success: true,
+        data: { callback_ok: false, error: 'connection refused' },
+      }),
+    })) as unknown as typeof fetch
+
+    const result = await submitAnswerAgent(
+      {
+        mission_id: 1,
+        tenant_id: 1001,
+        tenant_user_id: 'u1',
+        request_id: 'req-1',
+        callback_url: 'https://example.com/cb',
+        answer: {},
+      },
+      {
+        answerAgentCallbackUrl: '/api/v1/mock/ask_user_answer_mock',
+        fetch: fetchMock,
+      },
+    )
+    expect(result.ok).toBe(false)
+    expect(formatAnswerAgentSubmitMessage(result)).toEqual({
+      type: 'error',
+      message: '提交失败：connection refused',
+    })
+  })
+
+  it('throws when required body fields are missing', async () => {
+    await expect(submitAnswerAgent({ answer: {} })).rejects.toThrow(
+      'callback_url 为空，无法提交',
+    )
+  })
+})
+
 describe('submitFormJson', () => {
   it('POSTs JSON payload', async () => {
     const fetchMock = vi.fn(async () => ({

package/src/submit/submitAnswerAgent.ts

@@ -0,0 +1,104 @@
+import {
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
+  resolveAnswerAgentCallbackUrl,
+  resolveSkoponAuthHeaders,
+  type SkoponAuthStorageOptions,
+} from '../client/authStorage'
+import { validateAnswerAgentBody } from './buildAnswerAgentBody'
+import {
+  submitFormJson,
+  type SubmitFormJsonOptions,
+  type SubmitFormJsonResult,
+} from './submitFormJson'
+
+export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
+  authStorage?: SkoponAuthStorageOptions
+  /** 显式覆盖 auth_user 中的 answer_agent_callback_url */
+  answerAgentCallbackUrl?: string | null
+}
+
+interface AnswerAgentResponseData {
+  callback_ok?: boolean
+  callback_status?: number
+  error?: string | null
+}
+
+function extractAnswerAgentData(body: unknown): AnswerAgentResponseData | null {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return null
+  const envelope = body as Record<string, unknown>
+  const data = envelope.data
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return null
+  return data as AnswerAgentResponseData
+}
+
+function formatHttpErrorMessage(status: number, body: unknown): string {
+  if (body && typeof body === 'object' && body !== null && 'message' in body) {
+    const msg = (body as { message: unknown }).message
+    if (typeof msg === 'string' && msg.trim()) {
+      return `提交失败 (${status}): ${msg.trim()}`
+    }
+  }
+  if (typeof body === 'string' && body.trim()) {
+    return `提交失败 (${status}): ${body.trim()}`
+  }
+  return `提交失败 (${status})`
+}
+
+function formatCallbackFailureMessage(data: AnswerAgentResponseData): string {
+  const detail =
+    typeof data.error === 'string' && data.error.trim()
+      ? data.error.trim()
+      : `回调 HTTP ${data.callback_status ?? '失败'}`
+  return `提交失败：${detail}`
+}
+
+export function formatAnswerAgentSubmitMessage(
+  result: SubmitFormJsonResult,
+): { type: 'success' | 'error'; message: string } {
+  const data = extractAnswerAgentData(result.body)
+  if (data?.callback_ok === false) {
+    return { type: 'error', message: formatCallbackFailureMessage(data) }
+  }
+
+  if (!result.ok) {
+    return {
+      type: 'error',
+      message: formatHttpErrorMessage(result.status, result.body),
+    }
+  }
+
+  return { type: 'success', message: '提交成功' }
+}
+
+export async function submitAnswerAgent(
+  body: Record<string, unknown>,
+  options?: SubmitAnswerAgentOptions,
+): Promise<SubmitFormJsonResult> {
+  const validationError = validateAnswerAgentBody(body)
+  if (validationError) {
+    throw new Error(validationError)
+  }
+
+  const url = (
+    options?.answerAgentCallbackUrl?.trim() ||
+    resolveAnswerAgentCallbackUrl(options?.authStorage) ||
+    DEFAULT_ANSWER_AGENT_CALLBACK_URL
+  ).trim()
+
+  const storageHeaders = resolveSkoponAuthHeaders(options?.authStorage)
+
+  const result = await submitFormJson(url, body, {
+    ...options,
+    headers: {
+      ...storageHeaders,
+      ...(options?.headers ?? {}),
+    },
+  })
+
+  const data = extractAnswerAgentData(result.body)
+  if (result.ok && data?.callback_ok === false) {
+    return { ok: false, status: result.status, body: result.body }
+  }
+
+  return result
+}