Fast uuid generator / an alternative for crypto.randomUUID
npm install turbouuidFast UUID generator / an alternative for crypto.randomUUID.
Designed for performance-critical applications, turbouuid uses a pre-allocated buffer strategy to generate UUIDs significantly faster than the native implementation.
Benchmarks ran on 1,000,000 iterations show a massive performance gain:
- crypto.randomUUID: ~1138ms
- turbouuid: ~426ms
🚀 ~2.6x faster than the native solution.
The library attaches directly to window.randomUUID for browser environments.
``javascript
require('turbouuid');
// Returns a standard v4-like UUID string
console.log(window.randomUUID());
// Output example: f1235820-f090-3fce-a0d6-af6e26c6a0d6
`
turbouuid now includes a high-performance, WebAssembly-based storage engine for managing UUIDs in memory. It leverages 128-bit SIMD instructions to perform lightning-fast lookups and storage operations.
* ⚡ SIMD-Powered Search: Uses v128 vector instructions to scan memory in parallel, offering incredibly fast indexOf and has checks.uuid -> id
* 🔗 Key-Ref Association: Map each UUID to a 32-bit integer (e.g., a database ID or object reference) for efficient lookups ().
* 🧠 Zero-GC Overhead: Operates on shared memory pages, bypassing the JavaScript garbage collector for stable, high-throughput performance.
To use the storage engine, initialize it via turboUUID.base():
`javascript`
const store = await turboUUID.base();
#### store.randomUUID(value: number): string
Generates a new UUID, stores it in memory, and associates it with the given . Returns the generated UUID string.
`javascript`
const uuid = store.randomUUID(12345);
---
#### store.uuidAt(index: number): string
Returns the UUID string stored at the specific memory index.
`javascript`
// Get the first UUID stored
const firstUUID = store.uuidAt(0);
---
#### store.indexOf(uuid: string): number
Returns the memory index of the given UUID. Returns if not found.
Powered by SIMD for checking multiple bytes per cycle.
`javascript`
const index = store.indexOf("f1235820-f090-3fce-a0d6-af6e26c6a0d6");
---
#### store.has(uuid: string): boolean
Checks if the UUID exists in the storage. Returns (true) or 0 (false).
`javascript`
if (store.has(uuid)) {
console.log("UUID Exists!");
}
---
#### store.valueOf(uuid: string): number
Returns the integer value associated with the given UUID. Returns if the UUID is not found.
`javascript`
const userId = store.valueOf(uuid);
console.log("User ID:", userId); // 12345
---
#### store.setValue(uuid: string, value: number): void
Updates or sets the integer value associated with an existing UUID. If the UUID doesn't exist, it creates a new entry.
`javascript`
// Update the ID associated with this UUID
store.setValue(uuid, 67890);
---
#### store.remove(uuid: string): void
Removes the UUID and its associated value from the storage.
`javascript`
store.remove(uuid);
---
#### store.count(): number
Returns the total number of UUIDs currently stored.
`javascript`
console.log("Total UUIDs:", store.count());
---
#### store.forEach(callback: (uuid, value, index) => void): void
Iterates over all stored UUIDs.
Note: The callback receives the UUID string, the associated value, and the index.
`javascript#${index}: ${uuid} -> ${value}
store.forEach((uuid, value, index) => {
console.log();`
});
Instead of re-allocating memory for every generation, turbouuid reuses a set of TypedArrays (Float64Array, Uint32Array, Uint16Array, BigUint64Array`) sharing the same buffer. This minimizes garbage collection overhead and maximizes throughput.
MIT