uuid 11.0.3 → 11.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +29 -16
  2. package/dist/cjs/md5.d.ts +1 -1
  3. package/dist/cjs/parse.d.ts +1 -1
  4. package/dist/cjs/rng.d.ts +1 -1
  5. package/dist/cjs/sha1.d.ts +1 -1
  6. package/dist/cjs/v1.js +8 -0
  7. package/dist/cjs/v35.d.ts +2 -2
  8. package/dist/cjs/v4.js +7 -1
  9. package/dist/cjs/v7.js +8 -0
  10. package/dist/cjs-browser/md5.d.ts +1 -1
  11. package/dist/cjs-browser/parse.d.ts +1 -1
  12. package/dist/cjs-browser/rng.d.ts +1 -1
  13. package/dist/cjs-browser/v1.js +8 -0
  14. package/dist/cjs-browser/v35.d.ts +2 -2
  15. package/dist/cjs-browser/v4.js +7 -1
  16. package/dist/cjs-browser/v7.js +8 -0
  17. package/dist/esm/md5.d.ts +1 -1
  18. package/dist/esm/parse.d.ts +1 -1
  19. package/dist/esm/rng.d.ts +1 -1
  20. package/dist/esm/sha1.d.ts +1 -1
  21. package/dist/esm/v1.js +8 -0
  22. package/dist/esm/v35.d.ts +2 -2
  23. package/dist/esm/v4.js +7 -1
  24. package/dist/esm/v7.js +8 -0
  25. package/dist/esm-browser/md5.d.ts +1 -1
  26. package/dist/esm-browser/parse.d.ts +1 -1
  27. package/dist/esm-browser/rng.d.ts +1 -1
  28. package/dist/esm-browser/v1.js +8 -0
  29. package/dist/esm-browser/v35.d.ts +2 -2
  30. package/dist/esm-browser/v4.js +7 -1
  31. package/dist/esm-browser/v7.js +8 -0
  32. package/package.json +17 -20
  33. package/CHANGELOG.md +0 -335
  34. package/CONTRIBUTING.md +0 -18
  35. package/dist/cjs/test/parse.test.d.ts +0 -1
  36. package/dist/cjs/test/parse.test.js +0 -50
  37. package/dist/cjs/test/rng.test.d.ts +0 -1
  38. package/dist/cjs/test/rng.test.js +0 -14
  39. package/dist/cjs/test/stringify.test.d.ts +0 -1
  40. package/dist/cjs/test/stringify.test.js +0 -23
  41. package/dist/cjs/test/test_constants.d.ts +0 -33
  42. package/dist/cjs/test/test_constants.js +0 -91
  43. package/dist/cjs/test/v1.test.d.ts +0 -1
  44. package/dist/cjs/test/v1.test.js +0 -127
  45. package/dist/cjs/test/v35.test.d.ts +0 -1
  46. package/dist/cjs/test/v35.test.js +0 -143
  47. package/dist/cjs/test/v4.test.d.ts +0 -1
  48. package/dist/cjs/test/v4.test.js +0 -60
  49. package/dist/cjs/test/v6.test.d.ts +0 -1
  50. package/dist/cjs/test/v6.test.js +0 -56
  51. package/dist/cjs/test/v7.test.d.ts +0 -1
  52. package/dist/cjs/test/v7.test.js +0 -194
  53. package/dist/cjs/test/validate.test.d.ts +0 -1
  54. package/dist/cjs/test/validate.test.js +0 -13
  55. package/dist/cjs/test/version.test.d.ts +0 -1
  56. package/dist/cjs/test/version.test.js +0 -20
  57. package/dist/cjs-browser/test/parse.test.d.ts +0 -1
  58. package/dist/cjs-browser/test/parse.test.js +0 -50
  59. package/dist/cjs-browser/test/rng.test.d.ts +0 -1
  60. package/dist/cjs-browser/test/rng.test.js +0 -14
  61. package/dist/cjs-browser/test/stringify.test.d.ts +0 -1
  62. package/dist/cjs-browser/test/stringify.test.js +0 -23
  63. package/dist/cjs-browser/test/test_constants.d.ts +0 -33
  64. package/dist/cjs-browser/test/test_constants.js +0 -91
  65. package/dist/cjs-browser/test/v1.test.d.ts +0 -1
  66. package/dist/cjs-browser/test/v1.test.js +0 -127
  67. package/dist/cjs-browser/test/v35.test.d.ts +0 -1
  68. package/dist/cjs-browser/test/v35.test.js +0 -143
  69. package/dist/cjs-browser/test/v4.test.d.ts +0 -1
  70. package/dist/cjs-browser/test/v4.test.js +0 -60
  71. package/dist/cjs-browser/test/v6.test.d.ts +0 -1
  72. package/dist/cjs-browser/test/v6.test.js +0 -56
  73. package/dist/cjs-browser/test/v7.test.d.ts +0 -1
  74. package/dist/cjs-browser/test/v7.test.js +0 -194
  75. package/dist/cjs-browser/test/validate.test.d.ts +0 -1
  76. package/dist/cjs-browser/test/validate.test.js +0 -13
  77. package/dist/cjs-browser/test/version.test.d.ts +0 -1
  78. package/dist/cjs-browser/test/version.test.js +0 -20
  79. package/dist/esm/test/parse.test.d.ts +0 -1
  80. package/dist/esm/test/parse.test.js +0 -48
  81. package/dist/esm/test/rng.test.d.ts +0 -1
  82. package/dist/esm/test/rng.test.js +0 -12
  83. package/dist/esm/test/stringify.test.d.ts +0 -1
  84. package/dist/esm/test/stringify.test.js +0 -21
  85. package/dist/esm/test/test_constants.d.ts +0 -33
  86. package/dist/esm/test/test_constants.js +0 -88
  87. package/dist/esm/test/v1.test.d.ts +0 -1
  88. package/dist/esm/test/v1.test.js +0 -125
  89. package/dist/esm/test/v35.test.d.ts +0 -1
  90. package/dist/esm/test/v35.test.js +0 -141
  91. package/dist/esm/test/v4.test.d.ts +0 -1
  92. package/dist/esm/test/v4.test.js +0 -58
  93. package/dist/esm/test/v6.test.d.ts +0 -1
  94. package/dist/esm/test/v6.test.js +0 -54
  95. package/dist/esm/test/v7.test.d.ts +0 -1
  96. package/dist/esm/test/v7.test.js +0 -192
  97. package/dist/esm/test/validate.test.d.ts +0 -1
  98. package/dist/esm/test/validate.test.js +0 -11
  99. package/dist/esm/test/version.test.d.ts +0 -1
  100. package/dist/esm/test/version.test.js +0 -18
  101. package/dist/esm-browser/test/parse.test.d.ts +0 -1
  102. package/dist/esm-browser/test/parse.test.js +0 -48
  103. package/dist/esm-browser/test/rng.test.d.ts +0 -1
  104. package/dist/esm-browser/test/rng.test.js +0 -12
  105. package/dist/esm-browser/test/stringify.test.d.ts +0 -1
  106. package/dist/esm-browser/test/stringify.test.js +0 -21
  107. package/dist/esm-browser/test/test_constants.d.ts +0 -33
  108. package/dist/esm-browser/test/test_constants.js +0 -88
  109. package/dist/esm-browser/test/v1.test.d.ts +0 -1
  110. package/dist/esm-browser/test/v1.test.js +0 -125
  111. package/dist/esm-browser/test/v35.test.d.ts +0 -1
  112. package/dist/esm-browser/test/v35.test.js +0 -141
  113. package/dist/esm-browser/test/v4.test.d.ts +0 -1
  114. package/dist/esm-browser/test/v4.test.js +0 -58
  115. package/dist/esm-browser/test/v6.test.d.ts +0 -1
  116. package/dist/esm-browser/test/v6.test.js +0 -54
  117. package/dist/esm-browser/test/v7.test.d.ts +0 -1
  118. package/dist/esm-browser/test/v7.test.js +0 -192
  119. package/dist/esm-browser/test/validate.test.d.ts +0 -1
  120. package/dist/esm-browser/test/validate.test.js +0 -11
  121. package/dist/esm-browser/test/version.test.d.ts +0 -1
  122. package/dist/esm-browser/test/version.test.js +0 -18
@@ -1,194 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const assert = require("assert");
4
- const node_test_1 = require("node:test");
5
- const parse_js_1 = require("../parse.js");
6
- const stringify_js_1 = require("../stringify.js");
7
- const v7_js_1 = require("../v7.js");
8
- const RFC_V7 = '017f22e2-79b0-7cc3-98c4-dc0c0c07398f';
9
- const RFC_V7_BYTES = (0, parse_js_1.default)('017f22e2-79b0-7cc3-98c4-dc0c0c07398f');
10
- const RFC_MSECS = 0x17f22e279b0;
11
- const RFC_SEQ = (0x0cc3 << 20) | (0x98c4dc >> 2);
12
- const RFC_RANDOM = Uint8Array.of(0x10, 0x91, 0x56, 0xbe, 0xc4, 0xfb, 0x0c, 0xc3, 0x18, 0xc4, 0x6c, 0x0c, 0x0c, 0x07, 0x39, 0x8f);
13
- (0, node_test_1.describe)('v7', () => {
14
- (0, node_test_1.default)('subsequent UUIDs are different', () => {
15
- const id1 = (0, v7_js_1.default)();
16
- const id2 = (0, v7_js_1.default)();
17
- assert.ok(id1 !== id2);
18
- });
19
- (0, node_test_1.default)('explicit options.random and options.msecs produces expected result', () => {
20
- const id = (0, v7_js_1.default)({
21
- random: RFC_RANDOM,
22
- msecs: RFC_MSECS,
23
- seq: RFC_SEQ,
24
- });
25
- assert.strictEqual(id, RFC_V7);
26
- });
27
- (0, node_test_1.default)('explicit options.rng produces expected result', () => {
28
- const id = (0, v7_js_1.default)({
29
- rng: () => RFC_RANDOM,
30
- msecs: RFC_MSECS,
31
- seq: RFC_SEQ,
32
- });
33
- assert.strictEqual(id, RFC_V7);
34
- });
35
- (0, node_test_1.default)('explicit options.msecs produces expected result', () => {
36
- const id = (0, v7_js_1.default)({
37
- msecs: RFC_MSECS,
38
- });
39
- assert.strictEqual(id.indexOf('017f22e2'), 0);
40
- });
41
- (0, node_test_1.default)('fills one UUID into a buffer as expected', () => {
42
- const buffer = new Uint8Array(16);
43
- const result = (0, v7_js_1.default)({
44
- random: RFC_RANDOM,
45
- msecs: RFC_MSECS,
46
- seq: RFC_SEQ,
47
- }, buffer);
48
- (0, stringify_js_1.default)(buffer);
49
- assert.deepEqual(buffer, RFC_V7_BYTES);
50
- assert.strictEqual(buffer, result);
51
- });
52
- (0, node_test_1.default)('fills two UUIDs into a buffer as expected', () => {
53
- const buffer = new Uint8Array(32);
54
- (0, v7_js_1.default)({
55
- random: RFC_RANDOM,
56
- msecs: RFC_MSECS,
57
- seq: RFC_SEQ,
58
- }, buffer, 0);
59
- (0, v7_js_1.default)({
60
- random: RFC_RANDOM,
61
- msecs: RFC_MSECS,
62
- seq: RFC_SEQ,
63
- }, buffer, 16);
64
- const expected = new Uint8Array(32);
65
- expected.set(RFC_V7_BYTES);
66
- expected.set(RFC_V7_BYTES, 16);
67
- assert.deepEqual(buffer, expected);
68
- });
69
- (0, node_test_1.default)('lexicographical sorting is preserved', () => {
70
- let id;
71
- let prior;
72
- let msecs = RFC_MSECS;
73
- for (let i = 0; i < 20000; ++i) {
74
- if (i % 1500 === 0) {
75
- msecs += 1;
76
- }
77
- id = (0, v7_js_1.default)({ msecs, seq: i });
78
- if (prior !== undefined) {
79
- assert.ok(prior < id, `${prior} < ${id}`);
80
- }
81
- prior = id;
82
- }
83
- });
84
- (0, node_test_1.default)('can supply seq', () => {
85
- let seq = 0x12345;
86
- let uuid = (0, v7_js_1.default)({
87
- msecs: RFC_MSECS,
88
- seq,
89
- });
90
- assert.strictEqual(uuid.substr(0, 25), '017f22e2-79b0-7000-848d-1');
91
- seq = 0x6fffffff;
92
- uuid = (0, v7_js_1.default)({
93
- msecs: RFC_MSECS,
94
- seq,
95
- });
96
- assert.strictEqual(uuid.substring(0, 25), '017f22e2-79b0-76ff-bfff-f');
97
- });
98
- (0, node_test_1.default)('internal seq is reset upon timestamp change', () => {
99
- (0, v7_js_1.default)({
100
- msecs: RFC_MSECS,
101
- seq: 0x6fffffff,
102
- });
103
- const uuid = (0, v7_js_1.default)({
104
- msecs: RFC_MSECS + 1,
105
- });
106
- assert.ok(uuid.indexOf('fff') !== 15);
107
- });
108
- (0, node_test_1.default)('v7() state transitions', () => {
109
- const tests = [
110
- {
111
- title: 'new time interval',
112
- state: { msecs: 1, seq: 123 },
113
- now: 2,
114
- expected: {
115
- msecs: 2,
116
- seq: 0x6c318c4,
117
- },
118
- },
119
- {
120
- title: 'same time interval',
121
- state: { msecs: 1, seq: 123 },
122
- now: 1,
123
- expected: {
124
- msecs: 1,
125
- seq: 124,
126
- },
127
- },
128
- {
129
- title: 'same time interval (sequence rollover)',
130
- state: { msecs: 1, seq: 0xffffffff },
131
- now: 1,
132
- expected: {
133
- msecs: 2,
134
- seq: 0,
135
- },
136
- },
137
- {
138
- title: 'time regression',
139
- state: { msecs: 2, seq: 123 },
140
- now: 1,
141
- expected: {
142
- msecs: 2,
143
- seq: 124,
144
- },
145
- },
146
- {
147
- title: 'time regression (sequence rollover)',
148
- state: { msecs: 2, seq: 0xffffffff },
149
- now: 1,
150
- expected: {
151
- msecs: 3,
152
- seq: 0,
153
- },
154
- },
155
- ];
156
- for (const { title, state, now, expected } of tests) {
157
- assert.deepStrictEqual((0, v7_js_1.updateV7State)(state, now, RFC_RANDOM), expected, `Failed: ${title}`);
158
- }
159
- });
160
- (0, node_test_1.default)('flipping bits changes the result', () => {
161
- const asBigInt = (buf) => buf.reduce((acc, v) => (acc << 8n) | BigInt(v), 0n);
162
- const asNumber = (bits, data) => Number(BigInt.asUintN(bits, data));
163
- const flip = (data, n) => data ^ (1n << BigInt(127 - n));
164
- const optionsFrom = (data) => {
165
- const ms = asNumber(48, data >> 80n);
166
- const hi = asNumber(12, data >> 64n);
167
- const lo = asNumber(20, data >> 42n);
168
- const r = BigInt.asUintN(42, data);
169
- return {
170
- msecs: ms,
171
- seq: (hi << 20) | lo,
172
- random: Uint8Array.from([
173
- ...Array(10).fill(0),
174
- ...Array(6)
175
- .fill(0)
176
- .map((_, i) => asNumber(8, r >> (BigInt(i) * 8n)))
177
- .reverse(),
178
- ]),
179
- };
180
- };
181
- const buf = new Uint8Array(16);
182
- const data = asBigInt((0, v7_js_1.default)({}, buf));
183
- const id = (0, stringify_js_1.default)(buf);
184
- const reserved = [48, 49, 50, 51, 64, 65];
185
- for (let i = 0; i < 128; ++i) {
186
- if (reserved.includes(i)) {
187
- continue;
188
- }
189
- const flipped = flip(data, i);
190
- assert.strictEqual(asBigInt((0, v7_js_1.default)(optionsFrom(flipped), buf)).toString(16), flipped.toString(16), `Unequal uuids at bit ${i}`);
191
- assert.notStrictEqual((0, stringify_js_1.default)(buf), id);
192
- }
193
- });
194
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,13 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const assert = require("assert");
4
- const node_test_1 = require("node:test");
5
- const validate_js_1 = require("../validate.js");
6
- const test_constants_js_1 = require("./test_constants.js");
7
- (0, node_test_1.describe)('validate()', () => {
8
- (0, node_test_1.default)('TESTS cases', () => {
9
- for (const { value, expectedValidate } of test_constants_js_1.TESTS) {
10
- assert.strictEqual((0, validate_js_1.default)(value), expectedValidate, `validate(${value}) should be ${expectedValidate}`);
11
- }
12
- });
13
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,20 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const assert = require("assert");
4
- const node_test_1 = require("node:test");
5
- const version_js_1 = require("../version.js");
6
- const test_constants_js_1 = require("./test_constants.js");
7
- (0, node_test_1.describe)('version()', () => {
8
- (0, node_test_1.default)('TESTS cases', () => {
9
- for (const { value, expectedValidate, expectedVersion } of test_constants_js_1.TESTS) {
10
- try {
11
- const actualVersion = (0, version_js_1.default)(value);
12
- assert.ok(expectedValidate, `version(${value}) should throw`);
13
- assert.strictEqual(actualVersion, expectedVersion);
14
- }
15
- catch {
16
- assert.ok(!expectedValidate, `version(${value}) threw unexpectedly`);
17
- }
18
- }
19
- });
20
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,48 +0,0 @@
1
- import * as assert from 'assert';
2
- import test, { describe } from 'node:test';
3
- import parse from '../parse.js';
4
- import stringify from '../stringify.js';
5
- import uuidv4 from '../v4.js';
6
- function splitmix32(a) {
7
- return function () {
8
- a |= 0;
9
- a = (a + 0x9e3779b9) | 0;
10
- let t = a ^ (a >>> 16);
11
- t = Math.imul(t, 0x21f0aaad);
12
- t = t ^ (t >>> 15);
13
- t = Math.imul(t, 0x735a2d97);
14
- return ((t = t ^ (t >>> 15)) >>> 0) / 4294967296;
15
- };
16
- }
17
- const rand = splitmix32(0x12345678);
18
- function rng(bytes = new Uint8Array(16)) {
19
- for (let i = 0; i < 16; i++) {
20
- bytes[i] = rand() * 256;
21
- }
22
- return bytes;
23
- }
24
- describe('parse', () => {
25
- test('String -> bytes parsing', () => {
26
- assert.deepStrictEqual(parse('0f5abcd1-c194-47f3-905b-2df7263a084b'), Uint8Array.from([
27
- 0x0f, 0x5a, 0xbc, 0xd1, 0xc1, 0x94, 0x47, 0xf3, 0x90, 0x5b, 0x2d, 0xf7, 0x26, 0x3a, 0x08,
28
- 0x4b,
29
- ]));
30
- });
31
- test('String -> bytes -> string symmetry for assorted uuids', () => {
32
- for (let i = 0; i < 1000; i++) {
33
- const uuid = uuidv4({ rng });
34
- assert.equal(stringify(parse(uuid)), uuid);
35
- }
36
- });
37
- test('Case neutrality', () => {
38
- assert.deepStrictEqual(parse('0f5abcd1-c194-47f3-905b-2df7263a084b'), parse('0f5abcd1-c194-47f3-905b-2df7263a084b'.toUpperCase()));
39
- });
40
- test('Null UUID case', () => {
41
- assert.deepStrictEqual(parse('00000000-0000-0000-0000-000000000000'), Uint8Array.from(new Array(16).fill(0)));
42
- });
43
- test('UUID validation', () => {
44
- assert.throws(() => parse());
45
- assert.throws(() => parse('invalid uuid'));
46
- assert.throws(() => parse('zyxwvuts-rqpo-nmlk-jihg-fedcba000000'));
47
- });
48
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,12 +0,0 @@
1
- import * as assert from 'assert';
2
- import test, { describe } from 'node:test';
3
- import rng from '../rng.js';
4
- describe('rng', () => {
5
- test('Node.js RNG', () => {
6
- const bytes = rng();
7
- assert.equal(bytes.length, 16);
8
- for (let i = 0; i < bytes.length; ++i) {
9
- assert.equal(typeof bytes[i], 'number');
10
- }
11
- });
12
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,21 +0,0 @@
1
- import * as assert from 'assert';
2
- import test, { describe } from 'node:test';
3
- import stringify, { unsafeStringify } from '../stringify.js';
4
- const BYTES = Uint8Array.of(0x0f, 0x5a, 0xbc, 0xd1, 0xc1, 0x94, 0x47, 0xf3, 0x90, 0x5b, 0x2d, 0xf7, 0x26, 0x3a, 0x08, 0x4b);
5
- describe('stringify', () => {
6
- test('Stringify Array (unsafe)', () => {
7
- assert.equal(unsafeStringify(BYTES), '0f5abcd1-c194-47f3-905b-2df7263a084b');
8
- });
9
- test('Stringify w/ offset (unsafe)', () => {
10
- const bytes = new Uint8Array(19).fill(0);
11
- bytes.set(BYTES, 3);
12
- assert.equal(unsafeStringify(bytes, 3), '0f5abcd1-c194-47f3-905b-2df7263a084b');
13
- });
14
- test('Stringify Array (safe)', () => {
15
- assert.equal(stringify(BYTES), '0f5abcd1-c194-47f3-905b-2df7263a084b');
16
- });
17
- test('Throws on not enough values (safe)', () => {
18
- const bytes = BYTES.slice(0, 15);
19
- assert.throws(() => stringify(bytes));
20
- });
21
- });
@@ -1,33 +0,0 @@
1
- export declare const TESTS: ({
2
- value: string;
3
- expectedValidate: boolean;
4
- expectedVersion: number;
5
- } | {
6
- value: string;
7
- expectedValidate: boolean;
8
- expectedVersion?: undefined;
9
- } | {
10
- value: undefined;
11
- expectedValidate: boolean;
12
- expectedVersion?: undefined;
13
- } | {
14
- value: null;
15
- expectedValidate: boolean;
16
- expectedVersion?: undefined;
17
- } | {
18
- value: number;
19
- expectedValidate: boolean;
20
- expectedVersion?: undefined;
21
- } | {
22
- value: RegExp;
23
- expectedValidate: boolean;
24
- expectedVersion?: undefined;
25
- } | {
26
- value: Date;
27
- expectedValidate: boolean;
28
- expectedVersion?: undefined;
29
- } | {
30
- value: boolean;
31
- expectedValidate: boolean;
32
- expectedVersion?: undefined;
33
- })[];
@@ -1,88 +0,0 @@
1
- import MAX from '../max.js';
2
- import NIL from '../nil.js';
3
- export const TESTS = [
4
- { value: NIL, expectedValidate: true, expectedVersion: 0 },
5
- { value: MAX, expectedValidate: true, expectedVersion: 15 },
6
- { value: '00000000-0000-1000-8000-000000000000', expectedValidate: true, expectedVersion: 1 },
7
- { value: 'ffffffff-ffff-1fff-8fff-ffffffffffff', expectedValidate: true, expectedVersion: 1 },
8
- { value: '00000000-0000-2000-8000-000000000000', expectedValidate: true, expectedVersion: 2 },
9
- { value: 'ffffffff-ffff-2fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 2 },
10
- { value: '00000000-0000-3000-8000-000000000000', expectedValidate: true, expectedVersion: 3 },
11
- { value: 'ffffffff-ffff-3fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 3 },
12
- { value: '00000000-0000-4000-8000-000000000000', expectedValidate: true, expectedVersion: 4 },
13
- { value: 'ffffffff-ffff-4fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 4 },
14
- { value: '00000000-0000-5000-8000-000000000000', expectedValidate: true, expectedVersion: 5 },
15
- { value: 'ffffffff-ffff-5fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 5 },
16
- { value: '00000000-0000-6000-8000-000000000000', expectedValidate: true, expectedVersion: 6 },
17
- { value: 'ffffffff-ffff-6fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 6 },
18
- { value: '00000000-0000-7000-8000-000000000000', expectedValidate: true, expectedVersion: 7 },
19
- { value: 'ffffffff-ffff-7fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 7 },
20
- { value: '00000000-0000-8000-8000-000000000000', expectedValidate: true, expectedVersion: 8 },
21
- { value: 'ffffffff-ffff-8fff-bfff-ffffffffffff', expectedValidate: true, expectedVersion: 8 },
22
- { value: '00000000-0000-9000-8000-000000000000', expectedValidate: false },
23
- { value: 'ffffffff-ffff-9fff-bfff-ffffffffffff', expectedValidate: false },
24
- { value: '00000000-0000-a000-8000-000000000000', expectedValidate: false },
25
- { value: 'ffffffff-ffff-afff-bfff-ffffffffffff', expectedValidate: false },
26
- { value: '00000000-0000-b000-8000-000000000000', expectedValidate: false },
27
- { value: 'ffffffff-ffff-bfff-bfff-ffffffffffff', expectedValidate: false },
28
- { value: '00000000-0000-c000-8000-000000000000', expectedValidate: false },
29
- { value: 'ffffffff-ffff-cfff-bfff-ffffffffffff', expectedValidate: false },
30
- { value: '00000000-0000-d000-8000-000000000000', expectedValidate: false },
31
- { value: 'ffffffff-ffff-dfff-bfff-ffffffffffff', expectedValidate: false },
32
- { value: '00000000-0000-e000-8000-000000000000', expectedValidate: false },
33
- { value: 'ffffffff-ffff-efff-bfff-ffffffffffff', expectedValidate: false },
34
- { value: 'd9428888-122b-11e1-b85c-61cd3cbb3210', expectedValidate: true, expectedVersion: 1 },
35
- { value: '000003e8-2363-21ef-b200-325096b39f47', expectedValidate: true, expectedVersion: 2 },
36
- { value: 'a981a0c2-68b1-35dc-bcfc-296e52ab01ec', expectedValidate: true, expectedVersion: 3 },
37
- { value: '109156be-c4fb-41ea-b1b4-efe1671c5836', expectedValidate: true, expectedVersion: 4 },
38
- { value: '90123e1c-7512-523e-bb28-76fab9f2f73d', expectedValidate: true, expectedVersion: 5 },
39
- { value: '1ef21d2f-1207-6660-8c4f-419efbd44d48', expectedValidate: true, expectedVersion: 6 },
40
- { value: '017f22e2-79b0-7cc3-98c4-dc0c0c07398f', expectedValidate: true, expectedVersion: 7 },
41
- { value: '0d8f23a0-697f-83ae-802e-48f3756dd581', expectedValidate: true, expectedVersion: 8 },
42
- { value: '00000000-0000-1000-0000-000000000000', expectedValidate: false },
43
- { value: '00000000-0000-1000-1000-000000000000', expectedValidate: false },
44
- { value: '00000000-0000-1000-2000-000000000000', expectedValidate: false },
45
- { value: '00000000-0000-1000-3000-000000000000', expectedValidate: false },
46
- { value: '00000000-0000-1000-4000-000000000000', expectedValidate: false },
47
- { value: '00000000-0000-1000-5000-000000000000', expectedValidate: false },
48
- { value: '00000000-0000-1000-6000-000000000000', expectedValidate: false },
49
- { value: '00000000-0000-1000-7000-000000000000', expectedValidate: false },
50
- { value: '00000000-0000-1000-8000-000000000000', expectedValidate: true, expectedVersion: 1 },
51
- { value: '00000000-0000-1000-9000-000000000000', expectedValidate: true, expectedVersion: 1 },
52
- { value: '00000000-0000-1000-a000-000000000000', expectedValidate: true, expectedVersion: 1 },
53
- { value: '00000000-0000-1000-b000-000000000000', expectedValidate: true, expectedVersion: 1 },
54
- { value: '00000000-0000-1000-c000-000000000000', expectedValidate: false },
55
- { value: '00000000-0000-1000-d000-000000000000', expectedValidate: false },
56
- { value: '00000000-0000-1000-e000-000000000000', expectedValidate: false },
57
- { value: '00000000-0000-1000-f000-000000000000', expectedValidate: false },
58
- { value: '00000000000000000000000000000000', expectedValidate: false },
59
- { value: '', expectedValidate: false },
60
- { value: 'invalid uuid string', expectedValidate: false },
61
- {
62
- value: '=Y00a-f*vb*-c-d#-p00f\b-g0h-#i^-j*3&-L00k-\nl---00n-fg000-00p-00r+',
63
- expectedValidate: false,
64
- },
65
- { value: undefined, expectedValidate: false },
66
- { value: null, expectedValidate: false },
67
- { value: 123, expectedValidate: false },
68
- { value: /regex/, expectedValidate: false },
69
- { value: new Date(0), expectedValidate: false },
70
- { value: false, expectedValidate: false },
71
- ];
72
- for (let charIndex = 0; charIndex < 36; charIndex++) {
73
- if (charIndex === 8 ||
74
- charIndex === 13 ||
75
- charIndex === 14 ||
76
- charIndex === 18 ||
77
- charIndex === 23) {
78
- continue;
79
- }
80
- const nilChars = NIL.split('');
81
- const maxChars = MAX.split('');
82
- for (let i = 0; i < 4; i++) {
83
- nilChars[charIndex] = (0x0 ^ (1 << i)).toString(16);
84
- TESTS.push({ value: nilChars.join(''), expectedValidate: false });
85
- maxChars[charIndex] = (0xf ^ (1 << i)).toString(16);
86
- TESTS.push({ value: maxChars.join(''), expectedValidate: false });
87
- }
88
- }
@@ -1 +0,0 @@
1
- export {};
@@ -1,125 +0,0 @@
1
- import * as assert from 'assert';
2
- import test, { describe } from 'node:test';
3
- import parse from '../parse.js';
4
- import v1, { updateV1State } from '../v1.js';
5
- const TIME = 1321644961388;
6
- const RFC_V1 = 'c232ab00-9414-11ec-b3c8-9f68deced846';
7
- const RFC_V1_BYTES = parse(RFC_V1);
8
- const RFC_OPTIONS = {
9
- msecs: 0x17f22e279b0,
10
- nsecs: 0,
11
- clockseq: 0x33c8,
12
- node: Uint8Array.of(0x9f, 0x68, 0xde, 0xce, 0xd8, 0x46),
13
- };
14
- const RFC_RANDOM = Uint8Array.of(0, 0, 0, 0, 0, 0, 0, 0, RFC_OPTIONS.clockseq >> 8, RFC_OPTIONS.clockseq & 0xff, ...RFC_OPTIONS.node);
15
- function compareV1TimeField(a, b) {
16
- a = a.split('-').slice(0, 3).reverse().join('');
17
- b = b.split('-').slice(0, 3).reverse().join('');
18
- return a < b ? -1 : a > b ? 1 : 0;
19
- }
20
- describe('v1', () => {
21
- test('v1 sort order (default)', () => {
22
- const ids = [v1(), v1(), v1(), v1(), v1()];
23
- const sorted = [...ids].sort(compareV1TimeField);
24
- assert.deepEqual(ids, sorted);
25
- });
26
- test('v1 sort order (time option)', () => {
27
- const ids = [
28
- v1({ msecs: TIME - 10 * 3600 * 1000 }),
29
- v1({ msecs: TIME - 1 }),
30
- v1({ msecs: TIME }),
31
- v1({ msecs: TIME + 1 }),
32
- v1({ msecs: TIME + 28 * 24 * 3600 * 1000 }),
33
- ];
34
- const sorted = [...ids].sort(compareV1TimeField);
35
- assert.deepEqual(ids, sorted);
36
- });
37
- test('v1(options)', () => {
38
- assert.equal(v1({ msecs: RFC_OPTIONS.msecs, random: RFC_RANDOM }), RFC_V1, 'minimal options');
39
- assert.equal(v1(RFC_OPTIONS), RFC_V1, 'full options');
40
- });
41
- test('v1(options) equality', () => {
42
- assert.notEqual(v1({ msecs: TIME }), v1({ msecs: TIME }), 'UUIDs with minimal options differ');
43
- assert.equal(v1(RFC_OPTIONS), v1(RFC_OPTIONS), 'UUIDs with full options are identical');
44
- });
45
- test('fills one UUID into a buffer as expected', () => {
46
- const buffer = new Uint8Array(16);
47
- const result = v1(RFC_OPTIONS, buffer);
48
- assert.deepEqual(buffer, RFC_V1_BYTES);
49
- assert.strictEqual(buffer, result);
50
- });
51
- test('fills two UUIDs into a buffer as expected', () => {
52
- const buffer = new Uint8Array(32);
53
- v1(RFC_OPTIONS, buffer, 0);
54
- v1(RFC_OPTIONS, buffer, 16);
55
- const expectedBuf = new Uint8Array(32);
56
- expectedBuf.set(RFC_V1_BYTES);
57
- expectedBuf.set(RFC_V1_BYTES, 16);
58
- assert.deepEqual(buffer, expectedBuf);
59
- });
60
- test('v1() state transitions', () => {
61
- const PRE_STATE = {
62
- msecs: 10,
63
- nsecs: 20,
64
- clockseq: 0x1234,
65
- node: Uint8Array.of(0x12, 0x34, 0x56, 0x78, 0x9a, 0xbc),
66
- };
67
- const tests = [
68
- {
69
- title: 'initial state',
70
- state: {},
71
- now: 10,
72
- expected: {
73
- msecs: 10,
74
- nsecs: 0,
75
- clockseq: RFC_OPTIONS.clockseq,
76
- node: RFC_OPTIONS.node,
77
- },
78
- },
79
- {
80
- title: 'same time interval',
81
- state: { ...PRE_STATE },
82
- now: PRE_STATE.msecs,
83
- expected: {
84
- ...PRE_STATE,
85
- nsecs: 21,
86
- },
87
- },
88
- {
89
- title: 'new time interval',
90
- state: { ...PRE_STATE },
91
- now: PRE_STATE.msecs + 1,
92
- expected: {
93
- ...PRE_STATE,
94
- msecs: PRE_STATE.msecs + 1,
95
- nsecs: 0,
96
- },
97
- },
98
- {
99
- title: 'same time interval (nsecs overflow)',
100
- state: { ...PRE_STATE, nsecs: 9999 },
101
- now: PRE_STATE.msecs,
102
- expected: {
103
- ...PRE_STATE,
104
- nsecs: 0,
105
- clockseq: RFC_OPTIONS.clockseq,
106
- node: RFC_OPTIONS.node,
107
- },
108
- },
109
- {
110
- title: 'time regression',
111
- state: { ...PRE_STATE },
112
- now: PRE_STATE.msecs - 1,
113
- expected: {
114
- ...PRE_STATE,
115
- msecs: PRE_STATE.msecs - 1,
116
- clockseq: RFC_OPTIONS.clockseq,
117
- node: RFC_OPTIONS.node,
118
- },
119
- },
120
- ];
121
- for (const { title, state, now, expected } of tests) {
122
- assert.deepStrictEqual(updateV1State(state, now, RFC_RANDOM), expected, `Failed: ${title}`);
123
- }
124
- });
125
- });
@@ -1 +0,0 @@
1
- export {};