From 93a904d0ba8f85ce355aa373e407c16199f053fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Zasso?= <targos@protonmail.com>
Date: Wed, 4 Aug 2021 08:21:42 +0200
Subject: [PATCH] crypto: implement webcrypto.randomUUID
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Refs: https://wicg.github.io/uuid/
Refs: https://www.chromestatus.com/feature/5689159362543616

PR-URL: https://github.com/nodejs/node/pull/39648
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
---
 doc/api/webcrypto.md             | 11 +++++++++++
 lib/crypto.js                    |  2 +-
 lib/internal/crypto/webcrypto.js | 15 ++++++++++++++-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/doc/api/webcrypto.md b/doc/api/webcrypto.md
index 8032dad898658b..799cfd56431e5e 100644
--- a/doc/api/webcrypto.md
+++ b/doc/api/webcrypto.md
@@ -361,6 +361,16 @@ filled with random values, and a reference to `typedArray` is returned.
 
 An error will be thrown if the given `typedArray` is larger than 65,536 bytes.
 
+### `crypto.randomUUID()`
+<!-- YAML
+added: REPLACEME
+-->
+
+* Returns: {string}
+
+Generates a random [RFC 4122][] Version 4 UUID. The UUID is generated using a
+cryptographic pseudorandom number generator.
+
 ## Class: `CryptoKey`
 <!-- YAML
 added: v15.0.0
@@ -1771,4 +1781,5 @@ added: v15.0.0
 
 [JSON Web Key]: https://tools.ietf.org/html/rfc7517
 [Key usages]: #webcrypto_cryptokey_usages
+[RFC 4122]: https://www.rfc-editor.org/rfc/rfc4122.txt
 [Web Crypto API]: https://www.w3.org/TR/WebCryptoAPI/
diff --git a/lib/crypto.js b/lib/crypto.js
index e2355b0f5d53f6..6e050068b2093d 100644
--- a/lib/crypto.js
+++ b/lib/crypto.js
@@ -284,7 +284,7 @@ ObjectDefineProperties(module.exports, {
   webcrypto: {
     configurable: false,
     enumerable: true,
-    get() { return lazyRequire('internal/crypto/webcrypto'); }
+    get() { return lazyRequire('internal/crypto/webcrypto').crypto; }
   },
 
   // Aliases for randomBytes are deprecated.
diff --git a/lib/internal/crypto/webcrypto.js b/lib/internal/crypto/webcrypto.js
index 0dcdc28a6c2f63..7cb32ec702767d 100644
--- a/lib/internal/crypto/webcrypto.js
+++ b/lib/internal/crypto/webcrypto.js
@@ -64,8 +64,11 @@ const {
 
 const {
   getRandomValues,
+  randomUUID: _randomUUID,
 } = require('internal/crypto/random');
 
+const randomUUID = () => _randomUUID();
+
 async function generateKey(
   algorithm,
   extractable,
@@ -705,6 +708,12 @@ ObjectDefineProperties(
       writable: true,
       value: getRandomValues,
     },
+    randomUUID: {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: randomUUID,
+    },
     CryptoKey: {
       enumerable: true,
       configurable: true,
@@ -795,4 +804,8 @@ ObjectDefineProperties(
     }
   });
 
-module.exports = crypto;
+module.exports = {
+  Crypto,
+  SubtleCrypto,
+  crypto,
+};