-
Notifications
You must be signed in to change notification settings - Fork 577
/
v5.ts
60 lines (52 loc) · 1.83 KB
/
v5.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
// This module is browser compatible.
import { bytesToUuid, uuidToBytes } from "./_common.ts";
import { concat } from "../bytes/concat.ts";
import { assert } from "../_util/asserts.ts";
const UUID_RE =
/^[0-9a-f]{8}-[0-9a-f]{4}-[5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
/**
* Validate that the passed UUID is an RFC4122 v5 UUID.
*
* @example
* ```ts
* import { generate as generateV5, validate } from "https://deno.land/std@$STD_VERSION/uuid/v5.ts";
*
* validate(await generateV5("6ba7b811-9dad-11d1-80b4-00c04fd430c8", new Uint8Array())); // true
* validate(crypto.randomUUID()); // false
* validate("this-is-not-a-uuid"); // false
* ```
*/
export function validate(id: string): boolean {
return UUID_RE.test(id);
}
/**
* Generate a RFC4122 v5 UUID (SHA-1 namespace).
*
* @example
* ```js
* import { generate } from "https://deno.land/std@$STD_VERSION/uuid/v5.ts";
*
* const NAMESPACE_URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
*
* const uuid = await generate(NAMESPACE_URL, new TextEncoder().encode("python.org"));
* uuid === "7af94e2b-4dd9-50f0-9c9a-8a48519bdef0" // true
* ```
*
* @param namespace The namespace to use, encoded as a UUID.
* @param data The data to hash to calculate the SHA-1 digest for the UUID.
*/
export async function generate(
namespace: string,
data: Uint8Array,
): Promise<string> {
// TODO(lucacasonato): validate that `namespace` is a valid UUID.
const space = uuidToBytes(namespace);
assert(space.length === 16, "namespace must be a valid UUID");
const toHash = concat(new Uint8Array(space), data);
const buffer = await crypto.subtle.digest("sha-1", toHash);
const bytes = new Uint8Array(buffer);
bytes[6] = (bytes[6] & 0x0f) | 0x50;
bytes[8] = (bytes[8] & 0x3f) | 0x80;
return bytesToUuid(bytes);
}