befly 2.0.12 → 2.0.14

package/scripts/release.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync } from 'fs';
+import { execSync } from 'child_process';
+import { join } from 'path';
+import { __filename, __dirname } from '../system.js';
+
+// 获取 package.json 路径
+const packagePath = join(__dirname, 'package.json');
+
+/**
+ * 解析命令行参数
+ */
+function parseArguments() {
+    const args = process.argv.slice(2);
+
+    if (args.includes('-h') || args.includes('--help')) {
+        console.log(`
+发布脚本使用说明:
+  bun run scripts/release.js -a    发布大版本 (major)
+  bun run scripts/release.js -b    发布次要版本 (minor)
+  bun run scripts/release.js -c    发布补丁版本 (patch)
+  bun run scripts/release.js -h    显示帮助信息
+
+或者使用快捷命令:
+  bun run ra                       发布大版本
+  bun run rb                       发布次要版本
+  bun run rc                       发布补丁版本
+        `);
+        process.exit(0);
+    }
+
+    if (args.includes('-a')) return 'major';
+    if (args.includes('-b')) return 'minor';
+    if (args.includes('-c')) return 'patch';
+
+    console.error('错误: 请指定版本类型参数');
+    console.log('使用 -h 或 --help 查看帮助信息');
+    process.exit(1);
+}
+
+/**
+ * 读取 package.json
+ */
+function readPackageJson() {
+    try {
+        const content = readFileSync(packagePath, 'utf8');
+        return JSON.parse(content);
+    } catch (error) {
+        console.error('错误: 无法读取 package.json:', error.message);
+        process.exit(1);
+    }
+}
+
+/**
+ * 写入 package.json
+ */
+function writePackageJson(packageData) {
+    try {
+        const content = JSON.stringify(packageData, null, 4);
+        writeFileSync(packagePath, content, 'utf8');
+        console.log('✓ package.json 已更新');
+    } catch (error) {
+        console.error('错误: 无法写入 package.json:', error.message);
+        process.exit(1);
+    }
+}
+
+/**
+ * 更新版本号
+ */
+function updateVersion(currentVersion, type) {
+    const versionParts = currentVersion.split('.').map(Number);
+
+    if (versionParts.length !== 3) {
+        console.error('错误: 版本号格式不正确，应为 x.y.z 格式');
+        process.exit(1);
+    }
+
+    let [major, minor, patch] = versionParts;
+
+    switch (type) {
+        case 'major':
+            major += 1;
+            minor = 0;
+            patch = 0;
+            break;
+        case 'minor':
+            minor += 1;
+            patch = 0;
+            break;
+        case 'patch':
+            patch += 1;
+            break;
+        default:
+            console.error('错误: 未知的版本类型');
+            process.exit(1);
+    }
+
+    return `${major}.${minor}.${patch}`;
+}
+
+/**
+ * 执行 Git 命令（必须成功）
+ */
+function executeGitCommand(command, description) {
+    try {
+        console.log(`正在执行: ${description}`);
+        console.log(`命令: ${command}`);
+
+        const result = execSync(command, {
+            encoding: 'utf8',
+            stdio: 'inherit',
+            cwd: __dirname
+        });
+
+        console.log(`✓ ${description} 完成`);
+        return result;
+    } catch (error) {
+        console.error(`错误: ${description} 失败:`, error.message);
+        console.error('Git 操作失败，发布已取消！');
+        process.exit(1);
+    }
+}
+
+/**
+ * 执行命令（必须成功）
+ */
+function executeCommand(command, description) {
+    try {
+        console.log(`正在执行: ${description}`);
+        console.log(`命令: ${command}`);
+
+        const result = execSync(command, {
+            encoding: 'utf8',
+            stdio: 'inherit',
+            cwd: __dirname
+        });
+
+        console.log(`✓ ${description} 完成`);
+        return result;
+    } catch (error) {
+        console.error(`错误: ${description} 失败:`, error.message);
+        process.exit(1);
+    }
+}
+
+/**
+ * 检查 Git 状态
+ */
+function checkGitStatus() {
+    try {
+        const status = execSync('git status --porcelain', {
+            encoding: 'utf8',
+            cwd: __dirname
+        });
+
+        if (status.trim()) {
+            console.error('错误: 工作目录有未提交的更改');
+            console.log('未提交的文件:');
+            console.log(status);
+            console.log('\n请先提交所有更改后再发布！');
+            return false;
+        }
+        return true;
+    } catch (error) {
+        console.error('错误: 无法检查 Git 状态:', error.message);
+        console.error('请确保当前目录是一个有效的 Git 仓库！');
+        return false;
+    }
+}
+
+/**
+ * 检查必要文件是否存在
+ */
+function checkRequiredFiles() {
+    const requiredFiles = ['main.js', 'system.js', 'package.json', 'README.md', 'LICENSE'];
+
+    const missingFiles = [];
+
+    for (const file of requiredFiles) {
+        try {
+            const filePath = join(__dirname, file);
+            readFileSync(filePath);
+        } catch (error) {
+            missingFiles.push(file);
+        }
+    }
+
+    if (missingFiles.length > 0) {
+        console.error('错误: 以下必要文件缺失:');
+        missingFiles.forEach((file) => console.error(`  - ${file}`));
+        return false;
+    }
+
+    console.log('✓ 所有必要文件检查通过');
+    return true;
+}
+
+/**
+ * 主函数
+ */
+function main() {
+    // 解析参数（如果是帮助命令会直接退出）
+    const versionType = parseArguments();
+
+    console.log('🚀 开始发布流程...\n');
+    console.log(`版本类型: ${versionType}`);
+
+    // 检查必要文件
+    console.log('\n--- 检查必要文件 ---');
+    if (!checkRequiredFiles()) {
+        console.log('\n发布已取消');
+        process.exit(1);
+    }
+
+    // 检查 Git 状态
+    console.log('\n--- 检查 Git 状态 ---');
+    if (!checkGitStatus()) {
+        console.log('\n发布已取消');
+        process.exit(1);
+    }
+
+    // 读取当前版本
+    const packageData = readPackageJson();
+    const currentVersion = packageData.version;
+    console.log(`当前版本: ${currentVersion}`);
+
+    // 计算新版本
+    const newVersion = updateVersion(currentVersion, versionType);
+    console.log(`新版本: ${newVersion}\n`);
+
+    // 更新版本号
+    packageData.version = newVersion;
+    writePackageJson(packageData);
+
+    // 提交版本更新
+    console.log('\n--- Git 操作 ---');
+    executeGitCommand('git add package.json', '添加 package.json 到 Git');
+    executeGitCommand(`git commit -m "chore: bump version to ${newVersion}"`, '提交版本更新');
+    executeGitCommand(`git tag v${newVersion}`, '创建版本标签');
+
+    // 发布到 npm
+    console.log('\n--- NPM 发布 ---');
+    executeCommand('bun publish --registry=https://registry.npmjs.org --access=public', '发布到 npm');
+
+    // 推送到远程仓库
+    console.log('\n--- 推送到远程仓库 ---');
+    executeGitCommand('git push', '推送代码到远程仓库');
+    executeGitCommand('git push --tags', '推送标签到远程仓库');
+
+    console.log(`\n🎉 版本 ${newVersion} 发布成功！`);
+    console.log(`📦 包名: ${packageData.name}`);
+    console.log(`🔗 npm: https://www.npmjs.com/package/${packageData.name}`);
+}
+
+// 启动主函数
+main();

package/system.js

@@ -0,0 +1,118 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, join, resolve, relative } from 'node:path';
+
+/**
+ * Befly 框架系统路径定义
+ * 提供统一的路径变量，供整个框架使用
+ */
+
+// 当前文件的路径信息
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Befly 框架根目录
+const __dirroot = __dirname;
+
+// 各个重要目录的路径
+const __dirscript = join(__dirroot, 'scripts');
+const __dirbin = join(__dirroot, 'bin');
+const __dirutils = join(__dirroot, 'utils');
+const __dirconfig = join(__dirroot, 'config');
+const __dirtables = join(__dirroot, 'tables');
+const __dirchecks = join(__dirroot, 'checks');
+const __dirapis = join(__dirroot, 'apis');
+const __dirplugins = join(__dirroot, 'plugins');
+const __dirlibs = join(__dirroot, 'libs');
+const __dirtests = join(__dirroot, 'tests');
+
+// 获取项目根目录（befly 框架的使用方项目）
+const getProjectRoot = () => {
+    return process.cwd();
+};
+
+// 获取项目中的特定目录
+const getProjectDir = (subdir = '') => {
+    return subdir ? join(getProjectRoot(), subdir) : getProjectRoot();
+};
+
+// 创建路径解析器，基于 befly 根目录
+const resolveBeflyPath = (...paths) => {
+    return resolve(__dirroot, ...paths);
+};
+
+// 创建路径解析器，基于项目根目录
+const resolveProjectPath = (...paths) => {
+    return resolve(getProjectRoot(), ...paths);
+};
+
+// 获取相对于 befly 根目录的相对路径
+const getRelativeBeflyPath = (targetPath) => {
+    return relative(__dirroot, targetPath);
+};
+
+// 获取相对于项目根目录的相对路径
+const getRelativeProjectPath = (targetPath) => {
+    return relative(getProjectRoot(), targetPath);
+};
+
+// 导出所有路径变量和工具函数
+export {
+    // 基础路径变量
+    __filename,
+    __dirname,
+    __dirroot,
+
+    // Befly 框架目录
+    __dirscript,
+    __dirbin,
+    __dirutils,
+    __dirconfig,
+    __dirtables,
+    __dirchecks,
+    __dirapis,
+    __dirplugins,
+    __dirlibs,
+    __dirtests,
+
+    // 项目路径工具函数
+    getProjectRoot,
+    getProjectDir,
+
+    // 路径解析工具函数
+    resolveBeflyPath,
+    resolveProjectPath,
+    getRelativeBeflyPath,
+    getRelativeProjectPath
+};
+
+// 默认导出包含所有路径信息的对象
+export default {
+    // 基础路径变量
+    __filename,
+    __dirname,
+    __dirroot,
+
+    // Befly 框架目录
+    paths: {
+        script: __dirscript,
+        bin: __dirbin,
+        utils: __dirutils,
+        config: __dirconfig,
+        tables: __dirtables,
+        checks: __dirchecks,
+        apis: __dirapis,
+        plugins: __dirplugins,
+        libs: __dirlibs,
+        tests: __dirtests
+    },
+
+    // 工具函数
+    utils: {
+        getProjectRoot,
+        getProjectDir,
+        resolveBeflyPath,
+        resolveProjectPath,
+        getRelativeBeflyPath,
+        getRelativeProjectPath
+    }
+};

package/tables/common.json

@@ -0,0 +1,16 @@
+{
+    "email": "邮箱|string|5|100|null|1|^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
+    "phone": "手机号|string|11|11|null|1|^1[3-9]\\d{9}$",
+    "page": "页码|number|1|9999|1|0|null",
+    "limit": "每页数量|number|1|100|10|0|null",
+    "title": "标题|string|1|200|null|0|null",
+    "description": "描述|string|0|500|null|0|null",
+    "keyword": "关键词|string|1|50|null|1|null",
+    "status": "状态|string|1|20|active|1|null",
+    "enabled": "启用状态|number|0|1|1|0|null",
+    "date": "日期|string|10|10|null|0|^\\d{4}-\\d{2}-\\d{2}$",
+    "datetime": "日期时间|string|19|25|null|0|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}",
+    "filename": "文件名|string|1|255|null|0|null",
+    "url": "网址|string|5|500|null|0|^https?://",
+    "tag": "标签|array|0|10|[]|0|null"
+}

package/tables/tool.json

@@ -0,0 +1,6 @@
+{
+    "filename": "文件名|string|1|255|null|1|null",
+    "content": "内容|string|0|1000000|null|0|null",
+    "type": "类型|string|0|50|file|1|null",
+    "path": "路径|string|1|500|null|0|null"
+}

package/utils/util.js

@@ -191,3 +191,28 @@ export const filterLogFields = (body, excludeFields = '') => {
     }
     return filtered;
 };
+
+// 专门用于处理管道符分隔的字段规则
+export const parseFieldRule = (rule) => {
+    const allParts = rule.split('|');
+
+    // 现在支持7个部分：显示名|类型|最小值|最大值|默认值|是否索引|正则约束
+    if (allParts.length <= 7) {
+        // 如果少于7个部分，补齐缺失的部分为 null
+        while (allParts.length < 7) {
+            allParts.push('null');
+        }
+        return allParts;
+    }
+
+    // 如果超过7个部分，保留前6个，剩余的合并为最后的正则约束部分
+    return [
+        allParts[0], // 显示名
+        allParts[1], // 类型
+        allParts[2], // 最小值
+        allParts[3], // 最大值
+        allParts[4], // 默认值
+        allParts[5], // 是否索引
+        allParts.slice(6).join('|') // 正则约束（可能包含管道符）
+    ];
+};

package/utils/validate.js

@@ -1,4 +1,29 @@
-import { ruleSplit, isType } from './util.js';
+import { isType } from './util.js';
+
+// 专门用于处理管道符分隔的字段规则
+const parseFieldRule = (rule) => {
+    const allParts = rule.split('|');
+
+    // 现在支持7个部分：显示名|类型|最小值|最大值|默认值|是否索引|正则约束
+    if (allParts.length <= 7) {
+        // 如果少于7个部分，补齐缺失的部分为 null
+        while (allParts.length < 7) {
+            allParts.push('null');
+        }
+        return allParts;
+    }
+
+    // 如果超过7个部分，保留前6个，剩余的合并为最后的正则约束部分
+    return [
+        allParts[0], // 显示名
+        allParts[1], // 类型
+        allParts[2], // 最小值
+        allParts[3], // 最大值
+        allParts[4], // 默认值
+        allParts[5], // 是否索引
+        allParts.slice(6).join('|') // 正则约束（可能包含管道符）
+    ];
+};
 
 /**
  * 验证器类
@@ -63,7 +88,7 @@ export class Validator {
         for (const fieldName of required) {
             if (!(fieldName in data) || data[fieldName] === undefined || data[fieldName] === null || data[fieldName] === '') {
                 result.code = 1;
-                const ruleParts = rules[fieldName]?.split(',') || [];
+                const ruleParts = parseFieldRule(rules[fieldName] || '');
                 const fieldLabel = ruleParts[0] || fieldName;
                 result.fields[fieldName] = `${fieldLabel}(${fieldName})为必填项`;
             }
@@ -99,16 +124,18 @@ export class Validator {
      * 验证单个字段的值
      */
     validateFieldValue(value, rule, fieldName) {
-        const [name, type, minStr, maxStr, specStr] = ruleSplit(rule);
+        const [name, type, minStr, maxStr, defaultValue, isIndexStr, regexConstraint] = parseFieldRule(rule);
         const min = minStr === 'null' ? null : parseInt(minStr) || 0;
         const max = maxStr === 'null' ? null : parseInt(maxStr) || 0;
-        const spec = specStr === 'null' ? null : specStr.trim();
+        const spec = regexConstraint === 'null' ? null : regexConstraint.trim();
 
         switch (type.toLowerCase()) {
             case 'number':
                 return this.validateNumber(value, name, min, max, spec, fieldName);
             case 'string':
                 return this.validateString(value, name, min, max, spec, fieldName);
+            case 'text':
+                return this.validateString(value, name, min, max, spec, fieldName);
             case 'array':
                 return this.validateArray(value, name, min, max, spec, fieldName);
             default:
@@ -129,7 +156,7 @@ export class Validator {
                 return `${name}(${fieldName})不能小于${min}`;
             }
 
-            if (min !== null && max > 0 && value > max) {
+            if (max !== null && max > 0 && value > max) {
                 return `${name}(${fieldName})不能大于${max}`;
             }
 

package/schema/common.json

@@ -1,17 +0,0 @@
-{
-    "id": "ID,number,1,999999999,x%2=0",
-    "email": "邮箱,string,5,100,^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
-    "phone": "手机号,string,11,11,^1[3-9]\\d{9}$",
-    "page": "页码,number,1,9999,null",
-    "limit": "每页数量,number,1,100,null",
-    "title": "标题,string,1,200,null",
-    "description": "描述,string,0,500,null",
-    "keyword": "关键词,string,1,50,null",
-    "status": "状态,string,1,20,null",
-    "enabled": "启用状态,number,0,1,null",
-    "date": "日期,string,10,10,^\\d{4}-\\d{2}-\\d{2}$",
-    "datetime": "日期时间,string,19,25,^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}",
-    "filename": "文件名,string,1,255,null",
-    "url": "网址,string,5,500,^https?://",
-    "tag": "标签,array,0,10,null"
-}

package/schema/debug.json

@@ -1 +0,0 @@
-{}

package/schema/health.json

@@ -1 +0,0 @@
-{}

package/schema/tool.json

@@ -1,6 +0,0 @@
-{
-    "filename": "文件名,string,1,255,null",
-    "content": "内容,string,0,1000000,null",
-    "type": "类型,string,0,50,null",
-    "path": "路径,string,1,500,null"
-}