@andrew_l/snowflake 0.3.21 → 0.4.0

package/dist/index.mjs

@@ -1,298 +1,205 @@
-import { isDate, isNumber, timestampMs, isBigInt, assert, bigIntBytes, isString, bigIntFromBytes } from '@andrew_l/toolkit';
-
+import { assert, bigIntFromBytes, bitPack, bitUnpack, isBigInt, isDate, isNumber, isString, timestampMs } from "@andrew_l/toolkit";
 var MAX_WORKER_ID = 31;
 var MAX_PROCESS_ID = 31;
 var MAX_INCREMENT = 4095;
-class Snowflake {
-  /**
-   * Alias for {@link deconstruct}
-   */
-  decode = this.deconstruct;
-  /**
-   * Internal reference of the epoch passed in the constructor
-   * @internal
-   */
-  _epoch;
-  /**
-   * Internal incrementor for generating snowflakes
-   * @internal
-   */
-  _increment = 0;
-  /**
-   * The process ID that will be used by default in the generate method
-   * @internal
-   */
-  _processId = 1;
-  /**
-   * The worker ID that will be used by default in the generate method
-   * @internal
-   */
-  _workerId = 0;
-  /**
-   * @internal
-   */
-  _buffer;
-  /**
-   * @param epoch the epoch to use
-   */
-  constructor(opts) {
-    if (isDate(opts) || isNumber(opts)) {
-      this._epoch = timestampMs(opts);
-    } else if (isBigInt(opts)) {
-      this._epoch = timestampMs(Number(opts));
-    } else {
-      const { increment = 0, processId = 1, workerId = 0, epoch } = opts;
-      this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);
-      this.workerId = workerId;
-      this.processId = processId;
-      this.increment = increment;
-    }
-    this._buffer = new Uint8Array(8);
-  }
-  /**
-   * The epoch for this snowflake, as a number
-   */
-  get epoch() {
-    return this._epoch;
-  }
-  /**
-   * Gets the configured process ID
-   */
-  get processId() {
-    return this._processId;
-  }
-  /**
-   * Sets the process ID that will be used by default for the {@link generate} method
-   * @param value The new value, will be masked with `0b11111`
-   */
-  set processId(value) {
-    this._processId = Number(value) & MAX_PROCESS_ID;
-  }
-  /**
-   * Gets the configured worker ID
-   */
-  get workerId() {
-    return this._workerId;
-  }
-  /**
-   * Sets the worker ID that will be used by default for the {@link generate} method
-   * @param value The new value, will be masked with `0b11111`
-   */
-  set workerId(value) {
-    this._workerId = Number(value) & MAX_WORKER_ID;
-  }
-  /**
-   * Get incrementor for generating snowflakes
-   */
-  get increment() {
-    return this._increment;
-  }
-  /**
-   * Sets the incrementor for generating snowflakes that will be used by default for the {@link generate} method
-   * @param value The new value
-   */
-  set increment(value) {
-    this._increment = Number(value) & MAX_INCREMENT;
-  }
-  _createSavePoint() {
-    var increment = this._increment;
-    var workerId = this._workerId;
-    var processId = this._processId;
-    return () => {
-      this._increment = increment;
-      this._workerId = workerId;
-      this._processId = processId;
-    };
-  }
-  /**
-   * Sets most lowest values for generating snowflakes that will be used by default for the {@link generate} method
-   */
-  setLowest() {
-    this._increment = 0;
-    this._workerId = 0;
-    this._processId = 0;
-  }
-  /**
-   * Sets most highest values for generating snowflakes that will be used by default for the {@link generate} method
-   */
-  setHighest() {
-    this._increment = MAX_INCREMENT;
-    this._workerId = MAX_WORKER_ID;
-    this._processId = MAX_PROCESS_ID;
-  }
-  /**
-   * Execute a function in context of most lowest values for generating snowflakes
-   * @example
-   * ```typescript
-   * const epoch = new Date('2000-01-01T00:00:00.000Z');
-   * const snowflake = new Snowflake();
-   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the lowest possible id for that epoch
-   * ```
-   */
-  withLowest(fn) {
-    assert.fn(fn, "withLowest expected a function as first argument");
-    var reset = this._createSavePoint();
-    this.setLowest();
-    var result = fn(this);
-    reset();
-    return result;
-  }
-  /**
-   * Execute a function in context of most highest values for generating snowflakes
-   * @example
-   * ```typescript
-   * const epoch = new Date('2000-01-01T00:00:00.000Z');
-   * const snowflake = new Snowflake();
-   * const id = snowflake.withLowest((v) => v.generate(epoch)); // the highest possible id for that epoch
-   * ```
-   */
-  withHighest(fn) {
-    assert.fn(fn, "withHighest expected a function as first argument");
-    var reset = this._createSavePoint();
-    this.setHighest();
-    var result = fn(this);
-    reset();
-    return result;
-  }
-  /**
-   * Generates a Snowflake ID as bigint.
-   */
-  generate(timestamp = Date.now()) {
-    if (timestamp instanceof Date) timestamp = timestamp.getTime();
-    if (!isNumber(timestamp)) {
-      throw new Error(
-        `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
-      );
-    }
-    var increment = this._increment;
-    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);
-  }
-  /**
-   * Generates a Snowflake ID as a `Uint8Array` buffer.
-   *
-   * ⚠️ Returns a reference to the **same** internal `Uint8Array` instance.
-   * Its contents may be overwritten on the next ID generation call.
-   *
-   * This method is intended for high-performance scenarios where you
-   * immediately transform the buffer (e.g., to base62) before calling again.
-   * Avoid storing or mutating the returned buffer directly.
-   */
-  generateBufferUnsafe(timestamp = Date.now()) {
-    if (timestamp instanceof Date) timestamp = timestamp.getTime();
-    if (!isNumber(timestamp)) {
-      throw new Error(
-        `"timestamp" argument must be a number or Date (received ${typeof timestamp})`
-      );
-    }
-    var increment = this._increment;
-    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;
-  }
-  /**
-   * Generates a snowflake given an epoch and optionally a timestamp
-   * @example
-   * ```typescript
-   * const epoch = new Date('2000-01-01T00:00:00.000Z');
-   * const snowflake = new Snowflake({ epoch }).generate();
-   * ```
-   * @returns A unique snowflake as Uint8Array
-   */
-  generateBuffer(timestamp = Date.now()) {
-    this.generateBufferUnsafe(timestamp);
-    return new Uint8Array(this._buffer);
-  }
-  /**
-   * Deconstructs a snowflake given a snowflake ID
-   * @param id the snowflake to deconstruct
-   * @returns a deconstructed snowflake
-   * @example
-   * ```typescript
-   * const epoch = new Date('2000-01-01T00:00:00.000Z');
-   * const snowflake = new Snowflake(epoch).deconstruct('3971046231244935168');
-   * ```
-   */
-  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));
-    } else {
-      return this.deconstruct(bigIntBytes(BigInt(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
-    };
-  }
-  /**
-   * Retrieves the timestamp field's value from a snowflake.
-   * @param id The snowflake to get the timestamp value from.
-   * @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;
-  }
-  /**
-   * Returns a number indicating whether a reference snowflake comes before, or after, or is same as the given
-   * snowflake in sort order.
-   * @param a The first snowflake to compare.
-   * @param b The second snowflake to compare.
-   * @returns `-1` if `a` is older than `b`, `0` if `a` and `b` are equals, `1` if `a` is newer than `b`.
-   */
-  static compare(a, b) {
-    if (isString(a)) {
-      a = BigInt(a);
-    } else if (a instanceof Uint8Array) {
-      a = bigIntFromBytes(a);
-    }
-    if (isString(b)) {
-      b = BigInt(b);
-    } else if (b instanceof Uint8Array) {
-      b = bigIntFromBytes(b);
-    }
-    return a === b ? 0 : a < b ? -1 : 1;
-  }
-  /**
-   * Parse value as Uint8Array buffer
-   */
-  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;
-  }
+var ENCODE_BIGINT_BUFFER = /* @__PURE__ */ new Uint8Array(8);
+var Snowflake = class {
+	decode = this.deconstruct;
+	_epoch;
+	_increment = 0;
+	_processId = 1;
+	_workerId = 0;
+	_timestamp = 0;
+	__buf;
+	_packBuffer;
+	_packBigInt;
+	_unpackBuffer;
+	_unpackBigInt;
+	constructor(opts) {
+		if (isDate(opts) || isNumber(opts)) this._epoch = timestampMs(opts);
+		else if (isBigInt(opts)) this._epoch = timestampMs(Number(opts));
+		else {
+			const { increment = 0, processId = 1, workerId = 0, epoch } = opts;
+			this._epoch = timestampMs(isBigInt(epoch) ? Number(epoch) : epoch);
+			this.workerId = workerId;
+			this.processId = processId;
+			this.increment = increment;
+		}
+		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 = /* @__PURE__ */ new Uint8Array(8);
+		this._packBigInt = packer.bigint;
+		this._packBuffer = packer.buffer;
+		this._unpackBigInt = unpacker.bigint;
+		this._unpackBuffer = unpacker.buffer;
+	}
+	get epoch() {
+		return this._epoch;
+	}
+	get processId() {
+		return this._processId;
+	}
+	set processId(value) {
+		this._processId = Number(value) & 31;
+	}
+	get workerId() {
+		return this._workerId;
+	}
+	set workerId(value) {
+		this._workerId = Number(value) & 31;
+	}
+	get increment() {
+		return this._increment;
+	}
+	set increment(value) {
+		this._increment = Number(value) & MAX_INCREMENT;
+	}
+	_createSavePoint() {
+		var increment = this._increment;
+		var workerId = this._workerId;
+		var processId = this._processId;
+		return () => {
+			this._increment = increment;
+			this._workerId = workerId;
+			this._processId = processId;
+		};
+	}
+	setLowest() {
+		this._increment = 0;
+		this._workerId = 0;
+		this._processId = 0;
+	}
+	setHighest() {
+		this._increment = MAX_INCREMENT;
+		this._workerId = 31;
+		this._processId = 31;
+	}
+	withLowest(fn) {
+		assert.fn(fn, "withLowest expected a function as first argument");
+		var reset = this._createSavePoint();
+		this.setLowest();
+		var result = fn(this);
+		reset();
+		return result;
+	}
+	withHighest(fn) {
+		assert.fn(fn, "withHighest expected a function as first argument");
+		var reset = this._createSavePoint();
+		this.setHighest();
+		var result = fn(this);
+		reset();
+		return result;
+	}
+	generate(timestamp = Date.now()) {
+		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._timestamp = timestamp - this._epoch;
+		var res = this._packBigInt(this);
+		this._increment = this._increment + 1 & MAX_INCREMENT;
+		return res;
+	}
+	generateBufferUnsafe(timestamp = Date.now()) {
+		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._timestamp = timestamp - this._epoch;
+		this._packBuffer(this);
+		this._increment = this._increment + 1 & MAX_INCREMENT;
+		return this.__buf;
+	}
+	generateBuffer(timestamp = Date.now()) {
+		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 = /* @__PURE__ */ new Uint8Array(8);
+		this._timestamp = timestamp - this._epoch;
+		this._packBuffer(this);
+		this._increment = this._increment + 1 & MAX_INCREMENT;
+		return this.__buf;
+	}
+	deconstruct(id) {
+		if (isString(id)) id = BigInt(id);
+		let result;
+		if (isBigInt(id)) {
+			result = this._unpackBigInt(id);
+			result.id = id;
+		} else {
+			result = this._unpackBuffer(id);
+			result.id = bigIntFromBytes(id);
+		}
+		result.timestamp += this._epoch;
+		result.epoch = this._epoch;
+		return result;
+	}
+	timestampFrom(id) {
+		return this.deconstruct(id).timestamp;
+	}
+	static compare(a, b) {
+		if (isString(a)) a = BigInt(a);
+		else if (a instanceof Uint8Array) a = bigIntFromBytes(a);
+		if (isString(b)) b = BigInt(b);
+		else if (b instanceof Uint8Array) b = bigIntFromBytes(b);
+		return a === b ? 0 : a < b ? -1 : 1;
+	}
+	static bufferFrom(value) {
+		if (isString(value)) value = BigInt(value);
+		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) & 255n);
+	return ENCODE_BIGINT_BUFFER;
 }
-
 export { MAX_INCREMENT, MAX_PROCESS_ID, MAX_WORKER_ID, Snowflake };
-//# sourceMappingURL=index.mjs.map
+
+//# sourceMappingURL=index.mjs.map

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","names":[],"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"],"mappings":";;;AAqFA,IAAW,gBAAgB;;;;;CAY3B,aAAI;;;;;;;;;;;;OAiBS;;;;GAIJ,KAAA,YAAc;;;;;GAMJ,QAAA;;;;;IAMT;;;;;IAMA;;;;;IAMA;;;;KAKA,MAAA;IAEA;GAEA;GAIA,UAAA;GAIA,OAAA;EAIA,CAAA;;;;IAOD;KACL,MAAI;WAEO;WAEJ;IACL;IACA;KACA,MAAK;KACL,MAAK;KACL,MAAK;IACP;IAEA;KACE,MAAA;KACA,MAAQ;KACN,MAAA;;;KAAgC,MAAM;KAAM,MAAA;KAC5C,MAAA;;;UAA8B;;OAC9B,wBAAA,IAAA,WAAA,CAAA;OAAE,cAAM,OAAA;OAAc,cAAM,OAAA;OAAG,gBAAM,SAAA;OAAM,gBAAA,SAAA;;KACrB,QAAM;SAAI,KAAM;;KAExC,YAAU;SACV,KAAO;;KAIP,UAAW,OAAA;OACX,aAAQ,OAAA,KAAA,IAAA;;KACe,WAAM;SAAI,KAAM;;KACnC,SAAM,OAAA;OAAY,YAAM,OAAA,KAAA,IAAA;;KAC1B,YAAA;SAAE,KAAM;;KAAkC,UAAA,OAAA;OAC1C,aAAA,OAAA,KAAA,IAAA;;oBAA2B;MAAI,YAAM,KAAA;MAAM,WAAA,KAAA;MAC7C,YAAA,KAAA;eACO;GACR,KAAA,aAAA;GAED,KAAK,YAAA;GACL,KAAK,aAAc;EACnB;;CAGF,YAAA;;;;CAKA;CAEA,aAAA;;;;CAKA;CAEA,WAAA,IAAA;;;;;EAMA,MAAW;EACT,OAAK;CACP;;;EAKA,IAAW,QAAA,KAAmB,iBAAA;EAC5B,KAAA,WAAY;EACd,IAAA,SAAA,GAAA,IAAA;;;;CAMA,SAAW,YAAiC,KAAA,IAAA,GAAA;EAC1C,IAAA,qBAAwB,MAAK,YAAA,UAAA,QAAA;EAC/B,IAAA,CAAA,SAAA,SAAA,GAAA,MAAA,IAAA,MAAA,2DAAA,OAAA,UAAA,EAAA;;;;EAKA,OAAW;;;;;;EAQX,KAAW,YAAU,IAAwB;EAC3C,KAAK,aAAa,KAAA,aAAgB,IAAA;EACpC,OAAA,KAAA;CAEA;gBAEM,YAAgB,KAAA,IAAA,GAAA;EACpB,IAAI,qBAAiB,MAAA,YAAA,UAAA,QAAA;EAErB,IAAA,CAAA,SAAa,SAAA,GAAA,MAAA,IAAA,MAAA,2DAAA,OAAA,UAAA,EAAA;OACX,wBAAkB,IAAA,WAAA,CAAA;OAClB,aAAiB,YAAA,KAAA;OACjB,YAAK,IAAa;EACpB,KAAA,aAAA,KAAA,aAAA,IAAA;EACF,OAAA,KAAA;;;EAKA,IAAA,SAAkB,EAAA,GAAA,KAAA,OAAA,EAAA;EAChB,IAAA;EACA,IAAA,SAAK,EAAA,GAAY;GACjB,SAAK,KAAA,cAAa,EAAA;GACpB,OAAA,KAAA;;;;EAKA;EACE,OAAK,aAAa,KAAA;EAClB,OAAK,QAAA,KAAA;EACL,OAAK;CACP;;;;;;;;OAWA,IAAA,aAA4E,YAAA,IAAA,gBAAA,CAAA;EAC1E,OAAO,MAAG,IAAI,IAAA,IAAA,IAAA,KAAA;;QAKV,WAAY,OAAI;EACpB,IAAA,SAAM,KAAA,GAAA,QAAA,OAAA,KAAA;EAEN,OAAO,IAAA,WAAA,eAAA,KAAA,CAAA;CACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrew_l/snowflake",
-  "version": "0.3.21",
+  "version": "0.4.0",
   "description": "Another implementation of snowflake id generator.",
   "license": "MIT",
   "type": "module",
@@ -19,27 +19,28 @@
   "exports": {
     ".": {
       "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     }
   },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@andrew_l/toolkit": "0.3.21"
+    "@andrew_l/toolkit": "0.4.0"
   },
   "devDependencies": {
     "@sapphire/snowflake": "^3.5.5",
     "@types/node": "22.10.5",
-    "typescript": "~5.8.3",
-    "unbuild": "3.5.0",
+    "obuild": "^0.4.37",
+    "typescript": "6.0.3",
     "vitest": "^3.2.4"
   },
   "scripts": {
     "check-types": "tsc --noEmit",
-    "build": "unbuild",
+    "build": "obuild",
     "test": "vitest run --typecheck",
     "test:watch": "vitest watch --typecheck",
     "benchmark": "vitest bench watch ./benchmark",