The Ultimate Ultra-Fast, Zero-Dependency ID & Token Generator for Modern Enterprise Systems

We’re excited to announce the official release of @readytools/id (v1.0.6), our newest professional npm package designed from the ground up for developers building high-performance, secure, and scalable applications.

After seeing the fragmentation in the JavaScript ID ecosystem — where teams juggle separate packages for UUIDs, NanoIDs, ULIDs, CUIDs, and more — we built a single, battle-ready solution that replaces them all without adding a single dependency to your project.

Why @readytools/id?

The JavaScript ecosystem has long forced developers into a fragmented toolkit:

• uuid for databases
• nanoid for URL-friendly strings
• cuid2 / ulid for distributed systems
• Custom solutions for API keys, prefixed IDs, and binary storage

@readytools/id is the all-in-one replacement that solves real-world enterprise problems while keeping your node_modules clean and your supply-chain risk near zero.

Key Advantages

• Ultra-fast & fully tree-shakable — Highly optimized bitwise operations with strict named exports (import { uuidv7 }). Your bundler (Webpack, Vite, Rollup, esbuild) only includes the exact generators you use.
• Enterprise-grade security — Exclusively uses the native Web Crypto API (crypto.randomUUID, crypto.getRandomValues). Math.random is strictly forbidden.
• Zero dependencies — Completely replaces uuid, nanoid, cuid, ulid, and similar packages. Dramatically reduces supply-chain attack surface.
• Batteries included — UUIDv1 / v4 / v5 / v7, ULID, CUID2, NanoID (with custom alphabet support), Snowflake, Smart (Stripe-style) prefixed IDs, secure tokens, human-readable IDs, and more.
• Real-world tooling — Built-in deterministic test mocking, BINARY(16) converters for optimal database storage, mathematical collision-risk calculators, and rich validation/parsing utilities.
• Edge-ready — Works out of the box in Node.js 18+, React, Next.js, Deno, Bun, Cloudflare Workers, Vercel Edge, and modern browsers.
• AI / LLM friendly — Strict TypeScript typings, deterministic behavior, and predictable naming conventions make it ideal for Copilot, ChatGPT, Claude, and other AI coding assistants.

Installation

npm install @readytools/id
# or
pnpm add @readytools/id
# or
yarn add @readytools/id

Quick Start & Generators

Database-Optimized (UUIDv7 & ULID)

Random UUIDv4 values cause significant B-Tree index fragmentation in PostgreSQL and MySQL. UUIDv7 and ULID solve this by being chronologically sortable.

import { uuidv7, ulid } from '@readytools/id';

const uid = uuidv7(); // "01917f9b-6b80-71a2-8b9a-1c8f3b2a4d5e"
const u   = ulid();  // "01M0PSE3E250JQT8AVKQQ71XDX"

URL-Friendly & Client-Side (NanoID & CUID2)

import { nanoId, cuid2 } from '@readytools/id';

const nid = nanoId();  // "V1StGXR8_Z5jdHi6B-myT"
const cid = cuid2();   // "oyx0325cv6x4vqlsja5s7yd8"

Smart Prefixed IDs (Stripe-style)

Domain-prefixed IDs make logs, APIs, and debugging dramatically clearer.

import { smart } from '@readytools/id';

const userId    = smart('usr');                    // "usr_7eto6037Z-N5JDsBKKVYl"
const invoiceId = smart('inv', { date: true });    // "inv_20260823_6mY686gs0CYsJnxzeuG90"

Secure API Keys & Tokens

import { generateToken } from '@readytools/id';

const token = generateToken(32, 'base64url'); // 32-byte cryptographically secure Base64URL string

Enterprise Tooling

1. Deterministic Testing / Mocking
Stop writing fragile mocks for random IDs. Seed the generator so snapshot tests become 100% reproducible.

import { seed, resetMocks, uuidv4 } from '@readytools/id';

seed(12345);               // PRNG is now deterministic
const a = uuidv4();        // Always the same value for this seed
// ... run your tests ...
resetMocks();              // Restore secure Web Crypto generator

2. Database Storage Optimizer (BINARY(16))
Storing 36-character UUID strings wastes space and slows indexes. Convert to a compact 16-byte Uint8Array.

import { uuidv7, toBinary, fromBinary } from '@readytools/id';

const binary  = toBinary(uuidv7());           // Uint8Array(16)
const uuidStr = fromBinary(binary, 'uuid');   // Restore original string

3. Collision Risk Calculator
Calculate exact mathematical collision probability using the Birthday Paradox.

import { collisionRisk } from '@readytools/id';

const risk = collisionRisk(64, 21, 1_000_000); // alphabet length, ID length, expected count

Validation, Parsing & Inspection

import { isValid, getVersion, extractTimestamp } from '@readytools/id';

isValid('01917f9b-...', 'uuid');                    // true
getVersion('01917f9b-...');                         // 7
extractTimestamp('01M0PSE3E250JQT8AVKQQ71XDX', 'ulid'); // Date object

CLI Usage

Generate IDs or calculate risk directly from the terminal:

npx @readytools/id uuidv7
npx @readytools/id smart usr
npx @readytools/id risk 64 21 1000000

Performance Benchmarks

Tested on Node.js v20 (ops/sec — higher is better):

(Run npm run bench for results on your machine.)

Full Documentation

Complete, production-ready documentation is available at:

https://www.readytools.co/docs/id/

The docs cover:

• Getting Started
• Live in-browser benchmarks & package comparisons
• UUID (v1, v4, v5, v7)
• NanoID & custom alphabets
• ULID
• CUID2
• Snowflake IDs
• Smart Prefixed IDs
• Secure Token Generation
• Validation & Inspection
• Formatting & Batch generation
• Human-friendly readable IDs
• Database optimization & binary conversion
• Collision risk & entropy calculation
• Testing & deterministic mocking

License

MIT © ReadyTools

Happy coding!
— The ReadyTools Team