befly 3.17.0 → 3.17.2

package/tables/emailLog.json

@@ -0,0 +1,61 @@
+{
+    "adminId": {
+        "name": "发送人ID",
+        "input": "number"
+    },
+    "username": {
+        "name": "发送人账号",
+        "input": "string",
+        "max": 100
+    },
+    "nickname": {
+        "name": "发送人昵称",
+        "input": "string",
+        "max": 100
+    },
+    "toEmail": {
+        "name": "收件人邮箱",
+        "input": "@email",
+        "min": 5,
+        "max": 200
+    },
+    "subject": {
+        "name": "邮件主题",
+        "min": 1,
+        "max": 200,
+        "input": "string"
+    },
+    "content": {
+        "name": "邮件内容",
+        "input": "string"
+    },
+    "ccEmail": {
+        "name": "抄送邮箱",
+        "input": "string",
+        "max": 500
+    },
+    "bccEmail": {
+        "name": "密送邮箱",
+        "input": "string",
+        "max": 500
+    },
+    "sendTime": {
+        "name": "发送时间",
+        "input": "number"
+    },
+    "sendResult": {
+        "name": "发送结果",
+        "input": "number",
+        "max": 1
+    },
+    "messageId": {
+        "name": "消息ID",
+        "input": "string",
+        "max": 200
+    },
+    "failReason": {
+        "name": "失败原因",
+        "input": "string",
+        "max": 500
+    }
+}

package/tables/loginLog.json

@@ -0,0 +1,86 @@
+{
+    "adminId": {
+        "name": "管理员ID",
+        "input": "number"
+    },
+    "username": {
+        "name": "用户名",
+        "input": "string",
+        "min": 1,
+        "max": 50
+    },
+    "nickname": {
+        "name": "昵称",
+        "input": "string",
+        "max": 50
+    },
+    "ip": {
+        "name": "登录IP",
+        "input": "string",
+        "max": 50
+    },
+    "userAgent": {
+        "name": "用户代理",
+        "input": "string",
+        "max": 500
+    },
+    "browserName": {
+        "name": "浏览器名称",
+        "input": "string",
+        "max": 50
+    },
+    "browserVersion": {
+        "name": "浏览器版本",
+        "input": "string",
+        "max": 50
+    },
+    "osName": {
+        "name": "操作系统",
+        "input": "string",
+        "max": 50
+    },
+    "osVersion": {
+        "name": "系统版本",
+        "input": "string",
+        "max": 50
+    },
+    "deviceType": {
+        "name": "设备类型",
+        "input": "string",
+        "max": 20
+    },
+    "deviceVendor": {
+        "name": "设备厂商",
+        "input": "string",
+        "max": 50
+    },
+    "deviceModel": {
+        "name": "设备型号",
+        "input": "string",
+        "max": 50
+    },
+    "engineName": {
+        "name": "引擎名称",
+        "input": "string",
+        "max": 50
+    },
+    "cpuArchitecture": {
+        "name": "CPU架构",
+        "input": "string",
+        "max": 20
+    },
+    "loginTime": {
+        "name": "登录时间",
+        "input": "number"
+    },
+    "loginResult": {
+        "name": "登录结果",
+        "input": "number",
+        "max": 1
+    },
+    "failReason": {
+        "name": "失败原因",
+        "input": "string",
+        "max": 200
+    }
+}

package/tables/menu.json

@@ -0,0 +1,24 @@
+{
+    "name": {
+        "name": "菜单名称",
+        "input": "string",
+        "min": 2,
+        "max": 50
+    },
+    "path": {
+        "name": "路由路径",
+        "input": "string",
+        "min": 1,
+        "max": 150
+    },
+    "sort": {
+        "name": "排序",
+        "input": "number",
+        "max": 9999
+    },
+    "parentPath": {
+        "name": "父级路径",
+        "input": "string",
+        "max": 200
+    }
+}

package/tables/operateLog.json

@@ -0,0 +1,68 @@
+{
+    "adminId": {
+        "name": "管理员ID",
+        "input": "number"
+    },
+    "username": {
+        "name": "用户名",
+        "input": "string",
+        "min": 1,
+        "max": 50
+    },
+    "nickname": {
+        "name": "昵称",
+        "input": "string",
+        "max": 50
+    },
+    "ip": {
+        "name": "操作IP",
+        "input": "string",
+        "max": 50
+    },
+    "module": {
+        "name": "操作模块",
+        "input": "string",
+        "max": 50
+    },
+    "action": {
+        "name": "操作类型",
+        "input": "string",
+        "max": 50
+    },
+    "method": {
+        "name": "请求方法",
+        "input": "string",
+        "max": 10
+    },
+    "path": {
+        "name": "请求路径",
+        "input": "string",
+        "max": 200
+    },
+    "params": {
+        "name": "请求参数",
+        "input": "string"
+    },
+    "result": {
+        "name": "操作结果",
+        "input": "number",
+        "max": 1
+    },
+    "response": {
+        "name": "响应内容",
+        "input": "string"
+    },
+    "duration": {
+        "name": "耗时毫秒",
+        "input": "number"
+    },
+    "operateTime": {
+        "name": "操作时间",
+        "input": "number"
+    },
+    "remark": {
+        "name": "备注",
+        "input": "string",
+        "max": 500
+    }
+}

package/tables/role.json

@@ -0,0 +1,32 @@
+{
+    "name": {
+        "name": "角色名称",
+        "input": "string",
+        "min": 2,
+        "max": 50
+    },
+    "code": {
+        "name": "角色编码",
+        "input": "@alphanumericDash_",
+        "min": 2,
+        "max": 50
+    },
+    "description": {
+        "name": "角色描述",
+        "input": "string",
+        "max": 200
+    },
+    "menus": {
+        "name": "菜单权限",
+        "input": "array"
+    },
+    "apis": {
+        "name": "接口权限",
+        "input": "array"
+    },
+    "sort": {
+        "name": "排序",
+        "input": "number",
+        "max": 9999
+    }
+}

package/tables/sysConfig.json

@@ -0,0 +1,43 @@
+{
+    "name": {
+        "name": "配置名称",
+        "min": 2,
+        "max": 50,
+        "input": "string"
+    },
+    "code": {
+        "name": "配置代码",
+        "input": "@alphanumeric_",
+        "min": 2,
+        "max": 100
+    },
+    "value": {
+        "name": "配置值",
+        "input": "string"
+    },
+    "valueType": {
+        "name": "值类型",
+        "input": "string|number|boolean|json",
+        "max": 20
+    },
+    "group": {
+        "name": "配置分组",
+        "input": "string",
+        "max": 50
+    },
+    "sort": {
+        "name": "排序",
+        "input": "number",
+        "max": 9999
+    },
+    "isSystem": {
+        "name": "是否系统配置",
+        "input": "number",
+        "max": 1
+    },
+    "description": {
+        "name": "描述说明",
+        "input": "string",
+        "max": 500
+    }
+}

package/utils/calcPerfTime.js

@@ -0,0 +1,13 @@
+/**
+ * 计算性能时间差
+ */
+export const calcPerfTime = (startTime, endTime = Bun.nanoseconds()) => {
+    const elapsedMs = (endTime - startTime) / 1_000_000;
+
+    if (elapsedMs < 1000) {
+        return `${elapsedMs.toFixed(2)} 毫秒`;
+    } else {
+        const elapsedSeconds = elapsedMs / 1000;
+        return `${elapsedSeconds.toFixed(2)} 秒`;
+    }
+};

package/utils/cors.js

@@ -0,0 +1,17 @@
+/**
+ * 设置 CORS 响应头
+ * @param req - 请求对象
+ * @param config - CORS 配置（可选）
+ * @returns CORS 响应头对象
+ */
+export function setCorsOptions(req, config = {}) {
+    const origin = config.origin || "*";
+    return {
+        "Access-Control-Allow-Origin": origin === "*" ? req.headers.get("origin") || "*" : origin,
+        "Access-Control-Allow-Methods": config.methods || "GET, POST, PUT, DELETE, OPTIONS",
+        "Access-Control-Allow-Headers": config.allowedHeaders || "Content-Type, Authorization, authorization, token",
+        "Access-Control-Expose-Headers": config.exposedHeaders || "Content-Range, X-Content-Range, Authorization, authorization, token",
+        "Access-Control-Max-Age": String(config.maxAge || 86400),
+        "Access-Control-Allow-Credentials": config.credentials || "true"
+    };
+}

package/utils/deepMerge.js

@@ -0,0 +1,78 @@
+import { isPlainObject } from "./is.js";
+
+function clone(value) {
+    return structuredClone(value);
+}
+
+function concat(targetArr, sourceArr, cloneTargetItems) {
+    const nextArr = [];
+
+    if (cloneTargetItems) {
+        for (const item of targetArr) {
+            nextArr.push(clone(item));
+        }
+    } else {
+        for (const item of targetArr) {
+            nextArr.push(item);
+        }
+    }
+
+    for (const item of sourceArr) {
+        nextArr.push(clone(item));
+    }
+
+    return nextArr;
+}
+
+function mergeValue(baseValue, incomingValue) {
+    if (Array.isArray(baseValue) && Array.isArray(incomingValue)) {
+        return concat(baseValue, incomingValue, false);
+    }
+
+    if (isPlainObject(baseValue) && isPlainObject(incomingValue)) {
+        mergeInto(baseValue, incomingValue);
+        return baseValue;
+    }
+
+    return clone(incomingValue);
+}
+
+function mergeInto(base, incoming) {
+    for (const key of Object.keys(incoming)) {
+        const incomingValue = incoming[key];
+        if (incomingValue === undefined) {
+            continue;
+        }
+
+        base[key] = mergeValue(base[key], incomingValue);
+    }
+
+    return base;
+}
+
+/**
+ * 深度合并对象，并对数组执行 concat（保持 scanConfig 现有语义）。
+ * - undefined 会被忽略
+ * - plain object 深合并
+ * - array 与 array 合并为新数组（保持输入不被污染）
+ */
+export function deepMerge(source, target) {
+    if (Array.isArray(source) && Array.isArray(target)) {
+        const base = clone(source);
+        const incoming = clone(target);
+        return concat(base, incoming, false);
+    }
+
+    if (isPlainObject(source) && isPlainObject(target)) {
+        const base = clone(source);
+        const incoming = clone(target);
+        return mergeInto(base, incoming);
+    }
+
+    throw new Error("deepMerge: source/target 必须同为数组或同为普通对象", {
+        cause: null,
+        code: "validation",
+        subsystem: "utils",
+        operation: "deepMerge"
+    });
+}

package/utils/fieldClear.js

@@ -0,0 +1,65 @@
+// fieldClear 工具函数实现
+// 支持 pick/omit/keepValues/excludeValues，处理对象和数组
+
+function isObject(val) {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+}
+
+function isArray(val) {
+    return Array.isArray(val);
+}
+
+export function fieldClear(data, options = {}) {
+    const { pickKeys, omitKeys, keepValues, excludeValues, keepMap } = options;
+
+    const filterObj = (obj) => {
+        let result = {};
+        let keys = Object.keys(obj);
+        if (pickKeys && pickKeys.length) {
+            keys = keys.filter((k) => pickKeys.includes(k));
+        }
+        if (omitKeys && omitKeys.length) {
+            keys = keys.filter((k) => !omitKeys.includes(k));
+        }
+        for (const key of keys) {
+            const value = obj[key];
+
+            // 1. 优先检查 keepMap
+            if (keepMap && key in keepMap) {
+                if (Object.is(keepMap[key], value)) {
+                    result[key] = value;
+                    continue;
+                }
+            }
+
+            // 2. 检查 keepValues (只保留指定值)
+            if (keepValues && keepValues.length && !keepValues.includes(value)) {
+                continue;
+            }
+
+            // 3. 检查 excludeValues (排除指定值)
+            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
+                continue;
+            }
+            result[key] = value;
+        }
+        return result;
+    };
+
+    if (isArray(data)) {
+        return data
+            .map((item) => (isObject(item) ? filterObj(item) : item))
+            .filter((item) => {
+                if (isObject(item)) {
+                    // 只保留有内容的对象
+                    return Object.keys(item).length > 0;
+                }
+                // 原始值直接保留
+                return true;
+            });
+    }
+    if (isObject(data)) {
+        return filterObj(data);
+    }
+    return data;
+}

package/utils/formatYmdHms.js

@@ -0,0 +1,23 @@
+export function formatYmdHms(date, format = "dateTime") {
+    const y = date.getFullYear();
+    const m = date.getMonth() + 1;
+    const d = date.getDate();
+    const h = date.getHours();
+    const mi = date.getMinutes();
+    const s = date.getSeconds();
+
+    const mm = m < 10 ? `0${m}` : String(m);
+    const dd = d < 10 ? `0${d}` : String(d);
+    const hh = h < 10 ? `0${h}` : String(h);
+    const mii = mi < 10 ? `0${mi}` : String(mi);
+    const ss = s < 10 ? `0${s}` : String(s);
+
+    if (format === "date") {
+        return `${y}-${mm}-${dd}`;
+    }
+    if (format === "time") {
+        return `${hh}:${mii}:${ss}`;
+    }
+
+    return `${y}-${mm}-${dd} ${hh}:${mii}:${ss}`;
+}

package/utils/formatZodIssues.js

@@ -0,0 +1,109 @@
+function getValueByPath(source, path) {
+    if (!Array.isArray(path)) return undefined;
+
+    let current = source;
+    for (const segment of path) {
+        if (current === null || current === undefined) return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+
+function formatValue(value) {
+    if (value === undefined) return "undefined";
+    if (value === null) return "null";
+    if (typeof value === "string") return value;
+    if (typeof value === "number" || typeof value === "boolean") return value;
+    if (typeof value === "function") return "[Function]";
+    if (Array.isArray(value)) return value.map((item) => formatValue(item)).join(", ");
+
+    try {
+        return JSON.stringify(value);
+    } catch {
+        return String(value);
+    }
+}
+
+function pickFileLabel(item, itemLabel, index) {
+    if (item) {
+        if (item.filePath) return item.filePath;
+        if (item.relativePath) return item.relativePath;
+        if (item.fileName) return item.fileName;
+        if (item.name) return item.name;
+    }
+
+    if (typeof index === "number") return `${itemLabel}[${index}]`;
+
+    return itemLabel;
+}
+
+function buildExpectedMessage(issue, fieldPath) {
+    if (issue.code === "invalid_enum_value" && Array.isArray(issue.options)) {
+        return `字段 ${fieldPath} 仅允许 ${issue.options.join("|")}`;
+    }
+
+    if (issue.code === "invalid_literal") {
+        return `字段 ${fieldPath} 仅允许 ${formatValue(issue.expected)}`;
+    }
+
+    if (issue.code === "invalid_type") {
+        return `字段 ${fieldPath} 必须是 ${issue.expected}`;
+    }
+
+    if (issue.code === "too_small") {
+        if (typeof issue.minimum === "number") {
+            const sign = issue.inclusive ? ">=" : ">";
+            return `字段 ${fieldPath} ${sign}${issue.minimum}`;
+        }
+    }
+
+    if (issue.code === "too_big") {
+        if (typeof issue.maximum === "number") {
+            const sign = issue.inclusive ? "<=" : "<";
+            return `字段 ${fieldPath} ${sign}${issue.maximum}`;
+        }
+    }
+
+    if (issue.message) {
+        return `字段 ${fieldPath} ${issue.message}`;
+    }
+
+    return `字段 ${fieldPath} 无效`;
+}
+
+export function formatZodIssues(issues, options = {}) {
+    const result = [];
+    const items = Array.isArray(options.items) ? options.items : null;
+    const item = options.item || null;
+    const itemLabel = options.itemLabel || "item";
+
+    for (const issue of issues) {
+        const issuePath = Array.isArray(issue.path) ? issue.path : [];
+        const hasIndex = items && typeof issuePath[0] === "number";
+        const index = hasIndex ? issuePath[0] : null;
+        const path = hasIndex ? issuePath.slice(1) : issuePath;
+
+        const targetItem = hasIndex ? items[index] : item;
+        const fileLabel = pickFileLabel(targetItem, itemLabel, index);
+        const fieldPath = path.length > 0 ? path.join(".") : "(root)";
+
+        const expectedMessage = buildExpectedMessage(issue, fieldPath);
+
+        if (issue.code === "unrecognized_keys" && Array.isArray(issue.keys)) {
+            for (const key of issue.keys) {
+                result.push({
+                    file: fileLabel,
+                    expected: `字段 ${key} 禁止出现`
+                });
+            }
+            continue;
+        }
+
+        result.push({
+            file: fileLabel,
+            expected: expectedMessage
+        });
+    }
+
+    return result;
+}

package/utils/getClientIp.js

@@ -0,0 +1,47 @@
+import { isNonEmptyString } from "./is.js";
+
+/**
+ * 获取客户端 IP（优先代理头，其次 Bun server.requestIP 兜底）
+ *
+ * 注意：目前策略是“尽量取到 IP”，未做 trustProxy 防伪造控制。
+ */
+export function getClientIp(req, server) {
+    // 1) 代理/网关常见头（优先取）
+    const xForwardedFor = req.headers.get("x-forwarded-for");
+    if (isNonEmptyString(xForwardedFor)) {
+        const first = xForwardedFor.split(",")[0];
+        if (isNonEmptyString(first)) {
+            return first.trim();
+        }
+    }
+
+    const xRealIp = req.headers.get("x-real-ip");
+    if (isNonEmptyString(xRealIp)) {
+        return xRealIp.trim();
+    }
+
+    const cfConnectingIp = req.headers.get("cf-connecting-ip");
+    if (isNonEmptyString(cfConnectingIp)) {
+        return cfConnectingIp.trim();
+    }
+
+    const xClientIp = req.headers.get("x-client-ip");
+    if (isNonEmptyString(xClientIp)) {
+        return xClientIp.trim();
+    }
+
+    const trueClientIp = req.headers.get("true-client-ip");
+    if (isNonEmptyString(trueClientIp)) {
+        return trueClientIp.trim();
+    }
+
+    // 2) 连接层兜底：Bun server.requestIP(req)
+    if (server && typeof server.requestIP === "function") {
+        const ipInfo = server.requestIP(req);
+        if (ipInfo && isNonEmptyString(ipInfo.address)) {
+            return ipInfo.address.trim();
+        }
+    }
+
+    return "unknown";
+}