sy-lowcode-workspace-tools 0.1.0

package/scripts/utils/form-api.mjs

@@ -0,0 +1,482 @@
+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 readImportedStringConstant(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;
+      const value = readExportedStringConstant(sourcePath, exportedName);
+      if (value) return value;
+    }
+  }
+  return "";
+}
+
+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 identifierMatch = content.match(
+    new RegExp(`${escaped}\\s*:\\s*([A-Za-z_$][\\w$]*)`),
+  );
+  const identifier = identifierMatch?.[1];
+  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 writeSchemaFormUuid(schemaPath, formUuid) {
+  const content = fs.readFileSync(schemaPath, "utf-8");
+  const nextContent = content.replace(
+    /formUuid\s*:\s*(['"])([^'"]*)\1/,
+    (_match, quote) => `formUuid: ${quote}${formUuid}${quote}`,
+  );
+
+  if (nextContent === content) {
+    throw new Error("schema.ts 中未找到 formUuid 字段，无法回写");
+  }
+
+  fs.writeFileSync(schemaPath, nextContent, "utf-8");
+}
+
+export function assertRequiredOpenApiConfig(config) {
+  const missing = [];
+  if (!config.appType) missing.push("APP_TYPE");
+  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 async function getOpenApiAccessToken(config) {
+  assertRequiredOpenApiConfig(config);
+
+  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 payload = {
+    userId: config.userId,
+    name: formOptions.name,
+    appType: formOptions.appType || config.appType,
+    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;
+  }
+
+  const res = await fetch(`${apiBase}/dingtalk-api/v1.0/forms/createForm`, {
+    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}`);
+  }
+
+  const formUuid = body?.data?.formUuid || body?.formUuid;
+  if (!formUuid) {
+    throw new Error("创建表单成功但响应中没有 formUuid");
+  }
+
+  return {
+    ...body.data,
+    formUuid,
+  };
+}
+
+export async function listOpenApiForms(config, accessToken, appType) {
+  assertRequiredOpenApiConfig(config);
+
+  const apiBase = getApiBaseUrl(config);
+  const res = await fetch(`${apiBase}/dingtalk-api/v1.0/forms/getFormList`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-acs-dingtalk-access-token": accessToken,
+    },
+    body: JSON.stringify({
+      userId: config.userId,
+      appType: appType || config.appType,
+    }),
+  });
+
+  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 : [];
+}
+
+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 res = await fetch(
+    `${apiBase}/dingtalk-api/v1.0/forms/getMenusByAppType`,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-acs-dingtalk-access-token": accessToken,
+      },
+      body: JSON.stringify({
+        userId: config.userId,
+        appType: appType || config.appType,
+      }),
+    },
+  );
+
+  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 : [];
+}
+
+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,
+    };
+  }
+
+  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 = true,
+}) {
+  const meta = readSchemaMeta(schemaPath);
+  if (meta.formUuid) {
+    let created = false;
+    if (!dryRun && ensureMenu) {
+      const token = accessToken || (await getOpenApiAccessToken(config));
+      const appType = meta.appType || config.appType;
+      const existingForm = await getOpenApiForm(config, token, {
+        appType,
+        formUuid: meta.formUuid,
+      });
+
+      if (!existingForm) {
+        await createOpenApiForm(config, token, {
+          name: meta.title || formName,
+          appType,
+          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}`,
+        );
+      }
+
+      const menuResult = await ensureOpenApiMenuForForm(config, token, {
+        appType,
+        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,
+      created,
+      dryRunCreated: false,
+    };
+  }
+
+  if (!meta.hasFormUuidProp) {
+    throw new Error(
+      `${formName}: schema.ts 中未找到 formUuid 字段，无法自动创建并回写`,
+    );
+  }
+
+  const createOptions = {
+    name: meta.title || formName,
+    appType: meta.appType || config.appType,
+    formType: meta.formType || "receipt",
+    relateUuid: meta.relateUuid,
+    formUuid: meta.formUuid || undefined,
+    builderVersion: config.defaults?.formBuilderVersion || "2.0",
+  };
+
+  if (dryRun) {
+    console.log(
+      `  [dry-run] ${formName}: 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);
+  writeSchemaFormUuid(schemaPath, createdForm.formUuid);
+  console.log(`  ✓ ${formName}: 已创建表单 ${createdForm.formUuid}`);
+
+  const 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,
+  };
+}

package/scripts/utils/load-config.mjs

@@ -0,0 +1,210 @@
+import { config as dotenvConfig } from "dotenv";
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+
+export const rootDir = resolve(process.env.LOWCODE_WORKSPACE_ROOT || process.cwd());
+
+/**
+ * 标准化 OSS 路径前缀，去除前后斜杠
+ * @param {string|undefined} pathPrefix
+ * @returns {string}
+ */
+function normalizePathPrefix(pathPrefix) {
+  return String(pathPrefix || "app-workspace").replace(/^\/+|\/+$/g, "");
+}
+
+/**
+ * 解析逗号分隔的字符串为数组
+ * @param {string|undefined} value
+ * @param {string} [fallback]
+ * @returns {string[]}
+ */
+function parseCsv(value, fallback) {
+  return String(value || fallback || "")
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+function getDefaultCorsOrigin(platformUrl) {
+  try {
+    return new URL(platformUrl).origin;
+  } catch {
+    return "*";
+  }
+}
+
+function createBuildId() {
+  return new Date().toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
+}
+
+function normalizeBaseUrl(value) {
+  return String(value || "").replace(/\/+$/, "");
+}
+
+async function loadConfigModule() {
+  const configPath = resolve(rootDir, "app-workspace.config.ts");
+  const loaded = await import(pathToFileURL(configPath).href);
+  return loaded.default || loaded;
+}
+
+/**
+ * 加载并合并应用配置（文件 + 环境变量）
+ * @returns {Promise<object>} 合并后的应用配置对象
+ */
+export async function loadConfig() {
+  const mode = process.env.APP_MODE || "development";
+
+  if (mode !== "development") {
+    dotenvConfig({ path: resolve(rootDir, `.env.${mode}`) });
+  }
+  dotenvConfig({ path: resolve(rootDir, ".env") });
+
+  const source = await loadConfigModule();
+  const platformUrl = source.platformUrl || process.env.APP_PLATFORM_URL;
+  const explicitBuildId = Boolean(source.buildId || process.env.APP_BUILD_ID);
+
+  const normalized = {
+    ...source,
+    appType: source.appType || process.env.APP_TYPE,
+    appName: source.appName || process.env.APP_NAME || "低代码应用",
+    platformUrl,
+    servicePrefix: source.servicePrefix || process.env.APP_SERVICE_PREFIX || "/service",
+    appKey: source.appKey || process.env.APP_KEY,
+    appSecret: source.appSecret || process.env.APP_SECRET,
+    userId: source.userId || process.env.APP_USER_ID,
+    version: source.version || process.env.APP_VERSION || "0.1.0",
+    buildId: source.buildId || process.env.APP_BUILD_ID || createBuildId(),
+    buildIdExplicit: explicitBuildId,
+    oss: {
+      ...(source.oss || {}),
+      region: source.oss?.region || process.env.APP_OSS_REGION,
+      bucket: source.oss?.bucket || process.env.APP_OSS_BUCKET,
+      accessKeyId:
+        source.oss?.accessKeyId || process.env.APP_OSS_ACCESS_KEY_ID,
+      accessKeySecret:
+        source.oss?.accessKeySecret || process.env.APP_OSS_ACCESS_KEY_SECRET,
+      pathPrefix: normalizePathPrefix(
+        source.oss?.pathPrefix || process.env.APP_OSS_PATH_PREFIX,
+      ),
+      corsOrigins: parseCsv(
+        process.env.APP_OSS_CORS_ORIGINS,
+        getDefaultCorsOrigin(platformUrl),
+      ),
+      skipCors: process.env.APP_OSS_SKIP_CORS === "1" || source.oss?.skipCors,
+    },
+    defaults: {
+      protocolVersion:
+        source.defaults?.protocolVersion ||
+        process.env.APP_PAGE_PROTOCOL_VERSION ||
+        "1.0",
+      frameworkVersion:
+        source.defaults?.frameworkVersion ||
+        process.env.APP_FRAMEWORK_VERSION ||
+        "19.0.0",
+      cssIsolation:
+        source.defaults?.cssIsolation === "none" ||
+        process.env.APP_PAGE_CSS_ISOLATION === "none"
+          ? "none"
+          : "shadow",
+      formMenuParentId:
+        source.defaults?.formMenuParentId ||
+        process.env.APP_FORM_MENU_PARENT_ID ||
+        "",
+      formMenuIcon:
+        source.defaults?.formMenuIcon || process.env.APP_FORM_MENU_ICON || "",
+      pageMenuParentId:
+        source.defaults?.pageMenuParentId ||
+        process.env.APP_PAGE_MENU_PARENT_ID ||
+        "",
+      pageMenuIcon:
+        source.defaults?.pageMenuIcon || process.env.APP_PAGE_MENU_ICON || "",
+      formBuilderVersion:
+        source.defaults?.formBuilderVersion ||
+        process.env.APP_FORM_BUILDER_VERSION ||
+        "2.0",
+    },
+  };
+
+  return {
+    ...normalized,
+    menu: {
+      parentId: normalized.defaults.formMenuParentId,
+      icon: normalized.defaults.formMenuIcon,
+    },
+  };
+}
+
+/**
+ * 获取后端 API 基础 URL
+ * @param {object} config - 应用配置对象
+ * @returns {string}
+ */
+export function getApiBaseUrl(config) {
+  return `${normalizeBaseUrl(config.platformUrl)}${config.servicePrefix}`;
+}
+
+/**
+ * 获取 OSS 公网访问基础 URL
+ * @param {object} config - 应用配置对象
+ * @returns {string}
+ */
+export function getPublicBaseUrl(config) {
+  return `https://${config.oss.bucket}.${config.oss.region}.aliyuncs.com/${config.oss.pathPrefix}/${config.version}/${config.buildId}`;
+}
+
+/**
+ * 获取表单 bundle 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} formName - 表单名
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getFormBundleUrl(config, formName, fileName) {
+  return `${getPublicBaseUrl(config)}/forms/${formName}/${fileName}`;
+}
+
+/**
+ * 获取表单共享 runtime 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getFormRuntimeUrl(config, fileName) {
+  return `${getPublicBaseUrl(config)}/form-runtime/${fileName}`;
+}
+
+/**
+ * 获取代码页资源基础 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} pageCode - 页面编码
+ * @returns {string}
+ */
+export function getPageAssetBaseUrl(config, pageCode) {
+  return `${getPublicBaseUrl(config)}/pages/${pageCode}`;
+}
+
+/**
+ * 获取代码页指定资源的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} pageCode - 页面编码
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getPageAssetUrl(config, pageCode, fileName) {
+  return `${getPageAssetBaseUrl(config, pageCode)}/${fileName}`;
+}
+
+/**
+ * 获取代码页共享 runtime 文件的公网 URL
+ * @param {object} config - 应用配置对象
+ * @param {string} fileName - 文件名
+ * @returns {string}
+ */
+export function getPageRuntimeUrl(config, fileName) {
+  return `${getPublicBaseUrl(config)}/page-runtime/${fileName}`;
+}
+
+export function getBundleOSSUrl(config, formName, fileName) {
+  return getFormBundleUrl(config, formName, fileName);
+}