sy-lowcode-workspace-tools 0.1.0

package/scripts/build-workspace.mjs

@@ -0,0 +1,59 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { rootDir } from "./utils/load-config.mjs";
+
+const require = createRequire(import.meta.url);
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const tsxCli = require.resolve("tsx/cli");
+const args = process.argv.slice(2).filter((arg) => arg !== "--");
+const forwardedArgs = [];
+
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(`
+build - 构建表单页和代码页
+
+用法:
+  lowcode-workspace build [options]
+
+选项:
+  --bundle-mode       shared 或 self-contained，默认 shared
+  --no-runtime-cache  强制重建共享 runtime
+  --help, -h          显示帮助信息
+`);
+  process.exit(0);
+}
+
+for (let index = 0; index < args.length; index += 1) {
+  const arg = args[index];
+  if (arg === "--bundle-mode" && args[index + 1]) {
+    forwardedArgs.push(arg, args[index + 1]);
+    index += 1;
+    continue;
+  }
+  if (arg === "--no-runtime-cache") {
+    forwardedArgs.push(arg);
+  }
+}
+
+const runScript = (scriptName, args) =>
+  new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [tsxCli, path.join(scriptDir, scriptName), ...args], {
+      cwd: rootDir,
+      env: process.env,
+      shell: false,
+      stdio: "inherit",
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${scriptName} ${args.join(" ")} exited with code ${code}`));
+    });
+  });
+
+await runScript("build-forms.mjs", forwardedArgs);
+await runScript("build-pages.mjs", forwardedArgs);

package/scripts/publish-all.mjs

@@ -0,0 +1,111 @@
+/**
+ * publish-all.mjs - 统一执行 schema 同步、构建、OSS 发布和平台注册。
+ *
+ * 关键点：在同一个进程里生成一次 APP_BUILD_ID，并传给所有子脚本，
+ * 避免上传路径和注册 URL 因跨进程默认 buildId 不一致而错位。
+ */
+
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import minimist from "minimist";
+import { rootDir } from "./utils/load-config.mjs";
+
+const require = createRequire(import.meta.url);
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const tsxCli = require.resolve("tsx/cli");
+
+/**
+ * 生成时间戳格式的构建ID
+ * @returns {string} 格式如 20260516120000
+ */
+function createBuildId() {
+  return new Date().toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
+}
+
+const args = minimist(process.argv.slice(2).filter((arg) => arg !== "--"));
+const dryRun = Boolean(args["dry-run"]);
+const targetForm = args.form || "";
+const targetPage = args.page || "";
+const bundleModeArgs = args["bundle-mode"]
+  ? ["--bundle-mode", String(args["bundle-mode"])]
+  : [];
+
+if (args.help || args.h) {
+  console.log(`
+publish-all - 同步、构建、上传并注册应用工作区产物
+
+用法:
+  tsx scripts/publish-all.mjs [options]
+
+选项:
+  --dry-run        schema、OSS、注册均只打印计划，不调用写接口
+  --form <name>    只发布指定表单
+  --page <name>    只发布指定代码页
+  --bundle-mode    shared 或 self-contained，默认 shared
+  --help, -h       显示帮助信息
+`);
+  process.exit(0);
+}
+
+if (targetForm && targetPage) {
+  console.error("❌ --form 和 --page 不能同时使用，请分两次发布");
+  process.exit(1);
+}
+
+const buildId = process.env.APP_BUILD_ID || createBuildId();
+const childEnv = {
+  ...process.env,
+  APP_BUILD_ID: buildId,
+};
+
+/**
+ * 执行子脚本
+ * @param {string} script - 脚本路径
+ * @param {string[]} [scriptArgs] - 脚本参数
+ * @returns {Promise<void>}
+ */
+function run(script, scriptArgs = []) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [tsxCli, path.join(scriptDir, script), ...scriptArgs], {
+      cwd: rootDir,
+      env: childEnv,
+      shell: false,
+      stdio: "inherit",
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`${script} ${scriptArgs.join(" ")} exited with code ${code}`));
+    });
+  });
+}
+
+const maybeDryRun = dryRun ? ["--dry-run"] : [];
+
+console.log(`🚀 发布应用工作区 (${dryRun ? "DRY RUN" : "LIVE"})`);
+console.log(`   APP_BUILD_ID=${buildId}`);
+console.log("");
+
+if (targetPage) {
+  await run("build-pages.mjs", ["--page", targetPage, ...bundleModeArgs]);
+  await run("publish-oss.mjs", ["--page", targetPage, ...maybeDryRun]);
+  await run("register.mjs", ["--page", targetPage, ...maybeDryRun]);
+} else if (targetForm) {
+  await run("sync-schema.mjs", ["--form", targetForm, ...maybeDryRun]);
+  await run("build-forms.mjs", ["--form", targetForm, ...bundleModeArgs]);
+  await run("publish-oss.mjs", ["--form", targetForm, ...maybeDryRun]);
+  await run("register.mjs", ["--form", targetForm, ...maybeDryRun]);
+} else {
+  await run("sync-schema.mjs", maybeDryRun);
+  await run("build-workspace.mjs", bundleModeArgs);
+  await run("publish-oss.mjs", maybeDryRun);
+  await run("register.mjs", maybeDryRun);
+}
+
+console.log("");
+console.log(`✅ 发布流程完成，buildId=${buildId}`);

package/scripts/publish-oss.mjs

@@ -0,0 +1,143 @@
+/**
+ * publish-oss.mjs - 上传应用工作区构建产物到阿里云 OSS
+ *
+ * 功能特性：
+ * - 完整 MIME 类型识别（JS/CSS/图片/字体等）
+ * - 基于文件名 hash 的差异化 Cache-Control 策略
+ * - 并行上传（p-limit 控制并发数）
+ * - 失败自动重试
+ * - 上传进度与统计报告
+ */
+
+import { glob } from "glob";
+import path from "node:path";
+import minimist from "minimist";
+import pLimit from "p-limit";
+import { loadConfig, rootDir } from "./utils/load-config.mjs";
+import { getContentType, getCacheControl } from "./utils/mime-types.mjs";
+import { createOSSClient, uploadWithRetry, ensureBucketCors } from "./utils/oss-client.mjs";
+import { createProgressTracker } from "./utils/progress.mjs";
+
+const args = minimist(process.argv.slice(2).filter((arg) => arg !== "--"));
+const dryRun = Boolean(args["dry-run"]);
+const targetForm = args.form || null;
+const targetPage = args.page || null;
+
+if (args.help || args.h) {
+  console.log(`
+publish-oss - 发布应用工作区产物到阿里云 OSS
+
+用法:
+  tsx scripts/publish-oss.mjs [options]
+
+选项:
+  --dry-run        只打印上传计划，不实际上传
+  --form <name>    只上传指定表单
+  --page <name>    只上传指定代码页
+  --help, -h       显示帮助信息
+`);
+  process.exit(0);
+}
+
+const config = await loadConfig();
+
+if (!dryRun && !config.buildIdExplicit) {
+  console.error(
+    "❌ 单独执行 publish:oss 时必须设置 APP_BUILD_ID；推荐使用 pnpm publish:all 统一发布。",
+  );
+  process.exit(1);
+}
+
+if (
+  !dryRun &&
+  (!config.oss.accessKeyId || config.oss.accessKeyId.startsWith("your_"))
+) {
+  console.error("❌ 请先配置 OSS 密钥（.env 文件中的 APP_OSS_* 字段）");
+  process.exit(1);
+}
+
+const client = dryRun ? null : createOSSClient(config.oss);
+
+/**
+ * 构建文件扫描 glob 模式
+ * @returns {string} glob 模式
+ */
+function buildPattern() {
+  if (targetForm) return `{form-runtime/**/*,forms/${targetForm}/**/*}`;
+  if (targetPage) return `{page-runtime/**/*,pages/${targetPage}/**/*}`;
+  return "{form-runtime,page-runtime,forms,pages}/**/*";
+}
+
+const distDir = path.resolve(rootDir, "dist");
+const files = (await glob(buildPattern(), { cwd: distDir, nodir: true })).filter(
+  (file) => !file.endsWith("/build-cache.json"),
+);
+
+if (files.length === 0) {
+  console.error("❌ 没有找到构建产物。请先运行 pnpm build");
+  process.exit(1);
+}
+
+const remoteRoot = `${config.oss.pathPrefix}/${config.version}/${config.buildId}`;
+
+console.log(
+  `📦 准备上传 ${files.length} 个文件到 OSS (${dryRun ? "DRY RUN" : "LIVE"})`,
+);
+console.log(`   Bucket: ${config.oss.bucket}`);
+console.log(`   Path: ${remoteRoot}/`);
+console.log("");
+
+// ---------- Dry-run 模式 ----------
+
+if (dryRun) {
+  for (const file of files) {
+    const ossKey = `${remoteRoot}/${file}`;
+    const mime = getContentType(file);
+    const cache = getCacheControl(file);
+    console.log(`  [DRY] ${ossKey}  (${mime}, ${cache})`);
+  }
+  console.log(`\n✅ 预览完成（${files.length} 个文件）`);
+  process.exit(0);
+}
+
+// ---------- 实际上传 ----------
+
+await ensureBucketCors(client, config.oss);
+console.log("");
+
+const limit = pLimit(5); // 最多 5 个并发上传
+const tracker = createProgressTracker(files.length);
+
+const results = await Promise.allSettled(
+  files.map((file) =>
+    limit(async () => {
+      const ossKey = `${remoteRoot}/${file}`;
+      const localPath = path.join(distDir, file);
+      const headers = {
+        "Cache-Control": getCacheControl(file),
+        "Content-Type": getContentType(file),
+      };
+
+      await uploadWithRetry(client, ossKey, localPath, headers);
+      tracker.tick(ossKey, localPath);
+    }),
+  ),
+);
+
+// 报告失败项
+const failures = results.filter((r) => r.status === "rejected");
+if (failures.length > 0) {
+  console.error(`\n⚠ ${failures.length} 个文件上传失败:`);
+  for (const f of failures) {
+    console.error(`  - ${f.reason?.message || f.reason}`);
+  }
+}
+
+tracker.summary();
+
+const successCount = results.filter((r) => r.status === "fulfilled").length;
+console.log(`\n✅ 上传完成（${successCount}/${files.length} 成功）`);
+
+if (failures.length > 0) {
+  process.exit(1);
+}

package/scripts/register-bundle.mjs

@@ -0,0 +1 @@
+import "./register.mjs";

package/scripts/register.mjs

@@ -0,0 +1,242 @@
+/**
+ * register.mjs - 注册表单 bundle 和复杂代码页到平台
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { glob } from "glob";
+import minimist from "minimist";
+import {
+  getApiBaseUrl,
+  getFormBundleUrl,
+  getFormRuntimeUrl,
+  loadConfig,
+  rootDir,
+} from "./utils/load-config.mjs";
+import { discoverPages } from "./utils/pages.mjs";
+import { buildDirectPagePublishPayload } from "./utils/register-payload.mjs";
+import {
+  ensureSchemaFormUuid,
+  getOpenApiAccessToken,
+  getOpenApiForm,
+} from "./utils/form-api.mjs";
+import { assertFormReadyForBundle } from "./utils/schema-transform.mjs";
+
+const args = minimist(process.argv.slice(2).filter((arg) => arg !== "--"));
+const dryRun = Boolean(args["dry-run"]);
+const targetForm = args.form || null;
+const targetPage = args.page || null;
+
+if (args.help || args.h) {
+  console.log(`
+register - 注册应用工作区产物到平台
+
+用法:
+  tsx scripts/register.mjs [options]
+
+选项:
+  --dry-run        只打印注册计划，不实际调用 API
+  --form <name>    只注册指定表单
+  --page <name>    只注册指定代码页目录
+  --help, -h       显示帮助信息
+`);
+  process.exit(0);
+}
+
+const config = await loadConfig();
+const apiBase = getApiBaseUrl(config);
+let accessToken = null;
+
+if (!dryRun && !config.buildIdExplicit) {
+  console.error(
+    "❌ 单独执行 register 时必须设置 APP_BUILD_ID；推荐使用 pnpm publish:all 统一发布。",
+  );
+  process.exit(1);
+}
+
+async function getAccessToken() {
+  if (!accessToken) {
+    accessToken = await getOpenApiAccessToken(config);
+  }
+  return accessToken;
+}
+
+async function registerForms() {
+  const formDirs = await glob(targetForm ? targetForm : "*", {
+    cwd: path.resolve(rootDir, "src/forms"),
+    onlyDirectories: true,
+  });
+
+  let succeeded = 0;
+  let failed = 0;
+  let created = 0;
+
+  for (const formName of formDirs) {
+    const schemaPath = path.resolve(rootDir, `src/forms/${formName}/schema.ts`);
+    if (!fs.existsSync(schemaPath)) {
+      console.log(`  ⊘ 表单 ${formName}: 无 schema.ts，跳过注册`);
+      continue;
+    }
+
+    let formUuid;
+    let appType;
+    try {
+      const ensured = await ensureSchemaFormUuid({
+        config,
+        schemaPath,
+        formName,
+        accessToken: dryRun ? null : await getAccessToken(),
+        dryRun,
+      });
+      formUuid = ensured.formUuid;
+      appType = ensured.appType || config.appType;
+      if (ensured.created || ensured.dryRunCreated) created += 1;
+    } catch (error) {
+      console.error(`  ✗ 表单 ${formName}: ${error.message}`);
+      failed += 1;
+      continue;
+    }
+
+    if (!dryRun) {
+      try {
+        const formMeta = await getOpenApiForm(config, await getAccessToken(), {
+          appType,
+          formUuid,
+        });
+        assertFormReadyForBundle(formMeta, formName);
+      } catch (error) {
+        console.error(`  ✗ 表单 ${formName}: ${error.message}`);
+        failed += 1;
+        continue;
+      }
+    }
+
+    const payload = {
+      appType,
+      formUuid,
+      userId: config.userId,
+      bundleUrl: getFormBundleUrl(config, formName, "index.js"),
+      cssUrl: getFormBundleUrl(config, formName, "style.css"),
+      version: config.version,
+    };
+    const runtime = readFormRuntimeAssets(config);
+    if (runtime) {
+      payload.runtimeMode = "shared";
+      payload.runtime = runtime;
+    }
+
+    if (dryRun) {
+      console.log(`  [DRY] 表单 ${formName} (${formUuid})`);
+      console.log(`        → ${payload.bundleUrl}`);
+      console.log(`        → ${payload.cssUrl}`);
+      if (payload.runtime) {
+        console.log(`        runtime → ${payload.runtime.entryUrl}`);
+        if (payload.runtime.cssUrl) {
+          console.log(`        runtime → ${payload.runtime.cssUrl}`);
+        }
+      }
+      succeeded += 1;
+      continue;
+    }
+
+    const response = await fetch(`${apiBase}/dingtalk-api/v1.0/forms/customPage/publish`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-acs-dingtalk-access-token": await getAccessToken(),
+      },
+      body: JSON.stringify(payload),
+    });
+    const body = await response.json().catch(() => null);
+    if (!response.ok || body?.code !== 200) {
+      console.error(
+        `  ✗ 表单 ${formName}: HTTP ${response.status} ${body?.message || response.statusText}`,
+      );
+      failed += 1;
+      continue;
+    }
+    console.log(`  ✓ 表单 ${formName} (${formUuid})`);
+    succeeded += 1;
+  }
+
+  return { succeeded, failed, created };
+}
+
+function readFormRuntimeAssets(config) {
+  const manifestPath = path.resolve(rootDir, "dist/form-runtime/manifest.json");
+  if (!fs.existsSync(manifestPath)) return null;
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+    if (
+      manifest?.protocol !== "sy-form-runtime" ||
+      manifest?.majorVersion !== 2 ||
+      !manifest?.version ||
+      !manifest?.files?.entry
+    ) {
+      return null;
+    }
+    return {
+      protocol: "sy-form-runtime",
+      majorVersion: 2,
+      version: manifest.version,
+      entryUrl: getFormRuntimeUrl(config, manifest.files.entry),
+      cssUrl: manifest.files.css ? getFormRuntimeUrl(config, manifest.files.css) : null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+async function registerPages() {
+  const pages = await discoverPages(targetPage || "");
+  if (pages.length === 0) {
+    return { succeeded: 0, failed: 0 };
+  }
+
+  const payload = buildDirectPagePublishPayload(config, pages);
+
+  if (dryRun) {
+    console.log("  [DRY] 代码页发布 payload:");
+    console.log(JSON.stringify(payload, null, 2));
+    return { succeeded: pages.length, failed: 0 };
+  }
+
+  const response = await fetch(`${apiBase}/dingtalk-api/v1.0/custom-pages/publish`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-acs-dingtalk-access-token": await getAccessToken(),
+    },
+    body: JSON.stringify(payload),
+  });
+  const body = await response.json().catch(() => null);
+  if (!response.ok || body?.code !== 200) {
+    console.error(
+      `  ✗ 代码页发布失败: HTTP ${response.status} ${body?.message || response.statusText}`,
+    );
+    return { succeeded: 0, failed: pages.length };
+  }
+
+  body.data?.items?.forEach((item) => {
+    console.log(`  ✓ 代码页 ${item.code} (${item.pageId})`);
+  });
+  return { succeeded: pages.length, failed: 0 };
+}
+
+console.log(`🔗 注册应用工作区产物 (${dryRun ? "DRY RUN" : "LIVE"})`);
+console.log(`   API: ${apiBase}`);
+console.log("");
+
+const formResult = targetPage ? { succeeded: 0, failed: 0, created: 0 } : await registerForms();
+const pageResult = targetForm ? { succeeded: 0, failed: 0 } : await registerPages();
+const succeeded = formResult.succeeded + pageResult.succeeded;
+const failed = formResult.failed + pageResult.failed;
+
+console.log("");
+console.log(
+  `完成: ${succeeded} 成功, ${formResult.created || 0} 自动创建表单, ${failed} 失败`,
+);
+
+if (failed > 0) {
+  process.exit(1);
+}