befly 3.16.9 → 3.16.11

package/dist/configs/presetRegexp.d.ts

@@ -1,145 +0,0 @@
-/**
- * 内置正则表达式别名
- * 用于表单验证和数据校验
- * 命名规范：小驼峰格式
- */
-export declare const RegexAliases: {
-    /** 正整数（不含0） */
-    readonly number: "^\\d+$";
-    /** 整数（含负数） */
-    readonly integer: "^-?\\d+$";
-    /** 浮点数 */
-    readonly float: "^-?\\d+(\\.\\d+)?$";
-    /** 正整数（不含0） */
-    readonly positive: "^[1-9]\\d*$";
-    /** 负整数 */
-    readonly negative: "^-\\d+$";
-    /** 零 */
-    readonly zero: "^0$";
-    /** 纯字母 */
-    readonly word: "^[a-zA-Z]+$";
-    /** 字母和数字 */
-    readonly alphanumeric: "^[a-zA-Z0-9]+$";
-    /** 字母、数字和下划线 */
-    readonly alphanumeric_: "^[a-zA-Z0-9_]+$";
-    /** 字母、数字、下划线和短横线 */
-    readonly alphanumericDash_: "^[a-zA-Z0-9_-]+$";
-    /** 小写字母 */
-    readonly lowercase: "^[a-z]+$";
-    /** 大写字母 */
-    readonly uppercase: "^[A-Z]+$";
-    /** 纯中文 */
-    readonly chinese: "^[\\u4e00-\\u9fa5]+$";
-    /** 中文和字母 */
-    readonly chineseWord: "^[\\u4e00-\\u9fa5a-zA-Z]+$";
-    /** 邮箱地址 */
-    readonly email: "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$";
-    /** 中国大陆手机号 */
-    readonly phone: "^1[3-9]\\d{9}$";
-    /** 固定电话（区号-号码） */
-    readonly telephone: "^0\\d{2,3}-?\\d{7,8}$";
-    /** URL 地址 */
-    readonly url: "^https?://";
-    /** IPv4 地址 */
-    readonly ip: "^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$";
-    /** IPv6 地址 */
-    readonly ipv6: "^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$";
-    /** 域名 */
-    readonly domain: "^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}$";
-    /** UUID */
-    readonly uuid: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
-    /** 十六进制字符串 */
-    readonly hex: "^[0-9a-fA-F]+$";
-    /** Base64 编码 */
-    readonly base64: "^[A-Za-z0-9+/=]+$";
-    /** MD5 哈希 */
-    readonly md5: "^[a-f0-9]{32}$";
-    /** SHA1 哈希 */
-    readonly sha1: "^[a-f0-9]{40}$";
-    /** SHA256 哈希 */
-    readonly sha256: "^[a-f0-9]{64}$";
-    /** 日期 YYYY-MM-DD */
-    readonly date: "^\\d{4}-\\d{2}-\\d{2}$";
-    /** 时间 HH:MM:SS */
-    readonly time: "^\\d{2}:\\d{2}:\\d{2}$";
-    /** ISO 日期时间 */
-    readonly datetime: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}";
-    /** 年份 */
-    readonly year: "^\\d{4}$";
-    /** 月份 01-12 */
-    readonly month: "^(0[1-9]|1[0-2])$";
-    /** 日期 01-31 */
-    readonly day: "^(0[1-9]|[12]\\d|3[01])$";
-    /** 变量名 */
-    readonly variable: "^[a-zA-Z_][a-zA-Z0-9_]*$";
-    /** 常量名（全大写） */
-    readonly constant: "^[A-Z][A-Z0-9_]*$";
-    /** 包名（小写+连字符） */
-    readonly package: "^[a-z][a-z0-9-]*$";
-    /** 中国身份证号（18位） */
-    readonly idCard: "^\\d{17}[\\dXx]$";
-    /** 护照号 */
-    readonly passport: "^[a-zA-Z0-9]{5,17}$";
-    /** 银行卡号（16-19位数字） */
-    readonly bankCard: "^\\d{16,19}$";
-    /** 微信号（6-20位，字母开头，可包含字母、数字、下划线、减号） */
-    readonly wechat: "^[a-zA-Z][a-zA-Z0-9_-]{5,19}$";
-    /** QQ号（5-11位数字，首位非0） */
-    readonly qq: "^[1-9]\\d{4,10}$";
-    /** 支付宝账号（手机号或邮箱） */
-    readonly alipay: "^(1[3-9]\\d{9}|[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})$";
-    /** 用户名（4-20位，字母开头，可包含字母、数字、下划线） */
-    readonly username: "^[a-zA-Z][a-zA-Z0-9_]{3,19}$";
-    /** 昵称（2-20位，支持中文、字母、数字） */
-    readonly nickname: "^[\\u4e00-\\u9fa5a-zA-Z0-9]{2,20}$";
-    /** 弱密码（至少6位） */
-    readonly passwordWeak: "^.{6,}$";
-    /** 中等密码（至少8位，包含字母和数字） */
-    readonly passwordMedium: "^(?=.*[a-zA-Z])(?=.*\\d).{8,}$";
-    /** 强密码（至少8位，包含大小写字母、数字和特殊字符） */
-    readonly passwordStrong: "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[!@#$%^&*]).{8,}$";
-    /** 车牌号（新能源+普通） */
-    readonly licensePlate: "^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z][A-HJ-NP-Z0-9]{4,5}[A-HJ-NP-Z0-9挂学警港澳]$";
-    /** 邮政编码 */
-    readonly postalCode: "^\\d{6}$";
-    /** 版本号（语义化版本） */
-    readonly semver: "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$";
-    /** 颜色值（十六进制） */
-    readonly colorHex: "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$";
-    /** 空字符串 */
-    readonly empty: "^$";
-    /** 非空 */
-    readonly notempty: ".+";
-};
-/**
- * 正则别名类型
- */
-export type RegexAliasName = keyof typeof RegexAliases;
-/**
- * 获取正则表达式字符串
- * @param name 正则别名（以 @ 开头）或自定义正则字符串
- * @returns 正则表达式字符串
- */
-export declare function getRegex(name: string): string;
-/**
- * 获取编译后的正则表达式对象（带缓存）
- * @param pattern 正则别名或正则字符串
- * @param flags 正则标志（如 'i', 'g'）
- * @returns 编译后的 RegExp 对象
- */
-export declare function getCompiledRegex(pattern: string, flags?: string): RegExp;
-/**
- * 验证值是否匹配正则（使用缓存）
- * @param value 要验证的值
- * @param pattern 正则别名或正则字符串
- * @returns 是否匹配
- */
-export declare function matchRegex(value: string, pattern: string): boolean;
-/**
- * 清除正则缓存
- */
-export declare function clearRegexCache(): void;
-/**
- * 获取缓存大小
- */
-export declare function getRegexCacheSize(): number;

package/dist/configs/presetRegexp.js

@@ -1,218 +0,0 @@
-/**
- * 内置正则表达式别名
- * 用于表单验证和数据校验
- * 命名规范：小驼峰格式
- */
-export const RegexAliases = {
-    // ============================================
-    // 数字类型
-    // ============================================
-    /** 正整数（不含0） */
-    number: "^\\d+$",
-    /** 整数（含负数） */
-    integer: "^-?\\d+$",
-    /** 浮点数 */
-    float: "^-?\\d+(\\.\\d+)?$",
-    /** 正整数（不含0） */
-    positive: "^[1-9]\\d*$",
-    /** 负整数 */
-    negative: "^-\\d+$",
-    /** 零 */
-    zero: "^0$",
-    // ============================================
-    // 字符串类型
-    // ============================================
-    /** 纯字母 */
-    word: "^[a-zA-Z]+$",
-    /** 字母和数字 */
-    alphanumeric: "^[a-zA-Z0-9]+$",
-    /** 字母、数字和下划线 */
-    alphanumeric_: "^[a-zA-Z0-9_]+$",
-    /** 字母、数字、下划线和短横线 */
-    alphanumericDash_: "^[a-zA-Z0-9_-]+$",
-    /** 小写字母 */
-    lowercase: "^[a-z]+$",
-    /** 大写字母 */
-    uppercase: "^[A-Z]+$",
-    // ============================================
-    // 中文
-    // ============================================
-    /** 纯中文 */
-    chinese: "^[\\u4e00-\\u9fa5]+$",
-    /** 中文和字母 */
-    chineseWord: "^[\\u4e00-\\u9fa5a-zA-Z]+$",
-    // ============================================
-    // 常用格式
-    // ============================================
-    /** 邮箱地址 */
-    email: "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
-    /** 中国大陆手机号 */
-    phone: "^1[3-9]\\d{9}$",
-    /** 固定电话（区号-号码） */
-    telephone: "^0\\d{2,3}-?\\d{7,8}$",
-    /** URL 地址 */
-    url: "^https?://",
-    /** IPv4 地址 */
-    ip: "^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$",
-    /** IPv6 地址 */
-    ipv6: "^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$",
-    /** 域名 */
-    domain: "^(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+[a-zA-Z]{2,}$",
-    // ============================================
-    // 特殊格式
-    // ============================================
-    /** UUID */
-    uuid: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
-    /** 十六进制字符串 */
-    hex: "^[0-9a-fA-F]+$",
-    /** Base64 编码 */
-    base64: "^[A-Za-z0-9+/=]+$",
-    /** MD5 哈希 */
-    md5: "^[a-f0-9]{32}$",
-    /** SHA1 哈希 */
-    sha1: "^[a-f0-9]{40}$",
-    /** SHA256 哈希 */
-    sha256: "^[a-f0-9]{64}$",
-    // ============================================
-    // 日期时间
-    // ============================================
-    /** 日期 YYYY-MM-DD */
-    date: "^\\d{4}-\\d{2}-\\d{2}$",
-    /** 时间 HH:MM:SS */
-    time: "^\\d{2}:\\d{2}:\\d{2}$",
-    /** ISO 日期时间 */
-    datetime: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}",
-    /** 年份 */
-    year: "^\\d{4}$",
-    /** 月份 01-12 */
-    month: "^(0[1-9]|1[0-2])$",
-    /** 日期 01-31 */
-    day: "^(0[1-9]|[12]\\d|3[01])$",
-    // ============================================
-    // 代码相关
-    // ============================================
-    /** 变量名 */
-    variable: "^[a-zA-Z_][a-zA-Z0-9_]*$",
-    /** 常量名（全大写） */
-    constant: "^[A-Z][A-Z0-9_]*$",
-    /** 包名（小写+连字符） */
-    package: "^[a-z][a-z0-9-]*$",
-    // ============================================
-    // 证件相关
-    // ============================================
-    /** 中国身份证号（18位） */
-    idCard: "^\\d{17}[\\dXx]$",
-    /** 护照号 */
-    passport: "^[a-zA-Z0-9]{5,17}$",
-    // ============================================
-    // 账号相关（国内常用）
-    // ============================================
-    /** 银行卡号（16-19位数字） */
-    bankCard: "^\\d{16,19}$",
-    /** 微信号（6-20位，字母开头，可包含字母、数字、下划线、减号） */
-    wechat: "^[a-zA-Z][a-zA-Z0-9_-]{5,19}$",
-    /** QQ号（5-11位数字，首位非0） */
-    qq: "^[1-9]\\d{4,10}$",
-    /** 支付宝账号（手机号或邮箱） */
-    alipay: "^(1[3-9]\\d{9}|[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})$",
-    /** 用户名（4-20位，字母开头，可包含字母、数字、下划线） */
-    username: "^[a-zA-Z][a-zA-Z0-9_]{3,19}$",
-    /** 昵称（2-20位，支持中文、字母、数字） */
-    nickname: "^[\\u4e00-\\u9fa5a-zA-Z0-9]{2,20}$",
-    // ============================================
-    // 密码强度
-    // ============================================
-    /** 弱密码（至少6位） */
-    passwordWeak: "^.{6,}$",
-    /** 中等密码（至少8位，包含字母和数字） */
-    passwordMedium: "^(?=.*[a-zA-Z])(?=.*\\d).{8,}$",
-    /** 强密码（至少8位，包含大小写字母、数字和特殊字符） */
-    passwordStrong: "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[!@#$%^&*]).{8,}$",
-    // ============================================
-    // 其他常用
-    // ============================================
-    /** 车牌号（新能源+普通） */
-    licensePlate: "^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z][A-HJ-NP-Z0-9]{4,5}[A-HJ-NP-Z0-9挂学警港澳]$",
-    /** 邮政编码 */
-    postalCode: "^\\d{6}$",
-    /** 版本号（语义化版本） */
-    semver: "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$",
-    /** 颜色值（十六进制） */
-    colorHex: "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
-    // ============================================
-    // 空值
-    // ============================================
-    /** 空字符串 */
-    empty: "^$",
-    /** 非空 */
-    notempty: ".+"
-};
-// ============================================
-// 正则表达式缓存（性能优化）
-// ============================================
-const regexCache = new Map();
-/**
- * 获取正则表达式字符串
- * @param name 正则别名（以 @ 开头）或自定义正则字符串
- * @returns 正则表达式字符串
- */
-export function getRegex(name) {
-    if (name.startsWith("@")) {
-        const alias = name.slice(1);
-        return RegexAliases[alias] || name;
-    }
-    return name;
-}
-function parseRegexLiteral(pattern) {
-    const trimmed = String(pattern || "").trim();
-    if (trimmed.length < 2)
-        return null;
-    if (!trimmed.startsWith("/"))
-        return null;
-    const lastSlash = trimmed.lastIndexOf("/");
-    if (lastSlash <= 0)
-        return null;
-    const flags = trimmed.slice(lastSlash + 1);
-    if (flags !== "" && !/^[gimsuy]+$/.test(flags))
-        return null;
-    return { source: trimmed.slice(1, lastSlash), flags: flags };
-}
-/**
- * 获取编译后的正则表达式对象（带缓存）
- * @param pattern 正则别名或正则字符串
- * @param flags 正则标志（如 'i', 'g'）
- * @returns 编译后的 RegExp 对象
- */
-export function getCompiledRegex(pattern, flags) {
-    const literal = parseRegexLiteral(pattern);
-    const regexStr = literal ? literal.source : getRegex(pattern);
-    const useFlags = literal && literal.flags !== "" ? literal.flags : flags || "";
-    const cacheKey = `${regexStr}:${useFlags}`;
-    let cached = regexCache.get(cacheKey);
-    if (!cached) {
-        cached = new RegExp(regexStr, useFlags);
-        regexCache.set(cacheKey, cached);
-    }
-    return cached;
-}
-/**
- * 验证值是否匹配正则（使用缓存）
- * @param value 要验证的值
- * @param pattern 正则别名或正则字符串
- * @returns 是否匹配
- */
-export function matchRegex(value, pattern) {
-    return getCompiledRegex(pattern).test(value);
-}
-/**
- * 清除正则缓存
- */
-export function clearRegexCache() {
-    regexCache.clear();
-}
-/**
- * 获取缓存大小
- */
-export function getRegexCacheSize() {
-    return regexCache.size;
-}

package/dist/hooks/auth.d.ts

@@ -1,3 +0,0 @@
-import type { Hook } from "../types/hook";
-declare const authHook: Hook;
-export default authHook;

package/dist/hooks/auth.js

@@ -1,24 +0,0 @@
-import { setCtxUser } from "../lib/asyncContext";
-const authHook = {
-    name: "auth",
-    enable: true,
-    deps: ["cors"],
-    handler: async (befly, ctx) => {
-        const authHeader = ctx.req.headers.get("authorization");
-        if (authHeader && authHeader.startsWith("Bearer ")) {
-            const token = authHeader.substring(7);
-            try {
-                const payload = await befly.jwt.verify(token);
-                ctx.user = payload;
-                setCtxUser(payload.id, payload.roleCode, payload.nickname, payload.roleType);
-            }
-            catch {
-                ctx.user = {};
-            }
-        }
-        else {
-            ctx.user = {};
-        }
-    }
-};
-export default authHook;

package/dist/hooks/cors.d.ts

@@ -1,7 +0,0 @@
-import type { Hook } from "../types/hook";
-/**
- * CORS 跨域处理钩子
- * 设置跨域响应头并处理 OPTIONS 预检请求
- */
-declare const corsHook: Hook;
-export default corsHook;

package/dist/hooks/cors.js

@@ -1,36 +0,0 @@
-// 相对导入
-import { setCorsOptions } from "../utils/cors";
-/**
- * CORS 跨域处理钩子
- * 设置跨域响应头并处理 OPTIONS 预检请求
- */
-const corsHook = {
-    name: "cors",
-    enable: true,
-    deps: [],
-    handler: async (befly, ctx) => {
-        const req = ctx.req;
-        // 合并默认配置和用户配置
-        const defaultConfig = {
-            origin: "*",
-            methods: "GET, POST, OPTIONS",
-            allowedHeaders: "Content-Type, Authorization, authorization, token",
-            exposedHeaders: "Content-Range, X-Content-Range, Authorization, authorization, token",
-            maxAge: 86400,
-            credentials: "true"
-        };
-        const corsConfig = Object.assign({}, defaultConfig, befly.config && befly.config.cors ? befly.config.cors : {});
-        // 设置 CORS 响应头
-        const headers = setCorsOptions(req, corsConfig);
-        ctx.corsHeaders = headers;
-        // 处理 OPTIONS 预检请求
-        if (req.method === "OPTIONS") {
-            ctx.response = new Response(null, {
-                status: 204,
-                headers: headers
-            });
-            return;
-        }
-    }
-};
-export default corsHook;

package/dist/hooks/parser.d.ts

@@ -1,10 +0,0 @@
-import type { Hook } from "../types/hook";
-/**
- * 请求参数解析钩子
- * - GET 请求：解析 URL 查询参数
- * - POST 请求：解析 JSON 或 XML 请求体
- * - 仅负责解析与合并参数；字段过滤/映射/校验由 validator hook 处理
- * - rawBody: true 时跳过解析，由 handler 自行处理原始请求
- */
-declare const parserHook: Hook;
-export default parserHook;

package/dist/hooks/parser.js

@@ -1,76 +0,0 @@
-// 外部依赖
-import { XMLParser } from "fast-xml-parser";
-import { ErrorResponse } from "../utils/response";
-const xmlParser = new XMLParser();
-/**
- * 请求参数解析钩子
- * - GET 请求：解析 URL 查询参数
- * - POST 请求：解析 JSON 或 XML 请求体
- * - 仅负责解析与合并参数；字段过滤/映射/校验由 validator hook 处理
- * - rawBody: true 时跳过解析，由 handler 自行处理原始请求
- */
-const parserHook = {
-    name: "parser",
-    enable: true,
-    deps: ["auth"],
-    handler: async (befly, ctx) => {
-        if (!ctx.api)
-            return;
-        // rawBody 模式：跳过解析，保留原始请求供 handler 自行处理
-        // 适用于：微信回调、支付回调、webhook 等需要手动解密/验签的场景
-        if (ctx.api.rawBody) {
-            ctx.body = {};
-            return;
-        }
-        // GET 请求：解析查询参数
-        if (ctx.req.method === "GET") {
-            const url = new URL(ctx.req.url);
-            const params = Object.fromEntries(url.searchParams);
-            ctx.body = params;
-        }
-        else if (ctx.req.method === "POST") {
-            // POST 请求：解析请求体
-            const contentType = ctx.req.headers.get("content-type") || "";
-            // 获取 URL 查询参数（POST 请求也可能带参数）
-            const url = new URL(ctx.req.url);
-            const queryParams = Object.fromEntries(url.searchParams);
-            try {
-                // JSON 格式
-                if (contentType.includes("application/json")) {
-                    const body = (await ctx.req.json());
-                    // 合并 URL 参数和请求体（请求体优先）
-                    const merged = { ...queryParams, ...body };
-                    ctx.body = merged;
-                }
-                else if (contentType.includes("application/xml") || contentType.includes("text/xml")) {
-                    // XML 格式
-                    const text = await ctx.req.text();
-                    const parsed = xmlParser.parse(text);
-                    // 提取根节点内容（如 xml），使 body 扁平化
-                    const rootKey = Object.keys(parsed)[0];
-                    const body = rootKey && typeof parsed[rootKey] === "object" ? parsed[rootKey] : parsed;
-                    // 合并 URL 参数和请求体（请求体优先）
-                    const merged = { ...queryParams, ...body };
-                    ctx.body = merged;
-                }
-                else {
-                    // 不支持的 Content-Type
-                    ctx.response = ErrorResponse(ctx, "无效的请求参数格式", 1, null, {
-                        location: "content-type",
-                        value: contentType
-                    }, "parser");
-                    return;
-                }
-            }
-            catch {
-                // 解析失败：属于客户端输入错误，返回安全 detail（不回传异常栈/原始 body）
-                ctx.response = ErrorResponse(ctx, "无效的请求参数格式", 1, null, {
-                    location: "body",
-                    reason: contentType.includes("application/json") ? "invalid_json" : contentType.includes("xml") ? "invalid_xml" : "invalid_body"
-                }, "parser");
-                return;
-            }
-        }
-    }
-};
-export default parserHook;

package/dist/hooks/permission.d.ts

@@ -1,10 +0,0 @@
-import type { Hook } from "../types/hook";
-/**
- * 权限检查钩子
- * - 接口无需权限（auth=false）：直接通过
- * - 用户未登录：返回 401
- * - 开发者角色（dev）：最高权限，直接通过
- * - 其他角色：检查 Redis 中的角色权限集合
- */
-declare const permissionHook: Hook;
-export default permissionHook;

package/dist/hooks/permission.js

@@ -1,64 +0,0 @@
-import { CacheKeys } from "../lib/cacheKeys";
-import { Logger } from "../lib/logger";
-// 相对导入
-import { ErrorResponse } from "../utils/response";
-/**
- * 权限检查钩子
- * - 接口无需权限（auth=false）：直接通过
- * - 用户未登录：返回 401
- * - 开发者角色（dev）：最高权限，直接通过
- * - 其他角色：检查 Redis 中的角色权限集合
- */
-const permissionHook = {
-    name: "permission",
-    enable: true,
-    deps: ["validator"],
-    handler: async (befly, ctx) => {
-        if (!ctx.api)
-            return;
-        // 1. 接口无需权限
-        if (ctx.api.auth === false) {
-            return;
-        }
-        // 2. 用户未登录
-        if (typeof ctx.user.id !== "number") {
-            ctx.response = ErrorResponse(ctx, "未登录", 1, null, null, "auth");
-            return;
-        }
-        // 3. 开发者权限（最高权限）
-        if (ctx.user.roleCode === "dev") {
-            return;
-        }
-        // 4. 角色权限检查
-        // apiPath 在 apiHandler 中已统一生成并写入 ctx.route
-        const apiPath = ctx.route;
-        const roleCode = ctx.user.roleCode;
-        let hasPermission = false;
-        if (roleCode && befly.redis) {
-            try {
-                // 极简方案：每个角色一个 Set，直接判断成员是否存在
-                const roleApisKey = CacheKeys.roleApis(roleCode);
-                hasPermission = await befly.redis.sismember(roleApisKey, apiPath);
-            }
-            catch (err) {
-                // Redis 异常：记录到 error 日志文件（不回传给客户端），并降级为拒绝访问
-                Logger.error({
-                    event: "hook_permission_redis_error",
-                    apiPath: apiPath,
-                    roleCode: roleCode,
-                    err: err,
-                    msg: "hook permission redis error"
-                });
-                hasPermission = false;
-            }
-        }
-        if (!hasPermission) {
-            const apiNameLabel = typeof ctx.api.name === "string" && ctx.api.name.length > 0 ? ctx.api.name : null;
-            const apiPathLabel = typeof apiPath === "string" && apiPath.length > 0 ? apiPath : null;
-            const apiLabel = apiNameLabel ? apiNameLabel : apiPathLabel ? apiPathLabel : "未知接口";
-            ctx.response = ErrorResponse(ctx, `无权访问 ${apiLabel} 接口`, 1, null, { apiLabel: apiLabel }, "permission");
-            return;
-        }
-    }
-};
-export default permissionHook;

package/dist/hooks/validator.d.ts

@@ -1,7 +0,0 @@
-import type { Hook } from "../types/hook";
-/**
- * 参数验证钩子
- * 根据 API 定义的 fields 和 required 验证请求参数
- */
-declare const validatorHook: Hook;
-export default validatorHook;

package/dist/hooks/validator.js

@@ -1,52 +0,0 @@
-// 相对导入
-import { Validator } from "../lib/validator";
-import { normalizeFieldDefinition } from "../utils/normalizeFieldDefinition";
-import { ErrorResponse } from "../utils/response";
-import { isPlainObject, snakeCase } from "../utils/util";
-/**
- * 参数验证钩子
- * 根据 API 定义的 fields 和 required 验证请求参数
- */
-const validatorHook = {
-    name: "validator",
-    enable: true,
-    deps: ["parser"],
-    handler: async (befly, ctx) => {
-        if (!ctx.api)
-            return;
-        // 无需验证
-        if (!ctx.api.fields) {
-            return;
-        }
-        // 仅保留 fields 中声明的字段，并支持 snake_case 入参回退（例如 agent_id -> agentId）；同时在同一次遍历中应用默认值
-        if (isPlainObject(ctx.api.fields)) {
-            const rawBody = isPlainObject(ctx.body) ? ctx.body : {};
-            const nextBody = {};
-            for (const [field, fieldDef] of Object.entries(ctx.api.fields)) {
-                const normalized = normalizeFieldDefinition(fieldDef);
-                let value = rawBody[field];
-                if (value === undefined) {
-                    const snakeField = snakeCase(field);
-                    if (rawBody[snakeField] !== undefined) {
-                        value = rawBody[snakeField];
-                    }
-                }
-                // 字段未传值且定义了默认值时，应用默认值
-                if (value === undefined && normalized.default !== null) {
-                    value = normalized.default;
-                }
-                if (value !== undefined) {
-                    nextBody[field] = value;
-                }
-            }
-            ctx.body = nextBody;
-        }
-        // 验证参数
-        const result = Validator.validate(ctx.body, ctx.api.fields, ctx.api.required || []);
-        if (result.code !== 0) {
-            ctx.response = ErrorResponse(ctx, result.firstError || "参数验证失败", 1, null, result.fieldErrors, "validator");
-            return;
-        }
-    }
-};
-export default validatorHook;