@befly-addon/admin 1.6.2 → 1.7.0

package/apis/admin/cacheRefresh.ts

@@ -12,7 +12,9 @@
  * - 缓存出现异常需要重建
  */
 
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "刷新全部缓存",
     handler: async (befly, _ctx) => {
         try {
@@ -101,3 +103,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/api/all.ts

@@ -1,13 +1,16 @@
-export default {
+import type { DbJsonRow } from "../../utils/dbJsonRow";
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取所有接口",
     handler: async (befly) => {
         try {
             // 从缓存获取所有接口
-            let allApis = await befly.cache.getApis();
+            let allApis: unknown[] = await befly.cache.getApis();
 
             // 如果缓存不存在，从数据库查询并缓存
             if (allApis.length === 0) {
-                const result = await befly.db.getAll({
+                const result = await befly.db.getAll<DbJsonRow>({
                     table: "addon_admin_api",
                     orderBy: ["id#ASC"]
                 });
@@ -19,10 +22,14 @@ export default {
                 }
             }
 
-            return befly.tool.Yes("操作成功", { lists: allApis });
-        } catch (error: any) {
+            const lists = allApis.filter((api): api is Record<string, unknown> => typeof api === "object" && api !== null).map((api) => api as DbJsonRow);
+
+            return befly.tool.Yes("操作成功", { lists: lists });
+        } catch (error: unknown) {
             befly.logger.error({ err: error, msg: "获取接口列表失败" });
             return befly.tool.No("获取接口列表失败");
         }
     }
 };
+
+export default route;

package/apis/auth/sendSmsCode.ts

@@ -1,6 +1,8 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminTable from "../../tables/admin.json";
 
-export default {
+const route: ApiRoute = {
     name: "发送短信验证码",
     auth: false,
     fields: {
@@ -28,3 +30,5 @@ export default {
         return befly.tool.Yes("验证码已发送", isDev ? { code } : null);
     }
 };
+
+export default route;

package/apis/dashboard/configStatus.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取配置状态",
     handler: async (befly) => {
         const status = {
@@ -34,3 +36,5 @@ export default {
         return befly.tool.Yes("获取成功", status);
     }
 };
+
+export default route;

package/apis/dashboard/environmentInfo.ts

@@ -1,6 +1,8 @@
+import type { ApiRoute } from "befly/types/api";
+
 import os from "node:os";
 
-export default {
+const route: ApiRoute = {
     name: "获取运行环境信息",
     handler: async (befly) => {
         // 获取数据库版本
@@ -36,3 +38,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dashboard/performanceMetrics.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取性能指标",
     handler: async (befly) => {
         // 实际项目中，这些数据应该从监控系统或日志中获取
@@ -15,3 +17,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dashboard/permissionStats.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取权限统计",
     handler: async (befly) => {
         // 统计菜单数量
@@ -23,3 +25,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dashboard/serviceStatus.ts

@@ -1,7 +1,9 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取服务状态",
     handler: async (befly) => {
-        const services = [];
+        const services: Array<{ name: string; status: string; responseTime: string }> = [];
 
         // 数据库状态
         try {
@@ -73,3 +75,5 @@ export default {
         return befly.tool.Yes("获取成功", { services });
     }
 };
+
+export default route;

package/apis/dashboard/systemInfo.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取系统信息",
     handler: async (befly) => {
         // 系统启动时间（从进程启动时间计算）
@@ -17,3 +19,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dashboard/systemOverview.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取系统概览数据",
     handler: async (befly) => {
         // 权限统计
@@ -24,3 +26,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dashboard/systemResources.ts

@@ -1,8 +1,10 @@
+import type { ApiRoute } from "befly/types/api";
+
 import fs from "node:fs";
 import os from "node:os";
 import { promisify } from "node:util";
 
-export default {
+const route: ApiRoute = {
     name: "获取系统资源",
     auth: true,
     fields: {},
@@ -112,3 +114,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/dict/all.ts

@@ -1,7 +1,10 @@
-export default {
+import type { DbJsonRow } from "../../utils/dbJsonRow";
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取所有字典",
     handler: async (befly) => {
-        const result = await befly.db.getAll({
+        const result = await befly.db.getAll<DbJsonRow>({
             table: "addon_admin_dict",
             joins: [
                 {
@@ -27,3 +30,5 @@ export default {
         return befly.tool.Yes("获取成功", result.data);
     }
 };
+
+export default route;

package/apis/dict/ins.ts

@@ -2,7 +2,7 @@ import type { ApiRoute } from "befly/types/api";
 
 import adminDictTable from "../../tables/dict.json";
 
-export default {
+const route: ApiRoute = {
     name: "添加字典",
     fields: adminDictTable,
     required: ["typeCode", "key", "label"],
@@ -43,4 +43,6 @@ export default {
 
         return befly.tool.Yes("添加成功", { id: dictId.data });
     }
-} as unknown as ApiRoute;
+};
+
+export default route;

package/apis/dict/items.ts

@@ -1,6 +1,7 @@
+import type { DbJsonRow } from "../../utils/dbJsonRow";
 import type { ApiRoute } from "befly/types/api";
 
-export default {
+const route: ApiRoute = {
     name: "获取字典项列表",
     fields: {
         typeCode: { type: "string", label: "类型代码", required: true }
@@ -18,7 +19,7 @@ export default {
         }
 
         // 获取该类型下的所有字典项
-        const items = await befly.db.getAll({
+        const items = await befly.db.getAll<DbJsonRow>({
             table: "addon_admin_dict",
             where: { typeCode: ctx.body.typeCode },
             orderBy: ["sort#ASC", "id#ASC"]
@@ -26,4 +27,6 @@ export default {
 
         return befly.tool.Yes("获取成功", items.data);
     }
-} as unknown as ApiRoute;
+};
+
+export default route;

package/apis/dictType/all.ts

@@ -1,7 +1,10 @@
-export default {
+import type { DbJsonRow } from "../../utils/dbJsonRow";
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取所有字典类型",
     handler: async (befly) => {
-        const result = await befly.db.getAll({
+        const result = await befly.db.getAll<DbJsonRow>({
             table: "addon_admin_dict_type",
             orderBy: ["sort#ASC", "id#ASC"]
         });
@@ -9,3 +12,5 @@ export default {
         return befly.tool.Yes("操作成功", { lists: result.data.lists });
     }
 };
+
+export default route;

package/apis/dictType/ins.ts

@@ -1,6 +1,8 @@
+import type { ApiRoute } from "befly/types/api";
+
 import dictTypeTable from "../../tables/dictType.json";
 
-export default {
+const route: ApiRoute = {
     name: "添加字典类型",
     fields: dictTypeTable,
     required: ["code", "name"],
@@ -28,3 +30,5 @@ export default {
         return befly.tool.Yes("添加成功", { id: typeId.data });
     }
 };
+
+export default route;

package/apis/email/_emailPlugin.ts

@@ -0,0 +1,21 @@
+import type { EmailConfig, SendEmailOptions, SendEmailResult } from "../../libs/emailHelper";
+import type { BeflyContext } from "befly/types/befly";
+
+export type AddonAdminEmailPlugin = {
+    send: (options: SendEmailOptions) => Promise<SendEmailResult>;
+    verify: () => Promise<boolean>;
+    getConfig: () => Omit<EmailConfig, "pass"> & { pass: string };
+};
+
+export function getAddonAdminEmailPlugin(befly: BeflyContext): AddonAdminEmailPlugin | null {
+    const plugin = befly["addon_admin_email"];
+    if (typeof plugin !== "object" || plugin === null) return null;
+
+    const record = plugin as Record<string, unknown>;
+
+    if (typeof record["send"] !== "function") return null;
+    if (typeof record["verify"] !== "function") return null;
+    if (typeof record["getConfig"] !== "function") return null;
+
+    return plugin as AddonAdminEmailPlugin;
+}

package/apis/email/config.ts

@@ -1,11 +1,16 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { getAddonAdminEmailPlugin } from "./_emailPlugin";
+
+const route: ApiRoute = {
     name: "获取邮件配置",
     handler: async (befly) => {
-        if (!(befly as any).addon_admin_email) {
+        const emailPlugin = getAddonAdminEmailPlugin(befly);
+        if (!emailPlugin) {
             return befly.tool.No("邮件插件未加载，请检查配置");
         }
 
-        const config = (befly as any).addon_admin_email.getConfig();
+        const config = emailPlugin.getConfig();
 
         return befly.tool.Yes("获取成功", {
             host: config.host,
@@ -18,3 +23,5 @@ export default {
         });
     }
 };
+
+export default route;

package/apis/email/send.ts

@@ -1,6 +1,9 @@
+import type { ApiRoute } from "befly/types/api";
+
 import emailLogTable from "../../tables/emailLog.json";
+import { getAddonAdminEmailPlugin } from "./_emailPlugin";
 
-export default {
+const route: ApiRoute = {
     name: "发送邮件",
     fields: {
         to: emailLogTable.toEmail,
@@ -21,14 +24,15 @@ export default {
     },
     required: ["to", "subject", "content"],
     handler: async (befly, ctx) => {
-        if (!(befly as any).addon_admin_email) {
+        const emailPlugin = getAddonAdminEmailPlugin(befly);
+        if (!emailPlugin) {
             return befly.tool.No("邮件插件未加载，请检查配置");
         }
 
         const startTime = Date.now();
 
         // 发送邮件
-        const result = await (befly as any).addon_admin_email.send({
+        const result = await emailPlugin.send({
             to: ctx.body.to,
             subject: ctx.body.subject,
             html: ctx.body.isHtml ? ctx.body.content : undefined,
@@ -56,7 +60,7 @@ export default {
                     failReason: result.error || ""
                 }
             });
-        } catch (logError: any) {
+        } catch (logError: unknown) {
             befly.logger.error({ err: logError, msg: "记录邮件日志失败" });
         }
 
@@ -67,3 +71,5 @@ export default {
         return befly.tool.No(result.error || "发送失败");
     }
 };
+
+export default route;

package/apis/email/verify.ts

@@ -1,11 +1,16 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+import { getAddonAdminEmailPlugin } from "./_emailPlugin";
+
+const route: ApiRoute = {
     name: "验证邮件配置",
     handler: async (befly) => {
-        if (!(befly as any).addon_admin_email) {
+        const emailPlugin = getAddonAdminEmailPlugin(befly);
+        if (!emailPlugin) {
             return befly.tool.No("邮件插件未加载，请检查配置");
         }
 
-        const isValid = await (befly as any).addon_admin_email.verify();
+        const isValid = await emailPlugin.verify();
 
         if (isValid) {
             return befly.tool.Yes("邮件服务配置正常");
@@ -14,3 +19,5 @@ export default {
         return befly.tool.No("邮件服务配置异常，请检查 SMTP 设置");
     }
 };
+
+export default route;

package/apis/menu/all.ts

@@ -7,9 +7,10 @@
  * 4. 仅返回状态为启用的菜单
  */
 
+import type { DbJsonRow } from "../../utils/dbJsonRow";
 import type { ApiRoute } from "befly/types/api";
 
-export default {
+const route: ApiRoute = {
     name: "获取用户菜单",
     handler: async (befly, ctx) => {
         try {
@@ -32,11 +33,11 @@ export default {
             }
 
             // 4. 从缓存获取所有菜单
-            let allMenus = await befly.cache.getMenus();
+            let allMenus: unknown[] = await befly.cache.getMenus();
 
             // 如果缓存不存在，从数据库查询
             if (allMenus.length === 0) {
-                const result = await befly.db.getAll({
+                const result = await befly.db.getAll<DbJsonRow>({
                     table: "addon_admin_menu"
                 });
                 allMenus = result.data.lists;
@@ -48,13 +49,13 @@ export default {
 
             // 5. 根据角色权限过滤菜单（按 menu.path）
             const menuPathSet = new Set<string>(menuPaths);
-            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);
-            });
+            const authorizedMenus = allMenus
+                .filter((menu): menu is Record<string, unknown> => typeof menu === "object" && menu !== null)
+                .filter((menu) => {
+                    const path = menu["path"];
+                    return typeof path === "string" && menuPathSet.has(path);
+                })
+                .map((menu) => menu as DbJsonRow);
 
             // 6. 返回一维数组（由前端构建树形结构）
             return befly.tool.Yes("获取菜单成功", { lists: authorizedMenus });
@@ -63,4 +64,6 @@ export default {
             return befly.tool.No("获取菜单失败");
         }
     }
-} as unknown as ApiRoute;
+};
+
+export default route;

package/apis/role/all.ts

@@ -1,7 +1,10 @@
-export default {
+import type { DbJsonRow } from "../../utils/dbJsonRow";
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取所有角色",
     handler: async (befly) => {
-        const roles = await befly.db.getAll({
+        const roles = await befly.db.getAll<DbJsonRow>({
             table: "addon_admin_role",
             where: {
                 code: {
@@ -14,3 +17,5 @@ export default {
         return befly.tool.Yes("操作成功", { lists: roles.data.lists, total: roles.data.total });
     }
 };
+
+export default route;

package/apis/role/apiSave.ts

@@ -3,7 +3,7 @@ import type { ApiRoute } from "befly/types/api";
 import adminRoleTable from "../../tables/role.json";
 import { normalizePathnameListInput } from "../../utils/normalizePathnameListInput";
 
-export default {
+const route: ApiRoute = {
     name: "保存角色接口权限",
     fields: {
         roleCode: adminRoleTable.code,
@@ -47,4 +47,6 @@ export default {
 
         return befly.tool.Yes("操作成功");
     }
-} as unknown as ApiRoute;
+};
+
+export default route;

package/apis/role/apis.ts

@@ -1,6 +1,8 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 
-export default {
+const route: ApiRoute = {
     name: "获取角色接口权限",
     fields: {
         roleCode: adminRoleTable.code
@@ -17,8 +19,11 @@ export default {
         }
 
         // 数据库自动将 array_text 转换为数组
-        const apiPaths = Array.isArray(role.data.apis) ? role.data.apis : [];
+        const rawApiPaths = Array.isArray(role.data.apis) ? role.data.apis : [];
+        const apiPaths = rawApiPaths.map((p: unknown) => (typeof p === "string" ? p.trim() : "")).filter((p: string) => p.length > 0);
 
         return befly.tool.Yes("操作成功", { apiPaths: apiPaths });
     }
 };
+
+export default route;

package/apis/role/ins.ts

@@ -1,7 +1,9 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 import { normalizePathnameListInput } from "../../utils/normalizePathnameListInput";
 
-export default {
+const route: ApiRoute = {
     name: "创建角色",
     fields: adminRoleTable,
     handler: async (befly, ctx) => {
@@ -45,3 +47,5 @@ export default {
         return befly.tool.Yes("操作成功", { id: roleId.data });
     }
 };
+
+export default route;

package/apis/role/menuSave.ts

@@ -1,7 +1,9 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 import { normalizePathnameListInput } from "../../utils/normalizePathnameListInput";
 
-export default {
+const route: ApiRoute = {
     name: "保存角色菜单权限",
     fields: {
         roleCode: adminRoleTable.code,
@@ -37,3 +39,5 @@ export default {
         return befly.tool.Yes("操作成功");
     }
 };
+
+export default route;

package/apis/role/menus.ts

@@ -1,6 +1,8 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 
-export default {
+const route: ApiRoute = {
     name: "获取角色菜单权限",
     fields: {
         roleCode: adminRoleTable.code
@@ -22,3 +24,5 @@ export default {
         return befly.tool.Yes("操作成功", menuPaths);
     }
 };
+
+export default route;

package/apis/role/save.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "角色保存",
     fields: {
         roleCode: {
@@ -41,3 +43,5 @@ export default {
         }
     }
 };
+
+export default route;

package/apis/role/upd.ts

@@ -1,7 +1,9 @@
+import type { ApiRoute } from "befly/types/api";
+
 import adminRoleTable from "../../tables/role.json";
 import { normalizePathnameListInput } from "../../utils/normalizePathnameListInput";
 
-export default {
+const route: ApiRoute = {
     name: "更新角色",
     fields: adminRoleTable,
     handler: async (befly, ctx) => {
@@ -49,3 +51,5 @@ export default {
         return befly.tool.Yes("操作成功");
     }
 };
+
+export default route;

package/apis/sysConfig/all.ts

@@ -1,4 +1,6 @@
-export default {
+import type { ApiRoute } from "befly/types/api";
+
+const route: ApiRoute = {
     name: "获取所有系统配置",
     handler: async (befly) => {
         const result = await befly.db.getAll({
@@ -9,3 +11,5 @@ export default {
         return befly.tool.Yes("操作成功", { lists: result.data.lists });
     }
 };
+
+export default route;

package/apis/sysConfig/get.ts

@@ -1,6 +1,6 @@
 import type { ApiRoute } from "befly/types/api";
 
-export default {
+const route: ApiRoute = {
     name: "根据代码获取配置值",
     auth: false,
     fields: {
@@ -48,4 +48,6 @@ export default {
 
         return befly.tool.Yes("操作成功", { code: code, value: value });
     }
-} as unknown as ApiRoute;
+};
+
+export default route;

package/apis/sysConfig/ins.ts

@@ -2,7 +2,7 @@ import type { ApiRoute } from "befly/types/api";
 
 import sysConfigTable from "../../tables/sysConfig.json";
 
-export default {
+const route: ApiRoute = {
     name: "添加系统配置",
     fields: sysConfigTable,
     handler: async (befly, ctx) => {
@@ -37,4 +37,6 @@ export default {
             return befly.tool.No("操作失败");
         }
     }
-} as unknown as ApiRoute;
+};
+
+export default route;