befly 3.76.0 → 3.76.2

package/utils/is.js

@@ -1,267 +1,30 @@
-/**
- * 判断值是否为 plain object（原型为 Object.prototype 或 null）。
- */
 export function isPlainObject(value) {
-    if (typeof value !== "object" || value === null) {
-        return false;
-    }
-
-    const proto = Object.getPrototypeOf(value);
-    return proto === Object.prototype || proto === null;
-}
-
-/**
- * 判断值是否为 JSON 基础类型（string/number/boolean/null）。
- */
-export function isJsonPrimitive(value) {
-    if (value === null) {
-        return true;
-    }
-    return typeof value === "string" || isNumber(value) || isBoolean(value);
+    if (typeof value !== "object" || value === null) return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
 }
 
-/**
- * 判断值是否为有限数值。
- */
-export function isFiniteNumber(value) {
-    return isNumber(value) && Number.isFinite(value);
-}
-
-/**
- * 判断值是否为字符串。
- */
 export function isString(value) {
     return typeof value === "string";
 }
 
-/**
- * 判断值是否为 number。
- */
 export function isNumber(value) {
-    return Object.prototype.toString.call(value) === "[object Number]";
-}
-
-/**
- * 判断值是否为 boolean。
- */
-export function isBoolean(value) {
-    return Object.prototype.toString.call(value) === "[object Boolean]";
-}
-
-/**
- * 判断值是否为 function。
- */
-export function isFunction(value) {
-    return typeof value === "function";
-}
-
-/**
- * 判断值是否为 nullable（默认仅 null/undefined）。
- * 可通过 extraValues 指定更多“空值”。
- */
-export function isNullable(value, extraValues = []) {
-    if (value === null || value === undefined) {
-        return true;
-    }
-
-    if (!Array.isArray(extraValues) || extraValues.length === 0) {
-        return false;
-    }
-
-    for (const item of extraValues) {
-        if (Object.is(value, item)) {
-            return true;
-        }
-    }
-
-    return false;
+    return typeof value === "number";
 }
 
-/**
- * 判断字符串长度是否至少为指定值（trim 后）。
- */
-export function isMinLengthString(value, minLength) {
-    if (typeof value !== "string") {
-        return false;
-    }
-    if (!Number.isFinite(minLength)) {
-        return false;
-    }
-    if (minLength <= 0) {
-        return true;
-    }
-    return value.trim().length >= minLength;
+export function isNullable(value) {
+    return value === null || value === undefined;
 }
 
-/**
- * 判断值是否为非空字符串。
- */
 export function isNonEmptyString(value) {
     return typeof value === "string" && value.trim().length > 0;
 }
 
-/**
- * 判断字符串是否允许空字符串且不允许首尾空白。
- */
-export function isNoTrimStringAllowEmpty(value) {
-    if (typeof value !== "string") {
-        return false;
-    }
-
-    if (value.length === 0) {
-        return true;
-    }
-
-    const firstCharCode = value.codePointAt(0);
-    if (isWhitespaceCharCode(firstCharCode)) {
-        return false;
-    }
-
-    const lastCharCode = value.codePointAt(value.length - 1);
-    if (isWhitespaceCharCode(lastCharCode)) {
-        return false;
-    }
-
-    return true;
-}
-
-function isWhitespaceCharCode(code) {
-    if (code === 9 || code === 10 || code === 11 || code === 12 || code === 13) {
-        return true;
-    }
-    if (code === 32 || code === 133 || code === 160) {
-        return true;
-    }
-    if (code === 5760 || code === 8232 || code === 8233 || code === 8239 || code === 8287 || code === 12288 || code === 65279) {
-        return true;
-    }
-    if (code >= 8192 && code <= 8202) {
-        return true;
-    }
-    return false;
-}
-
-/**
- * 判断是否为小驼峰命名（可选以下划线开头）。
- */
-export function isLowerCamelCaseName(value) {
-    if (!isNonEmptyString(value)) {
-        return false;
-    }
-    return /^_?[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/.test(value);
-}
-
-/**
- * 判断值是否为合法端口号（1..65535）。
- */
-export function isValidPort(value) {
-    return isFiniteNumber(value) && value >= 1 && value <= 65535;
-}
-
-/**
- * 判断值是否为合法非负整数。
- */
-export function isValidNonNegativeInt(value) {
-    return Number.isInteger(value) && value >= 0;
-}
-
-/**
- * 判断值是否为合法正整数。
- */
 export function isValidPositiveInt(value) {
     return Number.isInteger(value) && value >= 1;
 }
 
-/**
- * 判断值是否为有效 IANA 时区字符串。
- */
-export function isValidTimeZone(value) {
-    if (!isNonEmptyString(value)) return false;
-
-    try {
-        // RangeError: Invalid time zone specified
-        new Intl.DateTimeFormat("en-US", { timeZone: value }).format(0);
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-/**
- * 判断值是否为可注册的 cron 表达式（与 Bun.cron 注册行为一致：
- * parse 抛异常或 8 年内无匹配都视为非法，避免启动后才报错）。
- */
-export function isValidCronSchedule(value) {
-    if (!isString(value)) return false;
-
-    try {
-        return Bun.cron.parse(value) !== null;
-    } catch {
-        return false;
-    }
-}
-
-/**
- * 判断值是否为有限整数。
- */
-export function isIntegerNumber(value) {
-    return isNumber(value) && Number.isInteger(value) && Number.isFinite(value);
-}
-
-/**
- * 判断字符串是否为正则字面量（/source/flags）。
- */
-export function isRegexLiteral(input) {
-    const trimmed = String(input || "").trim();
-    if (!isMinLengthString(trimmed, 2)) {
-        return false;
-    }
-    if (!trimmed.startsWith("/")) {
-        return false;
-    }
-
-    const lastSlash = trimmed.lastIndexOf("/");
-    if (lastSlash <= 0) {
-        return false;
-    }
-
-    const flags = trimmed.slice(lastSlash + 1);
-    if (flags !== "" && !/^[gimsuy]+$/.test(flags)) {
-        return false;
-    }
-
-    return true;
-}
-
-/**
- * 判断输入是否为正则规则（字面量或 @ 别名）。
- */
-export function isRegexInput(input) {
-    const trimmed = String(input || "").trim();
-    // 约束：正则 input 仅允许 /source/flags 形式；同时保留 @alias 作为正则别名。
-    // 说明：不再支持直接写 source（如 ^\d+$），避免与普通字符串/枚举产生歧义。
-    return isRegexLiteral(trimmed) || trimmed.startsWith("@");
-}
-
-/**
- * 判断当前进程是否为主进程。
- * bm2 的实例 0 是主进程；未由 bm2 启动时视为主进程。
- */
 export function isPrimaryProcess() {
     const instance = Bun.env.BM2_APP_INSTANCE;
     return instance === "0" || instance === 0 || instance === undefined;
 }
-
-/**
- * 日志敏感键判定
- */
-export function isSensitiveKey(key, matcher) {
-    const lower = String(key).toLowerCase();
-    if (matcher.exactSet.has(lower)) return true;
-
-    for (const part of matcher.contains) {
-        if (lower.includes(part)) return true;
-    }
-
-    return false;
-}

package/utils/response.js

@@ -1,6 +1,16 @@
-import { Logger } from "../lib/logger.js";
+import { Logger } from "#befly/libs/logger/index.js";
+
 import { isString } from "./is.js";
 
+const errorStatus = {
+    parser: 400,
+    validator: 400,
+    auth: 401,
+    permission: 403,
+    method: 405,
+    rateLimit: 429
+};
+
 /**
  * 创建错误响应（专用于 Hook 中间件）
  * 在钩子中提前拦截请求时使用
@@ -39,6 +49,7 @@ export function ErrorResponse(ctx, msg, code = 1, data = null, detail = null, re
             reason: reason
         },
         {
+            status: errorStatus[reason] || 400,
             headers: ctx.corsHeaders
         }
     );

package/utils/scanFiles.js

@@ -1,11 +1,17 @@
 import { existsSync } from "node:fs";
-
-import { relative, normalize, parse, join } from "pathe";
+import { join, normalize, parse, relative } from "node:path";
 
 import { createError } from "./error.js";
 import { importDefault } from "./importDefault.js";
 import { isPlainObject } from "./is.js";
 
+const selectFields = {
+    page: { name: "页码", paramType: "integer", minValue: 1, maxValue: 10000, paramDefault: 1 },
+    limit: { name: "每页数量", paramType: "integer", minValue: 1, maxValue: 100, paramDefault: 20 },
+    keyword: { name: "关键字", paramType: "string", minValue: 0, maxValue: 100, paramDefault: "" },
+    state: { name: "状态", paramType: "integer" }
+};
+
 /**
  * 扫描指定目录下的文件
  * @param dir 目录路径
@@ -28,7 +34,6 @@ export async function scanFiles(dir, source, type, pattern) {
         });
 
         for await (const file of files) {
-            // 使用 pathe.normalize 统一路径分隔符为 /
             const filePath = normalize(file);
             const parsedFile = parse(filePath);
 
@@ -37,7 +42,7 @@ export async function scanFiles(dir, source, type, pattern) {
 
             // 计算相对路径（去除扩展名）
             const parsedRelativePath = parse(relative(dir, filePath));
-            const relativePath = parsedRelativePath.dir ? join(parsedRelativePath.dir, parsedRelativePath.name) : parsedRelativePath.name;
+            const relativePath = (parsedRelativePath.dir ? join(parsedRelativePath.dir, parsedRelativePath.name) : parsedRelativePath.name).replaceAll("\\", "/");
 
             // 固定默认过滤（不可关闭）：忽略下划线开头的文件/目录
             if (relativePath.split("/").some((part) => part.startsWith("_"))) continue;
@@ -64,6 +69,10 @@ export async function scanFiles(dir, source, type, pattern) {
                     base[key] = value;
                 }
             }
+            if (type === "api") {
+                base.category ||= "other";
+                if (base.category === "select") base.fields = { ...selectFields, ...base.fields };
+            }
             results.push(base);
         }
         return results;

package/utils/scanSources.js

@@ -1,3 +1,4 @@
+import { buildTableModel } from "../libs/tableModel.js";
 import {
     //
     coreTableDir,
@@ -14,23 +15,63 @@ import {
 import { createError } from "./error.js";
 import { scanFiles } from "./scanFiles.js";
 
-export const scanSources = async () => {
+export function assertUnique(items, key, label) {
+    const values = new Map();
+    for (const item of items) {
+        const value = item[key];
+        if (!values.has(value)) {
+            values.set(value, item);
+            continue;
+        }
+        const first = values.get(value);
+        throw createError(`${label}冲突：${value}，${first.filePath} 与 ${item.filePath} 不允许同时存在`, {
+            code: "policy",
+            subsystem: "scan",
+            operation: "unique",
+            key: key,
+            value: value
+        });
+    }
+}
+
+export function assertAppApiNamespace(item) {
+    if (item.relativePath.split("/")[0] !== "core") return;
+    throw createError(`app 接口目录下禁止存在 core 一级目录：${item.filePath}`, {
+        code: "policy",
+        subsystem: "scan",
+        operation: "scanSources"
+    });
+}
+
+function addTable(tables, table) {
+    if (tables[table.codeName]) {
+        throw createError(`Table 冲突：${table.codeName}，${tables[table.codeName].fileName} 与 ${table.fileName} 不允许同时存在`, {
+            code: "policy",
+            subsystem: "scan",
+            operation: "unique",
+            key: "codeName",
+            value: table.codeName
+        });
+    }
+    tables[table.codeName] = table;
+}
+
+export async function scanTables({ beflyMode = "auto" } = {}) {
+    const tables = {};
+    const allCoreTables = await scanFiles(coreTableDir, "core", "table", "*.json");
+    for (const item of allCoreTables) addTable(tables, buildTableModel(item.fieldsDef, { source: "core", fileName: item.fileName, beflyMode: beflyMode }));
+    const allAppTables = await scanFiles(appTableDir, "app", "table", "*.json");
+    for (const item of allAppTables) addTable(tables, buildTableModel(item.fieldsDef, { source: "app", fileName: item.fileName, beflyMode: beflyMode }));
+    return tables;
+}
+
+export const scanSources = async ({ beflyMode = "auto" } = {}) => {
     const apis = [];
     const plugins = [];
     const hooks = [];
-    const tables = {};
+    const tables = await scanTables({ beflyMode: beflyMode });
     const corns = [];
 
-    // 处理表格
-    const allCoreTables = await scanFiles(coreTableDir, "core", "table", "*.json");
-    for (const item of allCoreTables) {
-        tables[`befly${item.fileName.charAt(0).toUpperCase()}${item.fileName.slice(1)}`] = item.fieldsDef;
-    }
-    const allAppTables = await scanFiles(appTableDir, "app", "table", "*.json");
-    for (const item of allAppTables) {
-        tables[item.fileName] = item.fieldsDef;
-    }
-
     // 处理插件
     const allCorePlugins = await scanFiles(corePluginDir, "core", "plugin", "*.js");
     for (const item of allCorePlugins) {
@@ -68,17 +109,14 @@ export const scanSources = async () => {
     }
     const allAppApis = await scanFiles(appApiDir, "app", "api", "**/*.js");
     for (const item of allAppApis) {
-        // 禁止 app 接口目录下的 core 一级目录：会与框架内置 /api/core 命名空间冲突，从源头保证 apiPath 唯一
-        if (item.relativePath.split("/")[0] === "core") {
-            throw createError(`app 接口目录下禁止存在 core 一级目录：${item.filePath}`, {
-                code: "policy",
-                subsystem: "scan",
-                operation: "scanSources"
-            });
-        }
+        assertAppApiNamespace(item);
         apis.push(item);
     }
 
+    assertUnique(plugins, "fileName", "Plugin 文件名");
+    assertUnique(hooks, "fileName", "Hook 文件名");
+    assertUnique(corns, "fileName", "Cron 文件名");
+
     return {
         hooks: hooks,
         plugins: plugins,

package/utils/util.js

@@ -1,197 +1,45 @@
-/**
- * 注意：本文件用于集中维护 core 内部通用 utils。
- * - 按项目规范：避免零散小文件噪音；实现集中在本文件，而不是做 re-export 聚合。
- * - 仅在 packages/core 内部使用；core 对外不承诺这些路径导出。
- */
-
 import { createError } from "./error.js";
-import { isPlainObject } from "./is.js";
 
-/**
- * 通用等待工具：轮询直到条件满足或超时（while + sleep 实现，无定时器句柄，无泄漏风险）
- * @param {string} label - 等待说明（用于超时错误信息）
- * @param {Function} check - 异步条件函数，返回 true 表示就绪
- * @param {number} [intervalMs=200] - 轮询间隔（毫秒）
- * @param {number} [timeoutMs=60000] - 超时时间（毫秒）
- */
 export async function waitFor({ label, check, intervalMs = 200, timeoutMs = 60000 }) {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
-        if (await check()) {
-            return;
-        }
+        if (await check()) return;
         await Bun.sleep(intervalMs);
     }
     throw createError(`等待${label}超时`, { code: "runtime", subsystem: "start", operation: "waitFor" });
 }
 
-/**
- * 判断 bigint 是否可安全转换为 number。
- * - 超出安全整数范围则不可转换
- * - 转换后若是科学计数法表示则不可转换
- */
-export function canConvertToNumber(value) {
-    const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
-    const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
-
-    if (value > maxSafe || value < minSafe) {
-        return null;
-    }
-
-    const asNumber = Number(value);
-    if (!Number.isSafeInteger(asNumber)) {
-        return null;
-    }
-
-    const text = String(asNumber);
-    if (text.includes("e") || text.includes("E")) {
-        return null;
-    }
-
-    return asNumber;
-}
-
-/**
- * 获取值的类型标识（数组/对象等做细分）。
- */
 export function getTypeTag(value) {
     if (value === null) return "null";
     if (value === undefined) return "undefined";
     if (Array.isArray(value)) return "array";
-
-    const t = typeof value;
-    if (t === "string") return "string";
-    if (t === "number") return "number";
-    if (t === "boolean") return "boolean";
-    if (t === "bigint") return "bigint";
-    if (t === "symbol") return "symbol";
-    if (t === "function") return "function";
-
-    return "object";
-}
-
-/**
- * 归一化正整数：非法值回退，超出范围裁剪。
- */
-export function normalizePositiveInt(value, fallback, min, max) {
-    if (!Number.isFinite(value)) return fallback;
-    const v = Math.floor(value);
-    if (v < min) return fallback;
-    if (v > max) return max;
-    return v;
+    return typeof value;
 }
 
-// 将字符串拆分为词段（用于 camelCase/snakeCase）
 function toWordParts(input) {
-    const normalized = String(input)
+    return String(input)
         .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
         .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
         .replace(/[^a-zA-Z0-9]+/g, " ")
-        .trim();
-
-    if (normalized.length === 0) {
-        return [];
-    }
-
-    return normalized.split(/\s+/).filter((p) => p.length > 0);
-}
-
-// 首字母大写
-function upperFirst(s) {
-    if (s.length === 0) {
-        return s;
-    }
-    return s.charAt(0).toUpperCase() + s.slice(1);
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
 }
 
-/**
- * 把字符串转为小驼峰。
- * - 主要用于文件名/目录名（例如 my_plugin / my-plugin / my plugin）。
- */
-export function camelCase(input) {
-    const parts = toWordParts(input);
-    if (parts.length === 0) {
-        return "";
-    }
-
-    const firstPart = parts[0];
-    if (!firstPart) {
-        return "";
-    }
-
-    const first = firstPart.toLowerCase();
-    const rest = parts.slice(1).map((p) => upperFirst(p.toLowerCase()));
-    return [first].concat(rest).join("");
-}
-
-/**
- * 把字符串转为 snake_case。
- * - 主要用于表名/字段名（例如 userId -> user_id）。
- */
 export function snakeCase(input) {
-    const parts = toWordParts(input);
-    if (parts.length === 0) {
-        return "";
-    }
-
-    return parts.map((p) => p.toLowerCase()).join("_");
+    return toWordParts(input)
+        .map((part) => part.toLowerCase())
+        .join("_");
 }
 
-/**
- * 对象字段名转下划线
- * @param obj - 源对象
- * @returns 字段名转为下划线格式的新对象
- */
-export const keysToSnake = (obj) => {
-    if (!obj || !isPlainObject(obj)) return obj;
-
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        const snakeKey = snakeCase(key);
-        result[snakeKey] = value;
-    }
-    return result;
-};
-
-/**
- * 获取运行模式（开发/正式的统一判断，仅以 NODE_ENV 为准）
- * - 线上部署（bm2 等）注入 NODE_ENV=production
- * - 本地开发未设置 NODE_ENV，默认 "development"
- */
 export function getRunMode() {
     return Bun.env.NODE_ENV || "development";
 }
 
-/**
- * 将 session 有效天数转换为秒。
- */
 export function toSessionTtlSeconds(ttlDays) {
-    if (typeof ttlDays === "number" && Number.isFinite(ttlDays) && ttlDays > 0) {
-        return Math.floor(ttlDays * 24 * 60 * 60);
-    }
-
-    if (typeof ttlDays === "string") {
-        const parsed = Number(ttlDays.trim());
-        if (Number.isFinite(parsed) && parsed > 0) {
-            return Math.floor(parsed * 24 * 60 * 60);
-        }
-    }
-
-    return 7 * 24 * 60 * 60;
+    return ttlDays * 24 * 60 * 60;
 }
 
-/**
- * 生成短 ID
- * 由时间戳（base36）+ 随机字符组成，约 13 位
- * - 前 8 位：时间戳（可排序）
- * - 后 5 位：随机字符（防冲突）
- * @returns 短 ID 字符串
- */
 export function genShortId() {
-    const timePart = Date.now().toString(36);
-    let rand = "";
-    while (rand.length < 10) {
-        rand = rand + Math.random().toString(36).slice(2);
-    }
-    return timePart + rand.slice(0, 10);
+    return `${Date.now().toString(36)}${crypto.randomUUID().replaceAll("-", "").slice(0, 10)}`;
 }

package/apis/_apis.js

@@ -1,20 +0,0 @@
-export const queryFields = {
-    page: {
-        name: "页码",
-        input: "integer",
-        min: 1,
-        max: 10000
-    },
-    limit: {
-        name: "每页数量",
-        input: "integer",
-        min: 1,
-        max: 100
-    },
-    keyword: {
-        name: "关键字",
-        input: "string",
-        min: 0,
-        max: 100
-    }
-};

package/apis/auth/sendSmsCode.js

@@ -1,24 +0,0 @@
-import adminTable from "#befly/tables/admin.json";
-
-export default {
-    name: "发送短信验证码",
-    method: "POST",
-    body: "none",
-    auth: false,
-    fields: {
-        phone: adminTable.phone
-    },
-    required: ["phone"],
-    handler: async (befly, ctx) => {
-        const code = Math.floor(100000 + Math.random() * 900000).toString();
-
-        if (befly.redis) {
-            const key = `sms_code:${ctx.body.phone}`;
-            await befly.redis.setString(key, code, 300);
-        }
-
-        const isDev = befly.config ? befly.config.runMode === "development" : false;
-
-        return befly.tool.Yes("验证码已发送", isDev ? { code: code } : null);
-    }
-};