befly 3.0.0 → 3.1.1

package/utils/index.ts

@@ -5,42 +5,29 @@
  * 保持向后兼容性，支持从 utils/index.js 导入所有工具函数
  */
 
-// ========== API 响应工具 ==========
-export { Yes, No } from './response.js';
+// ========== 通用辅助工具（helpers.ts）==========
+export { Yes, No, isDebug, isType, isEmptyObject, isEmptyArray, pickFields, formatDate, calcPerfTime, cleanData, toSnakeCase, toCamelCase, keysToSnake, keysToCamel } from './helper.js';
+export type { DataCleanOptions } from './helper.js';
 
-// ========== 类型判断工具 ==========
-export { isType, isEmptyObject, isEmptyArray } from './typeHelper.js';
-
-// ========== 对象操作工具 ==========
-export { pickFields, omitFields } from './objectHelper.js';
-
-// ========== 日期时间工具 ==========
-export { formatDate, calcPerfTime } from './datetime.js';
+// ========== 框架工具 ==========
+export { scanAddons, getAddonDir, addonDirExists, sortPlugins, parseRule } from './helper.js';
 
 // ========== 数据库工具 ==========
-export { toSnakeTableName, buildDatabaseUrl, createSqlClient } from './dbHelper.js';
-
-// ========== 表定义工具 ==========
-export { parseRule, loadTableFields, pickTableFields } from './tableHelper.js';
-
-// ========== 插件系统工具 ==========
-export { sortPlugins } from './pluginHelper.js';
+export { buildDatabaseUrl, createSqlClient, buildRedisUrl, createRedisClient, initDatabase, closeDatabase, initSqlOnly, initRedisOnly, getRedis, getSql, getDbHelper, isDatabaseInitialized } from './database.js';
 
-// 导出其他模块
+// 导出其他大型模块
 export { Colors } from './colors.js';
 export { Logger } from './logger.js';
 export { Validator } from './validate.js';
 export { SqlBuilder } from './sqlBuilder.js';
-export { SqlHelper } from './sqlHelper.js';
-export { RedisHelper, initRedisClient, getRedisClient, closeRedisClient } from './redisHelper.js';
+export { DbHelper } from './dbHelper.js';
+export { RedisHelper } from './redisHelper.js';
 export { Jwt } from './jwt.js';
 export { Crypto2 } from './crypto.js';
 export { Xml } from './xml.js';
-export { Api } from './api.js';
-export { Tool } from './tool.js';
 
 // 类型导出
-export type { QueryOptions, InsertOptions, UpdateOptions, DeleteOptions, ListResult, TransactionCallback } from './sqlHelper.js';
+export type { QueryOptions, InsertOptions, UpdateOptions, DeleteOptions, ListResult, TransactionCallback } from './dbHelper.js';
 export type { JwtPayload } from './jwt.js';
 export type { EncodingType, HashAlgorithm } from './crypto.js';
 export type { XmlParseOptions } from './xml.js';

package/utils/logger.ts

@@ -6,19 +6,10 @@
 import path from 'path';
 import { appendFile, stat } from 'node:fs/promises';
 import { formatDate } from './index.js';
+import { Colors } from './colors.js';
 import { Env } from '../config/env.js';
 import type { LogLevel } from '../types/common.js';
 
-/**
- * 日志级别映射
- */
-interface LogLevels {
-    error: number;
-    warn: number;
-    info: number;
-    debug: number;
-}
-
 /**
  * 日志消息类型
  */
@@ -28,17 +19,6 @@ type LogMessage = string | number | boolean | null | undefined | Record<string,
  * 日志器类
  */
 export class Logger {
-    /** 当前日志级别 */
-    static level: LogLevel = (Env.LOG_LEVEL as LogLevel) || 'info';
-
-    /** 日志级别权重 */
-    static readonly levels: LogLevels = {
-        error: 0,
-        warn: 1,
-        info: 2,
-        debug: 3
-    };
-
     /** 日志目录 */
     static logDir: string = Env.LOG_DIR || 'logs';
 
@@ -49,55 +29,44 @@ export class Logger {
     private static currentFiles: Map<string, string> = new Map();
 
     /**
-     * 格式化日志消息
+     * 记录日志
      * @param level - 日志级别
      * @param message - 日志消息
-     * @returns 格式化后的日志字符串
      */
-    static formatMessage(level: LogLevel, message: LogMessage): string {
-        const timestamp = formatDate();
-        const levelStr = level.toUpperCase().padStart(5);
+    static async log(level: LogLevel, message: LogMessage): Promise<void> {
+        // debug 日志特殊处理：仅当 LOG_DEBUG=1 时才记录
+        if (level === 'debug' && Env.LOG_DEBUG !== 1) return;
 
-        let msg = `[${timestamp}] ${levelStr} - `;
+        // 格式化消息
+        const timestamp = formatDate();
+        const colorMap = {
+            info: Colors.greenBright,
+            debug: Colors.cyanBright,
+            warn: Colors.yellowBright,
+            error: Colors.redBright
+        };
 
-        // 处理不同类型的消息
-        if (typeof message === 'object' && message !== null) {
-            if (Object.keys(message).length > 0) {
-                msg += JSON.stringify(message).replace(/\s+/g, ' ').replace(/\\"/g, '"').replace(/\\n/g, ' ');
-            }
+        // 处理消息内容
+        let content = '';
+        if (typeof message === 'object' && message !== null && Object.keys(message).length > 0) {
+            content = JSON.stringify(message, null, 0).replace(/\\"/g, '"');
         } else {
-            msg += String(message);
+            content = String(message);
         }
 
-        return msg;
-    }
-
-    /**
-     * 检查是否应该记录该级别的日志
-     * @param level - 日志级别
-     * @returns 是否应该记录
-     */
-    private static shouldLog(level: LogLevel): boolean {
-        return this.levels[level] <= this.levels[this.level];
-    }
-
-    /**
-     * 记录日志
-     * @param level - 日志级别
-     * @param message - 日志消息
-     */
-    static async log(level: LogLevel, message: LogMessage): Promise<void> {
-        // 检查日志级别
-        if (!this.shouldLog(level)) return;
-
-        const formattedMessage = this.formatMessage(level, message);
+        // 带颜色的控制台消息
+        const coloredLevelStr = colorMap[level](level.toUpperCase().padStart(5));
+        const coloredMessage = `[${timestamp}] ${coloredLevelStr} - ${content}`;
 
         // 控制台输出
         if (Env.LOG_TO_CONSOLE === 1) {
-            console.log(formattedMessage);
+            console.log(coloredMessage);
         }
 
-        await this.writeToFile(formattedMessage, level);
+        // 文件输出（去除 ANSI 颜色代码）
+        const plainLevelStr = level.toUpperCase().padStart(5);
+        const plainMessage = `[${timestamp}] ${plainLevelStr} - ${content}`;
+        await this.writeToFile(plainMessage, level);
     }
 
     /**
@@ -107,14 +76,8 @@ export class Logger {
      */
     static async writeToFile(message: string, level: LogLevel = 'info'): Promise<void> {
         try {
-            let prefix: string;
-
-            // debug 日志使用单独的文件名
-            if (level === 'debug') {
-                prefix = 'debug';
-            } else {
-                prefix = new Date().toISOString().split('T')[0];
-            }
+            // 确定文件前缀
+            const prefix = level === 'debug' ? 'debug' : new Date().toISOString().split('T')[0];
 
             // 检查缓存的当前文件是否仍然可用
             let currentLogFile = this.currentFiles.get(prefix);
@@ -122,74 +85,76 @@ export class Logger {
             if (currentLogFile) {
                 try {
                     const stats = await stat(currentLogFile);
-                    // 如果文件超过最大大小，清除缓存
                     if (stats.size >= this.maxFileSize) {
                         this.currentFiles.delete(prefix);
                         currentLogFile = undefined;
                     }
-                } catch (error) {
-                    // 文件不存在或无法访问，清除缓存
+                } catch {
                     this.currentFiles.delete(prefix);
                     currentLogFile = undefined;
                 }
             }
 
-            // 如果没有缓存的文件或文件已满，查找合适的文件
+            // 查找或创建新文件
             if (!currentLogFile) {
-                currentLogFile = await this.findAvailableLogFile(prefix);
+                const glob = new Bun.Glob(`${prefix}.*.log`);
+                const files = await Array.fromAsync(glob.scan(this.logDir));
+
+                // 按索引排序并查找可用文件
+                const getIndex = (f: string) => parseInt(f.match(/\.(\d+)\.log$/)?.[1] || '0');
+                files.sort((a, b) => getIndex(a) - getIndex(b));
+
+                let foundFile = false;
+                for (let i = files.length - 1; i >= 0; i--) {
+                    const filePath = path.join(this.logDir, files[i]);
+                    try {
+                        const stats = await stat(filePath);
+                        if (stats.size < this.maxFileSize) {
+                            currentLogFile = filePath;
+                            foundFile = true;
+                            break;
+                        }
+                    } catch {
+                        continue;
+                    }
+                }
+
+                // 没有可用文件，创建新文件
+                if (!foundFile) {
+                    const maxIndex = files.length > 0 ? Math.max(...files.map(getIndex)) : -1;
+                    currentLogFile = path.join(this.logDir, `${prefix}.${maxIndex + 1}.log`);
+                }
+
                 this.currentFiles.set(prefix, currentLogFile);
             }
 
-            // 使用 Node.js 的 appendFile 进行文件追加
             await appendFile(currentLogFile, message + '\n', 'utf8');
         } catch (error: any) {
-            console.error('写入日志文件失败:', error.message);
+            console.error('写入日志文件失败:', error?.message || error);
         }
     }
 
     /**
-     * 查找可用的日志文件
-     * @param prefix - 文件前缀
-     * @returns 可用的日志文件路径
+     * 记录错误日志
+     * @param name - 错误名称/位置
+     * @param error - 错误对象或消息
      */
-    static async findAvailableLogFile(prefix: string): Promise<string> {
-        const glob = new Bun.Glob(`${prefix}.*.log`);
-        const files = await Array.fromAsync(glob.scan(this.logDir));
-
-        // 按文件名排序
-        files.sort((a, b) => {
-            const aNum = parseInt(a.match(/\.(\d+)\.log$/)?.[1] || '0');
-            const bNum = parseInt(b.match(/\.(\d+)\.log$/)?.[1] || '0');
-            return aNum - bNum;
-        });
-
-        // 从最后一个文件开始检查
-        for (let i = files.length - 1; i >= 0; i--) {
-            const filePath = path.join(this.logDir, files[i]);
-            try {
-                const stats = await stat(filePath);
-                if (stats.size < this.maxFileSize) {
-                    return filePath;
-                }
-            } catch (error) {
-                // 文件不存在或无法访问，跳过
-                continue;
-            }
+    static async error(name: string, error?: any): Promise<void> {
+        if (!error) {
+            return this.log('error', name);
         }
 
-        // 所有文件都已满或没有文件，创建新文件
-        const existingIndices = files.map((f) => parseInt(f.match(/\.(\d+)\.log$/)?.[1] || '0'));
-        const nextIndex = existingIndices.length > 0 ? Math.max(...existingIndices) + 1 : 0;
-
-        return path.join(this.logDir, `${prefix}.${nextIndex}.log`);
-    }
+        // 构建错误消息
+        const parts = [name];
+        if (error?.message || error?.stack) {
+            if (error.message) parts.push(error.message);
+            if (error.stack) parts.push('\n' + error.stack);
+        } else {
+            const errorStr = typeof error === 'object' ? JSON.stringify(error) : String(error);
+            parts.push(errorStr);
+        }
 
-    /**
-     * 记录错误日志
-     * @param message - 日志消息
-     */
-    static async error(message: LogMessage): Promise<void> {
-        await this.log('error', message);
+        await this.log('error', parts.join(' - '));
     }
 
     /**
@@ -209,52 +174,12 @@ export class Logger {
     }
 
     /**
-     * 记录调试日志（总是记录，忽略级别检查）
+     * 记录调试日志
+     * 受 LOG_DEBUG 环境变量控制，仅当 LOG_DEBUG=1 时才记录
      * @param message - 日志消息
      */
     static async debug(message: LogMessage): Promise<void> {
-        const formattedMessage = this.formatMessage('debug', message);
-
-        // 控制台输出
-        if (Env.LOG_TO_CONSOLE === 1) {
-            console.log(formattedMessage);
-        }
-
-        await this.writeToFile(formattedMessage, 'debug');
-    }
-
-    /**
-     * 设置日志级别
-     * @param level - 新的日志级别
-     */
-    static setLevel(level: LogLevel): void {
-        this.level = level;
-    }
-
-    /**
-     * 获取当前日志级别
-     * @returns 当前日志级别
-     */
-    static getLevel(): LogLevel {
-        return this.level;
-    }
-
-    /**
-     * 设置日志目录
-     * @param dir - 新的日志目录
-     */
-    static setLogDir(dir: string): void {
-        this.logDir = dir;
-        // 清除文件缓存
-        this.currentFiles.clear();
-    }
-
-    /**
-     * 设置最大文件大小
-     * @param size - 文件大小（字节）
-     */
-    static setMaxFileSize(size: number): void {
-        this.maxFileSize = size;
+        await this.log('debug', message);
     }
 
     /**
@@ -263,22 +188,4 @@ export class Logger {
     static clearCache(): void {
         this.currentFiles.clear();
     }
-
-    /**
-     * 获取日志文件统计信息
-     * @returns 日志文件统计
-     */
-    static getStats(): {
-        level: LogLevel;
-        logDir: string;
-        maxFileSize: number;
-        cachedFiles: number;
-    } {
-        return {
-            level: this.level,
-            logDir: this.logDir,
-            maxFileSize: this.maxFileSize,
-            cachedFiles: this.currentFiles.size
-        };
-    }
 }