befly 3.10.19 → 3.11.1

package/dist/utils/util.js

@@ -0,0 +1,262 @@
+/**
+ * 注意：本文件用于集中维护 core 内部通用 utils。
+ * - 按项目规范：避免零散小文件噪音；实现集中在本文件，而不是做 re-export 聚合。
+ * - 仅在 packages/core 内部使用；core 对外不承诺这些路径导出。
+ */
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * 激进空值判断（项目约定）：
+ * - null/undefined => empty
+ * - "" / 全空白字符串 => empty
+ * - 0 / NaN => empty
+ * - false => empty
+ * - Array => length === 0
+ * - Map/Set => size === 0
+ * - plain object => 无自有 key
+ * - 其他类型 => false
+ */
+export function isEmpty(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === "string") {
+        return value.trim().length === 0;
+    }
+    if (typeof value === "number") {
+        return value === 0 || Number.isNaN(value);
+    }
+    if (typeof value === "boolean") {
+        return value === false;
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    if (value instanceof Map || value instanceof Set) {
+        return value.size === 0;
+    }
+    if (isPlainObject(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
+export function forOwn(obj, iteratee) {
+    if (typeof iteratee !== "function") {
+        return;
+    }
+    if (!isPlainObject(obj)) {
+        return;
+    }
+    for (const key of Object.keys(obj)) {
+        iteratee(obj[key], key);
+    }
+}
+function toWordParts(input) {
+    const normalized = String(input)
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[^a-zA-Z0-9]+/g, " ")
+        .trim();
+    if (normalized.length === 0) {
+        return [];
+    }
+    return normalized.split(/\s+/).filter((p) => p.length > 0);
+}
+function upperFirst(s) {
+    if (s.length === 0) {
+        return s;
+    }
+    return s[0].toUpperCase() + s.slice(1);
+}
+/**
+ * 把字符串转为小驼峰。
+ * - 主要用于文件名/目录名（例如 my_plugin / my-plugin / my plugin）。
+ */
+export function camelCase(input) {
+    const parts = toWordParts(input);
+    if (parts.length === 0) {
+        return "";
+    }
+    const first = parts[0].toLowerCase();
+    const rest = parts.slice(1).map((p) => upperFirst(p.toLowerCase()));
+    return [first, ...rest].join("");
+}
+function normalizeToWords(input) {
+    return String(input)
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[^a-zA-Z0-9]+/g, " ")
+        .trim();
+}
+/**
+ * 把字符串转为 snake_case。
+ * - 主要用于表名/字段名（例如 userId -> user_id）。
+ */
+export function snakeCase(input) {
+    const normalized = normalizeToWords(input);
+    if (normalized.length === 0) {
+        return "";
+    }
+    return normalized
+        .split(/\s+/)
+        .filter((p) => p.length > 0)
+        .map((p) => p.toLowerCase())
+        .join("_");
+}
+/**
+ * 对象字段名转小驼峰
+ * @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;
+};
+/**
+ * 对象字段名转下划线
+ * @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;
+};
+/**
+ * 数组对象字段名批量转小驼峰
+ * @param arr - 源数组
+ * @returns 字段名转为小驼峰格式的新数组
+ *
+ * @example
+ * arrayKeysToCamel([
+ *   { user_id: 1, user_name: 'John' },
+ *   { user_id: 2, user_name: 'Jane' }
+ * ])
+ * // [{ userId: 1, userName: 'John' }, { userId: 2, userName: 'Jane' }]
+ */
+export const arrayKeysToCamel = (arr) => {
+    if (!arr || !Array.isArray(arr))
+        return arr;
+    return arr.map((item) => keysToCamel(item));
+};
+export function getByPath(obj, path) {
+    if (!path) {
+        return obj;
+    }
+    const parts = path.split(".");
+    let cur = obj;
+    for (const part of parts) {
+        if (cur === null || cur === undefined) {
+            return undefined;
+        }
+        if (typeof cur !== "object") {
+            return undefined;
+        }
+        cur = cur[part];
+    }
+    return cur;
+}
+export function setByPath(target, path, value) {
+    const parts = path.split(".");
+    // 避免无效 path（如 a..b）导致部分写入
+    for (const part of parts) {
+        if (!part) {
+            return;
+        }
+    }
+    let cur = target;
+    for (let i = 0; i < parts.length; i++) {
+        const key = parts[i];
+        const isLast = i === parts.length - 1;
+        if (isLast) {
+            cur[key] = value;
+            return;
+        }
+        const nextVal = cur[key];
+        if (!isPlainObject(nextVal)) {
+            cur[key] = {};
+        }
+        cur = cur[key];
+    }
+}
+/**
+ * 返回一个移除指定 key 的浅拷贝。
+ * - 仅处理 plain object；其他类型返回空对象，避免日志场景抛错。
+ */
+export function omit(obj, keys) {
+    if (!isPlainObject(obj)) {
+        return {};
+    }
+    const keySet = new Set(Array.isArray(keys) ? keys : []);
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (keySet.has(k)) {
+            continue;
+        }
+        out[k] = v;
+    }
+    return out;
+}
+/**
+ * 挑选指定字段
+ */
+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;
+};
+export function keyBy(items, getKey) {
+    const out = {};
+    if (!Array.isArray(items) || typeof getKey !== "function") {
+        return out;
+    }
+    for (const item of items) {
+        const key = getKey(item);
+        if (typeof key !== "string" || key === "") {
+            continue;
+        }
+        out[key] = item;
+    }
+    return out;
+}
+/**
+ * 生成短 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/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly",
-    "version": "3.10.19",
-    "gitHead": "0914e9a6efb3f41136034f14d5f9cda4d5e7c3d0",
+    "version": "3.11.1",
+    "gitHead": "b566edda48fcd5e8e7c66d001fefedc68520036a",
     "private": false,
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "keywords": [
@@ -25,12 +25,22 @@
         "dist/"
     ],
     "type": "module",
-    "main": "./dist/main.js",
-    "types": "./dist/main.d.ts",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
     "exports": {
         ".": {
-            "types": "./dist/main.d.ts",
-            "default": "./dist/main.js"
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./all": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/befly.js",
+            "default": "./dist/befly.js"
+        },
+        "./min": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/befly.min.js",
+            "default": "./dist/befly.min.js"
         },
         "./types/*": {
             "types": "./dist/types/*.d.ts"
@@ -43,20 +53,16 @@
     "scripts": {
         "clean": "rimraf dist",
         "test": "bun test",
-        "build": "bunx tsgo -p tsconfig.build.json",
+        "bundle": "bun build ./index.ts --outfile ./dist/befly.js --target bun --format esm --packages bundle",
+        "bundle:min": "bun build ./index.ts --outdir ./dist --entry-naming befly.min.js --target bun --format esm --packages bundle --minify",
+        "build": "rimraf dist && bunx tsgo -p tsconfig.build.json && bun run bundle && bun run bundle:min",
         "prepack": "bun run build && bun run ./scripts/ensureDist.ts",
         "typecheck": "bunx tsgo -p tsconfig.json --noEmit"
     },
     "dependencies": {
-        "befly-shared": "^1.3.11",
-        "chalk": "^5.6.2",
-        "es-toolkit": "^1.43.0",
         "fast-jwt": "^6.1.0",
         "fast-xml-parser": "^5.3.3",
-        "merge-anything": "^6.0.6",
-        "pathe": "^2.0.3",
-        "pino": "^10.1.0",
-        "pino-roll": "^4.0.0"
+        "pathe": "^2.0.3"
     },
     "engines": {
         "bun": ">=1.3.0"

package/dist/utils/arrayKeysToCamel.d.ts

@@ -1,13 +0,0 @@
-/**
- * 数组对象字段名批量转小驼峰
- * @param arr - 源数组
- * @returns 字段名转为小驼峰格式的新数组
- *
- * @example
- * arrayKeysToCamel([
- *   { user_id: 1, user_name: 'John' },
- *   { user_id: 2, user_name: 'Jane' }
- * ])
- * // [{ userId: 1, userName: 'John' }, { userId: 2, userName: 'Jane' }]
- */
-export declare const arrayKeysToCamel: <T = any>(arr: Record<string, any>[]) => T[];

package/dist/utils/arrayKeysToCamel.js

@@ -1,18 +0,0 @@
-import { keysToCamel } from "./keysToCamel.js";
-/**
- * 数组对象字段名批量转小驼峰
- * @param arr - 源数组
- * @returns 字段名转为小驼峰格式的新数组
- *
- * @example
- * arrayKeysToCamel([
- *   { user_id: 1, user_name: 'John' },
- *   { user_id: 2, user_name: 'Jane' }
- * ])
- * // [{ userId: 1, userName: 'John' }, { userId: 2, userName: 'Jane' }]
- */
-export const arrayKeysToCamel = (arr) => {
-    if (!arr || !Array.isArray(arr))
-        return arr;
-    return arr.map((item) => keysToCamel(item));
-};

package/dist/utils/configTypes.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/configTypes.js

@@ -1 +0,0 @@
-export {};

package/dist/utils/genShortId.d.ts

@@ -1,10 +0,0 @@
-/**
- * 生成短 ID
- * 由时间戳（base36）+ 随机字符组成，约 13 位
- * - 前 8 位：时间戳（可排序）
- * - 后 5 位：随机字符（防冲突）
- * @returns 短 ID 字符串
- * @example
- * genShortId() // "lxyz1a2b3c4"
- */
-export declare function genShortId(): string;

package/dist/utils/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/utils/keysToCamel.d.ts

@@ -1,10 +0,0 @@
-/**
- * 对象字段名转小驼峰
- * @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/dist/utils/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/utils/keysToSnake.d.ts

@@ -1,10 +0,0 @@
-/**
- * 对象字段名转下划线
- * @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/dist/utils/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/utils/pickFields.d.ts

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

package/dist/utils/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/utils/processFields.d.ts

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

package/dist/utils/regex.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;