befly 3.77.1 → 3.77.2

package/apis/admin/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "系统管理"
+}

package/apis/api/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "接口管理"
+}

package/apis/auth/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "认证登录"
+}

package/apis/dashboard/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "仪表盘"
+}

package/apis/dict/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "字典项"
+}

package/apis/dictType/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "字典类型"
+}

package/apis/email/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "邮件"
+}

package/apis/loginLog/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "登录日志"
+}

package/apis/menu/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "菜单"
+}

package/apis/operateLog/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "操作日志"
+}

package/apis/role/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "角色"
+}

package/apis/source/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "资源"
+}

package/apis/tongJi/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "数据统计"
+}

package/apis/upload/_meta.json

@@ -0,0 +1,3 @@
+{
+    "title": "上传"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.77.1",
+    "version": "3.77.2",
     "gitHead": "49c39d36695036e85fc64083cc43c1652fff96cb",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 JavaScript API 接口框架核心引擎",

package/utils/scanFiles.js

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import { join, normalize, parse, relative } from "node:path";
 
 import { createError } from "./error.js";
@@ -13,14 +13,14 @@ const selectFields = {
 };
 
 /**
- * 扫描接口目录下的 _meta.js 目录元数据（约定：_ 前缀文件不注册路由）。
+ * 扫描接口目录下的 _meta.json 目录元数据（约定：_ 前缀文件不注册路由）。
  * 返回 Map<目录 apiPath, 中文标题>，键与接口 apiPath 的目录部分对齐，供 scanSources 挂载 parentTitle。
  */
 export async function scanApiMetaTitles(dir, source) {
     const titles = new Map();
     if (!existsSync(dir)) return titles;
 
-    const glob = new Bun.Glob("**/_meta.js");
+    const glob = new Bun.Glob("**/_meta.json");
     const files = await Array.fromAsync(
         glob.scan({
             cwd: dir,
@@ -119,3 +119,23 @@ export async function scanFiles(dir, source, type, pattern) {
         throw createError(`扫描失败: source=${source} type=${type} dir=${dir} pattern=${pattern}`, { cause: error, code: "runtime" });
     }
 }
+
+// 枚举接口目录下全部子目录（任意深度，跳过 _ 前缀段），返回目录 apiPath 集合，
+// 供启动校验"每个目录必须有 _meta.js"使用
+export function scanApiDirPaths(dir, source) {
+    const result = new Set();
+    if (!existsSync(dir)) return result;
+    const prefix = source === "core" ? "/api/core/" : "/api/";
+
+    function collect(current, relativeDir) {
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            if (!entry.isDirectory() || entry.name.startsWith("_")) continue;
+            const childRelative = relativeDir ? `${relativeDir}/${entry.name}` : entry.name;
+            result.add(`${prefix}${childRelative}`);
+            collect(join(current, entry.name), childRelative);
+        }
+    }
+
+    collect(dir, "");
+    return result;
+}

package/utils/scanSources.js

@@ -16,11 +16,11 @@ import {
     appCornDir
 } from "../paths.js";
 import { createError } from "./error.js";
-import { scanApiMetaTitles, scanFiles } from "./scanFiles.js";
+import { scanApiDirPaths, scanApiMetaTitles, scanFiles } from "./scanFiles.js";
 
 // 逐级拼接目录显示标题：每级目录有 _meta.js 标题用标题，没有用目录名，以 / 连接
 // 例：/api/admin/product/insert + 标题映射 -> "后台管理/product"
-export function composeTitlePath(apiPath, metaTitles, missingCollector) {
+export function composeTitlePath(apiPath, metaTitles) {
     const segments = apiPath.split("/").filter(Boolean);
     const start = segments[1] === "core" ? 2 : 1;
     const dirs = segments.slice(start, -1);
@@ -30,13 +30,7 @@ export function composeTitlePath(apiPath, metaTitles, missingCollector) {
     let current = `/${segments.slice(0, start).join("/")}`;
     for (const dir of dirs) {
         current = `${current}/${dir}`;
-        const title = metaTitles.get(current);
-        if (title) {
-            parts.push(title);
-        } else {
-            parts.push(dir);
-            if (missingCollector) missingCollector.add(current);
-        }
+        parts.push(metaTitles.get(current) || dir);
     }
     return parts.join("/");
 }
@@ -142,23 +136,36 @@ export const scanSources = async ({ beflyMode = "auto" } = {}) => {
         corns.push(item);
     }
 
-    // 处理接口（读取目录 _meta.js 标题挂载 parentTitle）；
-    // 每一级接口目录都必须有中文标题，缺失即启动失败并列出清单
-    const [allCoreApis, coreMetaTitles, allAppApis, appMetaTitles] = await Promise.all([scanFiles(coreApiDir, "core", "api", "**/*.js"), scanApiMetaTitles(coreApiDir, "core"), scanFiles(appApiDir, "app", "api", "**/*.js"), scanApiMetaTitles(appApiDir, "app")]);
+    // 处理接口（读取目录 _meta.js 标题挂载 parentTitle）
+    const [allCoreApis, coreMetaTitles, coreDirPaths, allAppApis, appMetaTitles, appDirPaths] = await Promise.all([
+        scanFiles(coreApiDir, "core", "api", "**/*.js"),
+        scanApiMetaTitles(coreApiDir, "core"),
+        scanApiDirPaths(coreApiDir, "core"),
+        scanFiles(appApiDir, "app", "api", "**/*.js"),
+        scanApiMetaTitles(appApiDir, "app"),
+        scanApiDirPaths(appApiDir, "app")
+    ]);
 
-    const missingTitleDirs = new Set();
     for (const item of allCoreApis) {
-        item.parentTitle = composeTitlePath(item.apiPath, coreMetaTitles, missingTitleDirs);
+        item.parentTitle = composeTitlePath(item.apiPath, coreMetaTitles);
         apis.push(item);
     }
     for (const item of allAppApis) {
         assertAppApiNamespace(item);
-        item.parentTitle = composeTitlePath(item.apiPath, appMetaTitles, missingTitleDirs);
+        item.parentTitle = composeTitlePath(item.apiPath, appMetaTitles);
         apis.push(item);
     }
 
+    // 每个接口目录（含空目录，_ 前缀隔离目录除外）都必须有 _meta.js 中文标题
+    const missingTitleDirs = new Set();
+    for (const dirPath of coreDirPaths) {
+        if (!coreMetaTitles.has(dirPath)) missingTitleDirs.add(dirPath);
+    }
+    for (const dirPath of appDirPaths) {
+        if (!appMetaTitles.has(dirPath)) missingTitleDirs.add(dirPath);
+    }
     if (missingTitleDirs.size > 0) {
-        throw createError(`以下接口目录缺少 _meta.js 中文标题：${Array.from(missingTitleDirs).toSorted().join("、")}`, {
+        throw createError(`以下接口目录缺少 _meta.json 中文标题：${Array.from(missingTitleDirs).toSorted().join("、")}`, {
             code: "policy",
             subsystem: "scan",
             operation: "scanSources"

package/apis/admin/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "系统管理"
-};

package/apis/api/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "接口管理"
-};

package/apis/auth/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "认证登录"
-};

package/apis/dashboard/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "仪表盘"
-};

package/apis/dict/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "字典项"
-};

package/apis/dictType/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "字典类型"
-};

package/apis/email/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "邮件"
-};

package/apis/loginLog/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "登录日志"
-};

package/apis/menu/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "菜单"
-};

package/apis/operateLog/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "操作日志"
-};

package/apis/role/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "角色"
-};

package/apis/source/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "资源"
-};

package/apis/tongJi/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "数据统计"
-};

package/apis/upload/_meta.js

@@ -1,3 +0,0 @@
-export default {
-    title: "上传"
-};