befly 2.3.3 → 3.0.1

package/scripts/syncDev.js

@@ -1,96 +0,0 @@
-/**
- * 同步开发管理员账号脚本
- * - 账号: dev
- * - 密码: Crypto2.hmacMd5(Crypto2.md5(Env.DEV_PASSWORD), Env.MD5_SALT)
- * - 行为: 若存在则更新密码与 updated_at；不存在则插入新记录
- */
-
-import { Env } from '../config/env.js';
-import { Logger } from '../utils/logger.js';
-import { createSqlClient } from '../utils/index.js';
-import { Crypto2 } from '../utils/crypto.js';
-
-// 命令行参数（保持与 syncDb.js 一致的 plan 行为）
-const ARGV = Array.isArray(process.argv) ? process.argv : [];
-const CLI = { DRY_RUN: ARGV.includes('--plan') };
-
-// 执行器封装
-const exec = async (client, query, params = []) => {
-    if (params && params.length > 0) return await client.unsafe(query, params);
-    return await client.unsafe(query);
-};
-
-/**
- * 同步开发管理员账号
- * @param {import('bun').SQL | null} client 可选，复用已有 SQL 客户端；不传则内部创建与关闭
- */
-export async function SyncDev(client = null) {
-    let ownClient = false;
-    try {
-        if (CLI.DRY_RUN) {
-            Logger.info('[计划] 同步完成后将初始化/更新 admin.dev 账号（plan 模式不执行）');
-            return true;
-        }
-
-        if (!Env.DEV_PASSWORD || !Env.MD5_SALT) {
-            Logger.warn('跳过开发管理员初始化：缺少 DEV_PASSWORD 或 MD5_SALT 配置');
-            return false;
-        }
-
-        if (!client) {
-            client = await createSqlClient({ max: 1 });
-            ownClient = true;
-        }
-
-        // 检查 admin 表是否存在
-        const [exist] = await exec(client, 'SELECT COUNT(*) AS cnt FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? LIMIT 1', [Env.DB_NAME || '', 'admin']);
-        if (!exist || Number(exist.cnt) === 0) {
-            Logger.warn('跳过开发管理员初始化：未检测到 admin 表');
-            return false;
-        }
-
-        const nowTs = Date.now();
-        const hashed = Crypto2.hmacMd5(Crypto2.md5(Env.DEV_PASSWORD), Env.MD5_SALT);
-
-        // 更新存在的 dev 账号
-        const updateRes = await exec(client, 'UPDATE `admin` SET `password` = ?, `updated_at` = ? WHERE `account` = ? LIMIT 1', [hashed, nowTs, 'dev']);
-        const affected = updateRes?.affectedRows ?? updateRes?.rowsAffected ?? 0;
-
-        if (!affected || affected === 0) {
-            // 插入新账号
-            const id = nowTs;
-            await exec(client, 'INSERT INTO `admin` (`id`, `created_at`, `updated_at`, `deleted_at`, `state`, `account`, `password`) VALUES (?, ?, ?, 0, 0, ?, ?)', [id, nowTs, nowTs, 'dev', hashed]);
-            Logger.info('开发管理员已初始化：account=dev');
-        } else {
-            Logger.info('开发管理员已更新密码并刷新更新时间：account=dev');
-        }
-
-        return true;
-    } catch (e) {
-        Logger.warn(`开发管理员初始化步骤出错：${e.message}`);
-        return false;
-    } finally {
-        if (ownClient && client) {
-            try {
-                await client.close();
-            } catch (e) {
-                Logger.warn('关闭数据库连接时出错:', e.message);
-            }
-        }
-    }
-}
-
-// 允许直接运行该脚本
-if (import.meta.url === `file://${process.argv[1]}`) {
-    SyncDev()
-        .then((ok) => {
-            if (CLI.DRY_RUN) {
-                process.exit(0);
-            }
-            process.exit(ok ? 0 : 1);
-        })
-        .catch((err) => {
-            console.error('❌ 开发管理员同步失败:', err);
-            process.exit(1);
-        });
-}

package/system.js

@@ -1,118 +0,0 @@
-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

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

package/tables/tool.json

@@ -1,6 +0,0 @@
-{
-    "filename": "文件名⚡string⚡1⚡255⚡''⚡1⚡null",
-    "content": "内容⚡string⚡0⚡100⚡''⚡0⚡null",
-    "type": "类型⚡string⚡0⚡50⚡file⚡1⚡^(file|folder|link)$",
-    "path": "路径⚡string⚡1⚡500⚡''⚡0⚡null"
-}

package/utils/api.js

@@ -1,27 +0,0 @@
-import { Logger } from './logger.js';
-import { RYes, RNo } from './index.js';
-export class Api {
-    // GET 方法
-    static GET(name, auth = false, fields = {}, required = [], handler) {
-        return {
-            method: 'GET',
-            name: name,
-            auth: auth,
-            fields: fields,
-            required: required,
-            handler: async (befly, ctx, req) => await handler(befly, ctx, req)
-        };
-    }
-
-    // POST 方法
-    static POST(name, auth = false, fields = {}, required = [], handler) {
-        return {
-            method: 'POST',
-            name: name,
-            auth: auth,
-            fields: fields,
-            required: required,
-            handler: async (befly, ctx, req) => await handler(befly, ctx, req)
-        };
-    }
-}

package/utils/colors.js

@@ -1,83 +0,0 @@
-const p = process || {},
-    argv = p.argv || [],
-    env = p.env || {};
-const isColorSupported = !(!!env.NO_COLOR || argv.includes('--no-color')) && (!!env.FORCE_COLOR || argv.includes('--color') || p.platform === 'win32' || ((p.stdout || {}).isTTY && env.TERM !== 'dumb') || !!env.CI);
-
-const formatter =
-    (open, close, replace = open) =>
-    (input) => {
-        let string = '' + input,
-            index = string.indexOf(close, open.length);
-        return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
-    };
-
-const replaceClose = (string, close, replace, index) => {
-    let result = '',
-        cursor = 0;
-    do {
-        result += string.substring(cursor, index) + replace;
-        cursor = index + close.length;
-        index = string.indexOf(close, cursor);
-    } while (~index);
-    return result + string.substring(cursor);
-};
-
-const createColors = (enabled = isColorSupported) => {
-    let f = enabled ? formatter : () => String;
-    return {
-        isColorSupported: enabled,
-        reset: f('\x1b[0m', '\x1b[0m'),
-        bold: f('\x1b[1m', '\x1b[22m', '\x1b[22m\x1b[1m'),
-        dim: f('\x1b[2m', '\x1b[22m', '\x1b[22m\x1b[2m'),
-        italic: f('\x1b[3m', '\x1b[23m'),
-        underline: f('\x1b[4m', '\x1b[24m'),
-        inverse: f('\x1b[7m', '\x1b[27m'),
-        hidden: f('\x1b[8m', '\x1b[28m'),
-        strikethrough: f('\x1b[9m', '\x1b[29m'),
-
-        black: f('\x1b[30m', '\x1b[39m'),
-        red: f('\x1b[31m', '\x1b[39m'),
-        green: f('\x1b[32m', '\x1b[39m'),
-        yellow: f('\x1b[33m', '\x1b[39m'),
-        blue: f('\x1b[34m', '\x1b[39m'),
-        magenta: f('\x1b[35m', '\x1b[39m'),
-        cyan: f('\x1b[36m', '\x1b[39m'),
-        white: f('\x1b[37m', '\x1b[39m'),
-        gray: f('\x1b[90m', '\x1b[39m'),
-
-        bgBlack: f('\x1b[40m', '\x1b[49m'),
-        bgRed: f('\x1b[41m', '\x1b[49m'),
-        bgGreen: f('\x1b[42m', '\x1b[49m'),
-        bgYellow: f('\x1b[43m', '\x1b[49m'),
-        bgBlue: f('\x1b[44m', '\x1b[49m'),
-        bgMagenta: f('\x1b[45m', '\x1b[49m'),
-        bgCyan: f('\x1b[46m', '\x1b[49m'),
-        bgWhite: f('\x1b[47m', '\x1b[49m'),
-
-        blackBright: f('\x1b[90m', '\x1b[39m'),
-        redBright: f('\x1b[91m', '\x1b[39m'),
-        greenBright: f('\x1b[92m', '\x1b[39m'),
-        yellowBright: f('\x1b[93m', '\x1b[39m'),
-        blueBright: f('\x1b[94m', '\x1b[39m'),
-        magentaBright: f('\x1b[95m', '\x1b[39m'),
-        cyanBright: f('\x1b[96m', '\x1b[39m'),
-        whiteBright: f('\x1b[97m', '\x1b[39m'),
-
-        bgBlackBright: f('\x1b[100m', '\x1b[49m'),
-        bgRedBright: f('\x1b[101m', '\x1b[49m'),
-        bgGreenBright: f('\x1b[102m', '\x1b[49m'),
-        bgYellowBright: f('\x1b[103m', '\x1b[49m'),
-        bgBlueBright: f('\x1b[104m', '\x1b[49m'),
-        bgMagentaBright: f('\x1b[105m', '\x1b[49m'),
-        bgCyanBright: f('\x1b[106m', '\x1b[49m'),
-        bgWhiteBright: f('\x1b[107m', '\x1b[49m')
-    };
-};
-
-const colors = createColors();
-colors.info = colors.blue('i');
-colors.success = colors.green('√');
-colors.warn = colors.yellow('‼');
-colors.error = colors.red('x');
-
-export { colors };

package/utils/crypto.js

@@ -1,260 +0,0 @@
-import { createSign } from 'node:crypto';
-
-export class Crypto2 {
-    /**
-     * MD5 哈希
-     * @param {string|Uint8Array} data - 要哈希的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} MD5 哈希值
-     */
-    static md5(data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('md5');
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * HMAC-MD5 签名
-     * @param {string|Uint8Array} key - 密钥
-     * @param {string|Uint8Array} data - 要签名的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} HMAC-MD5 签名
-     */
-    static hmacMd5(key, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('md5', key);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * SHA-1 哈希
-     * @param {string|Uint8Array} data - 要哈希的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} SHA-1 哈希值
-     */
-    static sha1(data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha1');
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * HMAC-SHA1 签名
-     * @param {string|Uint8Array} key - 密钥
-     * @param {string|Uint8Array} data - 要签名的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} HMAC-SHA1 签名
-     */
-    static hmacSha1(key, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha1', key);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * SHA-256 哈希
-     * @param {string|Uint8Array} data - 要哈希的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} SHA-256 哈希值
-     */
-    static sha256(data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha256');
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    static rsaSha256(data, privateKey, encoding = 'hex') {
-        const sign = createSign('RSA-SHA256');
-        sign.update(data);
-        const signature = sign.sign(privateKey, encoding);
-        return signature;
-    }
-
-    /**
-     * HMAC-SHA256 签名
-     * @param {string|Uint8Array} key - 密钥
-     * @param {string|Uint8Array} data - 要签名的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} HMAC-SHA256 签名
-     */
-    static hmacSha256(key, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha256', key);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * SHA-512 哈希
-     * @param {string|Uint8Array} data - 要哈希的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} SHA-512 哈希值
-     */
-    static sha512(data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha512');
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * HMAC-SHA512 签名
-     * @param {string|Uint8Array} key - 密钥
-     * @param {string|Uint8Array} data - 要签名的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} HMAC-SHA512 签名
-     */
-    static hmacSha512(key, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher('sha512', key);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * 通用哈希方法
-     * @param {string} algorithm - 算法名称 ('md5', 'sha1', 'sha256', 'sha512')
-     * @param {string|Uint8Array} data - 要哈希的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} 哈希值
-     */
-    static hash(algorithm, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher(algorithm);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * 通用 HMAC 方法
-     * @param {string} algorithm - 算法名称 ('md5', 'sha1', 'sha256', 'sha512')
-     * @param {string|Uint8Array} key - 密钥
-     * @param {string|Uint8Array} data - 要签名的数据
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {string} HMAC 签名
-     */
-    static hmac(algorithm, key, data, encoding = 'hex') {
-        const hasher = new Bun.CryptoHasher(algorithm, key);
-        hasher.update(data);
-        return hasher.digest(encoding);
-    }
-
-    /**
-     * 文件哈希
-     * @param {string} filePath - 文件路径
-     * @param {string} algorithm - 算法名称 (默认 'sha256')
-     * @param {string} encoding - 输出编码 ('hex', 'base64')
-     * @returns {Promise<string>} 文件哈希值
-     */
-    static async hashFile(filePath, algorithm = 'sha256', encoding = 'hex') {
-        const file = Bun.file(filePath);
-        const hasher = new Bun.CryptoHasher(algorithm);
-
-        const stream = file.stream();
-        const reader = stream.getReader();
-
-        try {
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done) break;
-                hasher.update(value);
-            }
-            return hasher.digest(encoding);
-        } finally {
-            reader.releaseLock();
-        }
-    }
-
-    /**
-     * 创建流式哈希器
-     * @param {string} algorithm - 算法名称
-     * @param {string|Uint8Array} key - 可选的 HMAC 密钥
-     * @returns {StreamHasher} 流式哈希器实例
-     */
-    static createHasher(algorithm, key = null) {
-        return new StreamHasher(algorithm, key);
-    }
-
-    /**
-     * 密码哈希 (使用 Argon2)
-     * @param {string} password - 密码
-     * @param {object} options - 选项
-     * @returns {Promise<string>} 哈希后的密码
-     */
-    static async hashPassword(password, options = {}) {
-        return await Bun.password.hash(password, options);
-    }
-
-    /**
-     * 验证密码
-     * @param {string} password - 原始密码
-     * @param {string} hash - 哈希值
-     * @returns {Promise<boolean>} 验证结果
-     */
-    static async verifyPassword(password, hash) {
-        return await Bun.password.verify(password, hash);
-    }
-
-    /**
-     * 快速哈希 (非密码学)
-     * @param {string|Uint8Array} data - 数据
-     * @param {number} seed - 种子值
-     * @returns {number} 64位哈希值
-     */
-    static fastHash(data, seed = 0) {
-        return Bun.hash(data, seed);
-    }
-}
-
-/**
- * 流式哈希器类
- */
-class StreamHasher {
-    constructor(algorithm, key = null) {
-        this.hasher = new Bun.CryptoHasher(algorithm, key);
-        this.finalized = false;
-    }
-
-    /**
-     * 更新数据
-     * @param {string|Uint8Array} data - 数据
-     * @returns {StreamHasher} 支持链式调用
-     */
-    update(data) {
-        if (this.finalized) {
-            throw new Error('哈希器已经完成，不能再更新数据');
-        }
-        this.hasher.update(data);
-        return this;
-    }
-
-    /**
-     * 生成最终哈希值
-     * @param {string} encoding - 输出编码
-     * @returns {string} 哈希值
-     */
-    digest(encoding = 'hex') {
-        if (this.finalized) {
-            throw new Error('哈希器已经完成');
-        }
-        this.finalized = true;
-        return this.hasher.digest(encoding);
-    }
-
-    /**
-     * 复制哈希器
-     * @returns {StreamHasher} 新的哈希器实例
-     */
-    copy() {
-        if (this.finalized) {
-            throw new Error('不能复制已完成的哈希器');
-        }
-        const newHasher = new StreamHasher();
-        newHasher.hasher = this.hasher.copy();
-        return newHasher;
-    }
-}
-
-// 使用示例：
-// const md5Hash = Crypto.md5('hello world');
-// const hmacMd5 = Crypto.hmacMd5('secret-key', 'hello world');
-// const sha256Hash = Crypto.sha256('hello world');
-// const fileHash = await Crypto.hashFile('./file.txt', 'md5');
-// const hasher = Crypto.createHasher('md5').update('hello').update(' world');
-// const result = hasher.digest('hex');