@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":"timestamp.js","names":["TIMESTAMP_WINDOW_OPTIONS","bytes","UuidSlugError","INVALID_UUID_VERSION","timestamp","maxTimestampDeltaMs","referenceUnixMs","window","INVALID_TIMESTAMP","unknown","cause","TIMESTAMP_OUTSIDE_WINDOW","UUID_TEXT_LOWERCASE","uuidText","uuid","normalized","normalizeUuidStringInput","selectedCase","resolveUuidTextCase","textCase","uuidStringToBytes","valid"],"sources":["../src/timestamp.ts"],"mappings":";;;;;;AA0BA,MAAMA,IAA2B;CAC/B,qBAAqB;CACrB,iBAAiB;AACnB;AAGA,SAAgB,uBACd,GACA,GAC2B;CAC3B,IAAI,CAAC,kBAAcC,CAAK,GACtB,OAAO,IAAIC,EACTC,GACA,sDACF;CACF,IAAMC,IAAY,kBAAgCH,GAAO,CAAC,GACtDI,GACAC;CACJ,IAAI;EACF,IAAI,OAAOC,KAAW,aAAYA,KAAmB,MAAM,QAAQA,CAAM,GACvE,OAAO,IAAIL,EAAcM,GAAmB,qCAAqC;EACnF,IAAMC,IAAU,kBAAkBF,GAAQP,CAAwB;EAClE,IAAIS,MAAY,KAAA,GACd,OAAO,IAAIP,EAAcM,GAAmB,oCAAoCC,EAAQ,EAAE;EAE5F,AADA,IAAsBF,EAAO,qBAC7B,IAAkBA,EAAO,mBAAmB,KAAK,IAAI;CACvD,SAASG,GAAO;EACd,OAAO,IAAIR,EAAcM,GAAmB,uCAAuC,EAAE,SAAM,CAAC;CAC9F;CACA,IAAI,CAAC,OAAO,SAASH,CAAmB,KAAKA,IAAsB,GACjE,OAAO,IAAIH,EACTM,GACA,2EACF;CACF,IAAI,CAAC,OAAO,SAASF,CAAe,GAClC,OAAO,IAAIJ,EACTM,GACA,+DACF;CACF,IACEJ,IAAYE,IAAkBD,KAC9BD,IAAYE,IAAkBD,GAE9B,OAAO,IAAIH,EACTS,GACA,oBAAoBP,EAAU,cAAcE,IAAkBD,EAAoB,IAAIC,IAAkBD,EAAoB,oBAC9H;AAEJ;AAqBA,SAAgB,2BACd,GACA,GACA,IAAyBO,GACD;CACxB,IAAIC;CACJ,IAAI,OAAOC,KAAS,UAClB,IAAWA;MACN;EACL,IAAMC,IAAaC,EAAyBF,CAAI;EAChD,IAAI,OAAOC,KAAe,UAAU,OAAOA;EAC3C,IAAWA;CACb;CACA,IAAME,IAAeC,EAAoBC,CAAQ;CACjD,IAAIF,aAAwB,OAAO,OAAOA;CAC1C,IAAMhB,IAAQmB,EAAkBP,CAAQ;CACxC,IAAIZ,aAAiB,OAAO,OAAOA;CACnC,IAAMoB,IAAQ,uBAAuBpB,GAAOM,CAAM;CAQlD,OAPIc,aAAiB,QAAcA,IAEjCR,EAAS,WAAW,OACnBI,MAAA,cACGJ,MAAaA,EAAS,YAAY,IAClCA,MAAaA,EAAS,YAAY,KACZA,IACrB,kBAAyBZ,GAAO,GAAGgB,CAAY;AACxD"}
1
+ {"version":3,"file":"timestamp.js","names":["INVALID_TIMESTAMP","INVALID_UUID_VERSION","TIMESTAMP_OUTSIDE_WINDOW","UuidSlugError","findUnknownOption","normalizeUuidStringInput","UUID_TEXT_LOWERCASE","formatUuidBytesUnchecked","isUuidV7Bytes","resolveUuidTextCase","uuidStringToBytes","uuidTimestampFromBytesUnchecked","TIMESTAMP_WINDOW_OPTIONS","bytes","window","timestamp","maxTimestampDeltaMs","referenceUnixMs","unknown","cause","uuid","textCase","uuidText","normalized","selectedCase","valid"],"sources":["../src/timestamp.ts"],"mappings":";;;;;;AA0BA,MAAMY,IAA2B;CAC/B,qBAAqB;CACrB,iBAAiB;AACnB;AAGA,SAAgB,uBACdC,GACAC,GAC2B;CAC3B,IAAI,CAACN,kBAAcK,CAAK,GACtB,OAAO,IAAIV,EACTF,GACA,sDACF;CACF,IAAMc,IAAYJ,kBAAgCE,GAAO,CAAC,GACtDG,GACAC;CACJ,IAAI;EACF,IAAI,OAAOH,KAAW,aAAYA,KAAmB,MAAM,QAAQA,CAAM,GACvE,OAAO,IAAIX,EAAcH,GAAmB,qCAAqC;EACnF,IAAMkB,IAAUd,kBAAkBU,GAAQF,CAAwB;EAClE,IAAIM,MAAY,KAAA,GACd,OAAO,IAAIf,EAAcH,GAAmB,oCAAoCkB,EAAQ,EAAE;EAC5FF,IAAsBF,EAAO,qBAC7BG,IAAkBH,EAAO,mBAAmB,KAAK,IAAI;CACvD,SAASK,GAAO;EACd,OAAO,IAAIhB,EAAcH,GAAmB,uCAAuC,EAAEmB,SAAM,CAAC;CAC9F;CACA,IAAI,CAAC,OAAO,SAASH,CAAmB,KAAKA,IAAsB,GACjE,OAAO,IAAIb,EACTH,GACA,2EACF;CACF,IAAI,CAAC,OAAO,SAASiB,CAAe,GAClC,OAAO,IAAId,EACTH,GACA,+DACF;CACF,IACEe,IAAYE,IAAkBD,KAC9BD,IAAYE,IAAkBD,GAE9B,OAAO,IAAIb,EACTD,GACA,oBAAoBa,EAAU,cAAcE,IAAkBD,EAAoB,IAAIC,IAAkBD,EAAoB,oBAC9H;AAEJ;AAqBA,SAAgB,2BACdI,GACAN,GACAO,IAAyBf,GACD;CACxB,IAAIgB;CACJ,IAAI,OAAOF,KAAS,UAClBE,IAAWF;MACN;EACL,IAAMG,IAAalB,EAAyBe,CAAI;EAChD,IAAI,OAAOG,KAAe,UAAU,OAAOA;EAC3CD,IAAWC;CACb;CACA,IAAMC,IAAef,EAAoBY,CAAQ;CACjD,IAAIG,aAAwB,OAAO,OAAOA;CAC1C,IAAMX,IAAQH,EAAkBY,CAAQ;CACxC,IAAIT,aAAiB,OAAO,OAAOA;CACnC,IAAMY,IAAQ,uBAAuBZ,GAAOC,CAAM;CAQlD,OAPIW,aAAiB,QAAcA,IAEjCH,EAAS,WAAW,OACnBE,MAAA,cACGF,MAAaA,EAAS,YAAY,IAClCA,MAAaA,EAAS,YAAY,KACZA,IACrBf,kBAAyBM,GAAO,GAAGW,CAAY;AACxD"}
package/dist/types.d.ts CHANGED
@@ -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
5
  import { UuidV7MaskingCodec, UuidV7MaskingCodecOptions, UuidV7MaskingCodecSharedOptions, UuidV7PreviousMask } from "./masking-codec-types.js";
6
- //#region src/types.d.ts
7
6
  declare const brand: unique symbol;
8
7
  declare const uuidV7MaskBrand: unique symbol;
9
8
  /** Select the standard lowercase UUID text spelling. */
@@ -19,6 +18,9 @@ export declare const UUID_V7_ROLLBACK_ERROR = "error";
19
18
  /** Select the hexadecimal letter case of UUID text output. JavaScript also accepts genuine `String` objects. */
20
19
  export type UuidTextCase = typeof UUID_TEXT_LOWERCASE | typeof UUID_TEXT_UPPERCASE;
21
20
  export type UuidTextCaseArguments<Case extends UuidTextCase> = typeof UUID_TEXT_LOWERCASE extends Case ? [textCase?: Case] : [textCase: Case];
21
+ export type UuidGenerationTextCase<Input> = Input extends UuidTextCase ? Input : Input extends object ? "textCase" extends keyof Input ? Extract<Input["textCase"], UuidTextCase> | (undefined extends Input["textCase"] ? typeof UUID_TEXT_LOWERCASE : never) : typeof UUID_TEXT_LOWERCASE : typeof UUID_TEXT_LOWERCASE;
22
+ export type UuidGenerationFailure<Input> = Input extends object ? UuidSlugError : never;
23
+ export type UuidGenerationInput<Input, Options> = Input extends Uint8Array ? Input : Input extends object ? Exclude<keyof Input, keyof Options> extends never ? Input : Input & { [Key in Exclude<keyof Input, keyof Options>]: never; } : Input;
22
24
  type UuidTextCaseOptions<Case extends UuidTextCase> = typeof UUID_TEXT_LOWERCASE extends Case ? {
23
25
  readonly textCase?: Case;
24
26
  } : {
@@ -87,7 +89,7 @@ export type PlainUuidV7Slug = Brand<PlainUuidSlug, "PlainUuidV7Slug">;
87
89
  /** Carry a UUID version from immutable input; mutable bytes cannot prove their current version. */
88
90
  export type PreserveUuidVersion<Input, UnknownVersion, Version4, Version7> = Input extends UuidSlugError ? never : Input extends Uuid<infer Version, boolean, boolean> ? Version extends 4 ? Version4 : Version extends 7 ? Version7 : UnknownVersion : Input extends UuidV4Text | PlainUuidV4Slug ? Version4 : Input extends UuidV7Text | PlainUuidV7Slug | MaskedUuidSlug ? Version7 : UnknownVersion;
89
91
  /** Infer a version from immutable input; mutable bytes retain the complete version-field range. */
90
- export type UuidVersionOf<Input> = Input extends UuidSlugError ? never : Input extends Uuid<infer Version, boolean, boolean> ? Version : Input extends UuidV4Text | PlainUuidV4Slug ? 4 : Input extends UuidV7Text | PlainUuidV7Slug | MaskedUuidSlug ? 7 : UuidVersion;
92
+ type UuidVersionOf<Input> = Input extends UuidSlugError ? never : Input extends Uuid<infer Version, boolean, boolean> ? Version : Input extends UuidV4Text | PlainUuidV4Slug ? 4 : Input extends UuidV7Text | PlainUuidV7Slug | MaskedUuidSlug ? 7 : UuidVersion;
91
93
  export type MaskingCodecUuidInput<Input> = Input extends PlainUuidV4Slug ? PlainUuidV4Slug | MaskedUuidV7Slug : Input;
92
94
  /** A masked payload in either spelling; its check bits are not plain-encoding padding. */
93
95
  type MaskedUuidSlug = Brand<string, "MaskedUuidSlug">;
@@ -101,6 +103,12 @@ export type MaskedUuidV7Slug = Brand<MaskedUuidSlug, "MaskedUuidV7Slug">;
101
103
  export type SentinelUuidV7Slug = Brand<PlainUuidV7Slug, "SentinelUuidV7Slug">;
102
104
  /** A masking result: either a masked UUIDv7 or a registered plain sentinel. */
103
105
  export type MaskedOrSentinelUuidV7Slug = MaskedUuidV7Slug | SentinelUuidV7Slug;
106
+ /** An owned 16-byte mixed UUIDv7 block with its 12-bit inner check; not raw UUID bytes. */
107
+ export type MaskedUuidV7Bytes = Brand<Uint8Array, "MaskedUuidV7Bytes">;
108
+ /** A registered sentinel's unmasked UUIDv7 bytes. */
109
+ export type SentinelUuidV7Bytes = Brand<UuidV7Bytes, "SentinelUuidV7Bytes">;
110
+ /** Binary masking output: a mixed block or a registered sentinel's raw UUID bytes. */
111
+ export type MaskedOrSentinelUuidV7Bytes = MaskedUuidV7Bytes | SentinelUuidV7Bytes;
104
112
  /** One generated UUIDv7 in the selected text case and one selected slug made from the same bytes. */
105
113
  export interface GeneratedUuidV7<Slug extends PlainUuidV7Slug | MaskedOrSentinelUuidV7Slug, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE> {
106
114
  /** UUIDv7 text in the requested case. */
@@ -200,6 +208,12 @@ export interface Uuid<Version extends UuidVersion = UuidVersion, HasMaskingCodec
200
208
  toJSON<Receiver extends AnyUuid>(this: Receiver): UuidStringForVersion<Receiver["version"], typeof UUID_TEXT_LOWERCASE>;
201
209
  }
202
210
  type RejectKnownInput<Input, Invalid> = [Extract<Exclude<Input, UuidSlugError>, Invalid>] extends [never] ? Input : never;
211
+ /** Raw UUID readers cannot infer masked provenance from the identical 16-byte shape. */
212
+ export type UnmaskedUuidInput<Input> = Input & {
213
+ readonly [brand]?: object & {
214
+ readonly MaskedUuidV7Bytes?: never;
215
+ };
216
+ };
203
217
  /** Reject a known slug; the operation parses UUID text. A bare string is validated at runtime. */
204
218
  export type UuidStringInput<Input extends string | UuidSlugError> = RejectKnownInput<Input, PlainUuidSlug | MaskedUuidSlug>;
205
219
  /** Reject known UUID text and masked slugs; only a plain slug decodes without a key. */
@@ -210,19 +224,22 @@ export type SlugStringInput<Input extends string | UuidSlugError> = RejectKnownI
210
224
  export type UuidV7StringInput<Input extends string | UuidSlugError> = RejectKnownInput<Input, PlainUuidSlug | MaskedUuidSlug | UuidV4Text>;
211
225
  /** Reject known UUID text, masked slugs, and UUIDv4 slugs; the operation needs a plain UUIDv7 slug. */
212
226
  export type PlainUuidV7SlugInput<Input extends string | UuidSlugError> = RejectKnownInput<Input, UuidText | MaskedUuidSlug | PlainUuidV4Slug>;
213
- /** Reject masked slugs and known UUIDv4 values across text and byte timestamp inputs. */
214
- export type UuidV7TimestampInput<Input extends string | UuidByteInput | UuidSlugError> = RejectKnownInput<Input, MaskedUuidSlug | UuidV4Text | PlainUuidV4Slug | UuidV4Bytes>;
215
- /** Reject known UUIDv4 bytes; the operation needs UUIDv7 bytes. */
216
- export type UuidV7BytesInput<Input extends UuidByteInput | UuidSlugError> = RejectKnownInput<Input, UuidV4Bytes>;
227
+ /** Reject masked slugs, mixed bytes and known UUIDv4 values across timestamp inputs. */
228
+ export type UuidV7TimestampInput<Input extends string | UuidByteInput | UuidSlugError> = RejectKnownInput<Input, MaskedUuidSlug | MaskedUuidV7Bytes | UuidV4Text | PlainUuidV4Slug | UuidV4Bytes>;
229
+ /** Reject mixed and known UUIDv4 bytes; the operation needs raw UUIDv7 bytes. */
230
+ export type UuidV7BytesInput<Input extends UuidByteInput | UuidSlugError> = RejectKnownInput<Input, UuidV4Bytes | MaskedUuidV7Bytes>;
217
231
  /** Reject known non-v7 values; a masking codec accepts every UUIDv7 form. */
218
- export type UuidV7ValueInput<Input extends UuidInput> = RejectKnownInput<Input, UuidV4Text | UuidV4Bytes | PlainUuidV4Slug | AnyUuidForVersion<Exclude<UuidVersion, 7>>>;
232
+ export type UuidV7ValueInput<Input extends UuidInput> = RejectKnownInput<Input, UuidV4Text | UuidV4Bytes | PlainUuidV4Slug | MaskedUuidV7Bytes | AnyUuidForVersion<Exclude<UuidVersion, 7>>>;
219
233
  /** Exactly 16 validated UUID bytes. Package-owned values are plain `Uint8Array`. */
220
234
  export type UuidBytes = Brand<Uint8Array, "UuidBytes">;
221
235
  /** UUID bytes with version 4 and RFC variant bits. */
222
236
  export type UuidV4Bytes = Brand<UuidBytes, "UuidV4Bytes">;
223
237
  /** UUID bytes with version 7 and RFC variant bits. */
224
238
  export type UuidV7Bytes = Brand<UuidBytes, "UuidV7Bytes">;
225
- export type UuidOutput<Output extends Uint8Array> = Output extends UuidBytes ? Omit<Output, typeof brand> : Output;
239
+ export type UuidOutput<Output extends Uint8Array> = Output extends UuidBytes | MaskedUuidV7Bytes ? Omit<Output, typeof brand> : Output;
240
+ export type UuidGenerationBytes<Input, Owned extends UuidBytes> = Input extends Uint8Array ? UuidOutput<Input> : Input extends {
241
+ readonly output: infer Output extends Uint8Array;
242
+ } ? UuidOutput<Output> : Owned;
226
243
  /** A UUID byte source: a `Uint8Array`, a complete `ArrayBuffer`, or a `DataView`'s declared range. */
227
244
  export type UuidByteInput = Uint8Array | ArrayBuffer | DataView;
228
245
  type AnyUuidForVersion<Version extends UuidVersion> = Uuid<Version, boolean, boolean>;
@@ -234,8 +251,8 @@ export type ParsedUuidResult<Input, WithCodec extends boolean = false> = Uuid<Uu
234
251
  * implementations also normalize genuine `String` objects; TypeScript uses primitive strings.
235
252
  */
236
253
  export type UuidInput = string | UuidByteInput | AnyUuid | UuidSlugError;
237
- /** Reject a branded masked slug where no masking codec is available. */
238
- export type KeylessUuidInput<Input> = [Extract<Exclude<Input, UuidSlugError>, MaskedUuidV7Slug>] extends [never] ? Input : never;
254
+ /** Reject branded masked slugs or bytes where no masking codec is available. */
255
+ export type KeylessUuidInput<Input> = UnmaskedUuidInput<RejectKnownInput<Input, MaskedUuidV7Slug>>;
239
256
  /** UUID text or the error returned while converting the captured input. */
240
257
  export type UuidStringResult<Input, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE> = PreserveUuidVersion<Input, UuidStringFor<Case>, UuidV4StringFor<Case>, UuidV7StringFor<Case>> | UuidSlugError;
241
258
  /** UUID bytes or the error returned while converting the captured input. */
@@ -266,7 +283,7 @@ export interface UuidV7Generator {
266
283
  /** Payload layout emitted by this generator; pass it to UUIDv7 payload extraction. */
267
284
  readonly payloadLayout: UuidV7PayloadLayout;
268
285
  /** Generate an immutable UUIDv7 that remembers this generator's payload layout. */
269
- generateUuidV7Value(this: void, options?: undefined): Uuid<7, false, true> | UuidSlugError;
286
+ generateUuidV7Value(this: void): Uuid<7, false, true> | UuidSlugError;
270
287
  /** Generate with supplied time or masking options; only a supplied codec is retained. */
271
288
  generateUuidV7Value<const Options extends UuidV7GeneratorValueOptions | undefined>(this: void, options: Options): Uuid<7, Options extends {
272
289
  readonly maskingCodec: UuidV7MaskingCodec;
@@ -275,6 +292,8 @@ export interface UuidV7Generator {
275
292
  generateUuidV7<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, ...textCase: UuidTextCaseArguments<Case>): UuidV7StringFor<Case> | UuidSlugError;
276
293
  /** Generate UUIDv7 text at an explicit time or the current clock reading. */
277
294
  generateUuidV7<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, options: Omit<GenerateUuidV7Options<Case>, "generator">): UuidV7StringFor<Case> | UuidSlugError;
295
+ /** Forward a spelling preset or optional settings through this generator's sequence. */
296
+ generateUuidV7<const Input extends UuidTextCase | Omit<GenerateUuidV7Options<UuidTextCase>, "generator"> | undefined>(this: void, textCaseOrOptions: UuidGenerationInput<Input, Omit<GenerateUuidV7Options<UuidTextCase>, "generator">>): UuidV7StringFor<UuidGenerationTextCase<Input>> | UuidSlugError;
278
297
  /** Generate a new plain 16-byte `Uint8Array` for the current clock reading. */
279
298
  generateUuidV7Bytes(this: void): UuidV7Bytes | UuidSlugError;
280
299
  /**
@@ -289,6 +308,8 @@ export interface UuidV7Generator {
289
308
  generateUuidV7Bytes(this: void, options: Omit<GenerateUuidV7BytesOptions, "generator">): UuidV7Bytes | UuidSlugError;
290
309
  /** Write UUIDv7 bytes at an explicit time or the current clock reading into caller-owned storage. */
291
310
  generateUuidV7Bytes<Output extends Uint8Array>(this: void, options: Omit<GenerateUuidV7BytesIntoOptions<Output>, "generator">): UuidOutput<Output> | UuidSlugError;
311
+ /** Forward optional storage or settings, preserving caller-array types and sequence state. */
312
+ generateUuidV7Bytes<const Input extends Uint8Array | Omit<GenerateUuidV7BytesOptions, "generator"> | Omit<GenerateUuidV7BytesIntoOptions<Uint8Array>, "generator"> | undefined>(this: void, outOrOptions: UuidGenerationInput<Input, Omit<GenerateUuidV7BytesOptions & GenerateUuidV7BytesIntoOptions<Uint8Array>, "generator">>): UuidGenerationBytes<Input, UuidV7Bytes> | UuidSlugError;
292
313
  /**
293
314
  * Generate a plain UUIDv7 slug in this sequence. Lowercase base32hex preserves UUID byte order;
294
315
  * base64url does not preserve that order under text comparison.
@@ -306,9 +327,11 @@ export interface UuidV7Generator {
306
327
  */
307
328
  generateUuidV7WithPlainSlug(this: void, alphabet?: SlugAlphabet): GeneratedUuidV7<PlainUuidV7Slug> | UuidSlugError;
308
329
  generateUuidV7WithPlainSlug<Case extends UuidTextCase>(this: void, textCase: Case): GeneratedUuidV7<PlainUuidV7Slug, Case> | UuidSlugError;
309
- generateUuidV7WithPlainSlug<Case extends UuidTextCase>(this: void, alphabet: SlugAlphabet, textCase: Case): GeneratedUuidV7<PlainUuidV7Slug, Case> | UuidSlugError;
330
+ generateUuidV7WithPlainSlug<Case extends UuidTextCase>(this: void, alphabet: SlugAlphabet | undefined, textCase: Case): GeneratedUuidV7<PlainUuidV7Slug, Case> | UuidSlugError;
310
331
  /** Generate the pair at an explicit time or the current clock reading, in the selected spellings. */
311
332
  generateUuidV7WithPlainSlug<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, options: Omit<GenerateUuidV7WithPlainSlugOptions<Case>, "generator">): GeneratedUuidV7<PlainUuidV7Slug, Case> | UuidSlugError;
333
+ /** Forward presets or optional settings through this sequence, retaining the UUID text case. */
334
+ generateUuidV7WithPlainSlug<const Input extends SlugAlphabet | UuidTextCase | Omit<GenerateUuidV7WithPlainSlugOptions<UuidTextCase>, "generator"> | undefined>(this: void, alphabetOrCaseOrOptions: UuidGenerationInput<Input, Omit<GenerateUuidV7WithPlainSlugOptions<UuidTextCase>, "generator">>): GeneratedUuidV7<PlainUuidV7Slug, UuidGenerationTextCase<Input>> | UuidSlugError;
312
335
  }
313
336
  /**
314
337
  * A standard host instant; generation uses every sub-millisecond fraction bit its layout provides.
@@ -515,7 +538,7 @@ export interface UuidSlugMigrationDecoder<in Format extends UuidSlugMigrationFor
515
538
  */
516
539
  uuidSlugToUuidString<Input extends string | UuidSlugError, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, uuidSlug: SlugStringInput<Input>, ...textCase: UuidTextCaseArguments<Case>): UuidStringFor<Case> | UuidSlugError;
517
540
  uuidSlugToUuidString<Input extends string | UuidSlugError>(this: void, uuidSlug: SlugStringInput<Input>, format: Format | undefined): UuidString | UuidSlugError;
518
- uuidSlugToUuidString<Input extends string | UuidSlugError, Case extends UuidTextCase>(this: void, uuidSlug: SlugStringInput<Input>, format: Format, textCase: Case): UuidStringFor<Case> | UuidSlugError;
541
+ uuidSlugToUuidString<Input extends string | UuidSlugError, Case extends UuidTextCase>(this: void, uuidSlug: SlugStringInput<Input>, format: Format | undefined, textCase: Case): UuidStringFor<Case> | UuidSlugError;
519
542
  /**
520
543
  * Return every distinct candidate in decode order for one application lookup. An empty array
521
544
  * means no enabled format matched; callback failure returns `UuidSlugError`, not a partial list.
@@ -528,8 +551,7 @@ export interface UuidSlugMigrationDecoder<in Format extends UuidSlugMigrationFor
528
551
  */
529
552
  uuidSlugToUuidStringCandidates<Input extends string | UuidSlugError, Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(this: void, uuidSlug: SlugStringInput<Input>, ...textCase: UuidTextCaseArguments<Case>): readonly UuidStringFor<Case>[] | UuidSlugError;
530
553
  uuidSlugToUuidStringCandidates<Input extends string | UuidSlugError>(this: void, uuidSlug: SlugStringInput<Input>, format: Format | undefined): readonly UuidString[] | UuidSlugError;
531
- uuidSlugToUuidStringCandidates<Input extends string | UuidSlugError, Case extends UuidTextCase>(this: void, uuidSlug: SlugStringInput<Input>, format: Format, textCase: Case): readonly UuidStringFor<Case>[] | UuidSlugError;
554
+ uuidSlugToUuidStringCandidates<Input extends string | UuidSlugError, Case extends UuidTextCase>(this: void, uuidSlug: SlugStringInput<Input>, format: Format | undefined, textCase: Case): readonly UuidStringFor<Case>[] | UuidSlugError;
532
555
  }
533
- //#endregion
534
556
  export type { UuidV7MaskingCodec, UuidV7MaskingCodecOptions, UuidV7PreviousMask };
535
557
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;cAac;cACA;;qBAGD;;qBAEA;;qBAEA;;qBAEA;;qBAEA;;YAGD,sBAAsB,6BAA6B;YAInD,sBAAsB,aAAa,uBACtC,4BAA4B,QAAQ,WAAW,SAAS,UAAU;KAGtE,oBAAoB,aAAa,uBAAuB,4BAA4B;WAC1E,WAAW;;WACX,UAAU;;;YAGb;;qBAGC;;qBAEA;;qBAEA;;qBAEA;;YAGD,qBACD,0BACA,0BACA,gCACA;;YAGC;WACG,eAAe;;WAEf,eAAe,gCAAgC;;WAE/C;;;;;;;YAQH,kBAAkB,OAAO,sBAAsB;;KAGtD,MAAM,OAAO,uBAAuB;YAC7B,WAAW,aAAa;;;YAIxB,WAAW;;YAEX,aAAa,MAAM;;YAEnB,aAAa,MAAM;;YAEnB,aAAa,MAAM;;YAEnB,sBAAsB,MAAM;;YAE5B,cAAc,aAAa,gBAAgB,oBAAoB,sBACvE,sBACA;;YAEQ,eAAe,MAAM,aAAa;;YAElC,wBAAwB,MAAM,sBAAsB;;YAEpD,gBAAgB,aAAa,gBAAgB,oBAAoB,sBACzE,wBACA;;YAEQ,eAAe,MAAM,aAAa;;YAElC,wBAAwB,MAAM,sBAAsB;;YAEpD,gBAAgB,aAAa,gBAAgB,oBAAoB,sBACzE,wBACA;;YAEQ,gBAAgB;;YAEhB,kBAAkB,MAAM;;YAExB,kBAAkB,MAAM;;YAKxB,oBAAoB,OAAO,gBAAgB,UAAU,YAC/D,cAAc,wBAEV,cAAc,WAAW,6BACvB,oBACE,WACA,oBACE,WACA,iBACJ,cAAc,aAAa,kBACzB,WACA,cAAc,aAAa,kBAAkB,iBAC3C,WACA;;YAEA,cAAc,SAAS,cAAc,wBAE7C,cAAc,WAAW,6BACvB,UACA,cAAc,aAAa,sBAEzB,cAAc,aAAa,kBAAkB,qBAE3C;YAIE,sBAAsB,SAAS,cAAc,kBACrD,kBAAkB,mBAClB;;KAGC,iBAAiB;;;;;;YAMV,mBAAmB,MAAM;;YAEzB,qBAAqB,MAAM;;YAE3B,6BAA6B,mBAAmB;;iBAG3C,gBACf,aAAa,kBAAkB,4BAC/B,aAAa,sBAAsB;;WAG1B,MAAM,gBAAgB;;WAEtB,MAAM;;;iBAIA,aAAa,cAAc,gBAAgB,gBAAgB;;WAEjE,gBAAgB;;WAEhB,cAAc;;;iBAIR;;WAEN;;WAEA;;;iBAIM;;WAEN;;WAEA;aAAmC;aAAwB;;;WAE3D;aAAoB;aAAwB;;;WAE5C;aAAsB;aAAwB;;;;iBAIxC,eAAe,gBAAgB,cAAc;;WAEnD,MAAM,qBAAqB,gBAAgB;;WAE3C,SAAS;;WAET,SAAS;;WAET;;WAEA;;WAEA;;;YAIC,qBAAqB,SAAS,aAAa,gBAAgB,oBACnE,gBAAgB,QAChB,oBACE,gBAAgB,QAChB,cAAc;;YAER,oBAAoB,WAAW,oBACvC,cACA,oBACE,cACA;;YAEM,wBAAwB,WAAW,oBAC3C,kBACA,oBACE,kBACA;;iBAGW,KACf,gBAAgB,cAAc,aAC9B,yCACA;;YAMU;aACC,eAAe;aACf,gBAAgB;;;WAGlB,SAAS;;EAIlB,QAAQ,iBAAiB,SAAA,MAAe,WAAW,eAAe;;EAElE,SAAS,aAAa,sBAAsB,qBAAA,MACpC,KAAK,+BACR,UAAU,sBAAsB,QAClC,qBAAqB,SAAS;;EAEjC,SACE,aAAa,sBAAsB,qBACnC,iBAAiB,UAAU,SAErB,MAAA,aACH,UAAU,sBAAsB,QAClC,qBAAqB,qBAAqB;;EAE7C,QAAQ,iBAAiB,SAAA,MAAe,WAAW,oBAAoB;;EAEvE,QAAQ,eAAe,YAAA,MACf,SACN,QAAQ,QACR,wBACC,WAAW,UAAU;;EAExB,YAAY,iBAAiB,SAAA,MACrB,UACN,WAAW,eACV,wBAAwB;;EAI3B,aAAA,MACQ,KAAK,4BACX,wBAAwB,UAAU,6BACjC,6BAA6B;;;;;;EAMhC,aAAA,MACQ,KAAK,SAAS,8BACjB,iBAAiB,WACf,4CACW,eAAe,gCACf,cAAc,gCAChB,uBACb,6BAA6B;;EAEhC,iBAAA,MACQ,KAAK,4BACX,yBAAyB,UAAU,8BAClC,gBAAgB;;EAEnB,iBAAA,MACQ,KAAK,kBAAkB,sBAC1B,kBAAkB,WAChB,6CACW,gBAAgB,iCAChB,eAAe,iCACjB,wBACb,gBAAgB;;EAEnB,OAAO,iBAAiB,SAAA,MAChB,WACL,qBAAqB,4BAA4B;;KAQjD,iBAAiB,OAAO,YAAY,QAAQ,QAAQ,OAAO,gBAAgB,4BAG5E;;YAIQ,gBAAgB,uBAAuB,iBAAiB,iBAClE,OACA,gBAAgB;;YAGN,mBAAmB,uBAAuB,iBAAiB,iBACrE,OACA,WAAW;;YAGD,gBAAgB,uBAAuB,iBAAiB,iBAClE,OACA;;YAGU,kBAAkB,uBAAuB,iBAAiB,iBACpE,OACA,gBAAgB,iBAAiB;;YAGvB,qBAAqB,uBAAuB,iBAAiB,iBACvE,OACA,WAAW,iBAAiB;;YAGlB,qBAAqB,uBAAuB,gBAAgB,iBACtE,iBAAiB,OAAO,iBAAiB,aAAa,kBAAkB;;YAE9D,iBAAiB,cAAc,gBAAgB,iBAAiB,iBAC1E,OACA;;YAGU,iBAAiB,cAAc,aAAa,iBACtD,OACA,aAAa,cAAc,kBAAkB,kBAAkB,QAAQ;;YAG7D,YAAY,MAAM;;YAElB,cAAc,MAAM;;YAEpB,cAAc,MAAM;YAIpB,WAAW,eAAe,cAAc,eAAe,YAC/D,KAAK,eAAe,SACpB;;YAGQ,gBAAgB,aAAa,cAAc;KAClD,kBAAkB,gBAAgB,eAAe,KAAK;KACtD,UACD,kBAAkB,kBACf,WAAW,cAAc,kBAAkB,YAAW;KAGxD,WAAW,OAAO,mDAAmD,cAAc,UACpF,YAAY,aAAa,QAAQ;YAEzB,iBAAiB,OAAO,qCAAqC,KACvE,cAAc,yBAAyB,sBAAsB,SAAS,QACtE,iCAEK,WAAW,QAAQ,OAAO,iEAG9B,WAAW,QAAQ,OAAO;;;;;YAMjB,qBAAqB,gBAAgB,UAAU;;YAE/C,iBAAiB,UAC3B,QAAQ,QAAQ,OAAO,gBAAgB,qCAErC;;YAGQ,iBAAiB,OAAO,aAAa,sBAAsB,uBACnE,oBAAoB,OAAO,cAAc,OAAO,gBAAgB,OAAO,gBAAgB,SACvF;;YAEQ,gBAAgB,SACxB,oBAAoB,OAAO,WAAW,aAAa,eACnD;;YAEQ,oBAAoB,SAC5B,oBAAoB,OAAO,eAAe,iBAAiB,mBAC3D;;;;;iBAMa;;WAEN;;;;;;WAMA;;;;;;;;iBASM;;WAEN,eAAe;;EAExB,oBAAA,YAAgC,sBAAsB,uBAAuB;;EAE7E,0BAA0B,gBAAgB,yCAAA,YAExC,SAAS,UAEP,QAAQ;aAA2B,cAAc;4BACjD;;EAEJ,eAAe,aAAa,sBAAsB,qBAAA,eAE7C,UAAU,sBAAsB,QAClC,gBAAgB,QAAQ;;EAE3B,eAAe,aAAa,sBAAsB,qBAAA,YAEhD,SAAS,KAAK,sBAAsB,sBACnC,gBAAgB,QAAQ;;EAE3B,oBAAA,aAAiC,cAAc;;;;;;;;EAQ/C,oBAAoB,eAAe,YAAA,YAEjC,QAAQ,QACR,wBACC,WAAW,UAAU;;EAExB,oBAAA,YAEE,SAAS,KAAK,2CACb,cAAc;;EAEjB,oBAAoB,eAAe,YAAA,YAEjC,SAAS,KAAK,+BAA+B,wBAC5C,WAAW,UAAU;;;;;;;;EAQxB,wBAAA,YAEE,oBAAoB,eAAe,KAAK,+CACvC,kBAAkB;;;;;;;;EAQrB,4BAAA,YAEE,WAAW,eACV,gBAAgB,mBAAmB;EACtC,4BAA4B,aAAa,cAAA,YAEvC,UAAU,OACT,gBAAgB,iBAAiB,QAAQ;EAC5C,4BAA4B,aAAa,cAAA,YAEvC,UAAU,cACV,UAAU,OACT,gBAAgB,iBAAiB,QAAQ;;EAE5C,4BAA4B,aAAa,sBAAsB,qBAAA,YAE7D,SAAS,KAAK,mCAAmC,sBAChD,gBAAgB,iBAAiB,QAAQ;;;;;;YAOlC,2CAIR;WACW;;WACA;;WACA;WAAmC;;;YAGtC,sBAAsB,aAAa,sBAAsB;;WAE1D,KAAK;;WAEL,YAAY;;WAEZ,WAAW;IAClB,oBAAoB;;iBAGP;;WAEN,KAAK;;WAEL,WAAW;;WAEX,YAAY;;;iBAIN;;WAEN,KAAK;;WAEL,YAAY;WACZ;WACA;;;iBAIM,+BAA+B,eAAe;;WAEpD,KAAK;;WAEL,YAAY;;WAEZ,QAAQ;;WAER;;;YAIC,mCACV,aAAa,sBAAsB;;WAG1B,KAAK;;WAEL,WAAW;;WAEX,YAAY;;WAEZ,WAAW;IAClB,oBAAoB;;iBAGP;;WAEN,KAAK;;WAEL,eAAe;;;iBAIT,2BAA2B;;WAEjC,YAAY;;;iBAIN;;WAEN,KAAK;;WAEL,YAAY;;;YAIX,oCACV,aAAa,sBAAsB,uBACjC;;WAEO,WAAW;IAClB,oBAAoB;;iBAGP;;WAEN;YACC;;;iBAIK;;;;;;WAMN;;WAEA,OAAO,OAAO,eAAe,aAAa;;WAE1C,SAAS,OAAO,eAAe,aAAa;;;;;;iBAOtC;;;;;;;WAON;;;;;;WAMA,eAAe;;;;;;;;WAQf;;;iBAIM,+BAA+B;;;;;;WAMrC,SAAS;;;iBAIH;;WAEN;;;;;WAKA;;;iBAIM;;WAEN;;WAEA,MAAM;;WAEN,MAAM;;;qBAIJ;;qBAEA;;qBAEA;;YAGD,iCACD,4BACA,2BACA;;iBAGM;;;;;;;;WAQN;;;;;;WAMA;;KAGN,uBACH,SACA,qBAAqB,4BACnB,qBAAqB,wBAAwB,QAAQ,UAAU;;YAGvD,uBAAuB,gBAAgB,mCACxC,sBACN,uBAAuB,2DAEb,sBACV,uBAAuB,2DAEb;;;;;;;iBAQE,4BACZ,eAAe,0BAA0B;;;;;;;;;;EAW5C,qBACE,uBAAuB,eACvB,aAAa,sBAAsB,qBAGnC,YAAA,UAAU,gBAAgB,WACvB,UAAU,sBAAsB,QAClC,cAAc,QAAQ;EACzB,qBAAqB,uBAAuB,eAAA,YAE1C,UAAU,gBAAgB,QAC1B,QAAQ,qBACP,aAAa;EAChB,qBAAqB,uBAAuB,eAAe,aAAa,cAEtE,YAAA,UAAU,gBAAgB,QAC1B,QAAQ,QACR,UAAU,OACT,cAAc,QAAQ;;;;;;;;;;;EAWzB,+BACE,uBAAuB,eACvB,aAAa,sBAAsB,qBAGnC,YAAA,UAAU,gBAAgB,WACvB,UAAU,sBAAsB,iBACzB,cAAc,UAAU;EACpC,+BAA+B,uBAAuB,eAAA,YAEpD,UAAU,gBAAgB,QAC1B,QAAQ,8BACE,eAAe;EAC3B,+BAA+B,uBAAuB,eAAe,aAAa,cAEhF,YAAA,UAAU,gBAAgB,QAC1B,QAAQ,QACR,UAAU,gBACA,cAAc,UAAU"}
1
+ {"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":"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"}
package/dist/types.js CHANGED
@@ -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
3
- //#region src/types.ts
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ // src/types.ts
4
4
  const e = "lowercase", t = "uppercase", n = "preserve", r = "reset", i = "error", a = "ncs", o = "rfc", s = "microsoft", c = "future", l = "seeded-mask", u = "fixed-mask", d = "plain-slug";
5
- //#endregion
6
5
  export { u as FIXED_MASK_FORMAT, d as PLAIN_SLUG_FORMAT, l as SEEDED_MASK_FORMAT, e as UUID_TEXT_LOWERCASE, t as UUID_TEXT_UPPERCASE, i as UUID_V7_ROLLBACK_ERROR, n as UUID_V7_ROLLBACK_PRESERVE, r as UUID_V7_ROLLBACK_RESET, c as UUID_VARIANT_FUTURE, s as UUID_VARIANT_MICROSOFT, a as UUID_VARIANT_NCS, o as UUID_VARIANT_RFC };
7
6
 
8
7
  //# sourceMappingURL=types.js.map
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","names":["UUID_TEXT_LOWERCASE","UUID_TEXT_UPPERCASE","UUID_V7_ROLLBACK_PRESERVE","UUID_V7_ROLLBACK_RESET","UUID_V7_ROLLBACK_ERROR","UUID_VARIANT_NCS","UUID_VARIANT_RFC","UUID_VARIANT_MICROSOFT","UUID_VARIANT_FUTURE","SEEDED_MASK_FORMAT","FIXED_MASK_FORMAT","PLAIN_SLUG_FORMAT"],"sources":["../src/types.ts"],"mappings":";;;AAiBA,MAAaA,IAAsB,aAEtBC,IAAsB,aAEtBC,IAA4B,YAE5BC,IAAyB,SAEzBC,IAAyB,SAmBzBC,IAAmB,OAEnBC,IAAmB,OAEnBC,IAAyB,aAEzBC,IAAsB,UAypBtBC,IAAqB,eAErBC,IAAoB,cAEpBC,IAAoB"}
1
+ {"version":3,"file":"types.js","names":["UUID_TEXT_LOWERCASE","UUID_TEXT_UPPERCASE","UUID_V7_ROLLBACK_PRESERVE","UUID_V7_ROLLBACK_RESET","UUID_V7_ROLLBACK_ERROR","UUID_VARIANT_NCS","UUID_VARIANT_RFC","UUID_VARIANT_MICROSOFT","UUID_VARIANT_FUTURE","SEEDED_MASK_FORMAT","FIXED_MASK_FORMAT","PLAIN_SLUG_FORMAT"],"sources":["../src/types.ts"],"mappings":";;;AAiBA,MAAaA,IAAsB,aAEtBC,IAAsB,aAEtBC,IAA4B,YAE5BC,IAAyB,SAEzBC,IAAyB,SA2CzBC,IAAmB,OAEnBC,IAAmB,OAEnBC,IAAyB,aAEzBC,IAAsB,UA2tBtBC,IAAqB,eAErBC,IAAoB,cAEpBC,IAAoB"}
@@ -1,7 +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 { isUint8Array as e } from "./errors.js";
4
- //#region src/uuid-value-protocol.ts
4
+ // src/uuid-value-protocol.ts
5
5
  const t = Symbol.for("@anizoptera/uuid-slug.uuid-value-bytes"), n = Symbol.for("@anizoptera/uuid-slug.uuid-value-context");
6
6
  var LocalUuidValue = class {
7
7
  #e;
@@ -40,7 +40,6 @@ function uuidValueBytes(n) {
40
40
  return;
41
41
  }
42
42
  }
43
- //#endregion
44
43
  export { LocalUuidValue, t as UUID_VALUE_BYTES, n as UUID_VALUE_CONTEXT, uuidValueBytes };
45
44
 
46
45
  //# sourceMappingURL=uuid-value-protocol.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"uuid-value-protocol.js","names":["UUID_VALUE_BYTES","UUID_VALUE_CONTEXT","#bytes","bytes","#maskingCodec","maskingCodec","#payloadLayout","payloadLayout","value","read"],"sources":["../src/uuid-value-protocol.ts"],"mappings":";;;;AAKA,MAAaA,IAAmB,OAAO,IAAI,wCAAwC,GACtEC,IAAqB,OAAO,IAAI,0CAA0C;AAUvF,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CAMA,YACE,GACA,GACA,GACA;EAGA,AAFA,KAAKC,KAASC,GACd,KAAKC,KAAgBC,GACrB,KAAKC,KAAiBC;CACxB;CAGA,OAAO,GAAG,GAAyC;EACjD,OAAO,OAAOC,KAAU,cAAYA,KAAkB,MAAUA;CAClE;CAIA,OAAO,SAAS,GAAmC;EACjD,OAAOA,EAAMN;CACf;CAEA,OAAO,gBAAgB,GAAuD;EAC5E,OAAOM,EAAMJ;CACf;CAEA,OAAO,iBAAiB,GAAwD;EAC9E,OAAOI,EAAMF;CACf;CAEA,CAACL,KAAsB;EAGrB,OAAO;GACL,cAAc,KAAKG;GACnB,eAAe,KAAKE,MAAkB,EAAE,GAAG,KAAKA,GAAe;EACjE;CACF;AACF;AAGA,SAAgB,eAAe,GAAwC;CACrE,IAAI,eAAe,GAAGE,CAAK,GAAG,OAAO,eAAe,SAASA,CAAK;CAClE,IAAI,OAAOA,KAAU,YAAYA,GACjC,IAAI;EACF,IAAMC,IAAO,QAAQ,IAAID,GAAOR,CAAgB;EAChD,IAAI,OAAOS,KAAS,YAAY;EAChC,IAAMN,IAAQ,QAAQ,MAAMM,GAAMD,GAAO,CAAC,CAAC;EAC3C,OAAO,kBAAaL,CAAK,KAAKA,EAAM,WAAW,KAAKA,IAAQ,KAAA;CAC9D,QAAQ;EACN;CACF;AACF"}
1
+ {"version":3,"file":"uuid-value-protocol.js","names":["isUint8Array","UUID_VALUE_BYTES","UUID_VALUE_CONTEXT","#bytes","#maskingCodec","#payloadLayout","bytes","maskingCodec","payloadLayout","value","read"],"sources":["../src/uuid-value-protocol.ts"],"mappings":";;;;AAKA,MAAaC,IAAmB,OAAO,IAAI,wCAAwC,GACtEC,IAAqB,OAAO,IAAI,0CAA0C;AAUvF,IAAa,iBAAb,MAA4B;CACjBC;CACAC;CACAC;CAMT,YACEC,GACAC,GACAC,GACA;EACA,KAAKL,KAASG,GACd,KAAKF,KAAgBG,GACrB,KAAKF,KAAiBG;CACxB;CAGA,OAAO,GAAGC,GAAyC;EACjD,OAAO,OAAOA,KAAU,cAAYA,KAAkBN,MAAUM;CAClE;CAIA,OAAO,SAASA,GAAmC;EACjD,OAAOA,EAAMN;CACf;CAEA,OAAO,gBAAgBM,GAAuD;EAC5E,OAAOA,EAAML;CACf;CAEA,OAAO,iBAAiBK,GAAwD;EAC9E,OAAOA,EAAMJ;CACf;CAEA,CAACH,KAAsB;EAGrB,OAAO;GACL,cAAc,KAAKE;GACnB,eAAe,KAAKC,MAAkB,EAAE,GAAG,KAAKA,GAAe;EACjE;CACF;AACF;AAGA,SAAgB,eAAeI,GAAwC;CACrE,IAAI,eAAe,GAAGA,CAAK,GAAG,OAAO,eAAe,SAASA,CAAK;CAClE,IAAI,OAAOA,KAAU,YAAYA,GACjC,IAAI;EACF,IAAMC,IAAO,QAAQ,IAAID,GAAOR,CAAgB;EAChD,IAAI,OAAOS,KAAS,YAAY;EAChC,IAAMJ,IAAQ,QAAQ,MAAMI,GAAMD,GAAO,CAAC,CAAC;EAC3C,OAAOT,kBAAaM,CAAK,KAAKA,EAAM,WAAW,KAAKA,IAAQ,KAAA;CAC9D,QAAQ;EACN;CACF;AACF"}
@@ -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 { UuidV7MaskingCodec } from "./masking-codec-types.js";
5
- import { KeylessUuidInput, ParsedUuidResult, UuidInput } from "./types.js";
6
- //#region src/uuid-value.d.ts
5
+ import { KeylessUuidInput, ParsedUuidResult, UnmaskedUuidInput, UuidInput } from "./types.js";
7
6
  /** Parse any keyless UUID form once; an existing UUID retains its codec and payload-layout presets. */
8
7
  export declare function parseUuid<Input extends UuidInput>(uuid: KeylessUuidInput<Input>): ParsedUuidResult<Input> | UuidSlugError;
9
8
  /**
@@ -12,6 +11,5 @@ export declare function parseUuid<Input extends UuidInput>(uuid: KeylessUuidInpu
12
11
  * External codec bytes are validated and copied. Malformed results return `invalid_options`;
13
12
  * thrown exceptions remain available as the error's `cause`.
14
13
  */
15
- export declare function parseUuid<Input extends UuidInput>(uuid: Input, maskingCodec: UuidV7MaskingCodec): ParsedUuidResult<Input, true> | UuidSlugError;
16
- //#endregion
14
+ export declare function parseUuid<Input extends UuidInput>(uuid: UnmaskedUuidInput<Input>, maskingCodec: UuidV7MaskingCodec): ParsedUuidResult<Input, true> | UuidSlugError;
17
15
  //# sourceMappingURL=uuid-value.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"uuid-value.d.ts","names":[],"sources":["../src/uuid-value.ts"],"mappings":";;;;;;;wBA+QgB,UAAU,cAAc,WACtC,MAAM,iBAAiB,SACtB,iBAAiB,SAAS;;;;;;;wBAOb,UAAU,cAAc,WACtC,MAAM,OACN,cAAc,qBACb,iBAAiB,eAAe"}
1
+ {"version":3,"file":"uuid-value.d.ts","names":[],"sources":["../src/uuid-value.ts"],"mappings":";;;;;;wBAgRgB,UAAU,cAAc,WACtC,MAAM,iBAAiB,SACtB,iBAAiB,SAAS;;;;;;;wBAOb,UAAU,cAAc,WACtC,MAAM,kBAAkB,QACxB,cAAc,qBACb,iBAAiB,eAAe"}
@@ -1,127 +1,123 @@
1
1
  // SPDX-License-Identifier: Apache-2.0
2
- // @anizoptera/uuid-slug 0.5.0 | https://github.com/Anizoptera/uuid-slug#readme
3
- import { INVALID_OPTIONS as e, INVALID_UUID_VERSION as t, UuidSlugError as n, checkByteRange as r, isUint8Array as i, isUuidSlugError as a } from "./errors.js";
4
- import { BASE64URL_NAME as o } from "./base64url-name.js";
5
- import { BASE32HEX as s, BASE64URL as c, encode as l, isEncoded as u } from "./alphabet.js";
6
- import { UUID_TEXT_LOWERCASE as d, UUID_VARIANT_FUTURE as f, UUID_VARIANT_MICROSOFT as p } from "./types.js";
7
- import { formatUuidBytesUnchecked as m, isUuidV7Bytes as h, resolveUuidTextCase as g, uuidTimestampFromBytesUnchecked as _, uuidVersion as v } from "./uuid.js";
8
- import { readUuidV7PayloadLayout as y } from "./v7-payload.js";
9
- import { isLocalMaskingCodec as b } from "./masking-codec-protocol.js";
10
- import { LocalUuidValue as x, UUID_VALUE_BYTES as S, UUID_VALUE_CONTEXT as C } from "./uuid-value-protocol.js";
11
- import { decodeKeylessUuid as w, extractUuidV7Payload as T, resolveSlugAlphabet as E } from "./slug.js";
12
- //#region src/uuid-value.ts
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { BASE32HEX as e, BASE64URL as t, encode as n, isEncoded as r } from "./alphabet.js";
4
+ import { BASE64URL_NAME as i } from "./base64url-name.js";
5
+ import { INVALID_OPTIONS as a, INVALID_UUID_VERSION as o, UuidSlugError as s, checkByteRange as c, isUint8Array as l, isUuidSlugError as u } from "./errors.js";
6
+ import { isLocalMaskingCodec as d } from "./masking-codec-protocol.js";
7
+ import { decodeKeylessUuid as f, extractUuidV7Payload as p, resolveSlugAlphabet as m } from "./slug.js";
8
+ import { UUID_TEXT_LOWERCASE as h, UUID_VARIANT_FUTURE as g, UUID_VARIANT_MICROSOFT as _ } from "./types.js";
9
+ import { formatUuidBytesUnchecked as v, isUuidV7Bytes as y, resolveUuidTextCase as b, uuidTimestampFromBytesUnchecked as x, uuidVersion as S } from "./uuid.js";
10
+ import { LocalUuidValue as C, UUID_VALUE_BYTES as w, UUID_VALUE_CONTEXT as T } from "./uuid-value-protocol.js";
11
+ import { readUuidV7PayloadLayout as E } from "./v7-payload.js";
12
+ // src/uuid-value.ts
13
13
  const D = "A masking codec is required for masked UUID output.";
14
14
  function variantOf(e) {
15
15
  let t = e[8];
16
- return t & 128 ? (t & 192) == 128 ? "rfc" : (t & 224) == 192 ? p : f : "ncs";
16
+ return t & 128 ? (t & 192) == 128 ? "rfc" : (t & 224) == 192 ? _ : g : "ncs";
17
17
  }
18
- var ParsedUuidValue = class extends x {
18
+ var ParsedUuidValue = class extends C {
19
19
  get version() {
20
- return /* @__PURE__ */ v(x.ownBytes(this), 0);
20
+ return /* @__PURE__ */ S(C.ownBytes(this), 0);
21
21
  }
22
22
  inspect() {
23
- let e = x.ownBytes(this), t = /* @__PURE__ */ v(e, 0), n = variantOf(e), r = !0, i = !0;
23
+ let e = C.ownBytes(this), t = /* @__PURE__ */ S(e, 0), n = variantOf(e), r = !0, i = !0;
24
24
  for (let t = 0; t < 16; t += 1) {
25
25
  let n = e[t];
26
26
  r &&= n === 0, i &&= n === 255;
27
27
  }
28
28
  return Object.freeze({
29
- uuid: /* @__PURE__ */ m(e),
29
+ uuid: /* @__PURE__ */ v(e),
30
30
  version: t,
31
31
  variant: n,
32
- unixMs: t === 7 && n === "rfc" ? /* @__PURE__ */ _(e, 0) : void 0,
32
+ unixMs: t === 7 && n === "rfc" ? /* @__PURE__ */ x(e, 0) : void 0,
33
33
  isNil: r,
34
34
  isMax: i
35
35
  });
36
36
  }
37
- toString(e = d) {
38
- let t = g(e);
39
- return t instanceof Error ? t : /* @__PURE__ */ m(x.ownBytes(this), 0, t);
37
+ toString(e = h) {
38
+ let t = b(e);
39
+ return t instanceof Error ? t : /* @__PURE__ */ v(C.ownBytes(this), 0, t);
40
40
  }
41
41
  toBytes(e, t = 0) {
42
- let n = x.ownBytes(this);
43
- return e ? /* @__PURE__ */ r(e, t, 16) || (e.set(n, t), e) : new Uint8Array(n);
42
+ let n = C.ownBytes(this);
43
+ return e ? /* @__PURE__ */ c(e, t, 16) || (e.set(n, t), e) : new Uint8Array(n);
44
44
  }
45
- toPlainSlug(e = o) {
46
- let t = /* @__PURE__ */ E(e);
47
- return t instanceof Error ? t : /* @__PURE__ */ l(x.ownBytes(this), t);
45
+ toPlainSlug(e = i) {
46
+ let t = /* @__PURE__ */ m(e);
47
+ return t instanceof Error ? t : /* @__PURE__ */ n(C.ownBytes(this), t);
48
48
  }
49
- toMaskedSlug(...r) {
50
- let i = x.ownBytes(this), o = r[0] ?? x.ownMaskingCodec(this);
51
- if (!o) return new n(e, D);
52
- if (b(o)) return o.uuidToMaskedSlug(i);
53
- if (!/* @__PURE__ */ h(i)) return new n(t, "Masked output requires RFC-variant UUIDv7 bytes.");
49
+ toMaskedSlug(...n) {
50
+ let i = C.ownBytes(this), c = n[0] ?? C.ownMaskingCodec(this);
51
+ if (!c) return new s(a, D);
52
+ if (d(c)) return c.uuidToMaskedSlug(i);
53
+ if (!/* @__PURE__ */ y(i)) return new s(o, "Masked output requires RFC-variant UUIDv7 bytes.");
54
54
  try {
55
- let t = o.uuidToMaskedSlug;
56
- if (typeof t != "function") return new n(e, D);
57
- let r = Reflect.apply(t, void 0, [new Uint8Array(i)]);
58
- return /* @__PURE__ */ a(r) || typeof r == "string" && (/* @__PURE__ */ u(r, c, 16, !1, 4) || /* @__PURE__ */ u(r, s, 16, !1, 4) || /* @__PURE__ */ u(r, s, 16)) ? r : new n(e, "Masking codec must return a canonical masked slug or sentinel.");
59
- } catch (t) {
60
- return new n(e, "Masking codec UUID encoding failed.", { cause: t });
55
+ let n = c.uuidToMaskedSlug;
56
+ if (typeof n != "function") return new s(a, D);
57
+ let o = Reflect.apply(n, void 0, [new Uint8Array(i)]);
58
+ return /* @__PURE__ */ u(o) || typeof o == "string" && (/* @__PURE__ */ r(o, t, 16, !1, 4) || /* @__PURE__ */ r(o, e, 16, !1, 4) || /* @__PURE__ */ r(o, e, 16)) ? o : new s(a, "Masking codec must return a canonical masked slug or sentinel.");
59
+ } catch (e) {
60
+ return new s(a, "Masking codec UUID encoding failed.", { cause: e });
61
61
  }
62
62
  }
63
- extractV7Payload(...t) {
64
- let r = x.ownBytes(this), i = t[0] ?? x.ownPayloadLayout(this);
65
- return i ? /* @__PURE__ */ T(r, i) : new n(e, "A UUIDv7 payload layout is required.");
63
+ extractV7Payload(...e) {
64
+ let t = C.ownBytes(this), n = e[0] ?? C.ownPayloadLayout(this);
65
+ return n ? /* @__PURE__ */ p(t, n) : new s(a, "A UUIDv7 payload layout is required.");
66
66
  }
67
67
  toJSON() {
68
- return /* @__PURE__ */ m(x.ownBytes(this));
68
+ return /* @__PURE__ */ v(C.ownBytes(this));
69
69
  }
70
- [S]() {
70
+ [w]() {
71
71
  return this.toBytes();
72
72
  }
73
73
  };
74
- Object.freeze(ParsedUuidValue.prototype), Object.freeze(x.prototype);
74
+ Object.freeze(ParsedUuidValue.prototype), Object.freeze(C.prototype);
75
75
  function createUuidValue(e, t, n) {
76
76
  return Object.freeze(new ParsedUuidValue(e, t, n));
77
77
  }
78
- function readForeignUuidContext(t) {
79
- if (typeof t == "object" && t) try {
80
- let r = Reflect.get(t, C);
81
- if (typeof r != "function") return;
82
- let i = Reflect.apply(r, t, []);
83
- if (typeof i != "object" || !i) return new n(e, "UUID construction context must be an object.");
84
- let a = i, o = a.maskingCodec;
85
- if (o !== void 0 && (typeof o != "object" || !o || typeof o.uuidToMaskedSlug != "function")) return new n(e, D);
86
- let s = a.payloadLayout, c = s === void 0 ? void 0 : y(s);
78
+ function readForeignUuidContext(e) {
79
+ if (typeof e == "object" && e) try {
80
+ let t = Reflect.get(e, T);
81
+ if (typeof t != "function") return;
82
+ let n = Reflect.apply(t, e, []);
83
+ if (typeof n != "object" || !n) return new s(a, "UUID construction context must be an object.");
84
+ let r = n, i = r.maskingCodec;
85
+ if (i !== void 0 && (typeof i != "object" || !i || typeof i.uuidToMaskedSlug != "function")) return new s(a, D);
86
+ let o = r.payloadLayout, c = o === void 0 ? void 0 : E(o);
87
87
  return c instanceof Error ? c : {
88
- maskingCodec: o,
88
+ maskingCodec: i,
89
89
  payloadLayout: c
90
90
  };
91
- } catch (t) {
92
- return new n(e, "Reading UUID construction context failed.", { cause: t });
91
+ } catch (e) {
92
+ return new s(a, "Reading UUID construction context failed.", { cause: e });
93
93
  }
94
94
  }
95
- function parseUuid(t, r) {
96
- let o = x.is(t) ? t : void 0;
97
- if (o && (!r || x.ownMaskingCodec(o) === r)) return t;
98
- let s;
99
- if (!r) s = w(t);
95
+ function parseUuid(e, t) {
96
+ let n = C.is(e) ? e : void 0;
97
+ if (n && (!t || C.ownMaskingCodec(n) === t)) return e;
98
+ let r;
99
+ if (!t) r = f(e);
100
100
  else {
101
- let o = b(r);
102
- if (!o && /* @__PURE__ */ a(t)) return t;
103
- let c;
101
+ let n = d(t);
102
+ if (!n && /* @__PURE__ */ u(e)) return e;
103
+ let i;
104
104
  try {
105
- c = r.uuidToBytes;
106
- } catch (t) {
107
- return new n(e, "Reading masking codec failed.", { cause: t });
105
+ i = t.uuidToBytes;
106
+ } catch (e) {
107
+ return new s(a, "Reading masking codec failed.", { cause: e });
108
108
  }
109
- if (typeof c != "function") return new n(e, "maskingCodec must be a UUIDv7 masking codec.");
109
+ if (typeof i != "function") return new s(a, "maskingCodec must be a UUIDv7 masking codec.");
110
110
  try {
111
- if (s = Reflect.apply(c, void 0, [t]), /* @__PURE__ */ i(s) && s.length === 16) o || (s = new Uint8Array(s));
112
- else if (!/* @__PURE__ */ a(s)) return new n(e, "Masking codec must return exactly 16 UUID bytes.");
113
- } catch (t) {
114
- return new n(e, "Masking codec UUID parsing failed.", { cause: t });
111
+ if (r = Reflect.apply(i, void 0, [e]), /* @__PURE__ */ l(r) && r.length === 16) n || (r = new Uint8Array(r));
112
+ else if (!/* @__PURE__ */ u(r)) return new s(a, "Masking codec must return exactly 16 UUID bytes.");
113
+ } catch (e) {
114
+ return new s(a, "Masking codec UUID parsing failed.", { cause: e });
115
115
  }
116
116
  }
117
- if (/* @__PURE__ */ a(s)) return s;
118
- let c = o || s === t || typeof t == "string" ? void 0 : readForeignUuidContext(t);
119
- return c instanceof Error ? c : createUuidValue(r || typeof t == "string" ? s : new Uint8Array(s), r ?? c?.maskingCodec, o ? x.ownPayloadLayout(o) : c?.payloadLayout);
117
+ if (/* @__PURE__ */ u(r)) return r;
118
+ let i = n || r === e || typeof e == "string" ? void 0 : readForeignUuidContext(e);
119
+ return i instanceof Error ? i : createUuidValue(t || typeof e == "string" ? r : new Uint8Array(r), t ?? i?.maskingCodec, n ? C.ownPayloadLayout(n) : i?.payloadLayout);
120
120
  }
121
- function parseUuidWithCodec(e, t) {
122
- return parseUuid(e, t);
123
- }
124
- //#endregion
125
- export { createUuidValue, parseUuid, parseUuidWithCodec };
121
+ export { createUuidValue, parseUuid };
126
122
 
127
123
  //# sourceMappingURL=uuid-value.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"uuid-value.js","names":["MASKING_CODEC_REQUIRED","field","bytes","UUID_VARIANT_MICROSOFT","UUID_VARIANT_FUTURE","LocalUuidValue","version","variant","isNil","isMax","index","byte","UUID_TEXT_LOWERCASE","selectedCase","resolveUuidTextCase","textCase","output","checkByteRange","outputOffset","BASE64URL_NAME","selectedAlphabet","alphabet","codecArgument","codec","UuidSlugError","INVALID_OPTIONS","isLocalMaskingCodec","INVALID_UUID_VERSION","encode","result","BASE64URL","BASE32HEX","cause","layoutArgument","layout","UUID_VALUE_BYTES","maskingCodec","payloadLayout","value","read","UUID_VALUE_CONTEXT","context","source","readUuidV7PayloadLayout","existing","uuid","parsed","decodeKeylessUuid","localCodec","decode","foreignContext"],"sources":["../src/uuid-value.ts"],"mappings":"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"}
1
+ {"version":3,"file":"uuid-value.js","names":["encodeUuidBytes","BASE32HEX","BASE64URL","encode","isEncoded","BASE64URL_NAME","INVALID_OPTIONS","INVALID_UUID_VERSION","UuidSlugError","checkByteRange","isUint8Array","isUuidSlugError","isLocalMaskingCodec","decodeKeylessUuid","extractUuidV7Payload","resolveSlugAlphabet","UUID_TEXT_LOWERCASE","UUID_VARIANT_FUTURE","UUID_VARIANT_MICROSOFT","formatUuidBytesUnchecked","isUuidV7Bytes","resolveUuidTextCase","uuidTimestampFromBytesUnchecked","uuidVersion","LocalUuidValue","UUID_VALUE_BYTES","UUID_VALUE_CONTEXT","readUuidV7PayloadLayout","MASKING_CODEC_REQUIRED","bytes","field","version","variant","isNil","isMax","index","byte","textCase","selectedCase","output","outputOffset","alphabet","selectedAlphabet","codecArgument","codec","result","cause","layoutArgument","layout","maskingCodec","payloadLayout","value","read","context","source","uuid","existing","parsed","localCodec","decode","foreignContext"],"sources":["../src/uuid-value.ts"],"mappings":"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"}
package/dist/uuid.d.ts CHANGED
@@ -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
3
- import { UuidSlugError, UuidSlugErrorCode, isUuidSlugError } from "./errors.js";
4
- import { PreserveUuidVersion, UUID_TEXT_LOWERCASE, UuidByteInput, UuidBytes, UuidOutput, UuidString, UuidStringFor, UuidStringInput, UuidText, UuidTextCase, UuidTextCaseArguments, UuidV4Bytes, UuidV4String, UuidV4Text, UuidV7Bytes, UuidV7String, UuidV7Text } from "./types.js";
5
- //#region src/uuid.d.ts
2
+ // @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
3
+ import { UuidSlugError } from "./errors.js";
4
+ import { PreserveUuidVersion, UUID_TEXT_LOWERCASE, UnmaskedUuidInput, UuidByteInput, UuidBytes, UuidOutput, UuidString, UuidStringFor, UuidStringInput, UuidText, UuidTextCase, UuidTextCaseArguments, UuidV4Bytes, UuidV4String, UuidV4Text, UuidV7Bytes, UuidV7String, UuidV7Text } from "./types.js";
6
5
  /** The canonical all-zero UUID value, without a version or issuance claim. */
7
6
  export declare const NIL_UUID: UuidString;
8
7
  /** The canonical all-one UUID value, without a version or issuance claim. */
@@ -30,14 +29,15 @@ export declare function uuidStringToBytes<Input extends string | UuidSlugError,
30
29
  * `ArrayBuffer` uses its whole contents; a `DataView` uses its declared range. Only `Uint8Array`
31
30
  * input accepts an explicit offset. Invalid input returns `invalid_buffer`, and a preceding
32
31
  * `UuidSlugError` is returned unchanged.
32
+ * TypeScript rejects known masked bytes; decode them with their masking codec first.
33
33
  *
34
34
  * @param bytes - One supported UUID byte source.
35
35
  * @param textCase - Built-in output spelling. Omit for lowercase.
36
36
  * @defaultValue `UUID_TEXT_LOWERCASE`
37
37
  * @param byteOffset - Zero-based index where the UUID starts. Omit for a standalone UUID.
38
38
  */
39
- export declare function bytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(bytes: UuidByteInput | UuidSlugError, ...textCase: UuidTextCaseArguments<Case>): UuidStringFor<Case> | UuidSlugError;
40
- export declare function bytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(bytes: Uint8Array | UuidSlugError, byteOffset: number, ...textCase: UuidTextCaseArguments<Case>): UuidStringFor<Case> | UuidSlugError;
39
+ export declare function bytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(bytes: UnmaskedUuidInput<Readonly<UuidByteInput> | UuidSlugError>, ...textCase: UuidTextCaseArguments<Case>): UuidStringFor<Case> | UuidSlugError;
40
+ export declare function bytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(bytes: UnmaskedUuidInput<Readonly<Uint8Array> | UuidSlugError>, byteOffset: number, ...textCase: UuidTextCaseArguments<Case>): UuidStringFor<Case> | UuidSlugError;
41
41
  /** Check accepted UUID text without claiming a version, variant, or issuance. */
42
42
  export declare function isUuidText(value: unknown): value is UuidText;
43
43
  /** Check accepted UUID text with version 4 and RFC variant bits. */
@@ -60,6 +60,4 @@ export declare function isUuidV4Bytes(value: unknown): value is UuidV4Bytes;
60
60
  * v7-only operations require.
61
61
  */
62
62
  export declare function isUuidV7Bytes(value: unknown): value is UuidV7Bytes;
63
- //#endregion
64
- export { UuidSlugError };
65
63
  //# sourceMappingURL=uuid.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"uuid.d.ts","names":[],"sources":["../src/uuid.ts"],"mappings":";;;;;;qBAwDa,UAAqD;;qBAErD,UAAqD;;;;;;;;wBAmKlD,kBAAkB,uBAAuB,eACvD,MAAM,gBAAgB,SACrB,oBAAoB,OAAO,WAAW,aAAa,eAAe;;;;;;;;;;wBAUrD,kBAAkB,uBAAuB,eAAe,eAAe,YACrF,MAAM,gBAAgB,QACtB,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;;;;;;;wBAuFR,kBAAkB,aAAa,sBAAsB,qBACnE,OAAO,gBAAgB,kBACpB,UAAU,sBAAsB,QAClC,cAAc,QAAQ;wBACT,kBAAkB,aAAa,sBAAsB,qBACnE,OAAO,aAAa,eACpB,uBACG,UAAU,sBAAsB,QAClC,cAAc,QAAQ;;wBAiIT,WAAW,iBAAiB,SAAS;;wBAsCrC,aAAa,iBAAiB,SAAS;;wBAiBvC,aAAa,iBAAiB,SAAS;;wBAoBvC,aAAa,iBAAiB,SAAS;;wBAIvC,eAAe,iBAAiB,SAAS;;wBAIzC,eAAe,iBAAiB,SAAS;;wBAMzC,YAAY,iBAAiB,SAAS;;wBAMtC,cAAc,iBAAiB,SAAS;;;;;;wBAUxC,cAAc,iBAAiB,SAAS"}
1
+ {"version":3,"file":"uuid.d.ts","names":[],"sources":["../src/uuid.ts"],"mappings":";;;;;qBAoDa,UAAqD;;qBAErD,UAAqD;;;;;;;;wBA4JlD,kBAAkB,uBAAuB,eACvD,MAAM,gBAAgB,SACrB,oBAAoB,OAAO,WAAW,aAAa,eAAe;;;;;;;;;;wBAUrD,kBAAkB,uBAAuB,eAAe,eAAe,YACrF,MAAM,gBAAgB,QACtB,QAAQ,QACR,wBACC,WAAW,UAAU;;;;;;;;;;;;;wBAwFR,kBAAkB,aAAa,sBAAsB,qBACnE,OAAO,kBAAkB,SAAS,iBAAiB,mBAChD,UAAU,sBAAsB,QAClC,cAAc,QAAQ;wBACT,kBAAkB,aAAa,sBAAsB,qBACnE,OAAO,kBAAkB,SAAS,cAAc,gBAChD,uBACG,UAAU,sBAAsB,QAClC,cAAc,QAAQ;;wBAkIT,WAAW,iBAAiB,SAAS;;wBAmCrC,aAAa,iBAAiB,SAAS;;wBAgBvC,aAAa,iBAAiB,SAAS;;wBAmBvC,aAAa,iBAAiB,SAAS;;wBAIvC,eAAe,iBAAiB,SAAS;;wBAIzC,eAAe,iBAAiB,SAAS;;wBAMzC,YAAY,iBAAiB,SAAS;;wBAMtC,cAAc,iBAAiB,SAAS;;;;;;wBAUxC,cAAc,iBAAiB,SAAS"}