@skopon-cool/form-sdk 0.3.1 → 0.3.2

package/dist/runtime/formRuntimeWs.d.ts

@@ -18,6 +18,8 @@ export declare class FormRuntimeWsClient {
     connect(): void;
     send(type: FormRuntimeOutboundType, data: Record<string, unknown>): void;
     close(): void;
+    /** 关闭当前 socket 且不触发重连（清掉 onclose），建新连或主动 close 时用。 */
+    private disposeSocket;
     private enqueue;
     private flushQueue;
     private scheduleReconnect;

package/dist/runtime/formRuntimeWs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formRuntimeWs.d.ts","sourceRoot":"","sources":["../../src/runtime/formRuntimeWs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAKhB,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,wBAAwB,EAC9B,QAAQ,EAAE,mBAAmB,CAAC,wBAAwB,CAAC,KACpD,IAAI,CAAA;AAET,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAwB;IACvD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,SAAS,CAAe;gBAEpB,OAAO,EAAE,0BAA0B;IAM/C,OAAO,IAAI,IAAI;IA0Bf,IAAI,CACF,IAAI,EAAE,uBAAuB,EAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI;IAqBP,KAAK,IAAI,IAAI;IAkBb,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,aAAa;CAgBtB"}
+{"version":3,"file":"formRuntimeWs.d.ts","sourceRoot":"","sources":["../../src/runtime/formRuntimeWs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAKhB,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,wBAAwB,EAC9B,QAAQ,EAAE,mBAAmB,CAAC,wBAAwB,CAAC,KACpD,IAAI,CAAA;AAET,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAwB;IACvD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,SAAS,CAAe;gBAEpB,OAAO,EAAE,0BAA0B;IAM/C,OAAO,IAAI,IAAI;IA2Bf,IAAI,CACF,IAAI,EAAE,uBAAuB,EAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI;IAqBP,KAAK,IAAI,IAAI;IAOb,sDAAsD;IACtD,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,aAAa;CAgBtB"}

package/package.json

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

package/src/catalog/useSkoponBoundField.ts

@@ -59,8 +59,16 @@ export function useSkoponBoundField(
   } = options
 
   const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null)
+  const pendingDebouncedValueRef = useRef<unknown>(undefined)
+  const hasPendingDebouncedRef = useRef(false)
   const runtimeRef = useRef(runtime)
   runtimeRef.current = runtime
+  const changeActionRef = useRef(changeAction)
+  changeActionRef.current = changeAction
+  const componentRef = useRef(component)
+  componentRef.current = component
+  const fieldNameRef = useRef(fieldName)
+  fieldNameRef.current = fieldName
 
   useEffect(() => {
     return () => {
@@ -68,6 +76,16 @@ export function useSkoponBoundField(
         clearTimeout(debounceTimerRef.current)
         debounceTimerRef.current = null
       }
+      // unmount 时 flush 未发出的最后一次 change，避免丢事件
+      if (hasPendingDebouncedRef.current && fieldNameRef.current) {
+        hasPendingDebouncedRef.current = false
+        runtimeRef.current.reportEvent({
+          action: changeActionRef.current,
+          component: componentRef.current,
+          field: fieldNameRef.current,
+          value: pendingDebouncedValueRef.current,
+        })
+      }
     }
   }, [])
 
@@ -91,6 +109,7 @@ export function useSkoponBoundField(
     (next: unknown) => {
       if (!fieldName) return
       const emit = () => {
+        hasPendingDebouncedRef.current = false
         runtimeRef.current.reportEvent({
           action: changeAction,
           component,
@@ -102,6 +121,8 @@ export function useSkoponBoundField(
         emit()
         return
       }
+      pendingDebouncedValueRef.current = next
+      hasPendingDebouncedRef.current = true
       if (debounceTimerRef.current != null) {
         clearTimeout(debounceTimerRef.current)
       }

package/src/components/AskUserFormCard.tsx

@@ -8,6 +8,7 @@ import {
 import { buildAskUserSurface } from '../adapter/resolveSurface'
 import {
   buildAnswerAgentBody,
+  validateAnswerAgentBody,
   type AskUserAnswerAgentContext,
 } from '../submit/buildAnswerAgentBody'
 import {
@@ -222,18 +223,18 @@ function AskUserFormCardBody({
       }
       const answer = { ...cardValues, ...extraValues }
 
-      runtime.reportData(answer)
-      runtime.reportEvent({
-        action: 'submit',
-        component: 'SubmitButton',
-      })
-
       if (submitMode === 'post') {
         const url = (callbackUrl ?? '').trim()
         if (!url) {
           onNotifyRef.current?.('error', 'callback_url 为空，无法提交')
           return
         }
+        // 确认可 POST 后再上报，避免空 callback 仍发 data/submit
+        runtime.reportData(answer)
+        runtime.reportEvent({
+          action: 'submit',
+          component: 'SubmitButton',
+        })
         const result = await submitFormJson(url, answer, {
           headers: resolvedSubmitHeaders,
         })
@@ -252,6 +253,16 @@ function AskUserFormCardBody({
         form: formDef ?? payloadDef,
         answer,
       })
+      const agentError = validateAnswerAgentBody(body)
+      if (agentError) {
+        onNotifyRef.current?.('error', agentError)
+        return
+      }
+      runtime.reportData(answer)
+      runtime.reportEvent({
+        action: 'submit',
+        component: 'SubmitButton',
+      })
       const result = await submitAnswerAgent(body, {
         headers: resolvedSubmitHeaders,
       })
@@ -383,7 +394,6 @@ export default function AskUserFormCard(props: AskUserFormCardProps) {
   const resolvedAskUserMessageId = props.askUserMessageId?.trim() ?? ''
   const realtimeWsUrl = useMemo(() => resolveRealtimeWsUrl(), [])
   const [surfaceReady, setSurfaceReady] = useState(false)
-  const [wsClient, setWsClient] = useState<FormRuntimeWsClient | null>(null)
   const autoControlHandlerRef = useRef<((data: FormAutoControlEventData) => void) | null>(null)
 
   const onSurfaceReadyChange = useCallback((ready: boolean) => {
@@ -397,29 +407,30 @@ export default function AskUserFormCard(props: AskUserFormCardProps) {
     [],
   )
 
-  const shouldConnect = Boolean(
-    realtimeWsUrl && resolvedAskUserMessageId && surfaceReady,
-  )
-
-  useEffect(() => {
-    if (!shouldConnect || !realtimeWsUrl || !resolvedAskUserMessageId) {
-      setWsClient(null)
-      return
-    }
-    const client = new FormRuntimeWsClient({
+  // 有 URL + id 即创建 client 并挂到 Provider：表单刚可交互时 send 可入队，
+  // 不必等 setState(surfaceReady) / connect 完成。
+  const wsClient = useMemo(() => {
+    if (!realtimeWsUrl || !resolvedAskUserMessageId) return null
+    return new FormRuntimeWsClient({
       url: realtimeWsUrl,
       askUserMessageId: resolvedAskUserMessageId,
       onAutoControl: (data) => {
         autoControlHandlerRef.current?.(data)
       },
     })
-    client.connect()
-    setWsClient(client)
+  }, [realtimeWsUrl, resolvedAskUserMessageId])
+
+  useEffect(() => {
+    if (!wsClient) return
     return () => {
-      client.close()
-      setWsClient(null)
+      wsClient.close()
     }
-  }, [shouldConnect, realtimeWsUrl, resolvedAskUserMessageId])
+  }, [wsClient])
+
+  useEffect(() => {
+    if (!wsClient || !surfaceReady) return
+    wsClient.connect()
+  }, [wsClient, surfaceReady])
 
   return (
     <SkoponFormProvider>

package/src/runtime/formRuntimeWs.ts

@@ -37,6 +37,7 @@ export class FormRuntimeWsClient {
   connect(): void {
     if (this.closed || typeof WebSocket === 'undefined') return
     this.clearReconnectTimer()
+    this.disposeSocket()
     try {
       const ws = new WebSocket(this.url)
       this.ws = ws
@@ -48,7 +49,7 @@ export class FormRuntimeWsClient {
         this.handleMessage(event.data)
       }
       ws.onclose = () => {
-        this.ws = null
+        if (this.ws === ws) this.ws = null
         this.scheduleReconnect()
       }
       ws.onerror = () => {
@@ -88,18 +89,22 @@ export class FormRuntimeWsClient {
     this.closed = true
     this.clearReconnectTimer()
     this.sendQueue = []
-    if (this.ws) {
-      this.ws.onopen = null
-      this.ws.onmessage = null
-      this.ws.onclose = null
-      this.ws.onerror = null
-      try {
-        this.ws.close()
-      } catch {
-        // ignore
-      }
-      this.ws = null
+    this.disposeSocket()
+  }
+
+  /** 关闭当前 socket 且不触发重连（清掉 onclose），建新连或主动 close 时用。 */
+  private disposeSocket(): void {
+    if (!this.ws) return
+    this.ws.onopen = null
+    this.ws.onmessage = null
+    this.ws.onclose = null
+    this.ws.onerror = null
+    try {
+      this.ws.close()
+    } catch {
+      // ignore
     }
+    this.ws = null
   }
 
   private enqueue(serialized: string): void {