YourSUUID

yoursuuid

ブラウザー、Node 20+、Deno、Bun、エッジランタイム向けの、依存関係ゼロの UUID v4／v5／v7、ULID、NanoID の生成、検証、デコード機能です。CLI と MCP サーバーを同梱しています。MIT ライセンスです。

乱数の生成には crypto.getRandomValues のみを使用します。UUID v7 と ULID はプロセス内で単調増加するため、同じミリ秒内に作成された ID も作成順に並びます。

インストール

npm install yoursuuid

ライブラリ

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

開発者向けユーティリティ（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 は標準的な 5 フィールドの Vixie セマンティクスに従います。名前（JAN、MON）、範囲、間隔、リスト、7 = 日曜日、@daily 形式のマクロに対応し、日付と曜日の両方に制限がある場合は「日付または曜日」として扱います。

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"

フラグ：--upper、--no-hyphens。

MCP サーバー

AI アシスタント（Claude、Cursor、VS Code、Windsurf…）が識別子をローカルで生成、検査できるようにします。

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

ツール：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。

インストールは不要ですか？ホスト型の Streamable HTTP エンドポイント https://yoursuuid.com/mcp で識別子ツールを利用できます。HMAC、JWT、bcrypt はローカルサーバー上で処理されるため、シークレットがマシンの外部に送信されることはありません。

v7 を選ぶ理由

UUID v7 はミリ秒単位のタイムスタンプを先頭に配置するため、データベースのインデックスにキーがランダムなページではなく、順番に追加されます。UUID v7 ビジュアライザーと衝突計算ツールをご覧ください。

ライセンス

MIT