befly 2.3.3 → 3.0.0

package/utils/{xml.js → xml.ts}

@@ -1,39 +1,66 @@
 /**
- * XML 解析器
+ * XML 解析器 - TypeScript 版本
  * 将 XML 字符串解析为 JSON 对象
  */
-class Xml {
+
+/**
+ * XML 解析选项
+ */
+interface XmlParseOptions {
+    /** 是否忽略属性 */
+    ignoreAttributes?: boolean;
+    /** 属性前缀 */
+    attributePrefix?: string;
+    /** 文本内容的键名 */
+    textKey?: string;
+    /** 是否去除首尾空格 */
+    trimValues?: boolean;
+    /** 是否解析布尔值 */
+    parseBooleans?: boolean;
+    /** 是否解析数字 */
+    parseNumbers?: boolean;
+    /** 是否使用自定义解析器 */
+    customParser?: boolean;
+}
+
+/**
+ * 解析结果接口（内部使用）
+ */
+interface ParseResult {
+    value: Record<string, any>;
+    end: number;
+}
+
+/**
+ * XML 解析器类
+ */
+export class Xml {
+    private options: Required<XmlParseOptions>;
+
     /**
      * 构造函数
-     * @param {Object} options - 解析选项
+     * @param options - 解析选项
      */
-    constructor(options = {}) {
+    constructor(options: XmlParseOptions = {}) {
         // 默认配置
         this.options = {
-            // 基本配置
-            ignoreAttributes: false, // 是否忽略属性
-            attributePrefix: '@', // 属性前缀
-            textKey: '#text', // 文本内容的键名
-
-            // 格式化配置
-            trimValues: true, // 是否去除首尾空格
-            parseBooleans: true, // 是否解析布尔值
-            parseNumbers: true, // 是否解析数字
-
-            // 高级配置
-            customParser: true, // 是否使用自定义解析器
-
-            // 合并用户选项
+            ignoreAttributes: false,
+            attributePrefix: '@',
+            textKey: '#text',
+            trimValues: true,
+            parseBooleans: true,
+            parseNumbers: true,
+            customParser: true,
             ...options
         };
     }
 
     /**
      * 解析 XML 字符串为 JSON 对象
-     * @param {string} xmlData - XML 字符串
-     * @returns {Object} 解析后的 JSON 对象
+     * @param xmlData - XML 字符串
+     * @returns 解析后的 JSON 对象
      */
-    parse(xmlData) {
+    parse(xmlData: string): Record<string, any> {
         if (typeof xmlData !== 'string') {
             throw new Error('无效的 XML 数据');
         }
@@ -54,20 +81,22 @@ class Xml {
 
         // 自定义解析
         if (this.options.customParser) {
-            return this.#customParse(xmlData);
+            return this.customParse(xmlData);
         }
+
+        return {};
     }
 
     /**
      * 解析属性字符串
-     * @param {string} attributesStr - 属性字符串
-     * @param {Object} element - 元素对象
+     * @param attributesStr - 属性字符串
+     * @param element - 元素对象
      */
-    #parseAttributes(attributesStr, element) {
+    private parseAttributes(attributesStr: string, element: Record<string, any>): void {
         // 移除标签名，只保留属性部分
         const attrPart = attributesStr.replace(/^\w+\s*/, '');
         const attrRegex = /(\w+)=["']([^"']*)["']/g;
-        let match;
+        let match: RegExpExecArray | null;
 
         while ((match = attrRegex.exec(attrPart)) !== null) {
             const attrName = this.options.attributePrefix + match[1];
@@ -78,18 +107,18 @@ class Xml {
                 element[attrName] = attrValue;
             } else {
                 // 其他属性进行类型解析
-                element[attrName] = this.#parseValue(attrValue);
+                element[attrName] = this.parseValue(attrValue);
             }
         }
     }
 
     /**
      * 自定义解析方法
-     * @param {string} xmlData - XML 数据
-     * @returns {Object} 解析结果
+     * @param xmlData - XML 数据
+     * @returns 解析结果
      */
-    #customParse(xmlData) {
-        const result = this.#parseXmlElement(xmlData, 0).value;
+    private customParse(xmlData: string): Record<string, any> {
+        const result = this.parseXmlElement(xmlData, 0).value;
 
         // 如果结果只有一个根元素，返回该元素的内容
         const keys = Object.keys(result);
@@ -101,11 +130,11 @@ class Xml {
 
     /**
      * 解析 XML 元素
-     * @param {string} xml - XML 字符串
-     * @param {number} start - 开始位置
-     * @returns {Object} 包含解析结果和结束位置的对象
+     * @param xml - XML 字符串
+     * @param start - 开始位置
+     * @returns 包含解析结果和结束位置的对象
      */
-    #parseXmlElement(xml, start) {
+    private parseXmlElement(xml: string, start: number): ParseResult {
         const tagStart = xml.indexOf('<', start);
         if (tagStart === -1) {
             return { value: {}, end: xml.length };
@@ -117,13 +146,13 @@ class Xml {
         }
 
         const fullTag = xml.slice(tagStart + 1, tagEnd);
-        const element = {};
+        const element: Record<string, any> = {};
 
         // 自闭合标签
         if (fullTag.endsWith('/')) {
             const tagName = fullTag.slice(0, -1).split(/\s+/)[0];
             if (!this.options.ignoreAttributes && fullTag.includes(' ')) {
-                this.#parseAttributes(fullTag.slice(0, -1), element);
+                this.parseAttributes(fullTag.slice(0, -1), element);
             }
             return { value: { [tagName]: Object.keys(element).length > 0 ? element : '' }, end: tagEnd + 1 };
         }
@@ -134,7 +163,7 @@ class Xml {
             if (commentEnd === -1) {
                 throw new Error('格式错误：未找到注释结束符');
             }
-            return this.#parseXmlElement(xml, commentEnd + 3);
+            return this.parseXmlElement(xml, commentEnd + 3);
         }
 
         // CDATA
@@ -143,15 +172,14 @@ class Xml {
             if (cdataEnd === -1) {
                 throw new Error('格式错误：未找到 CDATA 结束符');
             }
-            const cdataContent = xml.slice(tagEnd + 1, cdataEnd);
-            return this.#parseXmlElement(xml, cdataEnd + 3);
+            return this.parseXmlElement(xml, cdataEnd + 3);
         }
 
         const tagName = fullTag.split(/\s+/)[0];
 
         // 解析属性
         if (!this.options.ignoreAttributes && fullTag.includes(' ')) {
-            this.#parseAttributes(fullTag, element);
+            this.parseAttributes(fullTag, element);
         }
 
         // 查找结束标签
@@ -171,7 +199,7 @@ class Xml {
 
         // 如果没有子标签，直接解析文本
         if (!content.includes('<')) {
-            const textValue = this.#parseValue(content);
+            const textValue = this.parseValue(content);
             if (Object.keys(element).length === 0) {
                 return { value: { [tagName]: textValue }, end: endTagStart + endTag.length };
             } else {
@@ -181,7 +209,7 @@ class Xml {
         } else {
             // 解析子元素和混合内容
             let pos = 0;
-            const texts = [];
+            const texts: string[] = [];
 
             while (pos < content.length) {
                 const nextTag = content.indexOf('<', pos);
@@ -200,12 +228,12 @@ class Xml {
                 }
 
                 // 解析子元素
-                const childResult = this.#parseXmlElement(content, nextTag);
+                const childResult = this.parseXmlElement(content, nextTag);
                 const childObj = childResult.value;
 
                 // 合并子元素到当前元素
                 for (const [key, value] of Object.entries(childObj)) {
-                    this.#addElement(element, key, value);
+                    this.addElement(element, key, value);
                 }
 
                 pos = childResult.end;
@@ -215,9 +243,9 @@ class Xml {
             if (texts.length > 0) {
                 const combinedText = texts.join(' ');
                 if (Object.keys(element).length === 0) {
-                    return { value: { [tagName]: this.#parseValue(combinedText) }, end: endTagStart + endTag.length };
+                    return { value: { [tagName]: this.parseValue(combinedText) }, end: endTagStart + endTag.length };
                 } else {
-                    element[this.options.textKey] = this.#parseValue(combinedText);
+                    element[this.options.textKey] = this.parseValue(combinedText);
                 }
             }
 
@@ -227,11 +255,11 @@ class Xml {
 
     /**
      * 添加元素到对象
-     * @param {Object} parent - 父对象
-     * @param {string} name - 元素名
-     * @param {any} value - 元素值
+     * @param parent - 父对象
+     * @param name - 元素名
+     * @param value - 元素值
      */
-    #addElement(parent, name, value) {
+    private addElement(parent: Record<string, any>, name: string, value: any): void {
         if (parent[name] === undefined) {
             parent[name] = value;
         } else if (Array.isArray(parent[name])) {
@@ -243,10 +271,10 @@ class Xml {
 
     /**
      * 解析值的类型
-     * @param {string} value - 原始值
-     * @returns {any} 解析后的值
+     * @param value - 原始值
+     * @returns 解析后的值
      */
-    #parseValue(value) {
+    private parseValue(value: string): string | number | boolean {
         if (!value || typeof value !== 'string') {
             return value;
         }
@@ -288,16 +316,16 @@ class Xml {
         }
 
         // 处理 XML 实体
-        return this.#decodeEntities(value);
+        return this.decodeEntities(value);
     }
 
     /**
      * 解码 XML 实体
-     * @param {string} value - 包含实体的字符串
-     * @returns {string} 解码后的字符串
+     * @param value - 包含实体的字符串
+     * @returns 解码后的字符串
      */
-    #decodeEntities(value) {
-        const entities = {
+    private decodeEntities(value: string): string {
+        const entities: Record<string, string> = {
             '&amp;': '&',
             '&lt;': '<',
             '&gt;': '>',
@@ -312,39 +340,39 @@ class Xml {
 
     /**
      * 静态方法：快速解析 XML
-     * @param {string} xmlData - XML 数据
-     * @param {Object} options - 解析选项
-     * @returns {Object} 解析后的 JSON 对象
+     * @param xmlData - XML 数据
+     * @param options - 解析选项
+     * @returns 解析后的 JSON 对象
      */
-    static parse(xmlData, options = {}) {
+    static parse(xmlData: string, options: XmlParseOptions = {}): Record<string, any> {
         const parser = new Xml(options);
         return parser.parse(xmlData);
     }
 
     /**
      * 静态方法：解析 XML 并保留属性
-     * @param {string} xmlData - XML 数据
-     * @returns {Object} 解析后的 JSON 对象
+     * @param xmlData - XML 数据
+     * @returns 解析后的 JSON 对象
      */
-    static parseWithAttributes(xmlData) {
+    static parseWithAttributes(xmlData: string): Record<string, any> {
         return Xml.parse(xmlData, { ignoreAttributes: false });
     }
 
     /**
      * 静态方法：解析 XML 并忽略属性
-     * @param {string} xmlData - XML 数据
-     * @returns {Object} 解析后的 JSON 对象
+     * @param xmlData - XML 数据
+     * @returns 解析后的 JSON 对象
      */
-    static parseIgnoreAttributes(xmlData) {
+    static parseIgnoreAttributes(xmlData: string): Record<string, any> {
         return Xml.parse(xmlData, { ignoreAttributes: true });
     }
 
     /**
      * 静态方法：验证 XML 格式
-     * @param {string} xmlData - XML 数据
-     * @returns {boolean} 是否有效
+     * @param xmlData - XML 数据
+     * @returns 是否有效
      */
-    static validate(xmlData) {
+    static validate(xmlData: string): boolean {
         try {
             Xml.parse(xmlData);
             return true;
@@ -353,5 +381,3 @@ class Xml {
         }
     }
 }
-
-export { Xml };

package/.npmrc

@@ -1,3 +0,0 @@
-# registry=https://registry.npmmirror.com
-registry=https://registry.npmjs.org
-link-workspace-packages=true

package/.prettierignore

@@ -1,2 +0,0 @@
-LICENSE
-LICENSE.md

package/.prettierrc

@@ -1,11 +0,0 @@
-{
-    "trailingComma": "none",
-    "tabWidth": 4,
-    "semi": true,
-    "singleQuote": true,
-    "printWidth": 1024,
-    "bracketSpacing": true,
-    "useTabs": false,
-    "arrowParens": "always",
-    "endOfLine": "lf"
-}

package/apis/health/info.js

@@ -1,49 +0,0 @@
-import { Env } from '../../config/env.js';
-import { Api } from '../../utils/api.js';
-import { RYes, RNo } from '../../utils/index.js';
-
-export default Api.POST(
-    //
-    '健康检查',
-    false,
-    {},
-    [],
-    async (befly, ctx) => {
-        try {
-            const info = {
-                status: 'ok',
-                timestamp: new Date().toISOString(),
-                uptime: process.uptime(),
-                memory: process.memoryUsage(),
-                runtime: 'Bun',
-                version: Bun.version,
-                platform: process.platform,
-                arch: process.arch
-            };
-            // 检查 Redis 连接状态
-            if (Env.REDIS_ENABLE === 1) {
-                if (befly.redis) {
-                    try {
-                        await befly.redis.ping();
-                        info.redis = '已连接';
-                    } catch (error) {
-                        info.redis = '未连接';
-                        info.redisError = error.message;
-                    }
-                } else {
-                    info.redis = '未开启';
-                }
-            } else {
-                info.redis = '禁用';
-            }
-            return RYes('健康检查成功', info);
-        } catch (error) {
-            befly.logger.error({
-                msg: '健康检查失败',
-                error: error.message,
-                stack: error.stack
-            });
-            return RNo('健康检查失败');
-        }
-    }
-);

package/apis/tool/tokenCheck.js

@@ -1,29 +0,0 @@
-import { Env } from '../../config/env.js';
-import { Api } from '../../utils/api.js';
-import { RYes, RNo } from '../../utils/index.js';
-import { Jwt } from '../../utils/jwt.js';
-
-export default Api.POST(
-    //
-    '令牌检测',
-    false,
-    {},
-    [],
-    async (befly, ctx) => {
-        try {
-            const token = ctx.headers?.authorization?.split(' ')[1] || '';
-            if (!token) {
-                return RNo('令牌不能为空');
-            }
-            const jwtData = await Jwt.verify(token);
-            return RYes('令牌有效');
-        } catch (error) {
-            befly.logger.error({
-                msg: '令牌检测失败',
-                error: error.message,
-                stack: error.stack
-            });
-            return RNo('令牌检测失败');
-        }
-    }
-);

package/bin/befly.js

@@ -1,109 +0,0 @@
-#!/usr/bin/env -S bun run
-// Befly CLI (Bun): 列出并执行 core/scripts 与 tpl/scripts 下的脚本
-
-import path from 'node:path';
-import { Glob } from 'bun';
-import { __dirscript as coreScriptsDir, getProjectDir } from '../system.js';
-
-// 解析目录（来自 system.js）
-// 核心脚本目录：core/scripts
-// 用户项目（如 tpl）的脚本目录：始终基于当前工作目录
-const tplScriptsDir = getProjectDir('scripts');
-
-function safeList(dir) {
-    try {
-        // 使用 Bun.Glob 查找当前目录下的所有 .js 文件（不递归）
-        const glob = new Glob('*.js');
-        const files = Array.from(glob.scanSync({ cwd: dir, absolute: false, onlyFiles: true, dot: false }));
-        return files.map((f) => path.basename(f, '.js')).sort();
-    } catch {
-        return [];
-    }
-}
-
-function buildScriptItems() {
-    const coreList = safeList(coreScriptsDir);
-    const tplList = safeList(tplScriptsDir);
-    const coreSet = new Set(coreList);
-
-    const items = [];
-    for (const name of coreList) {
-        items.push({
-            name: name,
-            source: 'core',
-            duplicate: tplList.includes(name),
-            path: path.resolve(coreScriptsDir, `${name}.js`)
-        });
-    }
-    for (const name of tplList) {
-        items.push({
-            name: name,
-            source: 'tpl',
-            duplicate: coreSet.has(name),
-            path: path.resolve(tplScriptsDir, `${name}.js`)
-        });
-    }
-    // 排序：名称字典序，core 在前
-    items.sort((a, b) => (a.name === b.name ? (a.source === b.source ? 0 : a.source === 'core' ? -1 : 1) : a.name.localeCompare(b.name)));
-    return items;
-}
-
-function printAllScripts() {
-    const items = buildScriptItems();
-    if (items.length === 0) {
-        console.log('  • <无>');
-        return;
-    }
-    for (const it of items) {
-        if (it.source === 'tpl' && it.duplicate) console.log(`  • ${it.name}（重复）`);
-        else console.log(`  • ${it.name}`);
-    }
-}
-
-async function resolveScriptPath(name) {
-    const base = name.endsWith('.js') ? name.slice(0, -3) : name;
-    const filename = `${base}.js`;
-    const corePath = path.resolve(coreScriptsDir, filename);
-    const tplPath = path.resolve(tplScriptsDir, filename);
-    if (await Bun.file(corePath).exists()) return corePath;
-    if (await Bun.file(tplPath).exists()) return tplPath;
-    // 回退到列表匹配（防止极端路径或大小写差异）
-    const items = buildScriptItems();
-    const hit = items.find((it) => it.name.toLowerCase() === base.toLowerCase() && it.source === 'core') || items.find((it) => it.name.toLowerCase() === base.toLowerCase());
-    return hit ? hit.path : null;
-}
-
-async function runScriptAtPath(targetPath, label, args = []) {
-    const bunExe = process.execPath || 'bun';
-    const child = Bun.spawn({
-        cmd: [bunExe, targetPath, ...args],
-        stdio: ['inherit', 'inherit', 'inherit'],
-        cwd: process.cwd(),
-        env: { ...process.env, LOG_TO_CONSOLE: '1' }
-    });
-    const code = await child.exited;
-    return code ?? 0;
-}
-
-async function main() {
-    const [, , cmd, ...args] = process.argv;
-    // 无参数：打印所有脚本
-    if (!cmd) {
-        printAllScripts();
-        process.exit(0);
-    }
-    // 按名称执行（将剩余参数透传给脚本）
-    const target = await resolveScriptPath(cmd);
-    if (!target) {
-        console.error(`未找到脚本: ${cmd}`);
-        printAllScripts();
-        process.exit(1);
-    }
-    const code = await runScriptAtPath(target, cmd, args);
-    process.exit(code ?? 0);
-}
-
-main().catch((e) => {
-    console.error('Befly CLI 执行失败:', e);
-    process.exit(1);
-});

package/config/env.js

@@ -1,64 +0,0 @@
-export const Env = {
-    // 项目模式
-    NODE_ENV: process.env.NODE_ENV,
-    // 应用名称
-    APP_NAME: process.env.APP_NAME,
-    // 加密盐
-    MD5_SALT: process.env.MD5_SALT,
-    // 监听端口
-    APP_PORT: Number(process.env.APP_PORT),
-    // 监听主机
-    APP_HOST: process.env.APP_HOST,
-    // 超级管理员密码
-    DEV_PASSWORD: process.env.DEV_PASSWORD,
-    // 请求体大小 10M
-    BODY_LIMIT: Number(process.env.BODY_LIMIT),
-    // 是否进行参数验证
-    PARAMS_CHECK: process.env.PARAMS_CHECK,
-    // 日志等级
-    LOG_LEVEL: process.env.LOG_LEVEL,
-    LOG_EXCLUDE_FIELDS: process.env.LOG_EXCLUDE_FIELDS,
-    LOG_DIR: process.env.LOG_DIR,
-    LOG_TO_CONSOLE: Number(process.env.LOG_TO_CONSOLE),
-    LOG_MAX_SIZE: Number(process.env.LOG_MAX_SIZE),
-    // 时区
-    TZ: process.env.TZ,
-    // 数据库配置
-    DB_ENABLE: Number(process.env.DB_ENABLE),
-    // 通用数据库连接参数
-    DB_TYPE: process.env.DB_TYPE, // sqlite | mysql | postgresql
-    DB_HOST: process.env.DB_HOST,
-    DB_PORT: Number(process.env.DB_PORT),
-    DB_USER: process.env.DB_USER,
-    DB_PASS: process.env.DB_PASS,
-    DB_NAME: process.env.DB_NAME,
-    DB_DEBUG: Number(process.env.DB_DEBUG),
-    DB_POOL_MAX: Number(process.env.DB_POOL_MAX),
-    // Redis配置
-    REDIS_URL: process.env.REDIS_URL,
-    REDIS_ENABLE: Number(process.env.REDIS_ENABLE),
-    REDIS_HOST: process.env.REDIS_HOST,
-    REDIS_PORT: Number(process.env.REDIS_PORT),
-    REDIS_USERNAME: process.env.REDIS_USERNAME,
-    REDIS_PASSWORD: process.env.REDIS_PASSWORD,
-    REDIS_DB: Number(process.env.REDIS_DB),
-    REDIS_KEY_PREFIX: process.env.REDIS_KEY_PREFIX,
-    // JWT配置
-    JWT_SECRET: process.env.JWT_SECRET,
-    JWT_EXPIRES_IN: process.env.JWT_EXPIRES_IN,
-    JWT_ALGORITHM: process.env.JWT_ALGORITHM,
-    // 邮件配置
-    MAIL_HOST: process.env.MAIL_HOST,
-    MAIL_PORT: Number(process.env.MAIL_PORT),
-    MAIL_POOL: process.env.MAIL_POOL,
-    MAIL_SECURE: process.env.MAIL_SECURE,
-    MAIL_USER: process.env.MAIL_USER,
-    MAIL_PASS: process.env.MAIL_PASS,
-    MAIL_SENDER: process.env.MAIL_SENDER,
-    MAIL_ADDRESS: process.env.MAIL_ADDRESS,
-    // 同步脚本开关（用于 core/scripts/syncDb.js）
-    SYNC_MERGE_ALTER: process.env.SYNC_MERGE_ALTER,
-    SYNC_ONLINE_INDEX: process.env.SYNC_ONLINE_INDEX,
-    SYNC_DISALLOW_SHRINK: process.env.SYNC_DISALLOW_SHRINK,
-    SYNC_ALLOW_TYPE_CHANGE: process.env.SYNC_ALLOW_TYPE_CHANGE
-};