Uuid
Nova includes a Uuid utility class for generating, parsing, and working with UUIDs (v7 by default).
Import
Import TypeScript
import { Uuid } from '@abrahambass/nova';Factory Methods
| Method | Parameters | Returns | Description |
|---|---|---|---|
Uuid.create() | — | Uuid | Generates a new UUID v7 (time-ordered). |
Uuid.parse(value) | value: string Required | Uuid | Parses and validates a UUID string. Throws TypeError if invalid. |
Uuid.fromBytes(bytes) | bytes: Uint8Array Required | Uuid | Creates a UUID from a 16-byte array. Throws if not 16 bytes. |
Uuid.isUuid(value) | value: unknown | boolean | Type guard to check if a value is a Uuid instance. |
Instance Methods & Properties
| Property / Method | Returns | Description |
|---|---|---|
.value | string | The UUID string value. |
.toString() | string | Returns the UUID string. |
.toJSON() | string | Returns the UUID string (for JSON serialization). |
.toBytes() | Uint8Array | Converts the UUID to a 16-byte array. |
.equals(other) | boolean | Checks equality with another Uuid instance. |
Examples
Usage TypeScript
import { Uuid } from '@abrahambass/nova';
// Generate a new UUID
const id = Uuid.create();
console.log(id.value); // '019539c4-3e5b-7d4a-8c0f-...'
// Parse an existing UUID
const parsed = Uuid.parse('550e8400-e29b-41d4-a716-446655440000');
// Compare UUIDs
id.equals(parsed); // false
// Convert to bytes and back
const bytes = id.toBytes();
const restored = Uuid.fromBytes(bytes);
// Type guard
if (Uuid.isUuid(someValue)) {
console.log(someValue.value);
}