uuid 11.0.4 → 11.1.0

package/README.md

@@ -2,24 +2,24 @@
   -- This file is auto-generated from README_js.md. Changes should be made there.
   -->
 
-# uuid [![CI](https://github.com/uuidjs/uuid/workflows/CI/badge.svg)](https://github.com/uuidjs/uuid/actions?query=workflow%3ACI) [![Browser](https://github.com/uuidjs/uuid/workflows/Browser/badge.svg)](https://github.com/uuidjs/uuid/actions?query=workflow%3ABrowser)
+# uuid [![CI](https://github.com/uuidjs/uuid/workflows/CI/badge.svg)](https://github.com/uuidjs/uuid/actions?query=workflow%3ACI) [![Browser](https://github.com/uuidjs/uuid/workflows/Browser/badge.svg)](https://github.com/uuidjs/uuid/actions/workflows/browser.yml)
 
-For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (formally [RFC4122](https://www.rfc-editor.org/rfc/rfc4122.html)) UUIDs
+For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (formerly [RFC4122](https://www.rfc-editor.org/rfc/rfc4122.html)) UUIDs
 
 - **Complete** - Support for all RFC9562 UUID versions
 - **Cross-platform** - Support for...
   - ESM & Common JS
-  - [Chrome, Safari, Firefox, Edge browsers](#support)
+  - [Typescript](#support)
+  - [Chrome, Safari, Firefox, and Edge](#support)
   - [NodeJS](#support)
   - [React Native / Expo](#react-native--expo)
-- **Secure** - Cryptographically-strong random values
-- **Compact** - No dependencies, [tree-shakable](https://developer.mozilla.org/en-US/docs/Glossary/Tree_shaking)
-- **CLI** - Includes the [`uuid` command line](#command-line) utility
-- **Typescript** - Types now included
+- **Secure** - Uses modern `crypto` API for random values
+- **Compact** - Zero-dependency, [tree-shakable](https://developer.mozilla.org/en-US/docs/Glossary/Tree_shaking)
+- **CLI** - [`uuid` command line](#command-line) utility
 
 <!-- prettier-ignore -->
 > [!NOTE]
-w> `uuid@11` is now available:  See the [CHANGELOG](./CHANGELOG.md) for details. TL;DR:
+> `uuid@11` is now available:  See the [CHANGELOG](./CHANGELOG.md) for details. TL;DR:
 > * TypeScript support is now included  (remove `@types/uuid` from your dependencies)
 > * Subtle changes to how the `options` arg is interpreted for `v1()`, `v6()`, and `v7()`. [See details](#options-handling-for-timestamp-uuids)
 > * Binary UUIDs are now `Uint8Array`s.  (May impact callers of `parse()`, `stringify()`,  or that pass an `option#buf` argument to `v1()`-`v7()`.)
@@ -180,7 +180,7 @@ Create an RFC version 1 (timestamp) UUID
 | [`options.nsecs = 0`] | RFC "timestamp" field (`Number` of nanoseconds to add to `msecs`, should be 0-10,000) |
 | [`options.random = (random)`] | `Array` of 16 random bytes (0-255) used to generate other fields, above |
 | [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
-| [`buffer`] | `Array \| Buffer` If specified, uuid will be written here in byte-form, starting at `offset` |
+| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
 | [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
 | _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
 | _throws_ | `Error` if more than 10M UUIDs/sec are requested |
@@ -244,7 +244,7 @@ Create an RFC version 4 (random) UUID
 | [`options`] | `Object` with one or more of the following properties: |
 | [`options.random`] | `Array` of 16 random bytes (0-255) |
 | [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
-| [`buffer`] | `Array \| Buffer` If specified, uuid will be written here in byte-form, starting at `offset` |
+| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
 | [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
 | _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
 
@@ -292,7 +292,7 @@ Create an RFC version 5 (namespace w/ SHA-1) UUID
 | --- | --- |
 | `name` | `String \| Array` |
 | `namespace` | `String \| Array[16]` Namespace UUID |
-| [`buffer`] | `Array \| Buffer` If specified, uuid will be written here in byte-form, starting at `offset` |
+| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
 | [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
 | _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
 
@@ -367,7 +367,7 @@ Create an RFC version 7 (random) UUID
 | [`options.random = (random)`] | `Array` of 16 random bytes (0-255) used to generate other fields, above |
 | [`options.rng`] | Alternative to `options.random`, a `Function` that returns an `Array` of 16 random bytes (0-255) |
 | [`options.seq = (random)`] | 32-bit sequence `Number` between 0 - 0xffffffff. This may be provided to help ensure uniqueness for UUIDs generated within the same millisecond time interval. Default = random value. |
-| [`buffer`] | `Array \| Buffer` If specified, uuid will be written here in byte-form, starting at `offset` |
+| [`buffer`] | `Uint8Array` or `Uint8Array` subtype (e.g. Node.js `Buffer`). If provided, binary UUID is written into the array, starting at `offset` |
 | [`offset` = 0] | `Number` Index to start writing UUID bytes in `buffer` |
 | _returns_ | UUID `String` if no `buffer` is specified, otherwise returns `buffer` |
 

package/dist/cjs/md5.d.ts

@@ -1,2 +1,4 @@
-declare function md5(bytes: Uint8Array): Buffer<ArrayBufferLike>;
+/// <reference types="node" />
+/// <reference types="node" />
+declare function md5(bytes: Uint8Array): Buffer;
 export default md5;

package/dist/cjs/native.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import { randomUUID } from 'crypto';
 declare const _default: {
     randomUUID: typeof randomUUID;

package/dist/cjs/parse.d.ts

@@ -1,2 +1,2 @@
-declare function parse(uuid: string): Uint8Array<ArrayBuffer>;
+declare function parse(uuid: string): Uint8Array;
 export default parse;

package/dist/cjs/rng.d.ts

@@ -1 +1 @@
-export default function rng(): Uint8Array<ArrayBuffer>;
+export default function rng(): Uint8Array;

package/dist/cjs/rng.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = rng;
 const crypto_1 = require("crypto");
 const rnds8Pool = new Uint8Array(256);
 let poolPtr = rnds8Pool.length;
@@ -11,3 +10,4 @@ function rng() {
     }
     return rnds8Pool.slice(poolPtr, (poolPtr += 16));
 }
+exports.default = rng;

package/dist/cjs/sha1.d.ts

@@ -1,2 +1,4 @@
-declare function sha1(bytes: Uint8Array): Buffer<ArrayBufferLike>;
+/// <reference types="node" />
+/// <reference types="node" />
+declare function sha1(bytes: Uint8Array): Buffer;
 export default sha1;

package/dist/cjs/stringify.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unsafeStringify = unsafeStringify;
+exports.unsafeStringify = void 0;
 const validate_js_1 = require("./validate.js");
 const byteToHex = [];
 for (let i = 0; i < 256; ++i) {
@@ -28,6 +28,7 @@ function unsafeStringify(arr, offset = 0) {
         byteToHex[arr[offset + 14]] +
         byteToHex[arr[offset + 15]]).toLowerCase();
 }
+exports.unsafeStringify = unsafeStringify;
 function stringify(arr, offset = 0) {
     const uuid = unsafeStringify(arr, offset);
     if (!(0, validate_js_1.default)(uuid)) {

package/dist/cjs/types.d.ts

@@ -1,4 +1,4 @@
-export type UUIDTypes = string | Uint8Array;
+export type UUIDTypes<TBuf extends Uint8Array = Uint8Array> = string | TBuf;
 export type Version1Options = {
     node?: Uint8Array;
     clockseq?: number;

package/dist/cjs/v1.d.ts

@@ -6,6 +6,6 @@ type V1State = {
     nsecs?: number;
 };
 declare function v1(options?: Version1Options, buf?: undefined, offset?: number): string;
-declare function v1(options: Version1Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v1<Buf extends Uint8Array = Uint8Array>(options: Version1Options | undefined, buf: Buf, offset?: number): Buf;
 export declare function updateV1State(state: V1State, now: number, rnds: Uint8Array): V1State;
 export default v1;

package/dist/cjs/v1.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV1State = updateV1State;
+exports.updateV1State = void 0;
 const rng_js_1 = require("./rng.js");
 const stringify_js_1 = require("./stringify.js");
 const _state = {};
@@ -22,7 +22,7 @@ function v1(options, buf, offset) {
         updateV1State(_state, now, rnds);
         bytes = v1Bytes(rnds, _state.msecs, _state.nsecs, isV6 ? undefined : _state.clockseq, isV6 ? undefined : _state.node, buf, offset);
     }
-    return buf ? bytes : (0, stringify_js_1.unsafeStringify)(bytes);
+    return buf ?? (0, stringify_js_1.unsafeStringify)(bytes);
 }
 function updateV1State(state, now, rnds) {
     state.msecs ??= -Infinity;
@@ -48,6 +48,7 @@ function updateV1State(state, now, rnds) {
     state.msecs = now;
     return state;
 }
+exports.updateV1State = updateV1State;
 function v1Bytes(rnds, msecs, nsecs, clockseq, node, buf, offset = 0) {
     if (rnds.length < 16) {
         throw new Error('Random bytes length must be >= 16');

package/dist/cjs/v1ToV6.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = v1ToV6;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function v1ToV6(uuid) {
@@ -8,6 +7,7 @@ function v1ToV6(uuid) {
     const v6Bytes = _v1ToV6(v1Bytes);
     return typeof uuid === 'string' ? (0, stringify_js_1.unsafeStringify)(v6Bytes) : v6Bytes;
 }
+exports.default = v1ToV6;
 function _v1ToV6(v1Bytes) {
     return Uint8Array.of(((v1Bytes[6] & 0x0f) << 4) | ((v1Bytes[7] >> 4) & 0x0f), ((v1Bytes[7] & 0x0f) << 4) | ((v1Bytes[4] & 0xf0) >> 4), ((v1Bytes[4] & 0x0f) << 4) | ((v1Bytes[5] & 0xf0) >> 4), ((v1Bytes[5] & 0x0f) << 4) | ((v1Bytes[0] & 0xf0) >> 4), ((v1Bytes[0] & 0x0f) << 4) | ((v1Bytes[1] & 0xf0) >> 4), ((v1Bytes[1] & 0x0f) << 4) | ((v1Bytes[2] & 0xf0) >> 4), 0x60 | (v1Bytes[2] & 0x0f), v1Bytes[3], v1Bytes[8], v1Bytes[9], v1Bytes[10], v1Bytes[11], v1Bytes[12], v1Bytes[13], v1Bytes[14], v1Bytes[15]);
 }

package/dist/cjs/v3.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v3<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v3 {
     var DNS: string;
     var URL: string;

package/dist/cjs/v35.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
-export declare function stringToBytes(str: string): Uint8Array<ArrayBuffer>;
+export declare function stringToBytes(str: string): Uint8Array;
 export declare const DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
 export declare const URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
 type HashFunction = (bytes: Uint8Array) => Uint8Array;
-export default function v35(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: Uint8Array, offset?: number): string | Uint8Array<ArrayBufferLike>;
+export default function v35<TBuf extends Uint8Array = Uint8Array>(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: TBuf, offset?: number): UUIDTypes<TBuf>;
 export {};

package/dist/cjs/v35.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URL = exports.DNS = void 0;
-exports.stringToBytes = stringToBytes;
-exports.default = v35;
+exports.URL = exports.DNS = exports.stringToBytes = void 0;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function stringToBytes(str) {
@@ -13,6 +11,7 @@ function stringToBytes(str) {
     }
     return bytes;
 }
+exports.stringToBytes = stringToBytes;
 exports.DNS = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
 exports.URL = '6ba7b811-9dad-11d1-80b4-00c04fd430c8';
 function v35(version, hash, value, namespace, buf, offset) {
@@ -39,3 +38,4 @@ function v35(version, hash, value, namespace, buf, offset) {
     }
     return (0, stringify_js_1.unsafeStringify)(bytes);
 }
+exports.default = v35;

package/dist/cjs/v4.d.ts

@@ -1,4 +1,4 @@
 import { Version4Options } from './types.js';
 declare function v4(options?: Version4Options, buf?: undefined, offset?: number): string;
-declare function v4(options: Version4Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v4<TBuf extends Uint8Array = Uint8Array>(options: Version4Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v4;

package/dist/cjs/v5.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v5<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v5 {
     var DNS: string;
     var URL: string;

package/dist/cjs/v6.d.ts

@@ -1,4 +1,4 @@
 import { Version6Options } from './types.js';
 declare function v6(options?: Version6Options, buf?: undefined, offset?: number): string;
-declare function v6(options: Version6Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v6<TBuf extends Uint8Array = Uint8Array>(options: Version6Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v6;

package/dist/cjs/v6ToV1.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = v6ToV1;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function v6ToV1(uuid) {
@@ -8,6 +7,7 @@ function v6ToV1(uuid) {
     const v1Bytes = _v6ToV1(v6Bytes);
     return typeof uuid === 'string' ? (0, stringify_js_1.unsafeStringify)(v1Bytes) : v1Bytes;
 }
+exports.default = v6ToV1;
 function _v6ToV1(v6Bytes) {
     return Uint8Array.of(((v6Bytes[3] & 0x0f) << 4) | ((v6Bytes[4] >> 4) & 0x0f), ((v6Bytes[4] & 0x0f) << 4) | ((v6Bytes[5] & 0xf0) >> 4), ((v6Bytes[5] & 0x0f) << 4) | (v6Bytes[6] & 0x0f), v6Bytes[7], ((v6Bytes[1] & 0x0f) << 4) | ((v6Bytes[2] & 0xf0) >> 4), ((v6Bytes[2] & 0x0f) << 4) | ((v6Bytes[3] & 0xf0) >> 4), 0x10 | ((v6Bytes[0] & 0xf0) >> 4), ((v6Bytes[0] & 0x0f) << 4) | ((v6Bytes[1] & 0xf0) >> 4), v6Bytes[8], v6Bytes[9], v6Bytes[10], v6Bytes[11], v6Bytes[12], v6Bytes[13], v6Bytes[14], v6Bytes[15]);
 }

package/dist/cjs/v7.d.ts

@@ -4,6 +4,6 @@ type V7State = {
     seq?: number;
 };
 declare function v7(options?: Version7Options, buf?: undefined, offset?: number): string;
-declare function v7(options: Version7Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v7<TBuf extends Uint8Array = Uint8Array>(options: Version7Options | undefined, buf: TBuf, offset?: number): TBuf;
 export declare function updateV7State(state: V7State, now: number, rnds: Uint8Array): V7State;
 export default v7;

package/dist/cjs/v7.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV7State = updateV7State;
+exports.updateV7State = void 0;
 const rng_js_1 = require("./rng.js");
 const stringify_js_1 = require("./stringify.js");
 const _state = {};
@@ -15,7 +15,7 @@ function v7(options, buf, offset) {
         updateV7State(_state, now, rnds);
         bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);
     }
-    return buf ? bytes : (0, stringify_js_1.unsafeStringify)(bytes);
+    return buf ?? (0, stringify_js_1.unsafeStringify)(bytes);
 }
 function updateV7State(state, now, rnds) {
     state.msecs ??= -Infinity;
@@ -32,6 +32,7 @@ function updateV7State(state, now, rnds) {
     }
     return state;
 }
+exports.updateV7State = updateV7State;
 function v7Bytes(rnds, msecs, seq, buf, offset = 0) {
     if (rnds.length < 16) {
         throw new Error('Random bytes length must be >= 16');

package/dist/cjs-browser/md5.d.ts

@@ -1,2 +1,2 @@
-declare function md5(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
+declare function md5(bytes: Uint8Array): Uint8Array;
 export default md5;

package/dist/cjs-browser/parse.d.ts

@@ -1,2 +1,2 @@
-declare function parse(uuid: string): Uint8Array<ArrayBuffer>;
+declare function parse(uuid: string): Uint8Array;
 export default parse;

package/dist/cjs-browser/rng.d.ts

@@ -1 +1 @@
-export default function rng(): Uint8Array<ArrayBuffer>;
+export default function rng(): Uint8Array;

package/dist/cjs-browser/rng.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = rng;
 let getRandomValues;
 const rnds8 = new Uint8Array(16);
 function rng() {
@@ -12,3 +11,4 @@ function rng() {
     }
     return getRandomValues(rnds8);
 }
+exports.default = rng;

package/dist/cjs-browser/stringify.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unsafeStringify = unsafeStringify;
+exports.unsafeStringify = void 0;
 const validate_js_1 = require("./validate.js");
 const byteToHex = [];
 for (let i = 0; i < 256; ++i) {
@@ -28,6 +28,7 @@ function unsafeStringify(arr, offset = 0) {
         byteToHex[arr[offset + 14]] +
         byteToHex[arr[offset + 15]]).toLowerCase();
 }
+exports.unsafeStringify = unsafeStringify;
 function stringify(arr, offset = 0) {
     const uuid = unsafeStringify(arr, offset);
     if (!(0, validate_js_1.default)(uuid)) {

package/dist/cjs-browser/types.d.ts

@@ -1,4 +1,4 @@
-export type UUIDTypes = string | Uint8Array;
+export type UUIDTypes<TBuf extends Uint8Array = Uint8Array> = string | TBuf;
 export type Version1Options = {
     node?: Uint8Array;
     clockseq?: number;

package/dist/cjs-browser/v1.d.ts

@@ -6,6 +6,6 @@ type V1State = {
     nsecs?: number;
 };
 declare function v1(options?: Version1Options, buf?: undefined, offset?: number): string;
-declare function v1(options: Version1Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v1<Buf extends Uint8Array = Uint8Array>(options: Version1Options | undefined, buf: Buf, offset?: number): Buf;
 export declare function updateV1State(state: V1State, now: number, rnds: Uint8Array): V1State;
 export default v1;

package/dist/cjs-browser/v1.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV1State = updateV1State;
+exports.updateV1State = void 0;
 const rng_js_1 = require("./rng.js");
 const stringify_js_1 = require("./stringify.js");
 const _state = {};
@@ -22,7 +22,7 @@ function v1(options, buf, offset) {
         updateV1State(_state, now, rnds);
         bytes = v1Bytes(rnds, _state.msecs, _state.nsecs, isV6 ? undefined : _state.clockseq, isV6 ? undefined : _state.node, buf, offset);
     }
-    return buf ? bytes : (0, stringify_js_1.unsafeStringify)(bytes);
+    return buf ?? (0, stringify_js_1.unsafeStringify)(bytes);
 }
 function updateV1State(state, now, rnds) {
     state.msecs ??= -Infinity;
@@ -48,6 +48,7 @@ function updateV1State(state, now, rnds) {
     state.msecs = now;
     return state;
 }
+exports.updateV1State = updateV1State;
 function v1Bytes(rnds, msecs, nsecs, clockseq, node, buf, offset = 0) {
     if (rnds.length < 16) {
         throw new Error('Random bytes length must be >= 16');

package/dist/cjs-browser/v1ToV6.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = v1ToV6;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function v1ToV6(uuid) {
@@ -8,6 +7,7 @@ function v1ToV6(uuid) {
     const v6Bytes = _v1ToV6(v1Bytes);
     return typeof uuid === 'string' ? (0, stringify_js_1.unsafeStringify)(v6Bytes) : v6Bytes;
 }
+exports.default = v1ToV6;
 function _v1ToV6(v1Bytes) {
     return Uint8Array.of(((v1Bytes[6] & 0x0f) << 4) | ((v1Bytes[7] >> 4) & 0x0f), ((v1Bytes[7] & 0x0f) << 4) | ((v1Bytes[4] & 0xf0) >> 4), ((v1Bytes[4] & 0x0f) << 4) | ((v1Bytes[5] & 0xf0) >> 4), ((v1Bytes[5] & 0x0f) << 4) | ((v1Bytes[0] & 0xf0) >> 4), ((v1Bytes[0] & 0x0f) << 4) | ((v1Bytes[1] & 0xf0) >> 4), ((v1Bytes[1] & 0x0f) << 4) | ((v1Bytes[2] & 0xf0) >> 4), 0x60 | (v1Bytes[2] & 0x0f), v1Bytes[3], v1Bytes[8], v1Bytes[9], v1Bytes[10], v1Bytes[11], v1Bytes[12], v1Bytes[13], v1Bytes[14], v1Bytes[15]);
 }

package/dist/cjs-browser/v3.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v3<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v3 {
     var DNS: string;
     var URL: string;

package/dist/cjs-browser/v35.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
-export declare function stringToBytes(str: string): Uint8Array<ArrayBuffer>;
+export declare function stringToBytes(str: string): Uint8Array;
 export declare const DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
 export declare const URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
 type HashFunction = (bytes: Uint8Array) => Uint8Array;
-export default function v35(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: Uint8Array, offset?: number): string | Uint8Array<ArrayBufferLike>;
+export default function v35<TBuf extends Uint8Array = Uint8Array>(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: TBuf, offset?: number): UUIDTypes<TBuf>;
 export {};

package/dist/cjs-browser/v35.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.URL = exports.DNS = void 0;
-exports.stringToBytes = stringToBytes;
-exports.default = v35;
+exports.URL = exports.DNS = exports.stringToBytes = void 0;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function stringToBytes(str) {
@@ -13,6 +11,7 @@ function stringToBytes(str) {
     }
     return bytes;
 }
+exports.stringToBytes = stringToBytes;
 exports.DNS = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
 exports.URL = '6ba7b811-9dad-11d1-80b4-00c04fd430c8';
 function v35(version, hash, value, namespace, buf, offset) {
@@ -39,3 +38,4 @@ function v35(version, hash, value, namespace, buf, offset) {
     }
     return (0, stringify_js_1.unsafeStringify)(bytes);
 }
+exports.default = v35;

package/dist/cjs-browser/v4.d.ts

@@ -1,4 +1,4 @@
 import { Version4Options } from './types.js';
 declare function v4(options?: Version4Options, buf?: undefined, offset?: number): string;
-declare function v4(options: Version4Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v4<TBuf extends Uint8Array = Uint8Array>(options: Version4Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v4;

package/dist/cjs-browser/v5.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v5<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v5 {
     var DNS: string;
     var URL: string;

package/dist/cjs-browser/v6.d.ts

@@ -1,4 +1,4 @@
 import { Version6Options } from './types.js';
 declare function v6(options?: Version6Options, buf?: undefined, offset?: number): string;
-declare function v6(options: Version6Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v6<TBuf extends Uint8Array = Uint8Array>(options: Version6Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v6;

package/dist/cjs-browser/v6ToV1.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = v6ToV1;
 const parse_js_1 = require("./parse.js");
 const stringify_js_1 = require("./stringify.js");
 function v6ToV1(uuid) {
@@ -8,6 +7,7 @@ function v6ToV1(uuid) {
     const v1Bytes = _v6ToV1(v6Bytes);
     return typeof uuid === 'string' ? (0, stringify_js_1.unsafeStringify)(v1Bytes) : v1Bytes;
 }
+exports.default = v6ToV1;
 function _v6ToV1(v6Bytes) {
     return Uint8Array.of(((v6Bytes[3] & 0x0f) << 4) | ((v6Bytes[4] >> 4) & 0x0f), ((v6Bytes[4] & 0x0f) << 4) | ((v6Bytes[5] & 0xf0) >> 4), ((v6Bytes[5] & 0x0f) << 4) | (v6Bytes[6] & 0x0f), v6Bytes[7], ((v6Bytes[1] & 0x0f) << 4) | ((v6Bytes[2] & 0xf0) >> 4), ((v6Bytes[2] & 0x0f) << 4) | ((v6Bytes[3] & 0xf0) >> 4), 0x10 | ((v6Bytes[0] & 0xf0) >> 4), ((v6Bytes[0] & 0x0f) << 4) | ((v6Bytes[1] & 0xf0) >> 4), v6Bytes[8], v6Bytes[9], v6Bytes[10], v6Bytes[11], v6Bytes[12], v6Bytes[13], v6Bytes[14], v6Bytes[15]);
 }

package/dist/cjs-browser/v7.d.ts

@@ -4,6 +4,6 @@ type V7State = {
     seq?: number;
 };
 declare function v7(options?: Version7Options, buf?: undefined, offset?: number): string;
-declare function v7(options: Version7Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v7<TBuf extends Uint8Array = Uint8Array>(options: Version7Options | undefined, buf: TBuf, offset?: number): TBuf;
 export declare function updateV7State(state: V7State, now: number, rnds: Uint8Array): V7State;
 export default v7;

package/dist/cjs-browser/v7.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV7State = updateV7State;
+exports.updateV7State = void 0;
 const rng_js_1 = require("./rng.js");
 const stringify_js_1 = require("./stringify.js");
 const _state = {};
@@ -15,7 +15,7 @@ function v7(options, buf, offset) {
         updateV7State(_state, now, rnds);
         bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);
     }
-    return buf ? bytes : (0, stringify_js_1.unsafeStringify)(bytes);
+    return buf ?? (0, stringify_js_1.unsafeStringify)(bytes);
 }
 function updateV7State(state, now, rnds) {
     state.msecs ??= -Infinity;
@@ -32,6 +32,7 @@ function updateV7State(state, now, rnds) {
     }
     return state;
 }
+exports.updateV7State = updateV7State;
 function v7Bytes(rnds, msecs, seq, buf, offset = 0) {
     if (rnds.length < 16) {
         throw new Error('Random bytes length must be >= 16');

package/dist/esm/md5.d.ts

@@ -1,2 +1,4 @@
-declare function md5(bytes: Uint8Array): Buffer<ArrayBufferLike>;
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+declare function md5(bytes: Uint8Array): Buffer;
 export default md5;

package/dist/esm/native.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" resolution-mode="require"/>
 import { randomUUID } from 'crypto';
 declare const _default: {
     randomUUID: typeof randomUUID;

package/dist/esm/parse.d.ts

@@ -1,2 +1,2 @@
-declare function parse(uuid: string): Uint8Array<ArrayBuffer>;
+declare function parse(uuid: string): Uint8Array;
 export default parse;

package/dist/esm/rng.d.ts

@@ -1 +1 @@
-export default function rng(): Uint8Array<ArrayBuffer>;
+export default function rng(): Uint8Array;

package/dist/esm/sha1.d.ts

@@ -1,2 +1,4 @@
-declare function sha1(bytes: Uint8Array): Buffer<ArrayBufferLike>;
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+declare function sha1(bytes: Uint8Array): Buffer;
 export default sha1;

package/dist/esm/types.d.ts

@@ -1,4 +1,4 @@
-export type UUIDTypes = string | Uint8Array;
+export type UUIDTypes<TBuf extends Uint8Array = Uint8Array> = string | TBuf;
 export type Version1Options = {
     node?: Uint8Array;
     clockseq?: number;

package/dist/esm/v1.d.ts

@@ -6,6 +6,6 @@ type V1State = {
     nsecs?: number;
 };
 declare function v1(options?: Version1Options, buf?: undefined, offset?: number): string;
-declare function v1(options: Version1Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v1<Buf extends Uint8Array = Uint8Array>(options: Version1Options | undefined, buf: Buf, offset?: number): Buf;
 export declare function updateV1State(state: V1State, now: number, rnds: Uint8Array): V1State;
 export default v1;

package/dist/esm/v1.js

@@ -19,7 +19,7 @@ function v1(options, buf, offset) {
         updateV1State(_state, now, rnds);
         bytes = v1Bytes(rnds, _state.msecs, _state.nsecs, isV6 ? undefined : _state.clockseq, isV6 ? undefined : _state.node, buf, offset);
     }
-    return buf ? bytes : unsafeStringify(bytes);
+    return buf ?? unsafeStringify(bytes);
 }
 export function updateV1State(state, now, rnds) {
     state.msecs ??= -Infinity;

package/dist/esm/v3.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v3<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v3 {
     var DNS: string;
     var URL: string;

package/dist/esm/v35.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
-export declare function stringToBytes(str: string): Uint8Array<ArrayBuffer>;
+export declare function stringToBytes(str: string): Uint8Array;
 export declare const DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
 export declare const URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
 type HashFunction = (bytes: Uint8Array) => Uint8Array;
-export default function v35(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: Uint8Array, offset?: number): string | Uint8Array<ArrayBufferLike>;
+export default function v35<TBuf extends Uint8Array = Uint8Array>(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: TBuf, offset?: number): UUIDTypes<TBuf>;
 export {};

package/dist/esm/v4.d.ts

@@ -1,4 +1,4 @@
 import { Version4Options } from './types.js';
 declare function v4(options?: Version4Options, buf?: undefined, offset?: number): string;
-declare function v4(options: Version4Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v4<TBuf extends Uint8Array = Uint8Array>(options: Version4Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v4;

package/dist/esm/v5.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v5<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v5 {
     var DNS: string;
     var URL: string;

package/dist/esm/v6.d.ts

@@ -1,4 +1,4 @@
 import { Version6Options } from './types.js';
 declare function v6(options?: Version6Options, buf?: undefined, offset?: number): string;
-declare function v6(options: Version6Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v6<TBuf extends Uint8Array = Uint8Array>(options: Version6Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v6;

package/dist/esm/v7.d.ts

@@ -4,6 +4,6 @@ type V7State = {
     seq?: number;
 };
 declare function v7(options?: Version7Options, buf?: undefined, offset?: number): string;
-declare function v7(options: Version7Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v7<TBuf extends Uint8Array = Uint8Array>(options: Version7Options | undefined, buf: TBuf, offset?: number): TBuf;
 export declare function updateV7State(state: V7State, now: number, rnds: Uint8Array): V7State;
 export default v7;

package/dist/esm/v7.js

@@ -12,7 +12,7 @@ function v7(options, buf, offset) {
         updateV7State(_state, now, rnds);
         bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);
     }
-    return buf ? bytes : unsafeStringify(bytes);
+    return buf ?? unsafeStringify(bytes);
 }
 export function updateV7State(state, now, rnds) {
     state.msecs ??= -Infinity;

package/dist/esm-browser/md5.d.ts

@@ -1,2 +1,2 @@
-declare function md5(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
+declare function md5(bytes: Uint8Array): Uint8Array;
 export default md5;

package/dist/esm-browser/parse.d.ts

@@ -1,2 +1,2 @@
-declare function parse(uuid: string): Uint8Array<ArrayBuffer>;
+declare function parse(uuid: string): Uint8Array;
 export default parse;

package/dist/esm-browser/rng.d.ts

@@ -1 +1 @@
-export default function rng(): Uint8Array<ArrayBuffer>;
+export default function rng(): Uint8Array;

package/dist/esm-browser/types.d.ts

@@ -1,4 +1,4 @@
-export type UUIDTypes = string | Uint8Array;
+export type UUIDTypes<TBuf extends Uint8Array = Uint8Array> = string | TBuf;
 export type Version1Options = {
     node?: Uint8Array;
     clockseq?: number;

package/dist/esm-browser/v1.d.ts

@@ -6,6 +6,6 @@ type V1State = {
     nsecs?: number;
 };
 declare function v1(options?: Version1Options, buf?: undefined, offset?: number): string;
-declare function v1(options: Version1Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v1<Buf extends Uint8Array = Uint8Array>(options: Version1Options | undefined, buf: Buf, offset?: number): Buf;
 export declare function updateV1State(state: V1State, now: number, rnds: Uint8Array): V1State;
 export default v1;

package/dist/esm-browser/v1.js

@@ -19,7 +19,7 @@ function v1(options, buf, offset) {
         updateV1State(_state, now, rnds);
         bytes = v1Bytes(rnds, _state.msecs, _state.nsecs, isV6 ? undefined : _state.clockseq, isV6 ? undefined : _state.node, buf, offset);
     }
-    return buf ? bytes : unsafeStringify(bytes);
+    return buf ?? unsafeStringify(bytes);
 }
 export function updateV1State(state, now, rnds) {
     state.msecs ??= -Infinity;

package/dist/esm-browser/v3.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v3(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v3<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v3 {
     var DNS: string;
     var URL: string;

package/dist/esm-browser/v35.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
-export declare function stringToBytes(str: string): Uint8Array<ArrayBuffer>;
+export declare function stringToBytes(str: string): Uint8Array;
 export declare const DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
 export declare const URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
 type HashFunction = (bytes: Uint8Array) => Uint8Array;
-export default function v35(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: Uint8Array, offset?: number): string | Uint8Array<ArrayBufferLike>;
+export default function v35<TBuf extends Uint8Array = Uint8Array>(version: 0x30 | 0x50, hash: HashFunction, value: string | Uint8Array, namespace: UUIDTypes, buf?: TBuf, offset?: number): UUIDTypes<TBuf>;
 export {};

package/dist/esm-browser/v4.d.ts

@@ -1,4 +1,4 @@
 import { Version4Options } from './types.js';
 declare function v4(options?: Version4Options, buf?: undefined, offset?: number): string;
-declare function v4(options: Version4Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v4<TBuf extends Uint8Array = Uint8Array>(options: Version4Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v4;

package/dist/esm-browser/v5.d.ts

@@ -1,7 +1,7 @@
 import { UUIDTypes } from './types.js';
 export { DNS, URL } from './v35.js';
 declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf?: undefined, offset?: number): string;
-declare function v5(value: string | Uint8Array, namespace: UUIDTypes, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v5<TBuf extends Uint8Array = Uint8Array>(value: string | Uint8Array, namespace: UUIDTypes, buf: TBuf, offset?: number): TBuf;
 declare namespace v5 {
     var DNS: string;
     var URL: string;

package/dist/esm-browser/v6.d.ts

@@ -1,4 +1,4 @@
 import { Version6Options } from './types.js';
 declare function v6(options?: Version6Options, buf?: undefined, offset?: number): string;
-declare function v6(options: Version6Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v6<TBuf extends Uint8Array = Uint8Array>(options: Version6Options | undefined, buf: TBuf, offset?: number): TBuf;
 export default v6;

package/dist/esm-browser/v7.d.ts

@@ -4,6 +4,6 @@ type V7State = {
     seq?: number;
 };
 declare function v7(options?: Version7Options, buf?: undefined, offset?: number): string;
-declare function v7(options: Version7Options | undefined, buf: Uint8Array, offset?: number): Uint8Array;
+declare function v7<TBuf extends Uint8Array = Uint8Array>(options: Version7Options | undefined, buf: TBuf, offset?: number): TBuf;
 export declare function updateV7State(state: V7State, now: number, rnds: Uint8Array): V7State;
 export default v7;

package/dist/esm-browser/v7.js

@@ -12,7 +12,7 @@ function v7(options, buf, offset) {
         updateV7State(_state, now, rnds);
         bytes = v7Bytes(rnds, _state.msecs, _state.seq, buf, offset);
     }
-    return buf ? bytes : unsafeStringify(bytes);
+    return buf ?? unsafeStringify(bytes);
 }
 export function updateV7State(state, now, rnds) {
     state.msecs ??= -Infinity;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uuid",
-  "version": "11.0.4",
+  "version": "11.1.0",
   "description": "RFC9562 UUIDs",
   "type": "module",
   "funding": [
@@ -68,7 +68,7 @@
     "release-please": "16.15.0",
     "runmd": "1.4.1",
     "standard-version": "9.5.0",
-    "typescript": "5.7.2",
+    "typescript": "5.0.4",
     "typescript-eslint": "8.18.2"
   },
   "optionalDevDependencies": {
@@ -87,15 +87,17 @@
     "docs": "npm run build && npx runmd --output=README.md README_js.md",
     "eslint:check": "eslint src/ test/ examples/ *.[jt]s",
     "eslint:fix": "eslint --fix src/ test/ examples/ *.[jt]s",
-    "examples:browser:rollup:build": "cd examples/browser-rollup && npm install && npm run build",
-    "examples:browser:webpack:build": "cd examples/browser-webpack && npm install && npm run build",
-    "examples:node:commonjs:test": "cd examples/node-commonjs && npm install && npm test",
-    "examples:node:esmodules:test": "cd examples/node-esmodules && npm install && npm test",
-    "examples:node:jest:test": "cd examples/node-jest && npm install && npm test",
+    "examples:browser:rollup:build": "cd examples/browser-rollup && npm run build",
+    "examples:browser:webpack:build": "cd examples/browser-webpack && npm run build",
+    "examples:node:commonjs:test": "cd examples/node-commonjs && npm test",
+    "examples:node:esmodules:test": "cd examples/node-esmodules && npm test",
+    "examples:node:jest:test": "cd examples/node-jest && npm test",
+    "examples:node:typescript:test": "cd examples/typescript && npm test",
     "lint": "npm run eslint:check && npm run prettier:check",
     "md": "runmd --watch --output=README.md README_js.md",
-    "prepack": "npm run build",
+    "prepack": "npm run build -- --no-pack",
     "prepare": "husky",
+    "prepublishOnly": "npm run build",
     "pretest:benchmark": "npm run build",
     "pretest:browser": "./scripts/iodd && npm run build && npm-run-all --parallel examples:browser:**",
     "pretest:node": "npm run build",
@@ -103,10 +105,9 @@
     "prettier:check": "prettier --check .",
     "prettier:fix": "prettier --write .",
     "release": "standard-version --no-verify",
-    "test:benchmark": "cd examples/benchmark && HUSKY=0 npm install && npm test",
+    "test:benchmark": "cd examples/benchmark && npm test",
     "test:browser": "wdio run ./wdio.conf.js",
     "test:node": "npm-run-all --parallel examples:node:**",
-    "test:pack": "./scripts/testpack.sh",
     "test:watch": "node --test --enable-source-maps --watch dist/esm/test/*.js",
     "test": "node --test --enable-source-maps dist/esm/test/*.js"
   },