midway-fatcms 0.0.18 → 0.0.19

package/dist/libs/crud-pro/utils/idgene/generateSnowflakeIdExt.d.ts

@@ -1,19 +1,27 @@
 /**
- * 128 位雪花 ID 生成器（独立于 MixinUtils.generateSnowflakeId，原 63 位算法不变）
+ * 128 位雪花 ID 生成器（优化版）
  *
  * 位布局（128 bit，无符号，BigInt 拼接后 Base58 编码返回）：
- * - 64 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移
- * - 16 bit 机器ID：0-65535，优先参数 > 环境变量 SNOWFLAKE_MACHINE_ID > process.pid 低 16 位
- * - 48 bit 序列号：同一毫秒内自增，约 2.8e14 个/ms，实际不会耗尽
+ * - 41 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移，可用约 69 年（至 ~2093 年）
+ * - 10 bit 机器ID：0-1023，与标准 64 位雪花 ID 一致，优先参数 > 环境变量 > process.pid
+ * - 77 bit 序列号：同一毫秒内自增，2^77 ≈ 1.5×10²³，无需考虑耗尽
  *
- * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），当前约 21 字符，理论最大 22 字符，建议 VARCHAR(24)
+ * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），左填充 '1' 至恒定 22 字符，建议 VARCHAR(24)
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * 2^128-1 < 58^22，故 22 字符足以覆盖全部 128 位取值范围。
  */
 declare const EPOCH: bigint;
 /**
- * 生成 128 位雪花 ID（Base58 字符串）
+ * 生成 128 位雪花 ID（Base58 字符串，恒定 22 字符）
  *
- * @param machineId 机器ID（0-65535），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
- * @returns Base58 编码的 128 位雪花 ID
+ * 位布局：41 bit 时间戳 | 10 bit 机器ID | 77 bit 序列号
+ * 时间戳采用 41 bit（与标准 64 位雪花 ID 一致），毫秒精度，可用约 69 年。
+ * 机器ID 采用 10 bit（0-1023），与标准 64 位雪花 ID 一致，防止多机 ID 冲突。
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * Base58 输出左填充 '1'（零字符）至 22 字符，保证长度恒定且不破坏字典序排序。
+ *
+ * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
+ * @returns Base58 编码的 128 位雪花 ID（恒定 22 字符）
  */
 declare function generateSnowflakeIdExt(machineId?: number): string;
 export { generateSnowflakeIdExt, EPOCH as SNOWFLAKE_EXT_EPOCH };

package/dist/libs/crud-pro/utils/idgene/generateSnowflakeIdExt.js

@@ -1,22 +1,27 @@
 "use strict";
 /**
- * 128 位雪花 ID 生成器（独立于 MixinUtils.generateSnowflakeId，原 63 位算法不变）
+ * 128 位雪花 ID 生成器（优化版）
  *
  * 位布局（128 bit，无符号，BigInt 拼接后 Base58 编码返回）：
- * - 64 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移
- * - 16 bit 机器ID：0-65535，优先参数 > 环境变量 SNOWFLAKE_MACHINE_ID > process.pid 低 16 位
- * - 48 bit 序列号：同一毫秒内自增，约 2.8e14 个/ms，实际不会耗尽
+ * - 41 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移，可用约 69 年（至 ~2093 年）
+ * - 10 bit 机器ID：0-1023，与标准 64 位雪花 ID 一致，优先参数 > 环境变量 > process.pid
+ * - 77 bit 序列号：同一毫秒内自增，2^77 ≈ 1.5×10²³，无需考虑耗尽
  *
- * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），当前约 21 字符，理论最大 22 字符，建议 VARCHAR(24)
+ * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），左填充 '1' 至恒定 22 字符，建议 VARCHAR(24)
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * 2^128-1 < 58^22，故 22 字符足以覆盖全部 128 位取值范围。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SNOWFLAKE_EXT_EPOCH = exports.generateSnowflakeIdExt = void 0;
 const EPOCH = BigInt(1704067200000); // 2024-01-01 00:00:00 UTC
 exports.SNOWFLAKE_EXT_EPOCH = EPOCH;
-const TS_SHIFT = BigInt(64);
-const MID_SHIFT = BigInt(48);
-const MID_MASK = BigInt(0xffff);
-const SEQ_MASK = BigInt('0xffffffffffff'); // 48 bit
+const TS_BITS = BigInt(41);
+const MID_BITS = BigInt(10);
+const SEQ_BITS = BigInt(77);
+const TS_MASK = (BigInt(1) << TS_BITS) - BigInt(1); // 41 bit
+const MID_MASK = (BigInt(1) << MID_BITS) - BigInt(1); // 10 bit
+const SEQ_MASK = (BigInt(1) << SEQ_BITS) - BigInt(1); // 77 bit
+const PAD_LENGTH = 22;
 const SEQ_START = BigInt(1);
 const DRIFT_TOLERANCE = BigInt(5);
 /** Bitcoin Base58 字母表 */
@@ -38,7 +43,7 @@ function encodeBase58(value) {
     }
     return result;
 }
-/** 解析机器 ID（16 bit） */
+/** 解析机器 ID（10 bit，0-1023） */
 function resolveMachineId(machineId) {
     var _a;
     let mid = Number(machineId);
@@ -55,10 +60,16 @@ function resolveMachineId(machineId) {
     return BigInt(Math.abs(mid)) & MID_MASK;
 }
 /**
- * 生成 128 位雪花 ID（Base58 字符串）
+ * 生成 128 位雪花 ID（Base58 字符串，恒定 22 字符）
  *
- * @param machineId 机器ID（0-65535），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
- * @returns Base58 编码的 128 位雪花 ID
+ * 位布局：41 bit 时间戳 | 10 bit 机器ID | 77 bit 序列号
+ * 时间戳采用 41 bit（与标准 64 位雪花 ID 一致），毫秒精度，可用约 69 年。
+ * 机器ID 采用 10 bit（0-1023），与标准 64 位雪花 ID 一致，防止多机 ID 冲突。
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * Base58 输出左填充 '1'（零字符）至 22 字符，保证长度恒定且不破坏字典序排序。
+ *
+ * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
+ * @returns Base58 编码的 128 位雪花 ID（恒定 22 字符）
  */
 function generateSnowflakeIdExt(machineId) {
     const mid = resolveMachineId(machineId);
@@ -74,16 +85,12 @@ function generateSnowflakeIdExt(machineId) {
     }
     if (ts === snowflakeExtLastTs) {
         snowflakeExtSeq = (snowflakeExtSeq + BigInt(1)) & SEQ_MASK;
-        if (snowflakeExtSeq === BigInt(0)) {
-            ts = snowflakeExtLastTs + BigInt(1);
-            snowflakeExtSeq = SEQ_START;
-        }
     }
     else {
         snowflakeExtSeq = SEQ_START;
     }
     snowflakeExtLastTs = ts;
-    const id = (ts << TS_SHIFT) | (mid << MID_SHIFT) | snowflakeExtSeq;
-    return encodeBase58(id);
+    const id = ((ts & TS_MASK) << (MID_BITS + SEQ_BITS)) | (mid << SEQ_BITS) | snowflakeExtSeq;
+    return encodeBase58(id).padStart(PAD_LENGTH, BASE58_ALPHABET[0]);
 }
 exports.generateSnowflakeIdExt = generateSnowflakeIdExt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midway-fatcms",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "This is a midway component sample",
   "main": "dist/index.js",
   "typings": "index.d.ts",

package/src/libs/crud-pro/utils/idgene/generateSnowflakeIdExt.ts

@@ -1,20 +1,25 @@
 /**
- * 128 位雪花 ID 生成器（独立于 MixinUtils.generateSnowflakeId，原 63 位算法不变）
+ * 128 位雪花 ID 生成器（优化版）
  *
  * 位布局（128 bit，无符号，BigInt 拼接后 Base58 编码返回）：
- * - 64 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移
- * - 16 bit 机器ID：0-65535，优先参数 > 环境变量 SNOWFLAKE_MACHINE_ID > process.pid 低 16 位
- * - 48 bit 序列号：同一毫秒内自增，约 2.8e14 个/ms，实际不会耗尽
+ * - 41 bit 时间戳：相对 2024-01-01 00:00:00 UTC 的毫秒偏移，可用约 69 年（至 ~2093 年）
+ * - 10 bit 机器ID：0-1023，与标准 64 位雪花 ID 一致，优先参数 > 环境变量 > process.pid
+ * - 77 bit 序列号：同一毫秒内自增，2^77 ≈ 1.5×10²³，无需考虑耗尽
  *
- * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），当前约 21 字符，理论最大 22 字符，建议 VARCHAR(24)
+ * 输出：Bitcoin 字母表 Base58（无 0/O/I/l），左填充 '1' 至恒定 22 字符，建议 VARCHAR(24)
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * 2^128-1 < 58^22，故 22 字符足以覆盖全部 128 位取值范围。
  */
 
 const EPOCH = BigInt(1704067200000); // 2024-01-01 00:00:00 UTC
 
-const TS_SHIFT = BigInt(64);
-const MID_SHIFT = BigInt(48);
-const MID_MASK = BigInt(0xffff);
-const SEQ_MASK = BigInt('0xffffffffffff'); // 48 bit
+const TS_BITS = BigInt(41);
+const MID_BITS = BigInt(10);
+const SEQ_BITS = BigInt(77);
+const TS_MASK = (BigInt(1) << TS_BITS) - BigInt(1); // 41 bit
+const MID_MASK = (BigInt(1) << MID_BITS) - BigInt(1); // 10 bit
+const SEQ_MASK = (BigInt(1) << SEQ_BITS) - BigInt(1); // 77 bit
+const PAD_LENGTH = 22;
 
 const SEQ_START = BigInt(1);
 const DRIFT_TOLERANCE = BigInt(5);
@@ -41,7 +46,7 @@ function encodeBase58(value: bigint): string {
   return result;
 }
 
-/** 解析机器 ID（16 bit） */
+/** 解析机器 ID（10 bit，0-1023） */
 function resolveMachineId(machineId?: number): bigint {
   let mid = Number(machineId);
   if (machineId === undefined || machineId === null || isNaN(mid)) {
@@ -59,10 +64,16 @@ function resolveMachineId(machineId?: number): bigint {
 }
 
 /**
- * 生成 128 位雪花 ID（Base58 字符串）
+ * 生成 128 位雪花 ID（Base58 字符串，恒定 22 字符）
  *
- * @param machineId 机器ID（0-65535），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
- * @returns Base58 编码的 128 位雪花 ID
+ * 位布局：41 bit 时间戳 | 10 bit 机器ID | 77 bit 序列号
+ * 时间戳采用 41 bit（与标准 64 位雪花 ID 一致），毫秒精度，可用约 69 年。
+ * 机器ID 采用 10 bit（0-1023），与标准 64 位雪花 ID 一致，防止多机 ID 冲突。
+ * 时间戳在高位，ID 随时间单调递增，适合做数据库主键。
+ * Base58 输出左填充 '1'（零字符）至 22 字符，保证长度恒定且不破坏字典序排序。
+ *
+ * @param machineId 机器ID（0-1023），不传则依次从环境变量 SNOWFLAKE_MACHINE_ID、process.pid 获取
+ * @returns Base58 编码的 128 位雪花 ID（恒定 22 字符）
  */
 function generateSnowflakeIdExt(machineId?: number): string {
   const mid = resolveMachineId(machineId);
@@ -82,18 +93,14 @@ function generateSnowflakeIdExt(machineId?: number): string {
 
   if (ts === snowflakeExtLastTs) {
     snowflakeExtSeq = (snowflakeExtSeq + BigInt(1)) & SEQ_MASK;
-    if (snowflakeExtSeq === BigInt(0)) {
-      ts = snowflakeExtLastTs + BigInt(1);
-      snowflakeExtSeq = SEQ_START;
-    }
   } else {
     snowflakeExtSeq = SEQ_START;
   }
 
   snowflakeExtLastTs = ts;
 
-  const id = (ts << TS_SHIFT) | (mid << MID_SHIFT) | snowflakeExtSeq;
-  return encodeBase58(id);
+  const id = ((ts & TS_MASK) << (MID_BITS + SEQ_BITS)) | (mid << SEQ_BITS) | snowflakeExtSeq;
+  return encodeBase58(id).padStart(PAD_LENGTH, BASE58_ALPHABET[0]);
 }
 
 export { generateSnowflakeIdExt, EPOCH as SNOWFLAKE_EXT_EPOCH };