generator-mico-cli 0.2.31 → 0.2.32

package/generators/h5-react/templates/scripts/gateway.ts

@@ -0,0 +1,241 @@
+/**
+ * 本地开发网关脚本：读取根目录 `page.config.ts`，为每个 `apps/<key>` 分配端口并启动 `pnpm dev`，
+ * 再启动统一 HTTP/WebSocket 代理（默认从 3000 起占端口），通过路径前缀将流量转发到对应子应用。
+ */
+import http from 'http';
+import path from 'path';
+import fs from 'fs';
+import { spawn, type ChildProcessWithoutNullStreams } from 'child_process';
+import httpProxy from 'http-proxy';
+import portfinder from 'portfinder';
+import chalk from 'chalk';
+
+/**
+ * 仓库根目录的 `page.config.ts`：键名为子应用目录名（对应 `apps/<key>`）。
+ */
+import pageConfig from '../page.config.ts';
+
+/** 单个子应用在网关中的运行时元数据（端口、路径前缀等）。 */
+interface PageConfig {
+  key: string;
+  name: string;
+  fullPath: string;
+  prefixPath: string;
+  port: number;
+}
+
+/**
+ * 遍历 `page.config.ts` 的每个键，在 `apps/<key>` 下读取 `package.json`，
+ * 并为每个子应用从 4000 起顺序分配可用端口，生成 `PageConfig` 列表。
+ */
+async function formatPageConfig(): Promise<PageConfig[]> {
+  const pageConfigs: PageConfig[] = [];
+  const appPath = path.join(process.cwd(), 'apps');
+  let basePort = 4000;
+  for (const [key, value] of Object.entries(pageConfig)) {
+    const appPackagePath = path.join(appPath, key, 'package.json');
+    try {
+      const appPackage = await fs.promises.readFile(appPackagePath, 'utf8');
+      const appPackageJson = JSON.parse(appPackage);
+      const port = await portfinder.getPortPromise({ port: basePort });
+      basePort = port + 1;
+      const pageConfig: PageConfig = {
+        key,
+        name: appPackageJson.name,
+        fullPath: path.join(appPath, key),
+        prefixPath: `/${key}`,
+        port,
+      };
+      pageConfigs.push(pageConfig);
+    } catch (error) {
+      console.error(`[${key}] 读取 package.json 失败: ${(error as Error).message}`);
+      continue;
+    }
+  }
+  return pageConfigs;
+}
+
+/**
+ * 在各自 `cwd` 下执行 `pnpm run dev -p <port>` 启动每个子应用。
+ * 监听 stdout 出现 Ready/successfully 时视为已就绪并 resolve（stderr 常含非错误日志，见下方）。
+ */
+async function runApp(pageConfigs: PageConfig[]) {
+  const promises = pageConfigs.map(config => {
+    return new Promise<ChildProcessWithoutNullStreams>((resolve, reject) => {
+      const child = spawn('pnpm', ['run', 'dev'], {
+        cwd: config.fullPath,
+        env: { ...process.env, PORT: String(config.port) },
+        // 如需在终端直接看到子应用原始输出，可改为 stdio: 'inherit'（需自行调整就绪判断逻辑）
+        shell: process.platform === 'win32',
+      });
+      child.on('error', (err) => {
+        console.error(chalk.red(`[${config.key}] 子进程启动失败:`), err.message);
+      });
+      child.on('exit', (code, signal) => {
+        if (code !== null && code !== 0) {
+          console.error(chalk.red(`[${config.key}] 子进程退出 code=${code} signal=${signal}`));
+        }
+      });
+      child.stdout.on('data', (data) => {
+        const msg = data.toString();
+        console.log(`${chalk.green(`[${config.key}]`)} ${msg}`);
+        const reg = /Local: http:\/\/localhost:(\d+)/
+        const match = msg.match(reg);
+        if (match) {
+          const port = match[1];
+          config.port = parseInt(port);
+          setTimeout(() => {
+            resolve(child)
+          });
+        }
+      });
+      child.stderr.on('data', (data) => {
+        const msg = data.toString();
+        console.log(`${chalk.dim(`[${config.key}]`)} ${msg}`);
+      });
+    })
+  })
+  return Promise.all(promises).then((childs) => {
+    console.log(chalk.green('所有子应用已启动'))
+    pageConfigs.forEach(config => {
+      console.log(`${chalk.green(`[${config.key}]`)} 子应用已启动：${chalk.blue(`http://127.0.0.1:${config.port}`)}`)
+    })
+    return childs
+  })
+}
+
+/**
+ * 根据当前请求解析应转发到的子应用：优先用路径匹配；无 Referer 或 Referer 为根时用请求路径；
+ * 否则用 Referer 的路径（便于静态资源等请求仍落到同一子应用）。无匹配时回退上次目标或第一个应用。
+ */
+function getTargetByRes(req: http.IncomingMessage, pageConfigs: PageConfig[], lastTargetPageConfig: PageConfig | null) {
+  const pathname = urlPathname(req.url) ?? '/';
+  const refererPathname = urlPathname(req.headers.referer)
+  const targetPathname = (
+    !refererPathname || refererPathname === '/'
+      ? pathname
+      : refererPathname
+  )
+  const pathConfig = getTargetByPath(targetPathname, pageConfigs);
+  return pathConfig ?? lastTargetPageConfig ?? pageConfigs[0]!;
+}
+
+/** 判断 `pathname` 是否属于某子应用（等于 `prefixPath` 或以其为前缀）。 */
+function getTargetByPath(pathname: string, pageConfigs: PageConfig[]) {
+  for (const config of pageConfigs) {
+    if (pathname === config.prefixPath || pathname.startsWith(`${config.prefixPath}/`)) {
+      return config;
+    }
+  }
+  return null;
+}
+
+/** 从完整 URL 或相对路径中解析 pathname；无效输入返回 `null`。 */
+function urlPathname(url: string | undefined) {
+  if (!url) return null;
+  try {
+    return new URL(url, 'http://127.0.0.1').pathname || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 转发到子应用 dev 服务器前去掉网关层前缀（如 `/app`），使子应用收到根路径下的请求。
+ */
+function rewriteUrlForTarget(rawUrl: string | undefined, target: PageConfig): string {
+  if (!rawUrl) return '/';
+  const url = new URL(rawUrl, 'http://127.0.0.1');
+  url.pathname = url.pathname.replace(new RegExp(`^${target.prefixPath}`), '') || '/';
+  return url.toString();
+}
+
+/**
+ * 在可用端口（默认从 3000 起探测）上启动 HTTP 代理，支持 WebSocket；
+ * 根路径 `/` 返回各子应用入口链接，其余请求按路由规则转发到对应本地端口。
+ */
+async function runProxyServer(pageConfigs: PageConfig[]) {
+  const proxy = httpProxy.createProxyServer({ ws: true });
+  proxy.on('error', (err, req, res) => {
+    console.error(chalk.red('[proxy error]'), err.message);
+  });
+
+  let lastTargetPageConfig: PageConfig | null = null;
+
+  const server = http.createServer((req, res) => {
+    const pathname = urlPathname(req.url) ?? '/';
+    if (pathname === '/' || pathname === '') {
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+      const links = pageConfigs
+        .map((c) => `  <li><a href="${c.prefixPath}">${c.prefixPath}</a> (${c.key})</li>`)
+        .join('\n');
+      res.end(
+        `<!DOCTYPE html><html><body><h1>子应用入口</h1><ul>\n${links}\n</ul></body></html>`
+      );
+      return;
+    }
+
+    lastTargetPageConfig = getTargetByRes(req, pageConfigs, lastTargetPageConfig);
+    req.url = rewriteUrlForTarget(req.url, lastTargetPageConfig);
+    proxy.web(req, res, {
+      target: `http://127.0.0.1:${lastTargetPageConfig.port}`,
+      changeOrigin: true,
+    });
+  });
+
+  server.on('upgrade', (req, socket, head) => {
+    lastTargetPageConfig = getTargetByRes(req, pageConfigs, lastTargetPageConfig);
+    req.url = rewriteUrlForTarget(req.url, lastTargetPageConfig);
+    proxy.ws(req, socket, head, {
+      target: `http://127.0.0.1:${lastTargetPageConfig.port}`,
+    });
+  });
+  const port = await portfinder.getPortPromise({ port: 3000 });
+  server.listen(port, () => {
+    console.log(chalk.green(`[gateway] 代理服务已启动 端口：${chalk.blue(port)}`));
+    console.log(`>>> 统一通过代理访问: ${chalk.blue(`http://127.0.0.1:${port}`)}`);
+    pageConfigs.forEach(config => {
+      console.log(`${chalk.green(`[${config.key}]`)} 子应用访问路径：${chalk.blue(`http://127.0.0.1:${port}${config.prefixPath}`)}`)
+    })
+  });
+  return server;
+}
+
+/**
+ * 在收到 SIGINT（Ctrl+C）或 SIGTERM 时关闭代理 `server` 并终止所有子进程；
+ * `server.close` 若迟迟不回调，3 秒后强制 `process.exit(0)`。
+ */
+function listenerClose(server: http.Server, childs: ChildProcessWithoutNullStreams[]) {
+  let cleaning = false;
+  const cleanup = () => {
+    if (cleaning) return;
+    cleaning = true;
+
+    server.close(() => {
+      childs.forEach((child) => {
+        if (child.killed) return;
+        child.kill('SIGTERM');
+      });
+      process.exit(0);
+    });
+    // 若 server.close 回调未及时触发，超时后强制退出
+    setTimeout(() => process.exit(0), 3000);
+  };
+
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+}
+
+/** 加载配置 → 拉起子应用 → 启动网关代理 → 注册退出清理。 */
+async function main() {
+  const pageConfigs = await formatPageConfig();
+  if (pageConfigs.length === 0) {
+    console.error('未开启任何子应用，请检查 page.config.ts 配置');
+    process.exit(1);
+  }
+  const childs = await runApp(pageConfigs);
+  const proxyServer = await runProxyServer(pageConfigs);
+  listenerClose(proxyServer, childs);
+}
+
+main()

package/generators/h5-react/templates/turbo.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalEnv": [
+    "CDN_PUBLIC_PATH",
+    "BRANCH_OR_TAG",
+    "VERSION",
+    "SENTRY_AUTH_TOKEN"
+  ],
+  "envMode": "loose",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "!.umi/**",
+        "!.turbo/**",
+        "!src/.umi/**",
+        "!src/.umi-production/**",
+        "!src/.umi-test/**",
+        ".env",
+        ".env.local",
+        ".env.production",
+        ".env.production.local"
+      ],
+      "outputs": ["dist/**"]
+    },
+    "build:development": {
+      "dependsOn": ["^build:development"],
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "!.umi/**",
+        "!.turbo/**",
+        "!src/.umi/**",
+        "!src/.umi-production/**",
+        "!src/.umi-test/**",
+        ".env",
+        ".env.local",
+        ".env.development",
+        ".env.development.local"
+      ],
+      "outputs": ["dist/**"]
+    },
+    "build:testing": {
+      "dependsOn": ["^build:testing"],
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "!.umi/**",
+        "!.turbo/**",
+        "!src/.umi/**",
+        "!src/.umi-production/**",
+        "!src/.umi-test/**",
+        ".env",
+        ".env.local",
+        ".env.testing",
+        ".env.testing.local"
+      ],
+      "outputs": ["dist/**"]
+    },
+    "build:production": {
+      "dependsOn": ["^build:production"],
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        "!.umi/**",
+        "!.turbo/**",
+        "!src/.umi/**",
+        "!src/.umi-production/**",
+        "!src/.umi-test/**",
+        ".env",
+        ".env.local",
+        ".env.production",
+        ".env.production.local"
+      ],
+      "outputs": ["dist/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "outputs": []
+    },
+    "lint:fix": {
+      "outputs": []
+    }
+  }
+}

package/generators/subapp-h5/ignore-list.json

@@ -0,0 +1 @@
+["node_modules", "dist", ".umi", ".umi-production", ".turbo"]