befly-shared 1.2.8 → 1.3.1

package/dist/deepTransformKeys.js

@@ -1,139 +0,0 @@
-import { isPlainObject } from 'es-toolkit/compat';
-import { camelCase, snakeCase, kebabCase, pascalCase } from 'es-toolkit/string';
-/**
- * 深度递归遍历数据结构，转换所有键名
- * 支持嵌套对象和数组，自动防止循环引用和栈溢出
- *
- * @param data - 源数据（对象、数组或其他类型）
- * @param transformer - 转换函数或预设方式
- * @param options - 转换选项
- * @returns 键名转换后的新数据
- *
- * @example
- * // 小驼峰
- * deepTransformKeys({ user_id: 123, user_info: { first_name: 'John' } }, 'camel')
- * // { userId: 123, userInfo: { firstName: 'John' } }
- *
- * @example
- * // 下划线
- * deepTransformKeys({ userId: 123, userInfo: { firstName: 'John' } }, 'snake')
- * // { user_id: 123, user_info: { first_name: 'John' } }
- *
- * @example
- * // 短横线
- * deepTransformKeys({ userId: 123, userInfo: { firstName: 'John' } }, 'kebab')
- * // { 'user-id': 123, 'user-info': { 'first-name': 'John' } }
- *
- * @example
- * // 大驼峰
- * deepTransformKeys({ user_id: 123 }, 'pascal')
- * // { UserId: 123 }
- *
- * @example
- * // 大写
- * deepTransformKeys({ userId: 123 }, 'upper')
- * // { USERID: 123 }
- *
- * @example
- * // 小写
- * deepTransformKeys({ UserId: 123 }, 'lower')
- * // { userid: 123 }
- *
- * @example
- * // 自定义转换函数
- * deepTransformKeys({ user_id: 123 }, (key) => `prefix_${key}`)
- * // { prefix_user_id: 123 }
- *
- * @example
- * // 限制递归深度
- * deepTransformKeys(deepData, 'camel', { maxDepth: 10 })
- *
- * @example
- * // 排除特定键名
- * deepTransformKeys({ _id: '123', user_name: 'John' }, 'camel', { excludeKeys: ['_id'] })
- * // { _id: '123', userName: 'John' }
- *
- * @example
- * // 嵌套数组和对象
- * deepTransformKeys({
- *   user_list: [{ user_id: 1, user_tags: [{ tag_name: 'vip' }] }]
- * }, 'camel')
- * // { userList: [{ userId: 1, userTags: [{ tagName: 'vip' }] }] }
- */
-export const deepTransformKeys = (data, transformer, options = {}) => {
-    const { maxDepth = 100, excludeKeys = [] } = options;
-    // 获取实际的转换函数
-    let transformFn;
-    if (typeof transformer === 'function') {
-        transformFn = transformer;
-    }
-    else if (transformer === 'camel') {
-        transformFn = camelCase;
-    }
-    else if (transformer === 'snake') {
-        transformFn = snakeCase;
-    }
-    else if (transformer === 'kebab') {
-        transformFn = kebabCase;
-    }
-    else if (transformer === 'pascal') {
-        transformFn = pascalCase;
-    }
-    else if (transformer === 'upper') {
-        transformFn = (key) => key.toUpperCase();
-    }
-    else {
-        transformFn = (key) => key.toLowerCase();
-    }
-    // 用于检测循环引用的 WeakSet
-    const visited = new WeakSet();
-    // 创建排除键名集合，提升查找性能
-    const excludeSet = new Set(excludeKeys);
-    // 递归转换函数
-    const transform = (value, depth) => {
-        // 处理 null 和 undefined
-        if (value === null || value === undefined) {
-            return value;
-        }
-        // 处理数组
-        if (Array.isArray(value)) {
-            // 检测循环引用
-            if (visited.has(value)) {
-                return value;
-            }
-            visited.add(value);
-            // 检查深度限制：如果达到限制，返回原数组
-            if (maxDepth > 0 && depth >= maxDepth) {
-                visited.delete(value);
-                return value;
-            }
-            const result = value.map((item) => transform(item, depth + 1));
-            visited.delete(value);
-            return result;
-        }
-        // 处理对象
-        if (isPlainObject(value)) {
-            // 检测循环引用
-            if (visited.has(value)) {
-                return value;
-            }
-            visited.add(value);
-            // 检查深度限制：如果达到限制，返回原对象
-            if (maxDepth > 0 && depth >= maxDepth) {
-                visited.delete(value);
-                return value;
-            }
-            const result = {};
-            for (const [key, val] of Object.entries(value)) {
-                // 检查是否在排除列表中
-                const transformedKey = excludeSet.has(key) ? key : transformFn(key);
-                result[transformedKey] = transform(val, depth + 1);
-            }
-            visited.delete(value);
-            return result;
-        }
-        // 其他类型（字符串、数字、布尔值等）直接返回
-        return value;
-    };
-    return transform(data, 0);
-};

package/dist/fieldClear.js

@@ -1,57 +0,0 @@
-// fieldClear 工具函数实现
-// 支持 pick/omit/keepValues/excludeValues，处理对象和数组
-function isObject(val) {
-    return val !== null && typeof val === 'object' && !Array.isArray(val);
-}
-function isArray(val) {
-    return Array.isArray(val);
-}
-export function fieldClear(data, options = {}) {
-    const { pickKeys, omitKeys, keepValues, excludeValues, keepMap } = options;
-    const filterObj = (obj) => {
-        let result = {};
-        let keys = Object.keys(obj);
-        if (pickKeys && pickKeys.length) {
-            keys = keys.filter((k) => pickKeys.includes(k));
-        }
-        if (omitKeys && omitKeys.length) {
-            keys = keys.filter((k) => !omitKeys.includes(k));
-        }
-        for (const key of keys) {
-            const value = obj[key];
-            // 1. 优先检查 keepMap
-            if (keepMap && key in keepMap) {
-                if (Object.is(keepMap[key], value)) {
-                    result[key] = value;
-                    continue;
-                }
-            }
-            // 2. 检查 keepValues (只保留指定值)
-            if (keepValues && keepValues.length && !keepValues.includes(value)) {
-                continue;
-            }
-            // 3. 检查 excludeValues (排除指定值)
-            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
-                continue;
-            }
-            result[key] = value;
-        }
-        return result;
-    };
-    if (isArray(data)) {
-        return data
-            .map((item) => (isObject(item) ? filterObj(item) : item))
-            .filter((item) => {
-            if (isObject(item)) {
-                // 只保留有内容的对象
-                return Object.keys(item).length > 0;
-            }
-            // 原始值直接保留
-            return true;
-        });
-    }
-    if (isObject(data)) {
-        return filterObj(data);
-    }
-    return data;
-}

package/dist/genShortId.js

@@ -1,12 +0,0 @@
-/**
- * 生成短 ID
- * 由时间戳（base36）+ 随机字符组成，约 13 位
- * - 前 8 位：时间戳（可排序）
- * - 后 5 位：随机字符（防冲突）
- * @returns 短 ID 字符串
- * @example
- * genShortId() // "lxyz1a2b3c4"
- */
-export function genShortId() {
-    return Date.now().toString(36) + Math.random().toString(36).slice(2, 7);
-}

package/dist/hashPassword.js

@@ -1,22 +0,0 @@
-/**
- * 密码哈希工具
- * 使用 SHA-256 + 盐值对密码进行单向哈希
- */
-/**
- * 使用 SHA-256 对密码进行哈希
- * @param password - 原始密码
- * @param salt - 盐值，默认为 befly
- * @returns 哈希后的密码（十六进制字符串）
- */
-export async function hashPassword(password, salt = 'befly') {
-    const data = password + salt;
-    // 将字符串转换为 Uint8Array
-    const encoder = new TextEncoder();
-    const dataBuffer = encoder.encode(data);
-    // 使用 Web Crypto API 进行 SHA-256 哈希
-    const hashBuffer = await crypto.subtle.digest('SHA-256', dataBuffer);
-    // 将 ArrayBuffer 转换为十六进制字符串
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
-    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
-    return hashHex;
-}

package/dist/index.js

@@ -1,26 +0,0 @@
-/**
- * Befly Shared 统一导出
- * 跨包共享的工具函数、常量、类型定义
- */
-// 常量（运行时）
-export * from './constants.js';
-// Redis 键和正则
-export * from './redisKeys.js';
-export * from './regex.js';
-// 工具函数
-export * from './addonHelper.js';
-export * from './arrayKeysToCamel.js';
-export * from './arrayToTree.js';
-export * from './calcPerfTime.js';
-export * from './configTypes.js';
-export * from './deepTransformKeys.js';
-export * from './genShortId.js';
-export * from './scanConfig.js';
-export * from './fieldClear.js';
-export * from './keysToCamel.js';
-export * from './keysToSnake.js';
-export * from './layouts.js';
-export * from './pickFields.js';
-export * from './scanFiles.js';
-export * from './scanViews.js';
-export * from './withDefaultColumns.js';

package/dist/keysToCamel.js

@@ -1,21 +0,0 @@
-import { isPlainObject } from 'es-toolkit/compat';
-import { camelCase } from 'es-toolkit/string';
-/**
- * 对象字段名转小驼峰
- * @param obj - 源对象
- * @returns 字段名转为小驼峰格式的新对象
- *
- * @example
- * keysToCamel({ user_id: 123, user_name: 'John' }) // { userId: 123, userName: 'John' }
- * keysToCamel({ created_at: 1697452800000 }) // { createdAt: 1697452800000 }
- */
-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;
-    }
-    return result;
-};

package/dist/keysToSnake.js

@@ -1,21 +0,0 @@
-import { isPlainObject } from 'es-toolkit/compat';
-import { snakeCase } from 'es-toolkit/string';
-/**
- * 对象字段名转下划线
- * @param obj - 源对象
- * @returns 字段名转为下划线格式的新对象
- *
- * @example
- * keysToSnake({ userId: 123, userName: 'John' }) // { user_id: 123, user_name: 'John' }
- * keysToSnake({ createdAt: 1697452800000 }) // { created_at: 1697452800000 }
- */
-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;
-    }
-    return result;
-};

package/dist/layouts.js

@@ -1,59 +0,0 @@
-/**
- * 自定义布局处理函数
- * 根据文件名后缀判断使用哪个布局
- * @param routes - 原始路由配置
- * @param inheritLayout - 继承的布局名称（来自父级目录）
- * @returns 处理后的布局配置（不包含实际的布局组件导入）
- */
-export function Layouts(routes, inheritLayout = '') {
-    const result = [];
-    for (const route of routes) {
-        const currentPath = route.path || '';
-        // 检查当前路径是否有 _数字 格式
-        const pathMatch = currentPath.match(/_(\d+)$/);
-        const currentLayout = pathMatch ? pathMatch[1] : inheritLayout;
-        // 如果有子路由，说明这是中间节点（目录），不包裹布局，只递归处理子路由
-        if (route.children && route.children.length > 0) {
-            // 清理路径：如果是 xxx_数字 格式，去掉 _数字
-            const cleanPath = pathMatch ? currentPath.replace(/_\d+$/, '') : currentPath;
-            // 直接递归处理子路由，不添加当前层级到结果
-            const childConfigs = Layouts(route.children, currentLayout);
-            // 将子路由的路径前缀加上当前路径
-            for (const child of childConfigs) {
-                result.push({
-                    ...child,
-                    path: cleanPath ? `${cleanPath}/${child.path}`.replace(/\/+/g, '/') : child.path
-                });
-            }
-            continue;
-        }
-        // 没有子路由的叶子节点，需要包裹布局
-        const lastPart = currentPath;
-        // 匹配 _数字 格式（如 index_1, news_2）
-        const match = lastPart.match(/_(\d+)$/);
-        // 优先使用文件自己的布局，其次使用继承的布局，最后使用 default
-        const layoutName = match ? match[1] : currentLayout || 'default';
-        // 计算清理后的路径
-        let cleanPath;
-        if (lastPart === 'index' || (lastPart.startsWith('index_') && match)) {
-            // index 或 index_数字 → 改为空路径（由父级路径表示）
-            cleanPath = '';
-        }
-        else if (match) {
-            // xxx_数字 → 去掉 _数字 后缀
-            cleanPath = lastPart.replace(/_\d+$/, '');
-        }
-        else {
-            // 其他 → 保持原样
-            cleanPath = lastPart;
-        }
-        // 返回布局配置（不执行实际导入）
-        result.push({
-            path: cleanPath,
-            layoutName: layoutName,
-            component: route.component,
-            meta: route.meta
-        });
-    }
-    return result;
-}

package/dist/pickFields.js

@@ -1,16 +0,0 @@
-import { isPlainObject } from 'es-toolkit/compat';
-/**
- * 挑选指定字段
- */
-export const pickFields = (obj, keys) => {
-    if (!obj || (!isPlainObject(obj) && !Array.isArray(obj))) {
-        return {};
-    }
-    const result = {};
-    for (const key of keys) {
-        if (key in obj) {
-            result[key] = obj[key];
-        }
-    }
-    return result;
-};

package/dist/redisKeys.js

@@ -1,34 +0,0 @@
-/**
- * Redis Key 统一管理
- * 所有 Redis 缓存键在此统一定义，避免硬编码分散
- */
-/**
- * Redis Key 生成函数集合
- */
-export const RedisKeys = {
-    /** 所有接口缓存 */
-    apisAll: () => 'befly:apis:all',
-    /** 所有菜单缓存 */
-    menusAll: () => 'befly:menus:all',
-    /** 角色信息缓存（完整角色对象） */
-    roleInfo: (roleCode) => `befly:role:info:${roleCode}`,
-    /** 角色接口权限缓存（Set 集合） */
-    roleApis: (roleCode) => `befly:role:apis:${roleCode}`,
-    /** 表结构缓存 */
-    tableColumns: (table) => `befly:table:columns:${table}`
-};
-/**
- * Redis TTL（过期时间）常量配置（单位：秒）
- */
-export const RedisTTL = {
-    /** 表结构缓存 - 1小时 */
-    tableColumns: 3600,
-    /** 角色接口权限 - 24小时 */
-    roleApis: 86400,
-    /** 角色信息 - 24小时 */
-    roleInfo: 86400,
-    /** 接口列表 - 永久（不过期） */
-    apisAll: null,
-    /** 菜单列表 - 永久（不过期） */
-    menusAll: null
-};

package/dist/regex.js

@@ -1,202 +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;
-}
-/**
- * 获取编译后的正则表达式对象（带缓存）
- * @param pattern 正则别名或正则字符串
- * @param flags 正则标志（如 'i', 'g'）
- * @returns 编译后的 RegExp 对象
- */
-export function getCompiledRegex(pattern, flags) {
-    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, pattern) {
-    return getCompiledRegex(pattern).test(value);
-}
-/**
- * 清除正则缓存
- */
-export function clearRegexCache() {
-    regexCache.clear();
-}
-/**
- * 获取缓存大小
- */
-export function getRegexCacheSize() {
-    return regexCache.size;
-}