3.0.0
A changed copy of Maylily a distributable, serverless, and customizable unique ID generator based on Snowflake.
Repository
Current version released
4 years ago
Versions
Deno MayLily
A changed copy of Maylily a distributable, serverless, and customizable unique ID generator based on Snowflake. Made compatible with deno.
Features
- distributable / scalable
- no external servers required
- customizable
- supports 2-36 radix
- supports multiple precision integer
How to import
Import with nest.land
:
import { maylily } from "https://x.nest.land/deno-maylily@3.0.0/mod.ts";
Or use deno.land
:
import { maylily } from "https://deno.land/x/deno_maylily@3.0.0/mod.ts";
How to use
No external servers needed.
Just import and call maylily()
!
import { maylily } from "https://x.nest.land/deno-maylily@3.0.0/mod.ts";
try {
const id = await maylily();
// do something...
} catch (err) {
// err is instance of Error
}
How to customize
name | description | default |
---|---|---|
radix |
radix of generated ID (2-36) | 10 |
timeBase |
base time in unixtime (millisec) | 946684800000 (2000-01-01T00:00:00Z) |
machineId |
identifier of machine; must be unique in service | 0 |
machineBits |
required bits to represent machineId | 3 |
generatorId |
identifier of generator; must be unique in machine | process ID |
generatorBits |
required bits to represent generatorId | 10 |
sequenceBits |
required bits to represent sequence | 8 |
Generated value is stringified multiple precision integer (in specified radix).
000001011100000101111010101110101010111101 001 1101101010 00000110
|------------------------------------------| current time from timeBase in millisec
|---| machineId (uses machineBits bits)
|----------| generatorId (uses generatorBits bits)
|--------| sequence number (uses sequenceBits bits)
example:
// keeps options until next change
maylily({
timeBase: Date.parse("2017-01-01T00:00:00Z"), // if your service starts in 2017, this is enough.
machineBits: 1 // if required number machines are up to 2, this is enough.
});
Changelog
See CHANGELOG.md