Testing & Performance

Semantic ID Generator includes comprehensive test suites and regularly benchmarked performance targets. Use this page to navigate everything related to quality assurance.

Running the test suite

npm test

TypeScript-specific checks

npm run test:typescript

These commands cover unit tests (mocha), TypeScript compilation, and definition validation.

Test coverage overview

Performance benchmarks

General generation

• 100,000 IDs (default config): ~11 seconds (~0.11 ms/id)

Unicode strategy

• 10,000 strings (length 10): ~565 ms
• 100 strings (length 1000): ~700 ms
• 1,000 strings (length 50): ~300 ms

Strategy throughput

• Visible characters, numbers, alphanumeric, hexadecimal, base64: consistently fast
• Passphrase: still sub-millisecond thanks to cached word lists
• All characters: slower by design due to full Unicode plane filtering

Security guarantees

• All randomness uses Node.js crypto.randomBytes() / crypto.randomInt()
• Separators are excluded from every strategy, preventing malformed IDs
• Passphrase strategy sanitizes words that contain configured separators
• Dependencies (uuid, mocha, chai, TypeScript toolchain) are kept on current secure versions

Dependency snapshot

Refer to package.json for exact versions.

Performance tips

• Prefer presets + default strategies when possible (no per-call validation).
• Use visible characters, numbers, or hexadecimal strategies for hot paths—they avoid expensive Unicode filtering.
• Run npm test before publishing to ensure schema artifacts and preset metadata stay in sync.