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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [
@@ -26,7 +26,7 @@
   "license": "MIT",
   "miaodaTemplate": {
     "schemaVersion": 1,
-    "archType": 3,
+    "archType": 1,
     "hooks": {
       "beforeRender": "hooks/before-render.mjs",
       "afterRender": "hooks/after-render.mjs",

package/template/.env

@@ -0,0 +1,14 @@
+# Application
+# Server Configuration (NestJS)
+SUDA_DATABASE_URL=
+
+# Client Configuration
+
+# Logger
+LOG_DIR=./logs
+LOG_REQUEST_BODY=true
+LOG_RESPONSE_BODY=true
+
+# Framework build / lint mode（false = 严格）
+FORCE_FRAMEWORK_BUILD_LOOSE_MODE=false
+FORCE_FRAMEWORK_LINT_LOOSE_MODE=false

package/template/.spark/meta.json

@@ -0,0 +1 @@
+{"stack":"nestjs-react-fullstack"}

package/template/scripts/dev-local.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# ============================================================================
+# 本地 dev 启动脚本（平台控制，通过 `miaoda app upgrade` 同步，请勿手改）
+# Stack: nestjs-react-fullstack
+# 流程：env pull → skills sync → 并发起 server + client
+# ============================================================================
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT_DIR"
+
+# === Sentinels（必须由本脚本注入，不属于 .env.local 业务范畴）===
+
+# Stack 对应 miaoda CLI 的 application scene；沙箱里平台注入，本地脚本兜底，
+# 让后续 miaoda 子命令（skills sync 等）走对的 scene。
+export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-3}"
+
+# 本地开发总开关：SDK（fullstack-vite-preset / fullstack-rspack-preset /
+# fullstack-nestjs-core）据此启用本地兜底逻辑：
+#   - vite/rspack-preset：反代 /__runtime__ 到沙箱（带 cookie / webuser header）
+#   - nestjs-core：从 cookie 补 csrf header + 注入 webuser header
+# 沙箱 dev / 生产不设此 env，SDK 行为完全不变。
+export MIAODA_LOCAL_DEV=1
+
+# 临时：绕 npmmirror/bnpm 内网到 npmjs 的同步延迟，等 coding-steering 正式版去掉。
+export MIAODA_NPM_REGISTRY="${MIAODA_NPM_REGISTRY:-https://registry.npmjs.org/}"
+
+# === .env.local / .env 加载由 SDK 侧负责，本脚本不再手工 source ===
+# fullstack-nestjs-core 在 module init 通过 dotenv 读 .env.local + .env；
+# fullstack-{vite,rspack}-preset 的 defineConfig 同理。优先级：shell > .env.local > .env。
+# 历史版本曾在这里用 bash 自写 parser，引号 / 多行 / 行尾注释处理不全且重复造轮子，已下放到 SDK。
+
+# 1. 拉本地 dev 所需 ENV（jwt / cookie / sandbox URL 等，写入 .env.local）
+#    app_id 从 .spark/meta.json 读 —— `miaoda app init --app-id <id>` 时持久化的权威源，
+#    后续 dev / sync 全部沿用这一个值；不在脚本里 hack 别的推断渠道。
+#    lark-cli 子命令真名是 `+env-pull`（带 + 前缀单 token，不是 `env pull` 空格分隔）；
+#    `--as user` 必须显式：env-pull 只接受 user identity，默认 bot 会校验失败。
+echo "[dev-local] (1/3) env pull..."
+if command -v lark-cli >/dev/null 2>&1; then
+  # 用 node 读 .spark/meta.json，不引 python3 依赖（user app 必装 node）。
+  APP_ID=$(node -e 'try{process.stdout.write(JSON.parse(require("fs").readFileSync(".spark/meta.json","utf8")).app_id||"")}catch(e){}' 2>/dev/null || echo "")
+  if [ -n "$APP_ID" ]; then
+    lark-cli apps +env-pull --app-id "$APP_ID" --as user || echo "  (env pull 失败，后续按 .env.local 现状继续)"
+  else
+    echo "  (.spark/meta.json 缺 app_id，先跑 \`miaoda app init --app-id <id>\` 写入)"
+  fi
+else
+  echo "  (lark-cli 未装，跳过 env pull；请确保 .env.local 已就绪)"
+fi
+
+# 2. 同步 stack 对应 skills（coding-steering）。走 npx 不依赖用户全局装 miaoda；
+#    钉到 @alpha dist-tag 跟随最新发布，miaoda-cli 通道我们自己控制风险小。
+echo "[dev-local] (2/3) miaoda skills sync..."
+npx -y @lark-apaas/miaoda-cli@alpha skills sync || echo "  (skills sync 失败，继续启动)"
+
+# 3. 并发起 dev:server（NestJS）+ dev:client（vite/rspack）
+#    端口、SANDBOX_* 等业务 env 由 SDK 内 dotenv 加载，不在 banner 里假装显示。
+#    不走 scripts/dev.js（保活 / restart / 日志写文件那套）—— 本地崩就崩，错日志直接 stdout。
+echo "[dev-local] (3/3) 并发起 dev:server + dev:client"
+exec npx --no-install concurrently \
+  --names "server,client" --prefix-colors "blue,green" --kill-others-on-fail \
+  "npm run dev:server" "npm run dev:client"

package/template/tsconfig.node.json

@@ -9,7 +9,8 @@
     }
   },
   "watchOptions": {
-    "excludeDirectories": ["node_modules/**"]
+    "excludeDirectories": ["node_modules/**"],
+    "preserveWatchOutput": true
   },
   "include": ["server/**/*", "shared/**/*.ts"],
   "exclude": ["node_modules", "dist", "client", "**/*.spec.ts", "**/*.e2e-spec.ts"],

package/template/_env.local

@@ -1,38 +0,0 @@
-# =================================================
-# 妙搭本地开发 — .env.local
-# 优先级：shell env > .env.local > .env
-# SDK（fullstack-vite-preset / fullstack-nestjs-core）在 module init 通过 dotenv 自动加载
-# =================================================
-
-# ───── 应用上下文 ─────
-# app_id=app_xxx
-# CLIENT_BASE_PATH=/app/app_xxx/                              # React Router basename + Vite base
-# FORCE_FRAMEWORK_DOMAIN_MAIN=https://miaoda.feishu-boe.cn
-# FORCE_FRAMEWORK_ENVIRONMENT=boe
-
-# ───── 端口（缺省即使用 SDK 默认 8080 / 3000，本地推荐 8001 / 3000）─────
-# CLIENT_DEV_PORT=8001
-# SERVER_PORT=3000
-# SERVER_HOST=localhost
-# CLIENT_DEV_HOST=0.0.0.0
-
-# ───── 业务 DB（BOE PG 公网 endpoint，本地可直连）─────
-# SUDA_DATABASE_URL=postgresql://<user>:<pass>@<host>.miaoda-pg-staging.aiforce.cloud:5432/<db>?sslmode=require&schema=workspace_<id>
-
-# ───── 沙箱反代（本地 dev 兜底；MIAODA_LOCAL_DEV=1 由 scripts/dev-local.sh 自动 export）─────
-# SANDBOX_PUBLIC_URL=https://ai-tenant-<app_id>-<sandbox_id>.aiforce-boe-preview.bytedance.net
-
-# 后端下发的单值 session id（新流，推荐）
-# FORCE_AUTHN_PREVIEW_SESSION_ID=<后端给的 session 值>
-
-# webuser 身份（JSON，必须单行无空格）
-# SUDA_WEBUSER={"user_id":"...","tenant_id":...,"app_id":"app_xxx","env":"preview","login_url":"","roles":null,"user_type":"_employee","user_name":{"zh_cn":"..."}}
-
-# ───── 日志 ─────
-LOG_DIR=./logs
-LOG_REQUEST_BODY=true
-LOG_RESPONSE_BODY=true
-
-# ───── 构建期 ─────
-FORCE_FRAMEWORK_BUILD_LOOSE_MODE=false
-FORCE_FRAMEWORK_LINT_LOOSE_MODE=false