befly 3.5.1 → 3.5.3

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/commands/build.ts

@@ -1,62 +0,0 @@
-/**
- * Build 命令 - 构建项目
- */
-
-import { join } from 'pathe';
-import { existsSync } from 'node:fs';
-import { Logger } from '../lib/logger.js';
-import { getProjectRoot } from './util.js';
-
-interface BuildOptions {
-    outdir: string;
-    minify: boolean;
-    sourcemap: boolean;
-}
-
-export async function buildCommand(options: BuildOptions) {
-    try {
-        const projectRoot = getProjectRoot();
-
-        // 验证是否在项目目录下
-        const packageJsonPath = join(projectRoot, 'package.json');
-        if (!existsSync(packageJsonPath)) {
-            Logger.error('未找到 package.json 文件，请确保在项目目录下');
-            process.exit(1);
-        }
-
-        // 使用内置默认入口文件
-        const entryFile = join(import.meta.dir, '..', 'entry.ts');
-
-        Logger.info('正在构建项目...');
-
-        const args = ['build', entryFile, '--outdir', options.outdir, '--target', 'bun'];
-
-        if (options.minify) {
-            args.push('--minify');
-        }
-
-        if (options.sourcemap) {
-            args.push('--sourcemap');
-        }
-
-        const proc = Bun.spawn(['bun', ...args], {
-            cwd: projectRoot,
-            stdout: 'pipe',
-            stderr: 'pipe'
-        });
-
-        await proc.exited;
-
-        if (proc.exitCode === 0) {
-            Logger.success('项目构建完成');
-            Logger.success(`输出目录: ${options.outdir}`);
-        } else {
-            Logger.error('项目构建失败');
-            process.exit(1);
-        }
-    } catch (error) {
-        Logger.error('构建失败:');
-        console.error(error);
-        process.exit(1);
-    }
-}

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', '')
-};