openxiangda 1.0.0

package/packages/sdk/src/build-source/scripts/utils/form-api.mjs

@@ -0,0 +1,639 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getApiBaseUrl } from "./load-config.mjs";
+
+function readExportedStringConstant(filePath, exportName) {
+  if (!filePath || !fs.existsSync(filePath)) return "";
+  const content = fs.readFileSync(filePath, "utf-8");
+  const escaped = exportName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const match = content.match(
+    new RegExp(`export\\s+const\\s+${escaped}\\s*=\\s*(['"])(.*?)\\1`),
+  );
+  return match?.[2]?.trim() || "";
+}
+
+function resolveRelativeImportPath(schemaPath, source) {
+  if (!source.startsWith(".")) return "";
+  const basePath = path.resolve(path.dirname(schemaPath), source);
+  const candidates = [
+    basePath,
+    `${basePath}.ts`,
+    `${basePath}.tsx`,
+    `${basePath}.js`,
+    `${basePath}.mjs`,
+    path.join(basePath, "index.ts"),
+    path.join(basePath, "index.tsx"),
+    path.join(basePath, "index.js"),
+  ];
+  return candidates.find((candidate) => fs.existsSync(candidate)) || "";
+}
+
+function findImportedStringConstantSource(content, schemaPath, identifier) {
+  if (!schemaPath || !identifier) return "";
+  const importRegex = /import\s*\{([^}]+)\}\s*from\s*["']([^"']+)["']/g;
+  let match;
+  while ((match = importRegex.exec(content))) {
+    const specifiers = match[1]
+      .split(",")
+      .map((item) => item.trim())
+      .filter(Boolean);
+    const sourcePath = resolveRelativeImportPath(schemaPath, match[2]);
+    if (!sourcePath) continue;
+
+    for (const specifier of specifiers) {
+      const aliasMatch = specifier.match(
+        /^([A-Za-z_$][\w$]*)(?:\s+as\s+([A-Za-z_$][\w$]*))?$/,
+      );
+      if (!aliasMatch) continue;
+      const exportedName = aliasMatch[1];
+      const localName = aliasMatch[2] || exportedName;
+      if (localName !== identifier) continue;
+      return { sourcePath, exportedName };
+    }
+  }
+  return null;
+}
+
+function readImportedStringConstant(content, schemaPath, identifier) {
+  const imported = findImportedStringConstantSource(
+    content,
+    schemaPath,
+    identifier,
+  );
+  if (!imported) return "";
+  return readExportedStringConstant(imported.sourcePath, imported.exportedName);
+}
+
+function readPropIdentifier(content, propName) {
+  const escaped = propName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const identifierMatch = content.match(
+    new RegExp(`${escaped}\\s*:\\s*([A-Za-z_$][\\w$]*)`),
+  );
+  return identifierMatch?.[1] || "";
+}
+
+function writeStringConstant(filePath, identifier, value) {
+  const content = fs.readFileSync(filePath, "utf-8");
+  const escaped = identifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const nextContent = content.replace(
+    new RegExp(`((?:export\\s+)?const\\s+${escaped}\\s*=\\s*)([^;]+);`),
+    (_match, prefix, initializer) => {
+      const quote = initializer.trim().startsWith("'") ? "'" : '"';
+      return `${prefix}${quote}${value}${quote};`;
+    },
+  );
+  if (nextContent === content) return false;
+  fs.writeFileSync(filePath, nextContent, "utf-8");
+  return true;
+}
+
+export function writeSchemaStringProp(schemaPath, propName, value) {
+  const content = fs.readFileSync(schemaPath, "utf-8");
+  const escaped = propName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const literalRegex = new RegExp(
+    `(${escaped}\\s*:\\s*)(['"])([^'"]*)\\2`,
+  );
+  const literalNextContent = content.replace(
+    literalRegex,
+    (_match, prefix, quote) => `${prefix}${quote}${value}${quote}`,
+  );
+  if (literalNextContent !== content) {
+    fs.writeFileSync(schemaPath, literalNextContent, "utf-8");
+    return;
+  }
+
+  const identifier = readPropIdentifier(content, propName);
+  if (!identifier) {
+    throw new Error(`schema.ts 中未找到 ${propName} 字段，无法回写`);
+  }
+
+  if (writeStringConstant(schemaPath, identifier, value)) {
+    return;
+  }
+
+  const imported = findImportedStringConstantSource(
+    content,
+    schemaPath,
+    identifier,
+  );
+  if (
+    imported &&
+    writeStringConstant(imported.sourcePath, imported.exportedName, value)
+  ) {
+    return;
+  }
+
+  throw new Error(`schema.ts 中未找到可回写的 ${propName} 字段，无法回写`);
+}
+
+export function writeSchemaFormUuid(schemaPath, formUuid) {
+  writeSchemaStringProp(schemaPath, "formUuid", formUuid);
+}
+
+export function writeSchemaAppType(schemaPath, appType) {
+  writeSchemaStringProp(schemaPath, "appType", appType);
+}
+
+function resolveTargetAppType(config, meta) {
+  if (isOpenXiangdaMode(config)) {
+    return config.appType;
+  }
+  return meta.appType || config.appType;
+}
+
+function isStaleOpenXiangdaBinding(config, meta, targetAppType) {
+  return Boolean(
+    isOpenXiangdaMode(config) &&
+      meta.formUuid &&
+      meta.appType &&
+      meta.appType !== targetAppType,
+  );
+}
+
+function syncSchemaAppTypeIfNeeded(schemaPath, meta, targetAppType) {
+  if (!targetAppType || meta.appType === targetAppType) return;
+  if (!meta.appType && !meta.content.includes("appType")) return;
+  writeSchemaAppType(schemaPath, targetAppType);
+}
+
+function syncCreatedFormMeta(schemaPath, meta, targetAppType, formUuid) {
+  writeSchemaFormUuid(schemaPath, formUuid);
+  syncSchemaAppTypeIfNeeded(schemaPath, meta, targetAppType);
+}
+
+function readStringProp(content, propName, schemaPath) {
+  const escaped = propName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const literalMatch = content.match(
+    new RegExp(`${escaped}\\s*:\\s*(['"])(.*?)\\1`),
+  );
+  if (literalMatch) return literalMatch[2]?.trim() || "";
+
+  const identifier = readPropIdentifier(content, propName);
+  if (!identifier) return "";
+
+  const localConstMatch = content.match(
+    new RegExp(`(?:export\\s+)?const\\s+${identifier}\\s*=\\s*(['"])(.*?)\\1`),
+  );
+  if (localConstMatch) return localConstMatch[2]?.trim() || "";
+
+  return readImportedStringConstant(content, schemaPath, identifier);
+}
+
+function hasObjectProp(content, propName) {
+  const escaped = propName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`${escaped}\\s*:`).test(content);
+}
+
+export function readSchemaMeta(schemaPath) {
+  const content = fs.readFileSync(schemaPath, "utf-8");
+
+  return {
+    content,
+    hasFormUuidProp: hasObjectProp(content, "formUuid"),
+    formUuid: readStringProp(content, "formUuid", schemaPath),
+    appType: readStringProp(content, "appType", schemaPath),
+    title: readStringProp(content, "title", schemaPath),
+    formType: readStringProp(content, "formType", schemaPath) || "receipt",
+    relateUuid: readStringProp(content, "relateUuid", schemaPath),
+  };
+}
+
+export function assertRequiredOpenApiConfig(config) {
+  const missing = [];
+  if (!config.appType) missing.push("APP_TYPE");
+  if (!config.platformUrl) missing.push("APP_PLATFORM_URL");
+
+  if (isOpenXiangdaMode(config)) {
+    if (!config.openXiangdaAccessToken) {
+      missing.push("OPENXIANGDA_ACCESS_TOKEN");
+    }
+  } else {
+    if (!config.appKey) missing.push("APP_KEY");
+    if (!config.appSecret) missing.push("APP_SECRET");
+    if (!config.userId) missing.push("APP_USER_ID");
+  }
+
+  if (missing.length > 0) {
+    throw new Error(`缺少必要配置: ${missing.join(", ")}`);
+  }
+}
+
+export function isOpenXiangdaMode(config) {
+  return Boolean(config.openXiangdaAccessToken);
+}
+
+function getAuthHeaders(config, accessToken) {
+  if (isOpenXiangdaMode(config)) {
+    return {
+      Authorization: `Bearer ${accessToken || config.openXiangdaAccessToken}`,
+    };
+  }
+  return {
+    "x-acs-dingtalk-access-token": accessToken,
+  };
+}
+
+export async function getOpenApiAccessToken(config) {
+  assertRequiredOpenApiConfig(config);
+  if (isOpenXiangdaMode(config)) {
+    return config.openXiangdaAccessToken;
+  }
+
+  const apiBase = getApiBaseUrl(config);
+  const res = await fetch(`${apiBase}/dingtalk-api/v1.0/oauth2/accessToken`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      appKey: config.appKey,
+      appSecret: config.appSecret,
+    }),
+  });
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (!res.ok || !body?.accessToken) {
+    const message = body?.message || res.statusText || "unknown error";
+    throw new Error(`获取 accessToken 失败: HTTP ${res.status} ${message}`);
+  }
+
+  return body.accessToken;
+}
+
+export async function createOpenApiForm(config, accessToken, formOptions) {
+  assertRequiredOpenApiConfig(config);
+
+  const apiBase = getApiBaseUrl(config);
+  const targetAppType = formOptions.appType || config.appType;
+  const payload = {
+    name: formOptions.name,
+    formType: formOptions.formType || "receipt",
+    relateUuid: formOptions.relateUuid || "",
+  };
+  const builderVersion =
+    formOptions.builderVersion || config.defaults?.formBuilderVersion || "2.0";
+  if (
+    builderVersion === "2.0" &&
+    ["receipt", "process"].includes(String(payload.formType || ""))
+  ) {
+    payload.builderVersion = "2.0";
+  }
+  if (formOptions.formUuid) {
+    payload.formUuid = formOptions.formUuid;
+  }
+
+  if (isOpenXiangdaMode(config)) {
+    payload.createMenu = formOptions.createMenu !== false;
+    payload.menuParentId = config.menu?.parentId || "";
+    payload.menuIcon = config.menu?.icon || "";
+  } else {
+    payload.userId = config.userId;
+    payload.appType = targetAppType;
+  }
+
+  const url = isOpenXiangdaMode(config)
+    ? `${apiBase}/openxiangda-api/v1/apps/${encodeURIComponent(targetAppType)}/forms`
+    : `${apiBase}/dingtalk-api/v1.0/forms/createForm`;
+
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      ...getAuthHeaders(config, accessToken),
+    },
+    body: JSON.stringify(payload),
+  });
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (!res.ok || body?.code !== 200) {
+    const message = body?.message || res.statusText || "unknown error";
+    throw new Error(`创建表单失败: HTTP ${res.status} ${message}`);
+  }
+
+  const data = body?.data?.form || body?.data || body;
+  const formUuid = data?.formUuid;
+  if (!formUuid) {
+    throw new Error("创建表单成功但响应中没有 formUuid");
+  }
+
+  return {
+    ...data,
+    formUuid,
+  };
+}
+
+export async function listOpenApiForms(config, accessToken, appType) {
+  assertRequiredOpenApiConfig(config);
+
+  const apiBase = getApiBaseUrl(config);
+  const targetAppType = appType || config.appType;
+  const url = isOpenXiangdaMode(config)
+    ? `${apiBase}/openxiangda-api/v1/apps/${encodeURIComponent(targetAppType)}/forms`
+    : `${apiBase}/dingtalk-api/v1.0/forms/getFormList`;
+  const res = await fetch(url, {
+    method: isOpenXiangdaMode(config) ? "GET" : "POST",
+    headers: {
+      "Content-Type": "application/json",
+      ...getAuthHeaders(config, accessToken),
+    },
+    body: isOpenXiangdaMode(config)
+      ? undefined
+      : JSON.stringify({
+          userId: config.userId,
+          appType: targetAppType,
+        }),
+  });
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (!res.ok || body?.code !== 200) {
+    const message = body?.message || res.statusText || "unknown error";
+    throw new Error(`查询表单失败: HTTP ${res.status} ${message}`);
+  }
+
+  return Array.isArray(body?.data) ? body.data : Array.isArray(body) ? body : [];
+}
+
+export async function getOpenApiForm(
+  config,
+  accessToken,
+  { appType, formUuid },
+) {
+  if (!formUuid) return null;
+  const forms = await listOpenApiForms(
+    config,
+    accessToken,
+    appType || config.appType,
+  );
+  return (
+    forms.find(
+      (item) =>
+        item?.formUuid === formUuid &&
+        (!appType || !item?.appType || item.appType === appType),
+    ) || null
+  );
+}
+
+export async function listOpenApiMenus(config, accessToken, appType) {
+  assertRequiredOpenApiConfig(config);
+
+  const apiBase = getApiBaseUrl(config);
+  const targetAppType = appType || config.appType;
+  const url = isOpenXiangdaMode(config)
+    ? `${apiBase}/openxiangda-api/v1/apps/${encodeURIComponent(targetAppType)}/menus`
+    : `${apiBase}/dingtalk-api/v1.0/forms/getMenusByAppType`;
+  const res = await fetch(url, {
+    method: isOpenXiangdaMode(config) ? "GET" : "POST",
+    headers: {
+      "Content-Type": "application/json",
+      ...getAuthHeaders(config, accessToken),
+    },
+    body: isOpenXiangdaMode(config)
+      ? undefined
+      : JSON.stringify({
+          userId: config.userId,
+          appType: targetAppType,
+        }),
+  });
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (!res.ok || body?.code !== 200) {
+    const message = body?.message || res.statusText || "unknown error";
+    throw new Error(`查询菜单失败: HTTP ${res.status} ${message}`);
+  }
+
+  return Array.isArray(body?.data) ? body.data : Array.isArray(body) ? body : [];
+}
+
+function flattenMenus(menus) {
+  const result = [];
+  const visit = (menu) => {
+    result.push(menu);
+    if (Array.isArray(menu.children)) {
+      for (const child of menu.children) {
+        visit(child);
+      }
+    }
+  };
+
+  for (const menu of menus) {
+    visit(menu);
+  }
+
+  return result;
+}
+
+export async function ensureOpenApiMenuForForm(
+  config,
+  accessToken,
+  { appType, formUuid, name, formType = "receipt", parentId = "", icon = "" },
+) {
+  assertRequiredOpenApiConfig(config);
+
+  const targetAppType = appType || config.appType;
+  const menus = flattenMenus(
+    await listOpenApiMenus(config, accessToken, targetAppType),
+  );
+  const existing = menus.find((menu) => menu.formUuid === formUuid);
+  if (existing) {
+    return {
+      created: false,
+      menu: existing,
+    };
+  }
+
+  if (isOpenXiangdaMode(config)) {
+    return {
+      created: false,
+      menu: null,
+    };
+  }
+
+  const apiBase = getApiBaseUrl(config);
+  const payload = {
+    userId: config.userId,
+    appType: targetAppType,
+    name,
+    type: formType || "receipt",
+    formUuid,
+    parentId: parentId || null,
+    icon: icon || null,
+  };
+
+  const res = await fetch(`${apiBase}/dingtalk-api/v1.0/forms/menu/create`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-acs-dingtalk-access-token": accessToken,
+    },
+    body: JSON.stringify(payload),
+  });
+
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+
+  if (!res.ok || body?.code !== 200) {
+    const message = body?.message || res.statusText || "unknown error";
+    throw new Error(`创建菜单失败: HTTP ${res.status} ${message}`);
+  }
+
+  return {
+    created: true,
+    menu: body.data,
+  };
+}
+
+export async function ensureSchemaFormUuid({
+  config,
+  schemaPath,
+  formName,
+  accessToken,
+  dryRun = false,
+  ensureMenu = false,
+}) {
+  const meta = readSchemaMeta(schemaPath);
+  const targetAppType = resolveTargetAppType(config, meta);
+  const staleOpenXiangdaBinding = isStaleOpenXiangdaBinding(
+    config,
+    meta,
+    targetAppType,
+  );
+
+  if (meta.formUuid && !staleOpenXiangdaBinding) {
+    let created = false;
+    if (!dryRun) {
+      const token = accessToken || (await getOpenApiAccessToken(config));
+      const existingForm = await getOpenApiForm(config, token, {
+        appType: targetAppType,
+        formUuid: meta.formUuid,
+      });
+
+      if (!existingForm) {
+        await createOpenApiForm(config, token, {
+          name: meta.title || formName,
+          appType: targetAppType,
+          formType: meta.formType || "receipt",
+          relateUuid: meta.relateUuid,
+          formUuid: meta.formUuid,
+          builderVersion: config.defaults?.formBuilderVersion || "2.0",
+        });
+        created = true;
+        console.log(
+          `  ✓ ${formName}: 已按 schema formUuid 创建表单 ${meta.formUuid}`,
+        );
+      }
+
+      if ((created || ensureMenu) && !isOpenXiangdaMode(config)) {
+        const menuResult = await ensureOpenApiMenuForForm(config, token, {
+          appType: targetAppType,
+          formUuid: meta.formUuid,
+          name: meta.title || formName,
+          formType: meta.formType || "receipt",
+          parentId: config.menu?.parentId,
+          icon: config.menu?.icon,
+        });
+
+        if (menuResult.created) {
+          console.log(
+            `  ✓ ${formName}: 已创建菜单 ${menuResult.menu?.id || ""}`,
+          );
+        }
+      }
+    }
+
+    return {
+      ...meta,
+      appType: targetAppType,
+      created,
+      dryRunCreated: false,
+    };
+  }
+
+  if (!meta.hasFormUuidProp) {
+    throw new Error(
+      `${formName}: schema.ts 中未找到 formUuid 字段，无法自动创建并回写`,
+    );
+  }
+
+  const createOptions = {
+    name: meta.title || formName,
+    appType: targetAppType,
+    formType: meta.formType || "receipt",
+    relateUuid: meta.relateUuid,
+    formUuid: staleOpenXiangdaBinding ? undefined : meta.formUuid || undefined,
+    builderVersion: config.defaults?.formBuilderVersion || "2.0",
+  };
+
+  if (dryRun) {
+    console.log(
+      `  [dry-run] ${formName}: ${
+        staleOpenXiangdaBinding ? "检测到旧 appType 绑定" : "formUuid 为空"
+      }，将创建表单和菜单 "${createOptions.name}"`,
+    );
+    return {
+      ...meta,
+      ...createOptions,
+      formUuid: "<auto-created-formUuid>",
+      created: false,
+      dryRunCreated: true,
+    };
+  }
+
+  const token = accessToken || (await getOpenApiAccessToken(config));
+  const createdForm = await createOpenApiForm(config, token, createOptions);
+  syncCreatedFormMeta(schemaPath, meta, targetAppType, createdForm.formUuid);
+  console.log(`  ✓ ${formName}: 已创建表单 ${createdForm.formUuid}`);
+
+  let menuResult = { created: false, menu: null };
+  if (!isOpenXiangdaMode(config)) {
+    menuResult = await ensureOpenApiMenuForForm(config, token, {
+      appType: createOptions.appType,
+      formUuid: createdForm.formUuid,
+      name: createOptions.name,
+      formType: createOptions.formType,
+      parentId: config.menu?.parentId,
+      icon: config.menu?.icon,
+    });
+    if (menuResult.created) {
+      console.log(`  ✓ ${formName}: 已创建菜单 ${menuResult.menu?.id || ""}`);
+    } else {
+      console.log(`  ✓ ${formName}: 菜单已存在 ${menuResult.menu?.id || ""}`);
+    }
+  }
+
+  return {
+    ...meta,
+    ...createOptions,
+    formUuid: createdForm.formUuid,
+    created: true,
+    menuCreated: menuResult.created,
+    dryRunCreated: false,
+  };
+}