@skopon-cool/form-sdk 0.2.0 → 0.2.2

package/dist/submit/validateFormSubmit.d.ts

@@ -0,0 +1,10 @@
+import type { FormBlock } from '../types/index';
+export interface FormSubmitValidationError {
+    fieldName: string;
+    label: string;
+    message: string;
+}
+export declare function matchesValidationRegexp(value: string, pattern: string): boolean;
+/** 提交前校验 renderBlocks 对应字段值；首个错误即返回。 */
+export declare function validateFormSubmitValues(blocks: FormBlock[], values: Record<string, unknown>): FormSubmitValidationError | null;
+//# sourceMappingURL=validateFormSubmit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateFormSubmit.d.ts","sourceRoot":"","sources":["../../src/submit/validateFormSubmit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAM/C,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAO/E;AA6BD,wCAAwC;AACxC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,yBAAyB,GAAG,IAAI,CA0DlC"}

package/package.json

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

package/src/adapter/a2uiAdapter.ts

@@ -8,9 +8,8 @@ import type {
   FormSchema,
 } from '../types/index'
 import { generateId } from './id'
-import { coerceToggleValue } from './formSchema'
+import { coerceToggleValue, syncFormDefinition } from './formSchema'
 import { getMediaUrls, normalizeMediaSize } from './formMedia'
-import { syncFormDefinition } from './formSchema'
 import { getBlockTypeAdapter, getComponentAdapter } from '../blocks/registry'
 
 /**
@@ -28,7 +27,7 @@ import { getBlockTypeAdapter, getComponentAdapter } from '../blocks/registry'
 const ROOT_ID = 'root'
 const TITLE_ID = '__title__'
 const DESC_ID = '__desc__'
-const EMAIL_REGEXP = '^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$'
+export const EMAIL_REGEXP = '^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$'
 
 function pathFor(name: string): string {
   return `/${name}`
@@ -491,7 +490,7 @@ function applyDataModelDefaults(
     const raw = dataModel[name]
     if (raw === undefined) return block
     if (block.type === 'toggle') {
-      return { ...block, defaultValue: raw === true || raw === 'true' }
+      return { ...block, defaultValue: coerceToggleValue(raw) }
     }
     return { ...block, defaultValue: raw as FormBlock['defaultValue'] }
   })

package/src/adapter/formSchema.test.ts

@@ -3,13 +3,18 @@
  */
 import { describe, it, expect } from 'vitest'
 import { coerceToggleValue, normalizeFormDefinition } from './formSchema'
+import { mapFormDefinitionFromDto } from './resolveSurface'
 
 describe('coerceToggleValue', () => {
-  it('accepts boolean and string true', () => {
+  it('accepts boolean, string, and numeric truthy/falsy values', () => {
     expect(coerceToggleValue(true)).toBe(true)
     expect(coerceToggleValue('true')).toBe(true)
+    expect(coerceToggleValue(1)).toBe(true)
+    expect(coerceToggleValue('1')).toBe(true)
     expect(coerceToggleValue(false)).toBe(false)
     expect(coerceToggleValue('false')).toBe(false)
+    expect(coerceToggleValue(0)).toBe(false)
+    expect(coerceToggleValue('0')).toBe(false)
     expect(coerceToggleValue(undefined)).toBe(false)
   })
 })
@@ -32,4 +37,27 @@ describe('normalizeFormDefinition toggle default', () => {
     })
     expect(def.blocks[0]?.defaultValue).toBe(true)
   })
+
+  it('preserves jsonSchema from raw definition', () => {
+    const schema = { type: 'object', properties: { title: { type: 'string' } } }
+    const def = normalizeFormDefinition({
+      title: '',
+      description: '',
+      blocks: [],
+      jsonSchema: schema,
+    })
+    expect(def.jsonSchema).toEqual(schema)
+  })
+})
+
+describe('mapFormDefinitionFromDto jsonSchema', () => {
+  it('reads json_schema snake_case from DTO', () => {
+    const schema = { type: 'object' }
+    const def = mapFormDefinitionFromDto({
+      title: 'T',
+      blocks: [{ id: 'b1', type: 'text', name: 'x', label: 'X' }],
+      json_schema: schema,
+    })
+    expect(def?.jsonSchema).toEqual(schema)
+  })
 })

package/src/adapter/formSchema.ts

@@ -1,4 +1,4 @@
-import type { FormBlock, FormBlockType, FormCaseFilter, FormResumeFilter, FormSchema } from '../types/index'
+import type { FormBlock, FormBlockType, FormCaseFilter, FormResumeFilter, FormJsonSchema, FormSchema } from '../types/index'
 import { isInputBlockType, isMediaBlockType } from '../types/index'
 import { generateId } from './id'
 import {
@@ -13,8 +13,17 @@ import {
 
 const DEFAULT_MEDIA_URL_MAX = 10
 
+export function normalizeJsonSchema(raw: unknown): FormJsonSchema {
+  if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+    return raw as FormJsonSchema
+  }
+  return {}
+}
+
 export function coerceToggleValue(raw: unknown): boolean {
-  return raw === true || raw === 'true'
+  if (raw === true || raw === 'true' || raw === 1 || raw === '1') return true
+  if (raw === false || raw === 'false' || raw === 0 || raw === '0') return false
+  return false
 }
 
 function normalizeFileUploadCount(raw: unknown, fallback = 1): number {
@@ -178,7 +187,7 @@ export function normalizeFormDefinition(raw: FormSchema | undefined): FormSchema
     title: typeof raw.title === 'string' ? raw.title : '',
     description: typeof raw.description === 'string' ? raw.description : '',
     blocks,
-    jsonSchema: {},
+    jsonSchema: normalizeJsonSchema(raw.jsonSchema),
   })
 }
 

package/src/adapter/resolveSurface.ts

@@ -1,6 +1,6 @@
 import type { A2uiSurfaceDoc, FormBlock, FormDefinitionPayload, FormSchema } from '../types/index'
 import { a2uiToBlocks, blocksToA2ui, isA2uiSurfaceEmpty, type BlocksToA2uiOptions } from './a2uiAdapter'
-import { normalizeFormDefinition } from './formSchema'
+import { normalizeFormDefinition, normalizeJsonSchema } from './formSchema'
 
 function isA2uiSurfaceDoc(raw: unknown): raw is A2uiSurfaceDoc {
   return (
@@ -27,7 +27,7 @@ export function resolveSurfaceFromFormDefinition(
     title: typeof payload.title === 'string' ? payload.title : '',
     description: typeof payload.description === 'string' ? payload.description : '',
     blocks,
-    jsonSchema: {},
+    jsonSchema: normalizeJsonSchema(payload.jsonSchema ?? payload.json_schema),
   })
   const doc = blocksToA2ui(normalized, options)
   return isA2uiSurfaceEmpty(doc) ? null : doc
@@ -61,6 +61,6 @@ export function mapFormDefinitionFromDto(raw: unknown): FormSchema | undefined {
     title: typeof obj.title === 'string' ? obj.title : '',
     description: typeof obj.description === 'string' ? obj.description : '',
     blocks: Array.isArray(obj.blocks) ? (obj.blocks as FormSchema['blocks']) : [],
-    jsonSchema: {},
+    jsonSchema: normalizeJsonSchema(obj.jsonSchema ?? obj.json_schema),
   })
 }

package/src/catalog/a2uiCustomCatalog.tsx

@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import type { ReactNode } from 'react'
+import { useEffect, useState, type ReactNode } from 'react'
 import { Catalog, type ComponentContext } from '@a2ui/web_core/v0_9'
 import {
   basicCatalog,
@@ -21,6 +21,7 @@ import {
 import dayjs, { type Dayjs } from 'dayjs'
 import type { FormFilePlaceholderIcon, FormMediaSize } from '../types/index'
 import { coerceToggleValue } from '../adapter/formSchema'
+import { matchesValidationRegexp } from '../submit/validateFormSubmit'
 import {
   buildFileAcceptAttribute,
   formatFileAcceptSummary,
@@ -35,6 +36,7 @@ import { useA2uiPreviewMode } from './a2uiPreviewContext'
 import {
   asOptionalString,
   asStringArray,
+  normalizeSelectStoredValue,
   readBoundFieldValue,
   useSkoponBoundField,
 } from './useSkoponBoundField'
@@ -247,6 +249,11 @@ function SkoponSelectPreview({ context }: { context: ComponentContext }) {
   const options = readOptions(props.options)
   const isMultiple = readString(props.mode) === 'multiple'
 
+  useEffect(() => {
+    const normalized = normalizeSelectStoredValue(value, isMultiple)
+    if (normalized !== null) setValue(normalized)
+  }, [isMultiple, value, setValue])
+
   return (
     <div className="form-block-preview">
       {label ? <div className="form-block-preview-label">{label}</div> : null}
@@ -289,6 +296,13 @@ function ChoicePickerPreview({ context }: { context: ComponentContext }) {
       : isMultiple
         ? 'checkbox'
         : 'radio'
+  const isMultiplePicker =
+    effectiveType === 'multiselect' || effectiveType === 'checkbox'
+
+  useEffect(() => {
+    const normalized = normalizeSelectStoredValue(value, isMultiplePicker)
+    if (normalized !== null) setValue(normalized)
+  }, [isMultiplePicker, value, setValue])
 
   return (
     <div className="form-block-preview">
@@ -557,6 +571,7 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
         允许：{acceptSummary ?? '全部类型'}
         {minCount > 0 ? `；至少 ${minCount} 个文件` : ''}
         {hasMaxLimit ? `；最多 ${maxCount} 个文件` : ''}
+        ；当前仅收集文件名（不含文件内容，需宿主另行上传）
         {belowMinCount && interactive ? `（当前 ${selectedNames.length} 个，未达下限）` : ''}
       </Typography.Text>
     </div>
@@ -575,8 +590,22 @@ function TextFieldPreview({ context }: { context: ComponentContext }) {
   const label = readString(props.label)
   const placeholder = readString(props.placeholder)
   const variant = readString(props.variant) || 'shortText'
+  const validationRegexp = readString(props.validationRegexp)
   const stringValue = asOptionalString(value) ?? ''
   const disabled = !interactive
+  const [formatError, setFormatError] = useState('')
+
+  const validateFormat = (text: string) => {
+    if (!validationRegexp || !text.trim()) {
+      setFormatError('')
+      return
+    }
+    setFormatError(matchesValidationRegexp(text, validationRegexp) ? '' : '格式不正确')
+  }
+
+  useEffect(() => {
+    validateFormat(stringValue)
+  }, [validationRegexp, stringValue])
 
   const controlClassName = 'form-block-preview-control'
 
@@ -589,7 +618,13 @@ function TextFieldPreview({ context }: { context: ComponentContext }) {
         placeholder={placeholder || '长文本回答...'}
         autoSize={{ minRows: 2, maxRows: 6 }}
         value={stringValue}
-        onChange={(e) => setValue(e.target.value)}
+        status={formatError ? 'error' : undefined}
+        onChange={(e) => {
+          const next = e.target.value
+          setValue(next)
+          validateFormat(next)
+        }}
+        onBlur={(e) => validateFormat(e.target.value)}
       />
     )
   } else if (variant === 'number') {
@@ -622,7 +657,13 @@ function TextFieldPreview({ context }: { context: ComponentContext }) {
         className={controlClassName}
         placeholder={placeholder}
         value={stringValue}
-        onChange={(e) => setValue(e.target.value)}
+        status={formatError ? 'error' : undefined}
+        onChange={(e) => {
+          const next = e.target.value
+          setValue(next)
+          validateFormat(next)
+        }}
+        onBlur={(e) => validateFormat(e.target.value)}
       />
     )
   }
@@ -631,6 +672,11 @@ function TextFieldPreview({ context }: { context: ComponentContext }) {
     <div className="form-block-preview">
       {label ? <div className="form-block-preview-label">{label}</div> : null}
       {control}
+      {formatError ? (
+        <Typography.Text type="danger" className="form-block-preview-help">
+          {formatError}
+        </Typography.Text>
+      ) : null}
     </div>
   )
 }

package/src/catalog/skoponCaseSelect.tsx

@@ -90,7 +90,7 @@ function CaseCard({
       onClick={onToggle}
     >
       <div className="skopon-resume-select-card-avatar">
-        <FileTextOutlined style={{ fontSize: 24, color: 'var(--color-primary, #1677ff)' }} />
+        <FileTextOutlined style={{ fontSize: 24, color: 'var(--color-primary, #208368)' }} />
       </div>
       <div className="skopon-resume-select-card-body">
         <div className="skopon-resume-select-card-name">{item.name}</div>
@@ -152,6 +152,7 @@ function SkoponCaseSelectPreview({ context }: { context: ComponentContext }) {
         setItems([])
         setTotal(0)
         setFetchError('')
+        setLoading(false)
         return
       }
       setLoading(true)

package/src/catalog/skoponResumeSelect.tsx

@@ -198,6 +198,7 @@ function SkoponResumeSelectPreview({ context }: { context: ComponentContext }) {
         setItems([])
         setTotal(0)
         setError('未配置简历搜索服务')
+        setLoading(false)
         return
       }
       setLoading(true)

package/src/catalog/skoponSelectLoading.test.tsx

@@ -0,0 +1,182 @@
+// @vitest-environment happy-dom
+import { describe, it, expect, vi, afterEach, beforeAll } from 'vitest'
+
+vi.mock('@a2ui/web_core/v0_9/basic_catalog', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@a2ui/web_core/v0_9/basic_catalog')>()
+  return { ...actual, injectBasicCatalogStyles: vi.fn() }
+})
+
+vi.mock('@a2ui/react/styles', () => ({
+  injectStyles: vi.fn(),
+  removeStyles: vi.fn(),
+}))
+
+import { createElement } from 'react'
+import { render, cleanup, waitFor } from '@testing-library/react'
+import { blocksToA2ui } from '../adapter/a2uiAdapter'
+import SkoponFormRenderer from '../components/SkoponFormRenderer'
+import type { CaseSearchFn } from './caseSearchContext'
+import type { ResumeSearchFn } from './resumeSearchContext'
+
+beforeAll(() => {
+  class ResizeObserverMock {
+    observe() {}
+    unobserve() {}
+    disconnect() {}
+  }
+  vi.stubGlobal('ResizeObserver', ResizeObserverMock)
+})
+
+function buildCaseSurface(flowUniqueIds: string[]) {
+  return blocksToA2ui(
+    {
+      title: '',
+      description: '',
+      blocks: [
+        {
+          id: 'b-case',
+          type: 'case_multiselect',
+          name: 'cases',
+          label: '案例',
+          caseFilter: { flowUniqueIds, pageSize: 20 },
+        },
+      ],
+    },
+    { includeHeader: false },
+  )
+}
+
+function buildResumeSurface() {
+  return blocksToA2ui(
+    {
+      title: '',
+      description: '',
+      blocks: [
+        {
+          id: 'b-resume',
+          type: 'resume_multiselect',
+          name: 'resumes',
+          label: '简历',
+          resumeFilter: { names: [], agentUniqueIds: [], resumeUniqueIds: [], pageSize: 20 },
+        },
+      ],
+    },
+    { includeHeader: false },
+  )
+}
+
+describe('case/resume select loading state', () => {
+  afterEach(() => {
+    cleanup()
+  })
+
+  it('clears case loading when caseSearch is removed while fetch is in flight', async () => {
+    let resolveSearch!: (value: Awaited<ReturnType<CaseSearchFn>>) => void
+    const caseSearch = vi.fn(
+      () =>
+        new Promise<Awaited<ReturnType<CaseSearchFn>>>((resolve) => {
+          resolveSearch = resolve
+        }),
+    )
+
+    const doc = buildCaseSurface(['flow-1'])
+    const { rerender, queryByText } = render(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'case-loading-test',
+        caseSearch,
+      }),
+    )
+
+    expect(queryByText('加载案例…')).toBeTruthy()
+
+    rerender(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'case-loading-test',
+        caseSearch: null,
+      }),
+    )
+
+    await waitFor(() => {
+      expect(queryByText('加载案例…')).toBeNull()
+    })
+    expect(queryByText('未配置案例搜索服务')).toBeTruthy()
+
+    resolveSearch({ list: [], total: 0, page: 1, pageSize: 20 })
+  })
+
+  it('clears case loading when filter becomes invalid while fetch is in flight', async () => {
+    let resolveSearch!: (value: Awaited<ReturnType<CaseSearchFn>>) => void
+    const caseSearch = vi.fn(
+      () =>
+        new Promise<Awaited<ReturnType<CaseSearchFn>>>((resolve) => {
+          resolveSearch = resolve
+        }),
+    )
+
+    const validDoc = buildCaseSurface(['flow-1'])
+    const invalidDoc = buildCaseSurface([])
+
+    const { rerender, queryByText } = render(
+      createElement(SkoponFormRenderer, {
+        doc: validDoc,
+        surfaceId: 'case-filter-test',
+        caseSearch,
+      }),
+    )
+
+    expect(queryByText('加载案例…')).toBeTruthy()
+
+    rerender(
+      createElement(SkoponFormRenderer, {
+        doc: invalidDoc,
+        surfaceId: 'case-filter-test',
+        caseSearch,
+      }),
+    )
+
+    await waitFor(() => {
+      expect(queryByText('加载案例…')).toBeNull()
+    })
+    expect(queryByText('未配置案例列表筛选条件')).toBeTruthy()
+
+    resolveSearch({ list: [], total: 0, page: 1, pageSize: 20 })
+  })
+
+  it('clears resume loading when resumeSearch is removed while fetch is in flight', async () => {
+    let resolveSearch!: (value: Awaited<ReturnType<ResumeSearchFn>>) => void
+    const resumeSearch = vi.fn(
+      () =>
+        new Promise<Awaited<ReturnType<ResumeSearchFn>>>((resolve) => {
+          resolveSearch = resolve
+        }),
+    )
+
+    const doc = buildResumeSurface()
+    const { rerender, queryByText } = render(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'resume-loading-test',
+        resumeSearch,
+      }),
+    )
+
+    expect(queryByText('加载简历…')).toBeTruthy()
+
+    rerender(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'resume-loading-test',
+        resumeSearch: null,
+      }),
+    )
+
+    await waitFor(() => {
+      expect(queryByText('加载简历…')).toBeNull()
+    })
+    expect(queryByText('未配置简历搜索服务')).toBeTruthy()
+
+    resolveSearch({ list: [], total: 0, page: 1, pageSize: 20 })
+  })
+})

package/src/catalog/textFieldPreview.test.tsx

@@ -85,4 +85,35 @@ describe('SkoponFormRenderer TextField longText', () => {
     expect(warnSpy.mock.calls.some((call) => String(call[0]).includes('[useMarkdown]'))).toBe(false)
     warnSpy.mockRestore()
   })
+
+  it('shows format error for invalid email TextField', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          {
+            id: 'b-email',
+            type: 'email',
+            name: 'contact',
+            label: '邮箱',
+          },
+        ],
+      },
+      { includeHeader: false },
+    )
+    const { container, getByText } = render(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'test-email',
+        fieldNames: ['contact'],
+      }),
+    )
+    const input = container.querySelector('input.ant-input')
+    expect(input).toBeTruthy()
+    if (input) {
+      fireEvent.change(input, { target: { value: 'not-an-email' } })
+    }
+    expect(getByText('格式不正确')).toBeTruthy()
+  })
 })

package/src/catalog/useSkoponBoundField.test.ts

@@ -3,7 +3,7 @@
  */
 import { describe, it, expect } from 'vitest'
 import type { ComponentContext } from '@a2ui/web_core/v0_9'
-import { asStringArray, clampStringArraySelection, readBoundFieldValue, toggleStringArraySelection } from './useSkoponBoundField'
+import { asStringArray, clampStringArraySelection, normalizeSelectStoredValue, readBoundFieldValue, toggleStringArraySelection } from './useSkoponBoundField'
 
 function createMockContext(initial: unknown = []): {
   context: ComponentContext
@@ -29,6 +29,19 @@ function createMockContext(initial: unknown = []): {
   }
 }
 
+describe('normalizeSelectStoredValue', () => {
+  it('coerces string to array in multiple mode', () => {
+    expect(normalizeSelectStoredValue('a', true)).toEqual(['a'])
+    expect(normalizeSelectStoredValue(['a', 'b'], true)).toBeNull()
+  })
+
+  it('coerces array to string in single mode', () => {
+    expect(normalizeSelectStoredValue(['a', 'b'], false)).toBe('a')
+    expect(normalizeSelectStoredValue([], false)).toBe('')
+    expect(normalizeSelectStoredValue('a', false)).toBeNull()
+  })
+})
+
 describe('readBoundFieldValue', () => {
   it('reads current bound value from dataContext', () => {
     const { context } = createMockContext(['a.pdf'])

package/src/catalog/useSkoponBoundField.ts

@@ -65,6 +65,20 @@ export function asStringArray(value: unknown): string[] {
   return []
 }
 
+/** 单选/多选模式切换时规范化 stored value；无需变更时返回 null。 */
+export function normalizeSelectStoredValue(value: unknown, isMultiple: boolean): unknown | null {
+  if (isMultiple) {
+    if (Array.isArray(value)) return null
+    return asStringArray(value)
+  }
+  if (Array.isArray(value)) {
+    return value.length > 0 ? String(value[0]) : ''
+  }
+  if (value === undefined || value === null) return null
+  if (typeof value === 'string' || typeof value === 'number') return null
+  return ''
+}
+
 export function readOptionalSelectCount(value: unknown): number | undefined {
   if (value === undefined || value === null) return undefined
   const num = typeof value === 'number' ? value : Number(value)

package/src/client/apiEnvelope.ts

@@ -0,0 +1,21 @@
+export interface ApiEnvelope<T> {
+  success?: boolean
+  data?: T
+  message?: string
+}
+
+export async function parseEnvelope<T>(response: Response): Promise<T> {
+  let json: ApiEnvelope<T>
+  try {
+    json = (await response.json()) as ApiEnvelope<T>
+  } catch {
+    throw new Error(`响应非 JSON (${response.status})`)
+  }
+  if (!response.ok || json.success === false) {
+    throw new Error(json.message || `请求失败 (${response.status})`)
+  }
+  if (json.data === undefined || json.data === null) {
+    throw new Error(json.message || `响应缺少 data (${response.status})`)
+  }
+  return json.data
+}

package/src/client/authStorage.test.ts

@@ -0,0 +1,61 @@
+/**
+ * @vitest-environment happy-dom
+ */
+import { afterEach, describe, expect, it } from 'vitest'
+import {
+  DEFAULT_AUTH_STORAGE_KEY,
+  resolveSkoponAuthHeaders,
+} from './authStorage'
+
+describe('resolveSkoponAuthHeaders', () => {
+  afterEach(() => {
+    sessionStorage.clear()
+    localStorage.clear()
+  })
+
+  it('reads Bearer token from sessionStorage auth_user by default', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({ username: 'u', displayName: 'U', token: 'abc123' }),
+    )
+    expect(resolveSkoponAuthHeaders()).toEqual({
+      Authorization: 'Bearer abc123',
+    })
+  })
+
+  it('strips existing Bearer prefix from stored token', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({ token: 'Bearer xyz' }),
+    )
+    expect(resolveSkoponAuthHeaders()).toEqual({
+      Authorization: 'Bearer xyz',
+    })
+  })
+
+  it('returns empty object when session is missing', () => {
+    expect(resolveSkoponAuthHeaders()).toEqual({})
+  })
+
+  it('returns empty object when token field is empty', () => {
+    sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: '' }))
+    expect(resolveSkoponAuthHeaders()).toEqual({})
+  })
+
+  it('supports custom storageKey and tokenField', () => {
+    sessionStorage.setItem('my_session', JSON.stringify({ accessToken: 'tok-1' }))
+    expect(
+      resolveSkoponAuthHeaders({ storageKey: 'my_session', tokenField: 'accessToken' }),
+    ).toEqual({ Authorization: 'Bearer tok-1' })
+  })
+
+  it('supports localStorage', () => {
+    localStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({ token: 'local-tok' }),
+    )
+    expect(resolveSkoponAuthHeaders({ storage: 'localStorage' })).toEqual({
+      Authorization: 'Bearer local-tok',
+    })
+  })
+})