deterministic-uniqid

This package serves a single purpose; to quickly generate alphanumeric unique IDs in a deterministic way. Meaning, this library can be passed a seed value, and given the same seed, it should generate the same ID strings in the same order.

Usage

1var gen = new DeterministicUniqId();
2gen.setSeed('some_unique_seed');
3gen.generateId();
4// => "12Ab88zY"
5gen.generateId();
6// => "81v2Y79j"
7gen.setSeed('some_unique_seed');
8gen.generateId();
9// => "12Ab88zY"

API

constructor(seed: string, keyLength: number)

Takes two parameters:

• seed: instantiate the ID generator with this seed value
• keyLength: the length of the ID string output by generateId()

1    new DeterministicUniqId('DINOSAURS', 16);

.setKeyLength(length: number)

Sets the desired ID length. This will be the length of the string returned by .generateId()

.setSeed(seed: string)

Sets the seed for deterministic random number generation. This ensures that generateId will always generate the same pseudo-random ID strings, in the same order.

.generateId(void)

Generates a pseudo-random ID. Given the same seed value, either passed to the constructor or set via .setSeed(seed), this will return a series of the same unique IDs, in the same order.