befly 2.3.3 → 3.0.0

package/apis/health/info.ts

@@ -0,0 +1,64 @@
+/**
+ * 健康检查接口 - TypeScript 版本
+ * 检查服务器、Redis、数据库等状态
+ */
+
+import { Env } from '../../config/env.js';
+import { Api } from '../../utils/api.js';
+import { Yes } from '../../utils/index.js';
+import type { BeflyContext } from '../../types/befly.js';
+import type { HealthInfo } from '../../types/api.js';
+
+export default Api('健康检查', {
+    fields: {},
+    required: [],
+    handler: async (befly: BeflyContext, ctx: any) => {
+        const info: HealthInfo = {
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            memory: process.memoryUsage(),
+            runtime: 'Bun',
+            version: Bun.version,
+            platform: process.platform,
+            arch: process.arch
+        };
+
+        // 检查 Redis 连接状态
+        if (Env.REDIS_ENABLE === 1) {
+            if (befly.redis) {
+                try {
+                    await befly.redis.getRedisClient().ping();
+                    info.redis = '已连接';
+                } catch (error: any) {
+                    info.redis = '未连接';
+                    info.redisError = error.message;
+                }
+            } else {
+                info.redis = '未开启';
+            }
+        } else {
+            info.redis = '禁用';
+        }
+
+        // 检查数据库连接状态
+        if (Env.DB_ENABLE === 1) {
+            if (befly.db) {
+                try {
+                    // 执行简单查询测试连接
+                    await befly.db.query('SELECT 1');
+                    info.database = '已连接';
+                } catch (error: any) {
+                    info.database = '未连接';
+                    info.databaseError = error.message;
+                }
+            } else {
+                info.database = '未开启';
+            }
+        } else {
+            info.database = '禁用';
+        }
+
+        return Yes('健康检查成功', info);
+    }
+});

package/apis/tool/tokenCheck.ts

@@ -0,0 +1,51 @@
+/**
+ * 令牌检测接口 - TypeScript 版本
+ * 验证 JWT 令牌是否有效
+ */
+
+import { Env } from '../../config/env.js';
+import { Api } from '../../utils/api.js';
+import { Yes, No } from '../../utils/index.js';
+import { Jwt } from '../../utils/jwt.js';
+import type { BeflyContext } from '../../types/befly.js';
+import type { JwtPayload } from '../../utils/jwt.js';
+import type { TokenCheckData } from '../../types/api.js';
+
+export default Api('令牌检测', {
+    fields: {},
+    required: [],
+    handler: async (befly: BeflyContext, ctx: any) => {
+        // 从 Authorization 头获取 token
+        const authHeader = ctx.req?.headers?.get('authorization') || '';
+        const token = authHeader.split(' ')[1] || '';
+
+        if (!token) {
+            return No('令牌不能为空');
+        }
+
+        try {
+            // 验证令牌
+            const jwtData = await Jwt.verify(token);
+
+            // 计算剩余有效期
+            const expiresIn = jwtData.exp ? jwtData.exp - Math.floor(Date.now() / 1000) : undefined;
+
+            const data: TokenCheckData = {
+                valid: true,
+                payload: jwtData,
+                expiresIn
+            };
+
+            return Yes('令牌有效', data);
+        } catch (error: any) {
+            // 针对预期的令牌错误，返回友好提示（非致命错误）
+            if (error.message.includes('expired')) {
+                return No('令牌已过期', { expired: true });
+            } else if (error.message.includes('invalid')) {
+                return No('令牌无效', { invalid: true });
+            }
+            // 其他未知错误向上抛出，由路由层统一处理
+            throw error;
+        }
+    }
+});

package/bin/befly.ts

@@ -0,0 +1,202 @@
+#!/usr/bin/env -S bun run
+/**
+ * Befly CLI - TypeScript 版本
+ * 列出并执行 core/scripts 与 tpl/scripts 下的脚本
+ */
+
+import path from 'node:path';
+import { Glob } from 'bun';
+import { __dirscript as coreScriptsDir, getProjectDir } from '../system.js';
+
+/**
+ * 脚本项接口
+ */
+interface ScriptItem {
+    /** 脚本名称 */
+    name: string;
+    /** 脚本来源 (core 或 tpl) */
+    source: 'core' | 'tpl';
+    /** 是否与另一来源的脚本重名 */
+    duplicate: boolean;
+    /** 脚本完整路径 */
+    path: string;
+}
+
+/**
+ * 命令行参数接口
+ */
+interface CliArgs {
+    /** 是否为预演模式（只输出计划不执行） */
+    DRY_RUN: boolean;
+}
+
+// 解析目录（来自 system.js）
+// 核心脚本目录：core/scripts
+// 用户项目（如 tpl）的脚本目录：始终基于当前工作目录
+const tplScriptsDir = getProjectDir('scripts');
+
+/**
+ * 安全地列出目录下的所有 .js/.ts 脚本文件
+ * @param dir - 目录路径
+ * @returns 脚本名称数组（不含扩展名）
+ */
+function safeList(dir: string): string[] {
+    try {
+        // 使用 Bun.Glob 查找当前目录下的所有 .js 和 .ts 文件（不递归）
+        const glob = new Glob('*.{js,ts}');
+        const files = Array.from(
+            glob.scanSync({
+                cwd: dir,
+                absolute: false,
+                onlyFiles: true,
+                dot: false
+            })
+        );
+        // 移除扩展名并排序
+        return files
+            .map((f) => {
+                const basename = path.basename(f);
+                return basename.replace(/\.(js|ts)$/, '');
+            })
+            .sort();
+    } catch {
+        return [];
+    }
+}
+
+/**
+ * 构建所有可用脚本的列表
+ * @returns 脚本项数组
+ */
+function buildScriptItems(): ScriptItem[] {
+    const coreList = safeList(coreScriptsDir);
+    const tplList = safeList(tplScriptsDir);
+    const coreSet = new Set(coreList);
+
+    const items: ScriptItem[] = [];
+
+    // 添加核心脚本
+    for (const name of coreList) {
+        items.push({
+            name: name,
+            source: 'core',
+            duplicate: tplList.includes(name),
+            path: path.resolve(coreScriptsDir, `${name}.js`) // 优先 .js
+        });
+    }
+
+    // 添加用户脚本
+    for (const name of tplList) {
+        items.push({
+            name: name,
+            source: 'tpl',
+            duplicate: coreSet.has(name),
+            path: path.resolve(tplScriptsDir, `${name}.js`) // 优先 .js
+        });
+    }
+
+    // 排序：名称字典序，core 在前
+    items.sort((a, b) => {
+        if (a.name === b.name) {
+            return a.source === b.source ? 0 : a.source === 'core' ? -1 : 1;
+        }
+        return a.name.localeCompare(b.name);
+    });
+
+    return items;
+}
+
+/**
+ * 打印所有可用的脚本列表
+ */
+function printAllScripts(): void {
+    const items = buildScriptItems();
+    if (items.length === 0) {
+        console.log('  • <无>');
+        return;
+    }
+    for (const it of items) {
+        if (it.source === 'tpl' && it.duplicate) {
+            console.log(`  • ${it.name}（重复）`);
+        } else {
+            console.log(`  • ${it.name}`);
+        }
+    }
+}
+
+/**
+ * 解析脚本名称到完整路径
+ * @param name - 脚本名称（可带或不带 .js/.ts 扩展名）
+ * @returns 脚本完整路径，未找到返回 null
+ */
+async function resolveScriptPath(name: string): Promise<string | null> {
+    // 移除扩展名
+    const base = name.replace(/\.(js|ts)$/, '');
+
+    // 检查 .ts 文件（优先）
+    const coreTsPath = path.resolve(coreScriptsDir, `${base}.ts`);
+    const tplTsPath = path.resolve(tplScriptsDir, `${base}.ts`);
+    if (await Bun.file(coreTsPath).exists()) return coreTsPath;
+    if (await Bun.file(tplTsPath).exists()) return tplTsPath;
+
+    // 回退到 .js 文件
+    const coreJsPath = path.resolve(coreScriptsDir, `${base}.js`);
+    const tplJsPath = path.resolve(tplScriptsDir, `${base}.js`);
+    if (await Bun.file(coreJsPath).exists()) return coreJsPath;
+    if (await Bun.file(tplJsPath).exists()) return tplJsPath;
+
+    // 回退到列表匹配（防止极端路径或大小写差异）
+    const items = buildScriptItems();
+    const hit = items.find((it) => it.name.toLowerCase() === base.toLowerCase() && it.source === 'core') || items.find((it) => it.name.toLowerCase() === base.toLowerCase());
+
+    return hit ? hit.path : null;
+}
+
+/**
+ * 在指定路径运行脚本
+ * @param targetPath - 脚本完整路径
+ * @param label - 脚本标签（用于日志）
+ * @param args - 传递给脚本的参数
+ * @returns 脚本退出码
+ */
+async function runScriptAtPath(targetPath: string, label: string, args: string[] = []): Promise<number> {
+    const bunExe = process.execPath || 'bun';
+    const child = Bun.spawn({
+        cmd: [bunExe, targetPath, ...args],
+        stdio: ['inherit', 'inherit', 'inherit'],
+        cwd: process.cwd(),
+        env: { ...process.env, LOG_TO_CONSOLE: '1' }
+    });
+    const code = await child.exited;
+    return code ?? 0;
+}
+
+/**
+ * CLI 主函数
+ */
+async function main(): Promise<void> {
+    const [, , cmd, ...args] = process.argv;
+
+    // 无参数：打印所有脚本
+    if (!cmd) {
+        printAllScripts();
+        process.exit(0);
+    }
+
+    // 按名称执行（将剩余参数透传给脚本）
+    const target = await resolveScriptPath(cmd);
+    if (!target) {
+        console.error(`未找到脚本: ${cmd}`);
+        printAllScripts();
+        process.exit(1);
+    }
+
+    const code = await runScriptAtPath(target, cmd, args);
+    process.exit(code ?? 0);
+}
+
+// 启动 CLI
+main().catch((e: Error) => {
+    console.error('Befly CLI 执行失败:', e);
+    process.exit(1);
+});