YourSUUID

yoursuuid

Zero-dependency UUID v4 / v5 / v7, ULID and NanoID generation, validation and decoding for browsers, Node 20+, Deno, Bun and edge runtimes. Ships a CLI and an MCP server. MIT licensed.

Randomness comes only from crypto.getRandomValues. UUID v7 and ULID are monotonic within a process, so IDs created in the same millisecond still sort in creation order.

Install

npm install yoursuuid

Library

import { uuidv4, uuidv7, uuidv5, ulid, nanoid, parseUuid, isUuid } from 'yoursuuid'

uuidv7() // '0192d3a1-7c4f-7b2a-9d1e-3f5a6b7c8d9e' uuidv4() // random v4 await uuidv5('example.com', 'dns') // deterministic, SHA-1 name-based ulid() // '01JB8S3Y2F7Q9X4M5N6P7R8S9T' nanoid(12) // 'V1StGXR8_Z5j'

parseUuid('0192d3a1-7c4f-7b2a-9d1e-3f5a6b7c8d9e') // { valid: true, uuid: '…', version: 7, variant: 'rfc9562', timestamp: Date(2024-10-28T14:57:08.687Z) }

isUuid('{0192D3A1-7C4F-7B2A-9D1E-3F5A6B7C8D9E}') // true — braces, urn:uuid: and missing hyphens are accepted

Developer utilities (yoursuuid/devtools)

import { hmac, jsonToTypescript, jsonToZod, describeCron, cronNextRuns, jwtSign, bcryptHash } from 'yoursuuid/devtools'

await hmac('SHA-256', 'secret', 'message') // hex; also 'base64' and 'base64url' jsonToTypescript('{"id":1,"tags":["a"]}', { rootName: 'User' }) jsonToZod('{"id":1}', { rootName: 'User' }) describeCron('0 9 * * 1-5') // 'At 09:00 on Monday through Friday' cronNextRuns('*/15 * * * *', { count: 3, utc: true }) // [Date, Date, Date] await jwtSign({ sub: 'a' }, 'secret', 'HS256') bcryptHash('password', 10)

Cron follows standard 5-field Vixie semantics: names (JAN, MON), ranges, steps, lists, 7 = Sunday, @daily-style macros, and "day of month OR day of week" when both are restricted.

CLI

npx yoursuuid                 # one UUID v4

npx yoursuuid v7 -n 5 # five UUID v7 npx yoursuuid ulid -n 3 npx yoursuuid nanoid --size 12 npx yoursuuid v5 example.com --namespace dns npx yoursuuid inspect 0192d3a1-7c4f-7b2a-9d1e-3f5a6b7c8d9e npx yoursuuid hmac "message" --key secret --alg sha256 npx yoursuuid jwt sign '{"sub":"a"}' --secret secret npx yoursuuid bcrypt hash "password" --cost 10 npx yoursuuid cron "*/15 9-17 * * 1-5" --utc npx yoursuuid cron build --minute 0 --hour 9 --dow 1-5 curl -s https://api.github.com/users/octocat | npx yoursuuid json2ts --name User npx yoursuuid json2zod payload.json --name User npx yoursuuid chmod 755 npx yoursuuid compose "docker run -d -p 8080:80 nginx"

Flags: --upper, --no-hyphens.

MCP server

Lets AI assistants (Claude, Cursor, VS Code, Windsurf…) generate and inspect identifiers locally.

{

"mcpServers": { "yoursuuid": { "command": "npx", "args": ["-y", "yoursuuid", "mcp"] } } }

Tools: generate_uuid, generate_uuid_v5, generate_ulid, generate_nanoid, inspect_uuid, hmac, jwt_sign, jwt_verify, bcrypt_hash, bcrypt_verify, base58, base32, json_to_typescript, json_to_zod, json_to_go, json_to_rust, format_sql, curl_to_code, cron_next_runs, build_cron, explain_regex, explain_chmod, docker_run_to_compose.

No install? The hosted Streamable HTTP endpoint https://yoursuuid.com/mcp offers the identifier tools. HMAC, JWT and bcrypt stay on the local server so secrets never leave your machine.

Why v7?

UUID v7 puts a millisecond timestamp first, so database indexes receive keys in order instead of at random pages. See the UUID v7 visualizer and the collision calculator.

License

MIT