midway-fatcms 0.0.17 → 0.0.19

package/src/libs/crud-pro/utils/MixinUtils.ts

@@ -1,400 +1,309 @@
-import { CommonException, Exceptions } from '../exceptions';
-
-//  至少需要2个字符
-const FIELD_NAME_REG_EXP = /^[a-zA-Z][0-9a-zA-Z_]+$/;
-
-// ===================== 雪花ID =====================
-const SNOWFLAKE_SEQ_START = 1
-let snowflakeSeq = SNOWFLAKE_SEQ_START;
-let snowflakeLastTs = -1;
-
-/**
- * 生成雪花ID（64位整数，JS 中以 string 返回）
- * 结构：1位符号 + 41位时间戳(ms) + 10位机器ID + 12位序列号
- * - 时间戳：相对于 2024-01-01 00:00:00 的毫秒偏移，可用约 69 年
- * - 机器ID：0-1023，优先取参数 > 环境变量 SNOWFLAKE_MACHINE_ID > process.pid 低10位
- * - 序列号：0-4095，同一毫秒内自增
- *
- * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
- * @returns 雪花ID字符串
- */
-function generateSnowflakeId(machineId?: number): string {
-  const EPOCH = 1704067200000; // 2024-01-01 00:00:00 UTC
-
-  let mid = Number(machineId);
-  if (mid === undefined || mid === null || isNaN(mid)) {
-    // 优先从环境变量获取，适配多实例部署场景
-    const envMid = typeof process !== 'undefined' && process.env && process.env.SNOWFLAKE_MACHINE_ID
-      ? parseInt(process.env.SNOWFLAKE_MACHINE_ID, 10)
-      : NaN;
-    mid = !isNaN(envMid) ? envMid : (typeof process !== 'undefined' && process.pid ? process.pid & 0x3ff : 0);
-  }
-
-  mid = Math.abs(mid) & 0x3ff; // 确保在 0-1023 范围
-
-  let now = Date.now();
-  let ts = now - EPOCH;
-
-  // 时钟回拨保护：若当前时间戳小于上次，直接沿用上次时间戳继续递增，
-  // 避免 NTP 校正/VM 快照恢复等场景下生成重复 ID，同时不阻塞 CPU
-  if (ts < snowflakeLastTs) {
-    const drift = snowflakeLastTs - ts;
-    if (drift <= 5) {
-      // 小幅回拨，沿用上次时间戳（ID 仅比实际时间快 ≤5ms，不影响唯一性和排序性）
-      ts = snowflakeLastTs;
-    } else {
-      // 大幅回拨，无法安全恢复，抛出异常
-      throw new Error(`Snowflake clock drift detected: ${drift}ms backwards. Refusing to generate ID.`);
-    }
-  }
-
-  if (ts === snowflakeLastTs) {
-    snowflakeSeq = (snowflakeSeq + 1) & 0xfff; // 0-4095 循环
-    if (snowflakeSeq === 0) {
-      // 本毫秒序列号耗尽，直接推进到下一毫秒（不阻塞CPU忙等待）
-      // ID 的时间戳比实际时间快 ≤1ms，不影响唯一性和排序性
-      ts = snowflakeLastTs + 1;
-      snowflakeSeq = SNOWFLAKE_SEQ_START;
-    }
-  } else {
-    snowflakeSeq = SNOWFLAKE_SEQ_START;
-  }
-
-  snowflakeLastTs = ts;
-
-  // 雪花ID超过JS安全整数范围(2^53)，Number运算会丢失精度
-  // 使用 BigInt 做位移拼接，确保 64 位精度完整
-  const id = (BigInt(ts) << BigInt(22)) | (BigInt(mid) << BigInt(12)) | BigInt(snowflakeSeq);
-  return id.toString();
-}
-
-
-
-  /**
-   * 生成 UUID v4 字符串（纯随机，无外部依赖）
-   * 格式：xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx，其中 y 为 8/9/a/b 之一
-   * @returns 符合 RFC 4122 v4 规范的 UUID 字符串
-   */
-  function uuid(): string {
-    // crypto.getRandomValues 在 Node.js >= 11 和现代浏览器中可用
-    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
-      const bytes = new Uint8Array(16);
-      crypto.getRandomValues(bytes);
-      // 版本位：第6字节高4位设为 0100 (v4)
-      bytes[6] = (bytes[6] & 0x0f) | 0x40;
-      // 变体位：第8字节高2位设为 10
-      bytes[8] = (bytes[8] & 0x3f) | 0x80;
-      const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
-      return hex.slice(0, 8) + '-' + hex.slice(8, 12) + '-' + hex.slice(12, 16) + '-' + hex.slice(16, 20) + '-' + hex.slice(20);
-    }
-    // 降级方案：Math.random
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
-      const r = Math.random() * 16 | 0;
-      const v = c === 'x' ? r : (r & 0x3 | 0x8);
-      return v.toString(16);
-    });
-  }
-
-
-const MixinUtils = {
-  isNil(obj: any): boolean {
-    return typeof obj === 'undefined' || obj === null;
-  },
-  isNotNil(obj: any): boolean {
-    return !MixinUtils.isNil(obj);
-  },
-  isEmpty(obj: any): boolean {
-    if (typeof obj === 'number' || typeof obj === 'boolean') {
-      return false;  // ✅ 数字和布尔值永远不为空
-    }
-
-    if (obj === null || obj === undefined) {
-      return true;
-    }
-
-    if (typeof obj === 'string') {
-      return obj.length === 0;
-    }
-
-    if (Array.isArray(obj)) {
-      return obj.length === 0;
-    }
-
-    if (typeof obj === 'object') {
-      return Object.keys(obj).length === 0;
-    }
-
-    return false;
-  },
-
-  isNotEmpty(obj: any): boolean {
-    return !MixinUtils.isEmpty(obj);
-  },
-
-  equals(obj1: any, obj2: any): boolean {
-    return obj1 === obj2;
-  },
-
-  equalsIgnoreCase(str1: string, str2: string): boolean {
-    // 严格检查类型
-    if (typeof str1 !== 'string' || typeof str2 !== 'string') {
-      return str1 === str2;
-    }
-    return str1.toUpperCase() === str2.toUpperCase();
-  },
-
-  startsWith(str1: string, str2: string): boolean {
-    if (typeof str1 === 'string' && typeof str2 === 'string') {
-      return str1.startsWith(str2);
-    }
-    return false;
-  },
-
-  isValidFieldName(s: string): boolean {
-    if (MixinUtils.isEmpty(s)) {
-      return false;
-    }
-    return FIELD_NAME_REG_EXP.test(s);
-  },
-
-  isElementAllMatch(array: any, match: (e: any) => boolean): boolean {
-    for (let i = 0; i < array.length; i++) {
-      const e = array[i];
-      if (!match(e)) {
-        return false;
-      }
-    }
-    return true;
-  },
-
-  parseColumns(columns: string | string[]) {
-    return MixinUtils.parseStringArray(columns);
-  },
-
-  parseStringArray(columns: string | string[]): any[] {
-    if (!columns || columns === '*') {
-      return [];
-    }
-
-    if (typeof columns === 'string') {
-      const columnsTrim = columns.trim();
-      // JSON形式
-      if (columnsTrim.startsWith('[') && columnsTrim.endsWith(']')) {
-        return MixinUtils.parseJsonObject(columnsTrim);
-      }
-      //逗号形式
-      return columnsTrim.split(',').filter(s => {
-        return s.length > 0;
-      });
-    }
-
-    if (!Array.isArray(columns)) {
-      throw new CommonException(Exceptions.CFG_PARSE_ERROR, 'params must be an array or string');
-    }
-
-    return columns.filter(s => {
-      return !MixinUtils.isEmpty(s);
-    });
-  },
-
-  removeStringPrefix(str: string, prefix: string): string {
-    if (!str) {
-      return '';
-    }
-    if (str === prefix) {
-      return '';
-    }
-    if (str.startsWith(prefix)) {
-      return str.substring(prefix.length);
-    }
-    return str;
-  },
-  getErrorMessage(e: any) {
-    if (!e) {
-      return '';
-    }
-    const obj = {};
-    let fieldCount = 0;
-    const keys = ['code', 'message', 'errno', 'sql', 'sqlState', 'sqlMessage', 'stack'];
-    for (let i = 0; i < keys.length; i++) {
-      const key = keys[i];
-      const value = e[key];
-      if (value) {
-        obj[key] = value;
-        fieldCount++;
-      }
-    }
-
-    if (fieldCount > 0) {
-      return JSON.stringify(obj);
-    }
-
-    return '' + e;
-  },
-
-  parseJsonObject(str: any): any {
-    if (!str) {
-      return null;
-    }
-
-    if (typeof str === 'object' || Array.isArray(str)) {
-      return str;
-    }
-
-    if (typeof str === 'string') {
-      str = str.trim();
-      if (str.startsWith('{') || str.startsWith('[')) {
-        try {
-          return JSON.parse(str);
-        } catch (e) {
-          return null;
-        }
-      }
-    }
-
-    return null;
-  },
-
-  /**
-   * 将数组转换成Map方便查询
-   * @param list
-   * @param getKey
-   */
-  toMap<T>(list: T[], getKey: (e: T) => string): Record<string, T> {
-    const map = {};
-    if (Array.isArray(list) && list.length) {
-      for (let i = 0; i < list.length; i++) {
-        const e = list[i];
-        const key = getKey(e);
-        map[key] = e;
-      }
-    }
-    return map;
-  },
-
-  /**
-   * 将数组转换成Map方便查询
-   * @param list
-   * @param getKey
-   */
-  toNewMap<T>(list: T[], getKey: (e: T) => string): Map<string, T> {
-    const map = new Map();
-    if (list && list.length) {
-      for (let i = 0; i < list.length; i++) {
-        const e = list[i];
-        const key = getKey(e);
-        map.set(key, e);
-      }
-    }
-    return map;
-  },
-
-  deepTravelObject(obj: any, objTravelCallback: (value, key, index, keyPath) => void, keyPath: string) {
-    if (!obj || !objTravelCallback) {
-      return;
-    }
-
-    if (Array.isArray(obj)) {
-      const collection = obj;
-      for (let i = 0; i < collection.length; i++) {
-        const value = collection[i];
-        const curKeyPath = keyPath + '[' + i + ']';
-        objTravelCallback(value, null, i, curKeyPath);
-        MixinUtils.deepTravelObject(value, objTravelCallback, curKeyPath);
-      }
-      return;
-    }
-
-    if (typeof obj === 'object') {
-      const keys = Object.keys(obj);
-      for (let i = 0; i < keys.length; i++) {
-        const objKey = keys[i];
-        const keyStr = objKey;
-        const value = obj[objKey];
-        const curKeyPath = keyPath + '.' + keyStr;
-        objTravelCallback(value, keyStr, null, curKeyPath);
-        MixinUtils.deepTravelObject(value, objTravelCallback, curKeyPath);
-      }
-    }
-
-  },
-  removeEmptyAttrs(obj: any): any {
-    const result = {};
-    const keys = Object.keys(obj);
-    for (let i = 0; i < keys.length; i++) {
-      const key = keys[i];
-      const value = obj[key];
-      if (MixinUtils.isNotNil(value)) {
-        result[key] = value;
-      }
-    }
-    return result;
-  },
-
-  /**
-   * 判断集合A中，是否包含任意一个集合B中的元素
-   * @param a
-   * @param b
-   */
-  hasAny(a: string[], b: string[]): boolean {
-    const aSet = new Set(a);
-    for (let i = 0; i < b.length; i++) {
-      const bElement = b[i];
-      if (aSet.has(bElement)) {
-        return true;
-      }
-    }
-    return false;
-  },
-
-  selectNotEmpty(a: any, b: any): any {
-    if (MixinUtils.isNotEmpty(a)) {
-      return a;
-    }
-    return b;
-  },
-
-  parseValueByType(value: any, targetType: string): any {
-    if (value === undefined || value === null) {
-      return value;
-    }
-    if (targetType === 'string') {
-      return '' + value;
-    }
-    if (targetType === 'number') {
-      return Number(value);
-    }
-    if (targetType === 'boolean') {
-      return value === 1 || value === true || value === 'true';
-    }
-    if (targetType === 'array') {
-      return MixinUtils.parseStringArray(value);
-    }
-    if (targetType === 'JSONObject') {
-      return MixinUtils.parseJsonObject(value);
-    }
-    return value;
-  },
-  sleepMs(ms: number): Promise<any> {
-    return new Promise(resolve => setTimeout(resolve, ms));
-  },
-
-  /**
-   * 生成 UUID v4 字符串（纯随机，无外部依赖）
-   * 格式：xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx，其中 y 为 8/9/a/b 之一
-   * @returns 符合 RFC 4122 v4 规范的 UUID 字符串
-   */
-  uuid: uuid,
-
-  /**
-   * 生成雪花ID（64位整数，以字符串返回）
-   * 结构：1位符号 + 41位时间戳(ms) + 10位机器ID + 12位序列号
-   * 同一毫秒内可生成 4096 个不重复ID，单机每秒可生成约 400 万个
-   *
-   * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
-   * @returns 雪花ID字符串
-   */
-  generateSnowflakeId: generateSnowflakeId,
-};
-
-export { MixinUtils };
+import { CommonException, Exceptions } from '../exceptions';
+import { generateSnowflakeId, uuid, generateSnowflakeIdExt } from './idgene';
+
+//  至少需要2个字符
+const FIELD_NAME_REG_EXP = /^[a-zA-Z][0-9a-zA-Z_]+$/;
+
+const MixinUtils = {
+  isNil(obj: any): boolean {
+    return typeof obj === 'undefined' || obj === null;
+  },
+  isNotNil(obj: any): boolean {
+    return !MixinUtils.isNil(obj);
+  },
+  isEmpty(obj: any): boolean {
+    if (typeof obj === 'number' || typeof obj === 'boolean') {
+      return false; // ✅ 数字和布尔值永远不为空
+    }
+
+    if (obj === null || obj === undefined) {
+      return true;
+    }
+
+    if (typeof obj === 'string') {
+      return obj.length === 0;
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.length === 0;
+    }
+
+    if (typeof obj === 'object') {
+      return Object.keys(obj).length === 0;
+    }
+
+    return false;
+  },
+
+  isNotEmpty(obj: any): boolean {
+    return !MixinUtils.isEmpty(obj);
+  },
+
+  equals(obj1: any, obj2: any): boolean {
+    return obj1 === obj2;
+  },
+
+  equalsIgnoreCase(str1: string, str2: string): boolean {
+    // 严格检查类型
+    if (typeof str1 !== 'string' || typeof str2 !== 'string') {
+      return str1 === str2;
+    }
+    return str1.toUpperCase() === str2.toUpperCase();
+  },
+
+  startsWith(str1: string, str2: string): boolean {
+    if (typeof str1 === 'string' && typeof str2 === 'string') {
+      return str1.startsWith(str2);
+    }
+    return false;
+  },
+
+  isValidFieldName(s: string): boolean {
+    if (MixinUtils.isEmpty(s)) {
+      return false;
+    }
+    return FIELD_NAME_REG_EXP.test(s);
+  },
+
+  isElementAllMatch(array: any, match: (e: any) => boolean): boolean {
+    for (let i = 0; i < array.length; i++) {
+      const e = array[i];
+      if (!match(e)) {
+        return false;
+      }
+    }
+    return true;
+  },
+
+  parseColumns(columns: string | string[]) {
+    return MixinUtils.parseStringArray(columns);
+  },
+
+  parseStringArray(columns: string | string[]): any[] {
+    if (!columns || columns === '*') {
+      return [];
+    }
+
+    if (typeof columns === 'string') {
+      const columnsTrim = columns.trim();
+      // JSON形式
+      if (columnsTrim.startsWith('[') && columnsTrim.endsWith(']')) {
+        return MixinUtils.parseJsonObject(columnsTrim);
+      }
+      //逗号形式
+      return columnsTrim.split(',').filter(s => {
+        return s.length > 0;
+      });
+    }
+
+    if (!Array.isArray(columns)) {
+      throw new CommonException(Exceptions.CFG_PARSE_ERROR, 'params must be an array or string');
+    }
+
+    return columns.filter(s => {
+      return !MixinUtils.isEmpty(s);
+    });
+  },
+
+  removeStringPrefix(str: string, prefix: string): string {
+    if (!str) {
+      return '';
+    }
+    if (str === prefix) {
+      return '';
+    }
+    if (str.startsWith(prefix)) {
+      return str.substring(prefix.length);
+    }
+    return str;
+  },
+  getErrorMessage(e: any) {
+    if (!e) {
+      return '';
+    }
+    const obj = {};
+    let fieldCount = 0;
+    const keys = ['code', 'message', 'errno', 'sql', 'sqlState', 'sqlMessage', 'stack'];
+    for (let i = 0; i < keys.length; i++) {
+      const key = keys[i];
+      const value = e[key];
+      if (value) {
+        obj[key] = value;
+        fieldCount++;
+      }
+    }
+
+    if (fieldCount > 0) {
+      return JSON.stringify(obj);
+    }
+
+    return '' + e;
+  },
+
+  parseJsonObject(str: any): any {
+    if (!str) {
+      return null;
+    }
+
+    if (typeof str === 'object' || Array.isArray(str)) {
+      return str;
+    }
+
+    if (typeof str === 'string') {
+      str = str.trim();
+      if (str.startsWith('{') || str.startsWith('[')) {
+        try {
+          return JSON.parse(str);
+        } catch (e) {
+          return null;
+        }
+      }
+    }
+
+    return null;
+  },
+
+  /**
+   * 将数组转换成Map方便查询
+   * @param list
+   * @param getKey
+   */
+  toMap<T>(list: T[], getKey: (e: T) => string): Record<string, T> {
+    const map = {};
+    if (Array.isArray(list) && list.length) {
+      for (let i = 0; i < list.length; i++) {
+        const e = list[i];
+        const key = getKey(e);
+        map[key] = e;
+      }
+    }
+    return map;
+  },
+
+  /**
+   * 将数组转换成Map方便查询
+   * @param list
+   * @param getKey
+   */
+  toNewMap<T>(list: T[], getKey: (e: T) => string): Map<string, T> {
+    const map = new Map();
+    if (list && list.length) {
+      for (let i = 0; i < list.length; i++) {
+        const e = list[i];
+        const key = getKey(e);
+        map.set(key, e);
+      }
+    }
+    return map;
+  },
+
+  deepTravelObject(obj: any, objTravelCallback: (value, key, index, keyPath) => void, keyPath: string) {
+    if (!obj || !objTravelCallback) {
+      return;
+    }
+
+    if (Array.isArray(obj)) {
+      const collection = obj;
+      for (let i = 0; i < collection.length; i++) {
+        const value = collection[i];
+        const curKeyPath = keyPath + '[' + i + ']';
+        objTravelCallback(value, null, i, curKeyPath);
+        MixinUtils.deepTravelObject(value, objTravelCallback, curKeyPath);
+      }
+      return;
+    }
+
+    if (typeof obj === 'object') {
+      const keys = Object.keys(obj);
+      for (let i = 0; i < keys.length; i++) {
+        const objKey = keys[i];
+        const keyStr = objKey;
+        const value = obj[objKey];
+        const curKeyPath = keyPath + '.' + keyStr;
+        objTravelCallback(value, keyStr, null, curKeyPath);
+        MixinUtils.deepTravelObject(value, objTravelCallback, curKeyPath);
+      }
+    }
+  },
+  removeEmptyAttrs(obj: any): any {
+    const result = {};
+    const keys = Object.keys(obj);
+    for (let i = 0; i < keys.length; i++) {
+      const key = keys[i];
+      const value = obj[key];
+      if (MixinUtils.isNotNil(value)) {
+        result[key] = value;
+      }
+    }
+    return result;
+  },
+
+  /**
+   * 判断集合A中，是否包含任意一个集合B中的元素
+   * @param a
+   * @param b
+   */
+  hasAny(a: string[], b: string[]): boolean {
+    const aSet = new Set(a);
+    for (let i = 0; i < b.length; i++) {
+      const bElement = b[i];
+      if (aSet.has(bElement)) {
+        return true;
+      }
+    }
+    return false;
+  },
+
+  selectNotEmpty(a: any, b: any): any {
+    if (MixinUtils.isNotEmpty(a)) {
+      return a;
+    }
+    return b;
+  },
+
+  parseValueByType(value: any, targetType: string): any {
+    if (value === undefined || value === null) {
+      return value;
+    }
+    if (targetType === 'string') {
+      return '' + value;
+    }
+    if (targetType === 'number') {
+      return Number(value);
+    }
+    if (targetType === 'boolean') {
+      return value === 1 || value === true || value === 'true';
+    }
+    if (targetType === 'array') {
+      return MixinUtils.parseStringArray(value);
+    }
+    if (targetType === 'JSONObject') {
+      return MixinUtils.parseJsonObject(value);
+    }
+    return value;
+  },
+  sleepMs(ms: number): Promise<any> {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  },
+
+  /**
+   * 生成 UUID v4 字符串（纯随机，无外部依赖）
+   * 格式：xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx，其中 y 为 8/9/a/b 之一
+   * @returns 符合 RFC 4122 v4 规范的 UUID 字符串
+   */
+  uuid: uuid,
+
+  /**
+   * 生成雪花ID（64位整数，以字符串返回）
+   * 结构：1位符号 + 41位时间戳(ms) + 10位机器ID + 12位序列号
+   * 同一毫秒内可生成 4096 个不重复ID，单机每秒可生成约 400 万个
+   *
+   * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
+   * @returns 雪花ID字符串
+   */
+  generateSnowflakeId: generateSnowflakeId,
+
+  generateSnowflakeIdExt: generateSnowflakeIdExt,
+};
+
+export { MixinUtils };