@lark-apaas/fullstack-cli 0.1.0-alpha.9 → 1.0.1-alpha.0

package/LICENSE

@@ -0,0 +1,13 @@
+MIT License
+
+Copyright (c) 2024 Lark Technologies Pte. Ltd. and/or its affiliates
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted,provided that the above copyright notice and this permission notice appear in all copies.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/bin/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 直接执行编译后的 index.js
+const indexPath = path.join(__dirname, '../dist/index.js');
+await import(indexPath);

package/dist/commands/gen-db-schema.d.ts

@@ -1,10 +1,19 @@
 /**
  * 生成数据库 schema
  *
+ * 命令行选项：
+ * - --output <path>: schema 输出路径，默认 'server/database/schema.ts'
+ * - --schema-filter <schemas>: schema 过滤器，逗号分隔
+ * - --tables-filter <tables>: 表过滤器，逗号分隔，默认 '*'
+ *
  * 环境变量配置：
  * - SUDA_DATABASE_URL: 数据库连接 URL（必需）
- * - DB_SCHEMA_OUTPUT: schema 输出路径，默认 'server/database/schema.ts'
- * - DRIZZLE_SCHEMA_FILTER: schema 过滤器，逗号分隔
- * - DRIZZLE_TABLES_FILTER: 表过滤器，逗号分隔，默认 '*'
+ * - DB_SCHEMA_OUTPUT: schema 输出路径（命令行选项优先）
+ * - DRIZZLE_SCHEMA_FILTER: schema 过滤器（命令行选项优先）
+ * - DRIZZLE_TABLES_FILTER: 表过滤器（命令行选项优先）
  */
-export declare function run(): Promise<void>;
+export declare function run(options?: {
+    output?: string;
+    schemaFilter?: string;
+    tablesFilter?: string;
+}): Promise<void>;

package/dist/commands/gen-db-schema.js

@@ -10,13 +10,18 @@ const require = createRequire(import.meta.url);
 /**
  * 生成数据库 schema
  *
+ * 命令行选项：
+ * - --output <path>: schema 输出路径，默认 'server/database/schema.ts'
+ * - --schema-filter <schemas>: schema 过滤器，逗号分隔
+ * - --tables-filter <tables>: 表过滤器，逗号分隔，默认 '*'
+ *
  * 环境变量配置：
  * - SUDA_DATABASE_URL: 数据库连接 URL（必需）
- * - DB_SCHEMA_OUTPUT: schema 输出路径，默认 'server/database/schema.ts'
- * - DRIZZLE_SCHEMA_FILTER: schema 过滤器，逗号分隔
- * - DRIZZLE_TABLES_FILTER: 表过滤器，逗号分隔，默认 '*'
+ * - DB_SCHEMA_OUTPUT: schema 输出路径（命令行选项优先）
+ * - DRIZZLE_SCHEMA_FILTER: schema 过滤器（命令行选项优先）
+ * - DRIZZLE_TABLES_FILTER: 表过滤器（命令行选项优先）
  */
-export async function run() {
+export async function run(options = {}) {
     // 加载用户项目的 .env 文件
     const envPath = path.resolve(process.cwd(), '.env');
     if (fs.existsSync(envPath)) {
@@ -29,7 +34,8 @@ export async function run() {
         console.error('[gen-db-schema] Please set it in .env file or pass it as environment variable');
         process.exit(1);
     }
-    const outputPath = process.env.DB_SCHEMA_OUTPUT || 'server/database/schema.ts';
+    // 命令行选项优先于环境变量
+    const outputPath = options.output || process.env.DB_SCHEMA_OUTPUT || 'server/database/schema.ts';
     const OUT_DIR = path.resolve(process.cwd(), 'server/database/.introspect');
     const SCHEMA_FILE = path.resolve(process.cwd(), outputPath);
     console.log('[gen-db-schema] Starting...');
@@ -38,8 +44,8 @@ export async function run() {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = path.dirname(__filename);
     // 使用 CLI 内部的 drizzle 配置
-    const cliRoot = path.resolve(__dirname, '../..');
-    const configPath = path.join(cliRoot, 'templates', 'drizzle.config.ts');
+    const cliRoot = path.resolve(__dirname, '../');
+    const configPath = path.join(cliRoot, 'config', 'drizzle.config.js');
     if (!fs.existsSync(configPath)) {
         console.error('[gen-db-schema] Error: drizzle config not found in CLI package');
         process.exit(1);

package/dist/commands/sync.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 同步模板文件到用户项目
+ */
+export declare function run(): Promise<void>;

package/dist/commands/sync.js

@@ -0,0 +1,162 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { syncConfig } from '../config/sync.js';
+/**
+ * 同步模板文件到用户项目
+ */
+export async function run() {
+    // 检测是否在用户项目中（通过 INIT_CWD 判断）
+    const userProjectRoot = process.env.INIT_CWD || process.cwd();
+    // 获取插件根目录
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const pluginRoot = path.resolve(__dirname, '../..');
+    // 只有在插件自己的开发目录中才跳过（避免在开发插件时触发 sync）
+    if (userProjectRoot === pluginRoot) {
+        console.log('[fullstack-cli] Skip syncing (installing plugin itself)');
+        process.exit(0);
+    }
+    // 检查是否存在 package.json，确保是有效的项目
+    const userPackageJson = path.join(userProjectRoot, 'package.json');
+    if (!fs.existsSync(userPackageJson)) {
+        console.log('[fullstack-cli] Skip syncing (not a valid npm project)');
+        process.exit(0);
+    }
+    try {
+        console.log('[fullstack-cli] Starting sync...');
+        // 使用配置
+        const config = syncConfig;
+        if (!config || !config.sync) {
+            console.warn('[fullstack-cli] No sync configuration found');
+            process.exit(0);
+        }
+        // 执行同步规则
+        for (const rule of config.sync) {
+            await syncRule(rule, pluginRoot, userProjectRoot);
+        }
+        // 设置权限
+        if (config.permissions) {
+            setPermissions(config.permissions, userProjectRoot);
+        }
+        console.log('[fullstack-cli] Sync completed successfully ✅');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error('[fullstack-cli] Failed to sync:', message);
+        process.exit(1);
+    }
+}
+/**
+ * 执行单个同步规则
+ */
+async function syncRule(rule, pluginRoot, userProjectRoot) {
+    const srcPath = path.join(pluginRoot, rule.from);
+    const destPath = path.join(userProjectRoot, rule.to);
+    if (!fs.existsSync(srcPath)) {
+        console.warn(`[fullstack-cli] Source not found: ${rule.from}`);
+        return;
+    }
+    switch (rule.type) {
+        case 'directory':
+            syncDirectory(srcPath, destPath, rule.overwrite ?? true);
+            break;
+        case 'file':
+            syncFile(srcPath, destPath, rule.overwrite ?? true);
+            break;
+        case 'append':
+            appendToFile(srcPath, destPath);
+            break;
+        default:
+            console.warn(`[fullstack-cli] Unknown sync type: ${rule.type}`);
+    }
+}
+/**
+ * 同步单个文件
+ */
+function syncFile(src, dest, overwrite = true) {
+    // 确保目标目录存在
+    const destDir = path.dirname(dest);
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    // 检查目标文件是否存在
+    if (fs.existsSync(dest) && !overwrite) {
+        console.log(`[fullstack-cli] ○ ${path.basename(dest)} (skipped, already exists)`);
+        return;
+    }
+    // 复制文件
+    fs.copyFileSync(src, dest);
+    console.log(`[fullstack-cli] ✓ ${path.basename(dest)}`);
+}
+/**
+ * 同步整个目录
+ */
+function syncDirectory(src, dest, overwrite = true) {
+    // 确保目标目录存在
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    // 读取源目录所有文件
+    const files = fs.readdirSync(src);
+    let count = 0;
+    files.forEach(file => {
+        const srcFile = path.join(src, file);
+        const destFile = path.join(dest, file);
+        const stats = fs.statSync(srcFile);
+        if (stats.isDirectory()) {
+            // 递归处理子目录
+            syncDirectory(srcFile, destFile, overwrite);
+        }
+        else {
+            // 复制文件
+            if (overwrite || !fs.existsSync(destFile)) {
+                fs.copyFileSync(srcFile, destFile);
+                console.log(`[fullstack-cli] ✓ ${path.relative(dest, destFile)}`);
+                count++;
+            }
+        }
+    });
+    if (count > 0) {
+        console.log(`[fullstack-cli] Synced ${count} files to ${path.basename(dest)}/`);
+    }
+}
+/**
+ * 追加内容到文件
+ */
+function appendToFile(src, dest) {
+    const content = fs.readFileSync(src, 'utf-8');
+    // 读取目标文件内容（如果存在）
+    let existingContent = '';
+    if (fs.existsSync(dest)) {
+        existingContent = fs.readFileSync(dest, 'utf-8');
+    }
+    // 检查是否已包含相同内容（避免重复追加）
+    if (existingContent.includes(content.trim())) {
+        console.log(`[fullstack-cli] ○ ${path.basename(dest)} (already contains content)`);
+        return;
+    }
+    // 追加内容
+    fs.appendFileSync(dest, content);
+    console.log(`[fullstack-cli] ✓ ${path.basename(dest)} (appended)`);
+}
+/**
+ * 设置文件权限
+ */
+function setPermissions(permissions, projectRoot) {
+    for (const [pattern, mode] of Object.entries(permissions)) {
+        // 简单实现：只支持 **/*.sh 这种模式
+        if (pattern === '**/*.sh') {
+            const scriptsDir = path.join(projectRoot, 'scripts');
+            if (fs.existsSync(scriptsDir)) {
+                const files = fs.readdirSync(scriptsDir);
+                files.forEach(file => {
+                    if (file.endsWith('.sh')) {
+                        const filePath = path.join(scriptsDir, file);
+                        fs.chmodSync(filePath, mode);
+                    }
+                });
+            }
+        }
+    }
+}

package/dist/config/drizzle.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("drizzle-kit").Config;
+export default _default;

package/dist/config/drizzle.config.js

@@ -0,0 +1,19 @@
+import { defineConfig } from 'drizzle-kit';
+const outputDir = process.env.__DRIZZLE_OUT_DIR__ || './server/database/.introspect';
+const schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || './server/database/schema.ts';
+const parsedUrl = new URL(process.env.SUDA_DATABASE_URL || '');
+const schemaFilter = parsedUrl.searchParams.get('schema')?.split(',') ?? [];
+export default defineConfig({
+    schema: schemaPath,
+    out: outputDir,
+    tablesFilter: ['*'],
+    schemaFilter,
+    dialect: 'postgresql',
+    dbCredentials: {
+        host: parsedUrl.hostname,
+        port: Number(parsedUrl.port) || 5432,
+        user: decodeURIComponent(parsedUrl.username),
+        password: decodeURIComponent(parsedUrl.password),
+        database: parsedUrl.pathname.split('/')[1],
+    },
+});

package/dist/{postinstall.config.d.ts → config/sync.d.ts}

@@ -12,11 +12,10 @@ export interface SyncRule {
     /** 是否覆盖已存在的文件（仅 directory 和 file 类型有效） */
     overwrite?: boolean;
 }
-export interface PostinstallConfig {
+export interface SyncConfig {
     /** 派生规则 */
     sync: SyncRule[];
     /** 文件权限设置 */
     permissions?: Record<string, number>;
 }
-declare const config: PostinstallConfig;
-export default config;
+export declare const syncConfig: SyncConfig;

package/dist/{postinstall.config.js → config/sync.js}

@@ -2,7 +2,7 @@
  * fullstack-cli 派生配置
  * 定义哪些文件/目录需要同步到用户项目
  */
-const config = {
+export const syncConfig = {
     // 派生规则
     sync: [
         // 1. 派生 scripts 目录（总是覆盖）
@@ -12,23 +12,22 @@ const config = {
             type: 'directory',
             overwrite: true,
         },
-        // 2. 追加内容到 .gitignore
-        {
-            from: 'templates/.gitignore.append',
-            to: '.gitignore',
-            type: 'append',
-        },
+        // // 2. 追加内容到 .gitignore
+        // {
+        //   from: 'templates/.gitignore.append',
+        //   to: '.gitignore',
+        //   type: 'append',
+        // },
         // 3. 派生 server/type.ts 文件（总是覆盖）
-        {
-            from: 'templates/server/type.ts',
-            to: 'server/type.ts',
-            type: 'file',
-        },
+        // {
+        //   from: 'templates/server/global.d.ts',
+        //   to: 'server/types/global.d.ts',
+        //   type: 'file',
+        // },
     ],
     // 文件权限设置
     permissions: {
-        // 所有 .sh 文件设置为可执行
-        '**/*.sh': 0o755,
+    // 所有 .sh 文件设置为可执行
+    // '**/*.sh': 0o755,
     },
 };
-export default config;

package/dist/index.d.ts

@@ -1,10 +1 @@
-/**
- * @lark-apaas/fullstack-cli
- *
- * CLI tool for fullstack template management
- */
-export declare const version = "1.0.0";
-declare const _default: {
-    version: string;
-};
-export default _default;
+export {};

package/dist/index.js

@@ -1,9 +1,52 @@
-/**
- * @lark-apaas/fullstack-cli
- *
- * CLI tool for fullstack template management
- */
-export const version = '1.0.0';
-export default {
-    version,
-};
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import fs from 'node:fs';
+import cac from 'cac';
+import { run as runGenDbSchema } from './commands/gen-db-schema.js';
+import { run as runSync } from './commands/sync.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// 读取 package.json
+const pkgPath = path.join(__dirname, '../package.json');
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+const cli = cac('fullstack-cli');
+// 设置全局描述和版本
+cli
+    .version(pkg.version)
+    .help();
+// gen-db-schema 命令
+cli
+    .command('gen-db-schema', 'Generate database schema from existing database')
+    .option('--output <path>', 'Output path for schema', {
+    default: 'server/database/schema.ts',
+})
+    .option('--schema-filter <schemas>', 'Schema filter, comma-separated')
+    .option('--tables-filter <tables>', 'Tables filter, comma-separated')
+    .example('fullstack-cli gen-db-schema')
+    .example('fullstack-cli gen-db-schema --output custom/schema.ts')
+    .action(async (options) => {
+    try {
+        await runGenDbSchema(options);
+    }
+    catch (error) {
+        console.error(`Failed to execute command:`, error.message);
+        console.error(error.stack);
+        process.exit(1);
+    }
+});
+// sync 命令
+cli
+    .command('sync', 'Sync template files (scripts, configs) to user project')
+    .example('fullstack-cli sync')
+    .action(async () => {
+    try {
+        await runSync();
+    }
+    catch (error) {
+        console.error(`Failed to execute command:`, error.message);
+        console.error(error.stack);
+        process.exit(1);
+    }
+});
+// 解析命令行参数
+cli.parse();

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "0.1.0-alpha.9",
+  "version": "1.0.1-alpha.0",
   "description": "CLI tool for fullstack template management",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "bin": "./bin/cli.mjs",
+  "bin": "./bin/cli.js",
   "files": [
     "dist",
     "templates",
@@ -12,8 +13,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "postinstall": "node bin/sync-scripts.js"
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "fullstack",
@@ -30,6 +30,8 @@
   },
   "dependencies": {
     "@lark-apaas/devtool-kits": "^1.0.0",
+    "@vercel/nft": "^0.30.3",
+    "cac": "^6.7.14",
     "dotenv": "^16.0.0",
     "drizzle-kit": "0.31.5"
   },

package/templates/scripts/build.sh

@@ -1,37 +1,89 @@
 #!/usr/bin/env bash
+# This file is auto-generated by @lark-apaas/fullstack-cli
 set -euo pipefail
 
 ROOT_DIR="$(pwd)"
 OUT_DIR="$ROOT_DIR/dist/server"
 
-echo "===================="
-echo "0) 更新 openapi 代码"
-echo "===================="
+# 记录总开始时间
+TOTAL_START=$(node -e "console.log(Date.now())")
+
+# 打印耗时的辅助函数
+print_time() {
+  local start=$1
+  local end=$(node -e "console.log(Date.now())")
+  local elapsed=$((end - start))
+  local seconds=$((elapsed / 1000))
+  local ms=$((elapsed % 1000))
+  echo "   ⏱️  耗时: ${seconds}.$(printf "%03d" $ms)s"
+}
+
+echo "╔════════════════════════════════════════════════════════╗"
+echo "║              开始构建 - 智能裁剪版本                  ║"
+echo "╚════════════════════════════════════════════════════════╝"
+echo ""
+
+# ==================== 步骤 0 ====================
+echo "📝 [0/4] 更新 openapi 代码"
+STEP_START=$(node -e "console.log(Date.now())")
 npm run gen:openapi
+print_time $STEP_START
+echo ""
 
-echo "===================="
-echo "1) 清理 dist 目录"
-echo "===================="
+# ==================== 步骤 1 ====================
+echo "🗑️  [1/4] 清理 dist 目录"
+STEP_START=$(node -e "console.log(Date.now())")
 rm -rf "$ROOT_DIR/dist"
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 2 ====================
+echo "🔨 [2/4] 并行构建 server 和 client"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 并行构建
+echo "   ├─ 启动 server 构建..."
+npm run build:server > /tmp/build-server.log 2>&1 &
+SERVER_PID=$!
+
+echo "   ├─ 启动 client 构建..."
+npm run build:client > /tmp/build-client.log 2>&1 &
+CLIENT_PID=$!
+
+# 等待两个构建完成
+SERVER_EXIT=0
+CLIENT_EXIT=0
+
+wait $SERVER_PID || SERVER_EXIT=$?
+wait $CLIENT_PID || CLIENT_EXIT=$?
 
-echo "===================="
-echo "2) 构建项目"
-echo "===================="
-npm run build:prod
-echo "✅ Build completed"
+# 检查构建结果
+if [ $SERVER_EXIT -ne 0 ]; then
+  echo "   ❌ Server 构建失败"
+  cat /tmp/build-server.log
+  exit 1
+fi
+
+if [ $CLIENT_EXIT -ne 0 ]; then
+  echo "   ❌ Client 构建失败"
+  cat /tmp/build-client.log
+  exit 1
+fi
+
+echo "   ✅ Server 构建完成"
+echo "   ✅ Client 构建完成"
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 3 ====================
+echo "📦 [3/4] 准备 server 依赖产物"
+STEP_START=$(node -e "console.log(Date.now())")
 
-echo "===================="
-echo "3) 准备 server 产物目录"
-echo "===================="
 mkdir -p "$OUT_DIR/dist/client"
 
 # 拷贝 HTML
 cp "$ROOT_DIR/dist/client/"*.html "$OUT_DIR/dist/client/" || true
 
-# 拷贝 package.json
-cp "$ROOT_DIR/package.json" "$OUT_DIR/"
-[ -f "$ROOT_DIR/pnpm-lock.yaml" ] && cp "$ROOT_DIR/pnpm-lock.yaml" "$OUT_DIR/"
-
 # 拷贝 run.sh 文件
 cp "$ROOT_DIR/scripts/run.sh" "$OUT_DIR/"
 
@@ -39,11 +91,30 @@ cp "$ROOT_DIR/scripts/run.sh" "$OUT_DIR/"
 rm -rf "$ROOT_DIR/dist/scripts"
 rm -rf "$ROOT_DIR/dist/tsconfig.node.tsbuildinfo"
 
-echo "===================="
-echo "4) 复制 node_modules（仅生产依赖）"
-echo "===================="
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 4 ====================
+echo "✂️  [4/4] 智能依赖裁剪"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
+node "$ROOT_DIR/scripts/prune-smart.js"
+
+print_time $STEP_START
+echo ""
 
-npm prune --omit=dev
-cp -R "$ROOT_DIR/node_modules" "$OUT_DIR/"
+# 总耗时
+echo "╔════════════════════════════════════════════════════════╗"
+echo "║                  构建完成                              ║"
+echo "╚════════════════════════════════════════════════════════╝"
+print_time $TOTAL_START
 
-echo "✅ node_modules ready"
+# 输出产物信息
+DIST_SIZE=$(du -sh "$OUT_DIR" | cut -f1)
+NODE_MODULES_SIZE=$(du -sh "$OUT_DIR/node_modules" | cut -f1)
+echo ""
+echo "📊 构建产物统计:"
+echo "   总大小:        $DIST_SIZE"
+echo "   node_modules: $NODE_MODULES_SIZE"
+echo ""

package/templates/scripts/dev.sh

@@ -1,4 +1,6 @@
 #!/usr/bin/env bash
+# This file is auto-generated by @lark-apaas/fullstack-cli
+
 set -euo pipefail
 
 # Ensure the script always runs from the project root

package/templates/scripts/gen-openapi.ts

@@ -1,5 +1,6 @@
+// This file is auto-generated by @lark-apaas/fullstack-cli
 import { NestFactory } from '@nestjs/core';
-import { DevToolsModule } from '@lark-apaas/fullstack-nestjs-core';
+import { DevToolsV2Module } from '@lark-apaas/fullstack-nestjs-core';
 
 import { AppModule } from '../server/app.module';
 
@@ -17,7 +18,7 @@ async function generateOpenApi() {
     app.setGlobalPrefix(basePath);
   }
 
-  await DevToolsModule.mount(app, {
+  await DevToolsV2Module.mount(app, {
     basePath,
     docsPath: '/api_docs',
     needSetupServer: false,

package/templates/scripts/prune-smart.js

@@ -0,0 +1,270 @@
+#!/usr/bin/env node
+// This file is auto-generated by @lark-apaas/fullstack-cli, do not modify it manually.
+
+/**
+ * 智能依赖裁剪脚本 - 高性能版本
+ *
+ * 策略：
+ * 1. 分析 dist/server 下所有文件的实际依赖
+ * 2. **选择性复制**：只复制需要的包，而不是全部复制再删除
+ * 3. 生成精简的 package.json 到 dist/server
+ */
+
+const { nodeFileTrace } = require('@vercel/nft');
+const fs = require('fs');
+const path = require('path');
+
+const ROOT_DIR = path.resolve(__dirname, '..');
+const DIST_SERVER_DIR = path.join(ROOT_DIR, 'dist/server');
+const ROOT_PACKAGE_JSON = path.join(ROOT_DIR, 'package.json');
+const ROOT_NODE_MODULES = path.join(ROOT_DIR, 'node_modules');
+const OUT_NODE_MODULES = path.join(DIST_SERVER_DIR, 'node_modules');
+const OUT_PACKAGE_JSON = path.join(DIST_SERVER_DIR, 'package.json');
+
+// Node.js 内置模块列表
+const BUILTIN_MODULES = new Set([
+  'assert', 'buffer', 'child_process', 'cluster', 'crypto', 'dgram', 'dns',
+  'events', 'fs', 'http', 'http2', 'https', 'net', 'os', 'path', 'stream',
+  'string_decoder', 'timers', 'tls', 'url', 'util', 'v8', 'vm', 'zlib',
+  'async_hooks', 'perf_hooks', 'worker_threads', 'inspector', 'trace_events'
+]);
+
+/**
+ * 递归获取目录下所有 .js 文件
+ */
+function getJsFiles(dir) {
+  const files = [];
+
+  if (!fs.existsSync(dir)) {
+    console.error(`❌ 目录不存在: ${dir}`);
+    process.exit(1);
+  }
+
+  function traverse(currentDir) {
+    const items = fs.readdirSync(currentDir);
+    for (const item of items) {
+      const fullPath = path.join(currentDir, item);
+      const stat = fs.statSync(fullPath);
+
+      if (stat.isDirectory() && item !== 'node_modules') {
+        traverse(fullPath);
+      } else if (stat.isFile() && item.endsWith('.js')) {
+        files.push(fullPath);
+      }
+    }
+  }
+
+  traverse(dir);
+  return files;
+}
+
+/**
+ * 从完整路径中提取 npm 包名
+ */
+function extractPackageName(filePath) {
+  const parts = filePath.split('node_modules' + path.sep);
+  if (parts.length < 2) return null;
+
+  const afterNodeModules = parts[parts.length - 1];
+  const segments = afterNodeModules.split(path.sep);
+
+  // 处理 scoped package (@xxx/yyy)
+  if (segments[0].startsWith('@')) {
+    return segments[0] + '/' + segments[1];
+  }
+
+  return segments[0];
+}
+
+/**
+ * 递归删除目录
+ */
+function removeDir(dir) {
+  if (fs.existsSync(dir)) {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+/**
+ * 递归复制目录
+ */
+function copyDir(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 选择性复制包
+ */
+function copyPackagesSelectively(packages, rootNodeModules, outNodeModules) {
+  const copiedCount = { success: 0, failed: 0 };
+
+  // 确保输出目录存在
+  if (fs.existsSync(outNodeModules)) {
+    removeDir(outNodeModules);
+  }
+  fs.mkdirSync(outNodeModules, { recursive: true });
+
+  // 注意：不复制 .bin 目录，运行时不需要
+
+  // 复制每个包
+  for (const pkg of packages) {
+    const srcPath = path.join(rootNodeModules, pkg);
+    const destPath = path.join(outNodeModules, pkg);
+
+    if (!fs.existsSync(srcPath)) {
+      copiedCount.failed++;
+      continue;
+    }
+
+    try {
+      // 确保父目录存在（处理 scoped packages）
+      const destDir = path.dirname(destPath);
+      if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+      }
+
+      // 复制包目录
+      copyDir(srcPath, destPath);
+      copiedCount.success++;
+    } catch (err) {
+      console.error(`   ⚠️  复制失败: ${pkg} - ${err.message}`);
+      copiedCount.failed++;
+    }
+  }
+
+  return copiedCount;
+}
+
+/**
+ * 主函数：智能裁剪
+ */
+async function smartPrune() {
+  console.log('🔍 开始智能依赖分析...\n');
+
+  const totalStartTime = Date.now();
+
+  // 1. 获取所有 server 构建产物
+  const jsFiles = getJsFiles(DIST_SERVER_DIR);
+  console.log(`📂 找到 ${jsFiles.length} 个 JS 文件`);
+
+  if (jsFiles.length === 0) {
+    console.error('❌ 没有找到任何 JS 文件');
+    process.exit(1);
+  }
+
+  // 2. 使用 @vercel/nft 追踪依赖
+  console.log('🔎 追踪实际依赖...');
+  const analyzeStart = Date.now();
+
+  const { fileList } = await nodeFileTrace(jsFiles, {
+    base: ROOT_DIR,
+    processCwd: ROOT_DIR,
+    // 性能优化选项
+    cache: {},  // 启用缓存，避免重复分析相同文件
+    ignore: [
+      // 忽略明显不需要的文件类型
+      '**/*.md',
+      '**/*.ts',
+      '**/*.d.ts',
+      '**/test/**',
+      '**/tests/**',
+      '**/__tests__/**',
+      '**/examples/**',
+      '**/docs/**',
+      '**/.git/**',
+    ],
+  });
+
+  const analyzeElapsed = Date.now() - analyzeStart;
+  console.log(`   ✅ 分析完成，耗时: ${analyzeElapsed}ms\n`);
+
+  // 3. 提取 npm 包名
+  const requiredPackages = new Set();
+
+  for (const file of fileList) {
+    if (file.includes('node_modules')) {
+      const pkgName = extractPackageName(file);
+      if (pkgName && !BUILTIN_MODULES.has(pkgName)) {
+        requiredPackages.add(pkgName);
+      }
+    }
+  }
+
+  console.log(`📦 实际需要 ${requiredPackages.size} 个 npm 包\n`);
+
+  // 4. 选择性复制包（只复制需要的）
+  console.log('📋 选择性复制 node_modules（仅复制需要的包）...');
+  const copyStart = Date.now();
+
+  const sortedPackages = Array.from(requiredPackages).sort();
+  const copiedCount = copyPackagesSelectively(sortedPackages, ROOT_NODE_MODULES, OUT_NODE_MODULES);
+
+  const copyElapsed = Date.now() - copyStart;
+  console.log(`   ✅ 复制完成，耗时: ${copyElapsed}ms`);
+  console.log(`   成功: ${copiedCount.success} 个，失败: ${copiedCount.failed} 个\n`);
+
+  // 5. 读取原始 package.json 并生成精简版本
+  const originalPackage = JSON.parse(fs.readFileSync(ROOT_PACKAGE_JSON, 'utf8'));
+  const allDeps = {
+    ...originalPackage.dependencies || {},
+    ...originalPackage.devDependencies || {}
+  };
+
+  const prunedDependencies = {};
+  for (const pkg of requiredPackages) {
+    if (allDeps[pkg]) {
+      prunedDependencies[pkg] = allDeps[pkg];
+    }
+  }
+
+  const prunedPackage = {
+    name: originalPackage.name,
+    version: originalPackage.version,
+    private: true,
+    dependencies: prunedDependencies,
+    scripts: {
+      start: originalPackage.scripts?.start || 'node main.js'
+    },
+    engines: originalPackage.engines
+  };
+
+  fs.writeFileSync(OUT_PACKAGE_JSON, JSON.stringify(prunedPackage, null, 2));
+
+  const totalElapsed = Date.now() - totalStartTime;
+
+  // 6. 输出统计信息
+  console.log('='.repeat(60));
+  console.log('📊 智能裁剪统计:');
+  console.log('='.repeat(60));
+  console.log(`  需要的包数量:   ${requiredPackages.size}`);
+  console.log(`  成功复制:       ${copiedCount.success} 个`);
+  console.log(`  失败:           ${copiedCount.failed} 个`);
+  console.log(`  分析耗时:       ${analyzeElapsed}ms`);
+  console.log(`  复制耗时:       ${copyElapsed}ms`);
+  console.log(`  总耗时:         ${totalElapsed}ms`);
+  console.log('='.repeat(60) + '\n');
+
+  console.log('✅ 智能裁剪完成！');
+  console.log(`📍 精简的 package.json 已保存到: ${OUT_PACKAGE_JSON}\n`);
+}
+
+// 运行智能裁剪
+smartPrune().catch(err => {
+  console.error('❌ 智能裁剪失败:', err);
+  process.exit(1);
+});

package/templates/scripts/run.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# This file is auto-generated by @lark-apaas/fullstack-cli
 
 # 生产环境下，启动服务
 npm run start

package/templates/server/global.d.ts

@@ -0,0 +1,19 @@
+// automatically generated by fullstack-nestjs-core, do not edit manually
+declare namespace Express {
+  interface Request {
+    // don't depend on this field, it's used by client to get platform info
+    __platform_data__?: {
+      userId?: string;
+      tenantId?: string;
+      env?: string;
+      csrfToken?: string;
+      [key: string]: unknown;
+    };
+    userContext: {
+      userId?: string;
+      tenantId?: number;
+      appId?: string;
+    },
+    csrfToken?: string;
+  }
+}

package/bin/cli.mjs

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-import { createRequire } from 'node:module';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const require = createRequire(import.meta.url);
-
-const command = process.argv[2];
-const distPath = path.join(__dirname, '..', 'dist');
-
-async function main() {
-  try {
-    switch (command) {
-      case 'gen-db-schema': {
-        const modulePath = path.join(distPath, 'commands', 'gen-db-schema.js');
-        const { run } = await import(modulePath);
-        await run();
-        break;
-      }
-      case 'sync':
-      case 'postinstall': {
-        // 调用原有的 sync-scripts.js (CommonJS)
-        require('./sync-scripts.js');
-        break;
-      }
-      case '--version':
-      case '-v': {
-        const pkg = require('../package.json');
-        console.log(pkg.version);
-        break;
-      }
-      case '--help':
-      case '-h':
-      case undefined: {
-        showHelp();
-        break;
-      }
-      default: {
-        console.error(`Unknown command: ${command}`);
-        console.error('');
-        showHelp();
-        process.exit(1);
-      }
-    }
-  } catch (error) {
-    console.error(`Failed to execute command "${command}":`, error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-function showHelp() {
-  console.log(`
-Usage: fullstack-cli <command> [options]
-
-Commands:
-  gen-db-schema     Generate database schema from existing database
-  sync              Sync template files to user project (internal use)
-
-Options:
-  --version, -v     Show version number
-  --help, -h        Show help
-
-Environment Variables:
-  # gen-db-schema
-  SUDA_DATABASE_URL       Database connection URL (required)
-  DB_SCHEMA_OUTPUT        Output path for schema (default: server/database/schema.ts)
-  DRIZZLE_SCHEMA_FILTER   Schema filter, comma-separated (optional)
-  DRIZZLE_TABLES_FILTER   Tables filter (default: *)
-
-Examples:
-  $ fullstack-cli gen-db-schema
-  $ DB_SCHEMA_OUTPUT=custom/schema.ts fullstack-cli gen-db-schema
-
-Scripts (auto-generated):
-  scripts/gen-openapi.ts  - Generate OpenAPI documentation (use: npm run gen:openapi)
-  scripts/gen-db-schema.ts - Generate database schema (deprecated, use CLI command)
-`);
-}
-
-main();

package/bin/sync-scripts.js

@@ -1,183 +0,0 @@
-#!/usr/bin/env node
-
-const path = require('path');
-const fs = require('fs');
-
-// 主函数
-async function main() {
-  // 检测是否在用户项目中（通过 INIT_CWD 判断）
-  const userProjectRoot = process.env.INIT_CWD || process.cwd();
-  const pluginRoot = path.resolve(__dirname, '..');
-
-  // 只有在插件自己的开发目录中才跳过（避免在开发插件时触发 sync）
-  if (userProjectRoot === pluginRoot) {
-    console.log('[fullstack-cli] Skip syncing (installing plugin itself)');
-    process.exit(0);
-  }
-
-  // 检查是否存在 package.json，确保是有效的项目
-  const userPackageJson = path.join(userProjectRoot, 'package.json');
-  if (!fs.existsSync(userPackageJson)) {
-    console.log('[fullstack-cli] Skip syncing (not a valid npm project)');
-    process.exit(0);
-  }
-
-  try {
-    console.log('[fullstack-cli] Starting sync...');
-
-    // 加载配置文件（从 dist 目录加载编译后的配置）
-    const { default: config } = await import('../dist/postinstall.config.js');
-
-    if (!config || !config.sync) {
-      console.warn('[fullstack-cli] No sync configuration found');
-      process.exit(0);
-    }
-
-    // 执行同步规则
-    for (const rule of config.sync) {
-      await syncRule(rule, pluginRoot, userProjectRoot);
-    }
-
-    // 设置权限
-    if (config.permissions) {
-      setPermissions(config.permissions, userProjectRoot);
-    }
-
-    console.log('[fullstack-cli] Sync completed successfully ✅');
-  } catch (error) {
-    console.error('[fullstack-cli] Failed to sync:', error.message);
-    // 不阻塞安装过程
-    process.exit(0);
-  }
-}
-
-/**
- * 执行单个同步规则
- */
-async function syncRule(rule, pluginRoot, userProjectRoot) {
-  const srcPath = path.join(pluginRoot, rule.from);
-  const destPath = path.join(userProjectRoot, rule.to);
-
-  if (!fs.existsSync(srcPath)) {
-    console.warn(`[fullstack-cli] Source not found: ${rule.from}`);
-    return;
-  }
-
-  switch (rule.type) {
-    case 'directory':
-      syncDirectory(srcPath, destPath, rule.overwrite);
-      break;
-    case 'file':
-      syncFile(srcPath, destPath, rule.overwrite);
-      break;
-    case 'append':
-      appendToFile(srcPath, destPath);
-      break;
-    default:
-      console.warn(`[fullstack-cli] Unknown sync type: ${rule.type}`);
-  }
-}
-
-/**
- * 同步单个文件
- */
-function syncFile(src, dest, overwrite = true) {
-  // 确保目标目录存在
-  const destDir = path.dirname(dest);
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-
-  // 检查目标文件是否存在
-  if (fs.existsSync(dest) && !overwrite) {
-    console.log(`[fullstack-cli] ○ ${path.basename(dest)} (skipped, already exists)`);
-    return;
-  }
-
-  // 复制文件
-  fs.copyFileSync(src, dest);
-  console.log(`[fullstack-cli] ✓ ${path.basename(dest)}`);
-}
-
-/**
- * 同步整个目录
- */
-function syncDirectory(src, dest, overwrite = true) {
-  // 确保目标目录存在
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  // 读取源目录所有文件
-  const files = fs.readdirSync(src);
-  let count = 0;
-
-  files.forEach(file => {
-    const srcFile = path.join(src, file);
-    const destFile = path.join(dest, file);
-    const stats = fs.statSync(srcFile);
-
-    if (stats.isDirectory()) {
-      // 递归处理子目录
-      syncDirectory(srcFile, destFile, overwrite);
-    } else {
-      // 复制文件
-      if (overwrite || !fs.existsSync(destFile)) {
-        fs.copyFileSync(srcFile, destFile);
-        console.log(`[fullstack-cli] ✓ ${path.relative(dest, destFile)}`);
-        count++;
-      }
-    }
-  });
-
-  if (count > 0) {
-    console.log(`[fullstack-cli] Synced ${count} files to ${path.basename(dest)}/`);
-  }
-}
-
-/**
- * 追加内容到文件
- */
-function appendToFile(src, dest) {
-  const content = fs.readFileSync(src, 'utf-8');
-  
-  // 读取目标文件内容（如果存在）
-  let existingContent = '';
-  if (fs.existsSync(dest)) {
-    existingContent = fs.readFileSync(dest, 'utf-8');
-  }
-
-  // 检查是否已包含相同内容（避免重复追加）
-  if (existingContent.includes(content.trim())) {
-    console.log(`[fullstack-cli] ○ ${path.basename(dest)} (already contains content)`);
-    return;
-  }
-
-  // 追加内容
-  fs.appendFileSync(dest, content);
-  console.log(`[fullstack-cli] ✓ ${path.basename(dest)} (appended)`);
-}
-
-/**
- * 设置文件权限
- */
-function setPermissions(permissions, projectRoot) {
-  for (const [pattern, mode] of Object.entries(permissions)) {
-    // 简单实现：只支持 **/*.sh 这种模式
-    if (pattern === '**/*.sh') {
-      const scriptsDir = path.join(projectRoot, 'scripts');
-      if (fs.existsSync(scriptsDir)) {
-        const files = fs.readdirSync(scriptsDir);
-        files.forEach(file => {
-          if (file.endsWith('.sh')) {
-            const filePath = path.join(scriptsDir, file);
-            fs.chmodSync(filePath, mode);
-          }
-        });
-      }
-    }
-  }
-}
-
-// 运行主函数
-main();

package/templates/drizzle.config.ts

@@ -1,25 +0,0 @@
-import { defineConfig } from 'drizzle-kit';
-
-// 这个配置会被 fullstack-cli 在运行时动态处理
-// 通过环境变量传递具体参数
-const outputDir = process.env.__DRIZZLE_OUT_DIR__ || './server/database/.introspect';
-const schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || './server/database/schema.ts';
-
-const parsedUrl = new URL(process.env.SUDA_DATABASE_URL || '');
-const schemaFilter = parsedUrl.searchParams.get('schema')?.split(',') ?? [];
-
-const config = {
-  schema: schemaPath,
-  out: outputDir,
-  tablesFilter: ['*'],
-  schemaFilter,
-  dialect: 'postgresql',
-  dbCredentials: {
-    host: parsedUrl.hostname,
-    port: Number(parsedUrl.port) || 5432,
-    user: decodeURIComponent(parsedUrl.username),
-    password: decodeURIComponent(parsedUrl.password),
-    database: parsedUrl.pathname.split('/')[1],
-  },
-}
-export default defineConfig(config);

package/templates/server/type.ts

@@ -1,4 +0,0 @@
-export interface ServerType {
-  // 服务器类型
-  serverType: string;
-}