befly 3.10.17 → 3.10.19

package/{utils/isDirentDirectory.ts → dist/utils/isDirentDirectory.js}

@@ -1,23 +1,18 @@
-import type { Dirent } from "node:fs";
-
 import { statSync } from "node:fs";
-
 import { join } from "pathe";
-
-export const isDirentDirectory = (parentDir: string, entry: Dirent): boolean => {
+export const isDirentDirectory = (parentDir, entry) => {
     if (entry.isDirectory()) {
         return true;
     }
-
     // 兼容 Windows 下的 junction / workspace link：Dirent.isDirectory() 可能为 false，但它实际指向目录。
     if (!entry.isSymbolicLink()) {
         return false;
     }
-
     try {
         const stats = statSync(join(parentDir, entry.name));
         return stats.isDirectory();
-    } catch {
+    }
+    catch {
         return false;
     }
 };

package/dist/utils/keysToCamel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 对象字段名转小驼峰
+ * @param obj - 源对象
+ * @returns 字段名转为小驼峰格式的新对象
+ *
+ * @example
+ * keysToCamel({ user_id: 123, user_name: 'John' }) // { userId: 123, userName: 'John' }
+ * keysToCamel({ created_at: 1697452800000 }) // { createdAt: 1697452800000 }
+ */
+export declare const keysToCamel: <T = any>(obj: Record<string, any>) => T;

package/{utils/keysToCamel.ts → dist/utils/keysToCamel.js}

@@ -1,6 +1,5 @@
 import { isPlainObject } from "es-toolkit/compat";
 import { camelCase } from "es-toolkit/string";
-
 /**
  * 对象字段名转小驼峰
  * @param obj - 源对象
@@ -10,10 +9,10 @@ import { camelCase } from "es-toolkit/string";
  * keysToCamel({ user_id: 123, user_name: 'John' }) // { userId: 123, userName: 'John' }
  * keysToCamel({ created_at: 1697452800000 }) // { createdAt: 1697452800000 }
  */
-export const keysToCamel = <T = any>(obj: Record<string, any>): T => {
-    if (!obj || !isPlainObject(obj)) return obj as T;
-
-    const result: any = {};
+export const keysToCamel = (obj) => {
+    if (!obj || !isPlainObject(obj))
+        return obj;
+    const result = {};
     for (const [key, value] of Object.entries(obj)) {
         const camelKey = camelCase(key);
         result[camelKey] = value;

package/dist/utils/keysToSnake.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 对象字段名转下划线
+ * @param obj - 源对象
+ * @returns 字段名转为下划线格式的新对象
+ *
+ * @example
+ * keysToSnake({ userId: 123, userName: 'John' }) // { user_id: 123, user_name: 'John' }
+ * keysToSnake({ createdAt: 1697452800000 }) // { created_at: 1697452800000 }
+ */
+export declare const keysToSnake: <T = any>(obj: Record<string, any>) => T;

package/{utils/keysToSnake.ts → dist/utils/keysToSnake.js}

@@ -1,6 +1,5 @@
 import { isPlainObject } from "es-toolkit/compat";
 import { snakeCase } from "es-toolkit/string";
-
 /**
  * 对象字段名转下划线
  * @param obj - 源对象
@@ -10,10 +9,10 @@ import { snakeCase } from "es-toolkit/string";
  * keysToSnake({ userId: 123, userName: 'John' }) // { user_id: 123, user_name: 'John' }
  * keysToSnake({ createdAt: 1697452800000 }) // { created_at: 1697452800000 }
  */
-export const keysToSnake = <T = any>(obj: Record<string, any>): T => {
-    if (!obj || !isPlainObject(obj)) return obj as T;
-
-    const result: any = {};
+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;

package/dist/utils/loadMenuConfigs.d.ts

@@ -0,0 +1,5 @@
+import type { MenuConfig } from "../types/sync.ts";
+import type { AddonInfo } from "./scanAddons.ts";
+export declare function scanViewsDirToMenuConfigs(viewsDir: string, prefix: string, parentPath?: string): Promise<MenuConfig[]>;
+export declare function getParentPath(path: string): string;
+export declare function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]>;

package/{utils/loadMenuConfigs.ts → dist/utils/loadMenuConfigs.js}

@@ -1,90 +1,69 @@
-import type { MenuConfig } from "../types/sync.js";
-import type { AddonInfo } from "./scanAddons.js";
-import type { ViewDirMeta } from "befly-shared/utils/scanViewsDir";
-
 import { existsSync } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
-
 import { cleanDirName, extractDefinePageMetaFromScriptSetup, extractScriptSetupBlock } from "befly-shared/utils/scanViewsDir";
 import { join } from "pathe";
-
 import { Logger } from "../lib/logger.js";
 import { isDirentDirectory } from "./isDirentDirectory.js";
-
-export async function scanViewsDirToMenuConfigs(viewsDir: string, prefix: string, parentPath: string = ""): Promise<MenuConfig[]> {
+export async function scanViewsDirToMenuConfigs(viewsDir, prefix, parentPath = "") {
     if (!existsSync(viewsDir)) {
         return [];
     }
-
-    const menus: MenuConfig[] = [];
+    const menus = [];
     const entries = await readdir(viewsDir, { withFileTypes: true });
-
     for (const entry of entries) {
         if (!isDirentDirectory(viewsDir, entry) || entry.name === "components") {
             continue;
         }
-
         const dirPath = join(viewsDir, entry.name);
         const indexVuePath = join(dirPath, "index.vue");
-
         if (!existsSync(indexVuePath)) {
             continue;
         }
-
-        let meta: ViewDirMeta | null = null;
+        let meta = null;
         try {
             const content = await readFile(indexVuePath, "utf-8");
-
             const scriptSetup = extractScriptSetupBlock(content);
             if (!scriptSetup) {
                 Logger.warn({ path: indexVuePath }, "index.vue 缺少 <script setup>，已跳过该目录菜单同步");
                 continue;
             }
-
             meta = extractDefinePageMetaFromScriptSetup(scriptSetup);
             if (!meta?.title) {
                 Logger.warn({ path: indexVuePath }, "index.vue 未声明 definePage({ meta: { title, order? } })，已跳过该目录菜单同步");
                 continue;
             }
-        } catch (error: any) {
+        }
+        catch (error) {
             Logger.warn({ err: error, path: indexVuePath }, "读取 index.vue 失败");
             continue;
         }
-
         if (!meta?.title) {
             continue;
         }
-
         const cleanName = cleanDirName(entry.name);
-        let menuPath: string;
+        let menuPath;
         if (cleanName === "index") {
             menuPath = parentPath;
-        } else {
+        }
+        else {
             menuPath = parentPath ? `${parentPath}/${cleanName}` : `/${cleanName}`;
         }
-
         const fullPath = prefix ? (menuPath ? `${prefix}${menuPath}` : prefix) : menuPath || "/";
-
-        const menu: MenuConfig = {
+        const menu = {
             name: meta.title,
             path: fullPath,
             sort: meta.order ?? 999999
         };
-
         const children = await scanViewsDirToMenuConfigs(dirPath, prefix, menuPath);
         if (children.length > 0) {
             menu.children = children;
         }
-
         menus.push(menu);
     }
-
     menus.sort((a, b) => (a.sort ?? 999999) - (b.sort ?? 999999));
-
     return menus;
 }
-
-export function getParentPath(path: string): string {
+export function getParentPath(path) {
     // "/a/b" => "/a"
     // "/a" => ""
     const parts = path.split("/").filter((p) => !!p);
@@ -93,10 +72,8 @@ export function getParentPath(path: string): string {
     }
     return `/${parts.slice(0, -1).join("/")}`;
 }
-
-export async function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]> {
-    const allMenus: MenuConfig[] = [];
-
+export async function loadMenuConfigs(addons) {
+    const allMenus = [];
     for (const addon of addons) {
         const adminViewsDirByTopLevel = join(addon.fullPath, "adminViews");
         const adminViewsDirByViews = join(addon.fullPath, "views", "admin");
@@ -104,7 +81,6 @@ export async function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]
         if (!adminViewsDir) {
             continue;
         }
-
         try {
             const prefix = `/${addon.source}/${addon.name}`;
             const menus = await scanViewsDirToMenuConfigs(adminViewsDir, prefix);
@@ -113,19 +89,16 @@ export async function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]
                     allMenus.push(menu);
                 }
             }
-        } catch (error: any) {
-            Logger.warn(
-                {
-                    err: error,
-                    addon: addon.name,
-                    addonSource: addon.source,
-                    dir: adminViewsDir
-                },
-                "扫描 addon views 目录失败"
-            );
+        }
+        catch (error) {
+            Logger.warn({
+                err: error,
+                addon: addon.name,
+                addonSource: addon.source,
+                dir: adminViewsDir
+            }, "扫描 addon views 目录失败");
         }
     }
-
     const menusJsonPath = join(process.cwd(), "menus.json");
     if (existsSync(menusJsonPath)) {
         try {
@@ -136,10 +109,10 @@ export async function loadMenuConfigs(addons: AddonInfo[]): Promise<MenuConfig[]
                     allMenus.push(menu);
                 }
             }
-        } catch (error: any) {
+        }
+        catch (error) {
             Logger.warn({ err: error }, "读取项目 menus.json 失败");
         }
     }
-
     return allMenus;
 }

package/dist/utils/pickFields.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 挑选指定字段
+ */
+export declare const pickFields: <T extends Record<string, any>>(obj: T, keys: string[]) => Partial<T>;

package/{utils/pickFields.ts → dist/utils/pickFields.js}

@@ -1,19 +1,16 @@
 import { isPlainObject } from "es-toolkit/compat";
-
 /**
  * 挑选指定字段
  */
-export const pickFields = <T extends Record<string, any>>(obj: T, keys: string[]): Partial<T> => {
+export const pickFields = (obj, keys) => {
     if (!obj || (!isPlainObject(obj) && !Array.isArray(obj))) {
         return {};
     }
-
-    const result: any = {};
+    const result = {};
     for (const key of keys) {
         if (key in obj) {
             result[key] = obj[key];
         }
     }
-
     return result;
 };

package/dist/utils/process.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 进程角色信息
+ */
+export interface ProcessRole {
+    /** 进程角色：primary（主进程）或 worker（工作进程） */
+    role: "primary" | "worker";
+    /** 实例 ID（PM2 或 Bun Worker） */
+    instanceId: string | null;
+    /** 运行环境：bun-cluster、pm2-cluster 或 standalone */
+    env: "bun-cluster" | "pm2-cluster" | "standalone";
+}
+/**
+ * 获取当前进程角色信息
+ * @returns 进程角色、实例 ID 和运行环境
+ */
+export declare function getProcessRole(): ProcessRole;
+/**
+ * 检测当前进程是否为主进程
+ * 用于集群模式下避免重复执行同步任务
+ * - Bun 集群：BUN_WORKER_ID 为空时是主进程
+ * - PM2 集群：PM2_INSTANCE_ID 为 '0' 或不存在时是主进程
+ * @returns 是否为主进程
+ */
+export declare function isPrimaryProcess(): boolean;

package/{utils/process.ts → dist/utils/process.js}

@@ -1,23 +1,10 @@
-/**
- * 进程角色信息
- */
-export interface ProcessRole {
-    /** 进程角色：primary（主进程）或 worker（工作进程） */
-    role: "primary" | "worker";
-    /** 实例 ID（PM2 或 Bun Worker） */
-    instanceId: string | null;
-    /** 运行环境：bun-cluster、pm2-cluster 或 standalone */
-    env: "bun-cluster" | "pm2-cluster" | "standalone";
-}
-
 /**
  * 获取当前进程角色信息
  * @returns 进程角色、实例 ID 和运行环境
  */
-export function getProcessRole(): ProcessRole {
+export function getProcessRole() {
     const bunWorkerId = process.env.BUN_WORKER_ID;
     const pm2InstanceId = process.env.PM2_INSTANCE_ID;
-
     // Bun 集群模式
     if (bunWorkerId !== undefined) {
         return {
@@ -26,7 +13,6 @@ export function getProcessRole(): ProcessRole {
             env: "bun-cluster"
         };
     }
-
     // PM2 集群模式
     if (pm2InstanceId !== undefined) {
         return {
@@ -35,7 +21,6 @@ export function getProcessRole(): ProcessRole {
             env: "pm2-cluster"
         };
     }
-
     // 单进程模式
     return {
         role: "primary",
@@ -43,7 +28,6 @@ export function getProcessRole(): ProcessRole {
         env: "standalone"
     };
 }
-
 /**
  * 检测当前进程是否为主进程
  * 用于集群模式下避免重复执行同步任务
@@ -51,6 +35,6 @@ export function getProcessRole(): ProcessRole {
  * - PM2 集群：PM2_INSTANCE_ID 为 '0' 或不存在时是主进程
  * @returns 是否为主进程
  */
-export function isPrimaryProcess(): boolean {
+export function isPrimaryProcess() {
     return getProcessRole().role === "primary";
 }

package/dist/utils/processFields.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 处理字段定义：将 @ 符号引用替换为实际字段定义
+ */
+export declare function processFields(fields: Record<string, any>, apiName: string, routePath: string): Record<string, any>;

package/{utils/processFields.ts → dist/utils/processFields.js}

@@ -1,25 +1,21 @@
 import { presetFields } from "../configs/presetFields.js";
-
 /**
  * 处理字段定义：将 @ 符号引用替换为实际字段定义
  */
-export function processFields(fields: Record<string, any>, apiName: string, routePath: string): Record<string, any> {
-    if (!fields || typeof fields !== "object") return fields;
-
-    const processed: Record<string, any> = {};
+export function processFields(fields, apiName, routePath) {
+    if (!fields || typeof fields !== "object")
+        return fields;
+    const processed = {};
     for (const [key, value] of Object.entries(fields)) {
         if (typeof value === "string" && value.startsWith("@")) {
             if (presetFields[value]) {
                 processed[key] = presetFields[value];
                 continue;
             }
-
             const validKeys = Object.keys(presetFields).join(", ");
             throw new Error(`API [${apiName}] (${routePath}) 字段 [${key}] 引用了未定义的预设字段 "${value}"。可用的预设字段有: ${validKeys}`);
         }
-
         processed[key] = value;
     }
-
     return processed;
 }

package/dist/utils/regex.d.ts

@@ -0,0 +1,145 @@
+/**
+ * 内置正则表达式别名
+ * 用于表单验证和数据校验
+ * 命名规范：小驼峰格式
+ */
+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;