befly 3.16.9 → 3.16.11

package/dist/loader/loadApis.js

@@ -1,71 +0,0 @@
-/**
- * API 加载器
- * 负责扫描和加载所有 API 路由（组件、项目）
- */
-import { Logger } from "../lib/logger";
-import { CoreError } from "../types/coreError";
-/**
- * 加载所有 API 路由
- * @param apiItems - scanSources/scanFiles 扫描到的 API 条目数组
- * @returns API 路由映射表
- */
-export async function loadApis(apis) {
-    const apisMap = new Map();
-    for (const api of apis) {
-        try {
-            // B 方案：信任启动期 checkApi 的结构校验，这里只负责把 scanFiles 的结果映射为运行时 ApiRoute。
-            if (api.type !== "api") {
-                continue;
-            }
-            const record = api;
-            const path = record["path"];
-            const route = {
-                name: record["name"],
-                handler: record["handler"],
-                route: path
-            };
-            const method = record["method"];
-            if (typeof method === "string") {
-                const upperMethod = method.toUpperCase();
-                const normalized = upperMethod === "POST,GET" ? "GET,POST" : upperMethod;
-                route.method = ["GET", "POST", "GET,POST"].includes(normalized) ? normalized : "POST";
-            }
-            else {
-                route.method = "POST";
-            }
-            const auth = record["auth"];
-            if (auth !== undefined) {
-                route.auth = auth;
-            }
-            const fields = record["fields"];
-            if (fields !== undefined) {
-                route.fields = fields;
-            }
-            const required = record["required"];
-            if (required !== undefined) {
-                route.required = required;
-            }
-            const rawBody = record["rawBody"];
-            if (rawBody !== undefined) {
-                route.rawBody = rawBody;
-            }
-            apisMap.set(path, route);
-        }
-        catch (error) {
-            Logger.error({ err: error, api: api.relativePath, file: api.filePath, msg: "接口加载失败" });
-            throw new CoreError({
-                kind: "runtime",
-                message: "接口加载失败",
-                logged: true,
-                cause: error,
-                meta: {
-                    subsystem: "api",
-                    operation: "load",
-                    relativePath: api.relativePath,
-                    filePath: api.filePath
-                }
-            });
-        }
-    }
-    return apisMap;
-}

package/dist/loader/loadHooks.d.ts

@@ -1,7 +0,0 @@
-/**
- * 钩子加载器
- * 默认加载所有来源钩子（core/addon/app）
- */
-import type { Hook } from "../types/hook";
-import type { ScanFileResult } from "../utils/scanFiles";
-export declare function loadHooks(hooks: ScanFileResult[]): Promise<Hook[]>;

package/dist/loader/loadHooks.js

@@ -1,50 +0,0 @@
-/**
- * 钩子加载器
- * 默认加载所有来源钩子（core/addon/app）
- */
-import { CoreError } from "../types/coreError";
-import { sortModules } from "../utils/sortModules";
-export async function loadHooks(hooks) {
-    const hooksMap = [];
-    const enabledHooks = hooks.filter((item) => {
-        const moduleName = item.moduleName;
-        if (typeof moduleName !== "string" || moduleName.trim() === "") {
-            return false;
-        }
-        // enable=false 表示禁用（替代 disableHooks 列表）。
-        // enable 仅允许 boolean；缺失 enable 的默认值应在 checkHook 阶段被补全为 true。
-        const enable = Object.hasOwn(item, "enable") ? item.enable : undefined;
-        if (enable === false) {
-            return false;
-        }
-        return true;
-    });
-    const sortedHooks = sortModules(enabledHooks, { moduleLabel: "钩子" });
-    if (sortedHooks === false) {
-        // 依赖图的细节错误已由 sortModules(Logger.error) 输出。
-        // 这里抛出策略类错误即可，避免入口再打印一份重复堆栈。
-        throw new CoreError({ message: "钩子依赖关系错误", kind: "policy", logged: true });
-    }
-    for (const item of sortedHooks) {
-        const hookName = item.moduleName;
-        const depsRaw = Object.hasOwn(item, "deps") ? item.deps : undefined;
-        const deps = Array.isArray(depsRaw) ? depsRaw.filter((x) => typeof x === "string") : [];
-        const handlerRaw = Object.hasOwn(item, "handler") ? item.handler : undefined;
-        if (typeof handlerRaw !== "function") {
-            throw new CoreError({
-                kind: "validation",
-                message: `Hook '${hookName}' handler 必须是函数`,
-                noLog: true,
-                meta: { subsystem: "hook", operation: "load", hook: hookName }
-            });
-        }
-        const handler = handlerRaw;
-        hooksMap.push({
-            name: hookName,
-            enable: true,
-            deps: deps,
-            handler: handler
-        });
-    }
-    return hooksMap;
-}

package/dist/loader/loadPlugins.d.ts

@@ -1,8 +0,0 @@
-/**
- * 插件加载器
- * 负责扫描和初始化所有插件（核心、组件、项目）
- */
-import type { BeflyContext } from "../types/befly";
-import type { Plugin } from "../types/plugin";
-import type { ScanFileResult } from "../utils/scanFiles";
-export declare function loadPlugins(plugins: ScanFileResult[], context: BeflyContext): Promise<Plugin[]>;

package/dist/loader/loadPlugins.js

@@ -1,69 +0,0 @@
-/**
- * 插件加载器
- * 负责扫描和初始化所有插件（核心、组件、项目）
- */
-import { Logger } from "../lib/logger";
-import { CoreError } from "../types/coreError";
-import { sortModules } from "../utils/sortModules";
-export async function loadPlugins(plugins, context) {
-    const pluginsMap = [];
-    const enabledPlugins = plugins.filter((item) => {
-        const moduleName = item.moduleName;
-        if (typeof moduleName !== "string" || moduleName.trim() === "") {
-            return false;
-        }
-        // enable=false 表示禁用（替代 disablePlugins 列表）。
-        // enable 仅允许 boolean；缺失 enable 的默认值应在 checkPlugin 阶段被补全为 true。
-        const enable = Object.hasOwn(item, "enable") ? item.enable : undefined;
-        if (enable === false) {
-            return false;
-        }
-        return true;
-    });
-    const sortedPlugins = sortModules(enabledPlugins, { moduleLabel: "插件" });
-    if (sortedPlugins === false) {
-        // 依赖图的细节错误已由 sortModules(Logger.error) 输出。
-        // 这里抛出策略类错误即可，避免入口再打印一份重复堆栈。
-        throw new CoreError({ message: "插件依赖关系错误", kind: "policy", logged: true });
-    }
-    for (const item of sortedPlugins) {
-        const pluginName = item.moduleName;
-        const depsRaw = Object.hasOwn(item, "deps") ? item.deps : undefined;
-        const deps = Array.isArray(depsRaw) ? depsRaw.filter((x) => typeof x === "string") : [];
-        const handlerRaw = Object.hasOwn(item, "handler") ? item.handler : undefined;
-        if (typeof handlerRaw !== "function") {
-            throw new CoreError({
-                kind: "validation",
-                message: `插件 '${pluginName}' handler 必须是函数`,
-                noLog: true,
-                meta: { subsystem: "plugin", operation: "load", plugin: pluginName }
-            });
-        }
-        const handler = handlerRaw;
-        try {
-            const pluginInstance = await handler(context);
-            context[pluginName] = pluginInstance;
-            pluginsMap.push({
-                name: pluginName,
-                enable: true,
-                deps: deps,
-                handler: handler
-            });
-        }
-        catch (error) {
-            Logger.error({ err: error, plugin: pluginName, msg: "插件初始化失败" });
-            throw new CoreError({
-                kind: "runtime",
-                message: `插件初始化失败: ${pluginName}`,
-                logged: true,
-                cause: error,
-                meta: {
-                    subsystem: "plugin",
-                    operation: "init",
-                    plugin: pluginName
-                }
-            });
-        }
-    }
-    return pluginsMap;
-}

package/dist/paths.d.ts

@@ -1,93 +0,0 @@
-/**
- * Befly 框架路径配置
- *
- * 提供统一的路径常量，供整个框架使用
- * 所有路径常量采用具名导出方式，避免通过对象访问
- *
- * 路径分类：
- * - root* 系列：Core 框架内部路径（packages/core/*）
- * - app* 系列：用户项目路径（process.cwd()/*）
- *
- */
-/**
- * Core 框架根目录
- * @description packages/core/
- */
-export declare const coreDir: string;
-/**
- * Core 框架 dist 目录
- * @description 源码态为 packages/core/dist；dist 运行态为 packages/core/dist
- */
-export declare const coreDistDir: string;
-/**
- * Core 框架检查目录
- * @description packages/core/checks/
- * @usage 存放启动检查模块（返回 boolean 的 default 函数）
- */
-export declare const coreCheckDir: string;
-/**
- * Core 框架插件目录
- * @description packages/core/plugins/
- * @usage 存放内置插件（db, logger, redis, tool 等）
- */
-export declare const corePluginDir: string;
-/**
- * Core 框架钩子目录
- * @description packages/core/hooks/
- * @usage 存放内置钩子（auth, cors, parser 等）
- */
-export declare const coreHookDir: string;
-/**
- * Core 框架 API 目录
- * @description packages/core/apis/
- * @usage 存放框架级别的 API 接口
- */
-export declare const coreApiDir: string;
-/**
- * Core 框架表定义目录
- * @description packages/core/tables/
- * @usage 存放框架核心表定义（JSON 格式）
- */
-export declare const coreTableDir: string;
-/**
- * 项目根目录
- * @description process.cwd()
- * @usage 用户项目的根目录
- */
-export declare const appDir: string;
-/**
- * 项目检查目录
- * @description {appDir}/checks/
- * @usage 存放用户自定义启动检查模块
- */
-export declare const appCheckDir: string;
-/**
- * 项目插件目录
- * @description {appDir}/plugins/
- * @usage 存放用户自定义插件
- */
-export declare const appPluginDir: string;
-/**
- * 项目钩子目录
- * @description {appDir}/hooks/
- * @usage 存放用户自定义钩子
- */
-export declare const appHookDir: string;
-/**
- * 项目 API 目录
- * @description {appDir}/apis/
- * @usage 存放用户业务 API 接口
- */
-export declare const appApiDir: string;
-/**
- * 项目表定义目录
- * @description {appDir}/tables/
- * @usage 存放用户业务表定义（JSON 格式）
- */
-export declare const appTableDir: string;
-/**
- * 项目组件目录
- * @description {appDir}/addons/
- * @usage 存放本地组件（优先级高于 node_modules 中的组件）
- */
-export declare const appAddonsDir: string;

package/dist/paths.js

@@ -1,100 +0,0 @@
-/**
- * Befly 框架路径配置
- *
- * 提供统一的路径常量，供整个框架使用
- * 所有路径常量采用具名导出方式，避免通过对象访问
- *
- * 路径分类：
- * - root* 系列：Core 框架内部路径（packages/core/*）
- * - app* 系列：用户项目路径（process.cwd()/*）
- *
- */
-import { fileURLToPath } from "node:url";
-import { dirname, join, normalize } from "pathe";
-// 当前文件的路径信息
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// ==================== Core 框架路径 ====================
-/**
- * Core 框架根目录
- * @description packages/core/
- */
-export const coreDir = __dirname;
-/**
- * Core 框架 dist 目录
- * @description 源码态为 packages/core/dist；dist 运行态为 packages/core/dist
- */
-export const coreDistDir = normalize(__dirname).endsWith("/dist") ? __dirname : join(__dirname, "dist");
-/**
- * Core 框架检查目录
- * @description packages/core/checks/
- * @usage 存放启动检查模块（返回 boolean 的 default 函数）
- */
-export const coreCheckDir = join(__dirname, "checks");
-/**
- * Core 框架插件目录
- * @description packages/core/plugins/
- * @usage 存放内置插件（db, logger, redis, tool 等）
- */
-export const corePluginDir = join(__dirname, "plugins");
-/**
- * Core 框架钩子目录
- * @description packages/core/hooks/
- * @usage 存放内置钩子（auth, cors, parser 等）
- */
-export const coreHookDir = join(__dirname, "hooks");
-/**
- * Core 框架 API 目录
- * @description packages/core/apis/
- * @usage 存放框架级别的 API 接口
- */
-export const coreApiDir = join(__dirname, "apis");
-/**
- * Core 框架表定义目录
- * @description packages/core/tables/
- * @usage 存放框架核心表定义（JSON 格式）
- */
-export const coreTableDir = join(__dirname, "tables");
-// ==================== 用户项目路径 ====================
-/**
- * 项目根目录
- * @description process.cwd()
- * @usage 用户项目的根目录
- */
-export const appDir = process.cwd();
-/**
- * 项目检查目录
- * @description {appDir}/checks/
- * @usage 存放用户自定义启动检查模块
- */
-export const appCheckDir = join(appDir, "checks");
-/**
- * 项目插件目录
- * @description {appDir}/plugins/
- * @usage 存放用户自定义插件
- */
-export const appPluginDir = join(appDir, "plugins");
-/**
- * 项目钩子目录
- * @description {appDir}/hooks/
- * @usage 存放用户自定义钩子
- */
-export const appHookDir = join(appDir, "hooks");
-/**
- * 项目 API 目录
- * @description {appDir}/apis/
- * @usage 存放用户业务 API 接口
- */
-export const appApiDir = join(appDir, "apis");
-/**
- * 项目表定义目录
- * @description {appDir}/tables/
- * @usage 存放用户业务表定义（JSON 格式）
- */
-export const appTableDir = join(appDir, "tables");
-/**
- * 项目组件目录
- * @description {appDir}/addons/
- * @usage 存放本地组件（优先级高于 node_modules 中的组件）
- */
-export const appAddonsDir = join(appDir, "addons");

package/dist/plugins/cache.d.ts

@@ -1,10 +0,0 @@
-/**
- * 缓存插件 - TypeScript 版本
- * 负责在服务器启动时缓存接口、菜单和角色权限到 Redis
- */
-import type { Plugin } from "../types/plugin";
-/**
- * 缓存插件
- */
-declare const cachePlugin: Plugin;
-export default cachePlugin;

package/dist/plugins/cache.js

@@ -1,24 +0,0 @@
-/**
- * 缓存插件 - TypeScript 版本
- * 负责在服务器启动时缓存接口、菜单和角色权限到 Redis
- */
-import { CacheHelper } from "../lib/cacheHelper";
-import { CoreError } from "../types/coreError";
-/**
- * 缓存插件
- */
-const cachePlugin = {
-    name: "cache",
-    enable: true,
-    deps: ["logger", "redis", "db"],
-    async handler(befly) {
-        if (!befly.db) {
-            throw new CoreError({ message: "缓存初始化失败：ctx.db 未初始化", kind: "validation" });
-        }
-        if (!befly.redis) {
-            throw new CoreError({ message: "缓存初始化失败：ctx.redis 未初始化", kind: "validation" });
-        }
-        return new CacheHelper({ db: befly.db, redis: befly.redis });
-    }
-};
-export default cachePlugin;

package/dist/plugins/cipher.d.ts

@@ -1,7 +0,0 @@
-/**
- * Cipher 插件
- * 提供加密解密功能
- */
-import type { Plugin } from "../types/plugin";
-declare const cipherPlugin: Plugin;
-export default cipherPlugin;

package/dist/plugins/cipher.js

@@ -1,14 +0,0 @@
-/**
- * Cipher 插件
- * 提供加密解密功能
- */
-import { Cipher } from "../lib/cipher";
-const cipherPlugin = {
-    name: "cipher",
-    enable: true,
-    deps: [],
-    handler: () => {
-        return Cipher;
-    }
-};
-export default cipherPlugin;

package/dist/plugins/config.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from "../types/plugin";
-declare const configPlugin: Plugin;
-export default configPlugin;

package/dist/plugins/config.js

@@ -1,9 +0,0 @@
-const configPlugin = {
-    name: "config",
-    enable: true,
-    deps: [],
-    handler: (befly) => {
-        return befly.config;
-    }
-};
-export default configPlugin;

package/dist/plugins/db.d.ts

@@ -1,10 +0,0 @@
-/**
- * 数据库插件
- * 初始化数据库连接和 SQL 管理器
- */
-import type { Plugin } from "../types/plugin";
-/**
- * 数据库插件
- */
-declare const dbPlugin: Plugin;
-export default dbPlugin;

package/dist/plugins/db.js

@@ -1,48 +0,0 @@
-/**
- * 数据库插件
- * 初始化数据库连接和 SQL 管理器
- */
-import { Connect } from "../lib/connect";
-import { DbHelper } from "../lib/dbHelper";
-import { Logger } from "../lib/logger";
-import { CoreError } from "../types/coreError";
-/**
- * 数据库插件
- */
-const dbPlugin = {
-    name: "db",
-    enable: true,
-    deps: ["logger", "redis"],
-    async handler(befly) {
-        const env = befly.config?.nodeEnv;
-        const dbName = String(befly.config?.db?.database || "");
-        if (!dbName) {
-            throw new CoreError({ message: "数据库初始化失败：befly.config.db.database 缺失", kind: "validation" });
-        }
-        if (!befly.redis) {
-            throw new CoreError({ message: "Redis 未初始化", kind: "validation" });
-        }
-        try {
-            const sql = Connect.getSql();
-            const idMode = befly.config?.db?.idMode;
-            const normalizedIdMode = idMode === "autoId" ? "autoId" : "timeId";
-            // 创建数据库管理器实例
-            const dbManager = new DbHelper({ redis: befly.redis, dbName: dbName, sql: sql, idMode: normalizedIdMode });
-            return dbManager;
-        }
-        catch (error) {
-            Logger.error({ env: env, err: error, msg: "数据库初始化失败" });
-            throw new CoreError({
-                kind: "runtime",
-                message: "数据库初始化失败",
-                logged: true,
-                cause: error,
-                meta: {
-                    subsystem: "db",
-                    operation: "init"
-                }
-            });
-        }
-    }
-};
-export default dbPlugin;

package/dist/plugins/jwt.d.ts

@@ -1,6 +0,0 @@
-/**
- * JWT 插件
- */
-import type { Plugin } from "../types/plugin";
-declare const jwtPlugin: Plugin;
-export default jwtPlugin;

package/dist/plugins/jwt.js

@@ -1,13 +0,0 @@
-/**
- * JWT 插件
- */
-import { Jwt } from "../lib/jwt";
-const jwtPlugin = {
-    name: "jwt",
-    enable: true,
-    deps: [],
-    handler: (context) => {
-        return new Jwt(context.config ? context.config.auth : undefined);
-    }
-};
-export default jwtPlugin;

package/dist/plugins/logger.d.ts

@@ -1,10 +0,0 @@
-/**
- * 日志插件
- * 提供全局日志功能
- */
-import type { Plugin } from "../types/plugin";
-/**
- * 日志插件
- */
-declare const loggerPlugin: Plugin;
-export default loggerPlugin;

package/dist/plugins/logger.js

@@ -1,21 +0,0 @@
-/**
- * 日志插件
- * 提供全局日志功能
- */
-import { Logger } from "../lib/logger";
-/**
- * 日志插件
- */
-const loggerPlugin = {
-    name: "logger",
-    enable: true,
-    deps: [],
-    async handler(befly) {
-        // 配置 Logger
-        if (befly.config && befly.config.logger) {
-            Logger.configure(befly.config.logger);
-        }
-        return Logger;
-    }
-};
-export default loggerPlugin;

package/dist/plugins/redis.d.ts

@@ -1,10 +0,0 @@
-/**
- * Redis 插件
- * 初始化 Redis 连接和助手工具
- */
-import type { Plugin } from "../types/plugin";
-/**
- * Redis 插件
- */
-declare const redisPlugin: Plugin;
-export default redisPlugin;

package/dist/plugins/redis.js

@@ -1,40 +0,0 @@
-/**
- * Redis 插件
- * 初始化 Redis 连接和助手工具
- */
-import { Connect } from "../lib/connect";
-import { Logger } from "../lib/logger";
-import { RedisHelper } from "../lib/redisHelper";
-import { CoreError } from "../types/coreError";
-/**
- * Redis 插件
- */
-const redisPlugin = {
-    name: "redis",
-    enable: true,
-    deps: ["logger"],
-    async handler(befly) {
-        const env = befly.config?.nodeEnv;
-        const redisPrefix = befly.config?.redis?.prefix;
-        try {
-            // 启动期已建立 Redis 连接；这里仅校验连接存在
-            Connect.getRedis();
-            // 返回 RedisHelper 实例
-            return new RedisHelper(redisPrefix);
-        }
-        catch (error) {
-            Logger.error({ env: env, err: error, msg: "Redis 初始化失败" });
-            throw new CoreError({
-                kind: "runtime",
-                message: "Redis 初始化失败",
-                logged: true,
-                cause: error,
-                meta: {
-                    subsystem: "redis",
-                    operation: "init"
-                }
-            });
-        }
-    }
-};
-export default redisPlugin;