UUID Module

The std/uuid module generates universally unique identifiers (UUIDs) and provides validation utilities.

Import

import { uuid } from "std/uuid"

Functions

uuid.v4(): string

Generates a random UUID v4.

const id = uuid.v4()
println(id) // "550e8400-e29b-41d4-a716-446655440000"

uuid.v7(): string

Generates a time-ordered UUID v7 (RFC 9562). Sortable by creation time — preferred for database primary keys.

const id = uuid.v7()
println(id) // "019443a6-7d00-7000-8000-000000000001"

uuid.isValid(value: string): bool

Returns true if the string is a valid UUID format.

println(uuid.isValid("550e8400-e29b-41d4-a716-446655440000")) // true
println(uuid.isValid("not-a-uuid")) // false

uuid.version(value: string): int

Returns the version number of a UUID (4, 7, etc.) or -1 if invalid.

const v4id = uuid.v4()
println(uuid.version(v4id)) // 4

const v7id = uuid.v7()
println(uuid.version(v7id)) // 7

uuid.timestamp(value: string): int

Extracts the timestamp (in milliseconds) from a v7 UUID. Returns -1 if the UUID is not a valid v7.

const id = uuid.v7()
const ts = uuid.timestamp(id)
println(ts) // 1706000000000 (milliseconds since epoch)

Function Reference

Function	Description
uuid.v4()	Generate random UUID v4
uuid.v7()	Generate time-ordered UUID v7
uuid.isValid(value)	Check if string is valid UUID
uuid.version(value)	Get UUID version number
uuid.timestamp(value)	Extract timestamp from v7 UUID (ms)

Example: Database Records

import { uuid } from "std/uuid"
import { json } from "std/json"
import { createServer, Request, Response } from "std/http"

const app = createServer()

app.post("/users", function(req: Request, res: Response): Response {
    const id = uuid.v7()  // Sortable by creation time
    const body = json.parse(req.body)
    // Store user with id...
    return res.status(201).json('{"id": "' + id + '", "name": "' + body["name"] + '"}')
})

app.listen(3000)