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.
- package/README.md +29 -16
- package/dist/cjs/md5.d.ts +1 -1
- package/dist/cjs/parse.d.ts +1 -1
- package/dist/cjs/rng.d.ts +1 -1
- package/dist/cjs/sha1.d.ts +1 -1
- package/dist/cjs/v1.js +8 -0
- package/dist/cjs/v35.d.ts +2 -2
- package/dist/cjs/v4.js +7 -1
- package/dist/cjs/v7.js +8 -0
- package/dist/cjs-browser/md5.d.ts +1 -1
- package/dist/cjs-browser/parse.d.ts +1 -1
- package/dist/cjs-browser/rng.d.ts +1 -1
- package/dist/cjs-browser/v1.js +8 -0
- package/dist/cjs-browser/v35.d.ts +2 -2
- package/dist/cjs-browser/v4.js +7 -1
- package/dist/cjs-browser/v7.js +8 -0
- package/dist/esm/md5.d.ts +1 -1
- package/dist/esm/parse.d.ts +1 -1
- package/dist/esm/rng.d.ts +1 -1
- package/dist/esm/sha1.d.ts +1 -1
- package/dist/esm/v1.js +8 -0
- package/dist/esm/v35.d.ts +2 -2
- package/dist/esm/v4.js +7 -1
- package/dist/esm/v7.js +8 -0
- package/dist/esm-browser/md5.d.ts +1 -1
- package/dist/esm-browser/parse.d.ts +1 -1
- package/dist/esm-browser/rng.d.ts +1 -1
- package/dist/esm-browser/v1.js +8 -0
- package/dist/esm-browser/v35.d.ts +2 -2
- package/dist/esm-browser/v4.js +7 -1
- package/dist/esm-browser/v7.js +8 -0
- package/package.json +17 -20
- package/CHANGELOG.md +0 -335
- package/CONTRIBUTING.md +0 -18
- package/dist/cjs/test/parse.test.d.ts +0 -1
- package/dist/cjs/test/parse.test.js +0 -50
- package/dist/cjs/test/rng.test.d.ts +0 -1
- package/dist/cjs/test/rng.test.js +0 -14
- package/dist/cjs/test/stringify.test.d.ts +0 -1
- package/dist/cjs/test/stringify.test.js +0 -23
- package/dist/cjs/test/test_constants.d.ts +0 -33
- package/dist/cjs/test/test_constants.js +0 -91
- package/dist/cjs/test/v1.test.d.ts +0 -1
- package/dist/cjs/test/v1.test.js +0 -127
- package/dist/cjs/test/v35.test.d.ts +0 -1
- package/dist/cjs/test/v35.test.js +0 -143
- package/dist/cjs/test/v4.test.d.ts +0 -1
- package/dist/cjs/test/v4.test.js +0 -60
- package/dist/cjs/test/v6.test.d.ts +0 -1
- package/dist/cjs/test/v6.test.js +0 -56
- package/dist/cjs/test/v7.test.d.ts +0 -1
- package/dist/cjs/test/v7.test.js +0 -194
- package/dist/cjs/test/validate.test.d.ts +0 -1
- package/dist/cjs/test/validate.test.js +0 -13
- package/dist/cjs/test/version.test.d.ts +0 -1
- package/dist/cjs/test/version.test.js +0 -20
- package/dist/cjs-browser/test/parse.test.d.ts +0 -1
- package/dist/cjs-browser/test/parse.test.js +0 -50
- package/dist/cjs-browser/test/rng.test.d.ts +0 -1
- package/dist/cjs-browser/test/rng.test.js +0 -14
- package/dist/cjs-browser/test/stringify.test.d.ts +0 -1
- package/dist/cjs-browser/test/stringify.test.js +0 -23
- package/dist/cjs-browser/test/test_constants.d.ts +0 -33
- package/dist/cjs-browser/test/test_constants.js +0 -91
- package/dist/cjs-browser/test/v1.test.d.ts +0 -1
- package/dist/cjs-browser/test/v1.test.js +0 -127
- package/dist/cjs-browser/test/v35.test.d.ts +0 -1
- package/dist/cjs-browser/test/v35.test.js +0 -143
- package/dist/cjs-browser/test/v4.test.d.ts +0 -1
- package/dist/cjs-browser/test/v4.test.js +0 -60
- package/dist/cjs-browser/test/v6.test.d.ts +0 -1
- package/dist/cjs-browser/test/v6.test.js +0 -56
- package/dist/cjs-browser/test/v7.test.d.ts +0 -1
- package/dist/cjs-browser/test/v7.test.js +0 -194
- package/dist/cjs-browser/test/validate.test.d.ts +0 -1
- package/dist/cjs-browser/test/validate.test.js +0 -13
- package/dist/cjs-browser/test/version.test.d.ts +0 -1
- package/dist/cjs-browser/test/version.test.js +0 -20
- package/dist/esm/test/parse.test.d.ts +0 -1
- package/dist/esm/test/parse.test.js +0 -48
- package/dist/esm/test/rng.test.d.ts +0 -1
- package/dist/esm/test/rng.test.js +0 -12
- package/dist/esm/test/stringify.test.d.ts +0 -1
- package/dist/esm/test/stringify.test.js +0 -21
- package/dist/esm/test/test_constants.d.ts +0 -33
- package/dist/esm/test/test_constants.js +0 -88
- package/dist/esm/test/v1.test.d.ts +0 -1
- package/dist/esm/test/v1.test.js +0 -125
- package/dist/esm/test/v35.test.d.ts +0 -1
- package/dist/esm/test/v35.test.js +0 -141
- package/dist/esm/test/v4.test.d.ts +0 -1
- package/dist/esm/test/v4.test.js +0 -58
- package/dist/esm/test/v6.test.d.ts +0 -1
- package/dist/esm/test/v6.test.js +0 -54
- package/dist/esm/test/v7.test.d.ts +0 -1
- package/dist/esm/test/v7.test.js +0 -192
- package/dist/esm/test/validate.test.d.ts +0 -1
- package/dist/esm/test/validate.test.js +0 -11
- package/dist/esm/test/version.test.d.ts +0 -1
- package/dist/esm/test/version.test.js +0 -18
- package/dist/esm-browser/test/parse.test.d.ts +0 -1
- package/dist/esm-browser/test/parse.test.js +0 -48
- package/dist/esm-browser/test/rng.test.d.ts +0 -1
- package/dist/esm-browser/test/rng.test.js +0 -12
- package/dist/esm-browser/test/stringify.test.d.ts +0 -1
- package/dist/esm-browser/test/stringify.test.js +0 -21
- package/dist/esm-browser/test/test_constants.d.ts +0 -33
- package/dist/esm-browser/test/test_constants.js +0 -88
- package/dist/esm-browser/test/v1.test.d.ts +0 -1
- package/dist/esm-browser/test/v1.test.js +0 -125
- package/dist/esm-browser/test/v35.test.d.ts +0 -1
- package/dist/esm-browser/test/v35.test.js +0 -141
- package/dist/esm-browser/test/v4.test.d.ts +0 -1
- package/dist/esm-browser/test/v4.test.js +0 -58
- package/dist/esm-browser/test/v6.test.d.ts +0 -1
- package/dist/esm-browser/test/v6.test.js +0 -54
- package/dist/esm-browser/test/v7.test.d.ts +0 -1
- package/dist/esm-browser/test/v7.test.js +0 -192
- package/dist/esm-browser/test/validate.test.d.ts +0 -1
- package/dist/esm-browser/test/validate.test.js +0 -11
- package/dist/esm-browser/test/version.test.d.ts +0 -1
- 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 {};
|
package/dist/esm/test/v1.test.js
DELETED
|
@@ -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 {};
|