@anizoptera/uuid-slug 0.5.0 → 0.7.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 (141) hide show
  1. package/AGENTS.md +14 -0
  2. package/README.md +54 -140
  3. package/dist/alphabet.d.ts +1 -3
  4. package/dist/alphabet.d.ts.map +1 -1
  5. package/dist/alphabet.js +33 -91
  6. package/dist/alphabet.js.map +1 -1
  7. package/dist/base64url-name.d.ts +1 -3
  8. package/dist/base64url-name.d.ts.map +1 -1
  9. package/dist/base64url-name.js +2 -3
  10. package/dist/errors.d.ts +1 -3
  11. package/dist/errors.d.ts.map +1 -1
  12. package/dist/errors.js +7 -24
  13. package/dist/errors.js.map +1 -1
  14. package/dist/feistel.js +3 -4
  15. package/dist/feistel.js.map +1 -1
  16. package/dist/generation-options.js +2 -3
  17. package/dist/generation-options.js.map +1 -1
  18. package/dist/index.d.ts +10 -10
  19. package/dist/index.js +21 -21
  20. package/dist/instant.js +4 -5
  21. package/dist/instant.js.map +1 -1
  22. package/dist/mask-handle.d.ts +1 -3
  23. package/dist/mask-handle.d.ts.map +1 -1
  24. package/dist/mask-handle.js +19 -17
  25. package/dist/mask-handle.js.map +1 -1
  26. package/dist/mask.d.ts +1 -3
  27. package/dist/mask.d.ts.map +1 -1
  28. package/dist/mask.js +23 -24
  29. package/dist/mask.js.map +1 -1
  30. package/dist/masked-bytes.js +74 -0
  31. package/dist/masked-bytes.js.map +1 -0
  32. package/dist/masking-codec-protocol.js +2 -3
  33. package/dist/masking-codec-protocol.js.map +1 -1
  34. package/dist/masking-codec-types.d.ts +60 -19
  35. package/dist/masking-codec-types.d.ts.map +1 -1
  36. package/dist/masking-codec.d.ts +1 -3
  37. package/dist/masking-codec.d.ts.map +1 -1
  38. package/dist/masking-codec.js +119 -115
  39. package/dist/masking-codec.js.map +1 -1
  40. package/dist/migration.js +39 -40
  41. package/dist/migration.js.map +1 -1
  42. package/dist/node/runtime.js +9 -10
  43. package/dist/node/runtime.js.map +1 -1
  44. package/dist/payload.d.ts +1 -3
  45. package/dist/payload.d.ts.map +1 -1
  46. package/dist/payload.js +65 -64
  47. package/dist/payload.js.map +1 -1
  48. package/dist/runtime/pool.js +2 -3
  49. package/dist/runtime/pool.js.map +1 -1
  50. package/dist/runtime/portable.js +2 -3
  51. package/dist/runtime/portable.js.map +1 -1
  52. package/dist/sentinel.js +2 -3
  53. package/dist/sentinel.js.map +1 -1
  54. package/dist/siphash.js +4 -5
  55. package/dist/siphash.js.map +1 -1
  56. package/dist/slug.d.ts +14 -13
  57. package/dist/slug.d.ts.map +1 -1
  58. package/dist/slug.js +145 -153
  59. package/dist/slug.js.map +1 -1
  60. package/dist/timestamp.d.ts +1 -3
  61. package/dist/timestamp.d.ts.map +1 -1
  62. package/dist/timestamp.js +2 -3
  63. package/dist/timestamp.js.map +1 -1
  64. package/dist/types.d.ts +38 -16
  65. package/dist/types.d.ts.map +1 -1
  66. package/dist/types.js +2 -3
  67. package/dist/types.js.map +1 -1
  68. package/dist/uuid-value-protocol.js +2 -3
  69. package/dist/uuid-value-protocol.js.map +1 -1
  70. package/dist/uuid-value.d.ts +3 -5
  71. package/dist/uuid-value.d.ts.map +1 -1
  72. package/dist/uuid-value.js +74 -78
  73. package/dist/uuid-value.js.map +1 -1
  74. package/dist/uuid.d.ts +6 -8
  75. package/dist/uuid.d.ts.map +1 -1
  76. package/dist/uuid.js +38 -49
  77. package/dist/uuid.js.map +1 -1
  78. package/dist/v4-slug.d.ts +2 -4
  79. package/dist/v4-slug.d.ts.map +1 -1
  80. package/dist/v4-slug.js +6 -7
  81. package/dist/v4-slug.js.map +1 -1
  82. package/dist/v4.d.ts +8 -6
  83. package/dist/v4.d.ts.map +1 -1
  84. package/dist/v4.js +38 -44
  85. package/dist/v4.js.map +1 -1
  86. package/dist/v7-bounds.d.ts +3 -5
  87. package/dist/v7-bounds.d.ts.map +1 -1
  88. package/dist/v7-bounds.js +10 -11
  89. package/dist/v7-bounds.js.map +1 -1
  90. package/dist/v7-generator-input.js +10 -12
  91. package/dist/v7-generator-input.js.map +1 -1
  92. package/dist/v7-generator.d.ts +1 -3
  93. package/dist/v7-generator.d.ts.map +1 -1
  94. package/dist/v7-generator.js +45 -46
  95. package/dist/v7-generator.js.map +1 -1
  96. package/dist/v7-keyless.d.ts +12 -4
  97. package/dist/v7-keyless.d.ts.map +1 -1
  98. package/dist/v7-keyless.js +54 -55
  99. package/dist/v7-keyless.js.map +1 -1
  100. package/dist/v7-payload.js +3 -4
  101. package/dist/v7-payload.js.map +1 -1
  102. package/dist/v7-slug.d.ts +8 -5
  103. package/dist/v7-slug.d.ts.map +1 -1
  104. package/dist/v7-slug.js +69 -70
  105. package/dist/v7-slug.js.map +1 -1
  106. package/dist/v7-timestamp.js +2 -3
  107. package/dist/v7-timestamp.js.map +1 -1
  108. package/dist/v7-value-options.js +2 -3
  109. package/dist/v7-value-options.js.map +1 -1
  110. package/dist/v7-value.d.ts +5 -8
  111. package/dist/v7-value.d.ts.map +1 -1
  112. package/dist/v7-value.js +10 -11
  113. package/dist/v7-value.js.map +1 -1
  114. package/dist/v7.js +16 -17
  115. package/dist/v7.js.map +1 -1
  116. package/package.json +9 -2
  117. package/src/alphabet.ts +82 -237
  118. package/src/errors.ts +27 -40
  119. package/src/feistel.ts +3 -3
  120. package/src/index.ts +3 -0
  121. package/src/mask-handle.ts +7 -11
  122. package/src/mask.ts +16 -14
  123. package/src/masked-bytes.ts +203 -0
  124. package/src/masking-codec-types.ts +124 -24
  125. package/src/masking-codec.ts +43 -42
  126. package/src/migration.ts +8 -7
  127. package/src/payload.ts +69 -51
  128. package/src/runtime/portable.ts +2 -2
  129. package/src/runtime/types.ts +2 -4
  130. package/src/slug.ts +39 -48
  131. package/src/types.ts +107 -17
  132. package/src/uuid-value.ts +2 -9
  133. package/src/uuid.ts +19 -33
  134. package/src/v4.ts +12 -9
  135. package/src/v7-bounds.ts +4 -2
  136. package/src/v7-generator-input.ts +2 -5
  137. package/src/v7-generator.ts +2 -2
  138. package/src/v7-keyless.ts +29 -0
  139. package/src/v7-slug.ts +20 -1
  140. package/src/v7-value.ts +9 -4
  141. package/src/v7.ts +26 -0
@@ -1 +1 @@
1
- {"version":3,"file":"mask.d.ts","names":[],"sources":["../src/mask.ts"],"mappings":";;;;;;;;;;;;;wBAuLgB,iBAAiB,SAAS,oBAAoB,aAAa;;;;;;;;;wBA6IrD,sBACpB,SAAS,yBACR,QAAQ,aAAa;;qBAmDX,mBAAmB"}
1
+ {"version":3,"file":"mask.d.ts","names":[],"sources":["../src/mask.ts"],"mappings":";;;;;;;;;;;;wBA4LgB,iBAAiB,SAAS,oBAAoB,aAAa;;;;;;;;;wBA0IrD,sBACpB,SAAS,yBACR,QAAQ,aAAa;;qBAmDX,mBAAmB"}
package/dist/mask.js CHANGED
@@ -1,11 +1,11 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
3
  import { ABORTED as e, INVALID_MASK as t, UuidSlugError as n, findUnknownOption as r, isUint8Array as i, stringInput as a } from "./errors.js";
4
4
  import { feistel16 as o } from "./feistel.js";
5
5
  import { createMaskHandle as s } from "./mask-handle.js";
6
6
  import { halfSipHash as c } from "./siphash.js";
7
7
  import { encodeUtf8 as l } from "#runtime";
8
- //#region src/mask.ts
8
+ // src/mask.ts
9
9
  const u = "Mask construction failed.", d = "seed", f = {
10
10
  keyDerivationIterations: !0,
11
11
  diagnosticLabel: !0,
@@ -13,12 +13,12 @@ const u = "Mask construction failed.", d = "seed", f = {
13
13
  }, p = {
14
14
  ...f,
15
15
  signal: !0
16
- }, m = 1 << 24, h = new Uint8Array(new Uint16Array([1]).buffer)[0] === 1, g = 4096;
16
+ }, m = 1 << 24, h = new Uint8Array(new Uint16Array([1]).buffer)[0] === 1;
17
17
  /*#__NO_SIDE_EFFECTS__*/
18
- function canViewSeedWords(e) {
19
- return h && !(e.byteOffset & 3) && !(e.length & 3);
18
+ function seedWordView(e) {
19
+ return e.length >= 4096 && h && !(e.byteOffset & 3) && !(e.length & 3) ? new Int32Array(e.buffer, e.byteOffset, e.length >>> 2) : void 0;
20
20
  }
21
- const _ = 1097297011, v = 1114074227, y = 1684632949;
21
+ const g = 0x41676c73, _ = 0x42676c73, v = 0x64697575;
22
22
  function seedBytes(e) {
23
23
  return typeof e == "string" ? l(e) : new Uint8Array(e);
24
24
  }
@@ -39,9 +39,10 @@ function validateOptions(e, o) {
39
39
  }
40
40
  /*#__NO_SIDE_EFFECTS__*/
41
41
  function seedWords(e) {
42
- if (e.length >= g && /* @__PURE__ */ canViewSeedWords(e)) return new Int32Array(e.buffer, e.byteOffset, e.length >>> 2);
43
- let t = new Int32Array(Math.ceil(e.length / 4) + 1);
44
- return writeSeedWords(e, t), t;
42
+ let t = /* @__PURE__ */ seedWordView(e);
43
+ if (t) return t;
44
+ let n = new Int32Array(Math.ceil(e.length / 4) + 1);
45
+ return writeSeedWords(e, n), n;
45
46
  }
46
47
  function writeSeedWords(e, t, n = 0, r = 0, i = e.length) {
47
48
  for (let a = r; a < i; a += 1) {
@@ -51,15 +52,14 @@ function writeSeedWords(e, t, n = 0, r = 0, i = e.length) {
51
52
  }
52
53
  /*#__NO_SIDE_EFFECTS__*/
53
54
  function chain(e, t, n, r, i) {
54
- let a = /* @__PURE__ */ new Int32Array(2);
55
- c(e, t, n, r, a);
56
- for (let e = 1; e < i; e += 1) c(a[0], a[1], n, r, a);
55
+ let a = Int32Array.of(e, t);
56
+ for (let e = 0; e < i; e += 1) c(a[0], a[1], n, r, a);
57
57
  return a;
58
58
  }
59
59
  /*#__NO_SIDE_EFFECTS__*/
60
60
  function derivedKeys(e, t) {
61
61
  let n = /* @__PURE__ */ seedWords(e);
62
- return /* @__PURE__ */ roundKeys(/* @__PURE__ */ chain(y, _, n, e.length, t), /* @__PURE__ */ chain(y, v, n, e.length, t));
62
+ return /* @__PURE__ */ roundKeys(/* @__PURE__ */ chain(v, g, n, e.length, t), /* @__PURE__ */ chain(v, _, n, e.length, t));
63
63
  }
64
64
  /*#__NO_SIDE_EFFECTS__*/
65
65
  function roundKeys(e, t) {
@@ -94,9 +94,9 @@ function invalidSeedLength(e) {
94
94
  function validatedIterations(e) {
95
95
  return typeof e != "number" || !Number.isInteger(e) || e < 1 || e > m ? new n(t, `Mask keyDerivationIterations must be a whole number in 1..${m}, got ${String(e)}.`) : e;
96
96
  }
97
- const b = 4096, x = globalThis, S = x.setImmediate?.bind(x);
97
+ const y = 4096, b = globalThis, x = b.setImmediate?.bind(b);
98
98
  function yieldToHost() {
99
- return S ? new Promise((e) => S(e)) : new Promise((e) => {
99
+ return x ? new Promise((e) => x(e)) : new Promise((e) => {
100
100
  let t = new MessageChannel();
101
101
  t.port1.onmessage = () => {
102
102
  t.port1.close(), t.port2.close(), e();
@@ -106,11 +106,11 @@ function yieldToHost() {
106
106
  function* cooperativeChain(e, t, n, r, i) {
107
107
  let a = /* @__PURE__ */ new Int32Array(2);
108
108
  a[0] = e, a[1] = t;
109
- let o = Math.max(1, Math.floor(b / (r + 4))), s = 0;
109
+ let o = Math.max(1, Math.floor(y / (r + 4))), s = 0;
110
110
  for (let e = 0; e < i; e += 1) {
111
111
  let e;
112
112
  do
113
- e = c(a[0], a[1], n, r, a, e, b / 4), e && (yield);
113
+ e = c(a[0], a[1], n, r, a, e, y / 4), e && (yield);
114
114
  while (e);
115
115
  s += 1, s >= o && (s = 0, yield);
116
116
  }
@@ -119,7 +119,7 @@ function* cooperativeChain(e, t, n, r, i) {
119
119
  function* cooperativeKeys(e, t) {
120
120
  let n = [], r = 0;
121
121
  if (typeof e == "string") for (let t = 0; t < e.length;) {
122
- let i = Math.min(e.length, t + b), a = e.charCodeAt(i - 1), o = e.charCodeAt(i);
122
+ let i = Math.min(e.length, t + y), a = e.charCodeAt(i - 1), o = e.charCodeAt(i);
123
123
  i < e.length && a >= 55296 && a <= 56319 && o >= 56320 && o <= 57343 && --i;
124
124
  let s = l(e.slice(t, i));
125
125
  n.push(s), r += s.length, t = i, yield;
@@ -127,15 +127,15 @@ function* cooperativeKeys(e, t) {
127
127
  else n.push(e), r = e.length;
128
128
  let i = /* @__PURE__ */ invalidSeedLength(r);
129
129
  if (i) return i;
130
- let a = typeof e != "string" && e.length >= g && /* @__PURE__ */ canViewSeedWords(e), o = a ? new Int32Array(e.buffer, e.byteOffset, e.length >>> 2) : new Int32Array(Math.ceil(r / 4) + 1);
130
+ let a = typeof e == "string" ? void 0 : /* @__PURE__ */ seedWordView(e), o = a ?? new Int32Array(Math.ceil(r / 4) + 1);
131
131
  if (!a) {
132
132
  let e = 0;
133
133
  for (let t of n) {
134
- for (let n = 0; n < t.length; n += b) writeSeedWords(t, o, e, n, Math.min(t.length, n + b)), yield;
134
+ for (let n = 0; n < t.length; n += y) writeSeedWords(t, o, e, n, Math.min(t.length, n + y)), yield;
135
135
  e += t.length;
136
136
  }
137
137
  }
138
- return n.length = 0, /* @__PURE__ */ roundKeys(yield* cooperativeChain(y, _, o, r, t), yield* cooperativeChain(y, v, o, r, t));
138
+ return n.length = 0, /* @__PURE__ */ roundKeys(yield* cooperativeChain(v, g, o, r, t), yield* cooperativeChain(v, _, o, r, t));
139
139
  }
140
140
  async function deriveUuidV7MaskAsync(r) {
141
141
  try {
@@ -157,8 +157,7 @@ async function deriveUuidV7MaskAsync(r) {
157
157
  return new n(t, u, { cause: e });
158
158
  }
159
159
  }
160
- const C = /*#__PURE__*/ feistelMask("default", /*#__PURE__*/ seedBytes("anizoptera.uuid-slug.default-mask.v1"), 1);
161
- //#endregion
162
- export { C as UUID_V7_TEST_MASK, deriveUuidV7Mask, deriveUuidV7MaskAsync };
160
+ const S = /*#__PURE__*/ feistelMask("default", /*#__PURE__*/ seedBytes("anizoptera.uuid-slug.default-mask.v1"), 1);
161
+ export { S as UUID_V7_TEST_MASK, deriveUuidV7Mask, deriveUuidV7MaskAsync };
163
162
 
164
163
  //# sourceMappingURL=mask.js.map
package/dist/mask.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"mask.js","names":["MASK_CONSTRUCTION_FAILURE_MESSAGE","SEED_PROPERTY","MASK_OPTIONS","ASYNC_MASK_OPTIONS","MAX_KEY_ITERATIONS","LITTLE_ENDIAN","SEED_WORD_VIEW_MIN_BYTES","seed","CHAIN_A_KEY1","CHAIN_B_KEY1","CHAIN_KEY0","encodeUtf8","options","UuidSlugError","INVALID_MASK","input","unknown","accepted","givenSeed","givenLabel","normalizedLabel","givenIterations","iterations","words","index","start","end","absolute","offset","out","key0","key1","length","i","keys","fromA","fromB","word","halfSipHash","chainA","chainB","diagnosticLabel","direction","output","validated","cause","CHUNK_BYTES","host","immediate","resolve","channel","hashesPerChunk","sinceCheckpoint","continuation","chunks","last","next","bytes","short","viewBytes","signal","ABORTED","steps","deadline","failure","step","UUID_V7_TEST_MASK"],"sources":["../src/mask.ts"],"mappings":"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"}
1
+ {"version":3,"file":"mask.js","names":["ABORTED","INVALID_MASK","UuidSlugError","findUnknownOption","isUint8Array","stringInput","feistel16","createMaskHandle","halfSipHash","encodeUtf8","MASK_CONSTRUCTION_FAILURE_MESSAGE","SEED_PROPERTY","MASK_OPTIONS","ASYNC_MASK_OPTIONS","MAX_KEY_ITERATIONS","LITTLE_ENDIAN","seed","CHAIN_A_KEY1","CHAIN_B_KEY1","CHAIN_KEY0","options","accepted","input","unknown","givenSeed","givenLabel","normalizedLabel","givenIterations","iterations","view","words","offset","start","end","index","absolute","key0","key1","length","out","i","chainA","chainB","keys","fromA","fromB","word","diagnosticLabel","output","direction","validated","cause","CHUNK_BYTES","host","immediate","resolve","channel","hashesPerChunk","sinceCheckpoint","continuation","chunks","last","next","bytes","short","signal","steps","deadline","failure","step","UUID_V7_TEST_MASK"],"sources":["../src/mask.ts"],"mappings":";;;;;;;;AAiBA,MAAMU,IAAoC,6BACpCC,IAAgB,QAChBC,IAAe;CACnB,yBAAyB;CACzB,iBAAiB;EAChBD,IAAgB;AACnB,GACME,IAAqB;CACzB,GAAGD;CACH,QAAQ;AACV,GAMME,IAAqB,KAAK,IAG1BC,IAAgB,IAAI,WAAW,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO;;AAIzE,SAAS,aAAaC,GAA0C;CAE9D,OAAOA,EAAK,UAAU,QACpBD,KAAA,EACCC,EAAK,aAAa,MAAO,EACzBA,EAAK,SAAS,KACb,IAAI,WAAWA,EAAK,QAAQA,EAAK,YAAYA,EAAK,WAAW,CAAC,IAC9D,KAAA;AACN;AASA,MAAMC,IAAe,YACfC,IAAe,YACfC,IAAa;AAEnB,SAAS,UAAUH,GAA2B;CAE5C,OADI,OAAOA,KAAS,WACbP,EAAWO,CAAI,IADe,IAAI,WAAWA,CAAI;AAE1D;AAGA,SAAS,gBAAgBI,GAAkBC,GAA0C;CACnF,IAAI,OAAOD,KAAY,aAAYA,GACjC,OAAO,IAAIlB,EACTD,GACA,wDACF;CACF,IAAMqB,IAAQF,GAKRG,IAAUpB,kBAAkBmB,GAAOD,CAAQ;CACjD,IAAIE,MAAY,KAAA,GACd,OAAO,IAAIrB,EAAcD,GAAc,wBAAwBsB,EAAQ,EAAE;CAG3E,IAAMC,IAAYF,EAAM,MAClBN,IACJ,OAAOQ,KAAc,YAAYpB,kBAAaoB,CAAS,IAAIA,IAAYnB,kBAAYmB,CAAS;CAC9F,IAAIR,MAAS,KAAA,GACX,OAAO,IAAId,EAAcD,GAAc,2CAA2C;CACpF,IAAMwB,IAAaH,EAAM,iBAEnBI,IAAkBrB,kBADAoB,MAAe,KAAA,IAAY,WAAWA,CACX;CACnD,IAAIC,MAAoB,KAAA,GACtB,OAAO,IAAIxB,EAAcD,GAAc,wCAAwC;CACjF,IAAM0B,IAAkBL,EAAM,yBAExBM,IAAa,oBADaD,MAAoB,KAAA,IAAY,IAAIA,CACN;CAE9D,OADI,OAAOC,KAAe,WACnB;EAAE,iBAAiBF;EAAiBE;EAAYZ;CAAK,IADjBY;AAE7C;;AAIA,SAAS,UAAUZ,GAAkB;CACnC,IAAMa,IAAO,6BAAab,CAAI;CAC9B,IAAIa,GAAM,OAAOA;CACjB,IAAMC,IAAQ,IAAI,WAAW,KAAK,KAAKd,EAAK,SAAS,CAAC,IAAI,CAAC;CAE3D,OADA,eAAeA,GAAMc,CAAK,GACnBA;AACT;AAGA,SAAS,eACPd,GACAc,GACAC,IAAS,GACTC,IAAQ,GACRC,IAAMjB,EAAK,QACX;CACA,KAAK,IAAIkB,IAAQF,GAAOE,IAAQD,GAAKC,KAAS,GAAG;EAC/C,IAAMC,IAAWJ,IAASG;EAC1BJ,EAAMK,MAAa,KAChBL,EAAMK,MAAa,KAAkBnB,EAAKkB,OAAuBC,IAAW,KAAK;CACtF;AACF;;AAQA,SAAS,MAAMC,GAAcC,GAAcP,GAAmBQ,GAAgBV,GAAoB;CAChG,IAAMW,IAAM,WAAW,GAAGH,GAAMC,CAAI;CACpC,KAAK,IAAIG,IAAI,GAAGA,IAAIZ,GAAYY,KAAK,GACnChC,EAAY+B,EAAI,IAAcA,EAAI,IAAcT,GAAOQ,GAAQC,CAAG;CACpE,OAAOA;AACT;;AAQA,SAAS,YAAYvB,GAAkBY,GAAoB;CACzD,IAAME,IAAQ,0BAAUd,CAAI;CAG5B,OAAO,0BAFQ,sBAAMG,GAAYF,GAAca,GAAOd,EAAK,QAAQY,CAE7C,GADP,sBAAMT,GAAYD,GAAcY,GAAOd,EAAK,QAAQY,CACrC,CAAC;AACjC;;AAIA,SAAS,UAAUa,GAAoBC,GAAoB;CACzD,IAAMC,oBAAO,IAAI,WAAA,CAA4B,GACvCT,oBAAQ,IAAI,WAAW,CAAC,GACxBU,oBAAQ,IAAI,WAAW,CAAC,GACxBC,oBAAQ,IAAI,WAAW,CAAC;CAC9B,KAAK,IAAIC,IAAO,GAAGA,IAAA,GAA0BA,KAAQ,GACnDZ,EAAM,KAAKY,GACXtC,EAAYiC,EAAO,IAAcA,EAAO,IAAcP,GAAO,GAAGU,CAAK,GACrEpC,EAAYkC,EAAO,IAAcA,EAAO,IAAcR,GAAO,GAAGW,CAAK,GACrEF,EAAKG,KAASF,EAAM,KAAiBC,EAAM,IAC3CF,EAAKG,IAAO,KAAMF,EAAM,KAAiBC,EAAM;CAEjD,OAAOF;AACT;;AAGA,SAAS,YAAYI,GAAyB/B,GAAkBY,GAAgC;CAC9F,OAAO,6BAAamB,GAAiB,4BAAY/B,GAAMY,CAAU,CAAC;AACpE;;AAGA,SAAS,aAAamB,GAAyBJ,GAA8B;CAC3E,OAAOpC,kBAAiBwC,IAAkBzB,GAAO0B,GAAQC,MAAc;EACrE3C,EAAUgB,GAAO,GAAGqB,GAAMM,GAAWD,GAAQ,CAAC;CAChD,CAAC;AACH;AAUA,SAAgB,iBAAiB5B,GAAwD;CACvF,IAAI;EACF,IAAM8B,IAAY,gBAAgB9B,GAASR,CAAY;EACvD,IAAI,EAAED,KAAiBuC,IAAY,OAAOA;EAC1C,IAAMlC,IAAO,UAAUkC,EAAU,IAAI;EAErC,OADc,kCAAkBlC,EAAK,MAC1B,KAAK,4BAAYkC,EAAU,iBAAiBlC,GAAMkC,EAAU,UAAU;CACnF,SAASC,GAAO;EACd,OAAO,IAAIjD,EAAcD,GAAcS,GAAmC,EAAEyC,SAAM,CAAC;CACrF;AACF;;AAGA,SAAS,kBAAkBb,GAA2C;CACpE,IAAIA,IAAS,IACX,OAAO,IAAIpC,EACTD,GACA,4CAA2DqC,EAAO,4HACpE;AAEJ;AAEA,SAAS,oBAAoBV,GAA6C;CAWxE,OATE,OAAOA,KAAe,YACtB,CAAC,OAAO,UAAUA,CAAU,KAC5BA,IAAa,KACbA,IAAad,IAEN,IAAIZ,EACTD,GACA,6DAA6Da,EAAmB,QAAQ,OAAOc,CAAU,EAAE,EAC7G,IACKA;AACT;AAGA,MAAMwB,IAAc,MAEdC,IAAO,YACPC,IAAYD,EAAK,cAAc,KAAKA,CAAI;AAG9C,SAAS,cAA6B;CAGpC,OADIC,IAAkB,IAAI,SAASC,MAAYD,EAAUC,CAAO,CAAC,IAC1D,IAAI,SAASA,MAAY;EAC9B,IAAMC,IAAU,IAAI,eAAe;EAEnCA,EAAQ,MAAM,kBAAkB;GAC9BA,EAAQ,MAAM,MAAM,GACpBA,EAAQ,MAAM,MAAM,GACpBD,EAAQ;EACV,GACAC,EAAQ,MAAM,YAAY,IAAI;CAChC,CAAC;AACH;AAEA,UAAU,iBACRpB,GACAC,GACAP,GACAQ,GACAV,GACmC;CACnC,IAAMW,oBAAM,IAAI,WAAW,CAAC;CAC5BA,EAAI,KAAKH,GACTG,EAAI,KAAKF;CACT,IAAMoB,IAAiB,KAAK,IAAI,GAAG,KAAK,MAAML,KAAed,IAAS,EAAE,CAAC,GACrEoB,IAAkB;CACtB,KAAK,IAAIlB,IAAI,GAAGA,IAAIZ,GAAYY,KAAK,GAAG;EACtC,IAAImB;EACJ;GACEA,IAAenD,EAAY+B,EAAI,IAAIA,EAAI,IAAIT,GAAOQ,GAAQC,GAAKoB,GAAcP,IAAc,CAAC,GACxFO,MAAc;SACXA;EACTD,KAAmB,GACfA,KAAmBD,MACrBC,IAAkB,GAClB;CAEJ;CACA,OAAOnB;AACT;AAEA,UAAU,gBACRvB,GACAY,GACmD;CAEnD,IAAMgC,IAAuB,CAAC,GAC1BtB,IAAS;CACb,IAAI,OAAOtB,KAAS,UAClB,KAAK,IAAIgB,IAAQ,GAAGA,IAAQhB,EAAK,SAAS;EACxC,IAAIiB,IAAM,KAAK,IAAIjB,EAAK,QAAQgB,IAAQoB,CAAW,GAE7CS,IAAO7C,EAAK,WAAWiB,IAAM,CAAC,GAC9B6B,IAAO9C,EAAK,WAAWiB,CAAG;EAC5BA,IAAMjB,EAAK,UAAU6C,KAAQ,SAAUA,KAAQ,SAAUC,KAAQ,SAAUA,KAAQ,SACrF7B;EACF,IAAM8B,IAAQtD,EAAWO,EAAK,MAAMgB,GAAOC,CAAG,CAAC;EAC/C2B,EAAO,KAAKG,CAAK,GACjBzB,KAAUyB,EAAM,QAChB/B,IAAQC,GACR;CACF;MAEA2B,EAAO,KAAK5C,CAAI,GAChBsB,IAAStB,EAAK;CAEhB,IAAMgD,IAAQ,kCAAkB1B,CAAM;CACtC,IAAI0B,GAAO,OAAOA;CAClB,IAAMnC,IAAO,OAAOb,KAAS,WAAgC,KAAA,IAArB,6BAAaA,CAAI,GACnDc,IAAQD,KAAQ,IAAI,WAAW,KAAK,KAAKS,IAAS,CAAC,IAAI,CAAC;CAC9D,IAAI,CAACT,GAAM;EACT,IAAIE,IAAS;EACb,KAAK,IAAMgC,KAASH,GAAQ;GAC1B,KAAK,IAAI5B,IAAQ,GAAGA,IAAQ+B,EAAM,QAAQ/B,KAASoB,GACjD,eAAeW,GAAOjC,GAAOC,GAAQC,GAAO,KAAK,IAAI+B,EAAM,QAAQ/B,IAAQoB,CAAW,CAAC,GACvF;GAEFrB,KAAUgC,EAAM;EAClB;CACF;CAIA,OAHAH,EAAO,SAAS,GAGT,0BAAU,OAFK,iBAAiBzC,GAAYF,GAAca,GAAOQ,GAAQV,CAAU,GAEjE,OADH,iBAAiBT,GAAYD,GAAcY,GAAOQ,GAAQV,CAAU,CAC3D;AACjC;AAUA,eAAsB,sBACpBR,GACqC;CACrC,IAAI;EACF,IAAM6C,IAAS7C,GAAS,QAClB,gBACJ,IAAIlB,EAAcF,GAAS,kCAAkC,EAC3D,OAAOiE,GAAQ,OACjB,CAAC;EACH,IAAIA,GAAQ,SAAS,OAAO,QAAQ;EACpC,IAAMf,IAAY,gBAAgB9B,GAASP,CAAkB;EAC7D,IAAI,EAAEF,KAAiBuC,IAAY,OAAOA;EAG1C,IAAMgB,IAAQ,gBADZ,OAAOhB,EAAU,QAAS,WAAWA,EAAU,OAAO,IAAI,WAAWA,EAAU,IAAI,GACjDA,EAAU,UAAU,GACpDiB,IAAW,YAAY,IAAI,IAAI;EACnC,SAAa;GACX,IAAIF,GAAQ,SAAS;IACnB,IAAMG,IAAU,QAAQ;IAExB,OADAF,EAAM,OAAOE,CAAO,GACbA;GACT;GACA,IAAMC,IAAOH,EAAM,KAAK;GACxB,IAAIG,EAAK,MACP,OAAO,YAAY,OAAOA,EAAK,KAAK,IAChC,6BAAanB,EAAU,iBAAiBmB,EAAK,KAAK,IAClDA,EAAK;GACP,YAAY,IAAI,KAAKF,MAEvB,MAAM,YAAY,GAClBA,IAAW,YAAY,IAAI,IAAI;EAEnC;CACF,SAAShB,GAAO;EACd,OAAO,IAAIjD,EAAcD,GAAcS,GAAmC,EAAEyC,SAAM,CAAC;CACrF;AACF;AAUA,MAOamB,IAA8C,0BACzD,WACc,wBAAU,sCAAY,GACpC,CACF"}
@@ -0,0 +1,74 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { INVALID_MASK as e, INVALID_OPTIONS as t, INVALID_UUID_SLUG as n, INVALID_UUID_VERSION as r, UuidSlugError as i, checkByteRange as a, checkRange as o, isSuccessfulUuidBytes as s, isUint8Array as c, isUuidSlugError as l } from "./errors.js";
4
+ import { maskUuidV7Block as u, unmix as d } from "./payload.js";
5
+ import { exactUuidByteView as f, formatUuidBytesUnchecked as p, isUuidV7Bytes as m, resolveUuidTextCase as h } from "./uuid.js";
6
+ import { UUID_TEXT_LOWERCASE as g } from "./types.js";
7
+ // src/masked-bytes.ts
8
+ function readMaskedByteSource(e, n) {
9
+ return n === void 0 ? /* @__PURE__ */ f(e) : /* @__PURE__ */ c(e) ? /* @__PURE__ */ o(e.length, n, 16) ?? e : /* @__PURE__ */ l(e) ? e : n === 0 ? /* @__PURE__ */ f(e) : new i(t, "A non-zero byteOffset requires Uint8Array input.");
10
+ }
11
+ function createMaskedByteMethods(t, o, c, l) {
12
+ function sentinel(e, t = 0) {
13
+ for (let n of l) {
14
+ let r = 0;
15
+ for (; r < 16 && n.bytes[r] === e[t + r];) r += 1;
16
+ if (r === 16) return n.bytes;
17
+ }
18
+ }
19
+ function uuidToMaskedBytes(n, c, l = 0) {
20
+ let d = t(n);
21
+ if (!s(d)) return d;
22
+ if (c !== void 0) {
23
+ let e = /* @__PURE__ */ a(c, l, 16);
24
+ if (e) return e;
25
+ }
26
+ if (!/* @__PURE__ */ m(d)) return new i(r, "Masking requires an RFC-variant UUIDv7.");
27
+ let f = new Uint8Array(d);
28
+ if (!sentinel(d)) {
29
+ let t = u(f, o.mask, o.timestampRangeStartUnixMs);
30
+ if (typeof t != "number") return t;
31
+ if (sentinel(f)) return new i(e, "Masked output collides with a reserved sentinel. Configure a different mask or sentinel set.");
32
+ }
33
+ return c ? (c.set(f, l), c) : f;
34
+ }
35
+ function read(e, t) {
36
+ let r = sentinel(e, t);
37
+ if (r) return new Uint8Array(r);
38
+ let a = t === void 0 ? new Uint8Array(e) : /* @__PURE__ */ new Uint8Array(16);
39
+ if (t !== void 0) for (let n = 0; n < 16; n += 1) a[n] = e[t + n];
40
+ let s = c.length ? a.slice() : void 0, l = d(a, void 0, o);
41
+ if (l !== void 0) return l;
42
+ if (s) {
43
+ for (let e of c) if (a.set(s), l = d(a, void 0, e), l !== void 0) return l;
44
+ }
45
+ return new i(n, "No configured mask and timestamp range accepts these masked bytes; use the codec configuration that issued them.");
46
+ }
47
+ function maskedBytesToUuidBytes(e, t, n, r = 0) {
48
+ let i = typeof t == "number", o = i ? t : void 0, c = readMaskedByteSource(e, o);
49
+ if (!s(c)) return c;
50
+ let l = i ? n : t, u = i ? r : n ?? 0;
51
+ if (l !== void 0) {
52
+ let e = /* @__PURE__ */ a(l, u, 16);
53
+ if (e) return e;
54
+ }
55
+ let d = read(c, o);
56
+ return d instanceof Error || !l ? d : (l.set(d, u), l);
57
+ }
58
+ function maskedBytesToUuidString(e, t = g, n = g) {
59
+ let r = typeof t == "number", i = r ? t : void 0, a = readMaskedByteSource(e, i);
60
+ if (!s(a)) return a;
61
+ let o = h(r ? n : t);
62
+ if (o instanceof Error) return o;
63
+ let c = read(a, i);
64
+ return c instanceof Error ? c : /* @__PURE__ */ p(c, 0, o);
65
+ }
66
+ return {
67
+ uuidToMaskedBytes,
68
+ maskedBytesToUuidBytes,
69
+ maskedBytesToUuidString
70
+ };
71
+ }
72
+ export { createMaskedByteMethods };
73
+
74
+ //# sourceMappingURL=masked-bytes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"masked-bytes.js","names":["INVALID_MASK","INVALID_OPTIONS","INVALID_UUID_SLUG","INVALID_UUID_VERSION","UuidSlugError","checkByteRange","checkRange","isSuccessfulUuidBytes","isUint8Array","isUuidSlugError","maskUuidV7Block","unmix","exactUuidByteView","formatUuidBytesUnchecked","isUuidV7Bytes","resolveUuidTextCase","UUID_TEXT_LOWERCASE","value","byteOffset","decodeUuid","current","previous","sentinels","bytes","entry","index","uuid","output","outputOffset","source","invalid","tail","reserved","ciphertext","candidate","range","maskedUuidBytes","outputOrByteOffset","outputOrOutputOffset","offsetAfterOutput","readsAtOffset","offsetOrCase","textCaseAfterOffset","selectedCase"],"sources":["../src/masked-bytes.ts"],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
- //#region src/masking-codec-protocol.ts
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ // src/masking-codec-protocol.ts
4
4
  var ReturnCodec = class {
5
5
  constructor(e) {
6
6
  return e;
@@ -17,7 +17,6 @@ function registerMaskingCodec(e) {
17
17
  function isLocalMaskingCodec(e) {
18
18
  return PackageMaskingCodec.is(e);
19
19
  }
20
- //#endregion
21
20
  export { isLocalMaskingCodec, registerMaskingCodec };
22
21
 
23
22
  //# sourceMappingURL=masking-codec-protocol.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"masking-codec-protocol.js","names":["codec","#local"],"sources":["../src/masking-codec-protocol.ts"],"mappings":";;;AAQA,IAAM,cAAN,MAAkB;CAChB,YAAY,GAAe;EACzB,OAAOA;CACT;AACF,GAEM,sBAAN,cAAkC,YAAY;CAC5C,KAAkB;CAElB,OAAO,GAAG,GAAwB;EAChC,OAAO,OAAOA,KAAU,cAAYA,KAAkB,MAAUA,KAASA,EAAMC;CACjF;AACF;AAEA,SAAgB,qBAA2C,GAAqB;CAC9E,OAAO,IAAI,oBAAoBD,CAAK;AACtC;AAEA,SAAgB,oBAAoB,GAAwB;CAC1D,OAAO,oBAAoB,GAAGA,CAAK;AACrC"}
1
+ {"version":3,"file":"masking-codec-protocol.js","names":["codec","#local"],"sources":["../src/masking-codec-protocol.ts"],"mappings":";;;AAQA,IAAM,cAAN,MAAkB;CAChB,YAAYA,GAAe;EACzB,OAAOA;CACT;AACF,GAEM,sBAAN,cAAkC,YAAY;CACnCC,KAAS;CAElB,OAAO,GAAGD,GAAwB;EAChC,OAAO,OAAOA,KAAU,cAAYA,KAAkBC,MAAUD,KAASA,EAAMC;CACjF;AACF;AAEA,SAAgB,qBAA2CD,GAAqB;CAC9E,OAAO,IAAI,oBAAoBA,CAAK;AACtC;AAEA,SAAgB,oBAAoBA,GAAwB;CAC1D,OAAO,oBAAoB,GAAGA,CAAK;AACrC"}
@@ -1,9 +1,8 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
3
  import { UuidSlugError } from "./errors.js";
4
4
  import { SlugAlphabet } from "./slug.js";
5
- import { EnabledMigrationFormat, GenerateUuidV7WithMaskedSlugOptions, GeneratedUuidV7, MaskedOrSentinelUuidV7Slug, MaskingCodecUuidInput, ParsedUuidResult, PlainUuidSlug, PlainUuidSlugResult, PlainUuidV7Slug, PlainUuidV7SlugInput, SEEDED_MASK_FORMAT, SlugStringInput, UUID_TEXT_LOWERCASE, Uuid, UuidBytesResult, UuidInput, UuidOutput, UuidSlugMigrationDecoder, UuidSlugMigrationOptions, UuidStringResult, UuidTextCase, UuidTextCaseArguments, UuidV7Bytes, UuidV7Mask, UuidV7MaskOptions, UuidV7MaskingCodecValueOptions, UuidV7Payload, UuidV7PayloadLayout, UuidV7Sentinel, UuidV7SentinelConfig, UuidV7StringFor, UuidV7TimestampWindow, UuidV7ValueInput } from "./types.js";
6
- //#region src/masking-codec-types.d.ts
5
+ import { EnabledMigrationFormat, GenerateUuidV7WithMaskedSlugOptions, GeneratedUuidV7, MaskedOrSentinelUuidV7Bytes, MaskedOrSentinelUuidV7Slug, MaskingCodecUuidInput, ParsedUuidResult, PlainUuidSlug, PlainUuidSlugResult, PlainUuidV7Slug, PlainUuidV7SlugInput, SEEDED_MASK_FORMAT, SlugStringInput, UUID_TEXT_LOWERCASE, UnmaskedUuidInput, Uuid, UuidByteInput, UuidBytesResult, UuidGenerationInput, UuidGenerationTextCase, UuidInput, UuidOutput, UuidSlugMigrationDecoder, UuidSlugMigrationOptions, UuidStringResult, UuidTextCase, UuidTextCaseArguments, UuidV7Bytes, UuidV7Mask, UuidV7MaskOptions, UuidV7MaskingCodecValueOptions, UuidV7Payload, UuidV7PayloadLayout, UuidV7Sentinel, UuidV7SentinelConfig, UuidV7StringFor, UuidV7TimestampWindow, UuidV7ValueInput } from "./types.js";
7
6
  /** Key rotation, sentinel, and output options shared by both ways of supplying the writer mask. */
8
7
  export interface UuidV7MaskingCodecSharedOptions {
9
8
  /**
@@ -17,7 +16,8 @@ export interface UuidV7MaskingCodecSharedOptions {
17
16
  /**
18
17
  * Decode-only masks tried after the writer mask, in caller order. Each item accepts a mask or its
19
18
  * derivation options. A returned `UuidSlugError` passes through unchanged. Keep the list short:
20
- * every mask adds decoding work and another chance for a random input to pass its 16-bit check.
19
+ * every mask adds decoding work and another chance for a random input to pass its check
20
+ * (16 bits for text, 12 for binary).
21
21
  *
22
22
  * @defaultValue No previous masks.
23
23
  */
@@ -79,47 +79,49 @@ export interface UuidV7MaskingCodec {
79
79
  /** Generate an immutable UUIDv7 with this masking codec retained. */
80
80
  generateUuidV7Value(this: void, options?: UuidV7MaskingCodecValueOptions): Uuid<7, true, true> | UuidSlugError;
81
81
  /** Parse any accepted UUID form, retain this codec and preserve an existing payload layout. A plain-v4 slug brand cannot exclude a masked-v7 reading. */
82
- parseUuid<Input extends UuidInput>(this: void, uuid: Input): ParsedUuidResult<Input, true> | UuidSlugError;
82
+ parseUuid<Input extends UuidInput>(this: void, uuid: UnmaskedUuidInput<Input>): ParsedUuidResult<Input, true> | UuidSlugError;
83
83
  /**
84
84
  * Convert any accepted UUID form to normalized UUID text. A 22-character slug is read as masked
85
85
  * when it passes this codec's check and as plain otherwise.
86
86
  * A plain UUIDv4 slug can therefore return UUIDv4 or UUIDv7 text.
87
87
  */
88
- uuidToString<Input extends UuidInput, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, uuid: Input, ...textCase: UuidTextCaseArguments<Case>): UuidStringResult<MaskingCodecUuidInput<Input>, Case>;
88
+ uuidToString<Input extends UuidInput, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, uuid: UnmaskedUuidInput<Input>, ...textCase: UuidTextCaseArguments<Case>): UuidStringResult<MaskingCodecUuidInput<Input>, Case>;
89
89
  /**
90
- * Read one UUID out of a larger array as normalized UUID text. Bytes carry no masked spelling.
90
+ * Read raw UUID bytes out of a larger array as normalized UUID text.
91
+ * Decode masked bytes with `maskedBytesToUuidString` instead.
91
92
  *
92
93
  * @param byteOffset - Zero-based index where the UUID starts. Omit for a standalone UUID.
93
94
  */
94
- uuidToString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, uuid: Uint8Array, byteOffset: number, ...textCase: UuidTextCaseArguments<Case>): UuidStringResult<Uint8Array, Case>;
95
+ uuidToString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE, Input extends Uint8Array = Uint8Array>(this: void, uuid: UnmaskedUuidInput<Input>, byteOffset: number, ...textCase: UuidTextCaseArguments<Case>): UuidStringResult<Uint8Array, Case>;
95
96
  /**
96
97
  * Convert any accepted UUID form to a new plain 16-byte array. A 22-character slug is read as
97
98
  * masked when it passes this codec's check and as plain otherwise.
98
99
  * A plain UUIDv4 slug can therefore return UUIDv4 or UUIDv7 bytes.
99
100
  */
100
- uuidToBytes<Input extends UuidInput>(this: void, uuid: Input): UuidBytesResult<MaskingCodecUuidInput<Input>>;
101
+ uuidToBytes<Input extends UuidInput>(this: void, uuid: UnmaskedUuidInput<Input>): UuidBytesResult<MaskingCodecUuidInput<Input>>;
101
102
  /** Convert any accepted UUID form into caller-owned storage after complete validation. */
102
- uuidToBytes<Output extends Uint8Array>(this: void, uuid: UuidInput, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
103
+ uuidToBytes<Output extends Uint8Array, Input extends UuidInput = UuidInput>(this: void, uuid: UnmaskedUuidInput<Input>, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
103
104
  /**
104
- * Copy one UUID out of a larger array. Bytes carry no masked spelling.
105
+ * Copy raw UUID bytes out of a larger array. Decode masked bytes with `maskedBytesToUuidBytes` instead.
105
106
  *
106
107
  * @param byteOffset - Zero-based index where the UUID starts. Omit for a standalone UUID.
107
108
  */
108
- uuidToBytes(this: void, uuid: Uint8Array, byteOffset: number): UuidBytesResult<Uint8Array>;
109
+ uuidToBytes<Input extends Uint8Array>(this: void, uuid: UnmaskedUuidInput<Input>, byteOffset: number): UuidBytesResult<Uint8Array>;
109
110
  /** Copy one UUID out of a larger array into caller-owned storage. */
110
- uuidToBytes<Output extends Uint8Array>(this: void, uuid: Uint8Array, byteOffset: number, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
111
+ uuidToBytes<Output extends Uint8Array, Input extends Uint8Array = Uint8Array>(this: void, uuid: UnmaskedUuidInput<Input>, byteOffset: number, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
111
112
  /**
112
113
  * Convert any accepted UUID form to a plain UUID slug. A 22-character slug is read as masked
113
114
  * when it passes this codec's check and as plain otherwise.
114
115
  * A plain UUIDv4 slug can therefore return a plain UUIDv4 or UUIDv7 slug.
115
116
  */
116
- uuidToPlainSlug<Input extends UuidInput>(this: void, uuid: Input, alphabet?: SlugAlphabet): PlainUuidSlugResult<MaskingCodecUuidInput<Input>>;
117
+ uuidToPlainSlug<Input extends UuidInput>(this: void, uuid: UnmaskedUuidInput<Input>, alphabet?: SlugAlphabet): PlainUuidSlugResult<MaskingCodecUuidInput<Input>>;
117
118
  /**
118
- * Read one UUID out of a larger array as a plain UUID slug. Bytes carry no masked spelling.
119
+ * Read raw UUID bytes out of a larger array as a plain UUID slug.
120
+ * Decode masked bytes with `maskedBytesToUuidBytes` before plain-slug conversion.
119
121
  *
120
122
  * @param byteOffset - Zero-based index where the UUID starts. Omit for a standalone UUID.
121
123
  */
122
- uuidToPlainSlug(this: void, uuid: Uint8Array, byteOffset: number, alphabet?: SlugAlphabet): PlainUuidSlugResult<Uint8Array>;
124
+ uuidToPlainSlug<Input extends Uint8Array>(this: void, uuid: UnmaskedUuidInput<Input>, byteOffset: number, alphabet?: SlugAlphabet): PlainUuidSlugResult<Uint8Array>;
123
125
  /**
124
126
  * Create a reader for current and explicitly enabled old formats without changing this codec.
125
127
  * Omitted options return the reader directly. Configured construction returns `invalid_options`
@@ -128,9 +130,9 @@ export interface UuidV7MaskingCodec {
128
130
  *
129
131
  * @param options - Old formats this application has actually issued. Omit for current formats only.
130
132
  */
131
- createUuidSlugMigrationDecoder(this: void, options?: undefined): UuidSlugMigrationDecoder<typeof SEEDED_MASK_FORMAT>;
133
+ createUuidSlugMigrationDecoder(this: void): UuidSlugMigrationDecoder<typeof SEEDED_MASK_FORMAT>;
132
134
  /** Create a reusable reader with explicitly enabled old formats; check configuration failure once. */
133
- createUuidSlugMigrationDecoder<const Options extends UuidSlugMigrationOptions>(this: void, options: Options | undefined): UuidSlugMigrationDecoder<EnabledMigrationFormat<Options>> | UuidSlugError;
135
+ createUuidSlugMigrationDecoder<const Options extends UuidSlugMigrationOptions | undefined>(this: void, options: Options): UuidSlugMigrationDecoder<EnabledMigrationFormat<NonNullable<Options>>> | (Options extends undefined ? never : UuidSlugError);
134
136
  /**
135
137
  * Generate and encode a UUIDv7 as a masked slug or its registered raw sentinel slug.
136
138
  * Options may select an explicit time and a generator whose sequence this call joins.
@@ -152,6 +154,8 @@ export interface UuidV7MaskingCodec {
152
154
  generateUuidV7WithMaskedSlug<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, ...textCase: UuidTextCaseArguments<Case>): GeneratedUuidV7<MaskedOrSentinelUuidV7Slug, Case> | UuidSlugError;
153
155
  /** Generate the pair through selected sequence state at an explicit time or the current clock. */
154
156
  generateUuidV7WithMaskedSlug<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, options: GenerateUuidV7WithMaskedSlugOptions<Case>): GeneratedUuidV7<MaskedOrSentinelUuidV7Slug, Case> | UuidSlugError;
157
+ /** Forward a text-case preset or optional settings with this masking codec retained. */
158
+ generateUuidV7WithMaskedSlug<const Input extends UuidTextCase | GenerateUuidV7WithMaskedSlugOptions<UuidTextCase> | undefined>(this: void, textCaseOrOptions: UuidGenerationInput<Input, GenerateUuidV7WithMaskedSlugOptions<UuidTextCase>>): GeneratedUuidV7<MaskedOrSentinelUuidV7Slug, UuidGenerationTextCase<Input>> | UuidSlugError;
155
159
  /**
156
160
  * Convert UUID text, 16 UUID bytes, a plain slug, or a masked slug to this masking codec's
157
161
  * current masked spelling. A 22-character slug is read as masked when it passes this codec's
@@ -165,6 +169,44 @@ export interface UuidV7MaskingCodec {
165
169
  * @param uuid - Any supported UUIDv7 text, bytes, plain slug, masked slug, or sentinel.
166
170
  */
167
171
  uuidToMaskedSlug<Input extends UuidInput>(this: void, uuid: UuidV7ValueInput<Input>): MaskedOrSentinelUuidV7Slug | UuidSlugError;
172
+ /**
173
+ * Convert UUIDv7 text, raw bytes, a parsed UUID, or a plain or masked slug to 16 masked bytes.
174
+ * Registered sentinels retain raw UUID bytes and their full timestamp range. Binary carries 12 inner check bits;
175
+ * current masked text carries four more. Returns owned plain bytes or an unchanged prior error.
176
+ * Range, version and mask failures follow masked-slug conversion. A mixed block matching a
177
+ * registered raw sentinel returns `invalid_mask` instead of losing the original UUID.
178
+ */
179
+ uuidToMaskedBytes<Input extends UuidInput>(this: void, uuid: UuidV7ValueInput<Input>): MaskedOrSentinelUuidV7Bytes | UuidSlugError;
180
+ /** Write 16 masked bytes at `outputOffset` (default zero); preserve output identity and all bytes on failure. */
181
+ uuidToMaskedBytes<Input extends UuidInput, Output extends Uint8Array>(this: void, uuid: UuidV7ValueInput<Input>, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
182
+ /**
183
+ * Read exactly 16 masked bytes using registered-sentinel priority and current-first key order.
184
+ * A 12-bit check can accept a wrong key by chance; it is not authorization. Input remains unchanged
185
+ * unless it is also the supplied output storage.
186
+ * A preceding error propagates unchanged; malformed storage or no passing key returns a package error.
187
+ */
188
+ maskedBytesToUuidBytes(this: void, maskedUuidBytes: UuidByteInput | UuidSlugError): UuidV7Bytes | UuidSlugError;
189
+ /** Write the decoded UUID at `outputOffset` (default zero), preserving output identity and bytes on failure. */
190
+ maskedBytesToUuidBytes<Output extends Uint8Array>(this: void, maskedUuidBytes: UuidByteInput | UuidSlugError, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
191
+ /**
192
+ * Read 16 masked bytes at `byteOffset` from a larger array. Uses the same keys, checks and failures
193
+ * as the standalone reader; an invalid range returns `invalid_buffer`.
194
+ * @param byteOffset - Zero-based index where the masked UUID starts. Omit for a standalone value.
195
+ */
196
+ maskedBytesToUuidBytes(this: void, maskedUuidBytes: Uint8Array | UuidSlugError, byteOffset: number): UuidV7Bytes | UuidSlugError;
197
+ /**
198
+ * Decode 16 masked bytes at `byteOffset` into caller storage at `outputOffset` (default zero).
199
+ * Input and output may overlap; return output by identity and leave it unchanged on failure.
200
+ */
201
+ maskedBytesToUuidBytes<Output extends Uint8Array>(this: void, maskedUuidBytes: Uint8Array | UuidSlugError, byteOffset: number, output: Output, outputOffset?: number): UuidOutput<Output> | UuidSlugError;
202
+ /** Read masked bytes as UUIDv7 text; `textCase` defaults to lowercase. Uses the same keys, checks and failures as the byte reader. */
203
+ maskedBytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, maskedUuidBytes: UuidByteInput | UuidSlugError, ...textCase: UuidTextCaseArguments<Case>): UuidV7StringFor<Case> | UuidSlugError;
204
+ /**
205
+ * Read 16 masked bytes at `byteOffset` from a larger array as UUIDv7 text; lowercase is the default.
206
+ * Uses the standalone reader's keys, checks and failures; an invalid range returns `invalid_buffer`.
207
+ * @param byteOffset - Zero-based index where the masked UUID starts. Omit for a standalone value.
208
+ */
209
+ maskedBytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, maskedUuidBytes: Uint8Array | UuidSlugError, byteOffset: number, ...textCase: UuidTextCaseArguments<Case>): UuidV7StringFor<Case> | UuidSlugError;
168
210
  /**
169
211
  * Convert either plain UUIDv7 slug spelling to this codec's current masked or sentinel spelling.
170
212
  * TypeScript rejects known UUIDv4 slugs. Other UUIDv4 input returns `invalid_uuid_version`;
@@ -241,5 +283,4 @@ export interface UuidV7MaskingCodec {
241
283
  */
242
284
  validateMaskedUuidV7SlugUnixMs<Input extends string | UuidSlugError>(this: void, maskedUuidSlug: SlugStringInput<Input>, window: UuidV7TimestampWindow): (Input extends PlainUuidSlug | MaskedOrSentinelUuidV7Slug ? Input & MaskedOrSentinelUuidV7Slug : MaskedOrSentinelUuidV7Slug) | UuidSlugError;
243
285
  }
244
- //#endregion
245
286
  //# sourceMappingURL=masking-codec-types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"masking-codec-types.d.ts","names":[],"sources":["../src/masking-codec-types.ts"],"mappings":";;;;;;;iBAyCiB;;;;;;;;WAQN;;;;;;;;WAQA,0BACL,aACA,oBACA,qBACA;;;;;;WAOK,qBAAqB;;;;;;;;;WASrB,qBAAqB;;;;;;;YAQpB,6BACP;;;;;;WAMU,MAAM,aAAa,oBAAoB;WACvC;MAEV;WACU;;;;;;;WAOA,mBAAmB;;;iBAIjB;;WAEN,MAAM,aAAa,oBAAoB;;WAEvC;;;;;;;iBAQM;;WAEN,oBAAoB;;EAE7B,oBAAA,YAEE,UAAU,iCACT,sBAAsB;;EAEzB,UAAU,cAAc,WAAA,YAEtB,MAAM,QACL,iBAAiB,eAAe;;;;;;EAMnC,aAAa,cAAc,WAAW,aAAa,sBAAsB,qBAEvE,YAAA,MAAM,UACH,UAAU,sBAAsB,QAClC,iBAAiB,sBAAsB,QAAQ;;;;;;EAMlD,aAAa,aAAa,sBAAsB,qBAAA,YAE9C,MAAM,YACN,uBACG,UAAU,sBAAsB,QAClC,iBAAiB,YAAY;;;;;;EAMhC,YAAY,cAAc,WAAA,YAExB,MAAM,QACL,gBAAgB,sBAAsB;;EAEzC,YAAY,eAAe,YAAA,YAEzB,MAAM,WACN,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;EAMxB,YAAA,YAAwB,MAAM,YAAY,qBAAqB,gBAAgB;;EAE/E,YAAY,eAAe,YAAA,YAEzB,MAAM,YACN,oBACA,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;EAMxB,gBAAgB,cAAc,WAAA,YAE5B,MAAM,OACN,WAAW,eACV,oBAAoB,sBAAsB;;;;;;EAM7C,gBAAA,YAEE,MAAM,YACN,oBACA,WAAW,eACV,oBAAoB;;;;;;;;;EASvB,+BAAA,YAEE,sBACC,gCAAgC;;EAEnC,qCAAqC,gBAAgB,0BAAA,YAEnD,SAAS,sBACR,yBAAyB,uBAAuB,YAAY;;;;;;;;EAQ/D,yBAAA,YAEE,UAAU,iCACT,6BAA6B;;;;;;;;;;;EAWhC,6BAA6B,aAAa,sBAAsB,qBAAA,eAE3D,UAAU,sBAAsB,QAClC,gBAAgB,4BAA4B,QAAQ;;EAEvD,6BAA6B,aAAa,sBAAsB,qBAAA,YAE9D,SAAS,oCAAoC,QAC5C,gBAAgB,4BAA4B,QAAQ;;;;;;;;;;;;;EAavD,iBAAiB,cAAc,WAAA,YAE7B,MAAM,iBAAiB,SACtB,6BAA6B;;;;;;;;;EAShC,sBAAsB,uBAAuB,eAAA,YAE3C,eAAe,qBAAqB,SACnC,6BAA6B;;;;;;;;;EAShC,sBAAsB,uBAAuB,eAAA,YAE3C,gBAAgB,gBAAgB,QAChC,WAAW,eACV,kBAAkB;;;;;;;;;;;EAWrB,uBACE,uBAAuB,eACvB,aAAa,sBAAsB,qBAGnC,YAAA,gBAAgB,gBAAgB,WAC7B,UAAU,sBAAsB,QAClC,gBAAgB,QAAQ;;;;;;;EAO3B,sBAAsB,uBAAuB,eAAA,YAE3C,gBAAgB,gBAAgB,SAC/B,cAAc;;;;;;;;;;EAUjB,sBAAsB,uBAAuB,eAAe,eAAe,YAEzE,YAAA,gBAAgB,gBAAgB,QAChC,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;;;EAQxB,0BAA0B,uBAAuB,eAAA,YAE/C,gBAAgB,gBAAgB,kBACtB;;;;;;;;;;EAUZ,2BAA2B,uBAAuB,eAAA,YAEhD,gBAAgB,gBAAgB,QAChC,QAAQ,sBACP,gBAAgB;;;;;;;;;;;EAWnB,+BAA+B,uBAAuB,eAAA,YAEpD,gBAAgB,gBAAgB,QAChC,QAAQ,yBAEL,cAAc,gBAAgB,6BAC3B,QAAQ,6BACR,8BACJ"}
1
+ {"version":3,"file":"masking-codec-types.d.ts","names":[],"sources":["../src/masking-codec-types.ts"],"mappings":"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"}
@@ -1,8 +1,7 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
3
  import { UuidSlugError } from "./errors.js";
4
4
  import { UuidV7MaskingCodec, UuidV7MaskingCodecOptions } from "./masking-codec-types.js";
5
- //#region src/masking-codec.d.ts
6
5
  /**
7
6
  * Build an immutable UUIDv7 masking codec from a private `maskSeed`, or from an explicit `mask` when
8
7
  * it is derived elsewhere or needs a label or work factor. It reads the writer first, then
@@ -15,5 +14,4 @@ import { UuidV7MaskingCodec, UuidV7MaskingCodecOptions } from "./masking-codec-t
15
14
  * @returns The masking codec, or `UuidSlugError` when its configuration is invalid.
16
15
  */
17
16
  export declare function createUuidV7MaskingCodec(options: UuidV7MaskingCodecOptions): UuidV7MaskingCodec | UuidSlugError;
18
- //#endregion
19
17
  //# sourceMappingURL=masking-codec.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"masking-codec.d.ts","names":[],"sources":["../src/masking-codec.ts"],"mappings":";;;;;;;;;;;;;;;;wBAmVgB,yBACd,SAAS,4BACR,qBAAqB"}
1
+ {"version":3,"file":"masking-codec.d.ts","names":[],"sources":["../src/masking-codec.ts"],"mappings":";;;;;;;;;;;;;;;wBAmVgB,yBACd,SAAS,4BACR,qBAAqB"}