feat: support v6 uuids

.local/uuid/v1tov6.js

@@ -0,0 +1 @@
+../../v1tov6.js

.local/uuid/v6tov1.js

@@ -0,0 +1 @@
+../../v6tov1.js

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "files.autoSave": "afterDelay",
+  "editor.formatOnSave": false,
+  "editor.defaultFormatter": "esbenp.prettier-vscode"
+}

README.md

@@ -61,10 +61,13 @@ For timestamp UUIDs, namespace UUIDs, and other options read on ...
 | [`uuid.parse()`](#uuidparsestr) | Convert UUID string to array of bytes | New in `[email protected]` |
 | [`uuid.stringify()`](#uuidstringifyarr-offset) | Convert array of bytes to UUID string | New in `[email protected]` |
 | [`uuid.v1()`](#uuidv1options-buffer-offset) | Create a version 1 (timestamp) UUID |  |
+| [`uuid.v1ToV6()`](#uuidv7options-buffer-offset) | Create a version 6 UUID from a version 1 UUID | New in `uuid@10` |
 | [`uuid.v3()`](#uuidv3name-namespace-buffer-offset) | Create a version 3 (namespace w/ MD5) UUID |  |
 | [`uuid.v4()`](#uuidv4options-buffer-offset) | Create a version 4 (random) UUID |  |
 | [`uuid.v5()`](#uuidv5name-namespace-buffer-offset) | Create a version 5 (namespace w/ SHA-1) UUID |  |
-| [`uuid.v7()`](#uuidv7options-buffer-offset) | Create a version 7 (Unix Epoch time-based) UUID | `experimental support` |
+| [`uuid.v6()`](#uuidv5name-namespace-buffer-offset) | Create a version 6 (timestamp, reordered) UUID  | New in `uuid@10` |
+| [`uuid.v6ToV1()`](#uuidv7options-buffer-offset) | Create a version 1 UUID from a version 6 UUID | New in `uuid@10` |
+| [`uuid.v7()`](#uuidv7options-buffer-offset) | Create a version 7 (Unix Epoch time-based) UUID | New in `uuid@10` |
 | [`uuid.validate()`](#uuidvalidatestr) | Test a string to see if it is a valid UUID | New in `[email protected]` |
 | [`uuid.version()`](#uuidversionstr) | Detect RFC version of a UUID | New in `[email protected]` |
 
@@ -201,6 +204,16 @@ const v1options = {
 uuidv1(v1options); // ⇨ '710b962e-041c-11e1-9234-0123456789ab'
 ```
 
+### uuid.v1ToV6(uuid)
+
+Convert a UUID from version 1 to version 6
+
+```javascript
+import { v1ToV6 } from 'uuid';
+
+v1ToV6('92f62d9e-22c4-11ef-97e9-325096b39f47'); // ⇨ '1ef22c49-2f62-6d9e-97e9-325096b39f47'
+```
+
 ### uuid.v3(name, namespace[, buffer[, offset]])
 
 Create an RFC version 3 (namespace w/ MD5) UUID
@@ -281,6 +294,42 @@ import { v5 as uuidv5 } from 'uuid';
 uuidv5('https://www.w3.org/', uuidv5.URL); // ⇨ 'c106a26a-21bb-5538-8bf2-57095d1976c1'
 ```
 
+### uuid.v6([options, [, buffer[, offset]]])
+
+Create an RFC version 6 (timestamp, reordered) UUID
+
+This method takes the same args as uuid.v1().
+
+```javascript
+import { v6 as uuidv6 } from 'uuid';
+
+uuidv6(); // ⇨ '1e940672-c5ea-64c0-8bad-9b1deb4d3b7d'
+```
+
+Example using `options`:
+
+```javascript
+import { v6 as uuidv6 } from 'uuid';
+
+const v1options = {
+  node: [0x01, 0x23, 0x45, 0x67, 0x89, 0xab],
+  clockseq: 0x1234,
+  msecs: new Date('2011-11-01').getTime(),
+  nsecs: 5678,
+};
+uuidv6(v1options); // ⇨ '1e1041c7-10b9-662e-9234-0123456789ab'
+```
+
+### uuid.v6ToV1(uuid)
+
+Convert a UUID from version 6 to version 1
+
+```javascript
+import { v6ToV1 } from 'uuid';
+
+v6ToV1('92f62d9e-22c4-11ef-97e9-325096b39f47'); // ⇨ 'e22c41ef-62d9-192f-97e9-325096b39f47'
+```
+
 ### uuid.v7([options[, buffer[, offset]]])
 
 Create an RFC version 7 (random) UUID
@@ -301,7 +350,7 @@ Example:
 ```javascript
 import { v7 as uuidv7 } from 'uuid';
 
-uuidv7(); // ⇨ '01695553-c90c-7aad-9bdd-330d7b3dcb6d'
+uuidv7(); // ⇨ '01695553-c90c-722d-9b5d-b38dfbbd4bed'
 ```
 
 ### uuid.validate(str)

README_js.md

@@ -75,10 +75,13 @@ For timestamp UUIDs, namespace UUIDs, and other options read on ...
 | [`uuid.parse()`](#uuidparsestr) | Convert UUID string to array of bytes | New in `[email protected]` |
 | [`uuid.stringify()`](#uuidstringifyarr-offset) | Convert array of bytes to UUID string | New in `[email protected]` |
 | [`uuid.v1()`](#uuidv1options-buffer-offset) | Create a version 1 (timestamp) UUID |  |
+| [`uuid.v1ToV6()`](#uuidv7options-buffer-offset) | Create a version 6 UUID from a version 1 UUID | New in `uuid@10` |
 | [`uuid.v3()`](#uuidv3name-namespace-buffer-offset) | Create a version 3 (namespace w/ MD5) UUID |  |
 | [`uuid.v4()`](#uuidv4options-buffer-offset) | Create a version 4 (random) UUID |  |
 | [`uuid.v5()`](#uuidv5name-namespace-buffer-offset) | Create a version 5 (namespace w/ SHA-1) UUID |  |
-| [`uuid.v7()`](#uuidv7options-buffer-offset) | Create a version 7 (Unix Epoch time-based) UUID | `experimental support` |
+| [`uuid.v6()`](#uuidv5name-namespace-buffer-offset) | Create a version 6 (timestamp, reordered) UUID | New in `uuid@10` |
+| [`uuid.v6ToV1()`](#uuidv7options-buffer-offset) | Create a version 1 UUID from a version 6 UUID | New in `uuid@10` |
+| [`uuid.v7()`](#uuidv7options-buffer-offset) | Create a version 7 (Unix Epoch time-based) UUID | New in `uuid@10` |
 | [`uuid.validate()`](#uuidvalidatestr) | Test a string to see if it is a valid UUID | New in `[email protected]` |
 | [`uuid.version()`](#uuidversionstr) | Detect RFC version of a UUID | New in `[email protected]` |
 
@@ -209,6 +212,16 @@ const v1options = {
 uuidv1(v1options); // RESULT
 ```
 
+### uuid.v1ToV6(uuid)
+
+Convert a UUID from version 1 to version 6
+
+```javascript --run
+import { v1ToV6 } from 'uuid';
+
+v1ToV6('92f62d9e-22c4-11ef-97e9-325096b39f47'); // RESULT
+```
+
 ### uuid.v3(name, namespace[, buffer[, offset]])
 
 Create an RFC version 3 (namespace w/ MD5) UUID
@@ -289,6 +302,42 @@ import { v5 as uuidv5 } from 'uuid';
 uuidv5('https://www.w3.org/', uuidv5.URL); // RESULT
 ```
 
+### uuid.v6([options, [, buffer[, offset]]])
+
+Create an RFC version 6 (timestamp, reordered) UUID
+
+This method takes the same args as uuid.v1().
+
+```javascript --run
+import { v6 as uuidv6 } from 'uuid';
+
+uuidv6(); // RESULT
+```
+
+Example using `options`:
+
+```javascript --run
+import { v6 as uuidv6 } from 'uuid';
+
+const v1options = {
+  node: [0x01, 0x23, 0x45, 0x67, 0x89, 0xab],
+  clockseq: 0x1234,
+  msecs: new Date('2011-11-01').getTime(),
+  nsecs: 5678,
+};
+uuidv6(v1options); // RESULT
+```
+
+### uuid.v6ToV1(uuid)
+
+Convert a UUID from version 6 to version 1
+
+```javascript --run
+import { v6ToV1 } from 'uuid';
+
+v6ToV1('1ef22c49-2f62-6d9e-97e9-325096b39f47'); // RESULT
+```
+
 ### uuid.v7([options[, buffer[, offset]]])
 
 Create an RFC version 7 (random) UUID

bundlewatch.config.json

@@ -20,6 +20,7 @@
       "path": "./examples/browser-rollup/dist/v5-size.js",
       "maxSize": "1.5 kB"
     },
+    { "path": "./examples/browser-rollup/dist/v6-size.js", "maxSize": "1.5 kB" },
     { "path": "./examples/browser-rollup/dist/v7-size.js", "maxSize": "0.8 kB" },
 
     {
@@ -38,6 +39,10 @@
       "path": "./examples/browser-webpack/dist/v5-size.js",
       "maxSize": "1.5 kB"
     },
+    {
+      "path": "./examples/browser-webpack/dist/v6-size.js",
+      "maxSize": "1.5 kB"
+    },
     { "path": "./examples/browser-webpack/dist/v7-size.js", "maxSize": "0.8 kB" }
   ]
 }

examples/benchmark/benchmark.js

@@ -66,6 +66,9 @@ export default function benchmark(uuid, Benchmark) {
       .add('uuid.v5()', function () {
         uuid.v5('hello.example.com', uuid.v5.DNS);
       })
+      .add('uuid.v6()', function () {
+        uuid.v6();
+      })
       .add('uuid.v7()', function () {
         uuid.v7();
       })
@@ -82,10 +85,38 @@ export default function benchmark(uuid, Benchmark) {
       })
       .on('complete', function () {
         console.log('Fastest is ' + this.filter('fastest').map('name'));
+        console.log('---\n');
+      })
+      .run();
+  }
+
+  function testV6Conversion() {
+    const suite = new Benchmark.Suite({
+      onError(event) {
+        console.error(event.target.error);
+      },
+    });
+
+    const V1_ID = 'f1207660-21d2-11ef-8c4f-419efbd44d48';
+    const V6_ID = '1ef21d2f-1207-6660-8c4f-419efbd44d48';
+
+    suite
+      .add('uuid.v1ToV6()', function () {
+        uuid.v1ToV6(V1_ID);
+      })
+      .add('uuid.v1ToV6() w/ randomization', function () {
+        uuid.v1ToV6(V1_ID, true);
+      })
+      .add('uuid.v6ToV1()', function () {
+        uuid.v6ToV1(V6_ID);
+      })
+      .on('cycle', function (event) {
+        console.log(event.target.toString());
       })
       .run();
   }
 
   testParseAndStringify();
   testGeneration();
+  testV6Conversion();
 }

examples/browser-esmodules/example.js

@@ -1,17 +1,21 @@
+import pkg from 'uuid/package.json';
+import * as uuid from './node_modules/uuid/dist/esm-browser/index.js';
 import {
-  NIL as NIL_UUID,
   MAX as MAX_UUID,
+  NIL as NIL_UUID,
   parse as uuidParse,
   stringify as uuidStringify,
+  validate as uuidValidate,
+  version as uuidVersion,
   v1 as uuidv1,
+  v1ToV6 as uuidv1ToV6,
   v3 as uuidv3,
   v4 as uuidv4,
   v5 as uuidv5,
+  v6 as uuidv6,
+  v6ToV1 as uuidv6ToV1,
   v7 as uuidv7,
-  validate as uuidValidate,
-  version as uuidVersion,
 } from './node_modules/uuid/dist/esm-browser/index.js';
-import * as uuid from './node_modules/uuid/dist/esm-browser/index.js';
 
 console.log('uuidv1()', uuidv1());
 
@@ -45,6 +49,14 @@ console.log('uuidv5() URL', uuidv5('http://example.com/hello', uuidv5.URL));
 // const MY_NAMESPACE = '1b671a64-40d5-491e-99b0-da01ff1f3341';
 console.log('uuidv5() MY_NAMESPACE', uuidv5('Hello, World!', MY_NAMESPACE));
 
+console.log('uuidv6()', uuidv6());
+
+// v6 <-> v1 conversion
+const V1_ID = 'f1207660-21d2-11ef-8c4f-419efbd44d48';
+const V6_ID = '1ef21d2f-1207-6660-8c4f-419efbd44d48';
+console.log('uuidv1ToV6()', uuidv1ToV6(V1_ID));
+console.log('uuidv6ToV1()', uuidv6ToV1(V6_ID));
+
 // Utility functions
 console.log('NIL_UUID', NIL_UUID);
 console.log('MAX_UUID', MAX_UUID);
@@ -64,10 +76,17 @@ console.log('uuid.v3() MY_NAMESPACE', uuid.v3('Hello, World!', MY_NAMESPACE));
 console.log('uuid.v5() DNS', uuid.v5('hello.example.com', uuid.v5.DNS));
 console.log('uuid.v5() URL', uuid.v5('http://example.com/hello', uuid.v5.URL));
 console.log('uuid.v5() MY_NAMESPACE', uuid.v5('Hello, World!', MY_NAMESPACE));
+console.log('uuid.v6()', uuid.v6());
+
+console.log('uuid.v1ToV6()', uuid.v1ToV6(V1_ID));
+console.log('uuid.v6ToV1()', uuid.v6ToV1(V6_ID));
 
 console.log('uuid.NIL', uuid.NIL);
 console.log('uuid.MAX', uuid.MAX);
 console.log('uuid.parse()', uuid.parse(MY_NAMESPACE));
 console.log('uuid.stringify()', uuid.stringify(uuid.parse(MY_NAMESPACE)));
 console.log('uuid.validate()', uuid.validate(MY_NAMESPACE));
 console.log('uuid.version()', uuid.version(MY_NAMESPACE));
+
+// Some tools like react-native need to introspect the package.json file
+console.log('pkg.name', pkg.name);

examples/browser-rollup/example-all.js

@@ -1,17 +1,20 @@
+import * as uuid from 'uuid';
 import {
-  NIL as NIL_UUID,
   MAX as MAX_UUID,
+  NIL as NIL_UUID,
   parse as uuidParse,
   stringify as uuidStringify,
+  validate as uuidValidate,
+  version as uuidVersion,
   v1 as uuidv1,
+  v1ToV6 as uuidv1ToV6,
   v3 as uuidv3,
   v4 as uuidv4,
   v5 as uuidv5,
+  v6 as uuidv6,
+  v6ToV1 as uuidv6ToV1,
   v7 as uuidv7,
-  validate as uuidValidate,
-  version as uuidVersion,
 } from 'uuid';
-import * as uuid from 'uuid';
 
 import testpage from '../utils/testpage';
 
@@ -50,6 +53,14 @@ testpage(function (addTest, done) {
   // const MY_NAMESPACE = '1b671a64-40d5-491e-99b0-da01ff1f3341';
   addTest('uuidv5() MY_NAMESPACE', uuidv5('Hello, World!', MY_NAMESPACE));
 
+  addTest('uuidv6()', uuidv6());
+
+  // v6 <-> v1 conversion
+  const V1_ID = 'f1207660-21d2-11ef-8c4f-419efbd44d48';
+  const V6_ID = '1ef21d2f-1207-6660-8c4f-419efbd44d48';
+  addTest('uuidv1ToV6()', uuidv1ToV6(V1_ID));
+  addTest('uuidv6ToV1()', uuidv6ToV1(V6_ID));
+
   // Utility functions
   addTest('NIL_UUID', NIL_UUID);
   addTest('MAX_UUID', MAX_UUID);
@@ -69,6 +80,10 @@ testpage(function (addTest, done) {
   addTest('uuid.v5() DNS', uuid.v5('hello.example.com', uuid.v5.DNS));
   addTest('uuid.v5() URL', uuid.v5('http://example.com/hello', uuid.v5.URL));
   addTest('uuid.v5() MY_NAMESPACE', uuid.v5('Hello, World!', MY_NAMESPACE));
+  addTest('uuid.v6()', uuid.v6());
+
+  addTest('uuid.v1ToV6()', uuid.v1ToV6(V1_ID));
+  addTest('uuid.v6ToV1()', uuid.v6ToV1(V6_ID));
 
   addTest('uuid.NIL', uuid.NIL);
   addTest('uuid.MAX', uuid.MAX);