befly 3.5.2 → 3.5.3

package/lib/redisHelper.ts

@@ -1,10 +1,10 @@
-/**
+/**
  * Redis 助手 - TypeScript 版本
  * 提供 Redis 操作的便捷方法
  */
 
 import { RedisClient } from 'bun';
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import { Logger } from '../lib/logger.js';
 import { Database } from './database.js';
 

package/lib/sqlBuilder.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * SQL 构造器 - TypeScript 版本
  * 提供链式 API 构建 SQL 查询
  */

package/lib/validator.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 数据验证器 - Befly 项目专用
  * 内置 RegexAliases，直接使用 util.ts 中的 parseRule
  */

package/lib/xml.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * XML 解析器 - TypeScript 版本
  * 将 XML 字符串解析为 JSON 对象
  */

package/lifecycle/bootstrap.ts

@@ -1,11 +1,11 @@
-/**
+/**
  * 服务启动引导器
  * 负责组装和启动Bun HTTP服务器
  */
 
 import { Logger } from '../lib/logger.js';
 import { calcPerfTime, No } from '../util.js';
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import { rootHandler } from '../router/root.js';
 import { apiHandler } from '../router/api.js';
 import { staticHandler } from '../router/static.js';

package/lifecycle/checker.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 系统检查管理器
  * 负责在框架启动前执行系统检查
  */

package/lifecycle/lifecycle.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 生命周期管理器
  * 统一管理框架的启动流程：检查、加载插件、加载API、启动服务器
  */

package/lifecycle/loader.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 插件和API加载器
  * 负责加载和初始化插件以及API路由
  */

package/main.ts

@@ -1,9 +1,9 @@
-/**
+/**
  * Befly 框架主入口文件
  * 提供简洁的框架接口，核心逻辑已提取到 lifecycle 层
  */
 
-import { Env } from './config/env.js';
+import { Env } from './env.js';
 import { Yes, No } from './util.js';
 import { Logger } from './lib/logger.js';
 import { Cipher } from './lib/cipher.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.5.2",
+    "version": "3.5.3",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -78,5 +78,5 @@
         "es-toolkit": "^1.41.0",
         "pathe": "^2.0.3"
     },
-    "gitHead": "0896911e340ee0e7ee9d65a28d0809a3365ee9f4"
+    "gitHead": "97e7d2949ef44b34f38797bfcdf626892b002712"
 }

package/paths.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly 框架路径配置
  *
  * 提供统一的路径常量，供整个框架使用

package/plugins/cache.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 缓存插件 - TypeScript 版本
  * 负责在服务器启动时缓存接口、菜单和角色权限到 Redis
  */

package/plugins/db.ts

@@ -1,9 +1,9 @@
-/**
+/**
  * 数据库插件 - TypeScript 版本
  * 初始化数据库连接和 SQL 管理器
  */
 
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import { Logger } from '../lib/logger.js';
 import { Database } from '../lib/database.js';
 import { DbHelper } from '../lib/dbHelper.js';
@@ -24,7 +24,7 @@ const dbPlugin: Plugin = {
             if (Env.DB_ENABLE === 1) {
                 // 创建 Bun SQL 客户端（内置连接池），并确保连接验证成功后再继续
                 // 从环境变量读取连接超时配置
-                const connectionTimeout = process.env.DB_CONNECTION_TIMEOUT ? parseInt(process.env.DB_CONNECTION_TIMEOUT) : 5000;
+                const connectionTimeout = Env.DB_CONNECTION_TIMEOUT ? parseInt(Env.DB_CONNECTION_TIMEOUT) : 5000;
 
                 sql = await Database.connectSql({
                     connectionTimeout

package/plugins/logger.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 日志插件 - TypeScript 版本
  * 提供全局日志功能
  */

package/plugins/redis.ts

@@ -1,9 +1,9 @@
-/**
+/**
  * Redis 插件 - TypeScript 版本
  * 初始化 Redis 连接和助手工具
  */
 
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import { Logger } from '../lib/logger.js';
 import { RedisHelper } from '../lib/redisHelper.js';
 import { Database } from '../lib/database.js';

package/router/api.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * API路由处理器
  * 处理 /api/* 路径的请求
  */
@@ -6,7 +6,7 @@
 import { Logger } from '../lib/logger.js';
 import { No } from '../util.js';
 import { setCorsOptions, handleOptionsRequest, authenticate, parseGetParams, parsePostParams, checkPermission, validateParams, executePluginHooks, logRequest } from '../lib/middleware.js';
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import type { RequestContext } from '../util.js';
 import type { ApiRoute } from '../types/api.js';
 import type { Plugin } from '../types/plugin.js';

package/router/root.ts

@@ -1,9 +1,9 @@
-/**
+/**
  * 根路径路由处理器
  * 处理 / 路径的请求
  */
 
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 import { setCorsOptions } from '../lib/middleware.js';
 import { Logger } from '../lib/logger.js';
 import { No } from '../util.js';

package/router/static.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 静态文件路由处理器
  * 处理 /* 路径的静态文件请求
  */
@@ -8,7 +8,7 @@ import { projectDir } from '../paths.js';
 import { No } from '../util.js';
 import { setCorsOptions } from '../lib/middleware.js';
 import { Logger } from '../lib/logger.js';
-import { Env } from '../config/env.js';
+import { Env } from '../env.js';
 
 /**
  * 静态文件处理器

package/types/addon.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Addon 配置类型定义
  */
 

package/types/api.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly API 类型定义
  */
 

package/types/befly.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly 核心框架类型定义
  */
 

package/types/common.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly 框架通用类型定义
  */
 

package/types/context.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 请求上下文类型定义
  * 实现代码位于 util.ts，类型定义位于 types/util.d.ts
  */

package/types/crypto.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 加密相关类型定义
  */
 

package/types/database.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 数据库相关类型定义
  */
 

package/types/env.ts

@@ -0,0 +1,67 @@
+/**
+ * 环境变量配置接口
+ */
+export interface EnvConfig {
+    // ========== 项目配置 ==========
+    NODE_ENV: string;
+    APP_NAME: string;
+    APP_PORT: number;
+    APP_HOST: string;
+    DEV_EMAIL: string;
+    DEV_PASSWORD: string;
+    BODY_LIMIT: number;
+    PARAMS_CHECK: string;
+
+    // ========== 日志配置 ==========
+    LOG_DEBUG: number;
+    LOG_EXCLUDE_FIELDS: string;
+    LOG_DIR: string;
+    LOG_TO_CONSOLE: number;
+    LOG_MAX_SIZE: number;
+
+    // ========== 时区配置 ==========
+    TZ: string;
+
+    // ========== 数据库配置 ==========
+    DB_ENABLE: number;
+    DB_TYPE: string;
+    DB_HOST: string;
+    DB_PORT: number;
+    DB_USER: string;
+    DB_PASS: string;
+    DB_NAME: string;
+    DB_DEBUG: number;
+    DB_POOL_MAX: number;
+
+    // ========== Redis 配置 ==========
+    REDIS_ENABLE: number;
+    REDIS_HOST: string;
+    REDIS_PORT: number;
+    REDIS_USERNAME: string;
+    REDIS_PASSWORD: string;
+    REDIS_DB: number;
+    REDIS_KEY_PREFIX: string;
+
+    // ========== JWT 配置 ==========
+    JWT_SECRET: string;
+    JWT_EXPIRES_IN: string;
+    JWT_ALGORITHM: string;
+
+    // ========== CORS 配置 ==========
+    CORS_ALLOWED_ORIGIN: string;
+    CORS_ALLOWED_METHODS: string;
+    CORS_ALLOWED_HEADERS: string;
+    CORS_EXPOSE_HEADERS: string;
+    CORS_MAX_AGE: number;
+    CORS_ALLOW_CREDENTIALS: string;
+
+    // ========== 邮件配置 ==========
+    MAIL_HOST: string;
+    MAIL_PORT: number;
+    MAIL_POOL: string;
+    MAIL_SECURE: string;
+    MAIL_USER: string;
+    MAIL_PASS: string;
+    MAIL_SENDER: string;
+    MAIL_ADDRESS: string;
+}

package/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * 类型定义导出
+ */
+
+export * from './env.js';

package/types/jwt.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * JWT 相关类型定义
  */
 

package/types/logger.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 日志相关类型定义
  */
 

package/types/plugin.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly 插件系统类型定义
  */
 

package/types/redis.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Redis 相关类型定义
  */
 

package/types/tool.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 工具函数相关类型定义
  */
 

package/types/util.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * util.ts 相关类型定义
  */
 

package/types/validator.d.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * 验证器相关类型定义
  */
 

package/util.ts

@@ -1,4 +1,4 @@
-/**
+/**
  * Befly 核心工具函数集合
  *
  * 本文件整合了框架核心工具函数：
@@ -20,7 +20,7 @@ import { join } from 'pathe';
 import { readdirSync, statSync, readFileSync, existsSync } from 'node:fs';
 import { isEmpty, isPlainObject } from 'es-toolkit/compat';
 import { snakeCase, camelCase, kebabCase } from 'es-toolkit/string';
-import { Env } from './config/env.js';
+import { Env } from './env.js';
 import { Logger } from './lib/logger.js';
 import { projectDir } from './paths.js';
 import type { KeyValue } from './types/common.js';

package/config/env.ts

@@ -1,202 +0,0 @@
-/**
- * 环境变量配置 - TypeScript 版本
- * 类型化所有环境变量
- */
-
-/**
- * 环境变量配置接口
- */
-export interface EnvConfig {
-    // ========== 项目配置 ==========
-    /** 项目模式：development | production | test */
-    NODE_ENV: string;
-    /** 应用名称 */
-    APP_NAME: string;
-    /** 监听端口 */
-    APP_PORT: number;
-    /** 监听主机 */
-    APP_HOST: string;
-    /** 开发管理员邮箱 */
-    DEV_EMAIL: string;
-    /** 开发管理员密码 */
-    DEV_PASSWORD: string;
-    /** 请求体大小限制（字节） */
-    BODY_LIMIT: number;
-    /** 是否进行参数验证 */
-    PARAMS_CHECK: string;
-
-    // ========== 日志配置 ==========
-    /** debug日志开关：0 | 1 */
-    LOG_DEBUG: number;
-    /** 日志排除字段（逗号分隔） */
-    LOG_EXCLUDE_FIELDS: string;
-    /** 日志目录 */
-    LOG_DIR: string;
-    /** 是否输出到控制台：0 | 1 */
-    LOG_TO_CONSOLE: number;
-    /** 日志文件最大大小（字节） */
-    LOG_MAX_SIZE: number;
-
-    // ========== 时区配置 ==========
-    /** 时区：Asia/Shanghai */
-    TZ: string;
-
-    // ========== 数据库配置 ==========
-    /** 是否启用数据库：0 | 1 */
-    DB_ENABLE: number;
-    /** 数据库类型：sqlite | mysql | postgresql */
-    DB_TYPE: string;
-    /** 数据库主机 */
-    DB_HOST: string;
-    /** 数据库端口 */
-    DB_PORT: number;
-    /** 数据库用户名 */
-    DB_USER: string;
-    /** 数据库密码 */
-    DB_PASS: string;
-    /** 数据库名称 */
-    DB_NAME: string;
-    /** 是否启用调试：0 | 1 */
-    DB_DEBUG: number;
-    /** 连接池最大连接数 */
-    DB_POOL_MAX: number;
-
-    // ========== Redis 配置 ==========
-    /** 是否启用 Redis：0 | 1 */
-    REDIS_ENABLE: number;
-    /** Redis 主机 */
-    REDIS_HOST: string;
-    /** Redis 端口 */
-    REDIS_PORT: number;
-    /** Redis 用户名 */
-    REDIS_USERNAME: string;
-    /** Redis 密码 */
-    REDIS_PASSWORD: string;
-    /** Redis 数据库索引 */
-    REDIS_DB: number;
-    /** Redis 键前缀 */
-    REDIS_KEY_PREFIX: string;
-
-    // ========== JWT 配置 ==========
-    /** JWT 密钥 */
-    JWT_SECRET: string;
-    /** JWT 过期时间：7d | 30d | 1h */
-    JWT_EXPIRES_IN: string;
-    /** JWT 算法：HS256 | HS384 | HS512 */
-    JWT_ALGORITHM: string;
-
-    // ========== CORS 配置 ==========
-    /** 允许的来源 */
-    CORS_ALLOWED_ORIGIN: string;
-    /** 允许的方法 */
-    CORS_ALLOWED_METHODS: string;
-    /** 允许的头部 */
-    CORS_ALLOWED_HEADERS: string;
-    /** 暴露的头部 */
-    CORS_EXPOSE_HEADERS: string;
-    /** 预检请求缓存时间（秒） */
-    CORS_MAX_AGE: number;
-    /** 是否允许凭证 */
-    CORS_ALLOW_CREDENTIALS: string;
-
-    // ========== 邮件配置 ==========
-    /** 邮件服务器主机 */
-    MAIL_HOST: string;
-    /** 邮件服务器端口 */
-    MAIL_PORT: number;
-    /** 是否使用连接池 */
-    MAIL_POOL: string;
-    /** 是否使用 SSL */
-    MAIL_SECURE: string;
-    /** 邮件用户名 */
-    MAIL_USER: string;
-    /** 邮件密码 */
-    MAIL_PASS: string;
-    /** 发件人名称 */
-    MAIL_SENDER: string;
-    /** 发件人地址 */
-    MAIL_ADDRESS: string;
-}
-
-/**
- * 获取环境变量值（带默认值）
- */
-const getEnv = (key: string, defaultValue: string = ''): string => {
-    return process.env[key] || defaultValue;
-};
-
-/**
- * 获取数字类型环境变量
- */
-const getEnvNumber = (key: string, defaultValue: number = 0): number => {
-    const value = process.env[key];
-    return value ? Number(value) : defaultValue;
-};
-
-/**
- * 环境变量配置对象
- */
-export const Env: EnvConfig = {
-    // ========== 项目配置 ==========
-    NODE_ENV: getEnv('NODE_ENV', 'development'),
-    APP_NAME: getEnv('APP_NAME', 'befly'),
-    APP_PORT: getEnvNumber('APP_PORT', 3000),
-    APP_HOST: getEnv('APP_HOST', '0.0.0.0'),
-    DEV_EMAIL: getEnv('DEV_EMAIL', 'dev@qq.com'),
-    DEV_PASSWORD: getEnv('DEV_PASSWORD', ''),
-    BODY_LIMIT: getEnvNumber('BODY_LIMIT', 10485760), // 10MB
-    PARAMS_CHECK: getEnv('PARAMS_CHECK', 'true'),
-
-    // ========== 日志配置 ==========
-    LOG_DEBUG: getEnvNumber('LOG_DEBUG', 0),
-    LOG_EXCLUDE_FIELDS: getEnv('LOG_EXCLUDE_FIELDS', 'password,token,secret'),
-    LOG_DIR: getEnv('LOG_DIR', './logs'),
-    LOG_TO_CONSOLE: getEnvNumber('LOG_TO_CONSOLE', 1),
-    LOG_MAX_SIZE: getEnvNumber('LOG_MAX_SIZE', 10485760), // 10MB
-
-    // ========== 时区配置 ==========
-    TZ: getEnv('TZ', 'Asia/Shanghai'),
-
-    // ========== 数据库配置 ==========
-    DB_ENABLE: getEnvNumber('DB_ENABLE', 1),
-    DB_TYPE: getEnv('DB_TYPE', 'mysql'),
-    DB_HOST: getEnv('DB_HOST', 'localhost'),
-    DB_PORT: getEnvNumber('DB_PORT', 3306),
-    DB_USER: getEnv('DB_USER', 'root'),
-    DB_PASS: getEnv('DB_PASS', ''),
-    DB_NAME: getEnv('DB_NAME', 'befly'),
-    DB_DEBUG: getEnvNumber('DB_DEBUG', 0),
-    DB_POOL_MAX: getEnvNumber('DB_POOL_MAX', 10),
-
-    // ========== Redis 配置 ==========
-    REDIS_ENABLE: getEnvNumber('REDIS_ENABLE', 1),
-    REDIS_HOST: getEnv('REDIS_HOST', 'localhost'),
-    REDIS_PORT: getEnvNumber('REDIS_PORT', 6379),
-    REDIS_USERNAME: getEnv('REDIS_USERNAME', ''),
-    REDIS_PASSWORD: getEnv('REDIS_PASSWORD', ''),
-    REDIS_DB: getEnvNumber('REDIS_DB', 0),
-    REDIS_KEY_PREFIX: getEnv('REDIS_KEY_PREFIX', 'befly'),
-
-    // ========== JWT 配置 ==========
-    JWT_SECRET: getEnv('JWT_SECRET', 'befly-secret'),
-    JWT_EXPIRES_IN: getEnv('JWT_EXPIRES_IN', '7d'),
-    JWT_ALGORITHM: getEnv('JWT_ALGORITHM', 'HS256'),
-
-    // ========== CORS 配置 ==========
-    CORS_ALLOWED_ORIGIN: getEnv('CORS_ALLOWED_ORIGIN', '*'),
-    CORS_ALLOWED_METHODS: getEnv('CORS_ALLOWED_METHODS', 'GET, POST, PUT, DELETE, OPTIONS'),
-    CORS_ALLOWED_HEADERS: getEnv('CORS_ALLOWED_HEADERS', 'Content-Type, Authorization, authorization, token'),
-    CORS_EXPOSE_HEADERS: getEnv('CORS_EXPOSE_HEADERS', 'Content-Range, X-Content-Range, Authorization, authorization, token'),
-    CORS_MAX_AGE: getEnvNumber('CORS_MAX_AGE', 86400),
-    CORS_ALLOW_CREDENTIALS: getEnv('CORS_ALLOW_CREDENTIALS', 'true'),
-
-    // ========== 邮件配置 ==========
-    MAIL_HOST: getEnv('MAIL_HOST', ''),
-    MAIL_PORT: getEnvNumber('MAIL_PORT', 587),
-    MAIL_POOL: getEnv('MAIL_POOL', 'true'),
-    MAIL_SECURE: getEnv('MAIL_SECURE', 'false'),
-    MAIL_USER: getEnv('MAIL_USER', ''),
-    MAIL_PASS: getEnv('MAIL_PASS', ''),
-    MAIL_SENDER: getEnv('MAIL_SENDER', ''),
-    MAIL_ADDRESS: getEnv('MAIL_ADDRESS', '')
-};