@andrew_l/snowflake 0.3.2 → 0.3.4

package/dist/index.cjs

@@ -5,6 +5,7 @@ const toolkit = require('@andrew_l/toolkit');
 var MAX_WORKER_ID = 31;
 var MAX_PROCESS_ID = 31;
 var MAX_INCREMENT = 4095;
+var ENCODE_BIGINT_BUFFER = new Uint8Array(8);
 class Snowflake {
   /**
    * Alias for {@link deconstruct}
@@ -33,7 +34,12 @@ class Snowflake {
   /**
    * @internal
    */
-  _buffer;
+  _timestamp = 0;
+  __buf;
+  _packBuffer;
+  _packBigInt;
+  _unpackBuffer;
+  _unpackBigInt;
   /**
    * @param epoch the epoch to use
    */
@@ -49,7 +55,32 @@ class Snowflake {
       this.processId = processId;
       this.increment = increment;
     }
-    this._buffer = new Uint8Array(8);
+    const packer = toolkit.bitPack({
+      totalBits: 64,
+      fields: [
+        { name: "_timestamp", bits: 42, take: "low" },
+        { name: "_workerId", bits: 5, take: "low" },
+        { name: "_processId", bits: 5, take: "low" },
+        { name: "_increment", bits: 12, take: "low" }
+      ],
+      optimize: true,
+      debug: true
+    });
+    const unpacker = toolkit.bitUnpack({
+      totalBits: 64,
+      fields: [
+        { name: "timestamp", bits: 42, take: "low" },
+        { name: "workerId", bits: 5, take: "low" },
+        { name: "processId", bits: 5, take: "low" },
+        { name: "increment", bits: 12, take: "low" }
+      ],
+      debug: true
+    });
+    this.__buf = new Uint8Array(8);
+    this._packBigInt = packer.bigint;
+    this._packBuffer = packer.buffer;
+    this._unpackBigInt = unpacker.bigint;
+    this._unpackBuffer = unpacker.buffer;
   }
   /**
    * The epoch for this snowflake, as a number
@@ -166,9 +197,10 @@ class Snowflake {
         `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
       );
     }
-    var increment = this._increment;
+    this._timestamp = timestamp - this._epoch;
+    var res = this._packBigInt(this);
     this._increment = this._increment + 1 & MAX_INCREMENT;
-    return BigInt(timestamp - this._epoch) << 22n | BigInt(this._workerId & MAX_WORKER_ID) << 17n | BigInt(this._processId & MAX_PROCESS_ID) << 12n | BigInt(increment & MAX_INCREMENT);
+    return res;
   }
   /**
    * Generates a Snowflake ID as a `Uint8Array` buffer.
@@ -187,23 +219,10 @@ class Snowflake {
         `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
       );
     }
-    var increment = this._increment;
+    this._timestamp = timestamp - this._epoch;
+    this._packBuffer(this);
     this._increment = this._increment + 1 & MAX_INCREMENT;
-    var timestampDelta = timestamp - this._epoch;
-    var timestampHigh = Math.floor(timestampDelta / 4294967295);
-    var timestampLow = timestampDelta >>> 0;
-    var high32 = (timestampHigh << 22 | timestampLow >>> 10) >>> 0;
-    var low32 = (timestampLow << 22 | this._workerId << 17 | this._processId << 12 | increment & MAX_INCREMENT) >>> 0;
-    var buffer = this._buffer;
-    buffer[0] = high32 >>> 24;
-    buffer[1] = high32 >>> 16;
-    buffer[2] = high32 >>> 8;
-    buffer[3] = high32;
-    buffer[4] = low32 >>> 24;
-    buffer[5] = low32 >>> 16;
-    buffer[6] = low32 >>> 8;
-    buffer[7] = low32;
-    return buffer;
+    return this.__buf;
   }
   /**
    * Generates a snowflake given an epoch and optionally a timestamp
@@ -215,8 +234,17 @@ class Snowflake {
    * @returns A unique snowflake as Uint8Array
    */
   generateBuffer(timestamp = Date.now()) {
-    this.generateBufferUnsafe(timestamp);
-    return new Uint8Array(this._buffer);
+    if (timestamp instanceof Date) timestamp = timestamp.getTime();
+    if (!toolkit.isNumber(timestamp)) {
+      throw new Error(
+        `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
+      );
+    }
+    this.__buf = new Uint8Array(8);
+    this._timestamp = timestamp - this._epoch;
+    this._packBuffer(this);
+    this._increment = this._increment + 1 & MAX_INCREMENT;
+    return this.__buf;
   }
   /**
    * Deconstructs a snowflake given a snowflake ID
@@ -229,23 +257,20 @@ class Snowflake {
    * ```
    */
   deconstruct(id) {
-    var high32, low32;
-    if (id instanceof Uint8Array) {
-      high32 = (id[0] << 24 | id[1] << 16 | id[2] << 8 | id[3]) >>> 0;
-      low32 = (id[4] << 24 | id[5] << 16 | id[6] << 8 | id[7]) >>> 0;
-    } else if (toolkit.isBigInt(id)) {
-      return this.deconstruct(toolkit.bigIntBytes(id));
+    if (toolkit.isString(id)) {
+      id = BigInt(id);
+    }
+    let result;
+    if (toolkit.isBigInt(id)) {
+      result = this._unpackBigInt(id);
+      result.id = id;
     } else {
-      return this.deconstruct(toolkit.bigIntBytes(BigInt(id)));
+      result = this._unpackBuffer(id);
+      result.id = toolkit.bigIntFromBytes(id);
     }
-    return {
-      id: BigInt(high32) * 0x100000000n + BigInt(low32),
-      timestamp: high32 * 1024 + (low32 >>> 22) + this._epoch,
-      workerId: low32 >>> 17 & MAX_WORKER_ID,
-      processId: low32 >>> 12 & MAX_PROCESS_ID,
-      increment: low32 & MAX_INCREMENT,
-      epoch: this._epoch
-    };
+    result.timestamp += this._epoch;
+    result.epoch = this._epoch;
+    return result;
   }
   /**
    * Retrieves the timestamp field's value from a snowflake.
@@ -253,12 +278,7 @@ class Snowflake {
    * @returns The UNIX timestamp that is stored in `id`.
    */
   timestampFrom(id) {
-    if (toolkit.isString(id) || toolkit.isBigInt(id)) {
-      return this.timestampFrom(Snowflake.bufferFrom(id));
-    }
-    var high32 = (id[0] << 24 | id[1] << 16 | id[2] << 8 | id[3]) >>> 0;
-    var low32 = (id[4] << 24 | id[5] << 16 | id[6] << 8 | id[7]) >>> 0;
-    return high32 * 1024 + (low32 >>> 22) + this._epoch;
+    return this.deconstruct(id).timestamp;
   }
   /**
    * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given
@@ -285,15 +305,19 @@ class Snowflake {
    */
   static bufferFrom(value) {
     if (toolkit.isString(value)) value = BigInt(value);
-    var buf = toolkit.bigIntBytes(value);
-    var bufSize = buf.byteLength;
-    if (buf.byteLength < 8) {
-      var buf2 = new Uint8Array(8);
-      buf2.set(buf, 8 - bufSize);
-      buf = buf2;
-    }
-    return buf;
+    return new Uint8Array(bigintToBuffer(value));
+  }
+}
+function bigintToBuffer(value) {
+  if (value < 0n) {
+    value = value * -1n;
+  }
+  for (var i = 0; i < 8; i++) {
+    ENCODE_BIGINT_BUFFER[i] = Number(
+      value >> BigInt((8 - i - 1) * 8) & 0xffn
+    );
   }
+  return ENCODE_BIGINT_BUFFER;
 }
 
 exports.MAX_INCREMENT = MAX_INCREMENT;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/Snowflake.ts"],"sourcesContent":["/**\n * Based on: https://github.com/sapphiredev/utilities/blob/main/packages/snowflake/src/lib/Snowflake.ts\n */\nimport {\n  type AnyFunction,\n  assert,\n  bigIntBytes,\n  bigIntFromBytes,\n  isBigInt,\n  isDate,\n  isNumber,\n  isString,\n  timestampMs,\n} from '@andrew_l/toolkit';\n\n/**\n * Object returned by Snowflake#deconstruct\n */\nexport interface DeconstructedSnowflake {\n  /**\n   * The id as a number\n   */\n  id: bigint;\n\n  /**\n   * The timestamp stored in the snowflake\n   */\n  timestamp: number;\n\n  /**\n   * The worker id stored in the snowflake\n   */\n  workerId: number;\n\n  /**\n   * The process id stored in the snowflake\n   */\n  processId: number;\n\n  /**\n   * The increment stored in the snowflake\n   */\n  increment: number;\n\n  /**\n   * The epoch to use in the snowflake\n   */\n  epoch: number;\n}\n\n/**\n * Options for Snowflake\n */\nexport interface SnowflakeOptions {\n  /**\n   * Timestamp or date of the snowflake to generate\n   */\n  epoch: number | bigint | Date;\n\n  /**\n   * The increment to use\n   * @default 0\n   * @remark keep in mind that this number is auto-incremented between generate calls\n   */\n  increment?: number | bigint;\n\n  /**\n   * The worker ID to use, will be truncated to 5 bits (0-31)\n   * @default 0\n   */\n  workerId?: number | bigint;\n\n  /**\n   * The process ID to use, will be truncated to 5 bits (0-31)\n   * @default 1\n   */\n  processId?: number | bigint;\n}\n\n/**\n * The maximum value the `workerId` field accepts in snowflakes.\n */\nexport var MAX_WORKER_ID = 0x1f;\n\n/**\n * The maximum value the `processId` field accepts in snowflakes.\n */\nexport var MAX_PROCESS_ID = 0x1f;\n\n/**\n * The maximum value the `increment` field accepts in snowflakes.\n */\nexport var MAX_INCREMENT = 0xfff;\n\n/**\n * A class for generating and deconstructing Twitter snowflakes.\n *\n * A {@link https://developer.twitter.com/en/docs/twitter-ids Twitter snowflake}\n * is a 64-bit unsigned integer with 4 fields that have a fixed epoch value.\n *\n * If we have a snowflake `266241948824764416` we can represent it as binary:\n * ```\n * 64                                          22     17     12          0\n * 000000111011000111100001101001000101000000  00001  00000  000000000000\n *          number of ms since epoch           worker  pid    increment\n * ```\n *\n * @group Main\n */\nexport class Snowflake {\n  /**\n   * Alias for {@link deconstruct}\n   */\n  public decode = this.deconstruct;\n\n  /**\n   * Internal reference of the epoch passed in the constructor\n   * @internal\n   */\n  private readonly _epoch: number;\n\n  /**\n   * Internal incrementor for generating snowflakes\n   * @internal\n   */\n  private _increment = 0;\n\n  /**\n   * The process ID that will be used by default in the generate method\n   * @internal\n   */\n  private _processId = 1;\n\n  /**\n   * The worker ID that will be used by default in the generate method\n   * @internal\n   */\n  private _workerId = 0;\n\n  /**\n   * @internal\n   */\n  private _buffer: Uint8Array;\n\n  /**\n   * @param epoch the epoch to use\n   */\n  public constructor(opts: SnowflakeOptions | Date | number | bigint) {\n    if (isDate(opts) || isNumber(opts)) {\n      this._epoch = timestampMs(opts);\n    } else if (isBigInt(opts)) {\n      this._epoch = timestampMs(Number(opts));\n    } else {\n      const { increment = 0, processId = 1, workerId = 0, epoch } = opts;\n      this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);\n      this.workerId = workerId;\n      this.processId = processId;\n      this.increment = increment;\n    }\n\n    this._buffer = new Uint8Array(8);\n  }\n\n  /**\n   * The epoch for this snowflake, as a number\n   */\n  public get epoch(): number {\n    return this._epoch;\n  }\n\n  /**\n   * Gets the configured process ID\n   */\n  public get processId(): number {\n    return this._processId;\n  }\n\n  /**\n   * Sets the process ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set processId(value: number | bigint) {\n    this._processId = Number(value) & MAX_PROCESS_ID;\n  }\n\n  /**\n   * Gets the configured worker ID\n   */\n  public get workerId(): number {\n    return this._workerId;\n  }\n\n  /**\n   * Sets the worker ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set workerId(value: number | bigint) {\n    this._workerId = Number(value) & MAX_WORKER_ID;\n  }\n\n  /**\n   * Get incrementor for generating snowflakes\n   */\n  public get increment(): number {\n    return this._increment;\n  }\n\n  /**\n   * Sets the incrementor for generating snowflakes that will be used by default for the {@link generate} method\n   * @param value The new value\n   */\n  public set increment(value: number | bigint) {\n    this._increment = Number(value) & MAX_INCREMENT;\n  }\n\n  private _createSavePoint(): AnyFunction {\n    var increment = this._increment;\n    var workerId = this._workerId;\n    var processId = this._processId;\n\n    return () => {\n      this._increment = increment;\n      this._workerId = workerId;\n      this._processId = processId;\n    };\n  }\n\n  /**\n   * Sets most lowest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setLowest(): void {\n    this._increment = 0;\n    this._workerId = 0;\n    this._processId = 0;\n  }\n\n  /**\n   * Sets most highest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setHighest(): void {\n    this._increment = MAX_INCREMENT;\n    this._workerId = MAX_WORKER_ID;\n    this._processId = MAX_PROCESS_ID;\n  }\n\n  /**\n   * Execute a function in context of most lowest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the lowest possible id for that epoch\n   * ```\n   */\n  withLowest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withLowest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n    this.setLowest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Execute a function in context of most highest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the highest possible id for that epoch\n   * ```\n   */\n  withHighest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withHighest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n\n    this.setHighest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Generates a Snowflake ID as bigint.\n   */\n  public generate(timestamp: Date | number = Date.now()): bigint {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    var increment = this._increment;\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return (\n      (BigInt(timestamp - this._epoch) << 22n) |\n      (BigInt(this._workerId & MAX_WORKER_ID) << 17n) |\n      (BigInt(this._processId & MAX_PROCESS_ID) << 12n) |\n      BigInt(increment & MAX_INCREMENT)\n    );\n  }\n\n  /**\n   * Generates a Snowflake ID as a `Uint8Array` buffer.\n   *\n   * ⚠️ Returns a reference to the **same** internal `Uint8Array` instance.\n   * Its contents may be overwritten on the next ID generation call.\n   *\n   * This method is intended for high-performance scenarios where you\n   * immediately transform the buffer (e.g., to base62) before calling again.\n   * Avoid storing or mutating the returned buffer directly.\n   */\n  public generateBufferUnsafe(\n    timestamp: Date | number = Date.now(),\n  ): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    var increment = this._increment;\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    // Calculate the timestamp delta\n    var timestampDelta = timestamp - this._epoch;\n\n    // Split into 32-bit parts for bitwise operations\n    var timestampHigh = Math.floor(timestampDelta / 0xffffffff);\n    var timestampLow = timestampDelta >>> 0;\n\n    var high32 = ((timestampHigh << 22) | (timestampLow >>> 10)) >>> 0;\n    var low32 =\n      ((timestampLow << 22) |\n        (this._workerId << 17) |\n        (this._processId << 12) |\n        (increment & MAX_INCREMENT)) >>>\n      0;\n\n    var buffer = this._buffer;\n\n    buffer[0] = high32 >>> 24;\n    buffer[1] = high32 >>> 16;\n    buffer[2] = high32 >>> 8;\n    buffer[3] = high32;\n    buffer[4] = low32 >>> 24;\n    buffer[5] = low32 >>> 16;\n    buffer[6] = low32 >>> 8;\n    buffer[7] = low32;\n\n    return buffer;\n  }\n\n  /**\n   * Generates a snowflake given an epoch and optionally a timestamp\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake({ epoch }).generate();\n   * ```\n   * @returns A unique snowflake as Uint8Array\n   */\n  public generateBuffer(timestamp: Date | number = Date.now()): Uint8Array {\n    this.generateBufferUnsafe(timestamp);\n    return new Uint8Array(this._buffer);\n  }\n\n  /**\n   * Deconstructs a snowflake given a snowflake ID\n   * @param id the snowflake to deconstruct\n   * @returns a deconstructed snowflake\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake(epoch).deconstruct('3971046231244935168');\n   * ```\n   */\n  public deconstruct(id: string | bigint | Uint8Array): DeconstructedSnowflake {\n    var high32: number, low32: number;\n\n    if (id instanceof Uint8Array) {\n      // Convert from Uint8Array\n      high32 = ((id[0] << 24) | (id[1] << 16) | (id[2] << 8) | id[3]) >>> 0;\n      low32 = ((id[4] << 24) | (id[5] << 16) | (id[6] << 8) | id[7]) >>> 0;\n    } else if (isBigInt(id)) {\n      return this.deconstruct(bigIntBytes(id));\n    } else {\n      // Convert from string\n      return this.deconstruct(bigIntBytes(BigInt(id)));\n    }\n\n    return {\n      id: BigInt(high32) * 0x100000000n + BigInt(low32),\n      timestamp: high32 * 0x400 + (low32 >>> 22) + this._epoch,\n      workerId: (low32 >>> 17) & MAX_WORKER_ID,\n      processId: (low32 >>> 12) & MAX_PROCESS_ID,\n      increment: low32 & MAX_INCREMENT,\n      epoch: this._epoch,\n    };\n  }\n\n  /**\n   * Retrieves the timestamp field's value from a snowflake.\n   * @param id The snowflake to get the timestamp value from.\n   * @returns The UNIX timestamp that is stored in `id`.\n   */\n  public timestampFrom(id: string | bigint | Uint8Array): number {\n    if (isString(id) || isBigInt(id)) {\n      return this.timestampFrom(Snowflake.bufferFrom(id));\n    }\n\n    var high32 = ((id[0] << 24) | (id[1] << 16) | (id[2] << 8) | id[3]) >>> 0;\n    var low32 = ((id[4] << 24) | (id[5] << 16) | (id[6] << 8) | id[7]) >>> 0;\n\n    return high32 * 0x400 + (low32 >>> 22) + this._epoch;\n  }\n\n  /**\n   * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given\n   * snowflake in sort order.\n   * @param a The first snowflake to compare.\n   * @param b The second snowflake to compare.\n   * @returns `-1` if `a` is older than `b`, `0` if `a` and `b` are equals, `1` if `a` is newer than `b`.\n   */\n  public static compare(\n    a: string | bigint | Uint8Array,\n    b: string | bigint | Uint8Array,\n  ): -1 | 0 | 1 {\n    if (isString(a)) {\n      a = BigInt(a);\n    } else if (a instanceof Uint8Array) {\n      a = bigIntFromBytes(a);\n    }\n\n    if (isString(b)) {\n      b = BigInt(b);\n    } else if (b instanceof Uint8Array) {\n      b = bigIntFromBytes(b);\n    }\n\n    return a === b ? 0 : a < b ? -1 : 1;\n  }\n\n  /**\n   * Parse value as Uint8Array buffer\n   */\n  public static bufferFrom(value: bigint | string): Uint8Array {\n    if (isString(value)) value = BigInt(value);\n\n    var buf = bigIntBytes(value);\n    var bufSize = buf.byteLength;\n\n    // Add padding\n    if (buf.byteLength < 8) {\n      var buf2 = new Uint8Array(8);\n      buf2.set(buf, 8 - bufSize);\n      buf = buf2;\n    }\n\n    return buf;\n  }\n}\n"],"names":["isDate","isNumber","timestampMs","isBigInt","assert","bigIntBytes","isString","bigIntFromBytes"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/Snowflake.ts"],"sourcesContent":["/**\n * Based on: https://github.com/sapphiredev/utilities/blob/main/packages/snowflake/src/lib/Snowflake.ts\n */\nimport {\n  type AnyFunction,\n  type BitPack,\n  type BitUnpack,\n  assert,\n  bigIntFromBytes,\n  bitPack,\n  bitUnpack,\n  isBigInt,\n  isDate,\n  isNumber,\n  isString,\n  timestampMs,\n} from '@andrew_l/toolkit';\n\n/**\n * Object returned by Snowflake#deconstruct\n */\nexport interface DeconstructedSnowflake {\n  /**\n   * The id as a number\n   */\n  id: bigint;\n\n  /**\n   * The timestamp stored in the snowflake\n   */\n  timestamp: number;\n\n  /**\n   * The worker id stored in the snowflake\n   */\n  workerId: number;\n\n  /**\n   * The process id stored in the snowflake\n   */\n  processId: number;\n\n  /**\n   * The increment stored in the snowflake\n   */\n  increment: number;\n\n  /**\n   * The epoch to use in the snowflake\n   */\n  epoch: number;\n}\n\n/**\n * Options for Snowflake\n */\nexport interface SnowflakeOptions {\n  /**\n   * Timestamp or date of the snowflake to generate\n   */\n  epoch: number | bigint | Date;\n\n  /**\n   * The increment to use\n   * @default 0\n   * @remark keep in mind that this number is auto-incremented between generate calls\n   */\n  increment?: number | bigint;\n\n  /**\n   * The worker ID to use, will be truncated to 5 bits (0-31)\n   * @default 0\n   */\n  workerId?: number | bigint;\n\n  /**\n   * The process ID to use, will be truncated to 5 bits (0-31)\n   * @default 1\n   */\n  processId?: number | bigint;\n}\n\n/**\n * The maximum value the `workerId` field accepts in snowflakes.\n */\nexport var MAX_WORKER_ID = 0x1f;\n\n/**\n * The maximum value the `processId` field accepts in snowflakes.\n */\nexport var MAX_PROCESS_ID = 0x1f;\n\n/**\n * The maximum value the `increment` field accepts in snowflakes.\n */\nexport var MAX_INCREMENT = 0xfff;\n\nvar ENCODE_BIGINT_BUFFER = new Uint8Array(8);\n\n/**\n * A class for generating and deconstructing Twitter snowflakes.\n *\n * A {@link https://developer.twitter.com/en/docs/twitter-ids Twitter snowflake}\n * is a 64-bit unsigned integer with 4 fields that have a fixed epoch value.\n *\n * If we have a snowflake `266241948824764416` we can represent it as binary:\n * ```\n * 64                                          22     17     12          0\n * 000000111011000111100001101001000101000000  00001  00000  000000000000\n *          number of ms since epoch           worker  pid    increment\n * ```\n *\n * @group Main\n */\nexport class Snowflake {\n  /**\n   * Alias for {@link deconstruct}\n   */\n  public decode = this.deconstruct;\n\n  /**\n   * Internal reference of the epoch passed in the constructor\n   * @internal\n   */\n  private readonly _epoch: number;\n\n  /**\n   * Internal incrementor for generating snowflakes\n   * @internal\n   */\n  private _increment = 0;\n\n  /**\n   * The process ID that will be used by default in the generate method\n   * @internal\n   */\n  private _processId = 1;\n\n  /**\n   * The worker ID that will be used by default in the generate method\n   * @internal\n   */\n  private _workerId = 0;\n\n  /**\n   * @internal\n   */\n  private _timestamp = 0;\n\n  private __buf: Uint8Array;\n\n  private _packBuffer: BitPack.Fn.Buffer<\n    '_timestamp' | '_workerId' | '_processId' | '_increment'\n  >;\n\n  private _packBigInt: BitPack.Fn.BigInt<\n    '_timestamp' | '_workerId' | '_processId' | '_increment'\n  >;\n\n  private _unpackBuffer: BitUnpack.Fn.Buffer<\n    'timestamp' | 'workerId' | 'processId' | 'increment'\n  >;\n\n  private _unpackBigInt: BitUnpack.Fn.BigInt<\n    'timestamp' | 'workerId' | 'processId' | 'increment'\n  >;\n\n  /**\n   * @param epoch the epoch to use\n   */\n  public constructor(opts: SnowflakeOptions | Date | number | bigint) {\n    if (isDate(opts) || isNumber(opts)) {\n      this._epoch = timestampMs(opts);\n    } else if (isBigInt(opts)) {\n      this._epoch = timestampMs(Number(opts));\n    } else {\n      const { increment = 0, processId = 1, workerId = 0, epoch } = opts;\n      this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);\n      this.workerId = workerId;\n      this.processId = processId;\n      this.increment = increment;\n    }\n\n    const packer = bitPack({\n      totalBits: 64,\n      fields: [\n        { name: '_timestamp', bits: 42, take: 'low' },\n        { name: '_workerId', bits: 5, take: 'low' },\n        { name: '_processId', bits: 5, take: 'low' },\n        { name: '_increment', bits: 12, take: 'low' },\n      ],\n      optimize: true,\n      debug: true,\n    });\n\n    const unpacker = bitUnpack({\n      totalBits: 64,\n      fields: [\n        { name: 'timestamp', bits: 42, take: 'low' },\n        { name: 'workerId', bits: 5, take: 'low' },\n        { name: 'processId', bits: 5, take: 'low' },\n        { name: 'increment', bits: 12, take: 'low' },\n      ],\n      debug: true,\n    });\n\n    this.__buf = new Uint8Array(8);\n    this._packBigInt = packer.bigint;\n    this._packBuffer = packer.buffer;\n    this._unpackBigInt = unpacker.bigint;\n    this._unpackBuffer = unpacker.buffer;\n  }\n\n  /**\n   * The epoch for this snowflake, as a number\n   */\n  public get epoch(): number {\n    return this._epoch;\n  }\n\n  /**\n   * Gets the configured process ID\n   */\n  public get processId(): number {\n    return this._processId;\n  }\n\n  /**\n   * Sets the process ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set processId(value: number | bigint) {\n    this._processId = Number(value) & MAX_PROCESS_ID;\n  }\n\n  /**\n   * Gets the configured worker ID\n   */\n  public get workerId(): number {\n    return this._workerId;\n  }\n\n  /**\n   * Sets the worker ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set workerId(value: number | bigint) {\n    this._workerId = Number(value) & MAX_WORKER_ID;\n  }\n\n  /**\n   * Get incrementor for generating snowflakes\n   */\n  public get increment(): number {\n    return this._increment;\n  }\n\n  /**\n   * Sets the incrementor for generating snowflakes that will be used by default for the {@link generate} method\n   * @param value The new value\n   */\n  public set increment(value: number | bigint) {\n    this._increment = Number(value) & MAX_INCREMENT;\n  }\n\n  private _createSavePoint(): AnyFunction {\n    var increment = this._increment;\n    var workerId = this._workerId;\n    var processId = this._processId;\n\n    return () => {\n      this._increment = increment;\n      this._workerId = workerId;\n      this._processId = processId;\n    };\n  }\n\n  /**\n   * Sets most lowest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setLowest(): void {\n    this._increment = 0;\n    this._workerId = 0;\n    this._processId = 0;\n  }\n\n  /**\n   * Sets most highest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setHighest(): void {\n    this._increment = MAX_INCREMENT;\n    this._workerId = MAX_WORKER_ID;\n    this._processId = MAX_PROCESS_ID;\n  }\n\n  /**\n   * Execute a function in context of most lowest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the lowest possible id for that epoch\n   * ```\n   */\n  withLowest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withLowest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n    this.setLowest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Execute a function in context of most highest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the highest possible id for that epoch\n   * ```\n   */\n  withHighest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withHighest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n\n    this.setHighest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Generates a Snowflake ID as bigint.\n   */\n  public generate(timestamp: Date | number = Date.now()): bigint {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this._timestamp = timestamp - this._epoch;\n    var res = this._packBigInt(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return res;\n  }\n\n  /**\n   * Generates a Snowflake ID as a `Uint8Array` buffer.\n   *\n   * ⚠️ Returns a reference to the **same** internal `Uint8Array` instance.\n   * Its contents may be overwritten on the next ID generation call.\n   *\n   * This method is intended for high-performance scenarios where you\n   * immediately transform the buffer (e.g., to base62) before calling again.\n   * Avoid storing or mutating the returned buffer directly.\n   */\n  public generateBufferUnsafe(\n    timestamp: Date | number = Date.now(),\n  ): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this._timestamp = timestamp - this._epoch;\n    this._packBuffer(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return this.__buf;\n  }\n\n  /**\n   * Generates a snowflake given an epoch and optionally a timestamp\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake({ epoch }).generate();\n   * ```\n   * @returns A unique snowflake as Uint8Array\n   */\n  public generateBuffer(timestamp: Date | number = Date.now()): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this.__buf = new Uint8Array(8);\n    this._timestamp = timestamp - this._epoch;\n    this._packBuffer(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return this.__buf;\n  }\n\n  /**\n   * Deconstructs a snowflake given a snowflake ID\n   * @param id the snowflake to deconstruct\n   * @returns a deconstructed snowflake\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake(epoch).deconstruct('3971046231244935168');\n   * ```\n   */\n  public deconstruct(id: string | bigint | Uint8Array): DeconstructedSnowflake {\n    if (isString(id)) {\n      id = BigInt(id);\n    }\n\n    let result: DeconstructedSnowflake;\n\n    if (isBigInt(id)) {\n      result = this._unpackBigInt(id) as DeconstructedSnowflake;\n      result.id = id;\n    } else {\n      result = this._unpackBuffer(id) as DeconstructedSnowflake;\n      result.id = bigIntFromBytes(id);\n    }\n\n    result.timestamp += this._epoch;\n    result.epoch = this._epoch;\n\n    return result;\n  }\n\n  /**\n   * Retrieves the timestamp field's value from a snowflake.\n   * @param id The snowflake to get the timestamp value from.\n   * @returns The UNIX timestamp that is stored in `id`.\n   */\n  public timestampFrom(id: string | bigint | Uint8Array): number {\n    return this.deconstruct(id).timestamp;\n  }\n\n  /**\n   * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given\n   * snowflake in sort order.\n   * @param a The first snowflake to compare.\n   * @param b The second snowflake to compare.\n   * @returns `-1` if `a` is older than `b`, `0` if `a` and `b` are equals, `1` if `a` is newer than `b`.\n   */\n  public static compare(\n    a: string | bigint | Uint8Array,\n    b: string | bigint | Uint8Array,\n  ): -1 | 0 | 1 {\n    if (isString(a)) {\n      a = BigInt(a);\n    } else if (a instanceof Uint8Array) {\n      a = bigIntFromBytes(a);\n    }\n\n    if (isString(b)) {\n      b = BigInt(b);\n    } else if (b instanceof Uint8Array) {\n      b = bigIntFromBytes(b);\n    }\n\n    return a === b ? 0 : a < b ? -1 : 1;\n  }\n\n  /**\n   * Parse value as Uint8Array buffer\n   */\n  public static bufferFrom(value: bigint | string): Uint8Array {\n    if (isString(value)) value = BigInt(value);\n\n    return new Uint8Array(bigintToBuffer(value));\n  }\n}\n\nfunction bigintToBuffer(value: bigint): Uint8Array {\n  if (value < 0n) {\n    value = value * -1n;\n  }\n  for (var i = 0; i < 8; i++) {\n    ENCODE_BIGINT_BUFFER[i] = Number(\n      (value >> BigInt((8 - i - 1) * 8)) & 0xffn,\n    );\n  }\n  return ENCODE_BIGINT_BUFFER;\n}\n"],"names":["isDate","isNumber","timestampMs","isBigInt","bitPack","bitUnpack","assert","isString","bigIntFromBytes"],"mappings":"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"}

package/dist/index.d.cts

@@ -107,7 +107,12 @@ declare class Snowflake {
     /**
      * @internal
      */
-    private _buffer;
+    private _timestamp;
+    private __buf;
+    private _packBuffer;
+    private _packBigInt;
+    private _unpackBuffer;
+    private _unpackBigInt;
     /**
      * @param epoch the epoch to use
      */

package/dist/index.d.mts

@@ -107,7 +107,12 @@ declare class Snowflake {
     /**
      * @internal
      */
-    private _buffer;
+    private _timestamp;
+    private __buf;
+    private _packBuffer;
+    private _packBigInt;
+    private _unpackBuffer;
+    private _unpackBigInt;
     /**
      * @param epoch the epoch to use
      */

package/dist/index.d.ts

@@ -107,7 +107,12 @@ declare class Snowflake {
     /**
      * @internal
      */
-    private _buffer;
+    private _timestamp;
+    private __buf;
+    private _packBuffer;
+    private _packBigInt;
+    private _unpackBuffer;
+    private _unpackBigInt;
     /**
      * @param epoch the epoch to use
      */

package/dist/index.mjs

@@ -1,8 +1,9 @@
-import { isDate, isNumber, timestampMs, isBigInt, assert, bigIntBytes, isString, bigIntFromBytes } from '@andrew_l/toolkit';
+import { isDate, isNumber, timestampMs, isBigInt, bitPack, bitUnpack, assert, isString, bigIntFromBytes } from '@andrew_l/toolkit';
 
 var MAX_WORKER_ID = 31;
 var MAX_PROCESS_ID = 31;
 var MAX_INCREMENT = 4095;
+var ENCODE_BIGINT_BUFFER = new Uint8Array(8);
 class Snowflake {
   /**
    * Alias for {@link deconstruct}
@@ -31,7 +32,12 @@ class Snowflake {
   /**
    * @internal
    */
-  _buffer;
+  _timestamp = 0;
+  __buf;
+  _packBuffer;
+  _packBigInt;
+  _unpackBuffer;
+  _unpackBigInt;
   /**
    * @param epoch the epoch to use
    */
@@ -47,7 +53,32 @@ class Snowflake {
       this.processId = processId;
       this.increment = increment;
     }
-    this._buffer = new Uint8Array(8);
+    const packer = bitPack({
+      totalBits: 64,
+      fields: [
+        { name: "_timestamp", bits: 42, take: "low" },
+        { name: "_workerId", bits: 5, take: "low" },
+        { name: "_processId", bits: 5, take: "low" },
+        { name: "_increment", bits: 12, take: "low" }
+      ],
+      optimize: true,
+      debug: true
+    });
+    const unpacker = bitUnpack({
+      totalBits: 64,
+      fields: [
+        { name: "timestamp", bits: 42, take: "low" },
+        { name: "workerId", bits: 5, take: "low" },
+        { name: "processId", bits: 5, take: "low" },
+        { name: "increment", bits: 12, take: "low" }
+      ],
+      debug: true
+    });
+    this.__buf = new Uint8Array(8);
+    this._packBigInt = packer.bigint;
+    this._packBuffer = packer.buffer;
+    this._unpackBigInt = unpacker.bigint;
+    this._unpackBuffer = unpacker.buffer;
   }
   /**
    * The epoch for this snowflake, as a number
@@ -164,9 +195,10 @@ class Snowflake {
         `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
       );
     }
-    var increment = this._increment;
+    this._timestamp = timestamp - this._epoch;
+    var res = this._packBigInt(this);
     this._increment = this._increment + 1 & MAX_INCREMENT;
-    return BigInt(timestamp - this._epoch) << 22n | BigInt(this._workerId & MAX_WORKER_ID) << 17n | BigInt(this._processId & MAX_PROCESS_ID) << 12n | BigInt(increment & MAX_INCREMENT);
+    return res;
   }
   /**
    * Generates a Snowflake ID as a `Uint8Array` buffer.
@@ -185,23 +217,10 @@ class Snowflake {
         `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
       );
     }
-    var increment = this._increment;
+    this._timestamp = timestamp - this._epoch;
+    this._packBuffer(this);
     this._increment = this._increment + 1 & MAX_INCREMENT;
-    var timestampDelta = timestamp - this._epoch;
-    var timestampHigh = Math.floor(timestampDelta / 4294967295);
-    var timestampLow = timestampDelta >>> 0;
-    var high32 = (timestampHigh << 22 | timestampLow >>> 10) >>> 0;
-    var low32 = (timestampLow << 22 | this._workerId << 17 | this._processId << 12 | increment & MAX_INCREMENT) >>> 0;
-    var buffer = this._buffer;
-    buffer[0] = high32 >>> 24;
-    buffer[1] = high32 >>> 16;
-    buffer[2] = high32 >>> 8;
-    buffer[3] = high32;
-    buffer[4] = low32 >>> 24;
-    buffer[5] = low32 >>> 16;
-    buffer[6] = low32 >>> 8;
-    buffer[7] = low32;
-    return buffer;
+    return this.__buf;
   }
   /**
    * Generates a snowflake given an epoch and optionally a timestamp
@@ -213,8 +232,17 @@ class Snowflake {
    * @returns A unique snowflake as Uint8Array
    */
   generateBuffer(timestamp = Date.now()) {
-    this.generateBufferUnsafe(timestamp);
-    return new Uint8Array(this._buffer);
+    if (timestamp instanceof Date) timestamp = timestamp.getTime();
+    if (!isNumber(timestamp)) {
+      throw new Error(
+        `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
+      );
+    }
+    this.__buf = new Uint8Array(8);
+    this._timestamp = timestamp - this._epoch;
+    this._packBuffer(this);
+    this._increment = this._increment + 1 & MAX_INCREMENT;
+    return this.__buf;
   }
   /**
    * Deconstructs a snowflake given a snowflake ID
@@ -227,23 +255,20 @@ class Snowflake {
    * ```
    */
   deconstruct(id) {
-    var high32, low32;
-    if (id instanceof Uint8Array) {
-      high32 = (id[0] << 24 | id[1] << 16 | id[2] << 8 | id[3]) >>> 0;
-      low32 = (id[4] << 24 | id[5] << 16 | id[6] << 8 | id[7]) >>> 0;
-    } else if (isBigInt(id)) {
-      return this.deconstruct(bigIntBytes(id));
+    if (isString(id)) {
+      id = BigInt(id);
+    }
+    let result;
+    if (isBigInt(id)) {
+      result = this._unpackBigInt(id);
+      result.id = id;
     } else {
-      return this.deconstruct(bigIntBytes(BigInt(id)));
+      result = this._unpackBuffer(id);
+      result.id = bigIntFromBytes(id);
     }
-    return {
-      id: BigInt(high32) * 0x100000000n + BigInt(low32),
-      timestamp: high32 * 1024 + (low32 >>> 22) + this._epoch,
-      workerId: low32 >>> 17 & MAX_WORKER_ID,
-      processId: low32 >>> 12 & MAX_PROCESS_ID,
-      increment: low32 & MAX_INCREMENT,
-      epoch: this._epoch
-    };
+    result.timestamp += this._epoch;
+    result.epoch = this._epoch;
+    return result;
   }
   /**
    * Retrieves the timestamp field's value from a snowflake.
@@ -251,12 +276,7 @@ class Snowflake {
    * @returns The UNIX timestamp that is stored in `id`.
    */
   timestampFrom(id) {
-    if (isString(id) || isBigInt(id)) {
-      return this.timestampFrom(Snowflake.bufferFrom(id));
-    }
-    var high32 = (id[0] << 24 | id[1] << 16 | id[2] << 8 | id[3]) >>> 0;
-    var low32 = (id[4] << 24 | id[5] << 16 | id[6] << 8 | id[7]) >>> 0;
-    return high32 * 1024 + (low32 >>> 22) + this._epoch;
+    return this.deconstruct(id).timestamp;
   }
   /**
    * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given
@@ -283,15 +303,19 @@ class Snowflake {
    */
   static bufferFrom(value) {
     if (isString(value)) value = BigInt(value);
-    var buf = bigIntBytes(value);
-    var bufSize = buf.byteLength;
-    if (buf.byteLength < 8) {
-      var buf2 = new Uint8Array(8);
-      buf2.set(buf, 8 - bufSize);
-      buf = buf2;
-    }
-    return buf;
+    return new Uint8Array(bigintToBuffer(value));
+  }
+}
+function bigintToBuffer(value) {
+  if (value < 0n) {
+    value = value * -1n;
+  }
+  for (var i = 0; i < 8; i++) {
+    ENCODE_BIGINT_BUFFER[i] = Number(
+      value >> BigInt((8 - i - 1) * 8) & 0xffn
+    );
   }
+  return ENCODE_BIGINT_BUFFER;
 }
 
 export { MAX_INCREMENT, MAX_PROCESS_ID, MAX_WORKER_ID, Snowflake };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/Snowflake.ts"],"sourcesContent":["/**\n * Based on: https://github.com/sapphiredev/utilities/blob/main/packages/snowflake/src/lib/Snowflake.ts\n */\nimport {\n  type AnyFunction,\n  assert,\n  bigIntBytes,\n  bigIntFromBytes,\n  isBigInt,\n  isDate,\n  isNumber,\n  isString,\n  timestampMs,\n} from '@andrew_l/toolkit';\n\n/**\n * Object returned by Snowflake#deconstruct\n */\nexport interface DeconstructedSnowflake {\n  /**\n   * The id as a number\n   */\n  id: bigint;\n\n  /**\n   * The timestamp stored in the snowflake\n   */\n  timestamp: number;\n\n  /**\n   * The worker id stored in the snowflake\n   */\n  workerId: number;\n\n  /**\n   * The process id stored in the snowflake\n   */\n  processId: number;\n\n  /**\n   * The increment stored in the snowflake\n   */\n  increment: number;\n\n  /**\n   * The epoch to use in the snowflake\n   */\n  epoch: number;\n}\n\n/**\n * Options for Snowflake\n */\nexport interface SnowflakeOptions {\n  /**\n   * Timestamp or date of the snowflake to generate\n   */\n  epoch: number | bigint | Date;\n\n  /**\n   * The increment to use\n   * @default 0\n   * @remark keep in mind that this number is auto-incremented between generate calls\n   */\n  increment?: number | bigint;\n\n  /**\n   * The worker ID to use, will be truncated to 5 bits (0-31)\n   * @default 0\n   */\n  workerId?: number | bigint;\n\n  /**\n   * The process ID to use, will be truncated to 5 bits (0-31)\n   * @default 1\n   */\n  processId?: number | bigint;\n}\n\n/**\n * The maximum value the `workerId` field accepts in snowflakes.\n */\nexport var MAX_WORKER_ID = 0x1f;\n\n/**\n * The maximum value the `processId` field accepts in snowflakes.\n */\nexport var MAX_PROCESS_ID = 0x1f;\n\n/**\n * The maximum value the `increment` field accepts in snowflakes.\n */\nexport var MAX_INCREMENT = 0xfff;\n\n/**\n * A class for generating and deconstructing Twitter snowflakes.\n *\n * A {@link https://developer.twitter.com/en/docs/twitter-ids Twitter snowflake}\n * is a 64-bit unsigned integer with 4 fields that have a fixed epoch value.\n *\n * If we have a snowflake `266241948824764416` we can represent it as binary:\n * ```\n * 64                                          22     17     12          0\n * 000000111011000111100001101001000101000000  00001  00000  000000000000\n *          number of ms since epoch           worker  pid    increment\n * ```\n *\n * @group Main\n */\nexport class Snowflake {\n  /**\n   * Alias for {@link deconstruct}\n   */\n  public decode = this.deconstruct;\n\n  /**\n   * Internal reference of the epoch passed in the constructor\n   * @internal\n   */\n  private readonly _epoch: number;\n\n  /**\n   * Internal incrementor for generating snowflakes\n   * @internal\n   */\n  private _increment = 0;\n\n  /**\n   * The process ID that will be used by default in the generate method\n   * @internal\n   */\n  private _processId = 1;\n\n  /**\n   * The worker ID that will be used by default in the generate method\n   * @internal\n   */\n  private _workerId = 0;\n\n  /**\n   * @internal\n   */\n  private _buffer: Uint8Array;\n\n  /**\n   * @param epoch the epoch to use\n   */\n  public constructor(opts: SnowflakeOptions | Date | number | bigint) {\n    if (isDate(opts) || isNumber(opts)) {\n      this._epoch = timestampMs(opts);\n    } else if (isBigInt(opts)) {\n      this._epoch = timestampMs(Number(opts));\n    } else {\n      const { increment = 0, processId = 1, workerId = 0, epoch } = opts;\n      this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);\n      this.workerId = workerId;\n      this.processId = processId;\n      this.increment = increment;\n    }\n\n    this._buffer = new Uint8Array(8);\n  }\n\n  /**\n   * The epoch for this snowflake, as a number\n   */\n  public get epoch(): number {\n    return this._epoch;\n  }\n\n  /**\n   * Gets the configured process ID\n   */\n  public get processId(): number {\n    return this._processId;\n  }\n\n  /**\n   * Sets the process ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set processId(value: number | bigint) {\n    this._processId = Number(value) & MAX_PROCESS_ID;\n  }\n\n  /**\n   * Gets the configured worker ID\n   */\n  public get workerId(): number {\n    return this._workerId;\n  }\n\n  /**\n   * Sets the worker ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set workerId(value: number | bigint) {\n    this._workerId = Number(value) & MAX_WORKER_ID;\n  }\n\n  /**\n   * Get incrementor for generating snowflakes\n   */\n  public get increment(): number {\n    return this._increment;\n  }\n\n  /**\n   * Sets the incrementor for generating snowflakes that will be used by default for the {@link generate} method\n   * @param value The new value\n   */\n  public set increment(value: number | bigint) {\n    this._increment = Number(value) & MAX_INCREMENT;\n  }\n\n  private _createSavePoint(): AnyFunction {\n    var increment = this._increment;\n    var workerId = this._workerId;\n    var processId = this._processId;\n\n    return () => {\n      this._increment = increment;\n      this._workerId = workerId;\n      this._processId = processId;\n    };\n  }\n\n  /**\n   * Sets most lowest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setLowest(): void {\n    this._increment = 0;\n    this._workerId = 0;\n    this._processId = 0;\n  }\n\n  /**\n   * Sets most highest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setHighest(): void {\n    this._increment = MAX_INCREMENT;\n    this._workerId = MAX_WORKER_ID;\n    this._processId = MAX_PROCESS_ID;\n  }\n\n  /**\n   * Execute a function in context of most lowest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the lowest possible id for that epoch\n   * ```\n   */\n  withLowest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withLowest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n    this.setLowest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Execute a function in context of most highest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the highest possible id for that epoch\n   * ```\n   */\n  withHighest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withHighest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n\n    this.setHighest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Generates a Snowflake ID as bigint.\n   */\n  public generate(timestamp: Date | number = Date.now()): bigint {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    var increment = this._increment;\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return (\n      (BigInt(timestamp - this._epoch) << 22n) |\n      (BigInt(this._workerId & MAX_WORKER_ID) << 17n) |\n      (BigInt(this._processId & MAX_PROCESS_ID) << 12n) |\n      BigInt(increment & MAX_INCREMENT)\n    );\n  }\n\n  /**\n   * Generates a Snowflake ID as a `Uint8Array` buffer.\n   *\n   * ⚠️ Returns a reference to the **same** internal `Uint8Array` instance.\n   * Its contents may be overwritten on the next ID generation call.\n   *\n   * This method is intended for high-performance scenarios where you\n   * immediately transform the buffer (e.g., to base62) before calling again.\n   * Avoid storing or mutating the returned buffer directly.\n   */\n  public generateBufferUnsafe(\n    timestamp: Date | number = Date.now(),\n  ): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    var increment = this._increment;\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    // Calculate the timestamp delta\n    var timestampDelta = timestamp - this._epoch;\n\n    // Split into 32-bit parts for bitwise operations\n    var timestampHigh = Math.floor(timestampDelta / 0xffffffff);\n    var timestampLow = timestampDelta >>> 0;\n\n    var high32 = ((timestampHigh << 22) | (timestampLow >>> 10)) >>> 0;\n    var low32 =\n      ((timestampLow << 22) |\n        (this._workerId << 17) |\n        (this._processId << 12) |\n        (increment & MAX_INCREMENT)) >>>\n      0;\n\n    var buffer = this._buffer;\n\n    buffer[0] = high32 >>> 24;\n    buffer[1] = high32 >>> 16;\n    buffer[2] = high32 >>> 8;\n    buffer[3] = high32;\n    buffer[4] = low32 >>> 24;\n    buffer[5] = low32 >>> 16;\n    buffer[6] = low32 >>> 8;\n    buffer[7] = low32;\n\n    return buffer;\n  }\n\n  /**\n   * Generates a snowflake given an epoch and optionally a timestamp\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake({ epoch }).generate();\n   * ```\n   * @returns A unique snowflake as Uint8Array\n   */\n  public generateBuffer(timestamp: Date | number = Date.now()): Uint8Array {\n    this.generateBufferUnsafe(timestamp);\n    return new Uint8Array(this._buffer);\n  }\n\n  /**\n   * Deconstructs a snowflake given a snowflake ID\n   * @param id the snowflake to deconstruct\n   * @returns a deconstructed snowflake\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake(epoch).deconstruct('3971046231244935168');\n   * ```\n   */\n  public deconstruct(id: string | bigint | Uint8Array): DeconstructedSnowflake {\n    var high32: number, low32: number;\n\n    if (id instanceof Uint8Array) {\n      // Convert from Uint8Array\n      high32 = ((id[0] << 24) | (id[1] << 16) | (id[2] << 8) | id[3]) >>> 0;\n      low32 = ((id[4] << 24) | (id[5] << 16) | (id[6] << 8) | id[7]) >>> 0;\n    } else if (isBigInt(id)) {\n      return this.deconstruct(bigIntBytes(id));\n    } else {\n      // Convert from string\n      return this.deconstruct(bigIntBytes(BigInt(id)));\n    }\n\n    return {\n      id: BigInt(high32) * 0x100000000n + BigInt(low32),\n      timestamp: high32 * 0x400 + (low32 >>> 22) + this._epoch,\n      workerId: (low32 >>> 17) & MAX_WORKER_ID,\n      processId: (low32 >>> 12) & MAX_PROCESS_ID,\n      increment: low32 & MAX_INCREMENT,\n      epoch: this._epoch,\n    };\n  }\n\n  /**\n   * Retrieves the timestamp field's value from a snowflake.\n   * @param id The snowflake to get the timestamp value from.\n   * @returns The UNIX timestamp that is stored in `id`.\n   */\n  public timestampFrom(id: string | bigint | Uint8Array): number {\n    if (isString(id) || isBigInt(id)) {\n      return this.timestampFrom(Snowflake.bufferFrom(id));\n    }\n\n    var high32 = ((id[0] << 24) | (id[1] << 16) | (id[2] << 8) | id[3]) >>> 0;\n    var low32 = ((id[4] << 24) | (id[5] << 16) | (id[6] << 8) | id[7]) >>> 0;\n\n    return high32 * 0x400 + (low32 >>> 22) + this._epoch;\n  }\n\n  /**\n   * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given\n   * snowflake in sort order.\n   * @param a The first snowflake to compare.\n   * @param b The second snowflake to compare.\n   * @returns `-1` if `a` is older than `b`, `0` if `a` and `b` are equals, `1` if `a` is newer than `b`.\n   */\n  public static compare(\n    a: string | bigint | Uint8Array,\n    b: string | bigint | Uint8Array,\n  ): -1 | 0 | 1 {\n    if (isString(a)) {\n      a = BigInt(a);\n    } else if (a instanceof Uint8Array) {\n      a = bigIntFromBytes(a);\n    }\n\n    if (isString(b)) {\n      b = BigInt(b);\n    } else if (b instanceof Uint8Array) {\n      b = bigIntFromBytes(b);\n    }\n\n    return a === b ? 0 : a < b ? -1 : 1;\n  }\n\n  /**\n   * Parse value as Uint8Array buffer\n   */\n  public static bufferFrom(value: bigint | string): Uint8Array {\n    if (isString(value)) value = BigInt(value);\n\n    var buf = bigIntBytes(value);\n    var bufSize = buf.byteLength;\n\n    // Add padding\n    if (buf.byteLength < 8) {\n      var buf2 = new Uint8Array(8);\n      buf2.set(buf, 8 - bufSize);\n      buf = buf2;\n    }\n\n    return buf;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/Snowflake.ts"],"sourcesContent":["/**\n * Based on: https://github.com/sapphiredev/utilities/blob/main/packages/snowflake/src/lib/Snowflake.ts\n */\nimport {\n  type AnyFunction,\n  type BitPack,\n  type BitUnpack,\n  assert,\n  bigIntFromBytes,\n  bitPack,\n  bitUnpack,\n  isBigInt,\n  isDate,\n  isNumber,\n  isString,\n  timestampMs,\n} from '@andrew_l/toolkit';\n\n/**\n * Object returned by Snowflake#deconstruct\n */\nexport interface DeconstructedSnowflake {\n  /**\n   * The id as a number\n   */\n  id: bigint;\n\n  /**\n   * The timestamp stored in the snowflake\n   */\n  timestamp: number;\n\n  /**\n   * The worker id stored in the snowflake\n   */\n  workerId: number;\n\n  /**\n   * The process id stored in the snowflake\n   */\n  processId: number;\n\n  /**\n   * The increment stored in the snowflake\n   */\n  increment: number;\n\n  /**\n   * The epoch to use in the snowflake\n   */\n  epoch: number;\n}\n\n/**\n * Options for Snowflake\n */\nexport interface SnowflakeOptions {\n  /**\n   * Timestamp or date of the snowflake to generate\n   */\n  epoch: number | bigint | Date;\n\n  /**\n   * The increment to use\n   * @default 0\n   * @remark keep in mind that this number is auto-incremented between generate calls\n   */\n  increment?: number | bigint;\n\n  /**\n   * The worker ID to use, will be truncated to 5 bits (0-31)\n   * @default 0\n   */\n  workerId?: number | bigint;\n\n  /**\n   * The process ID to use, will be truncated to 5 bits (0-31)\n   * @default 1\n   */\n  processId?: number | bigint;\n}\n\n/**\n * The maximum value the `workerId` field accepts in snowflakes.\n */\nexport var MAX_WORKER_ID = 0x1f;\n\n/**\n * The maximum value the `processId` field accepts in snowflakes.\n */\nexport var MAX_PROCESS_ID = 0x1f;\n\n/**\n * The maximum value the `increment` field accepts in snowflakes.\n */\nexport var MAX_INCREMENT = 0xfff;\n\nvar ENCODE_BIGINT_BUFFER = new Uint8Array(8);\n\n/**\n * A class for generating and deconstructing Twitter snowflakes.\n *\n * A {@link https://developer.twitter.com/en/docs/twitter-ids Twitter snowflake}\n * is a 64-bit unsigned integer with 4 fields that have a fixed epoch value.\n *\n * If we have a snowflake `266241948824764416` we can represent it as binary:\n * ```\n * 64                                          22     17     12          0\n * 000000111011000111100001101001000101000000  00001  00000  000000000000\n *          number of ms since epoch           worker  pid    increment\n * ```\n *\n * @group Main\n */\nexport class Snowflake {\n  /**\n   * Alias for {@link deconstruct}\n   */\n  public decode = this.deconstruct;\n\n  /**\n   * Internal reference of the epoch passed in the constructor\n   * @internal\n   */\n  private readonly _epoch: number;\n\n  /**\n   * Internal incrementor for generating snowflakes\n   * @internal\n   */\n  private _increment = 0;\n\n  /**\n   * The process ID that will be used by default in the generate method\n   * @internal\n   */\n  private _processId = 1;\n\n  /**\n   * The worker ID that will be used by default in the generate method\n   * @internal\n   */\n  private _workerId = 0;\n\n  /**\n   * @internal\n   */\n  private _timestamp = 0;\n\n  private __buf: Uint8Array;\n\n  private _packBuffer: BitPack.Fn.Buffer<\n    '_timestamp' | '_workerId' | '_processId' | '_increment'\n  >;\n\n  private _packBigInt: BitPack.Fn.BigInt<\n    '_timestamp' | '_workerId' | '_processId' | '_increment'\n  >;\n\n  private _unpackBuffer: BitUnpack.Fn.Buffer<\n    'timestamp' | 'workerId' | 'processId' | 'increment'\n  >;\n\n  private _unpackBigInt: BitUnpack.Fn.BigInt<\n    'timestamp' | 'workerId' | 'processId' | 'increment'\n  >;\n\n  /**\n   * @param epoch the epoch to use\n   */\n  public constructor(opts: SnowflakeOptions | Date | number | bigint) {\n    if (isDate(opts) || isNumber(opts)) {\n      this._epoch = timestampMs(opts);\n    } else if (isBigInt(opts)) {\n      this._epoch = timestampMs(Number(opts));\n    } else {\n      const { increment = 0, processId = 1, workerId = 0, epoch } = opts;\n      this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);\n      this.workerId = workerId;\n      this.processId = processId;\n      this.increment = increment;\n    }\n\n    const packer = bitPack({\n      totalBits: 64,\n      fields: [\n        { name: '_timestamp', bits: 42, take: 'low' },\n        { name: '_workerId', bits: 5, take: 'low' },\n        { name: '_processId', bits: 5, take: 'low' },\n        { name: '_increment', bits: 12, take: 'low' },\n      ],\n      optimize: true,\n      debug: true,\n    });\n\n    const unpacker = bitUnpack({\n      totalBits: 64,\n      fields: [\n        { name: 'timestamp', bits: 42, take: 'low' },\n        { name: 'workerId', bits: 5, take: 'low' },\n        { name: 'processId', bits: 5, take: 'low' },\n        { name: 'increment', bits: 12, take: 'low' },\n      ],\n      debug: true,\n    });\n\n    this.__buf = new Uint8Array(8);\n    this._packBigInt = packer.bigint;\n    this._packBuffer = packer.buffer;\n    this._unpackBigInt = unpacker.bigint;\n    this._unpackBuffer = unpacker.buffer;\n  }\n\n  /**\n   * The epoch for this snowflake, as a number\n   */\n  public get epoch(): number {\n    return this._epoch;\n  }\n\n  /**\n   * Gets the configured process ID\n   */\n  public get processId(): number {\n    return this._processId;\n  }\n\n  /**\n   * Sets the process ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set processId(value: number | bigint) {\n    this._processId = Number(value) & MAX_PROCESS_ID;\n  }\n\n  /**\n   * Gets the configured worker ID\n   */\n  public get workerId(): number {\n    return this._workerId;\n  }\n\n  /**\n   * Sets the worker ID that will be used by default for the {@link generate} method\n   * @param value The new value, will be masked with `0b11111`\n   */\n  public set workerId(value: number | bigint) {\n    this._workerId = Number(value) & MAX_WORKER_ID;\n  }\n\n  /**\n   * Get incrementor for generating snowflakes\n   */\n  public get increment(): number {\n    return this._increment;\n  }\n\n  /**\n   * Sets the incrementor for generating snowflakes that will be used by default for the {@link generate} method\n   * @param value The new value\n   */\n  public set increment(value: number | bigint) {\n    this._increment = Number(value) & MAX_INCREMENT;\n  }\n\n  private _createSavePoint(): AnyFunction {\n    var increment = this._increment;\n    var workerId = this._workerId;\n    var processId = this._processId;\n\n    return () => {\n      this._increment = increment;\n      this._workerId = workerId;\n      this._processId = processId;\n    };\n  }\n\n  /**\n   * Sets most lowest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setLowest(): void {\n    this._increment = 0;\n    this._workerId = 0;\n    this._processId = 0;\n  }\n\n  /**\n   * Sets most highest values for generating snowflakes that will be used by default for the {@link generate} method\n   */\n  setHighest(): void {\n    this._increment = MAX_INCREMENT;\n    this._workerId = MAX_WORKER_ID;\n    this._processId = MAX_PROCESS_ID;\n  }\n\n  /**\n   * Execute a function in context of most lowest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the lowest possible id for that epoch\n   * ```\n   */\n  withLowest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withLowest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n    this.setLowest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Execute a function in context of most highest values for generating snowflakes\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake();\n   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the highest possible id for that epoch\n   * ```\n   */\n  withHighest<Result = undefined>(fn: (instance: Snowflake) => Result): Result {\n    assert.fn(fn, 'withHighest expected a function as first argument');\n\n    var reset = this._createSavePoint();\n\n    this.setHighest();\n\n    var result = fn(this);\n    reset();\n\n    return result;\n  }\n\n  /**\n   * Generates a Snowflake ID as bigint.\n   */\n  public generate(timestamp: Date | number = Date.now()): bigint {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this._timestamp = timestamp - this._epoch;\n    var res = this._packBigInt(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return res;\n  }\n\n  /**\n   * Generates a Snowflake ID as a `Uint8Array` buffer.\n   *\n   * ⚠️ Returns a reference to the **same** internal `Uint8Array` instance.\n   * Its contents may be overwritten on the next ID generation call.\n   *\n   * This method is intended for high-performance scenarios where you\n   * immediately transform the buffer (e.g., to base62) before calling again.\n   * Avoid storing or mutating the returned buffer directly.\n   */\n  public generateBufferUnsafe(\n    timestamp: Date | number = Date.now(),\n  ): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this._timestamp = timestamp - this._epoch;\n    this._packBuffer(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return this.__buf;\n  }\n\n  /**\n   * Generates a snowflake given an epoch and optionally a timestamp\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake({ epoch }).generate();\n   * ```\n   * @returns A unique snowflake as Uint8Array\n   */\n  public generateBuffer(timestamp: Date | number = Date.now()): Uint8Array {\n    if (timestamp instanceof Date) timestamp = timestamp.getTime();\n    if (!isNumber(timestamp)) {\n      throw new Error(\n        `\"timestamp\" argument must be a number or Date (received ${typeof timestamp})`,\n      );\n    }\n\n    this.__buf = new Uint8Array(8);\n    this._timestamp = timestamp - this._epoch;\n    this._packBuffer(this as any);\n    this._increment = (this._increment + 1) & MAX_INCREMENT;\n\n    return this.__buf;\n  }\n\n  /**\n   * Deconstructs a snowflake given a snowflake ID\n   * @param id the snowflake to deconstruct\n   * @returns a deconstructed snowflake\n   * @example\n   * ```typescript\n   * const epoch = new Date('2000-01-01T00:00:00.000Z');\n   * const snowflake = new Snowflake(epoch).deconstruct('3971046231244935168');\n   * ```\n   */\n  public deconstruct(id: string | bigint | Uint8Array): DeconstructedSnowflake {\n    if (isString(id)) {\n      id = BigInt(id);\n    }\n\n    let result: DeconstructedSnowflake;\n\n    if (isBigInt(id)) {\n      result = this._unpackBigInt(id) as DeconstructedSnowflake;\n      result.id = id;\n    } else {\n      result = this._unpackBuffer(id) as DeconstructedSnowflake;\n      result.id = bigIntFromBytes(id);\n    }\n\n    result.timestamp += this._epoch;\n    result.epoch = this._epoch;\n\n    return result;\n  }\n\n  /**\n   * Retrieves the timestamp field's value from a snowflake.\n   * @param id The snowflake to get the timestamp value from.\n   * @returns The UNIX timestamp that is stored in `id`.\n   */\n  public timestampFrom(id: string | bigint | Uint8Array): number {\n    return this.deconstruct(id).timestamp;\n  }\n\n  /**\n   * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given\n   * snowflake in sort order.\n   * @param a The first snowflake to compare.\n   * @param b The second snowflake to compare.\n   * @returns `-1` if `a` is older than `b`, `0` if `a` and `b` are equals, `1` if `a` is newer than `b`.\n   */\n  public static compare(\n    a: string | bigint | Uint8Array,\n    b: string | bigint | Uint8Array,\n  ): -1 | 0 | 1 {\n    if (isString(a)) {\n      a = BigInt(a);\n    } else if (a instanceof Uint8Array) {\n      a = bigIntFromBytes(a);\n    }\n\n    if (isString(b)) {\n      b = BigInt(b);\n    } else if (b instanceof Uint8Array) {\n      b = bigIntFromBytes(b);\n    }\n\n    return a === b ? 0 : a < b ? -1 : 1;\n  }\n\n  /**\n   * Parse value as Uint8Array buffer\n   */\n  public static bufferFrom(value: bigint | string): Uint8Array {\n    if (isString(value)) value = BigInt(value);\n\n    return new Uint8Array(bigintToBuffer(value));\n  }\n}\n\nfunction bigintToBuffer(value: bigint): Uint8Array {\n  if (value < 0n) {\n    value = value * -1n;\n  }\n  for (var i = 0; i < 8; i++) {\n    ENCODE_BIGINT_BUFFER[i] = Number(\n      (value >> BigInt((8 - i - 1) * 8)) & 0xffn,\n    );\n  }\n  return ENCODE_BIGINT_BUFFER;\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrew_l/snowflake",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Another implementation of snowflake id generator.",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "dist"
   ],
   "dependencies": {
-    "@andrew_l/toolkit": "0.3.2"
+    "@andrew_l/toolkit": "0.3.4"
   },
   "devDependencies": {
     "@sapphire/snowflake": "^3.5.5",