befly 3.10.18 → 3.11.1

package/checks/checkPlugin.ts

@@ -1,48 +0,0 @@
-import { isPlainObject } from "es-toolkit/compat";
-import { omit } from "es-toolkit/object";
-
-import { Logger } from "../lib/logger.ts";
-
-export async function checkPlugin(plugins: any[]): Promise<void> {
-    let hasError = false;
-
-    for (const plugin of plugins) {
-        try {
-            if (!isPlainObject(plugin)) {
-                Logger.warn(omit(plugin, ["handler"]), "插件导出必须是对象（export default { deps, handler }）");
-                hasError = true;
-                continue;
-            }
-
-            if (!Array.isArray((plugin as any).deps)) {
-                Logger.warn(omit(plugin, ["handler"]), "插件的 deps 属性必须是字符串数组");
-                hasError = true;
-                continue;
-            }
-
-            if ((plugin as any).deps.some((depItem: any) => typeof depItem !== "string")) {
-                Logger.warn(omit(plugin, ["handler"]), "插件的 deps 属性必须是字符串数组");
-                hasError = true;
-            }
-
-            if (typeof (plugin as any).handler !== "function") {
-                Logger.warn(omit(plugin, ["handler"]), "插件的 handler 属性必须是函数");
-                hasError = true;
-                continue;
-            }
-        } catch (error: any) {
-            Logger.error(
-                {
-                    err: error,
-                    item: plugin
-                },
-                "插件解析失败"
-            );
-            hasError = true;
-        }
-    }
-
-    if (hasError) {
-        throw new Error("插件结构检查失败");
-    }
-}

package/configs/presetRegexp.ts

@@ -1,225 +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: ".+"
-} as const;
-
-/**
- * 正则别名类型
- */
-export type RegexAliasName = keyof typeof RegexAliases;
-
-// ============================================
-// 正则表达式缓存（性能优化）
-// ============================================
-const regexCache = new Map<string, RegExp>();
-
-/**
- * 获取正则表达式字符串
- * @param name 正则别名（以 @ 开头）或自定义正则字符串
- * @returns 正则表达式字符串
- */
-export function getRegex(name: string): string {
-    if (name.startsWith("@")) {
-        const alias = name.slice(1) as RegexAliasName;
-        return RegexAliases[alias] || name;
-    }
-    return name;
-}
-
-/**
- * 获取编译后的正则表达式对象（带缓存）
- * @param pattern 正则别名或正则字符串
- * @param flags 正则标志（如 'i', 'g'）
- * @returns 编译后的 RegExp 对象
- */
-export function getCompiledRegex(pattern: string, flags?: string): RegExp {
-    const regexStr = getRegex(pattern);
-    const cacheKey = `${regexStr}:${flags || ""}`;
-
-    let cached = regexCache.get(cacheKey);
-    if (!cached) {
-        cached = new RegExp(regexStr, flags);
-        regexCache.set(cacheKey, cached);
-    }
-    return cached;
-}
-
-/**
- * 验证值是否匹配正则（使用缓存）
- * @param value 要验证的值
- * @param pattern 正则别名或正则字符串
- * @returns 是否匹配
- */
-export function matchRegex(value: string, pattern: string): boolean {
-    return getCompiledRegex(pattern).test(value);
-}
-
-/**
- * 清除正则缓存
- */
-export function clearRegexCache(): void {
-    regexCache.clear();
-}
-
-/**
- * 获取缓存大小
- */
-export function getRegexCacheSize(): number {
-    return regexCache.size;
-}

package/docs/README.md

@@ -1,98 +0,0 @@
-# Befly Core 文档
-
-> Befly 是基于 Bun 的高性能 API 框架
-
-## 文档原则
-
-- 文档只描述**当前实现**：不提供迁移指引、不保留兼容说明、不出现“已迁移/跳转页/占位页”。
-- 如文档与代码行为不一致：**以代码为准**，应直接修正文档。
-- 规则以“可执行/可验证”为标准：给出明确约束（例如 pathname-only、严格校验规则），避免含糊表述。
-
-## 快速开始
-
-- [Quickstart 快速入门](./guide/quickstart.md) - 5 分钟搭建第一个 API 服务
-
-## 核心概念
-
-| 文档                                     | 说明                                                                  |
-| ---------------------------------------- | --------------------------------------------------------------------- |
-| [API 开发](./api/api.md)                 | API 定义、字段验证、权限控制（[强约束清单](./api/api.md#强约束清单)） |
-| [Table 表结构](./reference/table.md)     | JSON 表定义格式、字段类型                                             |
-| [Database 数据库](./plugins/database.md) | CRUD 操作、事务、批量操作                                             |
-| [Config 配置](./reference/config.md)     | 配置文件、环境分离                                                    |
-
-## 扩展开发
-
-| 文档                                 | 说明           |
-| ------------------------------------ | -------------- |
-| [Plugin 插件](./plugins/plugin.md)   | 自定义插件开发 |
-| [Hook 钩子](./hooks/hook.md)         | 请求处理钩子   |
-| [Addon 插件包](./reference/addon.md) | 可复用功能模块 |
-
-常用内置 Hook：
-
-- [cors Hook](./hooks/cors.md)
-- [auth Hook](./hooks/auth.md)
-- [parser Hook](./hooks/parser.md)
-- [rateLimit Hook](./hooks/rateLimit.md)
-
-## 工具系统
-
-| 文档                                       | 说明               |
-| ------------------------------------------ | ------------------ |
-| [Validator 验证](./reference/validator.md) | 参数验证、正则别名 |
-| [Logger 日志](./reference/logger.md)       | 日志系统配置       |
-| [Cipher 加密](./plugins/cipher.md)         | 哈希、签名、JWT    |
-| [Redis 缓存](./infra/redis.md)             | Redis 操作         |
-
-## 命令工具
-
-| 文档                             | 说明                                                                  |
-| -------------------------------- | --------------------------------------------------------------------- |
-| [Sync 同步](./reference/sync.md) | 数据库、API、菜单同步（[强约束清单](./reference/sync.md#强约束清单)） |
-
-## 实战示例
-
-- [Examples 实战示例](./guide/examples.md) - 用户管理、文章管理、文件上传完整示例
-
-## 文档索引
-
-### 入门篇
-
-1. **[Quickstart](./guide/quickstart.md)** - 环境准备、项目创建、第一个 API
-
-### 开发篇
-
-2. **[API](./api/api.md)** - API 路由定义、字段验证、权限控制、响应格式（[强约束清单](./api/api.md#强约束清单)）
-3. **[Table](./reference/table.md)** - 表定义格式、字段类型、系统字段、命名规范
-4. **[Database](./plugins/database.md)** - 数据库连接、CRUD 操作、事务处理、批量操作
-5. **[Config](./reference/config.md)** - 配置文件结构、环境分离、运行时配置
-
-### 扩展篇
-
-6. **[Plugin](./plugins/plugin.md)** - 插件生命周期、依赖管理、内置插件
-7. **[Hook](./hooks/hook.md)** - 钩子执行顺序、洋葱模型、内置钩子
-8. **[Addon](./reference/addon.md)** - Addon 结构、创建发布、命名规范
-
-### 工具篇
-
-9. **[Validator](./reference/validator.md)** - 验证规则、类型转换、正则别名
-10. **[Logger](./reference/logger.md)** - 日志级别、文件轮转、测试 Mock
-11. **[Cipher](./plugins/cipher.md)** - 哈希算法、HMAC 签名、密码加密、JWT 令牌
-12. **[Redis](./infra/redis.md)** - 缓存操作、键值存储、过期管理
-
-### 运维篇
-
-13. **[Sync](./reference/sync.md)** - syncTable、syncApi、syncMenu、syncDev、syncCache（[强约束清单](./reference/sync.md#强约束清单)）
-
-## 常用链接
-
-- [GitHub](https://github.com/chenbimo/befly)
-- [npm](https://www.npmjs.com/package/befly)
-
-## 版本信息
-
-- Befly Core: 1.x
-- 运行时: Bun >= 1.0
-- 数据库: MySQL >= 8.0
-- 缓存: Redis >= 6.0