✨ uuidv7 support

Author: saby1101

src/uuid.ts

@@ -6,6 +6,41 @@ export function v4(): string {
   return crypto.randomUUID();
 }
 
+// https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#name-uuid-version-7
+/**
+ * unix_ts_ms:
+ * 48 bit big-endian unsigned number of Unix epoch timestamp as per Section 6.1.
+ * ver:
+ * 4 bit UUIDv7 version set as per Section 4
+ * rand_a:
+ * 12 bits pseudo-random data to provide uniqueness as per Section 6.2 and Section 6.6.
+ * var:
+ * The 2 bit variant defined by Section 4.
+ * rand_b:
+ * The final 62 bits of pseudo-random data to provide uniqueness as per Section 6.2 and Section 6.6.
+ */
+let seq = 0;
+export function v7(): string {
+  const timeComponent = Date.now().toString(16).padStart(12, "0");
+
+  const rndBuf = crypto.randomBytes(8);
+  // set 10 as first 2 bits for RFC 4122 variant
+  rndBuf[0] = (rndBuf[0] & 0x3f) | 0x80;
+  const rndArrHex = rndBuf.toString("hex");
+
+  return (
+    timeComponent.slice(0, 8) +
+    "-" +
+    timeComponent.slice(8, 12) +
+    "-7" +
+    (seq++).toString(16).padStart(3, "0") +
+    "-" +
+    rndArrHex.slice(0, 4) +
+    "-" +
+    rndArrHex.slice(4, 16)
+  );
+}
+
 export function fromBuffer(buffer: Buffer): string {
   const hex = buffer.toString("hex");
   return (