@skopon-cool/form-sdk 0.1.0 → 0.1.3

package/src/submit/submit.test.ts

@@ -1,6 +1,20 @@
+/**
+ * @vitest-environment node
+ */
 import { describe, it, expect, vi } from 'vitest'
-import { buildCurlStatement } from '../submit/buildCurlStatement'
-import { intersectPayloadWithForm } from '../submit/intersectPayloadWithForm'
+import {
+  buildAskUserCurlBodyJson,
+  buildAskUserCurlStatement,
+  buildCurlStatement,
+} from '../submit/buildCurlStatement'
+import {
+  extractExtraBlockValues,
+  getPayloadInputFieldNames,
+  getPayloadRenderableBlocks,
+  intersectPayloadBlocksWithForm,
+  parsePayloadBlocksJson,
+  payloadHasInputBlocks,
+} from '../submit/intersectPayloadBlocksWithForm'
 import { submitFormJson } from '../submit/submitFormJson'
 import type { FormSchema } from '../types/index'
 
@@ -16,9 +30,44 @@ describe('buildCurlStatement', () => {
   })
 })
 
-describe('intersectPayloadWithForm', () => {
+describe('buildAskUserCurlStatement', () => {
+  it('includes extra fields with comment after card values', () => {
+    const body = buildAskUserCurlBodyJson(
+      { video_title: 'hello' },
+      { agent_hint: '请尽快确认' },
+    )
+    expect(body).toContain('"video_title": "hello"')
+    expect(body).toContain('// 额外字段（未在卡片展示）')
+    expect(body).toContain('"agent_hint": "请尽快确认"')
+
+    const curl = buildAskUserCurlStatement({
+      cardValues: { video_title: 'hello' },
+      extraValues: { agent_hint: '请尽快确认' },
+      callbackUrl: 'https://example.com/hook',
+    })
+    expect(curl).toContain('// 额外字段（未在卡片展示）')
+  })
+})
+
+describe('parsePayloadBlocksJson', () => {
+  it('parses blocksJson payload', () => {
+    const parsed = parsePayloadBlocksJson({
+      title: 't',
+      blocks: [{ id: '1', type: 'text', name: 'video_title', label: 'Title' }],
+    })
+    expect(parsed?.blocks).toHaveLength(1)
+    expect(parsed?.blocks[0]?.name).toBe('video_title')
+  })
+
+  it('returns null for non-blocksJson', () => {
+    expect(parsePayloadBlocksJson({ video_title: { type: 'text' } })).toBeNull()
+    expect(parsePayloadBlocksJson(null)).toBeNull()
+  })
+})
+
+describe('intersectPayloadBlocksWithForm', () => {
   const formDef: FormSchema = {
-    title: 't',
+    title: 'Form',
     description: '',
     blocks: [
       { id: '1', type: 'text', name: 'video_title', label: 'Title' },
@@ -27,13 +76,124 @@ describe('intersectPayloadWithForm', () => {
     jsonSchema: {},
   }
 
-  it('matches payload keys to form blocks', () => {
-    const result = intersectPayloadWithForm(
-      { video_title: { type: 'text' }, extra: { type: 'text' } },
-      formDef,
-    )
+  const payloadDef = parsePayloadBlocksJson({
+    title: 'Ask',
+    blocks: [
+      { id: 'p1', type: 'text', name: 'video_title', label: '视频标题' },
+      { id: 'p2', type: 'text', name: 'agent_hint', label: '提示', defaultValue: 'hint' },
+    ],
+  })!
+
+  it('matches payload blocks to form by name', () => {
+    const result = intersectPayloadBlocksWithForm(payloadDef, formDef)
+    expect(result.matchedBlocks.map((b) => b.name)).toEqual(['video_title'])
+    expect(result.extraBlocks.map((b) => b.name)).toEqual(['agent_hint'])
+    expect(result.title).toBe('Ask')
+  })
+
+  it('extracts extra block default values', () => {
+    const result = intersectPayloadBlocksWithForm(payloadDef, formDef)
+    expect(extractExtraBlockValues(result.extraBlocks)).toEqual({ agent_hint: 'hint' })
+  })
+
+  it('keeps form block type and schema when payload type differs', () => {
+    const selectForm: FormSchema = {
+      title: 'Form',
+      description: '',
+      blocks: [
+        {
+          id: '1',
+          type: 'select',
+          name: 'choice',
+          label: 'Form Label',
+          options: [
+            { label: 'A', value: 'a' },
+            { label: 'B', value: 'b' },
+          ],
+        },
+      ],
+      jsonSchema: {},
+    }
+    const mismatchedPayload = parsePayloadBlocksJson({
+      title: 'Ask',
+      blocks: [
+        {
+          id: 'p1',
+          type: 'text',
+          name: 'choice',
+          label: 'Payload Label',
+          defaultValue: 'a',
+        },
+      ],
+    })!
+    const result = intersectPayloadBlocksWithForm(mismatchedPayload, selectForm)
+    expect(result.matchedBlocks).toHaveLength(1)
+    expect(result.matchedBlocks[0]?.type).toBe('select')
+    expect(result.matchedBlocks[0]?.label).toBe('Form Label')
+    expect(result.matchedBlocks[0]?.options).toEqual([
+      { label: 'A', value: 'a' },
+      { label: 'B', value: 'b' },
+    ])
+    expect(result.matchedBlocks[0]?.defaultValue).toBe('a')
+  })
+
+  it('preserves payload layout blocks in renderBlocks on partial intersection', () => {
+    const partialPayload = parsePayloadBlocksJson({
+      title: 'Ask',
+      blocks: [
+        { id: 'h1', type: 'heading', label: '请填写以下信息' },
+        { id: 'p1', type: 'text', name: 'video_title', label: '视频标题' },
+        { id: 'p2', type: 'text', name: 'agent_hint', label: '提示', defaultValue: 'hint' },
+        { id: 'para1', type: 'paragraph', label: '提交后不可修改' },
+      ],
+    })!
+    const result = intersectPayloadBlocksWithForm(partialPayload, formDef)
     expect(result.matchedBlocks.map((b) => b.name)).toEqual(['video_title'])
-    expect(Object.keys(result.remainderPayload)).toEqual(['extra'])
+    expect(result.extraBlocks.map((b) => b.name)).toEqual(['agent_hint'])
+    expect(result.renderBlocks.map((b) => b.type)).toEqual([
+      'heading',
+      'text',
+      'paragraph',
+    ])
+    expect(result.renderBlocks.map((b) => b.label)).toEqual([
+      '请填写以下信息',
+      'Title',
+      '提交后不可修改',
+    ])
+    expect(result.renderBlocks.some((b) => b.type === 'heading' && b.label === '请填写以下信息')).toBe(
+      true,
+    )
+    expect(result.extraBlocks.some((b) => b.type === 'heading')).toBe(false)
+  })
+})
+
+describe('payload fallback helpers', () => {
+  const surveyPayload = parsePayloadBlocksJson({
+    title: '',
+    blocks: [
+      { id: 'title', type: 'heading', label: '问卷调查' },
+      { id: 'q1', type: 'radio', name: 'occupation', label: '职业', options: [] },
+    ],
+  })!
+
+  it('detects input blocks for fallback', () => {
+    expect(payloadHasInputBlocks(surveyPayload)).toBe(true)
+  })
+
+  it('returns layout and input blocks for render', () => {
+    const blocks = getPayloadRenderableBlocks(surveyPayload)
+    expect(blocks.map((b) => b.id)).toEqual(['title', 'q1'])
+  })
+
+  it('returns input field names for submit', () => {
+    expect(getPayloadInputFieldNames(surveyPayload)).toEqual(['occupation'])
+  })
+
+  it('intersection empty when formDef missing but payload still renderable', () => {
+    const result = intersectPayloadBlocksWithForm(surveyPayload, undefined)
+    expect(result.matchedBlocks).toHaveLength(0)
+    expect(payloadHasInputBlocks(surveyPayload)).toBe(true)
+    expect(getPayloadRenderableBlocks(surveyPayload).length).toBeGreaterThan(0)
   })
 })
 

package/src/submit/submitFormJson.ts

@@ -46,5 +46,24 @@ export async function submitFormJson(
 }
 
 export async function copyTextToClipboard(text: string): Promise<void> {
-  await navigator.clipboard.writeText(text)
+  if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+    await navigator.clipboard.writeText(text)
+    return
+  }
+  if (typeof document === 'undefined') {
+    throw new Error('clipboard unavailable')
+  }
+  const textarea = document.createElement('textarea')
+  textarea.value = text
+  textarea.setAttribute('readonly', '')
+  textarea.style.position = 'fixed'
+  textarea.style.left = '-9999px'
+  document.body.appendChild(textarea)
+  textarea.select()
+  try {
+    const ok = document.execCommand('copy')
+    if (!ok) throw new Error('execCommand copy failed')
+  } finally {
+    document.body.removeChild(textarea)
+  }
 }

package/dist/submit/intersectPayloadWithForm.d.ts

@@ -1,17 +0,0 @@
-import type { FormBlock, FormSchema } from '../types/index';
-/** payload 单个字段的元数据约定（见 docs/ask/ payload.json） */
-export interface AskUserPayloadField {
-    用途描述?: string;
-    字段类型?: string;
-    字段格式?: string;
-    字段枚举?: string;
-    [key: string]: unknown;
-}
-export type AskUserPayload = Record<string, AskUserPayloadField | unknown>;
-export interface PayloadFormIntersection {
-    matchedBlocks: FormBlock[];
-    remainderPayload: AskUserPayload;
-}
-export declare function getPayloadKeys(payload: unknown): string[];
-export declare function intersectPayloadWithForm(payload: unknown, formDefinition: FormSchema | undefined): PayloadFormIntersection;
-//# sourceMappingURL=intersectPayloadWithForm.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"intersectPayloadWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadWithForm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAA;AAE1E,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,gBAAgB,EAAE,cAAc,CAAA;CACjC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAGzD;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,uBAAuB,CA0BzB"}

package/src/submit/intersectPayloadWithForm.ts

@@ -1,54 +0,0 @@
-import type { FormBlock, FormSchema } from '../types/index'
-import { isInputBlockType } from '../types/index'
-
-/** payload 单个字段的元数据约定（见 docs/ask/ payload.json） */
-export interface AskUserPayloadField {
-  用途描述?: string
-  字段类型?: string
-  字段格式?: string
-  字段枚举?: string
-  [key: string]: unknown
-}
-
-export type AskUserPayload = Record<string, AskUserPayloadField | unknown>
-
-export interface PayloadFormIntersection {
-  matchedBlocks: FormBlock[]
-  remainderPayload: AskUserPayload
-}
-
-export function getPayloadKeys(payload: unknown): string[] {
-  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return []
-  return Object.keys(payload as Record<string, unknown>)
-}
-
-export function intersectPayloadWithForm(
-  payload: unknown,
-  formDefinition: FormSchema | undefined,
-): PayloadFormIntersection {
-  const keys = getPayloadKeys(payload)
-  const source = (payload ?? {}) as Record<string, unknown>
-
-  const blocks = formDefinition?.blocks ?? []
-  const inputBlockNames = new Set(
-    blocks
-      .filter((block) => isInputBlockType(block.type) && block.name?.trim())
-      .map((block) => block.name!.trim()),
-  )
-
-  const matchedBlocks = blocks.filter(
-    (block) =>
-      isInputBlockType(block.type) &&
-      block.name?.trim() &&
-      keys.includes(block.name.trim()),
-  )
-
-  const remainderPayload: AskUserPayload = {}
-  for (const key of keys) {
-    if (!inputBlockNames.has(key)) {
-      remainderPayload[key] = source[key]
-    }
-  }
-
-  return { matchedBlocks, remainderPayload }
-}