node-flakes1.0.0 • Public • Published
The Node identity lib that provides:
- Coordination free
- 128 bit keys
- Lexicographically sortable
- base 62
128 bit key comprised of the following:
- 64 bit timestamp
- 48 bit worker id
- 16 bit sequence number
The sequence number increments for each subsequent id requested within the same millisecond.
node-flakes returns a function. Even when required and executed multiple times the same instance gets returned. This is worth noting so that you don't have to go through extra effort to pass around the seed value or continue to re-initialize it every time.
Using MACAddress or HostName as seed
If no seed is provided, you can use
seedFromEnvironment to use either the MAC address or host name plus the process id as the seed. This may not prevent duplicate seeds or id collisions, because of scenario where duplicate MACs or host names in your environment can occur.
const flakes = ;flakes // this call returns a promise and can be awaited if in an async call;
Anything can seed the node id. node-flakes uses farmhash to create a unique 32 bit integer from whatever you have lying around. This needs to be unique for every instance creating ids.
const flakes = 'Hey, look, a (terrible) string based seed.';const id = flakes; // ta-da
Looks like this tops out around 20 / ms on modern processors. Do with that what you will :)