UUIDv7 generator based on the RFC4122 update proposal (draft-03)

import { uuidv7 } from "@kripod/uuidv7";

let id = uuidv7();
console.log(id); // Example: 03475b12-c000-7000-8b18-6150ad2d0c05

• K-sortable with 1ms precision (Safari disallows sub-ms timing to defend against Spectre)
• Time-ordered when sorted lexicographically
• Collision-resistant with distributed systems in mind
• Works until the year 10889, after which timestamps would overflow

• String.prototype.padStart

  • Included in popular frameworks:

    • Next.js
    • Nuxt
    • Gatsby

  • Polyfillable using core-js, preferably within <script nomodule>:

    import "core-js/features/string/pad-start";

• crypto.getRandomValues()

  • IE 11:

    if (typeof window !== "undefined" && !window.crypto && window.msCrypto) {
      window.crypto = window.msCrypto;
    }

• unixts: Unix timestamp – 36 bits
• msec: Milliseconds – 12 bits
• ver: UUID version (7) – 4 bits
• seq: Monotonic sequence counter for more precise sorting – 12 bits
• var: UUID variant (0b10) – 2 bits
• rand: Cryptographically strong random data – 62 bits

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
┌─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┐
│                            unixts                             │
├─┴─┴─┴─┼─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┼─┴─┴─┴─┼─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┤
│unixts │         msec          │  ver  │          seq          │
├─┴─┼─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┤
│var│                         rand                              │
├─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┤
│                             rand                              │
└─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘