befly 3.4.6 → 3.4.7

package/bin/index.ts

@@ -3,6 +3,20 @@
  * Befly CLI - 命令行工具入口
  * 为 Befly 框架提供项目管理和脚本执行功能
  */
+
+/**
+ * 环境启动器
+ * 必须在任何模块导入前执行
+ * 父进程会在这里启动子进程并退出
+ * 只有子进程会继续执行后面的代码
+ */
+import { launch } from './launcher.js';
+await launch(import.meta.path);
+
+/**
+ * 以下代码只在子进程中执行
+ * 此时环境变量已正确加载
+ */
 import { Command } from 'commander';
 import { scriptCommand } from '../commands/script.js';
 import { devCommand } from '../commands/dev.js';
@@ -110,16 +124,16 @@ program.command('build').description('构建项目').option('-o, --outdir <path>
 program.command('start').description('启动生产服务器').option('-p, --port <number>', '端口号', '3000').option('-h, --host <string>', '主机地址', '0.0.0.0').option('-c, --cluster <instances>', '集群模式（数字或 max）').action(startCommand);
 
 // syncDb 命令 - 同步数据库
-program.command('syncDb').description('同步数据库表结构').option('-t, --table <name>', '指定表名').option('--dry-run', '预览模式，只显示不执行', false).action(syncDbCommand);
+program.command('syncDb').description('同步数据库表结构').option('-t, --table <name>', '指定表名').option('--dry-run', '预览模式，只显示不执行', false).option('-e, --env <environment>', '指定环境 (development, production, test)').action(syncDbCommand);
 
 // syncApi 命令 - 同步 API 接口
-program.command('syncApi').description('同步 API 接口到数据库').option('--plan', '计划模式，只显示不执行', false).action(syncApiCommand);
+program.command('syncApi').description('同步 API 接口到数据库').option('--plan', '计划模式，只显示不执行', false).option('-e, --env <environment>', '指定环境 (development, production, test)').action(syncApiCommand);
 
 // syncMenu 命令 - 同步菜单
-program.command('syncMenu').description('同步菜单配置到数据库').option('--plan', '计划模式，只显示不执行', false).action(syncMenuCommand);
+program.command('syncMenu').description('同步菜单配置到数据库').option('--plan', '计划模式，只显示不执行', false).option('-e, --env <environment>', '指定环境 (development, production, test)').action(syncMenuCommand);
 
 // syncDev 命令 - 同步开发者账号
-program.command('syncDev').description('同步开发者管理员账号').option('--plan', '计划模式，只显示不执行', false).action(syncDevCommand);
+program.command('syncDev').description('同步开发者管理员账号').option('--plan', '计划模式，只显示不执行', false).option('-e, --env <environment>', '指定环境 (development, production, test)').action(syncDevCommand);
 
 // addon 命令 - 插件管理
 const addon = program.command('addon').description('管理 Befly 插件');

package/bin/launcher.ts

@@ -0,0 +1,109 @@
+/**
+ * Befly CLI 环境启动器
+ * 负责检测环境参数并在正确的环境中启动子进程
+ *
+ * 工作原理：
+ * 1. 父进程：检测 --env 参数 → 启动子进程 → 退出
+ * 2. 子进程：跳过启动逻辑 → 继续执行 CLI 命令
+ */
+
+import { readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * 解析环境名称
+ * 支持前缀匹配（至少3个字符）
+ *
+ * @param input 用户输入的环境名称
+ * @returns 完整的环境名称
+ */
+function resolveEnvName(input: string): string {
+    // 如果输入少于3个字符，直接返回（不做匹配）
+    if (input.length < 3) {
+        return input;
+    }
+
+    // 获取项目根目录的所有 .env.* 文件
+    const rootDir = process.cwd();
+    let envFiles: string[] = [];
+
+    try {
+        const files = readdirSync(rootDir);
+        envFiles = files.filter((file) => file.startsWith('.env.') && file !== '.env.example').map((file) => file.replace('.env.', ''));
+    } catch (error) {
+        // 读取失败时直接返回原始输入
+        return input;
+    }
+
+    // 精确匹配
+    if (envFiles.includes(input)) {
+        return input;
+    }
+
+    // 前缀匹配
+    const matches = envFiles.filter((env) => env.startsWith(input.toLowerCase()));
+
+    if (matches.length === 1) {
+        return matches[0];
+    }
+
+    if (matches.length > 1) {
+        console.error(`❌ 环境名称 "${input}" 匹配到多个环境: ${matches.join(', ')}`);
+        console.error('请使用更具体的名称');
+        process.exit(1);
+    }
+
+    // 未匹配到，返回原始输入（让 Bun 处理文件不存在的情况）
+    return input;
+}
+
+/**
+ * 启动环境检测和子进程
+ * 如果在父进程中，会启动子进程并退出（不返回）
+ * 如果在子进程中，直接返回（继续执行）
+ *
+ * @param entryFile CLI 入口文件的绝对路径（通常是 bin/index.ts）
+ */
+export async function launch(entryFile: string): Promise<void> {
+    // 如果已经在子进程中，直接返回
+    if (process.env.BEFLY_SUBPROCESS) {
+        return;
+    }
+
+    // 确定环境名称
+    const envArgIndex = process.argv.indexOf('--env');
+    let envInput = 'development'; // 默认环境
+
+    if (envArgIndex !== -1 && process.argv[envArgIndex + 1]) {
+        // 如果指定了 --env 参数
+        envInput = process.argv[envArgIndex + 1];
+    } else if (process.env.NODE_ENV) {
+        // 如果设置了 NODE_ENV 环境变量
+        envInput = process.env.NODE_ENV;
+    }
+
+    // 解析环境名称（支持前缀匹配）
+    const envName = resolveEnvName(envInput);
+    const envFile = `.env.${envName}`;
+
+    // 过滤掉 --env 参数（已通过 --env-file 处理）
+    const filteredArgs = process.argv.slice(2).filter((arg, i, arr) => {
+        if (arg === '--env') return false;
+        if (arr[i - 1] === '--env') return false;
+        return true;
+    });
+
+    // 启动子进程，使用指定的环境文件
+    const proc = Bun.spawn(['bun', 'run', `--env-file=${envFile}`, entryFile, ...filteredArgs], {
+        cwd: process.cwd(),
+        stdio: ['inherit', 'inherit', 'inherit'],
+        env: {
+            ...process.env,
+            BEFLY_SUBPROCESS: '1', // 标记为子进程
+            NODE_ENV: envName // 同时设置 NODE_ENV
+        }
+    });
+
+    // 等待子进程结束并退出（父进程不会返回）
+    process.exit(await proc.exited);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.4.6",
+    "version": "3.4.7",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -81,5 +81,5 @@
         "ora": "^9.0.0",
         "pathe": "^2.0.3"
     },
-    "gitHead": "157f48d9170ab671919a4999050531469072bddf"
+    "gitHead": "754e5afe468859c551011ba4f8e5d70b3d0c0659"
 }