@lark-apaas/coding-template-nestjs-react-fullstack 0.1.0-alpha.1 → 0.1.0-alpha.2

package/package.json

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

package/template/.githooks/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+[ "$SKIP_GIT_HOOKS" = "1" ] && exit 0
+export PATH="node_modules/.bin:$PATH"
+npm run precommit

package/template/package.json

@@ -9,7 +9,7 @@
     "customToaster": true
   },
   "scripts": {
-    "dev": "npm run upgrade && ./scripts/dev.sh",
+    "dev": "./scripts/dev.sh",
     "dev:server": "NODE_ENV=development nest start --watch",
     "dev:client": "NODE_ENV=development vite --config vite.config.ts",
     "gen:db-schema": "npx -y @lark-apaas/db-schema-sync@latest --output server/database/schema.ts --export-custom-types",
@@ -29,7 +29,8 @@
     "type:check:server": "tsc --noEmit --project tsconfig.node.json",
     "lint": "node ./scripts/lint.js",
     "format": "prettier --write \"{server,client,test}/**/*.{js,ts,tsx,json,md}\"",
-    "upgrade": "fullstack-cli sync --disable-gen-openapi"
+    "precommit": "node scripts/hooks/run-precommit.js",
+    "upgrade": "npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi"
   },
   "dependencies": {
     "@lark-apaas/fullstack-nestjs-core": "^1.1.22",

package/template/scripts/dev.sh

@@ -1,2 +1,32 @@
 #!/usr/bin/env bash
-exec node "$(dirname "$0")/dev.js" "$@"
+# `npm run dev` 入口；按 IS_SANDBOX 分发：
+#   - IS_SANDBOX=1（沙箱平台注入）→ 先 fullstack-cli sync 同步平台脚本，再跑 dev.js
+#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）
+#   - 否则（本地）→ 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好
+# 显式想跑本地路径可用 `npm run dev:local`（绕过 IS_SANDBOX）。
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+if [ "${IS_SANDBOX:-}" = "1" ] || [ "${IS_SANDBOX:-}" = "true" ]; then
+  # 沙箱前置同步：fullstack-cli sync 把平台管控的 scripts/ + 部分 package.json 字段同步过来。
+  # 不直接调 `fullstack-cli`，走 `npm run upgrade` 享 package.json 里的入口定义（与 prepublish
+  # 之类的钩子一致）；后续若 upgrade 脚本换实现，dev 路径自动跟随。
+  npm run upgrade
+  exec node "$SCRIPT_DIR/dev.js" "$@"
+fi
+
+if [ ! -x "$SCRIPT_DIR/dev-local.sh" ]; then
+  echo "[dev] scripts/dev-local.sh 缺失或不可执行；先跑 \`miaoda app upgrade\` 同步平台脚本" >&2
+  exit 1
+fi
+
+# 本地启动前先跑一次 miaoda app upgrade：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
+# 最新 alpha + 迁移老 npm scripts。沙箱不走这里（IS_SANDBOX 分支已经 return）。miaoda 缺失时
+# 软失败（agent 环境可能没装），靠用户自己保证 .env.local / scripts 现状能跑。
+if command -v miaoda >/dev/null 2>&1; then
+  miaoda app upgrade || echo "[dev] miaoda app upgrade 失败，按现状继续" >&2
+else
+  echo "[dev] miaoda 未装，跳过 upgrade；建议 npm i -g @lark-apaas/miaoda-cli" >&2
+fi
+
+exec "$SCRIPT_DIR/dev-local.sh" "$@"

package/template/scripts/hooks/run-precommit.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// FULLSTACK_PRECOMMIT_V1
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+
+const SEP = '  ' + '─'.repeat(36);
+
+function failAndExit(step, body) {
+  process.stderr.write('\n✗ pre-commit failed: ' + step + '\n');
+  process.stderr.write(SEP + '\n');
+  if (body && body.length > 0) {
+    process.stderr.write(body.replace(/\s+$/, '') + '\n');
+  }
+  process.stderr.write(SEP + '\n');
+  process.stderr.write('  bypass: git commit --no-verify\n');
+  process.exit(1);
+}
+
+function runLint() {
+  const cwd = process.cwd();
+  const res = spawnSync('npm', ['run', 'lint'], {
+    cwd,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env: process.env,
+  });
+  if (res.error) {
+    failAndExit('lint', String(res.error.message || res.error));
+  }
+  if (res.status !== 0) {
+    const stdout = res.stdout ? res.stdout.toString() : '';
+    const stderr = res.stderr ? res.stderr.toString() : '';
+    failAndExit('lint', stdout + '\n' + stderr);
+  }
+}
+
+runLint();