@skorotkiewicz/snowflake-id/dist/cjs/index.js

Snowflake ID is a unique identifier commonly used in distributed systems to generate unique IDs with a timestamp component. It is designed to ensure uniqueness, even in distributed and highly concurrent environments.

'use strict';

Object.defineProperty(exports, '__esModule', { value: true });

class Snowflake {
    constructor(machineId) {
        this.timestampShift = 22n;
        this.machineIdShift = 12n;
        this.sequenceMask = 0xfffn;
        if (machineId < 0 || machineId >= 1024) {
            throw new Error("Machine ID must be in the range 0-1023.");
        }
        this.machineId = BigInt(machineId);
        this.sequence = BigInt(0);
        this.lastTimestamp = BigInt(-1);
    }
    async generate() {
        let timestamp = BigInt(Date.now());
        if (timestamp === this.lastTimestamp) {
            this.sequence = (this.sequence + 1n) & this.sequenceMask;
            if (this.sequence === 0n) {
                while (timestamp <= this.lastTimestamp) {
                    await new Promise((resolve) => setTimeout(resolve, 1));
                    timestamp = BigInt(Date.now());
                }
            }
        }
        else {
            this.sequence = 0n;
        }
        this.lastTimestamp = timestamp;
        const id = ((timestamp & 0x1ffffffffffn) << this.timestampShift) |
            (this.machineId << this.machineIdShift) |
            this.sequence;
        return id.toString();
    }
}
function decodeSnowflake(idStr) {
    const id = BigInt(idStr);
    const timestampShift = 22n;
    const machineIdShift = 12n;
    const sequenceMask = 0xfffn;
    const timestamp = (id >> timestampShift) & 0x1ffffffffffn;
    const machineId = (id >> machineIdShift) & 0x3ffn;
    const sequence = id & sequenceMask;
    const date = new Date(Number(timestamp));
    return {
        timestamp: date.toISOString(),
        machineId: machineId.toString(),
        sequence: sequence.toString(),
    };
}

exports.Snowflake = Snowflake;
exports.decodeSnowflake = decodeSnowflake;