befly 2.3.0 → 2.3.2

package/checks/table.js

@@ -56,9 +56,19 @@ export const checkTable = async () => {
         for (const { file, type } of allTableFiles) {
             totalFiles++;
             const fileName = path.basename(file);
+            const fileBaseName = path.basename(file, '.json');
             const fileType = type === 'core' ? '内核' : '项目';
 
             try {
+                // 1) 文件名小驼峰校验：必须以小写字母开头，后续可包含小写/数字，或多个 [大写+小写/数字] 片段
+                //    示例：userTable、testCustomers、common
+                const lowerCamelCaseRegex = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
+                if (!lowerCamelCaseRegex.test(fileBaseName)) {
+                    Logger.error(`${fileType}表 ${fileName} 文件名必须使用小驼峰命名（例如 testCustomers.json）`);
+                    // 命名不合规，直接标记为无效文件
+                    throw new Error('文件命名不符合小驼峰规范');
+                }
+
                 // 读取并解析 JSON 文件
                 const table = await Bun.file(file).json();
                 let fileValid = true;

package/main.js

@@ -43,11 +43,20 @@ class Befly {
                     const singleCheckStart = Bun.nanoseconds();
 
                     // 导入检查模块
-                    const check = await import(file);
+                    const checkModule = await import(file);
+
+                    // 仅允许具名导出（以 check 开头）的检查函数
+                    let checkFn = null;
+                    for (const [exportName, exportValue] of Object.entries(checkModule)) {
+                        if (typeof exportValue === 'function' && /^check/i.test(exportName)) {
+                            checkFn = exportValue;
+                            break;
+                        }
+                    }
 
-                    // 执行默认导出的函数
-                    if (typeof check.default === 'function') {
-                        const checkResult = await check.default(this.appContext);
+                    // 执行检查函数
+                    if (typeof checkFn === 'function') {
+                        const checkResult = await checkFn(this.appContext);
                         const singleCheckTime = calcPerfTime(singleCheckStart);
 
                         if (checkResult === true) {
@@ -59,7 +68,7 @@ class Befly {
                         }
                     } else {
                         const singleCheckTime = calcPerfTime(singleCheckStart);
-                        Logger.warn(`文件 ${fileName} 未导出默认函数，耗时: ${singleCheckTime}`);
+                        Logger.warn(`文件 ${fileName} 未找到可执行的检查函数（必须具名导出以 check 开头的函数），耗时: ${singleCheckTime}`);
                         failedChecks++;
                     }
                 } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "2.3.0",
+    "version": "2.3.2",
     "description": "Buma - 为 Bun 专属打造的 API 接口框架核心引擎",
     "type": "module",
     "private": false,

package/scripts/syncDb.js

@@ -5,7 +5,7 @@
 import path from 'node:path';
 import { Env } from '../config/env.js';
 import { Logger } from '../utils/logger.js';
-import { parseFieldRule, createSqlClient } from '../utils/index.js';
+import { parseFieldRule, createSqlClient, toSnakeTableName } from '../utils/index.js';
 import { __dirtables, getProjectDir } from '../system.js';
 import { checkTable } from '../checks/table.js';
 
@@ -16,6 +16,8 @@ const typeMapping = {
     array: 'VARCHAR'
 };
 
+// 表名转换函数已移动至 utils/index.js 的 toSnakeTableName
+
 // 环境开关读取（支持未在 Env 显式声明的变量，默认值兜底）
 const getFlag = (val, def = 0) => {
     if (val === undefined || val === null || val === '') return !!def;
@@ -466,7 +468,8 @@ const SyncDb = async () => {
         for (const dir of directories) {
             try {
                 for await (const file of tablesGlob.scan({ cwd: dir, absolute: true, onlyFiles: true })) {
-                    const tableName = path.basename(file, '.json');
+                    const fileBaseName = path.basename(file, '.json');
+                    const tableName = toSnakeTableName(fileBaseName);
                     const tableDefinition = await Bun.file(file).json();
                     const result = await exec(client, 'SELECT COUNT(*) as count FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?', [Env.MYSQL_DB || 'test', tableName]);
                     const exists = result[0].count > 0;

package/utils/index.js

@@ -93,6 +93,9 @@ export const isType = (value, type) => {
 
     // 语义类型单独处理，其余走 actualType === expectedType
     switch (expectedType) {
+        case 'function':
+            // 统一将普通函数、异步函数、生成器函数等都识别为函数
+            return typeof value === 'function';
         case 'nan':
             return typeof value === 'number' && Number.isNaN(value);
         case 'empty':
@@ -294,6 +297,16 @@ export const validateRegex = (value) => {
     }
 };
 
+// 将 lowerCamelCase 或单词形式转换为下划线风格（snake_case）
+// 例如：userTable -> user_table, testNewFormat -> test_new_format, users -> users, orderV2 -> order_v2
+export const toSnakeTableName = (name) => {
+    if (!name) return name;
+    return String(name)
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/([A-Z]+)([A-Z][a-z0-9]+)/g, '$1_$2')
+        .toLowerCase();
+};
+
 // 专门用于处理⚡分隔的字段规则
 export const parseFieldRule = (rule) => {
     const allParts = rule.split('⚡');