@befly-addon/admin 1.6.0 → 1.6.2

package/apis/admin/cacheRefresh.ts

@@ -30,10 +30,10 @@ export default {
                 });
 
                 await befly.redis.setObject("apis:all", apis.data.lists);
-                results.apis = { success: true, count: apis.data.lists.length };
+                results["apis"] = { success: true, count: apis.data.lists.length };
             } catch (error: any) {
                 befly.logger.error({ err: error, msg: "刷新接口缓存失败" });
-                results.apis = { success: false, error: error.message };
+                results["apis"] = { success: false, error: error.message };
             }
 
             // 2. 刷新菜单缓存
@@ -47,7 +47,7 @@ export default {
                 const parentCount = menus.data.lists.filter((m: any) => typeof m.parentPath !== "string" || m.parentPath.length === 0).length;
                 const childCount = menus.data.lists.filter((m: any) => typeof m.parentPath === "string" && m.parentPath.length > 0).length;
 
-                results.menus = {
+                results["menus"] = {
                     success: true,
                     count: menus.data.lists.length,
                     parentCount: parentCount,
@@ -55,7 +55,7 @@ export default {
                 };
             } catch (error: any) {
                 befly.logger.error({ err: error, msg: "刷新菜单缓存失败" });
-                results.menus = { success: false, error: error.message };
+                results["menus"] = { success: false, error: error.message };
             }
 
             // 3. 刷新角色权限缓存
@@ -72,23 +72,23 @@ export default {
                     }))
                 );
 
-                results.roles = { success: true, count: count };
+                results["roles"] = { success: true, count: count };
             } catch (error: any) {
                 befly.logger.error({ err: error, msg: "刷新角色缓存失败" });
-                results.roles = { success: false, error: error.message };
+                results["roles"] = { success: false, error: error.message };
             }
 
             // 4. 重建角色接口权限缓存（版本化 + 原子切换）
             try {
                 await befly.cache.rebuildRoleApiPermissions();
-                results.roleApiPermissions = { success: true };
+                results["roleApiPermissions"] = { success: true };
             } catch (error: any) {
                 befly.logger.error({ err: error, msg: "重建角色接口权限缓存失败" });
-                results.roleApiPermissions = { success: false, error: error.message };
+                results["roleApiPermissions"] = { success: false, error: error.message };
             }
 
             // 检查是否全部成功
-            const allSuccess = results.apis.success && results.menus.success && results.roles.success && results.roleApiPermissions.success;
+            const allSuccess = results["apis"].success && results["menus"].success && results["roles"].success && results["roleApiPermissions"].success;
 
             if (allSuccess) {
                 return befly.tool.Yes("全部缓存刷新成功", results);

package/apis/admin/del.ts

@@ -1,7 +1,11 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "删除管理员",
     fields: {
-        id: "@id"
+        id: fieldsScheme.id
     },
     required: ["id"],
     handler: async (befly, ctx) => {
@@ -29,3 +33,5 @@ export default {
         return befly.tool.Yes("删除成功");
     }
 };
+
+export default route;

package/apis/admin/detail.ts

@@ -1,7 +1,11 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取管理员信息",
     fields: {
-        id: "@id"
+        id: fieldsScheme.id
     },
     handler: async (befly, ctx) => {
         const adminData = await befly.db.getOne({
@@ -17,3 +21,5 @@ export default {
         return befly.tool.Yes("查询成功", adminData.data);
     }
 };
+
+export default route;

package/apis/admin/ins.ts

@@ -1,12 +1,14 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminTable from "../../tables/admin.json";
 
-export default {
+const route: ApiRoute = {
     name: "添加管理员",
     fields: adminTable,
     required: ["username", "password", "roleCode"],
     handler: async (befly, ctx) => {
         // 检查用户名是否已存在
-        const existingByUsername = await befly.db.getOne({
+        const existingByUsername = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_admin",
             where: { username: ctx.body.username }
         });
@@ -17,7 +19,7 @@ export default {
 
         // 检查昵称是否已存在
         if (ctx.body.nickname) {
-            const existingByNickname = await befly.db.getOne({
+            const existingByNickname = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_admin",
                 where: { nickname: ctx.body.nickname }
             });
@@ -28,7 +30,7 @@ export default {
         }
 
         // 查询角色信息
-        const roleData = await befly.db.getOne({
+        const roleData = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_role",
             where: { code: ctx.body.roleCode }
         });
@@ -56,3 +58,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/admin/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "查询管理员列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -22,3 +26,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/admin/upd.ts

@@ -1,14 +1,26 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminTable from "../../tables/admin.json";
+import { fieldsScheme } from "../../utils/fieldsScheme";
+import { mergeTableFields } from "../../utils/mergeTableFields";
 
-export default {
+const route: ApiRoute = {
     name: "更新管理员",
-    fields: { id: "@id", ...adminTable },
+    fields: mergeTableFields(adminTable, { id: fieldsScheme.id }),
     required: ["id"],
     handler: async (befly, ctx) => {
-        const { id, username, nickname, roleCode, ...updateData } = ctx.body;
+        const id = ctx.body.id;
+        const username = ctx.body.username;
+        const nickname = ctx.body.nickname;
+        const roleCode = ctx.body.roleCode;
 
         // 检查管理员是否存在
-        const admin = await befly.db.getOne({
+        const admin = await befly.db.getOne<{
+            id?: number;
+            username?: string;
+            nickname?: string;
+            roleCode?: string;
+        }>({
             table: "addon_admin_admin",
             where: { id }
         });
@@ -19,7 +31,7 @@ export default {
 
         // 检查用户名是否已被其他管理员使用
         if (username && username !== admin.data.username) {
-            const existingUsername = await befly.db.getOne({
+            const existingUsername = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_admin",
                 where: { username, id: { $ne: id } }
             });
@@ -30,7 +42,7 @@ export default {
 
         // 检查昵称是否已被其他管理员使用
         if (nickname && nickname !== admin.data.nickname) {
-            const existingNickname = await befly.db.getOne({
+            const existingNickname = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_admin",
                 where: { nickname, id: { $ne: id } }
             });
@@ -41,7 +53,7 @@ export default {
 
         // 检查角色是否存在
         if (roleCode && roleCode !== admin.data.roleCode) {
-            const role = await befly.db.getOne({
+            const role = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_role",
                 where: { code: roleCode }
             });
@@ -51,10 +63,19 @@ export default {
         }
 
         // 构建更新数据
-        const dataToUpdate: Record<string, any> = { ...updateData };
-        if (username) dataToUpdate.username = username;
-        if (nickname) dataToUpdate.nickname = nickname;
-        if (roleCode) dataToUpdate.roleCode = roleCode;
+        const dataToUpdate: Record<string, any> = {};
+
+        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.db.updData({
@@ -66,3 +87,5 @@ export default {
         return befly.tool.Yes("更新成功");
     }
 };
+
+export default route;

package/apis/api/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取接口列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         try {
@@ -25,3 +29,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/auth/login.ts

@@ -1,8 +1,10 @@
+import type { ApiRoute } from "befly/types/api";
+
 import { UAParser } from "ua-parser-js";
 
 import adminTable from "../../tables/admin.json";
 
-export default {
+const route: ApiRoute = {
     name: "管理员登录",
     auth: false,
     fields: {
@@ -10,12 +12,17 @@ export default {
             name: "账号",
             type: "string",
             min: 3,
-            max: 100
+            max: 100,
+            default: null,
+            regexp: null
         },
         password: adminTable.password,
         loginType: {
             name: "登录类型",
             type: "string",
+            min: null,
+            max: null,
+            default: null,
             regexp: "^(username|email|phone)$"
         }
     },
@@ -47,22 +54,30 @@ export default {
         };
 
         // 根据登录类型构建查询条件
-        const whereCondition: Record<string, any> = {};
+        const whereCondition: Record<string, unknown> = {};
         if (ctx.body.loginType === "username") {
-            whereCondition.username = ctx.body.account;
+            whereCondition["username"] = ctx.body.account;
         } else if (ctx.body.loginType === "email") {
-            whereCondition.email = ctx.body.account;
+            whereCondition["email"] = ctx.body.account;
         } else if (ctx.body.loginType === "phone") {
-            whereCondition.phone = ctx.body.account;
+            whereCondition["phone"] = ctx.body.account;
         }
 
         // 查询管理员
-        const admin = await befly.db.getOne({
+        const admin = await befly.db.getOne<{
+            id?: number;
+            username?: string;
+            nickname?: string;
+            password?: string;
+            state?: number;
+            roleCode?: string;
+            roleType?: string;
+        }>({
             table: "addon_admin_admin",
             where: whereCondition
         });
 
-        if (!admin.data?.id) {
+        if (!admin.data?.id || typeof admin.data.username !== "string" || typeof admin.data.password !== "string") {
             logData.failReason = "账号不存在";
             await befly.db.insData({ table: "addon_admin_login_log", data: logData });
             return befly.tool.No("账号或密码错误");
@@ -81,7 +96,7 @@ export default {
                 await befly.db.insData({ table: "addon_admin_login_log", data: logData });
                 return befly.tool.No("账号或密码错误");
             }
-        } catch (error: any) {
+        } catch (error: unknown) {
             befly.logger.error({ err: error, msg: "密码验证失败" });
             logData.failReason = "密码格式错误";
             await befly.db.insData({ table: "addon_admin_login_log", data: logData });
@@ -113,11 +128,20 @@ export default {
         );
 
         // 返回用户信息（不包含密码）
-        const { password: _, ...userWithoutPassword } = admin.data;
+        const userInfo = {
+            id: admin.data.id,
+            username: admin.data.username,
+            nickname: admin.data.nickname,
+            state: admin.data.state,
+            roleCode: admin.data.roleCode,
+            roleType: admin.data.roleType
+        };
 
         return befly.tool.Yes("登录成功", {
             token: token,
-            userInfo: userWithoutPassword
+            userInfo: userInfo
         });
     }
 };
+
+export default route;

package/apis/dict/del.ts

@@ -1,6 +1,10 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "删除字典",
-    fields: { "@id": true },
+    fields: { id: fieldsScheme.id },
     required: ["id"],
     handler: async (befly, ctx) => {
         await befly.db.delData({
@@ -11,3 +15,5 @@ export default {
         return befly.tool.Yes("删除成功");
     }
 };
+
+export default route;

package/apis/dict/detail.ts

@@ -1,6 +1,10 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取字典详情",
-    fields: { "@id": true },
+    fields: { id: fieldsScheme.id },
     required: ["id"],
     handler: async (befly, ctx) => {
         const dict = await befly.db.getOne({
@@ -34,3 +38,5 @@ export default {
         return befly.tool.Yes("获取成功", dict.data);
     }
 };
+
+export default route;

package/apis/dict/ins.ts

@@ -1,3 +1,5 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminDictTable from "../../tables/dict.json";
 
 export default {
@@ -6,7 +8,7 @@ export default {
     required: ["typeCode", "key", "label"],
     handler: async (befly, ctx) => {
         // 验证 typeCode 是否存在
-        const dictType = await befly.db.getOne({
+        const dictType = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_dict_type",
             where: { code: ctx.body.typeCode }
         });
@@ -16,7 +18,7 @@ export default {
         }
 
         // 检查 typeCode+key 是否已存在
-        const existing = await befly.db.getOne({
+        const existing = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_dict",
             where: {
                 typeCode: ctx.body.typeCode,
@@ -41,4 +43,4 @@ export default {
 
         return befly.tool.Yes("添加成功", { id: dictId.data });
     }
-};
+} as unknown as ApiRoute;

package/apis/dict/items.ts

@@ -1,3 +1,5 @@
+import type { ApiRoute } from "befly/types/api";
+
 export default {
     name: "获取字典项列表",
     fields: {
@@ -6,7 +8,7 @@ export default {
     required: ["typeCode"],
     handler: async (befly, ctx) => {
         // 验证 typeCode 是否存在
-        const dictType = await befly.db.getOne({
+        const dictType = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_dict_type",
             where: { code: ctx.body.typeCode }
         });
@@ -24,4 +26,4 @@ export default {
 
         return befly.tool.Yes("获取成功", items.data);
     }
-};
+} as unknown as ApiRoute;

package/apis/dict/list.ts

@@ -1,10 +1,15 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import dictTable from "../../tables/dict.json";
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取字典列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        typeCode: { type: "string", label: "类型代码" },
-        keyword: "@keyword"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        typeCode: dictTable.typeCode,
+        keyword: fieldsScheme.keyword
     },
     handler: async (befly, ctx) => {
         const where: any = {};
@@ -43,3 +48,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/dict/upd.ts

@@ -1,18 +1,19 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminDictTable from "../../tables/dict.json";
+import { fieldsScheme } from "../../utils/fieldsScheme";
+import { mergeTableFields } from "../../utils/mergeTableFields";
 
-export default {
+const route: ApiRoute = {
     name: "更新字典",
-    fields: {
-        ...adminDictTable,
-        "@id": true
-    },
+    fields: mergeTableFields(adminDictTable, { id: fieldsScheme.id }),
     required: ["id"],
     handler: async (befly, ctx) => {
         const { id, typeCode, key, label, sort, remark } = ctx.body;
 
         // 如果更新了 typeCode，验证其是否存在
         if (typeCode) {
-            const dictType = await befly.db.getOne({
+            const dictType = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_dict_type",
                 where: { code: typeCode }
             });
@@ -24,7 +25,7 @@ export default {
 
         // 如果更新了 typeCode 或 key，检查唯一性
         if (typeCode || key) {
-            const current = await befly.db.getOne({
+            const current = await befly.db.getOne<{ typeCode?: string; key?: string }>({
                 table: "addon_admin_dict",
                 where: { id: id }
             });
@@ -32,7 +33,7 @@ export default {
             const checkTypeCode = typeCode || current.data?.typeCode;
             const checkKey = key || current.data?.key;
 
-            const existing = await befly.db.getOne({
+            const existing = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_dict",
                 where: {
                     typeCode: checkTypeCode,
@@ -47,11 +48,11 @@ export default {
         }
 
         const updateData: Record<string, any> = {};
-        if (typeCode !== undefined) updateData.typeCode = typeCode;
-        if (key !== undefined) updateData.key = key;
-        if (label !== undefined) updateData.label = label;
-        if (sort !== undefined) updateData.sort = sort;
-        if (remark !== undefined) updateData.remark = remark;
+        if (typeCode !== undefined) updateData["typeCode"] = typeCode;
+        if (key !== undefined) updateData["key"] = key;
+        if (label !== undefined) updateData["label"] = label;
+        if (sort !== undefined) updateData["sort"] = sort;
+        if (remark !== undefined) updateData["remark"] = remark;
 
         await befly.db.updData({
             table: "addon_admin_dict",
@@ -62,3 +63,5 @@ export default {
         return befly.tool.Yes("更新成功");
     }
 };
+
+export default route;

package/apis/dictType/del.ts

@@ -1,11 +1,15 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "删除字典类型",
-    fields: { "@id": true },
+    fields: { id: fieldsScheme.id },
     required: ["id"],
     handler: async (befly, ctx) => {
         const { id } = ctx.body;
 
-        const dictType = await befly.db.getOne({
+        const dictType = await befly.db.getOne<{ code?: string }>({
             table: "addon_admin_dict_type",
             where: { id: id }
         });
@@ -15,7 +19,7 @@ export default {
         }
 
         // 检查是否有字典项引用此类型
-        const dictItems = await befly.db.getOne({
+        const dictItems = await befly.db.getOne<{ id?: number }>({
             table: "addon_admin_dict",
             where: {
                 typeCode: dictType.data.code
@@ -34,3 +38,5 @@ export default {
         return befly.tool.Yes("删除成功");
     }
 };
+
+export default route;

package/apis/dictType/detail.ts

@@ -1,6 +1,10 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "字典类型详情",
-    fields: { "@id": true },
+    fields: { id: fieldsScheme.id },
     required: ["id"],
     handler: async (befly, ctx) => {
         const detail = await befly.db.getOne({
@@ -15,3 +19,5 @@ export default {
         return befly.tool.Yes("获取成功", detail.data);
     }
 };
+
+export default route;

package/apis/dictType/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取字典类型列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -20,3 +24,5 @@ export default {
         return befly.tool.Yes("操作成功", result.data);
     }
 };
+
+export default route;

package/apis/dictType/upd.ts

@@ -1,11 +1,12 @@
+import type { ApiRoute } from "befly/types/api";
+
 import dictTypeTable from "../../tables/dictType.json";
+import { fieldsScheme } from "../../utils/fieldsScheme";
+import { mergeTableFields } from "../../utils/mergeTableFields";
 
-export default {
+const route: ApiRoute = {
     name: "更新字典类型",
-    fields: {
-        ...dictTypeTable,
-        "@id": true
-    },
+    fields: mergeTableFields(dictTypeTable, { id: fieldsScheme.id }),
     required: ["id"],
     handler: async (befly, ctx) => {
         const { id, code, name, description, sort } = ctx.body;
@@ -26,10 +27,10 @@ export default {
         }
 
         const updateData: Record<string, any> = {};
-        if (code !== undefined) updateData.code = code;
-        if (name !== undefined) updateData.name = name;
-        if (description !== undefined) updateData.description = description;
-        if (sort !== undefined) updateData.sort = sort;
+        if (code !== undefined) updateData["code"] = code;
+        if (name !== undefined) updateData["name"] = name;
+        if (description !== undefined) updateData["description"] = description;
+        if (sort !== undefined) updateData["sort"] = sort;
 
         await befly.db.updData({
             table: "addon_admin_dict_type",
@@ -40,3 +41,5 @@ export default {
         return befly.tool.Yes("更新成功");
     }
 };
+
+export default route;

package/apis/email/config.ts

@@ -14,7 +14,7 @@ export default {
             user: config.user,
             pass: config.pass,
             fromName: config.fromName,
-            configured: !!config.user
+            configured: Boolean(config.user)
         });
     }
 };

package/apis/email/logList.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "邮件发送日志列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -17,3 +21,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/loginLog/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取登录日志列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -17,3 +21,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/menu/all.ts

@@ -7,14 +7,16 @@
  * 4. 仅返回状态为启用的菜单
  */
 
+import type { ApiRoute } from "befly/types/api";
+
 export default {
     name: "获取用户菜单",
     handler: async (befly, ctx) => {
         try {
             // 2. 查询角色信息获取菜单权限（使用 roleCode 而非 roleId）
-            const role = await befly.db.getOne({
+            const role = await befly.db.getOne<{ id?: number; menus?: unknown }>({
                 table: "addon_admin_role",
-                where: { code: ctx.user.roleCode }
+                where: { code: ctx.user["roleCode"] }
             });
 
             if (!role.data?.id) {
@@ -23,7 +25,7 @@ export default {
 
             // 3. 解析菜单路径列表（menu.path 数组，array_text）
             const rawMenuPaths = Array.isArray(role.data.menus) ? role.data.menus : [];
-            const menuPaths = rawMenuPaths.map((p: any) => (typeof p === "string" ? p.trim() : "")).filter((p: string) => p.length > 0);
+            const menuPaths = rawMenuPaths.map((p: unknown) => (typeof p === "string" ? p.trim() : "")).filter((p: string) => p.length > 0);
 
             if (menuPaths.length === 0) {
                 return befly.tool.Yes("菜单为空", { lists: [] });
@@ -46,13 +48,19 @@ export default {
 
             // 5. 根据角色权限过滤菜单（按 menu.path）
             const menuPathSet = new Set<string>(menuPaths);
-            const authorizedMenus = allMenus.filter((menu: any) => typeof menu?.path === "string" && menuPathSet.has(String(menu.path)));
+            const authorizedMenus = allMenus.filter((menu: unknown) => {
+                if (typeof menu !== "object" || menu === null) {
+                    return false;
+                }
+                const path = (menu as { path?: unknown }).path;
+                return typeof path === "string" && menuPathSet.has(path);
+            });
 
             // 6. 返回一维数组（由前端构建树形结构）
             return befly.tool.Yes("获取菜单成功", { lists: authorizedMenus });
-        } catch (error: any) {
+        } catch (error: unknown) {
             befly.logger.error({ err: error, msg: "获取用户菜单失败" });
             return befly.tool.No("获取菜单失败");
         }
     }
-};
+} as unknown as ApiRoute;

package/apis/menu/list.ts

@@ -1,12 +1,16 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取菜单列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
-    handler: async (befly) => {
+    handler: async (befly, _ctx) => {
         try {
             const menus = await befly.db.getAll({
                 table: "addon_admin_menu"
@@ -19,3 +23,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/operateLog/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取操作日志列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -17,3 +21,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/role/apiSave.ts

@@ -1,3 +1,5 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 import { normalizePathnameListInput } from "../../utils/normalizePathnameListInput";
 
@@ -11,12 +13,13 @@ export default {
         let apiPaths: string[] = [];
         try {
             apiPaths = normalizePathnameListInput(ctx.body.apiPaths, "apiPaths", true);
-        } catch (error: any) {
-            return befly.tool.No(`参数不合法：${error?.message || "未知错误"}`);
+        } catch (error: unknown) {
+            const msg = error instanceof Error ? error.message : "未知错误";
+            return befly.tool.No(`参数不合法：${msg}`);
         }
 
         // 查询角色是否存在
-        const role = await befly.db.getOne({
+        const role = await befly.db.getOne<{ id?: number; code?: string }>({
             table: "addon_admin_role",
             where: { code: ctx.body.roleCode }
         });
@@ -25,6 +28,11 @@ export default {
             return befly.tool.No("角色不存在");
         }
 
+        const roleCode = role.data.code;
+        if (typeof roleCode !== "string" || roleCode.length === 0) {
+            return befly.tool.No("角色不存在");
+        }
+
         // 直接使用数组，数据库会自动处理存储
         await befly.db.updData({
             table: "addon_admin_role",
@@ -35,8 +43,8 @@ export default {
         });
 
         // 增量刷新 Redis 权限缓存
-        await befly.cache.refreshRoleApiPermissions(role.data.code, apiPaths);
+        await befly.cache.refreshRoleApiPermissions(roleCode, apiPaths);
 
         return befly.tool.Yes("操作成功");
     }
-};
+} as unknown as ApiRoute;

package/apis/role/del.ts

@@ -1,8 +1,13 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "删除角色",
     fields: {
-        id: "@id"
+        id: fieldsScheme.id
     },
+    required: ["id"],
     handler: async (befly, ctx) => {
         try {
             // 检查是否有用户使用此角色（使用 getList 代替 getAll）
@@ -47,3 +52,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/role/detail.ts

@@ -1,7 +1,11 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import roleTable from "../../tables/role.json";
+
+const route: ApiRoute = {
     name: "获取用户角色",
     fields: {
-        id: "@id"
+        id: roleTable.code
     },
     handler: async (befly, ctx) => {
         let roleInfo = null;
@@ -11,7 +15,10 @@ export default {
                 where: { code: ctx.body.id }
             });
 
-            roleInfo = roleInfoResult.data;
+            const roleId = (roleInfoResult.data as { id?: number }).id;
+            if (typeof roleId === "number") {
+                roleInfo = roleInfoResult.data;
+            }
         }
 
         return befly.tool.Yes("操作成功", {
@@ -20,3 +27,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/role/list.ts

@@ -1,12 +1,16 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取角色列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
-    handler: async (befly) => {
+    handler: async (befly, _ctx) => {
         const roles = await befly.db.getList({
             limit: 30,
             table: "addon_admin_role",
@@ -21,3 +25,5 @@ export default {
         return befly.tool.Yes("操作成功", roles.data);
     }
 };
+
+export default route;

package/apis/sysConfig/del.ts

@@ -1,8 +1,13 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "删除系统配置",
     fields: {
-        id: "@id"
+        id: fieldsScheme.id
     },
+    required: ["id"],
     handler: async (befly, ctx) => {
         try {
             // 检查是否为系统配置
@@ -31,3 +36,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/sysConfig/get.ts

@@ -1,3 +1,5 @@
+import type { ApiRoute } from "befly/types/api";
+
 export default {
     name: "根据代码获取配置值",
     auth: false,
@@ -5,7 +7,12 @@ export default {
         code: { name: "配置代码", type: "string", min: 1, max: 50 }
     },
     handler: async (befly, ctx) => {
-        const config = await befly.db.getOne({
+        const config = await befly.db.getOne<{
+            id?: number;
+            code?: string;
+            value?: string;
+            valueType?: string;
+        }>({
             table: "addon_admin_sys_config",
             where: { code: ctx.body.code }
         });
@@ -14,20 +21,31 @@ export default {
             return befly.tool.No("配置不存在");
         }
 
+        const valueType = config.data.valueType;
+        const rawValue = config.data.value;
+        if (typeof valueType !== "string" || typeof rawValue !== "string") {
+            return befly.tool.No("配置数据不完整");
+        }
+
+        const code = config.data.code;
+        if (typeof code !== "string") {
+            return befly.tool.No("配置数据不完整");
+        }
+
         // 根据类型转换值
-        let value = config.data.value;
-        if (config.data.valueType === "number") {
-            value = Number(config.data.value);
-        } else if (config.data.valueType === "boolean") {
-            value = config.data.value === "true" || config.data.value === "1";
-        } else if (config.data.valueType === "json") {
+        let value: unknown = rawValue;
+        if (valueType === "number") {
+            value = Number(rawValue);
+        } else if (valueType === "boolean") {
+            value = rawValue === "true" || rawValue === "1";
+        } else if (valueType === "json") {
             try {
-                value = JSON.parse(config.data.value);
+                value = JSON.parse(rawValue);
             } catch {
-                value = config.data.value;
+                value = rawValue;
             }
         }
 
-        return befly.tool.Yes("操作成功", { code: config.data.code, value: value });
+        return befly.tool.Yes("操作成功", { code: code, value: value });
     }
-};
+} as unknown as ApiRoute;

package/apis/sysConfig/ins.ts

@@ -1,3 +1,5 @@
+import type { ApiRoute } from "befly/types/api";
+
 import sysConfigTable from "../../tables/sysConfig.json";
 
 export default {
@@ -6,12 +8,12 @@ export default {
     handler: async (befly, ctx) => {
         try {
             // 检查 code 是否已存在
-            const existing = await befly.db.getOne({
+            const existing = await befly.db.getOne<{ id?: number }>({
                 table: "addon_admin_sys_config",
                 where: { code: ctx.body.code }
             });
 
-            if (existing.data) {
+            if (existing.data?.id) {
                 return befly.tool.No("配置代码已存在");
             }
 
@@ -35,4 +37,4 @@ export default {
             return befly.tool.No("操作失败");
         }
     }
-};
+} as unknown as ApiRoute;

package/apis/sysConfig/list.ts

@@ -1,10 +1,14 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { fieldsScheme } from "../../utils/fieldsScheme";
+
+const route: ApiRoute = {
     name: "获取系统配置列表",
     fields: {
-        page: "@page",
-        limit: "@limit",
-        keyword: "@keyword",
-        state: "@state"
+        page: fieldsScheme.page,
+        limit: fieldsScheme.limit,
+        keyword: fieldsScheme.keyword,
+        state: fieldsScheme.state
     },
     handler: async (befly, ctx) => {
         const result = await befly.db.getList({
@@ -18,3 +22,5 @@ export default {
         return befly.tool.Yes("操作成功", result.data);
     }
 };
+
+export default route;

package/apis/sysConfig/upd.ts

@@ -1,11 +1,13 @@
+import type { ApiRoute } from "befly/types/api";
+
 import sysConfigTable from "../../tables/sysConfig.json";
+import { fieldsScheme } from "../../utils/fieldsScheme";
+import { mergeTableFields } from "../../utils/mergeTableFields";
 
-export default {
+const route: ApiRoute = {
     name: "更新系统配置",
-    fields: {
-        id: "@id",
-        ...sysConfigTable
-    },
+    fields: mergeTableFields(sysConfigTable, { id: fieldsScheme.id }),
+    required: ["id"],
     handler: async (befly, ctx) => {
         try {
             // 检查是否为系统配置
@@ -51,3 +53,5 @@ export default {
         }
     }
 };
+
+export default route;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@befly-addon/admin",
-    "version": "1.6.0",
-    "gitHead": "0d60e323a83a1fc53822147de877af19cdb972c0",
+    "version": "1.6.2",
+    "gitHead": "e30f1dd7cb51e6560832110c37708ef0a6853749",
     "private": false,
     "description": "Befly - 管理后台功能组件",
     "keywords": [
@@ -52,5 +52,11 @@
         "nodemailer": "^7.0.12",
         "ua-parser-js": "^2.0.7"
     },
+    "devDependencies": {
+        "befly": "3.14.2"
+    },
+    "peerDependencies": {
+        "befly": "^3.14.0"
+    },
     "addonName": "管理后台"
 }

package/plugins/email.ts

@@ -3,9 +3,9 @@
  * 提供邮件发送功能，支持 SMTP 配置
  */
 
-import type { EmailConfig } from "../libs/emailHelper.ts";
+import type { EmailConfig } from "../libs/emailHelper";
 
-import { EmailHelper } from "../libs/emailHelper.ts";
+import { EmailHelper } from "../libs/emailHelper";
 
 /** 默认配置 */
 const defaultConfig: EmailConfig = {

package/tsconfig.json

@@ -4,10 +4,11 @@
         "target": "ES2022",
         "types": ["bun"],
         "strict": false,
+        "exactOptionalPropertyTypes": false,
         "noImplicitReturns": false,
         "noFallthroughCasesInSwitch": false,
         "noImplicitOverride": false
     },
-    "include": ["apis/**/*.ts", "libs/**/*.ts", "plugins/**/*.ts", "**/*.d.ts"],
+    "include": ["apis/**/*.ts", "libs/**/*.ts", "plugins/**/*.ts", "utils/**/*.ts", "**/*.d.ts"],
     "exclude": ["node_modules", "dist", "logs", "temp", "tests", "views", "adminViews", "appViews"]
 }

package/utils/fieldClear.ts

@@ -38,7 +38,7 @@ export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions =
             const value = obj[key];
 
             // 1. keepMap 优先
-            if (keepMap && Object.prototype.hasOwnProperty.call(keepMap, key)) {
+            if (keepMap && Object.hasOwn(keepMap, key)) {
                 if (Object.is(keepMap[key], value)) {
                     result[key] = value;
                     continue;

package/utils/fieldsScheme.ts

@@ -0,0 +1,50 @@
+import type { FieldDefinition } from "befly/types/validate";
+
+export const fieldsScheme: {
+    id: FieldDefinition;
+    page: FieldDefinition;
+    limit: FieldDefinition;
+    keyword: FieldDefinition;
+    state: FieldDefinition;
+} = {
+    id: {
+        name: "ID",
+        type: "number",
+        min: 1,
+        max: null,
+        default: null,
+        regexp: null
+    },
+    page: {
+        name: "页码",
+        type: "number",
+        min: 1,
+        max: 9999,
+        default: 1,
+        regexp: null
+    },
+    limit: {
+        name: "每页数量",
+        type: "number",
+        min: 1,
+        max: 100,
+        default: 30,
+        regexp: null
+    },
+    keyword: {
+        name: "关键词",
+        type: "string",
+        min: 0,
+        max: 50,
+        default: "",
+        regexp: null
+    },
+    state: {
+        name: "状态",
+        type: "number",
+        min: null,
+        max: null,
+        default: null,
+        regexp: "^[0-2]$"
+    }
+};

package/utils/mergeTableFields.ts

@@ -0,0 +1,11 @@
+import type { TableDefinition } from "befly/types/validate";
+
+export function mergeTableFields(...tables: TableDefinition[]): TableDefinition {
+    const merged: TableDefinition = {};
+
+    for (const table of tables) {
+        Object.assign(merged, table);
+    }
+
+    return merged;
+}