befly 3.17.0 → 3.17.3

package/README.md

@@ -3,3 +3,9 @@
 ![野蜂飞舞](https://static.yicode.tech/befly.svg)
 
 > 道生一，一生二，二生三，三生万物
+
+```js
+"bundle": "bun build ./index.js --outfile ./befly.js --target bun --format esm --packages bundle",
+"bundle:min": "bun build ./index.js --outfile ./befly.min.js --target bun --format esm --packages bundle --minify",
+"build": "rimraf befly.js befly.min.js && bun run bundle && bun run bundle:min"
+```

package/apis/admin/cacheRefresh.js

@@ -0,0 +1,122 @@
+/**
+ * 刷新全部缓存接口
+ *
+ * 功能：
+ * 1. 刷新接口缓存（apis:all）
+ * 2. 刷新菜单缓存（menus:all）
+ * 3. 刷新角色缓存（role:info:{code}）
+ * 4. 重建角色接口权限缓存（role:apis:{code}，Set）
+ * 5. 重建角色菜单权限缓存（role:menus:{code}，Set）
+ *
+ * 使用场景：
+ * - 执行数据库同步后
+ * - 手动修改配置需要立即生效
+ * - 缓存出现异常需要重建
+ */
+
+import { isNonEmptyString } from "../../utils/is.js";
+
+export default {
+    name: "刷新全部缓存",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {},
+    required: [],
+    handler: async (befly, _ctx) => {
+        try {
+            const results = {
+                apis: { success: false, count: 0 },
+                menus: { success: false, count: 0 },
+                roles: { success: false, count: 0 },
+                roleApiPermissions: { success: false },
+                roleMenuPermissions: { success: false }
+            };
+
+            // 1. 刷新接口缓存
+            try {
+                const apis = await befly.mysql.getAll({
+                    table: "beflyApi"
+                });
+
+                await befly.redis.setObject("apis:all", apis.data.lists);
+                results["apis"] = { success: true, count: apis.data.lists.length };
+            } catch (error) {
+                befly.logger.error("刷新接口缓存失败", error);
+                results["apis"] = { success: false, error: error.message };
+            }
+
+            // 2. 刷新菜单缓存
+            try {
+                const menus = await befly.mysql.getAll({
+                    table: "beflyMenu"
+                });
+
+                await befly.redis.setObject("menus:all", menus.data.lists);
+
+                const parentCount = menus.data.lists.filter((m) => !isNonEmptyString(m.parentPath)).length;
+                const childCount = menus.data.lists.filter((m) => isNonEmptyString(m.parentPath)).length;
+
+                results["menus"] = {
+                    success: true,
+                    count: menus.data.lists.length,
+                    parentCount: parentCount,
+                    childCount: childCount
+                };
+            } catch (error) {
+                befly.logger.error("刷新菜单缓存失败", error);
+                results["menus"] = { success: false, error: error.message };
+            }
+
+            // 3. 刷新角色权限缓存
+            try {
+                const roles = await befly.mysql.getAll({
+                    table: "beflyRole"
+                });
+
+                // 使用 setBatch 批量缓存所有角色
+                const count = await befly.redis.setBatch(
+                    roles.data.lists.map((role) => ({
+                        key: `role:info:${role.code}`,
+                        value: role
+                    }))
+                );
+
+                results["roles"] = { success: true, count: count };
+            } catch (error) {
+                befly.logger.error("刷新角色缓存失败", error);
+                results["roles"] = { success: false, error: error.message };
+            }
+
+            // 4. 重建角色接口权限缓存（版本化 + 原子切换）
+            try {
+                await befly.cache.cacheRoleApis();
+                results["roleApiPermissions"] = { success: true };
+            } catch (error) {
+                befly.logger.error("重建角色接口权限缓存失败", error);
+                results["roleApiPermissions"] = { success: false, error: error.message };
+            }
+
+            // 5. 重建角色菜单权限缓存
+            try {
+                await befly.cache.cacheRoleMenus();
+                results["roleMenuPermissions"] = { success: true };
+            } catch (error) {
+                befly.logger.error("重建角色菜单权限缓存失败", error);
+                results["roleMenuPermissions"] = { success: false, error: error.message };
+            }
+
+            // 检查是否全部成功
+            const allSuccess = results["apis"].success && results["menus"].success && results["roles"].success && results["roleApiPermissions"].success && results["roleMenuPermissions"].success;
+
+            if (allSuccess) {
+                return befly.tool.Yes("全部缓存刷新成功", results);
+            } else {
+                return befly.tool.No("部分缓存刷新失败", results);
+            }
+        } catch (error) {
+            befly.logger.error("刷新全部缓存失败", error);
+            return befly.tool.No("刷新全部缓存失败", { error: error.message });
+        }
+    }
+};

package/apis/admin/del.js

@@ -0,0 +1,34 @@
+export default {
+    name: "删除管理员",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        id: { name: "ID", input: "integer", min: 1, max: null }
+    },
+    required: ["id"],
+    handler: async (befly, ctx) => {
+        // 检查管理员是否存在
+        const adminData = await befly.mysql.getOne({
+            table: "beflyAdmin",
+            where: { id: ctx.body.id }
+        });
+
+        if (!adminData.data?.id) {
+            return befly.tool.No("管理员不存在");
+        }
+
+        // 不能删除 dev 角色的管理员
+        if (adminData.data.roleCode === "dev") {
+            return befly.tool.No("不能删除开发管理员");
+        }
+
+        // 删除管理员
+        await befly.mysql.delData({
+            table: "beflyAdmin",
+            where: { id: ctx.body.id }
+        });
+
+        return befly.tool.Yes("删除成功");
+    }
+};

package/apis/admin/detail.js

@@ -0,0 +1,23 @@
+export default {
+    name: "获取管理员信息",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        id: { name: "ID", input: "integer", min: 1, max: null }
+    },
+    required: [],
+    handler: async (befly, ctx) => {
+        const adminData = await befly.mysql.getOne({
+            table: "beflyAdmin",
+            fields: ["!password"],
+            where: { id: ctx.userId }
+        });
+
+        if (!adminData.data?.id) {
+            return befly.tool.No("管理员不存在");
+        }
+
+        return befly.tool.Yes("查询成功", adminData.data);
+    }
+};

package/apis/admin/ins.js

@@ -0,0 +1,69 @@
+import adminTable from "../../tables/admin.json";
+import { isString } from "../../utils/is.js";
+
+export default {
+    name: "添加管理员",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        username: adminTable.username,
+        password: adminTable.password,
+        nickname: adminTable.nickname,
+        roleCode: adminTable.roleCode
+    },
+    required: ["username", "password", "roleCode"],
+    handler: async (befly, ctx) => {
+        // 检查用户名是否已存在
+        const existingByUsername = await befly.mysql.getOne({
+            table: "beflyAdmin",
+            where: { username: ctx.body.username }
+        });
+
+        if (existingByUsername.data?.id) {
+            return befly.tool.No("用户名已被使用");
+        }
+
+        // 检查昵称是否已存在
+        if (ctx.body.nickname) {
+            const existingByNickname = await befly.mysql.getOne({
+                table: "beflyAdmin",
+                where: { nickname: ctx.body.nickname }
+            });
+
+            if (existingByNickname.data?.id) {
+                return befly.tool.No("昵称已被使用");
+            }
+        }
+
+        // 查询角色信息
+        const roleData = await befly.mysql.getOne({
+            table: "beflyRole",
+            where: { code: ctx.body.roleCode }
+        });
+
+        if (!roleData.data?.id) {
+            return befly.tool.No("角色不存在");
+        }
+
+        // 加密密码
+        const incoming = isString(ctx.body.password) ? ctx.body.password.toLowerCase() : "";
+        const isSha256Hex = /^[a-f0-9]{64}$/.test(incoming);
+        const hashedPassword = isSha256Hex ? befly.tool.sha256(incoming) : befly.tool.sha256(befly.tool.sha256(ctx.body.password));
+
+        // 创建管理员
+        const adminId = await befly.mysql.insData({
+            table: "beflyAdmin",
+            data: {
+                username: ctx.body.username,
+                password: hashedPassword,
+                nickname: ctx.body.nickname,
+                roleCode: ctx.body.roleCode
+            }
+        });
+
+        return befly.tool.Yes("添加成功", {
+            id: adminId.data
+        });
+    }
+};

package/apis/admin/list.js

@@ -0,0 +1,28 @@
+export default {
+    name: "查询管理员列表",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        page: { name: "页码", input: "integer", min: 1, max: 9999 },
+        limit: { name: "每页数量", input: "integer", min: 1, max: 100 },
+        keyword: { name: "关键词", input: "string", min: 0, max: 50 },
+        state: { name: "状态", input: "integer", min: 0, max: 2 }
+    },
+    required: [],
+    handler: async (befly, ctx) => {
+        const result = await befly.mysql.getList({
+            table: "beflyAdmin",
+            page: ctx.body.page,
+            limit: ctx.body.limit,
+            where: {
+                roleCode: {
+                    $ne: "dev"
+                }
+            },
+            orderBy: ["createdAt#DESC"]
+        });
+
+        return befly.tool.Yes("获取成功", result.data);
+    }
+};

package/apis/admin/upd.js

@@ -0,0 +1,95 @@
+import adminTable from "../../tables/admin.json";
+
+export default {
+    name: "更新管理员",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        id: { name: "ID", input: "integer", min: 1, max: null },
+        username: adminTable.username,
+        nickname: adminTable.nickname,
+        roleCode: adminTable.roleCode,
+        avatar: adminTable.avatar,
+        email: adminTable.email,
+        lastLoginIp: adminTable.lastLoginIp,
+        lastLoginTime: adminTable.lastLoginTime,
+        password: adminTable.password,
+        phone: adminTable.phone,
+        roleType: adminTable.roleType
+    },
+    required: ["id"],
+    handler: async (befly, ctx) => {
+        const id = ctx.body.id;
+        const username = ctx.body.username;
+        const nickname = ctx.body.nickname;
+        const roleCode = ctx.body.roleCode;
+
+        // 检查管理员是否存在
+        const admin = await befly.mysql.getOne({
+            table: "beflyAdmin",
+            where: { id: id }
+        });
+
+        if (!admin.data?.id) {
+            return befly.tool.No("管理员不存在");
+        }
+
+        // 检查用户名是否已被其他管理员使用
+        if (username && username !== admin.data.username) {
+            const existingUsername = await befly.mysql.getOne({
+                table: "beflyAdmin",
+                where: { username: username, id: { $ne: id } }
+            });
+            if (existingUsername.data?.id) {
+                return befly.tool.No("用户名已被使用");
+            }
+        }
+
+        // 检查昵称是否已被其他管理员使用
+        if (nickname && nickname !== admin.data.nickname) {
+            const existingNickname = await befly.mysql.getOne({
+                table: "beflyAdmin",
+                where: { nickname: nickname, id: { $ne: id } }
+            });
+            if (existingNickname.data?.id) {
+                return befly.tool.No("昵称已被使用");
+            }
+        }
+
+        // 检查角色是否存在
+        if (roleCode && roleCode !== admin.data.roleCode) {
+            const role = await befly.mysql.getOne({
+                table: "beflyRole",
+                where: { code: roleCode }
+            });
+            if (!role.data?.id) {
+                return befly.tool.No("角色不存在");
+            }
+        }
+
+        // 构建更新数据
+        const dataToUpdate = {};
+
+        if (ctx.body.avatar !== undefined) dataToUpdate["avatar"] = ctx.body.avatar;
+        if (ctx.body.email !== undefined) dataToUpdate["email"] = ctx.body.email;
+        if (ctx.body.lastLoginIp !== undefined) dataToUpdate["lastLoginIp"] = ctx.body.lastLoginIp;
+        if (ctx.body.lastLoginTime !== undefined) dataToUpdate["lastLoginTime"] = ctx.body.lastLoginTime;
+        if (ctx.body.password !== undefined) dataToUpdate["password"] = ctx.body.password;
+        if (ctx.body.phone !== undefined) dataToUpdate["phone"] = ctx.body.phone;
+        if (ctx.body.roleType !== undefined) dataToUpdate["roleType"] = ctx.body.roleType;
+
+        if (username !== undefined) dataToUpdate["username"] = username;
+        if (nickname !== undefined) dataToUpdate["nickname"] = nickname;
+        if (roleCode !== undefined) dataToUpdate["roleCode"] = roleCode;
+
+        // 更新管理员信息
+        await befly.mysql.updData({
+            table: "beflyAdmin",
+            data: dataToUpdate,
+            where: { id: id }
+        });
+
+        return befly.tool.Yes("更新成功");
+    }
+};

package/apis/api/all.js

@@ -0,0 +1,24 @@
+export default {
+    name: "获取所有接口",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {},
+    required: [],
+    handler: async (befly) => {
+        try {
+            const allApis = await befly.cache.getApis();
+
+            if (allApis.length === 0) {
+                return befly.tool.No("接口缓存不存在，请刷新缓存", { lists: [] });
+            }
+
+            const lists = allApis.filter((api) => api && typeof api === "object");
+
+            return befly.tool.Yes("操作成功", { lists: lists });
+        } catch (error) {
+            befly.logger.error("获取接口列表失败", error);
+            return befly.tool.No("获取接口列表失败");
+        }
+    }
+};

package/apis/api/list.js

@@ -0,0 +1,31 @@
+export default {
+    name: "获取接口列表",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {
+        page: { name: "页码", input: "integer", min: 1, max: 9999 },
+        limit: { name: "每页数量", input: "integer", min: 1, max: 100 },
+        keyword: { name: "关键词", input: "string", min: 0, max: 50 },
+        state: { name: "状态", input: "integer", min: 0, max: 2 }
+    },
+    required: [],
+    handler: async (befly, ctx) => {
+        try {
+            const result = await befly.mysql.getList({
+                table: "beflyApi",
+                where: {
+                    $or: [{ name$like: `%${ctx.body.keyword}%` }, { path$like: `%${ctx.body.keyword}%` }]
+                },
+                orderBy: ["id#ASC"],
+                page: ctx.body.page,
+                limit: ctx.body.limit
+            });
+
+            return befly.tool.Yes("操作成功", result.data);
+        } catch (error) {
+            befly.logger.error("获取接口列表失败", error);
+            return befly.tool.No("获取接口列表失败");
+        }
+    }
+};

package/apis/auth/login.js

@@ -0,0 +1,123 @@
+import { UAParser } from "ua-parser-js";
+
+import adminTable from "../../tables/admin.json";
+import { toSessionTtlSeconds } from "../../utils/toSessionTtlSeconds.js";
+import { isString } from "../../utils/is.js";
+
+export default {
+    name: "管理员登录",
+    method: "POST",
+    body: "none",
+    auth: false,
+    fields: {
+        account: {
+            name: "账号",
+            input: "string",
+            min: 3,
+            max: 100
+        },
+        password: adminTable.password,
+        loginType: {
+            name: "登录类型",
+            input: "/^(username|email|phone)$/",
+            min: null,
+            max: null
+        }
+    },
+    required: ["account", "password", "loginType"],
+    handler: async (befly, ctx) => {
+        const userAgent = ctx.req.headers.get("user-agent") || "";
+        const uaResult = UAParser(userAgent);
+
+        const logData = {
+            adminId: 0,
+            username: ctx.body.account,
+            nickname: "",
+            ip: ctx.ip || "",
+            userAgent: userAgent.substring(0, 500),
+            browserName: uaResult.browser.name || "",
+            browserVersion: uaResult.browser.version || "",
+            osName: uaResult.os.name || "",
+            osVersion: uaResult.os.version || "",
+            deviceType: uaResult.device.type || "desktop",
+            deviceVendor: uaResult.device.vendor || "",
+            deviceModel: uaResult.device.model || "",
+            engineName: uaResult.engine.name || "",
+            cpuArchitecture: uaResult.cpu.architecture || "",
+            loginTime: Date.now(),
+            loginResult: 0,
+            failReason: ""
+        };
+
+        const whereCondition = {};
+        if (ctx.body.loginType === "username") {
+            whereCondition["username"] = ctx.body.account;
+        } else if (ctx.body.loginType === "email") {
+            whereCondition["email"] = ctx.body.account;
+        } else if (ctx.body.loginType === "phone") {
+            whereCondition["phone"] = ctx.body.account;
+        }
+
+        const admin = await befly.mysql.getOne({
+            table: "beflyAdmin",
+            where: whereCondition
+        });
+
+        if (!admin.data?.id) {
+            logData.failReason = "账号不存在";
+            await befly.mysql.insData({ table: "beflyLoginLog", data: logData });
+            return befly.tool.No("账号或密码错误");
+        }
+
+        logData.adminId = admin.data.id;
+        logData.username = admin.data.username;
+        logData.nickname = admin.data.nickname;
+
+        if (befly.tool.sha256(ctx.body.password) !== admin.data.password) {
+            logData.failReason = "密码错误";
+            await befly.mysql.insData({ table: "beflyLoginLog", data: logData });
+            return befly.tool.No("账号或密码错误");
+        }
+
+        if (admin.data.state === 2) {
+            logData.failReason = "账号已被禁用";
+            await befly.mysql.insData({ table: "beflyLoginLog", data: logData });
+            return befly.tool.No("账号已被禁用");
+        }
+
+        logData.loginResult = 1;
+        await befly.mysql.insData({ table: "beflyLoginLog", data: logData });
+
+        const ttlSeconds = toSessionTtlSeconds(befly.config?.session?.expireDays);
+        const sid = Bun.randomUUIDv7();
+        const sessionKey = `session:${sid}`;
+
+        const sessionData = {
+            sid: sid,
+            id: admin.data.id,
+            username: admin.data.username,
+            nickname: admin.data.nickname,
+            state: admin.data.state,
+            roleCode: admin.data.roleCode,
+            roleType: admin.data.roleType,
+            loginAt: Date.now()
+        };
+
+        const sessionResult = await befly.redis.setObject(sessionKey, sessionData, ttlSeconds);
+        if (!sessionResult) {
+            return befly.tool.No("登录失败，请稍后重试");
+        }
+
+        return befly.tool.Yes("登录成功", {
+            token: sid,
+            userInfo: {
+                id: sessionData.id,
+                username: sessionData.username,
+                nickname: sessionData.nickname,
+                state: sessionData.state,
+                roleCode: sessionData.roleCode,
+                roleType: sessionData.roleType
+            }
+        });
+    }
+};

package/apis/auth/sendSmsCode.js

@@ -0,0 +1,24 @@
+import adminTable from "../../tables/admin.json";
+
+export default {
+    name: "发送短信验证码",
+    method: "POST",
+    body: "none",
+    auth: false,
+    fields: {
+        phone: adminTable.phone
+    },
+    required: ["phone"],
+    handler: async (befly, ctx) => {
+        const code = Math.floor(100000 + Math.random() * 900000).toString();
+
+        if (befly.redis) {
+            const key = `sms_code:${ctx.body.phone}`;
+            await befly.redis.setString(key, code, 300);
+        }
+
+        const isDev = befly.config ? befly.config.runMode === "development" : false;
+
+        return befly.tool.Yes("验证码已发送", isDev ? { code: code } : null);
+    }
+};

package/apis/dashboard/configStatus.js

@@ -0,0 +1,39 @@
+export default {
+    name: "获取配置状态",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {},
+    required: [],
+    handler: async (befly) => {
+        const status = {
+            database: { status: "ok", latency: 0, message: "" },
+            redis: { status: "ok", latency: 0, message: "" },
+            fileSystem: { status: "ok" },
+            email: { status: "warning", message: "未配置" },
+            oss: { status: "warning", message: "未配置" }
+        };
+
+        try {
+            const startTime = Date.now();
+            await befly.mysql.execute("SELECT 1");
+            status.database.latency = Date.now() - startTime;
+            status.database.status = "ok";
+        } catch {
+            status.database.status = "error";
+            status.database.message = "连接失败";
+        }
+
+        try {
+            const startTime = Date.now();
+            await befly.redis.ping();
+            status.redis.latency = Date.now() - startTime;
+            status.redis.status = "ok";
+        } catch {
+            status.redis.status = "error";
+            status.redis.message = "连接失败";
+        }
+
+        return befly.tool.Yes("获取成功", status);
+    }
+};

package/apis/dashboard/environmentInfo.js

@@ -0,0 +1,43 @@
+import os from "node:os";
+import { isString } from "../../utils/is.js";
+
+export default {
+    name: "获取运行环境信息",
+    method: "POST",
+    body: "none",
+    auth: true,
+    fields: {},
+    required: [],
+    handler: async (befly) => {
+        let databaseVersion = "Unknown";
+        try {
+            const versionResult = await befly.mysql.execute("SELECT VERSION() as version");
+            const rawVersion = versionResult.data && versionResult.data[0] ? versionResult.data[0].version : undefined;
+            databaseVersion = isString(rawVersion) ? rawVersion : String(rawVersion ?? "Unknown");
+        } catch {
+            // 忽略错误
+        }
+
+        let redisVersion = "未配置";
+        if (befly.redis) {
+            try {
+                const info = await befly.redis.info("server");
+                const match = info.match(/redis_version:([^\r\n]+)/);
+                if (match) {
+                    redisVersion = match[1];
+                }
+            } catch {
+                redisVersion = "未知";
+            }
+        }
+
+        return befly.tool.Yes("获取成功", {
+            os: `${os.type()} ${os.arch()}`,
+            server: `${os.platform()} ${os.release()}`,
+            nodeVersion: process.version,
+            database: `MySQL ${databaseVersion}`,
+            cache: `Redis ${redisVersion}`,
+            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+        });
+    }
+};