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 v4await uuidv5('example.com', 'dns')   // deterministic, SHA-1 name-basedulid()                               // '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 v4npx yoursuuid v7 -n 5         # five UUID v7npx yoursuuid ulid -n 3npx yoursuuid nanoid --size 12npx yoursuuid v5 example.com --namespace dnsnpx yoursuuid inspect 0192d3a1-7c4f-7b2a-9d1e-3f5a6b7c8d9enpx yoursuuid hmac "message" --key secret --alg sha256npx yoursuuid jwt sign '{"sub":"a"}' --secret secretnpx yoursuuid bcrypt hash "password" --cost 10npx yoursuuid cron "*/15 9-17 * * 1-5" --utcnpx yoursuuid cron build --minute 0 --hour 9 --dow 1-5curl -s https://api.github.com/users/octocat | npx yoursuuid json2ts --name Usernpx yoursuuid json2zod payload.json --name Usernpx yoursuuid chmod 755npx 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