weaver-e10-builder 1.6.0 → 1.6.5

package/skill-docs/assets/sample/api/formApi.js

@@ -1,510 +1,689 @@
-import { appInfo } from '@weapp/utils';
-const { publicUrl } = appInfo('@weapp/ecodesdk');
-const API_BASE = `${publicUrl}/api/ebuilder/form/dataset`;
-
-/**
- * Fetches data with a timeout and retry mechanism.
- * @param {string} url - The URL to fetch.
- * @param {RequestInit} options - Fetch options.
- * @param {number} [timeoutMs=5000] - Timeout in milliseconds.
- * @param {number} [retries=3] - Number of retries.
- * @returns {Promise<Response>}
- */
-async function fetchWithRetry(url, options, timeoutMs = 5000, retries = 3) {
-  let lastError;
-
-  for (let i = 0; i <= retries; i++) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
-
-    try {
-      const response = await fetch(url, {
-        ...options,
-        signal: controller.signal,
-      });
-      
-      clearTimeout(timeoutId);
-      return response;
-    } catch (error) {
-      clearTimeout(timeoutId);
-      lastError = error;
-      
-      // If it's the last attempt, throw the error
-      if (i === retries) {
-        throw new Error(`Request failed after ${retries + 1} attempts. Last error: ${lastError.message}`);
-      }
-      
-      // Optional: Add exponential backoff or simple delay before retrying
-      await new Promise(resolve => setTimeout(resolve, 1000 * (i + 1)));
-    }
-  }
-  
-  // This line should theoretically not be reached due to the throw above
-  throw lastError;
-}
-
-/**
- * 获取字段定义
- * @param {string} objId 
- * @param {string} userId 
- * @returns {Promise<Array>}
- */
-export async function getFields(objId, userId) {
-  const response = await fetchWithRetry(`${API_BASE}/v1/getFields`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      userid: userId,
-      objId: objId,
-      tenantKey: TENANTKEY,
-    }),
-  });
-
-  const result = await response.json();
-  
-  if (result.message.code !== '0') {
-    throw new Error(`获取字段失败: ${result.message.msg}`);
-  }
-  
-  // 按 number 排序，保持表单原始顺序
-  return result.data.mainFields.sort((a, b) => a.number - b.number);
-}
-
-/**
- * 获取所有数据
- * @param {string} objId 
- * @param {string} userId 
- * @returns {Promise<Array>}
- */
-const TENANTKEY = TEAMS.currentTenant.tenantKey
-export async function getAllData(objId, userId) {
-  const response = await fetchWithRetry(`${API_BASE}/v2/getAllData?tenantkey=${TENANTKEY}`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      userid: userId,
-      datajson: {
-        header: { objId: objId },
-      },
-    }),
-  });
-
-  const result = await response.json();
-  
-  if (result.message.code !== '0') {
-    throw new Error(`获取数据失败: ${result.message.msg}`);
-  }
-  
-  return result.data.datajson.datas || [];
-}
-
-// ==================== 数据解析函数 ====================
-
-/**
- * 解析单个字段的值
- * @param {any} value 
- * @param {Object} fieldDef 
- * @returns {Object} ParsedValue
- */
-export function parseFieldValue(value, fieldDef) {
-  // 处理 undefined 或 null 值
-  if (!value) {
-    return { displayValue: '', rawValue: value };
-  }
-
-  // 处理数组类型（Select, RadioBox, CheckBox 等多选/单选）
-  if (Array.isArray(value)) {
-    if (value.length === 0) {
-      return { displayValue: '', rawValue: [] };
-    }
-    
-    // 提取选项名称列表
-    const optionNames = value
-      .map(v => v?.fieldOptionName || v?.fieldValue || '')
-      .filter(v => v);
-    
-    const options = value.map(v => ({
-      id: v?.fieldOptionId || '',
-      name: v?.fieldOptionName || v?.fieldValue || '',
-    }));
-    
-    return {
-      displayValue: optionNames.join(', '),
-      rawValue: value,
-      options: options,
-    };
-  }
-  
-  // 处理普通对象
-  const fieldType = fieldDef.fieldType;
-  
-  switch (fieldType) {
-    case 'Employee':
-      // 员工字段可能返回用户ID或姓名
-      return {
-        displayValue: value.fieldValue || '',
-        rawValue: value,
-      };
-    case 'Date':
-      // 日期格式化
-      const dateValue = value.fieldValue;
-      if (dateValue && dateValue.includes('-')) {
-        return { displayValue: dateValue, rawValue: value };
-      }
-      return { displayValue: dateValue || '', rawValue: value };
-    case 'Number':
-      return {
-        displayValue: value.fieldValue || '0',
-        rawValue: value,
-      };
-    case 'Select':
-    case 'RadioBox':
-      return {
-        displayValue: value.fieldOptionName || value.fieldValue || '',
-        rawValue: value,
-      };
-    default:
-      return {
-        displayValue: value.fieldValue || '',
-        rawValue: value,
-      };
-  }
-}
-
-// ==================== 数据格式转换函数 ====================
-
-/**
- * 将API返回的复杂数据结构转换为简单的键值对格式
- * @param {Array} dataRows 
- * @param {Array} fields 
- * @returns {Array<SimpleDataItem>}
- */
-export function transformToSimpleFormat(dataRows, fields) {
-  if (!dataRows || !dataRows.length) return [];
-  // Create a map for quick lookup: fieldId -> FieldDefinition
-  const fieldMap = new Map();
-  fields.forEach(field => {
-    fieldMap.set(field.fieldId, field);
-  });
-
-  return dataRows.map(row => {
-    const simpleItem = {};
-    
-    // Copy row-level id (data ID) to simple item
-    if (row.id) {
-      simpleItem.id = row.id;
-    }
-
-    // Process mainTable
-    if (row.mainTable) {
-      Object.entries(row.mainTable).forEach(([key, value]) => {
-        // Handle the special 'id' field in mainTable
-        if (key === 'id' && value && typeof value === 'object') {
-          simpleItem.id = value.fieldValue || value.fieldOptionName || '';
-          return;
-        }
-
-        let actualFieldId;
-        let parsedValue;
-
-        // Case 1: Value is an object/array containing fieldId (Standard dynamic form structure)
-        if (value && typeof value === 'object') {
-          if (Array.isArray(value)) {
-            // For arrays (like RadioBox/Select), the fieldId is usually in the first item
-            actualFieldId = value[0]?.fieldId;
-          } else {
-            // For objects (like TextArea, Number), the fieldId is directly on the object
-            actualFieldId = value.fieldId;
-          }
-        } 
-        // Case 2: Value is a primitive (fallback)
-        else {
-           actualFieldId = key;
-        }
-
-        // Find the field definition using the extracted actualFieldId
-        const fieldDef = actualFieldId ? fieldMap.get(actualFieldId) : undefined;
-        
-        // Determine the key: Use fieldId if available, otherwise fallback to original key
-        const resultKey = fieldDef ? fieldDef.fieldId : key;
-
-        // Parse the value using the correct field definition
-        // Fallback definition if fieldDef is missing
-        const fallbackDef = {
-          id: 0,
-          fieldId: actualFieldId || key,
-          fieldName: resultKey, 
-          fieldType: 'String',
-          fieldKey: 'Text',
-          number: 0,
-          multiSelect: false,
-          objId: 0
-        };
-
-        parsedValue = parseFieldValue(value, fieldDef || fallbackDef);
-
-        // Assign to result using the fieldId as the key
-        let finalValue = parsedValue.displayValue;
-
-        // 特殊类型统一返回 fieldOptionId（写入和组件回显需要的 ID）
-        // Select/RadioBox/CheckBox → 选项ID, Employee → 人员ID, Department → 部门ID, FileComponent → 文件ID
-        // 如需显示名称，配合 getFieldOptions 或从 uploadedFiles/selectedPerson 状态中获取
-        const fieldType = fieldDef?.fieldType;
-        const isIdType = fieldType === 'Select' || fieldType === 'RadioBox' || fieldType === 'CheckBox'
-            || fieldType === 'Employee' || fieldType === 'Department' || fieldType === 'FileComponent';
-
-        if (isIdType) {
-            if (Array.isArray(value)) {
-                const ids = value
-                    .map((v) => v?.fieldOptionId)
-                    .filter((id) => id !== undefined && id !== null && id !== '');
-
-                finalValue = ids.length > 0 ? ids.join(',') : '';
-            } else if (value && typeof value === 'object') {
-                finalValue = value.fieldOptionId ? String(value.fieldOptionId) : '';
-            }
-        }
-        
-        simpleItem[actualFieldId] = finalValue;
-      });
-    }
-    
-    return simpleItem;
-  });
-}
-
-/**
- * 获取转换后的简单格式数据
- * @param {string} objId 
- * @param {string} userId 
- * @returns {Promise<Array<SimpleDataItem>>}
- */
-export async function getSimpleData(objId, userId) {
-  const [fields, dataRows] = await Promise.all([
-    getFields(objId, userId),
-    getAllData(objId, userId)
-  ]);
-  const result = transformToSimpleFormat(dataRows, fields);
-  return result;
-}
-
-// ==================== ID → 名称映射（用于表格展示） ====================
-
-/**
- * 将 simpleData 中 Select/Employee/Department 等字段的 ID 替换为显示名称。
- * getSimpleData 返回的是 ID（用于写入），表格展示需要名称，用此函数转换。
- *
- * @param {Array<Object>} simpleData — getSimpleData 的返回值
- * @param {Object} optionsMap — { fieldId: [{valueKey, name}, ...] }，valueKey→name 的映射表
- * @returns {Array<Object>} 字段值为显示名称的新数组
- *
- * 用法：
- *   var [data, setData] = useState([]);
- *   useEffect(function () {
- *     Promise.all([
- *       getSimpleData(OBJ_ID, USER_ID),
- *       getFieldOptions(F.status, FORM_ID),
- *     ]).then(function ([rows, statusOpts]) {
- *       setData(withDisplayNames(rows, { [F.status]: statusOpts }));
- *     });
- *   }, []);
- */
-export function withDisplayNames(simpleData, optionsMap) {
-  return simpleData.map(function (row) {
-    var displayRow = {};
-    Object.keys(row).forEach(function (key) {
-      var options = optionsMap[key];
-      if (options && options.length) {
-        var ids = (row[key] || '').split(',');
-        displayRow[key] = ids.map(function (id) {
-          var opt = options.find(function (o) { return o.valueKey === id; });
-          return opt ? opt.name : id;
-        }).join(', ');
-      } else {
-        displayRow[key] = row[key];
-      }
-    });
-    return displayRow;
-  });
-}
-
-// ==================== 保存表单数据 ====================
-
-/**
- * 保存表单数据
- * @param {string} objId 
- * @param {Object} formData 
- * @param {string} userId 
- * @returns {Promise<Object>}
- */
-export async function saveFormData(objId, formData, userId) {
-  const requestData = {
-    userid: userId,
-    datajson: {
-      datas: {
-        mainTable: formData,
-        operationinfo: {
-          doAction: 'n', // 新增操作
-          optionNoFindIgnore: 'false'
-        }
-      },
-      header: {
-        objId: objId,
-        tenantKey: TENANTKEY
-      }
-    }
-  };
-
-  const response = await fetchWithRetry(`${API_BASE}/v1/saveFormData`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify(requestData),
-  });
-
-  const result = await response.json();
-  if (result.data && result.data.isSuccess === false) {
-    throw new Error('保存失败: ' + (result.data.msg || JSON.stringify(result.data)));
-  }
-  if (result.message && result.message.code !== '0') {
-    throw new Error('保存失败: ' + (result.message.msg || JSON.stringify(result.message)));
-  }
-  return result;
-}
-
-// ==================== 更新表单数据 ====================
-
-/**
- * 更新表单数据
- * @param {string} objId
- * @param {Object} formData
- * @param {string} dataId - 数据ID
- * @param {string} userId
- * @returns {Promise<Object>}
- */
-export async function updateFormData(objId, formData, dataId, userId) {
-  const requestData = {
-    userid: userId,
-    datajson: {
-      datas: {
-        mainTable: Object.assign({ id: dataId }, formData),
-        operationinfo: {
-          doAction: 'u',
-          optionNoFindIgnore: 'false'
-        }
-      },
-      header: {
-        objId: objId,
-        tenantKey: TENANTKEY
-      }
-    }
-  };
-
-  const response = await fetchWithRetry(`${API_BASE}/v1/saveFormData`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify(requestData),
-  });
-
-  const result = await response.json();
-  if (result.data && result.data.isSuccess === false) {
-    throw new Error('更新失败: ' + (result.data.msg || JSON.stringify(result.data)));
-  }
-  if (result.message && result.message.code !== '0') {
-    throw new Error('更新失败: ' + (result.message.msg || JSON.stringify(result.message)));
-  }
-  return result;
-}
-
-// ==================== 删除表单数据 ====================
-
-/**
- * 删除表单数据
- * @param {string} objId - 表单ID (objId)
- * @param {string|number} dataId - 数据ID
- * @param {string} userId - User ID
- * @returns {Promise<Object>}
- */
-export async function deleteFormData(objId, dataId, userId) {
-  const requestData = {
-    userid: userId,
-    datajson: {
-      header: {
-        objId: objId
-      },
-      mainTable: {
-        id: dataId
-      },
-      operationinfo: {
-        fieldNoFindIgnore: 'false'
-      }
-    }
-  };
-
-  const response = await fetchWithRetry(`${API_BASE}/v2/deleteData`, {
-    method: 'POST',
-    headers: { 
-      'Content-Type': 'application/json' 
-    },
-    body: JSON.stringify(requestData),
-  });
-
-  const result = await response.json();
-  
-  if (result.message.code !== '0') {
-    throw new Error(`删除数据失败: ${result.message.msg}`);
-  }
-
-  return result;
-}
-
-// ==================== 获取选项字段的具体选项值 ====================
-export async function getFieldOptions(fieldId, objId) {
-  // 注意：第二个参数是 objId（表单对象 ID），与 getSimpleData/saveFormData 用的是同一个值
-  const infoUrl = `${publicUrl}/api/ebuilder/form/obj/getInfo/${objId}`;
-  const infoResponse = await fetchWithRetry(infoUrl, {
-    method: 'GET',
-    headers: { 'Content-Type': 'application/json' },
-  });
-  const infoResult = await infoResponse.json();
-  if (infoResult.code !== 200 || !infoResult.status) {
-    throw new Error(`获取表单信息失败: ${infoResult.msg || 'Unknown error'}`);
-  }
-  const formIdNew = infoResult.data?.formId;
-  
-  if (!formIdNew) {
-    throw new Error('未能从表单信息中获取有效的 formId');
-  }
-
-  const url = `${publicUrl}/api/ebuilder/form/form/field/manage/getFormField`;    
-  const requestBody = {
-    module: "ebuilderform",
-    formTableField: {
-      formField: {
-        id: fieldId,
-        form: {
-          id: formIdNew // Use the dynamically fetched formId
-        }
-      }
-    }
-  };
-  const response = await fetchWithRetry(url, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify(requestBody),
-  });
-
-  const result = await response.json();
-  if (result.code !== 200 || !result.status) {
-    throw new Error(`获取字段选项失败: ${result.msg || 'Unknown error'}`);
-  }
-  
-  const options = result.data?.options || [];
-  return options.map(option => ({
-    valueKey: option.valueKey,
-    name: option.name
-  }));
-}
+import { appInfo } from '@weapp/utils';
+
+var SDK_INFO = appInfo('@weapp/ecodesdk');
+var PUBLIC_URL = SDK_INFO.publicUrl;
+var API_BASE = PUBLIC_URL + '/api/ebuilder/form/dataset';
+
+function getTeams() {
+  if (typeof TEAMS !== 'undefined') return TEAMS;
+  if (typeof window !== 'undefined' && window.TEAMS) return window.TEAMS;
+  return {};
+}
+
+var TEAMS_OBJ = getTeams();
+var USER_ID = (TEAMS_OBJ.currentUser && TEAMS_OBJ.currentUser.id) || '';
+var TENANT_KEY = (TEAMS_OBJ.currentTenant && TEAMS_OBJ.currentTenant.tenantKey) || '';
+
+var clients = {};
+
+function headers(appId) {
+  var result = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json'
+  };
+  if (appId) result.ebbusinessid = String(appId);
+  return result;
+}
+
+function multipartHeaders(appId) {
+  var result = { 'Accept': 'application/json' };
+  if (appId) result.ebbusinessid = String(appId);
+  return result;
+}
+
+function parseResponse(res) {
+  return res.text().then(function (text) {
+    var data = {};
+    try {
+      data = text ? JSON.parse(text) : {};
+    } catch (e) {
+      throw new Error('接口返回不是 JSON（HTTP ' + res.status + '）');
+    }
+    if (!res.ok) {
+      throw new Error('请求失败（HTTP ' + res.status + '）' + (data && data.msg ? '：' + data.msg : ''));
+    }
+    return data;
+  });
+}
+
+function readRequest(url, options, retries) {
+  if (retries === undefined) retries = 1;
+  var timeout = 15000;
+
+  function attempt(n) {
+    var controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+    var timer = null;
+    var opts = Object.assign({}, options);
+    if (controller) {
+      opts.signal = controller.signal;
+      timer = setTimeout(function () { controller.abort(); }, timeout);
+    }
+    return fetch(url, opts).then(function (res) {
+      if (timer) clearTimeout(timer);
+      return parseResponse(res);
+    }).catch(function (err) {
+      if (timer) clearTimeout(timer);
+      if (n < retries) {
+        return new Promise(function (resolve) {
+          setTimeout(function () { resolve(attempt(n + 1)); }, 500 * (n + 1));
+        });
+      }
+      throw err;
+    });
+  }
+
+  return attempt(0);
+}
+
+function writeRequest(url, body, appId) {
+  return fetch(url, {
+    method: 'POST',
+    headers: headers(appId),
+    body: JSON.stringify(body)
+  }).then(parseResponse);
+}
+
+function innerOf(res) {
+  return res && res.data && res.data.datajson ? res.data.datajson : null;
+}
+
+function assertOk(res, action) {
+  var message = res && res.message;
+  if (message && message.code !== undefined
+    && String(message.code) !== '0' && String(message.code) !== '200') {
+    throw new Error(action + '失败：' + (message.msg || String(message.code)));
+  }
+  var inner = innerOf(res);
+  if (inner && inner.status === false) {
+    throw new Error(action + '失败：' + (inner.message || '平台返回失败'));
+  }
+  if (res && res.code !== undefined
+    && String(res.code) !== '200' && String(res.code) !== '0') {
+    throw new Error(action + '失败：' + (res.msg || String(res.code)));
+  }
+  return res;
+}
+
+function textOf(cell) {
+  if (cell === undefined || cell === null) return '';
+  if (Array.isArray(cell)) {
+    return cell.map(textOf).filter(function (x) { return x !== ''; }).join(',');
+  }
+  if (typeof cell === 'object') {
+    if (cell.fieldOptionName) return String(cell.fieldOptionName);
+    if (cell.fieldTextValue) return String(cell.fieldTextValue);
+    if (cell.fieldValue !== undefined && cell.fieldValue !== null) return String(cell.fieldValue);
+    return '';
+  }
+  return String(cell);
+}
+
+function valueOf(cell) {
+  if (cell === undefined || cell === null) return '';
+  if (Array.isArray(cell)) {
+    return cell.map(valueOf).filter(function (x) { return x !== ''; }).join(',');
+  }
+  if (typeof cell === 'object') {
+    if (cell.fieldValue !== undefined && cell.fieldValue !== null) return String(cell.fieldValue);
+    if (cell.fieldOptionId !== undefined && cell.fieldOptionId !== null) return String(cell.fieldOptionId);
+    return '';
+  }
+  return String(cell);
+}
+
+function itemsOf(cell) {
+  if (cell === undefined || cell === null) return [];
+  var source = Array.isArray(cell) ? cell : [cell];
+  var result = [];
+  source.forEach(function (item) {
+    if (item === undefined || item === null || item === '') return;
+    if (typeof item !== 'object') {
+      result.push({ id: String(item), name: String(item) });
+      return;
+    }
+    var id = item.fieldOptionId;
+    if (id === undefined || id === null || id === '') id = item.fieldValue;
+    if (id === undefined || id === null || id === '') return;
+    var name = item.fieldOptionName || item.fieldTextValue || item.fieldValue || String(id);
+    result.push({ id: String(id), name: String(name) });
+  });
+  return result;
+}
+
+function idsOf(cell) {
+  return itemsOf(cell).map(function (item) { return item.id; }).join(',');
+}
+
+var ID_FIELD_TYPES = [
+  'Select', 'RadioBox', 'CheckBox', 'Employee', 'Department',
+  'FileComponent', 'Ebuilder', 'Browser', 'RelateBrowser'
+];
+
+function isIdField(field) {
+  return ID_FIELD_TYPES.indexOf(field && field.fieldType) >= 0;
+}
+
+function normalizeWriteValue(value) {
+  if (!Array.isArray(value)) return value;
+  return value.map(function (item) {
+    if (item && typeof item === 'object') {
+      return String(item.id || item.valueKey || item.fieldOptionId || '');
+    }
+    return String(item);
+  }).filter(function (item) { return item !== ''; }).join(',');
+}
+
+function requestKeyOf(field) {
+  var id = String(field.id || '');
+  var name = String(field.name || '');
+  var dataKey = field.config && field.config.dataKey ? String(field.config.dataKey) : '';
+  if (name === id && dataKey) return dataKey;
+  return name || dataKey || id;
+}
+
+function cellMap(mainTable) {
+  var result = {};
+  Object.keys(mainTable || {}).forEach(function (key) {
+    var value = mainTable[key];
+    if (value === undefined || value === null) return;
+    var fieldId = '';
+    if (Array.isArray(value)) fieldId = value[0] && value[0].fieldId;
+    else if (typeof value === 'object') fieldId = value.fieldId;
+    else fieldId = key;
+    if (fieldId) result[String(fieldId)] = value;
+  });
+  return result;
+}
+
+function idOfCell(value) {
+  if (value && typeof value === 'object') {
+    return String(value.fieldValue || value.fieldOptionId || '');
+  }
+  if (value !== undefined && value !== null) return String(value);
+  return '';
+}
+
+function toFlatRow(row, fields, idFallback) {
+  var cells = cellMap(row);
+  var values = {};
+  var display = {};
+  var items = {};
+
+  fields.forEach(function (field) {
+    var cell = cells[String(field.fieldId)];
+    if (cell === undefined) return;
+    var idField = isIdField(field);
+    values[field.fieldId] = idField ? idsOf(cell) : valueOf(cell);
+    display[field.fieldId] = textOf(cell);
+    if (idField) items[field.fieldId] = itemsOf(cell);
+  });
+
+  var id = idOfCell(row && row.id);
+  if (!id && idFallback !== undefined && idFallback !== null) id = String(idFallback);
+  return {
+    id: id,
+    values: values,
+    display: display,
+    items: items,
+    raw: row
+  };
+}
+
+function toRow(raw, fields, detailMeta) {
+  var mainTable = raw && raw.mainTable ? raw.mainTable : {};
+  var result = toFlatRow(mainTable, fields, raw && raw.id);
+  var details = {};
+  var detailRows = {};
+
+  Object.keys(raw || {}).forEach(function (node) {
+    if (node.indexOf('detail') !== 0 || !Array.isArray(raw[node])) return;
+    details[node] = raw[node];
+    var def = detailMeta && detailMeta[node];
+    if (def && def.fields) {
+      detailRows[def.subFormId || node] = raw[node].map(function (line) {
+        return toFlatRow(line, def.fields);
+      });
+    }
+  });
+
+  result.details = details;
+  result.detailRows = detailRows;
+  result.raw = raw;
+  return result;
+}
+
+function totalOf(inner) {
+  if (!inner) return null;
+  var candidates = [inner.total, inner.totalCount, inner.recordCount];
+  if (inner.pageInfo) candidates.push(inner.pageInfo.total, inner.pageInfo.totalCount);
+  for (var i = 0; i < candidates.length; i++) {
+    if (candidates[i] !== undefined && candidates[i] !== null) return Number(candidates[i]);
+  }
+  return null;
+}
+
+function createClient(options) {
+  var state = {
+    objId: String(options.objId),
+    appId: options.appId ? String(options.appId) : '',
+    fieldsPromise: null,
+    formIdPromise: null,
+    dsFieldsPromise: null,
+    requestKeysPromise: null,
+    detailMetaPromise: null,
+    optionsCache: {}
+  };
+
+  function fields() {
+    if (!state.fieldsPromise) {
+      var body = { userid: USER_ID, objId: state.objId };
+      if (TENANT_KEY) body.tenantKey = TENANT_KEY;
+      state.fieldsPromise = readRequest(API_BASE + '/v1/getFields', {
+        method: 'POST',
+        headers: headers(state.appId),
+        body: JSON.stringify(body)
+      }).then(function (res) {
+        assertOk(res, '读取字段');
+        var mainFields = res.data && res.data.mainFields ? res.data.mainFields : [];
+        mainFields.sort(function (a, b) {
+          return (Number(a.number) || 0) - (Number(b.number) || 0);
+        });
+        return mainFields;
+      });
+    }
+    return state.fieldsPromise;
+  }
+
+  function formId() {
+    if (!state.formIdPromise) {
+      state.formIdPromise = readRequest(
+        PUBLIC_URL + '/api/ebuilder/form/obj/getInfo/' + encodeURIComponent(state.objId),
+        { method: 'GET', headers: headers(state.appId) }
+      ).then(function (res) {
+        if (!res || String(res.code) !== '200' || !res.status) {
+          throw new Error('读取表单信息失败：' + ((res && res.msg) || '未知错误'));
+        }
+        return res.data && res.data.formId;
+      });
+    }
+    return state.formIdPromise;
+  }
+
+  function loadOptions(fieldId) {
+    var key = String(fieldId);
+    if (state.optionsCache[key]) return Promise.resolve(state.optionsCache[key]);
+    return formId().then(function (id) {
+      if (!id) throw new Error('未读到表单 formId，无法读取字段选项');
+      var body = {
+        module: 'ebuilderform',
+        formTableField: {
+          formField: {
+            id: String(fieldId),
+            form: { id: id }
+          }
+        }
+      };
+      return readRequest(PUBLIC_URL + '/api/ebuilder/form/form/field/manage/getFormField', {
+        method: 'POST',
+        headers: headers(state.appId),
+        body: JSON.stringify(body)
+      });
+    }).then(function (res) {
+      assertOk(res, '读取字段选项');
+      var rawOptions = (res.data && res.data.options) || [];
+      var result = rawOptions.map(function (item) {
+        return {
+          id: String(item.valueKey),
+          valueKey: String(item.valueKey),
+          name: item.name
+        };
+      });
+      state.optionsCache[key] = result;
+      return result;
+    });
+  }
+
+  function dsFields() {
+    if (!state.dsFieldsPromise) {
+      var form = new FormData();
+      form.append('groupId', state.appId || state.objId);
+      form.append('sourceId', state.objId);
+      form.append('sourceType', 'FORM');
+      form.append('detailFieldsGroup', 'true');
+      form.append('enableMerge', 'true');
+      form.append('customParam', '{"terminal":""}');
+      form.append('params', '[]');
+      state.dsFieldsPromise = fetch(PUBLIC_URL + '/api/ebuilder/common/ds/fields', {
+        method: 'POST',
+        headers: multipartHeaders(state.appId),
+        body: form
+      }).then(parseResponse).then(function (res) {
+        assertOk(res, '读取字段定义');
+        return Array.isArray(res.data) ? res.data : [];
+      });
+    }
+    return state.dsFieldsPromise;
+  }
+
+  function requestKeys() {
+    if (!state.requestKeysPromise) {
+      state.requestKeysPromise = dsFields().then(function (groups) {
+        var map = {};
+        groups.forEach(function (group) {
+          (group.fields || []).forEach(function (field) {
+            if (field.isDetailtable) return;
+            map[String(field.id)] = requestKeyOf(field);
+          });
+        });
+        return map;
+      });
+    }
+    return state.requestKeysPromise;
+  }
+
+  function detailMeta() {
+    if (!state.detailMetaPromise) {
+      var url = API_BASE + '/v1/getTableMapping?objId=' + encodeURIComponent(state.objId) + '&reverse=false';
+      state.detailMetaPromise = Promise.all([
+        dsFields(),
+        readRequest(url, { method: 'GET', headers: headers(state.appId) })
+      ]).then(function (results) {
+        var groups = results[0];
+        var res = results[1];
+        assertOk(res, '读取明细映射');
+        var mapping = res.data || {};
+        var bySubForm = {};
+        groups.forEach(function (group) {
+          (group.fields || []).forEach(function (field) {
+            if (!field.isDetailtable) return;
+            bySubForm[String(field.id)] = {
+              subFormId: String(field.id),
+              fields: (field.fields || []).map(function (item) {
+                return {
+                  fieldId: String(item.id),
+                  fieldType: String(item.type || item.compType || ''),
+                  fieldName: String(item.text || item.name || ''),
+                  requestKey: requestKeyOf(item)
+                };
+              })
+            };
+          });
+        });
+        var nodes = {};
+        Object.keys(mapping).forEach(function (node) {
+          if (node === 'mainTable') return;
+          var def = bySubForm[String(mapping[node])];
+          if (def) nodes[node] = def;
+        });
+        return nodes;
+      });
+    }
+    return state.detailMetaPromise;
+  }
+
+  function optionId(fieldId, nameOrId) {
+    return loadOptions(fieldId).then(function (opts) {
+      var key = String(nameOrId);
+      var hit = null;
+      opts.forEach(function (item) {
+        if (!hit && (item.name === key || item.valueKey === key || item.id === key)) hit = item;
+      });
+      if (!hit) {
+        throw new Error('字段 ' + fieldId + ' 没有选项「' + nameOrId + '」，可选：'
+          + opts.map(function (item) { return item.name; }).join('、'));
+      }
+      return hit.valueKey;
+    });
+  }
+
+  function optionIds(fieldId, names) {
+    var list = Array.isArray(names) ? names : String(names || '').split(/[,，、]/);
+    return Promise.all(list.map(function (name) {
+      return optionId(fieldId, name);
+    })).then(function (ids) {
+      return ids.join(',');
+    });
+  }
+
+  function optionMap(fieldId) {
+    return loadOptions(fieldId).then(function (opts) {
+      var map = {};
+      opts.forEach(function (item) { map[item.name] = item.valueKey; });
+      return map;
+    });
+  }
+
+  function toRequestValues(values) {
+    return requestKeys().then(function (map) {
+      var result = {};
+      Object.keys(values || {}).forEach(function (key) {
+        var target = map[String(key)] || String(key);
+        result[target] = normalizeWriteValue(values[key]);
+      });
+      return result;
+    });
+  }
+
+  function toRequestDetails(details) {
+    if (!details) return Promise.resolve(null);
+    return detailMeta().then(function (nodes) {
+      var lookup = {};
+      Object.keys(nodes).forEach(function (node) {
+        lookup[node] = node;
+        if (nodes[node].subFormId) lookup[nodes[node].subFormId] = node;
+      });
+      var result = {};
+      Object.keys(details).forEach(function (key) {
+        var node = lookup[key];
+        if (!node) throw new Error('未找到明细节点或 subFormId：' + key);
+        var def = nodes[node];
+        if (!Array.isArray(details[key])) throw new Error('明细 ' + key + ' 必须是数组');
+        var map = {};
+        def.fields.forEach(function (field) { map[field.fieldId] = field.requestKey; });
+        result[node] = details[key].map(function (row) {
+          var out = {};
+          Object.keys(row || {}).forEach(function (fieldKey) {
+            out[map[String(fieldKey)] || String(fieldKey)] = normalizeWriteValue(row[fieldKey]);
+          });
+          return out;
+        });
+      });
+      return result;
+    });
+  }
+
+  function list(query) {
+    query = query || {};
+    var datajson = {
+      header: { objId: state.objId },
+      pageInfo: {
+        pageNo: String(query.page || 1),
+        pageSize: String(query.size || 1000)
+      }
+    };
+    if (TENANT_KEY) datajson.header.tenantKey = TENANT_KEY;
+    if (query.withDetail) datajson.operationinfo = { isReturnDetail: 'y' };
+
+    var url = API_BASE + '/v2/getAllData';
+    if (TENANT_KEY) url += '?tenantkey=' + encodeURIComponent(TENANT_KEY);
+
+    var request = Promise.resolve(null).then(function () {
+      return query.filter ? toRequestValues(query.filter) : null;
+    }).then(function (filter) {
+      if (filter) datajson.mainTable = filter;
+      return readRequest(url, {
+        method: 'POST',
+        headers: headers(state.appId),
+        body: JSON.stringify({ userid: USER_ID, datajson: datajson })
+      });
+    });
+
+    var detailPromise = query.withDetail ? detailMeta() : Promise.resolve(null);
+
+    return Promise.all([fields(), detailPromise, request]).then(function (results) {
+      var fieldList = results[0];
+      var detail = results[1];
+      var res = results[2];
+      assertOk(res, '读取数据');
+      var inner = innerOf(res) || {};
+      var datas = Array.isArray(inner.datas) ? inner.datas : [];
+      return {
+        rows: datas.map(function (raw) { return toRow(raw, fieldList, detail); }),
+        total: totalOf(inner),
+        raw: res
+      };
+    });
+  }
+
+  function get(dataId, query) {
+    query = query || {};
+    var operationinfo = { fieldNoFindIgnore: 'false' };
+    if (query.withDetail) operationinfo.isReturnDetail = 'y';
+    var datajson = {
+      header: { objId: state.objId },
+      mainTable: { id: String(dataId) },
+      operationinfo: operationinfo
+    };
+    if (TENANT_KEY) datajson.header.tenantKey = TENANT_KEY;
+
+    var detailPromise = query.withDetail ? detailMeta() : Promise.resolve(null);
+
+    return Promise.all([
+      fields(),
+      detailPromise,
+      readRequest(API_BASE + '/v2/getDataById', {
+        method: 'POST',
+        headers: headers(state.appId),
+        body: JSON.stringify({ userid: USER_ID, datajson: datajson })
+      })
+    ]).then(function (results) {
+      var fieldList = results[0];
+      var detail = results[1];
+      var res = results[2];
+      assertOk(res, '读取数据');
+      var inner = innerOf(res) || {};
+      var datas = Array.isArray(inner.datas) ? inner.datas : [];
+      return datas.length ? toRow(datas[0], fieldList, detail) : null;
+    });
+  }
+
+  function save(values, writeOptions) {
+    writeOptions = writeOptions || {};
+    return Promise.all([
+      toRequestValues(values),
+      toRequestDetails(writeOptions.details)
+    ]).then(function (results) {
+      var mainTable = results[0];
+      var details = results[1];
+      var data = { mainTable: mainTable };
+      if (details) {
+        Object.keys(details).forEach(function (key) {
+          data[key] = details[key];
+        });
+      }
+      var operationinfo = { fieldNoFindIgnore: 'false' };
+      if (writeOptions.triggerAction === true) operationinfo.doAction = 'true';
+
+      var datajson = { header: { objId: state.objId }, datas: [data], operationinfo: operationinfo };
+      if (TENANT_KEY) datajson.header.tenantKey = TENANT_KEY;
+
+      return writeRequest(API_BASE + '/v2/saveFormData', {
+        userid: USER_ID,
+        datajson: datajson
+      }, state.appId).then(function (res) {
+        assertOk(res, '保存数据');
+        var inner = innerOf(res) || {};
+        if (Array.isArray(inner.dataIds)) return String(inner.dataIds[0] || '');
+        return String(inner.dataIds || '');
+      });
+    });
+  }
+
+  function update(dataId, values, writeOptions) {
+    writeOptions = writeOptions || {};
+    return Promise.all([
+      toRequestValues(values),
+      toRequestDetails(writeOptions.details)
+    ]).then(function (results) {
+      var mainTable = results[0];
+      var details = results[1];
+      mainTable.id = String(dataId);
+
+      var data = { mainTable: mainTable };
+      if (details) {
+        Object.keys(details).forEach(function (key) {
+          data[key] = details[key];
+        });
+      }
+
+      var operationinfo = {
+        updateType: 'ids',
+        needAdd: 'false',
+        fieldNoFindIgnore: 'false'
+      };
+      if (writeOptions.detailMode === 'cover' && details) {
+        var operateType = {};
+        Object.keys(details).forEach(function (key) { operateType[key] = 'cover'; });
+        if (Object.keys(operateType).length) operationinfo.operateType = operateType;
+      }
+      if (writeOptions.triggerAction === true) operationinfo.doAction = 'true';
+
+      var datajson = { header: { objId: state.objId }, datas: [data], operationinfo: operationinfo };
+      if (TENANT_KEY) datajson.header.tenantKey = TENANT_KEY;
+
+      return writeRequest(API_BASE + '/v2/updateFormData', {
+        userid: USER_ID,
+        datajson: datajson
+      }, state.appId).then(function (res) {
+        assertOk(res, '更新数据');
+        return true;
+      });
+    });
+  }
+
+  function remove(dataId) {
+    var datajson = {
+      header: { objId: state.objId },
+      mainTable: { id: String(dataId) },
+      operationinfo: { fieldNoFindIgnore: 'false' }
+    };
+    if (TENANT_KEY) datajson.header.tenantKey = TENANT_KEY;
+
+    return writeRequest(API_BASE + '/v2/deleteData', {
+      userid: USER_ID,
+      datajson: datajson
+    }, state.appId).then(function (res) {
+      assertOk(res, '删除数据');
+      return true;
+    });
+  }
+
+  return {
+    objId: state.objId,
+    appId: state.appId,
+    fields: fields,
+    options: loadOptions,
+    optionId: optionId,
+    optionIds: optionIds,
+    optionMap: optionMap,
+    list: list,
+    get: get,
+    save: save,
+    update: update,
+    remove: remove
+  };
+}
+
+/**
+ * 取得某个表单的数据客户端。同一 objId + appId 只创建一次，字段和选项缓存会复用。
+ * 在模块顶层调用一次，不要放在组件 render 里。
+ */
+export function formClient(input) {
+  var options = typeof input === 'string' ? { objId: input } : (input || {});
+  if (!options.objId) {
+    throw new Error('formClient 需要 objId，例如 formClient({ objId: OBJ_ID, appId: APP_ID })');
+  }
+  var key = String(options.objId) + '|' + String(options.appId || '');
+  if (!clients[key]) clients[key] = createClient(options);
+  return clients[key];
+}