befly 3.8.9 → 3.8.10

package/.prettierignore

@@ -0,0 +1,2 @@
+LICENSE
+LICENSE.md

package/.prettierrc

@@ -0,0 +1,12 @@
+{
+    "trailingComma": "none",
+    "tabWidth": 4,
+    "semi": true,
+    "singleQuote": true,
+    "printWidth": 1024,
+    "bracketSpacing": true,
+    "useTabs": false,
+    "arrowParens": "always",
+    "endOfLine": "lf",
+    "plugins": ["@prettier/plugin-oxc"]
+}

package/bunfig.toml

@@ -0,0 +1,3 @@
+[install]
+# 使用隔离模式
+linker = "isolated"

package/env.ts

@@ -22,7 +22,6 @@ const coreEnv: EnvConfig = {
     DEV_EMAIL: 'dev@qq.com',
     DEV_PASSWORD: '123456',
     BODY_LIMIT: 10485760, // 10MB
-    PARAMS_CHECK: false,
 
     // ========== 日志配置 ==========
     LOG_DEBUG: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.8.9",
+    "version": "3.8.10",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -40,13 +40,9 @@
     "files": [
         "lib/",
         "loader/",
-        "middleware/",
+        "plugins/",
         "router/",
         "types/",
-        ".gitignore",
-        ".npmignore",
-        ".bunignore",
-        ".editorconfig",
         ".npmrc",
         ".prettierignore",
         ".prettierrc",
@@ -56,11 +52,11 @@
         "main.ts",
         "check.ts",
         "env.ts",
-        "menu.json",
         "paths.ts",
         "util.ts",
         "package.json",
-        "README.md"
+        "README.md",
+        "LICENSE"
     ],
     "engines": {
         "bun": ">=1.3.0"
@@ -69,5 +65,5 @@
         "es-toolkit": "^1.41.0",
         "pathe": "^2.0.3"
     },
-    "gitHead": "6e8ca2ec311fcc99e89adc35c151e9a63e7e8e0e"
+    "gitHead": "492e46d692787e6d141659fba27c26e030cd1181"
 }

package/plugins/cache.ts

@@ -0,0 +1,22 @@
+/**
+ * 缓存插件 - TypeScript 版本
+ * 负责在服务器启动时缓存接口、菜单和角色权限到 Redis
+ */
+
+import { CacheHelper } from '../lib/cacheHelper.js';
+import type { Plugin } from '../types/plugin.js';
+import type { BeflyContext } from '../types/befly.js';
+
+/**
+ * 缓存插件
+ */
+const cachePlugin: Plugin = {
+    name: '_cache',
+    after: ['_db', '_redis'],
+
+    async onInit(befly: BeflyContext): Promise<CacheHelper> {
+        return new CacheHelper(befly);
+    }
+};
+
+export default cachePlugin;

package/plugins/db.ts

@@ -0,0 +1,59 @@
+/**
+ * 数据库插件 - TypeScript 版本
+ * 初始化数据库连接和 SQL 管理器
+ */
+
+import { Env } from '../env.js';
+import { Logger } from '../lib/logger.js';
+import { Database } from '../lib/database.js';
+import { DbHelper } from '../lib/dbHelper.js';
+import type { Plugin } from '../types/plugin.js';
+import type { BeflyContext } from '../types/befly.js';
+
+/**
+ * 数据库插件
+ */
+const dbPlugin: Plugin = {
+    name: '_db',
+    after: ['_redis'],
+
+    async onInit(befly: BeflyContext): Promise<DbHelper | Record<string, never>> {
+        let sql: any = null;
+
+        try {
+            if (Env.DB_ENABLE === 1) {
+                // 创建 Bun SQL 客户端（内置连接池），并确保连接验证成功后再继续
+                // 从环境变量读取连接超时配置
+                const connectionTimeout = Env.DB_CONNECTION_TIMEOUT ? parseInt(Env.DB_CONNECTION_TIMEOUT) : 30000;
+
+                sql = await Database.connectSql({
+                    connectionTimeout
+                });
+
+                // 创建数据库管理器实例，直接传入 sql 对象
+                const dbManager = new DbHelper(befly, sql);
+
+                return dbManager;
+            } else {
+                Logger.warn('数据库未启用（DB_ENABLE≠1），跳过初始化');
+                return {};
+            }
+        } catch (error: any) {
+            Logger.error('数据库初始化失败', error);
+
+            // 清理资源
+            if (sql) {
+                try {
+                    await sql.close();
+                } catch (cleanupError: any) {
+                    Logger.error('清理连接池失败:', cleanupError);
+                }
+            }
+
+            // 插件内禁止直接退出进程，抛出异常交由主流程统一处理
+            throw error;
+        }
+    }
+};
+
+export default dbPlugin;

package/plugins/logger.ts

@@ -0,0 +1,27 @@
+/**
+ * 日志插件 - TypeScript 版本
+ * 提供全局日志功能
+ */
+
+import { Logger } from '../lib/logger.js';
+import type { Plugin } from '../types/plugin.js';
+import type { BeflyContext } from '../types/befly.js';
+
+/**
+ * 日志插件
+ */
+const loggerPlugin: Plugin = {
+    name: '_logger',
+    after: [],
+
+    async onInit(befly: BeflyContext): Promise<typeof Logger> {
+        try {
+            return Logger;
+        } catch (error: any) {
+            // 插件内禁止直接退出进程，抛出异常交由主流程统一处理
+            throw error;
+        }
+    }
+};
+
+export default loggerPlugin;

package/plugins/redis.ts

@@ -0,0 +1,41 @@
+/**
+ * Redis 插件 - TypeScript 版本
+ * 初始化 Redis 连接和助手工具
+ */
+
+import { Env } from '../env.js';
+import { Logger } from '../lib/logger.js';
+import { RedisHelper } from '../lib/redisHelper.js';
+import { Database } from '../lib/database.js';
+import type { Plugin } from '../types/plugin.js';
+import type { BeflyContext } from '../types/befly.js';
+
+/**
+ * Redis 插件
+ */
+const redisPlugin: Plugin = {
+    name: '_redis',
+    after: ['_logger'],
+
+    async onInit(befly: BeflyContext): Promise<RedisHelper | Record<string, never>> {
+        try {
+            if (Env.REDIS_ENABLE === 1) {
+                // 初始化 Redis 客户端（统一使用 database.ts 的连接管理）
+                await Database.connectRedis();
+
+                // 返回 RedisHelper 实例
+                return new RedisHelper();
+            } else {
+                Logger.warn('Redis 未启用，跳过初始化');
+                return {};
+            }
+        } catch (error: any) {
+            Logger.error('Redis 初始化失败', error);
+
+            // 插件内禁止直接退出进程，抛出异常交由主流程统一处理
+            throw error;
+        }
+    }
+};
+
+export default redisPlugin;