@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.
- package/AGENTS.md +14 -0
- package/README.md +54 -140
- package/dist/alphabet.d.ts +1 -3
- package/dist/alphabet.d.ts.map +1 -1
- package/dist/alphabet.js +33 -91
- package/dist/alphabet.js.map +1 -1
- package/dist/base64url-name.d.ts +1 -3
- package/dist/base64url-name.d.ts.map +1 -1
- package/dist/base64url-name.js +2 -3
- package/dist/errors.d.ts +1 -3
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +7 -24
- package/dist/errors.js.map +1 -1
- package/dist/feistel.js +3 -4
- package/dist/feistel.js.map +1 -1
- package/dist/generation-options.js +2 -3
- package/dist/generation-options.js.map +1 -1
- package/dist/index.d.ts +10 -10
- package/dist/index.js +21 -21
- package/dist/instant.js +4 -5
- package/dist/instant.js.map +1 -1
- package/dist/mask-handle.d.ts +1 -3
- package/dist/mask-handle.d.ts.map +1 -1
- package/dist/mask-handle.js +19 -17
- package/dist/mask-handle.js.map +1 -1
- package/dist/mask.d.ts +1 -3
- package/dist/mask.d.ts.map +1 -1
- package/dist/mask.js +23 -24
- package/dist/mask.js.map +1 -1
- package/dist/masked-bytes.js +74 -0
- package/dist/masked-bytes.js.map +1 -0
- package/dist/masking-codec-protocol.js +2 -3
- package/dist/masking-codec-protocol.js.map +1 -1
- package/dist/masking-codec-types.d.ts +60 -19
- package/dist/masking-codec-types.d.ts.map +1 -1
- package/dist/masking-codec.d.ts +1 -3
- package/dist/masking-codec.d.ts.map +1 -1
- package/dist/masking-codec.js +119 -115
- package/dist/masking-codec.js.map +1 -1
- package/dist/migration.js +39 -40
- package/dist/migration.js.map +1 -1
- package/dist/node/runtime.js +9 -10
- package/dist/node/runtime.js.map +1 -1
- package/dist/payload.d.ts +1 -3
- package/dist/payload.d.ts.map +1 -1
- package/dist/payload.js +65 -64
- package/dist/payload.js.map +1 -1
- package/dist/runtime/pool.js +2 -3
- package/dist/runtime/pool.js.map +1 -1
- package/dist/runtime/portable.js +2 -3
- package/dist/runtime/portable.js.map +1 -1
- package/dist/sentinel.js +2 -3
- package/dist/sentinel.js.map +1 -1
- package/dist/siphash.js +4 -5
- package/dist/siphash.js.map +1 -1
- package/dist/slug.d.ts +14 -13
- package/dist/slug.d.ts.map +1 -1
- package/dist/slug.js +145 -153
- package/dist/slug.js.map +1 -1
- package/dist/timestamp.d.ts +1 -3
- package/dist/timestamp.d.ts.map +1 -1
- package/dist/timestamp.js +2 -3
- package/dist/timestamp.js.map +1 -1
- package/dist/types.d.ts +38 -16
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -3
- package/dist/types.js.map +1 -1
- package/dist/uuid-value-protocol.js +2 -3
- package/dist/uuid-value-protocol.js.map +1 -1
- package/dist/uuid-value.d.ts +3 -5
- package/dist/uuid-value.d.ts.map +1 -1
- package/dist/uuid-value.js +74 -78
- package/dist/uuid-value.js.map +1 -1
- package/dist/uuid.d.ts +6 -8
- package/dist/uuid.d.ts.map +1 -1
- package/dist/uuid.js +38 -49
- package/dist/uuid.js.map +1 -1
- package/dist/v4-slug.d.ts +2 -4
- package/dist/v4-slug.d.ts.map +1 -1
- package/dist/v4-slug.js +6 -7
- package/dist/v4-slug.js.map +1 -1
- package/dist/v4.d.ts +8 -6
- package/dist/v4.d.ts.map +1 -1
- package/dist/v4.js +38 -44
- package/dist/v4.js.map +1 -1
- package/dist/v7-bounds.d.ts +3 -5
- package/dist/v7-bounds.d.ts.map +1 -1
- package/dist/v7-bounds.js +10 -11
- package/dist/v7-bounds.js.map +1 -1
- package/dist/v7-generator-input.js +10 -12
- package/dist/v7-generator-input.js.map +1 -1
- package/dist/v7-generator.d.ts +1 -3
- package/dist/v7-generator.d.ts.map +1 -1
- package/dist/v7-generator.js +45 -46
- package/dist/v7-generator.js.map +1 -1
- package/dist/v7-keyless.d.ts +12 -4
- package/dist/v7-keyless.d.ts.map +1 -1
- package/dist/v7-keyless.js +54 -55
- package/dist/v7-keyless.js.map +1 -1
- package/dist/v7-payload.js +3 -4
- package/dist/v7-payload.js.map +1 -1
- package/dist/v7-slug.d.ts +8 -5
- package/dist/v7-slug.d.ts.map +1 -1
- package/dist/v7-slug.js +69 -70
- package/dist/v7-slug.js.map +1 -1
- package/dist/v7-timestamp.js +2 -3
- package/dist/v7-timestamp.js.map +1 -1
- package/dist/v7-value-options.js +2 -3
- package/dist/v7-value-options.js.map +1 -1
- package/dist/v7-value.d.ts +5 -8
- package/dist/v7-value.d.ts.map +1 -1
- package/dist/v7-value.js +10 -11
- package/dist/v7-value.js.map +1 -1
- package/dist/v7.js +16 -17
- package/dist/v7.js.map +1 -1
- package/package.json +9 -2
- package/src/alphabet.ts +82 -237
- package/src/errors.ts +27 -40
- package/src/feistel.ts +3 -3
- package/src/index.ts +3 -0
- package/src/mask-handle.ts +7 -11
- package/src/mask.ts +16 -14
- package/src/masked-bytes.ts +203 -0
- package/src/masking-codec-types.ts +124 -24
- package/src/masking-codec.ts +43 -42
- package/src/migration.ts +8 -7
- package/src/payload.ts +69 -51
- package/src/runtime/portable.ts +2 -2
- package/src/runtime/types.ts +2 -4
- package/src/slug.ts +39 -48
- package/src/types.ts +107 -17
- package/src/uuid-value.ts +2 -9
- package/src/uuid.ts +19 -33
- package/src/v4.ts +12 -9
- package/src/v7-bounds.ts +4 -2
- package/src/v7-generator-input.ts +2 -5
- package/src/v7-generator.ts +2 -2
- package/src/v7-keyless.ts +29 -0
- package/src/v7-slug.ts +20 -1
- package/src/v7-value.ts +9 -4
- package/src/v7.ts +26 -0
package/dist/timestamp.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"timestamp.js","names":["
|
|
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.
|
|
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
|
-
|
|
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
|
|
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
|
|
238
|
-
export type KeylessUuidInput<Input> =
|
|
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
|
|
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
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":"
|
|
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.
|
|
3
|
-
|
|
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,
|
|
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.
|
|
2
|
+
// @anizoptera/uuid-slug 0.7.0 | https://github.com/Anizoptera/uuid-slug#readme
|
|
3
3
|
import { isUint8Array as e } from "./errors.js";
|
|
4
|
-
|
|
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","
|
|
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"}
|
package/dist/uuid-value.d.ts
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
-
// @anizoptera/uuid-slug 0.
|
|
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
|
|
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
|
package/dist/uuid-value.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"uuid-value.d.ts","names":[],"sources":["../src/uuid-value.ts"],"mappings":"
|
|
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"}
|
package/dist/uuid-value.js
CHANGED
|
@@ -1,127 +1,123 @@
|
|
|
1
1
|
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
-
// @anizoptera/uuid-slug 0.
|
|
3
|
-
import {
|
|
4
|
-
import { BASE64URL_NAME as
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
-
import { LocalUuidValue as
|
|
11
|
-
import {
|
|
12
|
-
|
|
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 ?
|
|
16
|
+
return t & 128 ? (t & 192) == 128 ? "rfc" : (t & 224) == 192 ? _ : g : "ncs";
|
|
17
17
|
}
|
|
18
|
-
var ParsedUuidValue = class extends
|
|
18
|
+
var ParsedUuidValue = class extends C {
|
|
19
19
|
get version() {
|
|
20
|
-
return /* @__PURE__ */
|
|
20
|
+
return /* @__PURE__ */ S(C.ownBytes(this), 0);
|
|
21
21
|
}
|
|
22
22
|
inspect() {
|
|
23
|
-
let e =
|
|
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__ */
|
|
29
|
+
uuid: /* @__PURE__ */ v(e),
|
|
30
30
|
version: t,
|
|
31
31
|
variant: n,
|
|
32
|
-
unixMs: t === 7 && n === "rfc" ? /* @__PURE__ */
|
|
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 =
|
|
38
|
-
let t =
|
|
39
|
-
return t instanceof Error ? t : /* @__PURE__ */
|
|
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 =
|
|
43
|
-
return e ? /* @__PURE__ */
|
|
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 =
|
|
46
|
-
let t = /* @__PURE__ */
|
|
47
|
-
return t instanceof Error ? t : /* @__PURE__ */
|
|
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(...
|
|
50
|
-
let i =
|
|
51
|
-
if (!
|
|
52
|
-
if (
|
|
53
|
-
if (!/* @__PURE__ */
|
|
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
|
|
56
|
-
if (typeof
|
|
57
|
-
let
|
|
58
|
-
return /* @__PURE__ */
|
|
59
|
-
} catch (
|
|
60
|
-
return new
|
|
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(...
|
|
64
|
-
let
|
|
65
|
-
return
|
|
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__ */
|
|
68
|
+
return /* @__PURE__ */ v(C.ownBytes(this));
|
|
69
69
|
}
|
|
70
|
-
[
|
|
70
|
+
[w]() {
|
|
71
71
|
return this.toBytes();
|
|
72
72
|
}
|
|
73
73
|
};
|
|
74
|
-
Object.freeze(ParsedUuidValue.prototype), Object.freeze(
|
|
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(
|
|
79
|
-
if (typeof
|
|
80
|
-
let
|
|
81
|
-
if (typeof
|
|
82
|
-
let
|
|
83
|
-
if (typeof
|
|
84
|
-
let
|
|
85
|
-
if (
|
|
86
|
-
let
|
|
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:
|
|
88
|
+
maskingCodec: i,
|
|
89
89
|
payloadLayout: c
|
|
90
90
|
};
|
|
91
|
-
} catch (
|
|
92
|
-
return new
|
|
91
|
+
} catch (e) {
|
|
92
|
+
return new s(a, "Reading UUID construction context failed.", { cause: e });
|
|
93
93
|
}
|
|
94
94
|
}
|
|
95
|
-
function parseUuid(
|
|
96
|
-
let
|
|
97
|
-
if (
|
|
98
|
-
let
|
|
99
|
-
if (!
|
|
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
|
|
102
|
-
if (!
|
|
103
|
-
let
|
|
101
|
+
let n = d(t);
|
|
102
|
+
if (!n && /* @__PURE__ */ u(e)) return e;
|
|
103
|
+
let i;
|
|
104
104
|
try {
|
|
105
|
-
|
|
106
|
-
} catch (
|
|
107
|
-
return new
|
|
105
|
+
i = t.uuidToBytes;
|
|
106
|
+
} catch (e) {
|
|
107
|
+
return new s(a, "Reading masking codec failed.", { cause: e });
|
|
108
108
|
}
|
|
109
|
-
if (typeof
|
|
109
|
+
if (typeof i != "function") return new s(a, "maskingCodec must be a UUIDv7 masking codec.");
|
|
110
110
|
try {
|
|
111
|
-
if (
|
|
112
|
-
else if (!/* @__PURE__ */
|
|
113
|
-
} catch (
|
|
114
|
-
return new
|
|
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__ */
|
|
118
|
-
let
|
|
119
|
-
return
|
|
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
|
-
|
|
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
|
package/dist/uuid-value.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"uuid-value.js","names":["
|
|
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.
|
|
3
|
-
import { UuidSlugError
|
|
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
|
|
40
|
-
export declare function bytesToUuidString<Case extends UuidTextCase = typeof UUID_TEXT_LOWERCASE>(bytes: Uint8Array | 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
|
package/dist/uuid.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"uuid.d.ts","names":[],"sources":["../src/uuid.ts"],"mappings":"
|
|
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"}
|