UUID

UUID value object with random generation.

Import

import { UUID } from '@haskou/value-objects';

Signature

class UUID extends ValueObject<string>

Constructor

constructor(value: string | StringValueObject)

Validation

Must use the standard 8-4-4-4-12 hexadecimal structure with a supported UUID version and RFC variant. The Nil and Max sentinel UUIDs defined by RFC 9562 are also accepted.

Throws

This class can throw:

• InvalidLengthError
• InvalidFormatError

Methods

Method	Description
static generate()	Generates a random UUID v4 value.

Example

import { UUID } from '@haskou/value-objects';

const id = UUID.generate();
id.toString(); // e.g. '3fd4c04a-8e73-4e10-aef3-f491b32ec538'

Notes

• The constructor pattern accepts lowercase a-z, 0-9, and hyphens.

Generation uses globalThis.crypto.getRandomValues() (browsers and Node.js 20 or later) and produces an RFC 4122 version 4 UUID. The package has no runtime dependencies.

Related

• Error handling
• Reference overview