@skopon-cool/form-sdk 0.3.2 → 0.4.0

package/src/runtime/formRuntimeWs.ts

@@ -1,16 +1,11 @@
-import type {
-  FormAutoControlEventData,
-  FormRuntimeEnvelope,
-  FormRuntimeOutboundType,
-} from './types'
+import {
+  acquireFormRuntimeConnection,
+  type FormAutoControlHandler,
+  type FormRuntimeConnection,
+} from './formRuntimeConnection'
+import type { FormRuntimeOutboundType } from './types'
 
-const SEND_QUEUE_MAX = 100
-const RECONNECT_MAX_MS = 30_000
-
-export type FormAutoControlHandler = (
-  data: FormAutoControlEventData,
-  envelope: FormRuntimeEnvelope<FormAutoControlEventData>,
-) => void
+export type { FormAutoControlHandler } from './formRuntimeConnection'
 
 export interface FormRuntimeWsClientOptions {
   url: string
@@ -18,47 +13,27 @@ export interface FormRuntimeWsClientOptions {
   onAutoControl?: FormAutoControlHandler
 }
 
+/**
+ * Per-card runtime 会话：绑定 ask_user_message_id，代理到按 URL 的全局单例连接。
+ */
 export class FormRuntimeWsClient {
-  private readonly url: string
   private readonly askUserMessageId: string
-  private readonly onAutoControl?: FormAutoControlHandler
-  private ws: WebSocket | null = null
+  private readonly connection: FormRuntimeConnection
+  private readonly unsubscribe: () => void
   private closed = false
-  private reconnectAttempt = 0
-  private reconnectTimer: ReturnType<typeof setTimeout> | null = null
-  private sendQueue: string[] = []
 
   constructor(options: FormRuntimeWsClientOptions) {
-    this.url = options.url
-    this.askUserMessageId = options.askUserMessageId
-    this.onAutoControl = options.onAutoControl
+    this.askUserMessageId = options.askUserMessageId.trim()
+    this.connection = acquireFormRuntimeConnection(options.url)
+    const handler = options.onAutoControl
+    this.unsubscribe = handler
+      ? this.connection.subscribe(this.askUserMessageId, handler)
+      : () => {}
   }
 
   connect(): void {
-    if (this.closed || typeof WebSocket === 'undefined') return
-    this.clearReconnectTimer()
-    this.disposeSocket()
-    try {
-      const ws = new WebSocket(this.url)
-      this.ws = ws
-      ws.onopen = () => {
-        this.reconnectAttempt = 0
-        this.flushQueue()
-      }
-      ws.onmessage = (event) => {
-        this.handleMessage(event.data)
-      }
-      ws.onclose = () => {
-        if (this.ws === ws) this.ws = null
-        this.scheduleReconnect()
-      }
-      ws.onerror = () => {
-        // onclose will follow; avoid noisy logs
-      }
-    } catch (error) {
-      console.warn('[FormRuntimeWs] connect failed', error)
-      this.scheduleReconnect()
-    }
+    if (this.closed) return
+    this.connection.connect()
   }
 
   send(
@@ -66,98 +41,13 @@ export class FormRuntimeWsClient {
     data: Record<string, unknown>,
   ): void {
     if (this.closed) return
-    const payload: FormRuntimeEnvelope = {
-      type,
-      ask_user_message_id: this.askUserMessageId,
-      data,
-    }
-    let serialized: string
-    try {
-      serialized = JSON.stringify(payload)
-    } catch (error) {
-      console.warn('[FormRuntimeWs] serialize failed', error)
-      return
-    }
-    if (this.ws?.readyState === WebSocket.OPEN) {
-      this.ws.send(serialized)
-      return
-    }
-    this.enqueue(serialized)
+    this.connection.send(this.askUserMessageId, type, data)
   }
 
   close(): void {
-    this.closed = true
-    this.clearReconnectTimer()
-    this.sendQueue = []
-    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 {
-    this.sendQueue.push(serialized)
-    while (this.sendQueue.length > SEND_QUEUE_MAX) {
-      this.sendQueue.shift()
-    }
-  }
-
-  private flushQueue(): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return
-    const pending = this.sendQueue
-    this.sendQueue = []
-    for (const item of pending) {
-      this.ws.send(item)
-    }
-  }
-
-  private scheduleReconnect(): void {
     if (this.closed) return
-    this.clearReconnectTimer()
-    const delay = Math.min(
-      RECONNECT_MAX_MS,
-      1000 * 2 ** Math.min(this.reconnectAttempt, 5),
-    )
-    this.reconnectAttempt += 1
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = null
-      this.connect()
-    }, delay)
-  }
-
-  private clearReconnectTimer(): void {
-    if (this.reconnectTimer != null) {
-      clearTimeout(this.reconnectTimer)
-      this.reconnectTimer = null
-    }
-  }
-
-  private handleMessage(raw: unknown): void {
-    if (typeof raw !== 'string') return
-    let parsed: unknown
-    try {
-      parsed = JSON.parse(raw)
-    } catch {
-      return
-    }
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return
-    const envelope = parsed as FormRuntimeEnvelope<FormAutoControlEventData>
-    if (envelope.type !== 'form_auto_control_event') return
-    if (String(envelope.ask_user_message_id ?? '') !== this.askUserMessageId) return
-    const data = envelope.data
-    if (!data || typeof data !== 'object' || Array.isArray(data)) return
-    this.onAutoControl?.(data, envelope)
+    this.closed = true
+    this.unsubscribe()
+    this.connection.release()
   }
 }

package/src/runtime/types.ts

@@ -24,3 +24,15 @@ export interface FormRuntimeEnvelope<T = Record<string, unknown>> {
   ask_user_message_id: string
   data: T
 }
+
+/** form_runtime_data 的 data 载荷（Init / Refresh / Submit）。 */
+export interface FormRuntimeDataPayload {
+  form_schema: {
+    title?: string
+    description?: string
+    blocks: unknown[]
+  }
+  form_values: Record<string, unknown>
+  /** 本次被更新的字段名；Init/Submit 为空数组。 */
+  form_change: string[]
+}