@skopon-cool/form-sdk 0.2.3 → 0.2.5

package/dist/submit/buildAnswerAgentBody.d.ts

@@ -16,4 +16,8 @@ export interface BuildAnswerAgentBodyOptions {
 }
 /** 组装 answer-agent 外包消息体（与 mock AskUserAnswerMockVo 对齐）。 */
 export declare function buildAnswerAgentBody({ context, payload, form, answer, }: BuildAnswerAgentBodyOptions): Record<string, unknown>;
+/** 提交前校验 mock answer-agent 必填字段，返回错误文案或 null。 */
+export declare function validateAnswerAgentBody(body: Record<string, unknown>): string | null;
+/** 提交前校验上下文必填字段，返回错误文案或 null。 */
+export declare function validateAnswerAgentContext(context: AskUserAnswerAgentContext): string | null;
 //# sourceMappingURL=buildAnswerAgentBody.d.ts.map

package/dist/submit/buildAnswerAgentBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAmBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD"}
+{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAmBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAqBpF;AAED,iCAAiC;AACjC,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CAQf"}

package/dist/submit/buildCurlStatement.d.ts

@@ -1,12 +1,13 @@
-export declare function buildCurlStatement(payload: unknown, callbackUrl?: string | null): string;
+export declare function buildCurlStatement(payload: unknown, callbackUrl?: string | null, headers?: Record<string, string>): string;
 /** 构建合法 JSON body（card + extra 合并，便于 curl 直接执行） */
 export declare function buildAskUserCurlBodyJson(cardValues: Record<string, unknown>, extraValues: Record<string, unknown>): string;
 export interface BuildAskUserCurlStatementOptions {
     cardValues: Record<string, unknown>;
     extraValues?: Record<string, unknown>;
     callbackUrl?: string | null;
+    headers?: Record<string, string>;
 }
-export declare function buildAskUserCurlStatement({ cardValues, extraValues, callbackUrl, }: BuildAskUserCurlStatementOptions): string;
+export declare function buildAskUserCurlStatement({ cardValues, extraValues, callbackUrl, headers, }: BuildAskUserCurlStatementOptions): string;
 /** 从 ask_user payload（blocksJson）生成向 callback 提交返回字段的 curl */
-export declare function buildAskUserSubmitCurlFromPayload(payload: unknown, callbackUrl?: string | null): string;
+export declare function buildAskUserSubmitCurlFromPayload(payload: unknown, callbackUrl?: string | null, headers?: Record<string, string>): string;
 //# sourceMappingURL=buildCurlStatement.d.ts.map

package/dist/submit/buildCurlStatement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildCurlStatement.d.ts","sourceRoot":"","sources":["../../src/submit/buildCurlStatement.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQxF;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAER;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,wBAAgB,yBAAyB,CAAC,EACxC,UAAU,EACV,WAAgB,EAChB,WAAW,GACZ,EAAE,gCAAgC,GAAG,MAAM,CAQ3C;AAED,8DAA8D;AAC9D,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,MAAM,CAKR"}
+{"version":3,"file":"buildCurlStatement.d.ts","sourceRoot":"","sources":["../../src/submit/buildCurlStatement.ts"],"names":[],"mappings":"AAiBA,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CASR;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAER;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,wBAAgB,yBAAyB,CAAC,EACxC,UAAU,EACV,WAAgB,EAChB,WAAW,EACX,OAAO,GACR,EAAE,gCAAgC,GAAG,MAAM,CAS3C;AAED,8DAA8D;AAC9D,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAKR"}

package/dist/submit/submitAnswerAgent.d.ts

@@ -5,5 +5,9 @@ export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
     /** 显式覆盖 auth_user 中的 answer_agent_callback_url */
     answerAgentCallbackUrl?: string | null;
 }
+export declare function formatAnswerAgentSubmitMessage(result: SubmitFormJsonResult): {
+    type: 'success' | 'error';
+    message: string;
+};
 export declare function submitAnswerAgent(body: Record<string, unknown>, options?: SubmitAnswerAgentOptions): Promise<SubmitFormJsonResult>;
 //# sourceMappingURL=submitAnswerAgent.d.ts.map

package/dist/submit/submitAnswerAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submitAnswerAgent.d.ts","sourceRoot":"","sources":["../../src/submit/submitAnswerAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,WAAW,CAAC,EAAE,wBAAwB,CAAA;IACtC,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}
+{"version":3,"file":"submitAnswerAgent.d.ts","sourceRoot":"","sources":["../../src/submit/submitAnswerAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,WAAW,CAAC,EAAE,wBAAwB,CAAA;IACtC,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC;AAwDD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oBAAoB,GAC3B;IAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAchD;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAmB/B"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/client/authStorage.test.ts

@@ -4,9 +4,11 @@
 import { afterEach, describe, expect, it } from 'vitest'
 import {
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   DEFAULT_AUTH_STORAGE_KEY,
   resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
+  resolveSubmitAuthHeaders,
 } from './authStorage'
 
 describe('resolveSkoponAuthHeaders', () => {
@@ -62,6 +64,33 @@ describe('resolveSkoponAuthHeaders', () => {
   })
 })
 
+describe('resolveSubmitAuthHeaders', () => {
+  afterEach(() => {
+    sessionStorage.clear()
+    localStorage.clear()
+  })
+
+  it('merges session auth with explicit headers, explicit wins', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({ token: 'session-tok' }),
+    )
+    expect(
+      resolveSubmitAuthHeaders({ Authorization: 'Bearer explicit-tok' }),
+    ).toEqual({ Authorization: 'Bearer explicit-tok' })
+  })
+
+  it('falls back to session auth when explicit headers missing', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({ token: 'session-tok' }),
+    )
+    expect(resolveSubmitAuthHeaders()).toEqual({
+      Authorization: 'Bearer session-tok',
+    })
+  })
+})
+
 describe('resolveAnswerAgentCallbackUrl', () => {
   afterEach(() => {
     sessionStorage.clear()
@@ -80,8 +109,23 @@ describe('resolveAnswerAgentCallbackUrl', () => {
     expect(resolveAnswerAgentCallbackUrl()).toBe('/api/v1/mock/ask_user_answer_mock')
   })
 
-  it('returns empty string when field is missing', () => {
+  it('returns default mock url when field is missing', () => {
     sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: 'tok' }))
+    expect(resolveAnswerAgentCallbackUrl()).toBe(DEFAULT_ANSWER_AGENT_CALLBACK_URL)
+  })
+
+  it('returns empty string when session is missing', () => {
     expect(resolveAnswerAgentCallbackUrl()).toBe('')
   })
+
+  it('returns default mock url when field is empty string', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({
+        token: 'tok',
+        [DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD]: '   ',
+      }),
+    )
+    expect(resolveAnswerAgentCallbackUrl()).toBe(DEFAULT_ANSWER_AGENT_CALLBACK_URL)
+  })
 })

package/src/client/authStorage.ts

@@ -10,6 +10,8 @@ export interface SkoponAuthStorageOptions {
 export const DEFAULT_AUTH_STORAGE_KEY = 'auth_user'
 export const DEFAULT_AUTH_TOKEN_FIELD = 'token'
 export const DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD = 'answer_agent_callback_url'
+/** 与 skopon-admin 登录写入的 mock answer-agent 路径一致 */
+export const DEFAULT_ANSWER_AGENT_CALLBACK_URL = '/api/v1/mock/ask_user_answer_mock'
 
 function readStorage(
   kind: 'sessionStorage' | 'localStorage',
@@ -44,7 +46,10 @@ function readTokenFromSessionJson(
     : ''
 }
 
-/** 从宿主登录缓存读取 answer_agent_callback_url（无则返回空串）。 */
+/**
+ * 从宿主登录缓存读取 answer_agent_callback_url。
+ * 无 session / 无法读取时返回空串；session 存在但字段缺失或为空时回落到默认 mock 路径（与 skopon-admin 登录迁移一致）。
+ */
 export function resolveAnswerAgentCallbackUrl(
   options: SkoponAuthStorageOptions & {
     answerAgentCallbackUrlField?: string
@@ -65,7 +70,19 @@ export function resolveAnswerAgentCallbackUrl(
   if (!parsed) return ''
 
   const url = parsed[field]
-  return typeof url === 'string' ? url.trim() : ''
+  const trimmed = typeof url === 'string' ? url.trim() : ''
+  return trimmed || DEFAULT_ANSWER_AGENT_CALLBACK_URL
+}
+
+/** 合并 session 鉴权头与宿主显式 headers；显式 headers 优先。 */
+export function resolveSubmitAuthHeaders(
+  explicit?: Record<string, string>,
+  authStorage?: SkoponAuthStorageOptions,
+): Record<string, string> {
+  return {
+    ...resolveSkoponAuthHeaders(authStorage),
+    ...(explicit ?? {}),
+  }
 }
 
 /** 从宿主登录缓存读取 Bearer token，返回 Authorization 头（无 token 时返回空对象）。 */

package/src/components/AskUserFormCard.tsx

@@ -1,6 +1,7 @@
 import { useEffect, useMemo, useRef, useState } from 'react'
 import { Button, Spin, Tag, Tooltip } from 'antd'
 import type { FormDetailResult, FormSchema, SubmitMode } from '../types/index'
+import { resolveSubmitAuthHeaders } from '../client/authStorage'
 import { buildAskUserSurface } from '../adapter/resolveSurface'
 import {
   buildAnswerAgentBody,
@@ -15,7 +16,10 @@ import {
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
 import { submitFormJson } from '../submit/submitFormJson'
-import { submitAnswerAgent } from '../submit/submitAnswerAgent'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
@@ -43,6 +47,8 @@ export interface AskUserFormCardProps {
   callbackUrl?: string | null
   submitMode?: SubmitMode
   answerAgentContext?: AskUserAnswerAgentContext
+  /** 显式提交 headers，与 session 鉴权合并；显式优先 */
+  submitHeaders?: Record<string, string>
   /** 需 useCallback 稳定引用，避免重复拉取 */
   fetchFormDetail: (ref: { formUniqueId: string }) => Promise<FormDetailResult>
   onNotify?: (type: 'success' | 'error', message: string) => void
@@ -58,6 +64,7 @@ export default function AskUserFormCard({
   callbackUrl,
   submitMode = 'curl',
   answerAgentContext,
+  submitHeaders,
   fetchFormDetail,
   onNotify,
   resumeSearch = null,
@@ -74,6 +81,11 @@ export default function AskUserFormCard({
 
   const resolvedFormUniqueId = formUniqueId?.trim() ?? ''
 
+  const resolvedSubmitHeaders = useMemo(
+    () => resolveSubmitAuthHeaders(submitHeaders),
+    [submitHeaders],
+  )
+
   const resolvedAnswerAgentContext = useMemo(
     (): AskUserAnswerAgentContext => ({
       ...answerAgentContext,
@@ -185,6 +197,7 @@ export default function AskUserFormCard({
           payload={payload}
           callbackUrl={callbackUrl}
           answerAgentContext={resolvedAnswerAgentContext}
+          submitHeaders={submitHeaders}
           unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
           onNotify={onNotify}
         />
@@ -210,7 +223,9 @@ export default function AskUserFormCard({
           onNotifyRef.current?.('error', 'callback_url 为空，无法提交')
           return
         }
-        const result = await submitFormJson(url, answer)
+        const result = await submitFormJson(url, answer, {
+          headers: resolvedSubmitHeaders,
+        })
         if (!mountedRef.current) return
         if (result.ok) {
           onNotifyRef.current?.('success', '提交成功')
@@ -226,13 +241,12 @@ export default function AskUserFormCard({
         form: formDef ?? payloadDef,
         answer,
       })
-      const result = await submitAnswerAgent(body)
+      const result = await submitAnswerAgent(body, {
+        headers: resolvedSubmitHeaders,
+      })
       if (!mountedRef.current) return
-      if (result.ok) {
-        onNotifyRef.current?.('success', '提交成功')
-      } else {
-        onNotifyRef.current?.('error', formatSubmitErrorMessage(result.status, result.body))
-      }
+      const notify = formatAnswerAgentSubmitMessage(result)
+      onNotifyRef.current?.(notify.type, notify.message)
     } catch (error) {
       if (!mountedRef.current) return
       const detail = error instanceof Error ? error.message : '提交失败'

package/src/components/CurlSubmitBlock.tsx

@@ -1,5 +1,6 @@
-import { useMemo, useState } from 'react'
+import { useEffect, useMemo, useRef, useState } from 'react'
 import { Button, Tag, Tooltip, Typography } from 'antd'
+import { resolveSubmitAuthHeaders } from '../client/authStorage'
 import { buildCurlStatement } from '../submit/buildCurlStatement'
 import {
   buildAnswerAgentBody,
@@ -9,7 +10,10 @@ import {
   extractExtraBlockValues,
   parsePayloadBlocksJson,
 } from '../submit/intersectPayloadBlocksWithForm'
-import { submitAnswerAgent } from '../submit/submitAnswerAgent'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 
 export type CurlSubmitBlockCopyMode = 'display' | 'submitFields'
 
@@ -22,22 +26,11 @@ export interface CurlSubmitBlockProps {
   /** display：复制与显示一致；submitFields：复制向 callback 提交返回字段的 curl */
   copyMode?: CurlSubmitBlockCopyMode
   answerAgentContext?: AskUserAnswerAgentContext
+  /** 显式提交 headers，与 session 鉴权合并；显式优先 */
+  submitHeaders?: Record<string, string>
   onNotify?: (type: 'success' | 'error', message: string) => void
 }
 
-function formatSubmitErrorMessage(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 resolveAnswerFromPayload(payload: unknown): Record<string, unknown> {
   const def = parsePayloadBlocksJson(payload)
   if (def) return extractExtraBlockValues(def.blocks)
@@ -54,13 +47,27 @@ export default function CurlSubmitBlock({
   unpublishedFormId,
   incompleteFormId,
   answerAgentContext,
+  submitHeaders,
   onNotify,
 }: CurlSubmitBlockProps) {
   const [submitting, setSubmitting] = useState(false)
+  const mountedRef = useRef(true)
+
+  useEffect(() => {
+    mountedRef.current = true
+    return () => {
+      mountedRef.current = false
+    }
+  }, [])
+
+  const resolvedSubmitHeaders = useMemo(
+    () => resolveSubmitAuthHeaders(submitHeaders),
+    [submitHeaders],
+  )
 
   const displayCurl = useMemo(
-    () => buildCurlStatement(payload, callbackUrl),
-    [payload, callbackUrl],
+    () => buildCurlStatement(payload, callbackUrl, resolvedSubmitHeaders),
+    [payload, callbackUrl, resolvedSubmitHeaders],
   )
 
   const resolvedContext = useMemo(
@@ -81,17 +88,18 @@ export default function CurlSubmitBlock({
         payload,
         answer,
       })
-      const result = await submitAnswerAgent(body)
-      if (result.ok) {
-        onNotify?.('success', '提交成功')
-      } else {
-        onNotify?.('error', formatSubmitErrorMessage(result.status, result.body))
-      }
+      const result = await submitAnswerAgent(body, {
+        headers: resolvedSubmitHeaders,
+      })
+      if (!mountedRef.current) return
+      const notify = formatAnswerAgentSubmitMessage(result)
+      onNotify?.(notify.type, notify.message)
     } catch (error) {
+      if (!mountedRef.current) return
       const detail = error instanceof Error ? error.message : '提交失败'
       onNotify?.('error', detail)
     } finally {
-      setSubmitting(false)
+      if (mountedRef.current) setSubmitting(false)
     }
   }
 

package/src/index.ts

@@ -67,20 +67,25 @@ export {
 export { createFormClient, type FormClient, type FormClientOptions } from './client/formClient'
 export {
   buildAnswerAgentBody,
+  validateAnswerAgentBody,
+  validateAnswerAgentContext,
   type AskUserAnswerAgentContext,
   type BuildAnswerAgentBodyOptions,
 } from './submit/buildAnswerAgentBody'
 export {
   submitAnswerAgent,
+  formatAnswerAgentSubmitMessage,
   type SubmitAnswerAgentOptions,
 } from './submit/submitAnswerAgent'
 export {
   resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
+  resolveSubmitAuthHeaders,
   resolveClientHeaders,
   DEFAULT_AUTH_STORAGE_KEY,
   DEFAULT_AUTH_TOKEN_FIELD,
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   type SkoponAuthStorageOptions,
   type ClientHeadersOptions,
 } from './client/authStorage'

package/src/submit/buildAnswerAgentBody.ts

@@ -59,3 +59,40 @@ export function buildAnswerAgentBody({
     answer,
   }
 }
+
+/** 提交前校验 mock answer-agent 必填字段，返回错误文案或 null。 */
+export function validateAnswerAgentBody(body: Record<string, unknown>): string | null {
+  const callbackUrl = body.callback_url
+  if (typeof callbackUrl !== 'string' || !callbackUrl.trim()) {
+    return 'callback_url 为空，无法提交'
+  }
+  if (body.tenant_id == null) {
+    return 'tenant_id 缺失，无法提交'
+  }
+  const tenantUserId = body.tenant_user_id
+  if (typeof tenantUserId !== 'string' || !tenantUserId.trim()) {
+    return 'tenant_user_id 缺失，无法提交'
+  }
+  const requestId = body.request_id
+  if (typeof requestId !== 'string' || !requestId.trim()) {
+    return 'request_id 缺失，无法提交'
+  }
+  const missionId = body.mission_id
+  if (missionId == null || missionId === '') {
+    return 'mission_id 缺失，无法提交'
+  }
+  return null
+}
+
+/** 提交前校验上下文必填字段，返回错误文案或 null。 */
+export function validateAnswerAgentContext(
+  context: AskUserAnswerAgentContext,
+): string | null {
+  return validateAnswerAgentBody(
+    buildAnswerAgentBody({
+      context,
+      payload: {},
+      answer: {},
+    }),
+  )
+}

package/src/submit/buildCurlStatement.ts

@@ -7,12 +7,25 @@ function escapeSingleQuotes(text: string): string {
   return text.replace(/'/g, `'\\''`)
 }
 
-export function buildCurlStatement(payload: unknown, callbackUrl?: string | null): string {
+function resolveAuthorizationCurlHeader(headers?: Record<string, string>): string {
+  const authorization = headers?.Authorization?.trim()
+  if (authorization) {
+    return `  -H 'Authorization: ${escapeSingleQuotes(authorization)}' \\`
+  }
+  return `  -H 'Authorization: Bearer <token>' \\`
+}
+
+export function buildCurlStatement(
+  payload: unknown,
+  callbackUrl?: string | null,
+  headers?: Record<string, string>,
+): string {
   const url = (callbackUrl ?? '').trim() || '<callback_url>'
   const body = JSON.stringify(payload ?? {}, null, 2)
   return [
     `curl -X POST '${url}' \\`,
     `  -H 'Content-Type: application/json' \\`,
+    resolveAuthorizationCurlHeader(headers),
     `  -d '${escapeSingleQuotes(body)}'`,
   ].join('\n')
 }
@@ -29,18 +42,21 @@ export interface BuildAskUserCurlStatementOptions {
   cardValues: Record<string, unknown>
   extraValues?: Record<string, unknown>
   callbackUrl?: string | null
+  headers?: Record<string, string>
 }
 
 export function buildAskUserCurlStatement({
   cardValues,
   extraValues = {},
   callbackUrl,
+  headers,
 }: BuildAskUserCurlStatementOptions): string {
   const url = (callbackUrl ?? '').trim() || '<callback_url>'
   const body = buildAskUserCurlBodyJson(cardValues, extraValues)
   return [
     `curl -X POST '${url}' \\`,
     `  -H 'Content-Type: application/json' \\`,
+    resolveAuthorizationCurlHeader(headers),
     `  -d '${escapeSingleQuotes(body)}'`,
   ].join('\n')
 }
@@ -49,9 +65,10 @@ export function buildAskUserCurlStatement({
 export function buildAskUserSubmitCurlFromPayload(
   payload: unknown,
   callbackUrl?: string | null,
+  headers?: Record<string, string>,
 ): string {
   const def = parsePayloadBlocksJson(payload)
-  if (!def) return buildCurlStatement(payload, callbackUrl)
+  if (!def) return buildCurlStatement(payload, callbackUrl, headers)
   const cardValues = extractExtraBlockValues(def.blocks)
-  return buildAskUserCurlStatement({ cardValues, callbackUrl })
+  return buildAskUserCurlStatement({ cardValues, callbackUrl, headers })
 }