@anizoptera/uuid-slug 0.3.0 → 0.5.0

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 (202) hide show
  1. package/LICENSE +54 -31
  2. package/README.md +373 -324
  3. package/dist/alphabet.d.ts +5 -17
  4. package/dist/alphabet.d.ts.map +1 -1
  5. package/dist/alphabet.js +146 -112
  6. package/dist/alphabet.js.map +1 -1
  7. package/dist/base64url-name.d.ts +7 -0
  8. package/dist/base64url-name.d.ts.map +1 -0
  9. package/dist/base64url-name.js +8 -0
  10. package/dist/base64url-name.js.map +1 -0
  11. package/dist/errors.d.ts +50 -9
  12. package/dist/errors.d.ts.map +1 -1
  13. package/dist/errors.js +145 -63
  14. package/dist/errors.js.map +1 -1
  15. package/dist/feistel.js +29 -95
  16. package/dist/feistel.js.map +1 -1
  17. package/dist/generation-options.js +20 -0
  18. package/dist/generation-options.js.map +1 -0
  19. package/dist/index.d.ts +22 -10
  20. package/dist/index.js +21 -9
  21. package/dist/instant.js +83 -0
  22. package/dist/instant.js.map +1 -0
  23. package/dist/mask-handle.d.ts +16 -0
  24. package/dist/mask-handle.d.ts.map +1 -0
  25. package/dist/mask-handle.js +60 -0
  26. package/dist/mask-handle.js.map +1 -0
  27. package/dist/mask.d.ts +27 -0
  28. package/dist/mask.d.ts.map +1 -0
  29. package/dist/mask.js +151 -95
  30. package/dist/mask.js.map +1 -1
  31. package/dist/masking-codec-protocol.js +23 -0
  32. package/dist/masking-codec-protocol.js.map +1 -0
  33. package/dist/masking-codec-types.d.ts +245 -0
  34. package/dist/masking-codec-types.d.ts.map +1 -0
  35. package/dist/masking-codec.d.ts +19 -0
  36. package/dist/masking-codec.d.ts.map +1 -0
  37. package/dist/masking-codec.js +391 -0
  38. package/dist/masking-codec.js.map +1 -0
  39. package/dist/migration.js +114 -51
  40. package/dist/migration.js.map +1 -1
  41. package/dist/node/runtime.js +39 -0
  42. package/dist/node/runtime.js.map +1 -0
  43. package/dist/payload.d.ts +7 -0
  44. package/dist/payload.d.ts.map +1 -0
  45. package/dist/payload.js +118 -0
  46. package/dist/payload.js.map +1 -0
  47. package/dist/runtime/pool.js +21 -46
  48. package/dist/runtime/pool.js.map +1 -1
  49. package/dist/runtime/portable.js +27 -0
  50. package/dist/runtime/portable.js.map +1 -0
  51. package/dist/sentinel.js +10 -0
  52. package/dist/sentinel.js.map +1 -0
  53. package/dist/siphash.js +20 -99
  54. package/dist/siphash.js.map +1 -1
  55. package/dist/slug.d.ts +169 -0
  56. package/dist/slug.d.ts.map +1 -0
  57. package/dist/slug.js +268 -0
  58. package/dist/slug.js.map +1 -0
  59. package/dist/timestamp.d.ts +19 -0
  60. package/dist/timestamp.d.ts.map +1 -0
  61. package/dist/timestamp.js +44 -0
  62. package/dist/timestamp.js.map +1 -0
  63. package/dist/types.d.ts +480 -200
  64. package/dist/types.d.ts.map +1 -1
  65. package/dist/types.js +8 -0
  66. package/dist/types.js.map +1 -0
  67. package/dist/uuid-value-protocol.js +46 -0
  68. package/dist/uuid-value-protocol.js.map +1 -0
  69. package/dist/uuid-value.d.ts +17 -0
  70. package/dist/uuid-value.d.ts.map +1 -0
  71. package/dist/uuid-value.js +127 -0
  72. package/dist/uuid-value.js.map +1 -0
  73. package/dist/uuid.d.ts +51 -64
  74. package/dist/uuid.d.ts.map +1 -1
  75. package/dist/uuid.js +203 -199
  76. package/dist/uuid.js.map +1 -1
  77. package/dist/v4-slug.d.ts +16 -0
  78. package/dist/v4-slug.d.ts.map +1 -0
  79. package/dist/v4-slug.js +16 -0
  80. package/dist/v4-slug.js.map +1 -0
  81. package/dist/v4.d.ts +42 -0
  82. package/dist/v4.d.ts.map +1 -0
  83. package/dist/v4.js +85 -0
  84. package/dist/v4.js.map +1 -0
  85. package/dist/v7-bounds.d.ts +36 -0
  86. package/dist/v7-bounds.d.ts.map +1 -0
  87. package/dist/v7-bounds.js +49 -0
  88. package/dist/v7-bounds.js.map +1 -0
  89. package/dist/v7-generator-input.js +75 -0
  90. package/dist/v7-generator-input.js.map +1 -0
  91. package/dist/v7-generator.d.ts +43 -0
  92. package/dist/v7-generator.d.ts.map +1 -0
  93. package/dist/v7-generator.js +105 -0
  94. package/dist/v7-generator.js.map +1 -0
  95. package/dist/v7-keyless.d.ts +46 -0
  96. package/dist/v7-keyless.d.ts.map +1 -0
  97. package/dist/v7-keyless.js +106 -0
  98. package/dist/v7-keyless.js.map +1 -0
  99. package/dist/v7-payload.js +54 -0
  100. package/dist/v7-payload.js.map +1 -0
  101. package/dist/v7-slug.d.ts +46 -0
  102. package/dist/v7-slug.d.ts.map +1 -0
  103. package/dist/v7-slug.js +127 -0
  104. package/dist/v7-slug.js.map +1 -0
  105. package/dist/v7-timestamp.js +9 -0
  106. package/dist/v7-timestamp.js.map +1 -0
  107. package/dist/v7-value-options.js +28 -0
  108. package/dist/v7-value-options.js.map +1 -0
  109. package/dist/v7-value.d.ts +23 -0
  110. package/dist/v7-value.d.ts.map +1 -0
  111. package/dist/v7-value.js +31 -0
  112. package/dist/v7-value.js.map +1 -0
  113. package/dist/v7.js +127 -171
  114. package/dist/v7.js.map +1 -1
  115. package/package.json +15 -8
  116. package/src/alphabet.ts +456 -27
  117. package/src/base64url-name.ts +5 -0
  118. package/src/errors.ts +373 -37
  119. package/src/feistel.ts +69 -56
  120. package/src/generation-options.ts +48 -0
  121. package/src/index.ts +134 -80
  122. package/src/instant.ts +196 -0
  123. package/src/keyless.ts +7 -134
  124. package/src/mask-handle.ts +141 -0
  125. package/src/mask.ts +354 -129
  126. package/src/masking-codec-protocol.ts +29 -0
  127. package/src/masking-codec-types.ts +380 -0
  128. package/src/masking-codec.ts +923 -0
  129. package/src/migration.ts +195 -42
  130. package/src/payload.ts +321 -0
  131. package/src/runtime/bun.ts +30 -49
  132. package/src/runtime/node.ts +43 -24
  133. package/src/runtime/pool.ts +49 -21
  134. package/src/runtime/portable.ts +68 -0
  135. package/src/runtime/types.ts +23 -35
  136. package/src/sentinel.ts +13 -0
  137. package/src/siphash.ts +5 -4
  138. package/src/slug.ts +884 -0
  139. package/src/timestamp.ts +122 -0
  140. package/src/types.ts +759 -205
  141. package/src/uuid-value-protocol.ts +77 -0
  142. package/src/uuid-value.ts +341 -0
  143. package/src/uuid.ts +514 -234
  144. package/src/v4-slug.ts +27 -0
  145. package/src/v4.ts +234 -0
  146. package/src/v7-bounds.ts +171 -0
  147. package/src/v7-generator-input.ts +169 -0
  148. package/src/v7-generator.ts +245 -0
  149. package/src/v7-keyless.ts +354 -0
  150. package/src/v7-payload.ts +121 -0
  151. package/src/v7-slug.ts +293 -0
  152. package/src/v7-timestamp.ts +21 -0
  153. package/src/v7-value-options.ts +62 -0
  154. package/src/v7-value.ts +54 -0
  155. package/src/v7.ts +377 -200
  156. package/dist/base64url.d.ts +0 -20
  157. package/dist/base64url.d.ts.map +0 -1
  158. package/dist/base64url.js +0 -33
  159. package/dist/base64url.js.map +0 -1
  160. package/dist/codec.d.ts +0 -17
  161. package/dist/codec.d.ts.map +0 -1
  162. package/dist/codec.js +0 -192
  163. package/dist/codec.js.map +0 -1
  164. package/dist/keyless.d.ts +0 -31
  165. package/dist/keyless.d.ts.map +0 -1
  166. package/dist/keyless.js +0 -93
  167. package/dist/keyless.js.map +0 -1
  168. package/dist/legacy-mask.js +0 -55
  169. package/dist/legacy-mask.js.map +0 -1
  170. package/dist/node/alphabet.js +0 -130
  171. package/dist/node/base64url.js +0 -31
  172. package/dist/node/codec.js +0 -190
  173. package/dist/node/errors.js +0 -78
  174. package/dist/node/feistel.js +0 -103
  175. package/dist/node/index.js +0 -10
  176. package/dist/node/keyless.js +0 -91
  177. package/dist/node/legacy-mask.js +0 -53
  178. package/dist/node/mask.js +0 -106
  179. package/dist/node/migration.js +0 -64
  180. package/dist/node/runtime/node.js +0 -33
  181. package/dist/node/runtime/pool.js +0 -53
  182. package/dist/node/schema.js +0 -214
  183. package/dist/node/siphash.js +0 -106
  184. package/dist/node/uuid.js +0 -226
  185. package/dist/node/v7.js +0 -185
  186. package/dist/node/yield.js +0 -20
  187. package/dist/runtime/web.js +0 -39
  188. package/dist/runtime/web.js.map +0 -1
  189. package/dist/schema.d.ts +0 -20
  190. package/dist/schema.d.ts.map +0 -1
  191. package/dist/schema.js +0 -216
  192. package/dist/schema.js.map +0 -1
  193. package/dist/v7.d.ts +0 -12
  194. package/dist/v7.d.ts.map +0 -1
  195. package/dist/yield.js +0 -22
  196. package/dist/yield.js.map +0 -1
  197. package/src/base64url.ts +0 -41
  198. package/src/codec.ts +0 -320
  199. package/src/legacy-mask.ts +0 -25
  200. package/src/runtime/web.ts +0 -48
  201. package/src/schema.ts +0 -300
  202. package/src/yield.ts +0 -22
package/dist/uuid.js CHANGED
@@ -1,16 +1,81 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.3.0 | https://github.com/Anizoptera/uuid-slug#readme
3
- import { UuidSlugError, checkRange } from "./errors.js";
4
- import { BASE32HEX, BASE64URL, decodeInto, encode, isEncoded } from "./alphabet.js";
2
+ // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { INVALID_BUFFER as e, INVALID_OPTIONS as t, INVALID_UUID as n, UuidSlugError as r, checkByteRange as i, checkRange as a, isUint8Array as o, isUuidSlugError as s, normalizeUuidStringInput as c, stringInput as l, uuidByteView as u } from "./errors.js";
4
+ import { UUID_TEXT_LOWERCASE as d } from "./types.js";
5
+ import { runtime as f } from "#runtime";
5
6
  //#region src/uuid.ts
6
- const HEX = "0123456789abcdef";
7
- const nativeToHex = Uint8Array.prototype.toHex;
8
- const HEX_BYTES = nativeToHex ? [] : /*#__PURE__*/ Array.from({ length: 256 }, (_, byte) => HEX[byte >>> 4] + HEX[byte & 15]);
9
- const HEX_DECODE = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
10
- for (let i = 0; i < 10; i += 1) HEX_DECODE[48 + i] = i;
11
- for (let i = 0; i < 6; i += 1) HEX_DECODE[97 + i] = 10 + i;
12
- const UUID_LENGTH = 36;
13
- const UUID_BYTE_OFFSETS = [
7
+ const invalidUuidBytes = /* @__NO_SIDE_EFFECTS__ */ () => new r(e, "UUID byte input must contain exactly 16 bytes.");
8
+ /*#__NO_SIDE_EFFECTS__*/
9
+ function exactUuidByteView(e) {
10
+ if (/* @__PURE__ */ s(e)) return e;
11
+ let t = u(e);
12
+ return t?.length === 16 ? t : /* @__PURE__ */ invalidUuidBytes();
13
+ }
14
+ const p = "00000000-0000-0000-0000-000000000000", m = "ffffffff-ffff-ffff-ffff-ffffffffffff", h = "0123456789abcdef", g = "0123456789ABCDEF", isUuidTextCase = (e) => e === "lowercase" || e === "uppercase";
15
+ function resolveUuidTextCase(e) {
16
+ if (e === "lowercase" || e === "uppercase") return e;
17
+ let t = /* @__PURE__ */ l(e);
18
+ return isUuidTextCase(t) ? t : invalidUuidTextCase();
19
+ }
20
+ function invalidUuidTextCase() {
21
+ return new r(t, "UUID text case must be lowercase or uppercase.");
22
+ }
23
+ const _ = f.latin1Scratch, v = f.uuidHex, y = (/* @__PURE__ */ new Int8Array(128)).fill(-1);
24
+ for (let e = 0; e < 10; e += 1) y[48 + e] = e;
25
+ for (let e = 0; e < 6; e += 1) y[97 + e] = 10 + e;
26
+ const b = (/* @__PURE__ */ new Uint16Array(128)).fill(256);
27
+ for (let e = 0; e < 16; e += 1) b[h.charCodeAt(e)] = e, b[g.charCodeAt(e)] = e;
28
+ let x, S, C;
29
+ function hexCodes(e) {
30
+ let t = /* @__PURE__ */ new Uint8Array(512);
31
+ for (let n = 0; n < 256; n += 1) t[n * 2] = e.charCodeAt(n >>> 4), t[n * 2 + 1] = e.charCodeAt(n & 15);
32
+ return t;
33
+ }
34
+ function createUuidTextScratch(e) {
35
+ let t = e(T);
36
+ for (let e of [
37
+ 8,
38
+ 13,
39
+ 18,
40
+ 23
41
+ ]) t.bytes[e] = 45;
42
+ return t;
43
+ }
44
+ function formatUuidBytesLatin1(e, t, n, r) {
45
+ let i = x ??= createUuidTextScratch(e), a = r === "uppercase" ? C ??= hexCodes(g) : S ??= hexCodes(h), o = i.bytes, s = t[n + 0] * 2;
46
+ o[0] = a[s], o[1] = a[s + 1];
47
+ let c = t[n + 1] * 2;
48
+ o[2] = a[c], o[3] = a[c + 1];
49
+ let l = t[n + 2] * 2;
50
+ o[4] = a[l], o[5] = a[l + 1];
51
+ let u = t[n + 3] * 2;
52
+ o[6] = a[u], o[7] = a[u + 1];
53
+ let d = t[n + 4] * 2;
54
+ o[9] = a[d], o[10] = a[d + 1];
55
+ let f = t[n + 5] * 2;
56
+ o[11] = a[f], o[12] = a[f + 1];
57
+ let p = t[n + 6] * 2;
58
+ o[14] = a[p], o[15] = a[p + 1];
59
+ let m = t[n + 7] * 2;
60
+ o[16] = a[m], o[17] = a[m + 1];
61
+ let _ = t[n + 8] * 2;
62
+ o[19] = a[_], o[20] = a[_ + 1];
63
+ let v = t[n + 9] * 2;
64
+ o[21] = a[v], o[22] = a[v + 1];
65
+ let y = t[n + 10] * 2;
66
+ o[24] = a[y], o[25] = a[y + 1];
67
+ let b = t[n + 11] * 2;
68
+ o[26] = a[b], o[27] = a[b + 1];
69
+ let w = t[n + 12] * 2;
70
+ o[28] = a[w], o[29] = a[w + 1];
71
+ let T = t[n + 13] * 2;
72
+ o[30] = a[T], o[31] = a[T + 1];
73
+ let E = t[n + 14] * 2;
74
+ o[32] = a[E], o[33] = a[E + 1];
75
+ let D = t[n + 15] * 2;
76
+ return o[34] = a[D], o[35] = a[D + 1], i.text();
77
+ }
78
+ const w = /* @__PURE__ */ new Uint8Array(16), T = 36, E = [
14
79
  0,
15
80
  2,
16
81
  4,
@@ -28,201 +93,140 @@ const UUID_BYTE_OFFSETS = [
28
93
  32,
29
94
  34
30
95
  ];
31
- /**
32
- * The alphabets a plain slug may be written in. base64url is the default and the shortest;
33
- * base32hex costs four more characters and buys the one property base64url cannot offer: its
34
- * characters are in ASCII order, so base32hex slugs of UUIDv7s sort chronologically as plain
35
- * strings. Only the lowercase spelling decodes — the table is built from `chars` — so slugs have
36
- * no second spelling, as everywhere else in this format.
37
- *
38
- * MASKED slugs are always base64url (Art's ruling, 2026-08-12). Sort order there would be order of
39
- * ciphertext, which carries nothing, so the extra characters would buy only the case-insensitivity.
40
- */
41
- const SLUG_ALPHABETS = {
42
- base32hex: BASE32HEX,
43
- base64url: BASE64URL
44
- };
45
- /** Reject inherited property names as well as unknown names from JavaScript callers. */
46
- function resolveSlugAlphabet(alphabet) {
47
- return Object.hasOwn(SLUG_ALPHABETS, alphabet) ? SLUG_ALPHABETS[alphabet] : new UuidSlugError("invalid_uuid_slug", `Unknown slug alphabet "${alphabet}"; expected ${Object.keys(SLUG_ALPHABETS).join(" or ")}.`);
48
- }
49
- /** Characters needed for 16 bytes: 22 in base64url, 26 in base32hex. */
50
- function slugLength(alpha) {
51
- return Math.ceil(128 / alpha.bitsPerChar);
52
- }
53
- /**
54
- * Length -> alphabet, which is why decoding takes no alphabet argument: the two lengths are
55
- * disjoint, so a slug names its own encoding and a caller cannot pick the wrong one. Indexed
56
- * rather than searched because every decode and every type guard pays this lookup.
57
- */
58
- const SLUG_ALPHABET_BY_LENGTH = Object.values(SLUG_ALPHABETS).reduce((table, alpha) => {
59
- table[slugLength(alpha)] = alpha;
60
- return table;
61
- }, []);
62
- const SLUG_LENGTHS = Object.values(SLUG_ALPHABETS).map((alpha) => `${slugLength(alpha)} (${alpha.name})`).join(" or ");
63
- function hexValue(code) {
64
- return HEX_DECODE[code] ?? -1;
65
- }
66
- function parseUuid(uuid, out, offset = 0) {
67
- if (uuid.length !== UUID_LENGTH) return new UuidSlugError("invalid_uuid", "UUID must be 36 characters.");
68
- if (uuid[8] !== "-" || uuid[13] !== "-" || uuid[18] !== "-" || uuid[23] !== "-") return new UuidSlugError("invalid_uuid", "UUID hyphen positions are invalid.");
69
- const target = out ?? /* @__PURE__ */ new Uint8Array(16);
70
- const badRange = checkRange(target.length, offset, 16);
71
- if (badRange) return badRange;
72
- for (let byteIndex = 0; byteIndex < UUID_BYTE_OFFSETS.length; byteIndex += 1) {
73
- const textOffset = UUID_BYTE_OFFSETS[byteIndex];
74
- const high = hexValue(uuid.charCodeAt(textOffset));
75
- const low = hexValue(uuid.charCodeAt(textOffset + 1));
76
- if (high < 0 || low < 0) return new UuidSlugError("invalid_uuid", `Invalid UUID hex at offset ${textOffset}.`);
77
- target[offset + byteIndex] = high << 4 | low;
96
+ /*#__NO_SIDE_EFFECTS__*/
97
+ function uuidTextStart(e) {
98
+ if (e.length === 32) return -1;
99
+ if (e.length === 36) return 0;
100
+ if (e.length === 38 && e[0] === "{" && e[37] === "}") return 1;
101
+ if (e.length === 45) {
102
+ for (let t = 0; t < 9; t += 1) if ((e.charCodeAt(t) | 32) !== "urn:uuid:".charCodeAt(t)) return -2;
103
+ return 9;
78
104
  }
79
- return target;
80
- }
81
- function formatUuid(bytes, offset = 0) {
82
- const badRange = checkRange(bytes.length, offset, 16);
83
- if (badRange) return badRange;
84
- if (nativeToHex) {
85
- const hex = nativeToHex.call(bytes.length === 16 ? bytes : bytes.subarray(offset, offset + 16));
86
- return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
105
+ return -2;
106
+ }
107
+ /*#__NO_SIDE_EFFECTS__*/
108
+ function lowercaseHexValue(e) {
109
+ return y[e] ?? -1;
110
+ }
111
+ /*#__NO_SIDE_EFFECTS__*/
112
+ function parsedHexValue(e) {
113
+ return e >= 65 && e <= 70 ? e - 55 : /* @__PURE__ */ lowercaseHexValue(e);
114
+ }
115
+ function uuidStringToBytes(e, t, o = 0) {
116
+ let s = e;
117
+ if (typeof s != "string" && (s = c(s), typeof s != "string")) return s;
118
+ let l = /* @__PURE__ */ uuidTextStart(s);
119
+ if (l === -2) return new r(n, "UUID must be canonical, compact, a UUID URN, or brace-wrapped canonical text.");
120
+ let u = l !== -1;
121
+ if (u && (s[l + 8] !== "-" || s[l + 13] !== "-" || s[l + 18] !== "-" || s[l + 23] !== "-")) return new r(n, "UUID hyphen positions are invalid.");
122
+ let d = t === void 0 ? /* @__PURE__ */ a(16, o, 16) : /* @__PURE__ */ i(t, o, 16);
123
+ if (d) return d;
124
+ let f = t === void 0 ? /* @__PURE__ */ new Uint8Array(16) : w, p = 0, m = 0;
125
+ for (let e = 0; e < 16; e += 1) {
126
+ let t = u ? l + E[e] : e * 2, n = s.charCodeAt(t), r = s.charCodeAt(t + 1), i = b[n & 127] << 4 | b[r & 127];
127
+ p |= n | r, m |= i, f[e] = i;
87
128
  }
88
- let out = "";
89
- for (let i = 0; i < 16; i += 1) {
90
- if (i === 4 || i === 6 || i === 8 || i === 10) out += "-";
91
- const byte = bytes[offset + i] ?? 0;
92
- out += HEX_BYTES[byte];
129
+ if (p < 128 && m < 256) {
130
+ if (t === void 0) return f;
131
+ for (let e = 0; e < 16; e += 1) t[o + e] = f[e];
132
+ return t;
93
133
  }
94
- return out;
134
+ let h = 0;
135
+ for (let e = 0; e < 16; e += 1) {
136
+ h = u ? l + E[e] : e * 2;
137
+ let t = s.charCodeAt(h), n = s.charCodeAt(h + 1);
138
+ if ((t | n) > 127 || b[t] > 15 || b[n] > 15) break;
139
+ }
140
+ return new r(n, `Invalid UUID hex at offset ${h}; use 0-9, a-f, or A-F.`);
141
+ }
142
+ /*#__NO_SIDE_EFFECTS__*/
143
+ function bytesToUuidString(e, t = 0, n = d) {
144
+ let r = /* @__PURE__ */ o(e) ? e : /* @__PURE__ */ exactUuidByteView(e);
145
+ if (r instanceof Error) return r;
146
+ let i = typeof t == "string" ? Number.isNaN(Number(t)) : typeof t != "number", s = i ? 0 : t, c = resolveUuidTextCase(i ? t : n);
147
+ if (c instanceof Error) return c;
148
+ let l = /* @__PURE__ */ a(r.length, s, 16);
149
+ if (l) return l;
150
+ if (v) {
151
+ let e = r.length <= 32 ? v(r) : v(r.subarray(s, s + 16)), t = r.length <= 32 ? s * 2 : 0, n = /* @__PURE__ */ hyphenateHex(e, t);
152
+ return c === "uppercase" ? n.toUpperCase() : n;
153
+ }
154
+ return /* @__PURE__ */ formatUuidBytesUnchecked(r, s, c);
155
+ }
156
+ const hyphenateHex = /* @__NO_SIDE_EFFECTS__ */ (e, t) => `${e.slice(t, t + 8)}-${e.slice(t + 8, t + 12)}-${e.slice(t + 12, t + 16)}-${e.slice(t + 16, t + 20)}-${e.slice(t + 20, t + 32)}`;
157
+ /*#__NO_SIDE_EFFECTS__*/
158
+ function formatUuidBytesUnchecked(e, t = 0, n = d) {
159
+ if (_) return formatUuidBytesLatin1(_, e, t, n);
160
+ if (v) {
161
+ let r = /* @__PURE__ */ hyphenateHex(v(e), t * 2);
162
+ return n === "uppercase" ? r.toUpperCase() : r;
163
+ }
164
+ let r = n === "uppercase" ? C ??= hexCodes(g) : S ??= hexCodes(h), i = e[t] * 2, a = e[t + 1] * 2, o = e[t + 2] * 2, s = e[t + 3] * 2, c = e[t + 4] * 2, l = e[t + 5] * 2, u = e[t + 6] * 2, f = e[t + 7] * 2, p = e[t + 8] * 2, m = e[t + 9] * 2, y = e[t + 10] * 2, b = e[t + 11] * 2, x = e[t + 12] * 2, w = e[t + 13] * 2, T = e[t + 14] * 2, E = e[t + 15] * 2;
165
+ return String.fromCharCode(r[i], r[i + 1], r[a], r[a + 1], r[o], r[o + 1], r[s], r[s + 1], 45, r[c], r[c + 1], r[l], r[l + 1], 45, r[u], r[u + 1], r[f], r[f + 1], 45, r[p], r[p + 1], r[m], r[m + 1], 45, r[y], r[y + 1], r[b], r[b + 1], r[x], r[x + 1], r[w], r[w + 1], r[T], r[T + 1], r[E], r[E + 1]);
166
+ }
167
+ /*#__NO_SIDE_EFFECTS__*/
168
+ function uuidVersion(e, t = 0) {
169
+ return (e[t + 6] ?? 0) >>> 4;
170
+ }
171
+ /*#__NO_SIDE_EFFECTS__*/
172
+ function isRfcVariant(e, t = 0) {
173
+ return (e[t + 8] ?? 0) >>> 6 == 2;
174
+ }
175
+ /*#__NO_SIDE_EFFECTS__*/
176
+ function isUuidText(e) {
177
+ if (typeof e != "string") return !1;
178
+ let t = /* @__PURE__ */ uuidTextStart(e);
179
+ if (t === -2) return !1;
180
+ let n = t !== -1;
181
+ if (n && (e[t + 8] !== "-" || e[t + 13] !== "-" || e[t + 18] !== "-" || e[t + 23] !== "-")) return !1;
182
+ for (let r = 0; r < E.length; r += 1) {
183
+ let i = n ? t + E[r] : r * 2;
184
+ if (/* @__PURE__ */ parsedHexValue(e.charCodeAt(i)) < 0 || /* @__PURE__ */ parsedHexValue(e.charCodeAt(i + 1)) < 0) return !1;
185
+ }
186
+ return !0;
95
187
  }
96
- function uuidVersion(bytes, offset = 0) {
97
- return (bytes[offset + 6] ?? 0) >>> 4;
188
+ const D = _ ? /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ : /^(?:[0-9a-f][0-9a-f]){4}-(?:[0-9a-f][0-9a-f]){2}-(?:[0-9a-f][0-9a-f]){2}-(?:[0-9a-f][0-9a-f]){2}-(?:[0-9a-f][0-9a-f]){6}$/, O = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/, k = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/, A = /*#__PURE__*/ new RegExp(k.source, "i");
189
+ /*#__NO_SIDE_EFFECTS__*/
190
+ function isUuidV4Text(e) {
191
+ if (!/* @__PURE__ */ isUuidText(e)) return !1;
192
+ let t = /* @__PURE__ */ uuidTextStart(e), n = /* @__PURE__ */ parsedHexValue(e.charCodeAt(t === -1 ? 16 : t + 19));
193
+ return /* @__PURE__ */ parsedHexValue(e.charCodeAt(t === -1 ? 12 : t + 14)) === 4 && n >= 8 && n <= 11;
98
194
  }
99
- function isRfcVariant(bytes, offset = 0) {
100
- return (bytes[offset + 8] ?? 0) >>> 6 === 2;
195
+ /*#__NO_SIDE_EFFECTS__*/
196
+ function isUuidV7Text(e) {
197
+ if (typeof e == "string" && e.length === 36) return A.test(e);
198
+ if (!/* @__PURE__ */ isUuidText(e)) return !1;
199
+ let t = /* @__PURE__ */ uuidTextStart(e), n = /* @__PURE__ */ parsedHexValue(e.charCodeAt(t === -1 ? 16 : t + 19));
200
+ return /* @__PURE__ */ parsedHexValue(e.charCodeAt(t === -1 ? 12 : t + 14)) === 7 && n >= 8 && n <= 11;
101
201
  }
102
- function isUuidString(uuid) {
103
- if (!uuid || uuid.length !== UUID_LENGTH) return false;
104
- if (uuid[8] !== "-" || uuid[13] !== "-" || uuid[18] !== "-" || uuid[23] !== "-") return false;
105
- for (let i = 0; i < UUID_BYTE_OFFSETS.length; i += 1) {
106
- const offset = UUID_BYTE_OFFSETS[i];
107
- if (hexValue(uuid.charCodeAt(offset)) < 0 || hexValue(uuid.charCodeAt(offset + 1)) < 0) return false;
108
- }
109
- return true;
110
- }
111
- /** The string has already passed canonical validation, so the variant digit is a known hex value. */
112
- function stringHasRfcVariant(uuid) {
113
- return HEX_DECODE[uuid.charCodeAt(19)] >>> 2 === 2;
114
- }
115
- function isUuidV4String(uuid) {
116
- return isUuidString(uuid) && uuid[14] === "4" && stringHasRfcVariant(uuid);
117
- }
118
- function isUuidV7String(uuid) {
119
- return isUuidString(uuid) && uuid[14] === "7" && stringHasRfcVariant(uuid);
120
- }
121
- /**
122
- * The only BYTE-level predicate, and the asymmetry against `isUuidV4String` is deliberate: masking
123
- * accepts v7 alone, so a caller holding raw bytes has a reason to ask this and none to ask the v4
124
- * question. `isUuidV4Bytes` is absent because nothing needs it, not because it was overlooked —
125
- * add it when a caller appears, never for symmetry, since an export is permanent surface.
126
- */
127
- function isUuidV7Bytes(bytes) {
128
- return bytes.length === 16 && uuidVersion(bytes) === 7 && isRfcVariant(bytes);
129
- }
130
- function formatUuidSlug(bytes, offset = 0, alphabet = "base64url") {
131
- const badRange = checkRange(bytes.length, offset, 16);
132
- if (badRange) return badRange;
133
- const alpha = resolveSlugAlphabet(alphabet);
134
- if (alpha instanceof Error) return alpha;
135
- return encode(bytes.length === 16 ? bytes : bytes.subarray(offset, offset + 16), alpha);
136
- }
137
- /** Accepts either alphabet; the length says which, so there is nothing to pass and nothing to get wrong. */
138
- function parseUuidSlug(slug, out, offset = 0) {
139
- const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length];
140
- if (!alpha) return new UuidSlugError("invalid_uuid_slug", `UUID slug must be ${SLUG_LENGTHS} characters, got ${slug.length}.`);
141
- const target = out ?? /* @__PURE__ */ new Uint8Array(16);
142
- const result = decodeInto(slug, alpha, target, offset, 16);
143
- return result instanceof Error ? result : target;
144
- }
145
- function uuidToSlug(uuid, alphabet = "base64url") {
146
- const bytes = parseUuid(uuid);
147
- if (bytes instanceof Error) return bytes;
148
- return formatUuidSlug(bytes, 0, alphabet);
149
- }
150
- function slugToUuid(slug) {
151
- const bytes = parseUuidSlug(slug);
152
- if (bytes instanceof Error) return bytes;
153
- return formatUuid(bytes);
154
- }
155
- function isUuidSlug(slug) {
156
- if (!slug) return false;
157
- const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length];
158
- return alpha !== void 0 && isEncoded(slug, alpha, 16);
159
- }
160
- /** Read only the version/variant bytes after canonical validation, without decoding a whole UUID. */
161
- function slugByte(slug, alpha, offset) {
162
- const start = Math.floor(offset * 8 / alpha.bitsPerChar);
163
- const end = Math.floor((offset * 8 + 7) / alpha.bitsPerChar);
164
- let value = 0;
165
- for (let i = start; i <= end; i += 1) value = value << alpha.bitsPerChar | alpha.decode[slug.charCodeAt(i)];
166
- return value >>> (end + 1) * alpha.bitsPerChar - (offset + 1) * 8 & 255;
167
- }
168
- function isVersionedSlug(slug, version) {
169
- if (!isUuidSlug(slug)) return false;
170
- const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length];
171
- return slugByte(slug, alpha, 6) >>> 4 === version && slugByte(slug, alpha, 8) >>> 6 === 2;
172
- }
173
- function isUuidV4Slug(slug) {
174
- return isVersionedSlug(slug, 4);
175
- }
176
- function isUuidV7Slug(slug) {
177
- return isVersionedSlug(slug, 7);
178
- }
179
- /**
180
- * The 48-bit millisecond a UUIDv7 was minted at.
181
- *
182
- * It REFUSES anything that is not a v7, which is the whole point of the return type: the first six
183
- * bytes of a v4 are random, so reading them yields a confident, well-formed date drawn uniformly
184
- * from the next nine thousand years. A caller that passed the wrong version got that date silently,
185
- * and a freshness check built on it would accept or reject by coin flip while looking correct.
186
- *
187
- * Short input is reported separately from wrong version, because `uuidVersion` reads a missing byte
188
- * as zero and would otherwise blame a truncated buffer for holding a v0.
189
- */
190
- function extractUuidV7Timestamp(bytes, offset = 0) {
191
- const badRange = checkRange(bytes.length, offset, 16);
192
- if (badRange) return badRange;
193
- if (uuidVersion(bytes, offset) !== 7 || !isRfcVariant(bytes, offset)) return new UuidSlugError("invalid_uuid_version", "Timestamp is only defined for UUIDv7.");
194
- let timestamp = 0;
195
- for (let i = 0; i < 6; i += 1) timestamp = timestamp * 256 + (bytes[offset + i] ?? 0);
196
- return timestamp;
197
- }
198
- /**
199
- * Whether a v7's 74 random bits are anything other than all-zero or all-one — the two patterns a
200
- * generator produces when its entropy source is absent rather than working.
201
- *
202
- * Out of range answers `false`, and the direction is the whole point. Without the check the reads
203
- * below fall through `?? 0`, so a missing byte is indistinguishable from a zero byte and only ever
204
- * in the reassuring direction: a short buffer reported entropy PRESENT, and an offset past the end
205
- * reported the degenerate case for data that was never examined. Both are answers about bytes the
206
- * caller does not have. `false` is the honest one — it means "cannot be shown to carry entropy",
207
- * which is what a caller acts on, and it is what a truly degenerate id gets too.
208
- *
209
- * Boolean rather than `UuidSlugError | boolean` because the sole use is a guard in a condition; an error
210
- * return would have every call site unwrap a value it is already treating as a yes/no.
211
- */
212
- function hasUuidV7Entropy(bytes, offset = 0) {
213
- if (checkRange(bytes.length, offset, 16)) return false;
214
- const randA = ((bytes[offset + 6] ?? 0) & 15) << 8 | (bytes[offset + 7] ?? 0);
215
- const randBFirst = (bytes[offset + 8] ?? 0) & 63;
216
- let restZero = true;
217
- let restMax = true;
218
- for (let i = 9; i < 16; i += 1) {
219
- const byte = bytes[offset + i] ?? 0;
220
- if (byte !== 0) restZero = false;
221
- if (byte !== 255) restMax = false;
222
- }
223
- return !(randA === 0 && randBFirst === 0 && restZero) && !(randA === 4095 && randBFirst === 63 && restMax);
202
+ function isUuidString(e) {
203
+ return typeof e == "string" && D.test(e);
204
+ }
205
+ function isUuidV4String(e) {
206
+ return typeof e == "string" && O.test(e);
207
+ }
208
+ function isUuidV7String(e) {
209
+ return typeof e == "string" && k.test(e);
210
+ }
211
+ /*#__NO_SIDE_EFFECTS__*/
212
+ function isUuidBytes(e) {
213
+ return /* @__PURE__ */ o(e) && e.length === 16;
214
+ }
215
+ /*#__NO_SIDE_EFFECTS__*/
216
+ function isUuidV4Bytes(e) {
217
+ return /* @__PURE__ */ isUuidBytes(e) && /* @__PURE__ */ uuidVersion(e) === 4 && /* @__PURE__ */ isRfcVariant(e);
218
+ }
219
+ /*#__NO_SIDE_EFFECTS__*/
220
+ function isUuidV7Bytes(e) {
221
+ return /* @__PURE__ */ isUuidBytes(e) && /* @__PURE__ */ uuidVersion(e) === 7 && /* @__PURE__ */ isRfcVariant(e);
222
+ }
223
+ /*#__NO_SIDE_EFFECTS__*/
224
+ function uuidTimestampFromBytesUnchecked(e, t) {
225
+ let n = 0;
226
+ for (let r = 0; r < 6; r += 1) n = n * 256 + (e[t + r] ?? 0);
227
+ return n;
224
228
  }
225
229
  //#endregion
226
- export { extractUuidV7Timestamp, formatUuid, formatUuidSlug, hasUuidV7Entropy, isRfcVariant, isUuidSlug, isUuidString, isUuidV4Slug, isUuidV4String, isUuidV7Bytes, isUuidV7Slug, isUuidV7String, parseUuid, parseUuidSlug, resolveSlugAlphabet, slugToUuid, uuidToSlug, uuidVersion };
230
+ export { m as MAX_UUID, p as NIL_UUID, r as UuidSlugError, bytesToUuidString, exactUuidByteView, formatUuidBytesUnchecked, invalidUuidBytes, invalidUuidTextCase, isRfcVariant, isUuidBytes, isUuidString, isUuidText, isUuidTextCase, isUuidV4Bytes, isUuidV4String, isUuidV4Text, isUuidV7Bytes, isUuidV7String, isUuidV7Text, resolveUuidTextCase, uuidStringToBytes, uuidTimestampFromBytesUnchecked, uuidVersion };
227
231
 
228
232
  //# sourceMappingURL=uuid.js.map
package/dist/uuid.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"uuid.js","names":[],"sources":["../src/uuid.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport { BASE32HEX, BASE64URL, decodeInto, encode, isEncoded } from \"./alphabet\";\nimport type { Alphabet } from \"./alphabet\";\nimport { checkRange, UuidSlugError } from \"./errors\";\nimport type {\n UuidSlug,\n UuidString,\n UuidV4Slug,\n UuidV4String,\n UuidV7Slug,\n UuidV7String,\n} from \"./types\";\n\nconst HEX = \"0123456789abcdef\";\n// Probe once and allocate the byte-pair fallback only on engines that need it.\nconst nativeToHex = (Uint8Array.prototype as { toHex?: () => string }).toHex;\nconst HEX_BYTES = nativeToHex\n ? []\n : /*#__PURE__*/ Array.from(\n { length: 256 },\n (_, byte) => (HEX[byte >>> 4] as string) + (HEX[byte & 15] as string),\n );\nconst HEX_DECODE = new Int8Array(128).fill(-1);\nfor (let i = 0; i < 10; i += 1) HEX_DECODE[48 + i] = i;\nfor (let i = 0; i < 6; i += 1) HEX_DECODE[97 + i] = 10 + i;\n\nconst UUID_LENGTH = 36;\nconst UUID_BYTE_OFFSETS = [0, 2, 4, 6, 9, 11, 14, 16, 19, 21, 24, 26, 28, 30, 32, 34] as const;\n\n/**\n * The alphabets a plain slug may be written in. base64url is the default and the shortest;\n * base32hex costs four more characters and buys the one property base64url cannot offer: its\n * characters are in ASCII order, so base32hex slugs of UUIDv7s sort chronologically as plain\n * strings. Only the lowercase spelling decodes — the table is built from `chars` — so slugs have\n * no second spelling, as everywhere else in this format.\n *\n * MASKED slugs are always base64url (Art's ruling, 2026-08-12). Sort order there would be order of\n * ciphertext, which carries nothing, so the extra characters would buy only the case-insensitivity.\n */\nconst SLUG_ALPHABETS: { base32hex: Alphabet; base64url: Alphabet } = {\n base32hex: BASE32HEX,\n base64url: BASE64URL,\n} as const;\n\n/**\n * Callers name an alphabet rather than passing one. `Alphabet` holds a decode table and a bit\n * width — internals that would become public surface the moment the type escaped — and accepting\n * an arbitrary one would also open a second extension point beside `MaskSchema`, which this\n * package documents as its only one. A union of two names cannot be widened by a caller at all, so\n * there is nothing to validate.\n */\nexport type SlugAlphabet = keyof typeof SLUG_ALPHABETS;\n\n/** Reject inherited property names as well as unknown names from JavaScript callers. */\nexport function resolveSlugAlphabet(alphabet: SlugAlphabet): Alphabet | UuidSlugError {\n return Object.hasOwn(SLUG_ALPHABETS, alphabet)\n ? SLUG_ALPHABETS[alphabet]\n : new UuidSlugError(\n \"invalid_uuid_slug\",\n `Unknown slug alphabet \"${alphabet}\"; expected ${Object.keys(SLUG_ALPHABETS).join(\" or \")}.`,\n );\n}\n\n/** Characters needed for 16 bytes: 22 in base64url, 26 in base32hex. */\nfunction slugLength(alpha: Alphabet) {\n return Math.ceil(128 / alpha.bitsPerChar);\n}\n\n/**\n * Length -> alphabet, which is why decoding takes no alphabet argument: the two lengths are\n * disjoint, so a slug names its own encoding and a caller cannot pick the wrong one. Indexed\n * rather than searched because every decode and every type guard pays this lookup.\n */\nconst SLUG_ALPHABET_BY_LENGTH: readonly (Alphabet | undefined)[] = Object.values(\n SLUG_ALPHABETS,\n).reduce<(Alphabet | undefined)[]>((table, alpha) => {\n table[slugLength(alpha)] = alpha;\n return table;\n}, []);\n\nconst SLUG_LENGTHS = Object.values(SLUG_ALPHABETS)\n .map((alpha) => `${slugLength(alpha)} (${alpha.name})`)\n .join(\" or \");\n\nfunction hexValue(code: number) {\n return HEX_DECODE[code] ?? -1;\n}\n\nexport function parseUuid(uuid: string, out?: Uint8Array, offset = 0): UuidSlugError | Uint8Array {\n if (uuid.length !== UUID_LENGTH)\n return new UuidSlugError(\"invalid_uuid\", \"UUID must be 36 characters.\");\n if (uuid[8] !== \"-\" || uuid[13] !== \"-\" || uuid[18] !== \"-\" || uuid[23] !== \"-\") {\n return new UuidSlugError(\"invalid_uuid\", \"UUID hyphen positions are invalid.\");\n }\n\n const target = out ?? new Uint8Array(16);\n const badRange = checkRange(target.length, offset, 16);\n if (badRange) return badRange;\n\n for (let byteIndex = 0; byteIndex < UUID_BYTE_OFFSETS.length; byteIndex += 1) {\n const textOffset = UUID_BYTE_OFFSETS[byteIndex] as number;\n const high = hexValue(uuid.charCodeAt(textOffset));\n const low = hexValue(uuid.charCodeAt(textOffset + 1));\n if (high < 0 || low < 0)\n return new UuidSlugError(\"invalid_uuid\", `Invalid UUID hex at offset ${textOffset}.`);\n target[offset + byteIndex] = (high << 4) | low;\n }\n return target;\n}\n\nexport function formatUuid(bytes: Uint8Array, offset = 0): UuidSlugError | UuidString {\n const badRange = checkRange(bytes.length, offset, 16);\n if (badRange) return badRange;\n if (nativeToHex) {\n const hex = nativeToHex.call(bytes.length === 16 ? bytes : bytes.subarray(offset, offset + 16));\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n }\n let out = \"\";\n for (let i = 0; i < 16; i += 1) {\n if (i === 4 || i === 6 || i === 8 || i === 10) out += \"-\";\n const byte = bytes[offset + i] ?? 0;\n out += HEX_BYTES[byte];\n }\n return out;\n}\n\nexport function uuidVersion(bytes: Uint8Array, offset = 0): number {\n return (bytes[offset + 6] ?? 0) >>> 4;\n}\n\nexport function isRfcVariant(bytes: Uint8Array, offset = 0): boolean {\n return (bytes[offset + 8] ?? 0) >>> 6 === 0b10;\n}\n\n// Predicates inspect the same hex table as parsing without allocating output bytes or Errors.\nexport function isUuidString(uuid: null | string | undefined): uuid is UuidString {\n if (!uuid || uuid.length !== UUID_LENGTH) return false;\n if (uuid[8] !== \"-\" || uuid[13] !== \"-\" || uuid[18] !== \"-\" || uuid[23] !== \"-\") return false;\n for (let i = 0; i < UUID_BYTE_OFFSETS.length; i += 1) {\n const offset = UUID_BYTE_OFFSETS[i] as number;\n if (hexValue(uuid.charCodeAt(offset)) < 0 || hexValue(uuid.charCodeAt(offset + 1)) < 0)\n return false;\n }\n return true;\n}\n\n/** The string has already passed canonical validation, so the variant digit is a known hex value. */\nfunction stringHasRfcVariant(uuid: string): boolean {\n return (HEX_DECODE[uuid.charCodeAt(19)] as number) >>> 2 === 2;\n}\n\nexport function isUuidV4String(uuid: null | string | undefined): uuid is UuidV4String {\n return isUuidString(uuid) && uuid[14] === \"4\" && stringHasRfcVariant(uuid);\n}\n\nexport function isUuidV7String(uuid: null | string | undefined): uuid is UuidV7String {\n return isUuidString(uuid) && uuid[14] === \"7\" && stringHasRfcVariant(uuid);\n}\n\n/**\n * The only BYTE-level predicate, and the asymmetry against `isUuidV4String` is deliberate: masking\n * accepts v7 alone, so a caller holding raw bytes has a reason to ask this and none to ask the v4\n * question. `isUuidV4Bytes` is absent because nothing needs it, not because it was overlooked —\n * add it when a caller appears, never for symmetry, since an export is permanent surface.\n */\nexport function isUuidV7Bytes(bytes: Uint8Array): boolean {\n return bytes.length === 16 && uuidVersion(bytes) === 7 && isRfcVariant(bytes);\n}\n\nexport function formatUuidSlug(\n bytes: Uint8Array,\n offset = 0,\n alphabet: SlugAlphabet = \"base64url\",\n): UuidSlugError | UuidSlug {\n const badRange = checkRange(bytes.length, offset, 16);\n if (badRange) return badRange;\n // Unreachable from TypeScript, where the name is a two-member union. Reached from JavaScript,\n // which is why it answers rather than indexing into `undefined`.\n const alpha = resolveSlugAlphabet(alphabet);\n if (alpha instanceof Error) return alpha;\n return encode(bytes.length === 16 ? bytes : bytes.subarray(offset, offset + 16), alpha);\n}\n\n/** Accepts either alphabet; the length says which, so there is nothing to pass and nothing to get wrong. */\nexport function parseUuidSlug(\n slug: string,\n out?: Uint8Array,\n offset = 0,\n): UuidSlugError | Uint8Array {\n const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length];\n if (!alpha)\n return new UuidSlugError(\n \"invalid_uuid_slug\",\n `UUID slug must be ${SLUG_LENGTHS} characters, got ${slug.length}.`,\n );\n const target = out ?? new Uint8Array(16);\n const result = decodeInto(slug, alpha, target, offset, 16);\n return result instanceof Error ? result : target;\n}\n\nexport function uuidToSlug(\n uuid: string,\n alphabet: SlugAlphabet = \"base64url\",\n): UuidSlugError | UuidSlug {\n const bytes = parseUuid(uuid);\n if (bytes instanceof Error) return bytes;\n return formatUuidSlug(bytes, 0, alphabet);\n}\n\nexport function slugToUuid(slug: string): UuidSlugError | UuidString {\n const bytes = parseUuidSlug(slug);\n if (bytes instanceof Error) return bytes;\n return formatUuid(bytes);\n}\n\nexport function isUuidSlug(slug: null | string | undefined): slug is UuidSlug {\n if (!slug) return false;\n const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length];\n return alpha !== undefined && isEncoded(slug, alpha, 16);\n}\n\n/** Read only the version/variant bytes after canonical validation, without decoding a whole UUID. */\nfunction slugByte(slug: string, alpha: Alphabet, offset: number): number {\n const start = Math.floor((offset * 8) / alpha.bitsPerChar);\n const end = Math.floor((offset * 8 + 7) / alpha.bitsPerChar);\n let value = 0;\n for (let i = start; i <= end; i += 1)\n value = (value << alpha.bitsPerChar) | (alpha.decode[slug.charCodeAt(i)] as number);\n return (value >>> ((end + 1) * alpha.bitsPerChar - (offset + 1) * 8)) & 255;\n}\n\nfunction isVersionedSlug(slug: null | string | undefined, version: number): boolean {\n if (!isUuidSlug(slug)) return false;\n const alpha = SLUG_ALPHABET_BY_LENGTH[slug.length] as Alphabet;\n return slugByte(slug, alpha, 6) >>> 4 === version && slugByte(slug, alpha, 8) >>> 6 === 2;\n}\n\nexport function isUuidV4Slug(slug: null | string | undefined): slug is UuidV4Slug {\n return isVersionedSlug(slug, 4);\n}\n\nexport function isUuidV7Slug(slug: null | string | undefined): slug is UuidV7Slug {\n return isVersionedSlug(slug, 7);\n}\n\n/**\n * The 48-bit millisecond a UUIDv7 was minted at.\n *\n * It REFUSES anything that is not a v7, which is the whole point of the return type: the first six\n * bytes of a v4 are random, so reading them yields a confident, well-formed date drawn uniformly\n * from the next nine thousand years. A caller that passed the wrong version got that date silently,\n * and a freshness check built on it would accept or reject by coin flip while looking correct.\n *\n * Short input is reported separately from wrong version, because `uuidVersion` reads a missing byte\n * as zero and would otherwise blame a truncated buffer for holding a v0.\n */\nexport function extractUuidV7Timestamp(bytes: Uint8Array, offset = 0): UuidSlugError | number {\n const badRange = checkRange(bytes.length, offset, 16);\n if (badRange) return badRange;\n if (uuidVersion(bytes, offset) !== 7 || !isRfcVariant(bytes, offset))\n return new UuidSlugError(\"invalid_uuid_version\", \"Timestamp is only defined for UUIDv7.\");\n let timestamp = 0;\n for (let i = 0; i < 6; i += 1) timestamp = timestamp * 256 + (bytes[offset + i] ?? 0);\n return timestamp;\n}\n\n/**\n * Whether a v7's 74 random bits are anything other than all-zero or all-one — the two patterns a\n * generator produces when its entropy source is absent rather than working.\n *\n * Out of range answers `false`, and the direction is the whole point. Without the check the reads\n * below fall through `?? 0`, so a missing byte is indistinguishable from a zero byte and only ever\n * in the reassuring direction: a short buffer reported entropy PRESENT, and an offset past the end\n * reported the degenerate case for data that was never examined. Both are answers about bytes the\n * caller does not have. `false` is the honest one — it means \"cannot be shown to carry entropy\",\n * which is what a caller acts on, and it is what a truly degenerate id gets too.\n *\n * Boolean rather than `UuidSlugError | boolean` because the sole use is a guard in a condition; an error\n * return would have every call site unwrap a value it is already treating as a yes/no.\n */\nexport function hasUuidV7Entropy(bytes: Uint8Array, offset = 0): boolean {\n if (checkRange(bytes.length, offset, 16)) return false;\n const randA = (((bytes[offset + 6] ?? 0) & 0x0f) << 8) | (bytes[offset + 7] ?? 0);\n const randBFirst = (bytes[offset + 8] ?? 0) & 0x3f;\n let restZero = true;\n let restMax = true;\n for (let i = 9; i < 16; i += 1) {\n const byte = bytes[offset + i] ?? 0;\n if (byte !== 0x00) restZero = false;\n if (byte !== 0xff) restMax = false;\n }\n return (\n !(randA === 0 && randBFirst === 0 && restZero) &&\n !(randA === 0x0fff && randBFirst === 0x3f && restMax)\n );\n}\n"],"mappings":";;;;;AAcA,MAAM,MAAM;AAEZ,MAAM,cAAe,WAAW,UAAuC;AACvE,MAAM,YAAY,cACd,CAAC,IACa,oBAAM,KAClB,EAAE,QAAQ,IAAI,IACb,GAAG,SAAU,IAAI,SAAS,KAAiB,IAAI,OAAO,GACzD;AACJ,MAAM,8BAAa,IAAI,UAAU,GAAG,EAAA,CAAE,KAAK,EAAE;AAC7C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG,WAAW,KAAK,KAAK;AACrD,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,WAAW,KAAK,KAAK,KAAK;AAEzD,MAAM,cAAc;AACpB,MAAM,oBAAoB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAAE;;;;;;;;;;;AAYpF,MAAM,iBAA+D;CACnE,WAAW;CACX,WAAW;AACb;;AAYA,SAAgB,oBAAoB,UAAkD;CACpF,OAAO,OAAO,OAAO,gBAAgB,QAAQ,IACzC,eAAe,YACf,IAAI,cACF,qBACA,0BAA0B,SAAS,cAAc,OAAO,KAAK,cAAc,CAAC,CAAC,KAAK,MAAM,EAAE,EAC5F;AACN;;AAGA,SAAS,WAAW,OAAiB;CACnC,OAAO,KAAK,KAAK,MAAM,MAAM,WAAW;AAC1C;;;;;;AAOA,MAAM,0BAA6D,OAAO,OACxE,cACF,CAAC,CAAC,QAAkC,OAAO,UAAU;CACnD,MAAM,WAAW,KAAK,KAAK;CAC3B,OAAO;AACT,GAAG,CAAC,CAAC;AAEL,MAAM,eAAe,OAAO,OAAO,cAAc,CAAC,CAC/C,KAAK,UAAU,GAAG,WAAW,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,CAAC,CACtD,KAAK,MAAM;AAEd,SAAS,SAAS,MAAc;CAC9B,OAAO,WAAW,SAAS;AAC7B;AAEA,SAAgB,UAAU,MAAc,KAAkB,SAAS,GAA+B;CAChG,IAAI,KAAK,WAAW,aAClB,OAAO,IAAI,cAAc,gBAAgB,6BAA6B;CACxE,IAAI,KAAK,OAAO,OAAO,KAAK,QAAQ,OAAO,KAAK,QAAQ,OAAO,KAAK,QAAQ,KAC1E,OAAO,IAAI,cAAc,gBAAgB,oCAAoC;CAG/E,MAAM,SAAS,uBAAO,IAAI,WAAW,EAAE;CACvC,MAAM,WAAW,WAAW,OAAO,QAAQ,QAAQ,EAAE;CACrD,IAAI,UAAU,OAAO;CAErB,KAAK,IAAI,YAAY,GAAG,YAAY,kBAAkB,QAAQ,aAAa,GAAG;EAC5E,MAAM,aAAa,kBAAkB;EACrC,MAAM,OAAO,SAAS,KAAK,WAAW,UAAU,CAAC;EACjD,MAAM,MAAM,SAAS,KAAK,WAAW,aAAa,CAAC,CAAC;EACpD,IAAI,OAAO,KAAK,MAAM,GACpB,OAAO,IAAI,cAAc,gBAAgB,8BAA8B,WAAW,EAAE;EACtF,OAAO,SAAS,aAAc,QAAQ,IAAK;CAC7C;CACA,OAAO;AACT;AAEA,SAAgB,WAAW,OAAmB,SAAS,GAA+B;CACpF,MAAM,WAAW,WAAW,MAAM,QAAQ,QAAQ,EAAE;CACpD,IAAI,UAAU,OAAO;CACrB,IAAI,aAAa;EACf,MAAM,MAAM,YAAY,KAAK,MAAM,WAAW,KAAK,QAAQ,MAAM,SAAS,QAAQ,SAAS,EAAE,CAAC;EAC9F,OAAO,GAAG,IAAI,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,GAAG,IAAI,MAAM,EAAE;CACzG;CACA,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG;EAC9B,IAAI,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,IAAI,OAAO;EACtD,MAAM,OAAO,MAAM,SAAS,MAAM;EAClC,OAAO,UAAU;CACnB;CACA,OAAO;AACT;AAEA,SAAgB,YAAY,OAAmB,SAAS,GAAW;CACjE,QAAQ,MAAM,SAAS,MAAM,OAAO;AACtC;AAEA,SAAgB,aAAa,OAAmB,SAAS,GAAY;CACnE,QAAQ,MAAM,SAAS,MAAM,OAAO,MAAM;AAC5C;AAGA,SAAgB,aAAa,MAAqD;CAChF,IAAI,CAAC,QAAQ,KAAK,WAAW,aAAa,OAAO;CACjD,IAAI,KAAK,OAAO,OAAO,KAAK,QAAQ,OAAO,KAAK,QAAQ,OAAO,KAAK,QAAQ,KAAK,OAAO;CACxF,KAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,KAAK,GAAG;EACpD,MAAM,SAAS,kBAAkB;EACjC,IAAI,SAAS,KAAK,WAAW,MAAM,CAAC,IAAI,KAAK,SAAS,KAAK,WAAW,SAAS,CAAC,CAAC,IAAI,GACnF,OAAO;CACX;CACA,OAAO;AACT;;AAGA,SAAS,oBAAoB,MAAuB;CAClD,OAAQ,WAAW,KAAK,WAAW,EAAE,OAAkB,MAAM;AAC/D;AAEA,SAAgB,eAAe,MAAuD;CACpF,OAAO,aAAa,IAAI,KAAK,KAAK,QAAQ,OAAO,oBAAoB,IAAI;AAC3E;AAEA,SAAgB,eAAe,MAAuD;CACpF,OAAO,aAAa,IAAI,KAAK,KAAK,QAAQ,OAAO,oBAAoB,IAAI;AAC3E;;;;;;;AAQA,SAAgB,cAAc,OAA4B;CACxD,OAAO,MAAM,WAAW,MAAM,YAAY,KAAK,MAAM,KAAK,aAAa,KAAK;AAC9E;AAEA,SAAgB,eACd,OACA,SAAS,GACT,WAAyB,aACC;CAC1B,MAAM,WAAW,WAAW,MAAM,QAAQ,QAAQ,EAAE;CACpD,IAAI,UAAU,OAAO;CAGrB,MAAM,QAAQ,oBAAoB,QAAQ;CAC1C,IAAI,iBAAiB,OAAO,OAAO;CACnC,OAAO,OAAO,MAAM,WAAW,KAAK,QAAQ,MAAM,SAAS,QAAQ,SAAS,EAAE,GAAG,KAAK;AACxF;;AAGA,SAAgB,cACd,MACA,KACA,SAAS,GACmB;CAC5B,MAAM,QAAQ,wBAAwB,KAAK;CAC3C,IAAI,CAAC,OACH,OAAO,IAAI,cACT,qBACA,qBAAqB,aAAa,mBAAmB,KAAK,OAAO,EACnE;CACF,MAAM,SAAS,uBAAO,IAAI,WAAW,EAAE;CACvC,MAAM,SAAS,WAAW,MAAM,OAAO,QAAQ,QAAQ,EAAE;CACzD,OAAO,kBAAkB,QAAQ,SAAS;AAC5C;AAEA,SAAgB,WACd,MACA,WAAyB,aACC;CAC1B,MAAM,QAAQ,UAAU,IAAI;CAC5B,IAAI,iBAAiB,OAAO,OAAO;CACnC,OAAO,eAAe,OAAO,GAAG,QAAQ;AAC1C;AAEA,SAAgB,WAAW,MAA0C;CACnE,MAAM,QAAQ,cAAc,IAAI;CAChC,IAAI,iBAAiB,OAAO,OAAO;CACnC,OAAO,WAAW,KAAK;AACzB;AAEA,SAAgB,WAAW,MAAmD;CAC5E,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,QAAQ,wBAAwB,KAAK;CAC3C,OAAO,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,EAAE;AACzD;;AAGA,SAAS,SAAS,MAAc,OAAiB,QAAwB;CACvE,MAAM,QAAQ,KAAK,MAAO,SAAS,IAAK,MAAM,WAAW;CACzD,MAAM,MAAM,KAAK,OAAO,SAAS,IAAI,KAAK,MAAM,WAAW;CAC3D,IAAI,QAAQ;CACZ,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,KAAK,GACjC,QAAS,SAAS,MAAM,cAAgB,MAAM,OAAO,KAAK,WAAW,CAAC;CACxE,OAAQ,WAAY,MAAM,KAAK,MAAM,eAAe,SAAS,KAAK,IAAM;AAC1E;AAEA,SAAS,gBAAgB,MAAiC,SAA0B;CAClF,IAAI,CAAC,WAAW,IAAI,GAAG,OAAO;CAC9B,MAAM,QAAQ,wBAAwB,KAAK;CAC3C,OAAO,SAAS,MAAM,OAAO,CAAC,MAAM,MAAM,WAAW,SAAS,MAAM,OAAO,CAAC,MAAM,MAAM;AAC1F;AAEA,SAAgB,aAAa,MAAqD;CAChF,OAAO,gBAAgB,MAAM,CAAC;AAChC;AAEA,SAAgB,aAAa,MAAqD;CAChF,OAAO,gBAAgB,MAAM,CAAC;AAChC;;;;;;;;;;;;AAaA,SAAgB,uBAAuB,OAAmB,SAAS,GAA2B;CAC5F,MAAM,WAAW,WAAW,MAAM,QAAQ,QAAQ,EAAE;CACpD,IAAI,UAAU,OAAO;CACrB,IAAI,YAAY,OAAO,MAAM,MAAM,KAAK,CAAC,aAAa,OAAO,MAAM,GACjE,OAAO,IAAI,cAAc,wBAAwB,uCAAuC;CAC1F,IAAI,YAAY;CAChB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,YAAY,YAAY,OAAO,MAAM,SAAS,MAAM;CACnF,OAAO;AACT;;;;;;;;;;;;;;;AAgBA,SAAgB,iBAAiB,OAAmB,SAAS,GAAY;CACvE,IAAI,WAAW,MAAM,QAAQ,QAAQ,EAAE,GAAG,OAAO;CACjD,MAAM,UAAW,MAAM,SAAS,MAAM,KAAK,OAAS,KAAM,MAAM,SAAS,MAAM;CAC/E,MAAM,cAAc,MAAM,SAAS,MAAM,KAAK;CAC9C,IAAI,WAAW;CACf,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG;EAC9B,MAAM,OAAO,MAAM,SAAS,MAAM;EAClC,IAAI,SAAS,GAAM,WAAW;EAC9B,IAAI,SAAS,KAAM,UAAU;CAC/B;CACA,OACE,EAAE,UAAU,KAAK,eAAe,KAAK,aACrC,EAAE,UAAU,QAAU,eAAe,MAAQ;AAEjD"}
1
+ {"version":3,"file":"uuid.js","names":["UuidSlugError","INVALID_BUFFER","value","bytes","uuidByteView","NIL_UUID","MAX_UUID","HEX","UPPERCASE_HEX","textCase","INVALID_OPTIONS","createLatin1Scratch","runtime","nativeToHex","HEX_DECODE","i","HEX_NIBBLES","uuidTextScratch","lowercaseHexCodes","uppercaseHexCodes","codes","byte","digits","scratch","create","UUID_LENGTH","hyphen","text","code0","offset","code1","code2","code3","code4","code5","code6","code7","code8","code9","code10","code11","code12","code13","code14","code15","decodedUuidScratch","UUID_BYTE_OFFSETS","index","code","uuidText","uuid","normalizeUuidStringInput","textStart","INVALID_UUID","hyphenated","badRange","out","target","pairs","byteIndex","textOffset","high","low","pair","UUID_TEXT_LOWERCASE","view","caseIsSecond","offsetOrCase","byteOffset","selectedCase","hex","a","b","c","d","e","f","g","h","j","k","l","m","n","o","p","UUID_RE","UUID_V4_RE","UUID_V7_RE","UUID_V7_TEXT_RE","variant","timestamp"],"sources":["../src/uuid.ts"],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { SlugAlphabet } from "./slug.js";
4
+ import { PlainUuidV4Slug } from "./types.js";
5
+ //#region src/v4-slug.d.ts
6
+ /**
7
+ * Generate a plain UUIDv4 slug with platform randomness, using base64url by default. base32hex is
8
+ * filesystem-safe but cannot make random UUIDv4 values chronological.
9
+ *
10
+ * @param alphabet - Output spelling. Omit for the shorter 22-character base64url form.
11
+ * @throws `UuidSlugError` with code `rng_unavailable` when generation cannot obtain
12
+ * secure randomness.
13
+ */
14
+ export declare function generatePlainUuidV4Slug(alphabet?: SlugAlphabet): PlainUuidV4Slug;
15
+ //#endregion
16
+ //# sourceMappingURL=v4-slug.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"v4-slug.d.ts","names":[],"sources":["../src/v4-slug.ts"],"mappings":";;;;;;;;;;;;;wBAkBgB,wBAAwB,WAAW,eAAe"}
@@ -0,0 +1,16 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { generatedOrThrow as e } from "./errors.js";
4
+ import { BASE64URL_NAME as t } from "./base64url-name.js";
5
+ import { encode as n } from "./alphabet.js";
6
+ import { resolveSlugAlphabet as r } from "./slug.js";
7
+ import { drawUuidV4Scratch as i } from "./v4.js";
8
+ //#region src/v4-slug.ts
9
+ function generatePlainUuidV4Slug(a = t) {
10
+ let o = /* @__PURE__ */ r(a);
11
+ return o instanceof Error ? o : /* @__PURE__ */ n(e(i()), o);
12
+ }
13
+ //#endregion
14
+ export { generatePlainUuidV4Slug };
15
+
16
+ //# sourceMappingURL=v4-slug.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"v4-slug.js","names":["BASE64URL_NAME","resolved","alphabet","generatedOrThrow","drawUuidV4Scratch"],"sources":["../src/v4-slug.ts"],"mappings":";;;;;;;;AAmBA,SAAgB,wBACd,IAAyBA,GACQ;CAEjC,IAAMC,IAAW,kBAAoBC,CAAQ;CAE7C,OADID,aAAoB,QAAcA,IAC/B,kBAAOE,EAAiBC,EAAkB,CAAC,GAAGH,CAAQ;AAC/D"}
package/dist/v4.d.ts ADDED
@@ -0,0 +1,42 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { UuidSlugError, UuidSlugErrorCode, isUuidSlugError } from "./errors.js";
4
+ import { UUID_TEXT_LOWERCASE, UuidOutput, UuidRandomFill, UuidTextCase, UuidTextCaseArguments, UuidV4Bytes, UuidV4String, UuidV4StringFor } from "./types.js";
5
+ import { isUuidV4Bytes, isUuidV4String, isUuidV4Text } from "./uuid.js";
6
+ //#region src/v4.d.ts
7
+ /**
8
+ * Generate UUIDv4 bytes with platform randomness in a new plain 16-byte `Uint8Array`.
9
+ *
10
+ * @throws `UuidSlugError` with code `rng_unavailable` when generation cannot obtain
11
+ * secure randomness.
12
+ */
13
+ export declare function generateUuidV4Bytes(): UuidV4Bytes;
14
+ /**
15
+ * Write UUIDv4 bytes into caller-owned storage only after successful generation.
16
+ *
17
+ * @param output - Caller-owned array that receives the 16 UUID bytes.
18
+ * @param outputOffset - Zero-based index where writing starts. Omit to start at index 0. Bytes
19
+ * outside the written range stay unchanged.
20
+ */
21
+ export declare function generateUuidV4Bytes<Output extends Uint8Array>(output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
22
+ /**
23
+ * Generate UUIDv4 text with platform cryptographic randomness, lowercase by default.
24
+ * Native runtime results are trusted without additional output guarantees.
25
+ *
26
+ * @param textCase - Built-in output spelling. Omit for lowercase.
27
+ * @throws `UuidSlugError` with code `rng_unavailable` when generation cannot obtain
28
+ * secure randomness.
29
+ */
30
+ export declare function generateUuidV4<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(...textCase: UuidTextCaseArguments<Case>): UuidV4StringFor<Case>;
31
+ /**
32
+ * Generate UUIDv4 text from the caller's synchronous random-byte source. The callback must fill
33
+ * all 16 bytes. Returned or thrown errors become generation failures; the package cannot detect a
34
+ * successful partial or weak fill.
35
+ *
36
+ * @param fillRandom - Fill the complete array from the caller's chosen source.
37
+ * @param textCase - Built-in output spelling. Omit for lowercase.
38
+ */
39
+ export declare function generateUuidV4WithRandomFill<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(fillRandom: UuidRandomFill, ...textCase: UuidTextCaseArguments<Case>): UuidV4StringFor<Case> | UuidSlugError;
40
+ //#endregion
41
+ export { UuidSlugError };
42
+ //# sourceMappingURL=v4.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"v4.d.ts","names":[],"sources":["../src/v4.ts"],"mappings":";;;;;;;;;;;;wBAoDgB,uBAAuB;;;;;;;;wBAQvB,oBAAoB,eAAe,YACjD,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;;;;wBA2FR,eAAe,aAAa,sBAAsB,wBAC7D,UAAU,sBAAsB,QAClC,gBAAgB;;;;;;;;;wBA4CH,6BACd,aAAa,sBAAsB,qBAEnC,YAAY,mBACT,UAAU,sBAAsB,QAClC,gBAAgB,QAAQ"}