scru128

v0.2.3

SCRU128: Sortable, Clock and Random number-based Unique identifier

identifier uuid guid ulid ksuid

SCRU128: Sortable, Clock and Random number-based Unique identifier

SCRU128 ID is yet another attempt to supersede UUID for the users who need decentralized, globally unique time-ordered identifiers. SCRU128 is inspired by ULID and KSUID and has the following features:

128-bit unsigned integer type
Sortable by generation time (as integer and as text)
25-digit case-insensitive textual representation (Base36)
48-bit millisecond Unix timestamp that ensures useful life until year 10889
Up to 281 trillion time-ordered but unpredictable unique IDs per millisecond
80-bit three-layer randomness for global uniqueness

import { scru128, scru128String } from "scru128";
// or on browsers:
// import { scru128, scru128String } from "https://unpkg.com/scru128@^3";

// generate a new identifier object
const x = scru128();
console.log(String(x)); // e.g., "036z951mhjikzik2gsl81gr7l"
console.log(x.toBigInt()); // as a 128-bit unsigned integer

// generate a textual representation directly
console.log(scru128String()); // e.g., "036z951mhzx67t63mq9xe6q0j"

See SCRU128 Specification for details.

CommonJS support

The CommonJS entry point is deprecated and provided for backward compatibility purposes only. The entry point is no longer tested and will be removed in the future.