37 lines
927 B
TypeScript
37 lines
927 B
TypeScript
/**
|
|
* Explain UUID and link to RFC here.
|
|
*
|
|
* @_subsection: api/utils:UUID [about-uuid]
|
|
*/
|
|
import { getBytes, hexlify } from "./data.js";
|
|
|
|
import type { BytesLike } from "./index.js";
|
|
|
|
/**
|
|
* Returns the version 4 [[link-uuid]] for the %%randomBytes%%.
|
|
*
|
|
* @see: https://www.ietf.org/rfc/rfc4122.txt (Section 4.4)
|
|
*/
|
|
export function uuidV4(randomBytes: BytesLike): string {
|
|
const bytes = getBytes(randomBytes, "randomBytes");
|
|
|
|
// Section: 4.1.3:
|
|
// - time_hi_and_version[12:16] = 0b0100
|
|
bytes[6] = (bytes[6] & 0x0f) | 0x40;
|
|
|
|
// Section 4.4
|
|
// - clock_seq_hi_and_reserved[6] = 0b0
|
|
// - clock_seq_hi_and_reserved[7] = 0b1
|
|
bytes[8] = (bytes[8] & 0x3f) | 0x80;
|
|
|
|
const value = hexlify(bytes);
|
|
|
|
return [
|
|
value.substring(2, 10),
|
|
value.substring(10, 14),
|
|
value.substring(14, 18),
|
|
value.substring(18, 22),
|
|
value.substring(22, 34),
|
|
].join("-");
|
|
}
|