@lark-apaas/coding-template-nestjs-react-fullstack 0.1.25-alpha.20260820120346 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.25-alpha.20260820120346",
+  "version": "0.1.25",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/package.json

@@ -35,8 +35,8 @@
   "dependencies": {
     "@lark-apaas/fullstack-nestjs-core": "^1.1.59",
     "@nestjs/axios": "^4.0.1",
-    "@nestjs/cache-manager": "^3.1.3",
     "@nestjs/common": "^10.4.20",
+    "@nestjs/cache-manager": "^3.1.3",
     "@nestjs/config": "^3.3.0",
     "@nestjs/core": "^10.4.20",
     "@nestjs/platform-express": "^10.4.20",
@@ -63,8 +63,8 @@
     "@heroicons/react": "^2.2.0",
     "@hookform/resolvers": "^5.2.2",
     "@lark-apaas/client-toolkit": "^1.2.63",
-    "@lark-apaas/coding-preset-vite-react": "1.0.18-alpha.20260819103004",
     "@lark-apaas/fullstack-presets": "^1.1.0",
+    "@lark-apaas/fullstack-vite-preset": "^1.0.34",
     "@nestjs/cli": "^10.4.9",
     "@nestjs/testing": "^10.4.20",
     "@radix-ui/react-accordion": "^1.2.12",
@@ -181,7 +181,7 @@
     "typescript-eslint": "^8.44.0",
     "uuid": "11.0.5",
     "vaul": "^1.1.2",
-    "vite": "^8",
+    "vite": "^7.3.1",
     "xlsx": "^0.18.5",
     "xlsx-js-style": "^1.2.0",
     "zod": "^3.25.76",

package/template/scripts/dev.js

@@ -59,23 +59,10 @@ function timestamp() {
   );
 }
 
-// Cap pending async stdout writes so a stalled pty consumer can't grow memory unbounded.
-// Each pending fs.write retains ~1.5 KB (msg + libuv/V8 wrappers); 1000 ≈ ~1.5 MB ceiling.
-let _stdoutInFlight = 0;
-const STDOUT_MAX_INFLIGHT = 1000;
-
-/** Write to dev.std.log (sync, guaranteed) + mirror to terminal (async, non-blocking) */
+/** Write to terminal + dev.std.log */
 function writeOutput(msg) {
-  // File first and synchronously — read-logs reads this file; it must never be gated
-  // by the terminal consumer.
+  try { process.stdout.write(msg); } catch {}
   try { fs.writeSync(devStdLogFd, msg); } catch {}
-  // stdout mirror via async fs.write: if process.stdout is a pty/pipe whose consumer
-  // stalls, the block happens on the libuv threadpool, NOT the event loop — so the
-  // synchronous log-FILE writes above (and subsequent readline callbacks) keep running.
-  // Drop overflow when too many writes are already pending (best-effort mirror).
-  if (_stdoutInFlight >= STDOUT_MAX_INFLIGHT) { return; }
-  _stdoutInFlight++;
-  try { fs.write(1, msg, () => { _stdoutInFlight--; }); } catch { _stdoutInFlight--; }
 }
 
 /** Structured event log → terminal + dev.std.log + dev.log */
@@ -252,23 +239,20 @@ process.on('SIGTERM', cleanup);
 process.on('SIGINT', cleanup);
 process.on('SIGHUP', cleanup);
 
-// 定向保留 dist/ 里能复用的部分, 替代之前无脑 rm -rf dist/。
-// 收益: 保留 dist/server 让 nest --watch 从增量编译起点起 (省 8-13s 冷启动),
-// routes JSON 也保留 (build 会覆盖, 无 stale 风险)。dist/client/index.html 按
-// preset 打的 <meta name="miaoda-html-mode"> marker 判定:
-//   marker=dev  → 保留 dist/client/ 整个 (dev cache hit)
-//   marker=prod → agent 跑过 build:client 污染, 定向清 index.html + assets/
-// 具体逻辑抽到 lib/preserve-dev-cache.cjs 便于单测。
-// 降级 escape hatch: FORCE_CLEAN_DIST=true 走原全清路径 (marker 逻辑出 bug 时用)。
-const { preserveDevCache } = require('./lib/preserve-dev-cache.cjs');
+// Stale dist makes nest --watch skip missing files; watcher won't self-heal.
+function cleanStaleDist() {
+  const distPath = path.join(PROJECT_ROOT, 'dist');
+  if (fs.existsSync(distPath)) {
+    fs.rmSync(distPath, { recursive: true, force: true });
+    logEvent('INFO', 'main', 'Cleaned dist/ to force full rebuild');
+  }
+}
 
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
   logEvent('INFO', 'main', '========== Dev session started ==========');
 
-  preserveDevCache(PROJECT_ROOT, {
-    log: (level, msg) => logEvent(level, 'main', msg),
-  });
+  cleanStaleDist();
 
   // Initialize action plugins
   writeOutput('\n🔌 Initializing action plugins...\n');

package/template/scripts/dev.sh

@@ -1,14 +1,18 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
-#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
+# `npm run dev` 入口；按 MIAODA_DEP_CACHE_DIR 是否非空判断运行环境（与 miaoda-cli
+# isSandboxEnv() 同口径）：
+#   - 非空（沙箱平台注入的依赖缓存目录）→ 直接跑 dev.js
 #       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
 #       dev 入口不再额外 `npm run upgrade`。
-#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好。
-# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
+#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.js：纯 stdout、崩了就崩、Agent 友好。
+# 显式想跑本地路径可用 `npm run dev:local`（绕过本判断）。
+#
+# 不用 SANDBOX_ID：它由 sandbox_console 在绑定沙箱时才写入 .force/environment/env，预热池实例
+# 在绑定前拿不到，会被误判成本地。保留为附加条件只为兼容，不影响判定结果。
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-if [ -n "${SANDBOX_ID:-}" ]; then
+if [ -n "${MIAODA_DEP_CACHE_DIR:-}" ] || [ -n "${SANDBOX_ID:-}" ]; then
   exec node "$SCRIPT_DIR/dev.js" "$@"
 fi
 
@@ -18,7 +22,7 @@ if [ ! -f "$SCRIPT_DIR/dev-local.js" ]; then
 fi
 
 # 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# latest + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
+# latest + 迁移老 npm scripts。沙箱不走这里（上面的沙箱分支已经 exec return）。
 npx -y @lark-apaas/miaoda-cli@latest app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 
 exec node "$SCRIPT_DIR/dev-local.js" "$@"

package/template/vite.config.ts

@@ -1,5 +1,5 @@
 import path from 'path';
-import { defineConfig } from '@lark-apaas/coding-preset-vite-react';
+import { defineConfig } from '@lark-apaas/fullstack-vite-preset';
 
 export default defineConfig({
   resolve: {

package/template/scripts/lib/preserve-dev-cache.cjs

@@ -1,123 +0,0 @@
-'use strict';
-
-// dev.js 启动时替代无脑 rm -rf dist/ 的 lib: 保留 dist/server (nest --watch 增量编译起点)
-// + 按 HTML mode marker 决定 dist/client 是保留还是清污染。
-// 跟 preset 侧 html-output plugin 的 injectHtmlModeMarker / detectHtmlMode 配套:
-// preset 写盘时打 marker (dev 版 vs prod 污染版), 这里读 marker 定去留。
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 从 HTML 里回读 <meta name="miaoda-html-mode" content="dev|prod"> marker。
- * 与 packages/tools/fullstack-vite-preset/src/vite-plugins/html-output-plugin.ts
- * 的 detectHtmlMode 同源, 为了让 dev.js 模板脚本零依赖跑起来这里重复一份。
- */
-function detectHtmlMode(htmlContent) {
-  const match = htmlContent.match(
-    /<meta\s+name=["']miaoda-html-mode["']\s+content=["'](dev|prod)["'][^>]*>/i
-  );
-  return (match && match[1]) || 'unknown';
-}
-
-/**
- * 定向清理 dist/ 的可复用副本, 替代 dev.js 之前无脑 `rm -rf dist/` 的 cleanStaleDist。
- *
- * 决策规则:
- *  - FORCE_CLEAN_DIST=true → 走 escape hatch 全清 (preserveDevCache 逻辑 / 保留的
- *    dist/server 出 stale 时兜底)
- *  - dist/ 不存在 → 无动作
- *  - dist/client/index.html 存在且 marker=dev → 整个 dist/client/ 保留 (dev cache hit)
- *  - 存在但 marker=prod 或缺失 → 只清 dist/client/index.html + dist/client/assets/
- *    (build 污染部分), dist/server/ 与 routes JSON 保留
- *  - 不存在 → 无动作, htmlOutputPlugin 稍后会写入
- *
- * @param {string} projectRoot 项目根目录
- * @param {object} [options]
- * @param {(level: string, msg: string) => void} [options.log] 日志回调, 默认 console.log
- * @param {boolean} [options.forceClean] 覆盖 FORCE_CLEAN_DIST env var 判断 (给测试用)
- * @returns {{ action: 'no_dist' | 'force_cleaned' | 'no_index' | 'preserved' | 'cleaned_polluted' | 'read_failed_cleaned' | 'cleanup_failed', mode: string }}
- */
-function preserveDevCache(projectRoot, options) {
-  const log = (options && options.log) || defaultLogger;
-  const forceClean =
-    options && typeof options.forceClean === 'boolean'
-      ? options.forceClean
-      : process.env.FORCE_CLEAN_DIST === 'true';
-
-  const distPath = path.join(projectRoot, 'dist');
-  if (!fs.existsSync(distPath)) {
-    log('INFO', 'preserveDevCache: no dist/, will be created by vite/nest');
-    return { action: 'no_dist', mode: 'unknown' };
-  }
-
-  if (forceClean) {
-    fs.rmSync(distPath, { recursive: true, force: true });
-    log(
-      'INFO',
-      'preserveDevCache: FORCE_CLEAN_DIST=true, cleaned entire dist/'
-    );
-    return { action: 'force_cleaned', mode: 'unknown' };
-  }
-
-  const clientDir = path.join(distPath, 'client');
-  const indexHtml = path.join(clientDir, 'index.html');
-
-  if (!fs.existsSync(indexHtml)) {
-    log(
-      'INFO',
-      'preserveDevCache: no dist/client/index.html, other artifacts preserved'
-    );
-    return { action: 'no_index', mode: 'unknown' };
-  }
-
-  let mode = 'unknown';
-  let readFailed = false;
-  try {
-    const content = fs.readFileSync(indexHtml, 'utf-8');
-    mode = detectHtmlMode(content);
-  } catch (e) {
-    log(
-      'WARN',
-      `preserveDevCache: read dist/client/index.html failed: ${e.message}, treating as polluted`
-    );
-    readFailed = true;
-    mode = 'unknown';
-  }
-
-  if (mode === 'dev') {
-    log('INFO', 'preserveDevCache: dist/client preserved (dev cache hit)');
-    return { action: 'preserved', mode: 'dev' };
-  }
-
-  // marker=prod 或 unknown → build:client 污染 (或人为放的产物), 定向清 index.html + assets/
-  // dist/server/, dist/*.json 保留
-  try {
-    fs.rmSync(indexHtml, { force: true });
-    const assetsDir = path.join(clientDir, 'assets');
-    if (fs.existsSync(assetsDir)) {
-      fs.rmSync(assetsDir, { recursive: true, force: true });
-    }
-    log(
-      'INFO',
-      `preserveDevCache: dist/client/index.html was ${mode}, cleaned index.html + assets/ (dist/server preserved)`
-    );
-    return {
-      action: readFailed ? 'read_failed_cleaned' : 'cleaned_polluted',
-      mode,
-    };
-  } catch (e) {
-    log(
-      'WARN',
-      `preserveDevCache: cleanup failed: ${e.message}, continuing anyway (index.html / assets may still be polluted)`
-    );
-    return { action: 'cleanup_failed', mode };
-  }
-}
-
-function defaultLogger(level, msg) {
-  // eslint-disable-next-line no-console
-  console.log(`[${level}] [main] ${msg}`);
-}
-
-module.exports = { detectHtmlMode, preserveDevCache };