@fgv/ts-utils 5.1.0-21 → 5.1.0-23

package/dist/packlets/base/index.js

@@ -25,4 +25,5 @@ export * from './messageAggregator';
 export { Normalizer } from './normalize';
 export * from './result';
 export * from './utils';
+export * from './uuid';
 //# sourceMappingURL=index.js.map

package/dist/packlets/base/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './brand';\nexport * from './mapResults';\nexport * from './messageAggregator';\nexport { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './brand';\nexport * from './mapResults';\nexport * from './messageAggregator';\nexport { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\nexport * from './uuid';\n"]}

package/dist/packlets/base/uuid.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version
+ * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the
+ * start of the fourth group. Matches what `crypto.randomUUID()` returns.
+ */
+const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+export function isValidUuid(value) {
+    return uuidRegex.test(value);
+}
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+export function generateUuid() {
+    const cryptoObj = globalThis.crypto;
+    /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */
+    if (typeof (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.randomUUID) !== 'function') {
+        throw new Error('generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser');
+    }
+    return cryptoObj.randomUUID();
+}
+//# sourceMappingURL=uuid.js.map

package/dist/packlets/base/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH;;;;GAIG;AACH,MAAM,SAAS,GAAW,uEAAuE,CAAC;AAElG;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,iHAAiH;IACjH,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,EAAU,CAAC;AACxC,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Brand } from './brand';\n\n/**\n * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version\n * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}\n * and validated by {@link isValidUuid}.\n * @public\n */\nexport type Uuid = Brand<string, 'Uuid'>;\n\n/**\n * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version\n * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the\n * start of the fourth group. Matches what `crypto.randomUUID()` returns.\n */\nconst uuidRegex: RegExp = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/**\n * Type guard that returns `true` when the input is a canonical UUIDv4 string.\n * @param value - The string to test.\n * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.\n * @public\n */\nexport function isValidUuid(value: string): value is Uuid {\n  return uuidRegex.test(value);\n}\n\n/**\n * Generates a cryptographically random UUIDv4 using the platform's Web Crypto\n * API (`globalThis.crypto.randomUUID`). Works in Node.js \\>= 18 and modern\n * browsers without per-call runtime checks.\n * @returns A new {@link Uuid}.\n * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.\n * This indicates an unsupported platform, not a per-call failure mode, so it is\n * surfaced as a thrown error rather than a `Result`.\n * @public\n */\nexport function generateUuid(): Uuid {\n  const cryptoObj = globalThis.crypto;\n  /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */\n  if (typeof cryptoObj?.randomUUID !== 'function') {\n    throw new Error(\n      'generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser'\n    );\n  }\n  return cryptoObj.randomUUID() as Uuid;\n}\n"]}

package/dist/ts-utils.d.ts

@@ -2603,6 +2603,18 @@ declare class Collectible<TKEY extends string = string, TINDEX extends number =
               type: 'function';
           }
 
+          /**
+           * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+           * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+           * browsers without per-call runtime checks.
+           * @returns A new {@link Uuid}.
+           * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+           * This indicates an unsupported platform, not a per-call failure mode, so it is
+           * surfaced as a thrown error rather than a `Result`.
+           * @public
+           */
+          export declare function generateUuid(): Uuid;
+
           /**
            * Helper function to create a {@link Converter | Converter} from a supplied {@link Conversion.ConverterFunc | ConverterFunc}.
            * @param convert - the function to be wrapped
@@ -3906,6 +3918,14 @@ declare class Collectible<TKEY extends string = string, TINDEX extends number =
            */
           declare function isValidator<T, TC>(converterOrValidator: Converter<T, TC> | Validator<T, TC>): converterOrValidator is Validator<T, TC>;
 
+          /**
+           * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+           * @param value - The string to test.
+           * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+           * @public
+           */
+          export declare function isValidUuid(value: string): value is Uuid;
+
           /**
            * Parameters for constructing a {@link Collections.ValidatingCollector | ValidatingCollector}.
            * @public
@@ -6131,6 +6151,14 @@ declare class Collectible<TKEY extends string = string, TINDEX extends number =
                                  }
                              }
 
+                             /**
+                              * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version
+                              * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}
+                              * and validated by {@link isValidUuid}.
+                              * @public
+                              */
+                             export declare type Uuid = Brand<string, 'Uuid'>;
+
                              /**
                               * Helper function to create a {@link Converter | Converter} from any {@link Validation.Validator}
                               * @param converterOrValidator - the {@link Validation.Validator} to be wrapped or {@link Converter | Converter}

package/lib/packlets/base/index.d.ts

@@ -4,4 +4,5 @@ export * from './messageAggregator';
 export { Normalizer } from './normalize';
 export * from './result';
 export * from './utils';
+export * from './uuid';
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/base/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":"AAsBA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":"AAsBA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/lib/packlets/base/index.js

@@ -43,4 +43,5 @@ var normalize_1 = require("./normalize");
 Object.defineProperty(exports, "Normalizer", { enumerable: true, get: function () { return normalize_1.Normalizer; } });
 __exportStar(require("./result"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./uuid"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/base/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,+CAA6B;AAC7B,sDAAoC;AACpC,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,2CAAyB;AACzB,0CAAwB","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './brand';\nexport * from './mapResults';\nexport * from './messageAggregator';\nexport { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/base/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,+CAA6B;AAC7B,sDAAoC;AACpC,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,2CAAyB;AACzB,0CAAwB;AACxB,yCAAuB","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './brand';\nexport * from './mapResults';\nexport * from './messageAggregator';\nexport { Normalizer } from './normalize';\nexport * from './result';\nexport * from './utils';\nexport * from './uuid';\n"]}

package/lib/packlets/base/uuid.d.ts

@@ -0,0 +1,27 @@
+import { Brand } from './brand';
+/**
+ * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version
+ * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}
+ * and validated by {@link isValidUuid}.
+ * @public
+ */
+export type Uuid = Brand<string, 'Uuid'>;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+export declare function isValidUuid(value: string): value is Uuid;
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+export declare function generateUuid(): Uuid;
+//# sourceMappingURL=uuid.d.ts.map

package/lib/packlets/base/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AASzC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,IAAI,CASnC"}

package/lib/packlets/base/uuid.js

@@ -0,0 +1,59 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidUuid = isValidUuid;
+exports.generateUuid = generateUuid;
+/**
+ * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version
+ * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the
+ * start of the fourth group. Matches what `crypto.randomUUID()` returns.
+ */
+const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+function isValidUuid(value) {
+    return uuidRegex.test(value);
+}
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+function generateUuid() {
+    const cryptoObj = globalThis.crypto;
+    /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */
+    if (typeof (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.randomUUID) !== 'function') {
+        throw new Error('generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser');
+    }
+    return cryptoObj.randomUUID();
+}
+//# sourceMappingURL=uuid.js.map

package/lib/packlets/base/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAyBH,kCAEC;AAYD,oCASC;AApCD;;;;GAIG;AACH,MAAM,SAAS,GAAW,uEAAuE,CAAC;AAElG;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY;IAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,iHAAiH;IACjH,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,EAAU,CAAC;AACxC,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Brand } from './brand';\n\n/**\n * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version\n * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}\n * and validated by {@link isValidUuid}.\n * @public\n */\nexport type Uuid = Brand<string, 'Uuid'>;\n\n/**\n * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version\n * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the\n * start of the fourth group. Matches what `crypto.randomUUID()` returns.\n */\nconst uuidRegex: RegExp = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/**\n * Type guard that returns `true` when the input is a canonical UUIDv4 string.\n * @param value - The string to test.\n * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.\n * @public\n */\nexport function isValidUuid(value: string): value is Uuid {\n  return uuidRegex.test(value);\n}\n\n/**\n * Generates a cryptographically random UUIDv4 using the platform's Web Crypto\n * API (`globalThis.crypto.randomUUID`). Works in Node.js \\>= 18 and modern\n * browsers without per-call runtime checks.\n * @returns A new {@link Uuid}.\n * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.\n * This indicates an unsupported platform, not a per-call failure mode, so it is\n * surfaced as a thrown error rather than a `Result`.\n * @public\n */\nexport function generateUuid(): Uuid {\n  const cryptoObj = globalThis.crypto;\n  /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */\n  if (typeof cryptoObj?.randomUUID !== 'function') {\n    throw new Error(\n      'generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser'\n    );\n  }\n  return cryptoObj.randomUUID() as Uuid;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-utils",
-  "version": "5.1.0-21",
+  "version": "5.1.0-23",
   "description": "Assorted Typescript Utilities",
   "main": "lib/index.js",
   "module": "dist/index.js",
@@ -54,8 +54,8 @@
     "@rushstack/heft-jest-plugin": "1.2.6",
     "eslint-plugin-tsdoc": "~0.5.2",
     "typedoc": "~0.28.16",
-    "@fgv/heft-dual-rig": "5.1.0-21",
-    "@fgv/typedoc-compact-theme": "5.1.0-21"
+    "@fgv/heft-dual-rig": "5.1.0-23",
+    "@fgv/typedoc-compact-theme": "5.1.0-23"
   },
   "repository": {
     "type": "git",