@andrew_l/snowflake 0.2.21 → 0.3.0

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  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 = Number(increment) & MAX_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   * Generates a Snowflake ID as a `Uint8Array` buffer.\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(timestamp: Date | number = Date.now()) {\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()) {\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","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  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 = Number(increment) & MAX_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   * Generates a Snowflake ID as a `Uint8Array` buffer.\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(timestamp: Date | number = Date.now()) {\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()) {\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","bigIntBytes","isString","bigIntFromBytes"],"mappings":"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"}

package/dist/index.d.cts

@@ -148,7 +148,7 @@ declare class Snowflake {
      * immediately transform the buffer (e.g., to base62) before calling again.
      * Avoid storing or mutating the returned buffer directly.
      */
-    generateBufferUnsafe(timestamp?: Date | number): Uint8Array;
+    generateBufferUnsafe(timestamp?: Date | number): Uint8Array<ArrayBufferLike>;
     /**
      * Generates a snowflake given an epoch and optionally a timestamp
      * @example
@@ -158,7 +158,7 @@ declare class Snowflake {
      * ```
      * @returns A unique snowflake as Uint8Array
      */
-    generateBuffer(timestamp?: Date | number): Uint8Array;
+    generateBuffer(timestamp?: Date | number): Uint8Array<ArrayBuffer>;
     /**
      * Deconstructs a snowflake given a snowflake ID
      * @param id the snowflake to deconstruct

package/dist/index.d.mts

@@ -148,7 +148,7 @@ declare class Snowflake {
      * immediately transform the buffer (e.g., to base62) before calling again.
      * Avoid storing or mutating the returned buffer directly.
      */
-    generateBufferUnsafe(timestamp?: Date | number): Uint8Array;
+    generateBufferUnsafe(timestamp?: Date | number): Uint8Array<ArrayBufferLike>;
     /**
      * Generates a snowflake given an epoch and optionally a timestamp
      * @example
@@ -158,7 +158,7 @@ declare class Snowflake {
      * ```
      * @returns A unique snowflake as Uint8Array
      */
-    generateBuffer(timestamp?: Date | number): Uint8Array;
+    generateBuffer(timestamp?: Date | number): Uint8Array<ArrayBuffer>;
     /**
      * Deconstructs a snowflake given a snowflake ID
      * @param id the snowflake to deconstruct

package/dist/index.d.ts

@@ -148,7 +148,7 @@ declare class Snowflake {
      * immediately transform the buffer (e.g., to base62) before calling again.
      * Avoid storing or mutating the returned buffer directly.
      */
-    generateBufferUnsafe(timestamp?: Date | number): Uint8Array;
+    generateBufferUnsafe(timestamp?: Date | number): Uint8Array<ArrayBufferLike>;
     /**
      * Generates a snowflake given an epoch and optionally a timestamp
      * @example
@@ -158,7 +158,7 @@ declare class Snowflake {
      * ```
      * @returns A unique snowflake as Uint8Array
      */
-    generateBuffer(timestamp?: Date | number): Uint8Array;
+    generateBuffer(timestamp?: Date | number): Uint8Array<ArrayBuffer>;
     /**
      * Deconstructs a snowflake given a snowflake ID
      * @param id the snowflake to deconstruct

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  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 = Number(increment) & MAX_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   * Generates a Snowflake ID as a `Uint8Array` buffer.\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(timestamp: Date | number = Date.now()) {\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()) {\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  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 = Number(increment) & MAX_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   * Generates a Snowflake ID as a `Uint8Array` buffer.\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(timestamp: Date | number = Date.now()) {\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()) {\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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrew_l/snowflake",
-  "version": "0.2.21",
+  "version": "0.3.0",
   "description": "Another implementation of snowflake id generator.",
   "license": "MIT",
   "type": "module",
@@ -28,16 +28,17 @@
     "dist"
   ],
   "dependencies": {
-    "@andrew_l/toolkit": "0.2.21"
+    "@andrew_l/toolkit": "0.3.0"
   },
   "devDependencies": {
     "@sapphire/snowflake": "^3.5.5",
     "@types/node": "22.10.5",
-    "typescript": "~5.6.2",
-    "unbuild": "3.0.0-rc.11",
-    "vitest": "^2.1.3"
+    "typescript": "~5.8.3",
+    "unbuild": "3.5.0",
+    "vitest": "^3.2.4"
   },
   "scripts": {
+    "check-types": "tsc --noEmit",
     "build": "unbuild",
     "test": "vitest run --typecheck",
     "test:watch": "vitest watch --typecheck",