befly 3.76.1 → 3.76.3

package/lib/xmlParse.js

@@ -1,149 +0,0 @@
-import { createError } from "#befly/utils/error.js";
-import { isString } from "#befly/utils/is.js";
-
-function decodeXmlText(value) {
-    return String(value)
-        .replace(/&lt;/g, "<")
-        .replace(/&gt;/g, ">")
-        .replace(/&amp;/g, "&")
-        .replace(/&apos;/g, "'")
-        .replace(/&quot;/g, '"');
-}
-
-function normalizeXmlValue(value) {
-    const text = decodeXmlText(value.trim());
-    if (text === "") {
-        return "";
-    }
-    const numberValue = Number(text);
-    if (Number.isFinite(numberValue) && String(numberValue) === text) {
-        return numberValue;
-    }
-    return text;
-}
-
-function assignNodeValue(target, key, value) {
-    if (Object.hasOwn(target, key)) {
-        if (Array.isArray(target[key])) {
-            target[key].push(value);
-            return;
-        }
-        target[key] = [target[key], value];
-        return;
-    }
-
-    target[key] = value;
-}
-
-function skipIgnoredMarkup(rawXml, startIndex) {
-    let index = startIndex;
-
-    while (index < rawXml.length) {
-        while (/\s/.test(rawXml[index])) {
-            index += 1;
-        }
-
-        if (rawXml.startsWith("<?", index)) {
-            const declarationEnd = rawXml.indexOf("?>", index);
-            if (declarationEnd === -1) {
-                throw createError("XML 声明未闭合", { code: "validation", subsystem: "xml", operation: "skipIgnoredMarkup" });
-            }
-            index = declarationEnd + 2;
-            continue;
-        }
-
-        if (rawXml.startsWith("<!--", index)) {
-            const commentEnd = rawXml.indexOf("-->", index);
-            if (commentEnd === -1) {
-                throw createError("XML 注释未闭合", { code: "validation", subsystem: "xml", operation: "skipIgnoredMarkup" });
-            }
-            index = commentEnd + 3;
-            continue;
-        }
-
-        return index;
-    }
-
-    return index;
-}
-
-function parseNode(rawXml, startIndex) {
-    const openEnd = rawXml.indexOf(">", startIndex);
-    if (openEnd === -1) {
-        throw createError("XML 开始标签不完整", { code: "validation", subsystem: "xml", operation: "parseNode" });
-    }
-
-    const openContent = rawXml.slice(startIndex + 1, openEnd).trim();
-    const isSelfClosing = openContent.endsWith("/");
-    const tagName = (isSelfClosing ? openContent.slice(0, -1).trim() : openContent).split(/\s+/)[0];
-    if (!tagName || tagName.startsWith("/")) {
-        throw createError("XML 标签格式不正确", { code: "validation", subsystem: "xml", operation: "parseNode" });
-    }
-    if (isSelfClosing) {
-        return {
-            key: tagName,
-            value: "",
-            index: openEnd + 1
-        };
-    }
-
-    let index = openEnd + 1;
-    let text = "";
-    const children = {};
-    let hasChild = false;
-
-    while (index < rawXml.length) {
-        index = skipIgnoredMarkup(rawXml, index);
-
-        if (rawXml.startsWith("<![CDATA[", index)) {
-            const cdataEnd = rawXml.indexOf("]]>", index);
-            if (cdataEnd === -1) {
-                throw createError("XML CDATA 未闭合", { code: "validation", subsystem: "xml", operation: "parseNode" });
-            }
-            text += rawXml.slice(index + 9, cdataEnd);
-            index = cdataEnd + 3;
-            continue;
-        }
-
-        if (rawXml.startsWith(`</${tagName}>`, index)) {
-            index += tagName.length + 3;
-            return {
-                key: tagName,
-                value: hasChild ? children : normalizeXmlValue(text),
-                index: index
-            };
-        }
-
-        if (rawXml[index] === "<") {
-            const child = parseNode(rawXml, index);
-            hasChild = true;
-            assignNodeValue(children, child.key, child.value);
-            index = child.index;
-            continue;
-        }
-
-        const nextTagIndex = rawXml.indexOf("<", index);
-        if (nextTagIndex === -1) {
-            throw createError("XML 结束标签缺失", { code: "validation", subsystem: "xml", operation: "parseNode" });
-        }
-        text += rawXml.slice(index, nextTagIndex);
-        index = nextTagIndex;
-    }
-
-    throw createError("XML 标签未闭合", { code: "validation", subsystem: "xml", operation: "parseNode" });
-}
-
-export function xmlParse(value) {
-    if (!isString(value) || value.length < 1) {
-        throw createError("xmlParse 输入必须是非空字符串", { code: "validation", subsystem: "xml", operation: "xmlParse" });
-    }
-
-    const normalized = value.trim();
-    const startIndex = skipIgnoredMarkup(normalized, 0);
-    if (normalized[startIndex] !== "<") {
-        throw createError("XML 根节点缺失", { code: "validation", subsystem: "xml", operation: "xmlParse" });
-    }
-
-    const node = parseNode(normalized, startIndex);
-    return node.key === "xml" && Object.prototype.toString.call(node.value) === "[object Object]" ? node.value : { [node.key]: node.value };
-}

package/plugins/config.js

@@ -1,13 +0,0 @@
-import { PLUGIN_ORDER } from "../configs/constConfig.js";
-
-/**
- * 配置插件
- * 提供访问项目配置的能力
- */
-
-export default {
-    order: PLUGIN_ORDER.CONFIG,
-    handler: (befly) => {
-        return befly.config;
-    }
-};

package/plugins/cron.js

@@ -1,115 +0,0 @@
-import { PLUGIN_ORDER } from "../configs/constConfig.js";
-/**
- * 定时任务插件
- * 基于 Bun.cron 提供进程内定时任务能力。
- */
-import { Logger } from "../lib/logger.js";
-import { createError } from "../utils/error.js";
-import { isPrimaryProcess, isValidCronSchedule } from "../utils/is.js";
-
-const jobs = new Map();
-
-/**
- * 注册一个定时任务
- * @param {string} name - 任务名称，用于日志标识
- * @param {string} schedule - cron 表达式或预定义昵称
- * @param {function} task - 任务函数，接收 befly 上下文
- * @returns {CronJob|null}
- */
-function register(context, name, schedule, task) {
-    if (!isPrimaryProcess()) {
-        return null;
-    }
-
-    if (jobs.has(name)) {
-        return jobs.get(name);
-    }
-
-    // 前置校验：表达式非法时启动即报错，避免 Bun.cron 注册时抛裸错
-    if (!isValidCronSchedule(schedule)) {
-        throw createError(`定时任务 ${name} 的 schedule 不是合法的 cron 表达式`, { code: "validation", subsystem: "cron", operation: "register" });
-    }
-
-    // 时区统一走 config.tz（checkConfig 已校验 IANA 合法性），未配置时使用系统时区
-    const tz = context.config?.tz;
-    const job = Bun.cron(
-        schedule,
-        async function () {
-            Logger.info(`[定时任务] ${name} 开始执行`);
-            try {
-                await task(context);
-                Logger.info(`[定时任务] ${name} 执行完成`);
-            } catch (error) {
-                Logger.error(`[定时任务] ${name} 执行失败`, error);
-            }
-        },
-        tz ? { tz: tz } : undefined
-    );
-
-    jobs.set(name, job);
-    return job;
-}
-
-/**
- * 注册一个按秒执行的定时任务
- */
-function second(context, name, seconds, task) {
-    if (!isPrimaryProcess()) {
-        return null;
-    }
-
-    if (jobs.has(name)) {
-        return jobs.get(name);
-    }
-
-    let running = false;
-    const timer = setInterval(async () => {
-        if (running) {
-            return;
-        }
-
-        running = true;
-        try {
-            await task(context);
-        } catch (error) {
-            Logger.error(`[定时任务] ${name} 执行失败`, error);
-        } finally {
-            running = false;
-        }
-    }, seconds * 1000);
-    const job = {
-        stop: () => clearInterval(timer)
-    };
-
-    jobs.set(name, job);
-    return job;
-}
-
-/**
- * 批量注册扫描到的定时器（corns/*.js），任务名取文件名
- */
-export function registerCorns(context, corns) {
-    for (const corn of corns) {
-        register(context, corn.fileName, corn.schedule, corn.handler);
-    }
-}
-
-/**
- * 停止所有已注册的定时任务
- */
-export function stopAll() {
-    for (const job of jobs.values()) {
-        job.stop();
-    }
-    jobs.clear();
-}
-
-export default {
-    order: PLUGIN_ORDER.CRON,
-    handler: async function (befly) {
-        return {
-            register: (name, schedule, task) => register(befly, name, schedule, task),
-            second: (name, seconds, task) => second(befly, name, seconds, task)
-        };
-    }
-};

package/plugins/logger.js

@@ -1,17 +0,0 @@
-import { PLUGIN_ORDER } from "../configs/constConfig.js";
-/**
- * 日志插件
- * 提供全局日志功能
- */
-import { Logger } from "../lib/logger.js";
-
-/**
- * 日志插件
- */
-export default {
-    order: PLUGIN_ORDER.LOGGER,
-    handler: async function () {
-        // 日志已在 createBefly 中按 runMode 初始化，这里只注入 Logger 实例
-        return Logger;
-    }
-};

package/plugins/tool.js

@@ -1,131 +0,0 @@
-import { PLUGIN_ORDER } from "../configs/constConfig.js";
-/**
- * 工具插件
- * 提供常用的工具函数
- */
-import { isNumber, isString } from "../utils/is.js";
-
-/**
- * 成功响应
- * @param msg - 消息
- * @param data - 数据（可选）
- * @param other - 其他字段（可选）
- * @returns 成功响应对象
- */
-export function Yes(msg, data = {}, other = {}) {
-    const out = {
-        code: 0,
-        msg: msg,
-        data: data
-    };
-    if (other && typeof other === "object") {
-        for (const key of Object.keys(other)) {
-            out[key] = other[key];
-        }
-    }
-    return out;
-}
-
-/**
- * 失败响应
- * @param msg - 消息
- * @param data - 数据（可选）
- * @param other - 其他字段（可选）
- * @returns 失败响应对象
- */
-export function No(msg, data = null, other = {}) {
-    const out = {
-        code: 1,
-        msg: msg,
-        data: data
-    };
-    if (other && typeof other === "object") {
-        for (const key of Object.keys(other)) {
-            out[key] = other[key];
-        }
-    }
-    return out;
-}
-
-/**
- * 业务失败并抛出错误
- *
- * 仅用于事务内需要回滚的业务失败；抛出后由路由统一转换为 { code: 1 } 响应。
- * @param msg - 消息
- * @param data - 数据（可选）
- * @param other - 其他字段（可选）
- */
-export function Fail(msg, data = null, other = {}) {
-    const error = new Error(msg);
-    error.isBeflyResponse = true;
-    error.payload = No(msg, data, other);
-    throw error;
-}
-
-/**
- * 统一响应函数
- *
- * 自动识别数据类型并设置正确的 Content-Type：
- * - 对象 → application/json
- * - 字符串 → text/plain
- * - 可通过 options.contentType 手动指定
- *
- * @param ctx 请求上下文
- * @param data 响应数据（对象或字符串）
- * @param options 响应选项
- * @returns Response 对象
- */
-export function Raw(ctx, data, options = {}) {
-    const status = isNumber(options.status) ? options.status : 200;
-    const contentType = options.contentType;
-    const headers = options.headers || {};
-
-    // 自动判断 Content-Type
-    let finalContentType = contentType;
-    let body;
-
-    if (isString(data)) {
-        // 字符串类型
-        body = data;
-        if (!finalContentType) {
-            // 自动判断：XML 或纯文本
-            finalContentType = data.trim().startsWith("<") ? "application/xml" : "text/plain";
-        }
-    } else {
-        // JSON 序列化（对象/数组/原始值均可）
-        body = JSON.stringify(data);
-        finalContentType ||= "application/json";
-    }
-
-    // 合并响应头
-    const responseHeaders = {};
-    const corsHeaders = ctx.corsHeaders;
-    if (corsHeaders && typeof corsHeaders === "object") {
-        for (const key of Object.keys(corsHeaders)) {
-            responseHeaders[key] = corsHeaders[key];
-        }
-    }
-    responseHeaders["Content-Type"] = finalContentType;
-    if (headers && typeof headers === "object") {
-        for (const key of Object.keys(headers)) {
-            responseHeaders[key] = headers[key];
-        }
-    }
-
-    return new Response(body, {
-        status: status,
-        headers: responseHeaders
-    });
-}
-
-export default {
-    order: PLUGIN_ORDER.TOOL,
-    handler: () => {
-        return {
-            Yes: Yes,
-            No: No,
-            Fail: Fail,
-            Raw: Raw
-        };
-    }
-};

package/plugins/xmlParse.js

@@ -1,10 +0,0 @@
-import { xmlParse } from "#befly/lib/xmlParse.js";
-
-import { PLUGIN_ORDER } from "../configs/constConfig.js";
-
-export default {
-    order: PLUGIN_ORDER.XML_PARSE,
-    handler: () => {
-        return xmlParse;
-    }
-};

package/schemas/config.js

@@ -1,67 +0,0 @@
-const noTrimString = { type: "string", noTrim: true };
-const boolInt = { type: "boolInt" };
-const port = { type: "number", integer: true, min: 1, max: 65535 };
-
-export const configSchema = {
-    root: {
-        appName: noTrimString,
-        appPort: port,
-        appHost: noTrimString,
-        apiHost: noTrimString,
-        devEmail: { type: "string", noTrim: true, check: "emailOrEmpty" },
-        devPassword: { type: "string", min: 6 },
-        bodyLimit: { type: "number", integer: true, min: 1 },
-        tz: { type: "string", check: "timeZone" },
-        excludeApisLog: { type: "stringArray", noTrim: true }
-    },
-    groups: {
-        upload: {
-            maxSize: { type: "number", integer: true, min: 1 },
-            publicDir: { ...noTrimString, min: 1 },
-            publicHost: noTrimString,
-            allowedExtensions: { ...noTrimString, pattern: /^\.[a-z0-9]+(?:,\.[a-z0-9]+)*$/ },
-            allowedMimeTypes: { ...noTrimString, pattern: /^[a-z0-9][a-z0-9.+-]*\/[a-z0-9][a-z0-9.+-]*(?:,[a-z0-9][a-z0-9.+-]*\/[a-z0-9][a-z0-9.+-]*)*$/ },
-            forceDownloadExtensions: { ...noTrimString, pattern: /^(|\.[a-z0-9]+(?:,\.[a-z0-9]+)*)$/ }
-        },
-        logger: { debug: boolInt, excludeFields: { type: "stringArray", noTrim: true } },
-        mysql: {
-            hostname: noTrimString,
-            port: port,
-            username: noTrimString,
-            password: noTrimString,
-            database: noTrimString,
-            max: { type: "number", min: 1 },
-            beflyMode: { type: "values", values: ["manual", "auto"], optional: true },
-            idleTimeout: { type: "number", min: 1, optional: true },
-            maxLifetime: { type: "number", min: 0, optional: true },
-            connectionTimeout: { type: "number", min: 1, optional: true },
-            queryTimeout: { type: "number", min: 1, optional: true }
-        },
-        redis: {
-            hostname: noTrimString,
-            port: port,
-            username: noTrimString,
-            password: noTrimString,
-            db: { type: "number", integer: true, min: 0, max: 16 },
-            prefix: { ...noTrimString, check: "redisPrefix" }
-        },
-        session: { expireDays: { type: "number", integer: true, min: 1 } },
-        email: { host: noTrimString, port: port, secure: boolInt, user: noTrimString, pass: noTrimString, label: { ...noTrimString, optional: true } },
-        cors: {
-            methods: noTrimString,
-            allowedHeaders: noTrimString,
-            exposedHeaders: noTrimString,
-            maxAge: { type: "number", integer: true, min: 0 },
-            credentials: { type: "values", values: ["true", "false", true, false] }
-        },
-        rateLimit: {
-            enable: boolInt,
-            // 限流服务不可用时是否放行（1 放行 / 0 拒绝），默认 1
-            failOpen: boolInt,
-            defaultLimit: { type: "number", integer: true, min: 1 },
-            defaultWindow: { type: "number", integer: true, min: 1 },
-            key: noTrimString,
-            skipRoutes: { type: "stringArray", noTrim: true }
-        }
-    }
-};

package/scripts/syncDb/context.js

@@ -1,120 +0,0 @@
-import { mkdir } from "node:fs/promises";
-import { basename, resolve, join } from "node:path";
-
-import { BEFLY_TABLE_PREFIX } from "#befly/configs/constConfig.js";
-import { Connect } from "#befly/lib/connect.js";
-import { DbHelper } from "#befly/lib/dbHelper.js";
-import { Logger } from "#befly/lib/logger.js";
-import { createError } from "#befly/utils/error.js";
-import { importDefault } from "#befly/utils/importDefault.js";
-import { isNonEmptyString, isPlainObject } from "#befly/utils/is.js";
-import { camelCase } from "#befly/utils/util.js";
-
-import { buildSyncDbDiff, groupSyncDbColumns } from "./diff.js";
-import { printSyncDbProcessLog } from "./report.js";
-
-const SYNC_DB_COLUMNS_SQL = `
-SELECT
-    c.TABLE_NAME AS tableName,
-    t.TABLE_COMMENT AS tableComment,
-    c.COLUMN_NAME AS columnName,
-    c.DATA_TYPE AS dataType,
-    c.COLUMN_TYPE AS columnType,
-    c.CHARACTER_MAXIMUM_LENGTH AS charLength,
-    c.COLUMN_COMMENT AS columnComment,
-    c.ORDINAL_POSITION AS ordinalPosition
-FROM information_schema.COLUMNS AS c
-LEFT JOIN information_schema.TABLES AS t
-    ON t.TABLE_SCHEMA = c.TABLE_SCHEMA
-    AND t.TABLE_NAME = c.TABLE_NAME
-WHERE c.TABLE_SCHEMA = DATABASE()
-ORDER BY c.TABLE_NAME ASC, c.ORDINAL_POSITION ASC
-`;
-
-export async function prepareSyncDbBaseContext(mysqlConfig) {
-    const tablesDir = resolve(join(process.cwd(), "tables"));
-    await mkdir(tablesDir, { recursive: true });
-    printSyncDbProcessLog(`表定义目录=${tablesDir}`);
-
-    if (!isPlainObject(mysqlConfig)) {
-        throw createError("syncDb 缺少 mysql 配置", { code: "validation", subsystem: "scripts", operation: "syncDb" });
-    }
-
-    printSyncDbProcessLog(`同步模式=${mysqlConfig.beflyMode === "manual" ? "手动" : "自动"}`);
-    printSyncDbProcessLog(`连接 MySQL，数据库名=${mysqlConfig.database}`);
-    await Connect.connectMysql(mysqlConfig);
-    const mysql = new DbHelper({
-        redis: null,
-        dbName: mysqlConfig.database,
-        sql: Connect.getMysql(),
-        beflyMode: mysqlConfig.beflyMode
-    });
-
-    printSyncDbProcessLog("开始读取数据库字段信息");
-    const queryRes = await mysql.execute(SYNC_DB_COLUMNS_SQL);
-    const dbColumns = Array.isArray(queryRes.data) ? queryRes.data : [];
-    printSyncDbProcessLog(`数据库字段读取完成，字段数量=${dbColumns.length}`);
-
-    const skippedBeflyTables = new Set();
-    for (const row of dbColumns) {
-        const tableName = String(row?.tableName || "");
-        if (isNonEmptyString(tableName) && tableName.toLowerCase().startsWith(BEFLY_TABLE_PREFIX)) {
-            skippedBeflyTables.add(tableName);
-        }
-    }
-    if (skippedBeflyTables.size > 0) {
-        const skippedTables = Array.from(skippedBeflyTables).toSorted((left, right) => left.localeCompare(right));
-        Logger.info("已跳过 befly_ 前缀表，不参与对比", {
-            skippedTableCount: skippedBeflyTables.size,
-            skippedTables: skippedTables
-        });
-    }
-
-    const groupedDbColumns = groupSyncDbColumns(dbColumns);
-    const existingTableMap = new Map();
-    const glob = new Bun.Glob("*.json");
-    const files = await glob.scan({
-        cwd: tablesDir,
-        onlyFiles: true,
-        absolute: true,
-        followSymlinks: true
-    });
-
-    for await (const filePath of files) {
-        const tableFileName = basename(filePath, ".json");
-        if (tableFileName.startsWith("_")) {
-            continue;
-        }
-
-        const tableKey = String(camelCase(tableFileName)).toLowerCase();
-        const loaded = await importDefault(filePath, {});
-        if (!isPlainObject(loaded)) {
-            Logger.warn("tables 定义文件不是对象，已按空对象处理", {
-                filePath: filePath
-            });
-            existingTableMap.set(tableKey, {
-                tableFileName: tableFileName,
-                filePath: filePath,
-                tableDef: {}
-            });
-            continue;
-        }
-
-        existingTableMap.set(tableKey, {
-            tableFileName: tableFileName,
-            filePath: filePath,
-            tableDef: loaded
-        });
-    }
-
-    const diff = buildSyncDbDiff(groupedDbColumns, existingTableMap, mysqlConfig.beflyMode);
-    printSyncDbProcessLog(`表定义文件数量=${existingTableMap.size}`);
-    printSyncDbProcessLog(`差异扫描完成，缺少表数量=${diff.missingTables.length}，缺少字段数量=${diff.missingFieldCount}，多余表数量=${diff.extraTables.length}，多余字段数量=${diff.extraFieldCount}`);
-
-    return {
-        diff: diff,
-        groupedDbColumns: groupedDbColumns,
-        tablesDir: tablesDir,
-        existingTableMap: existingTableMap
-    };
-}