first commit

1 files changed, 202 insertions, 0 deletions

diff --git a/node_modules/@sapphire/snowflake/dist/index.d.ts b/node_modules/@sapphire/snowflake/dist/index.d.ts
new file mode 100644
index 0000000..76db741
--- /dev/null
+++ b/node_modules/@sapphire/snowflake/dist/index.d.ts
@@ -0,0 +1,202 @@
+declare const IncrementSymbol: unique symbol;
+declare const EpochSymbol: unique symbol;
+declare const ProcessIdSymbol: unique symbol;
+declare const WorkerIdSymbol: unique symbol;
+/**
+ * The maximum value the `workerId` field accepts in snowflakes.
+ */
+declare const MaximumWorkerId = 31n;
+/**
+ * The maximum value the `processId` field accepts in snowflakes.
+ */
+declare const MaximumProcessId = 31n;
+/**
+ * The maximum value the `increment` field accepts in snowflakes.
+ */
+declare const MaximumIncrement = 4095n;
+/**
+ * A class for generating and deconstructing Twitter snowflakes.
+ *
+ * A {@link https://developer.twitter.com/en/docs/twitter-ids Twitter snowflake}
+ * is a 64-bit unsigned integer with 4 fields that have a fixed epoch value.
+ *
+ * If we have a snowflake `266241948824764416` we can represent it as binary:
+ * ```
+ * 64                                          22     17     12          0
+ *  000000111011000111100001101001000101000000  00001  00000  000000000000
+ *           number of ms since epoch           worker  pid    increment
+ * ```
+ */
+declare class Snowflake {
+    /**
+     * Alias for {@link deconstruct}
+     */
+    decode: (id: string | bigint) => DeconstructedSnowflake;
+    /**
+     * Internal reference of the epoch passed in the constructor
+     * @internal
+     */
+    private readonly [EpochSymbol];
+    /**
+     * Internal incrementor for generating snowflakes
+     * @internal
+     */
+    private [IncrementSymbol];
+    /**
+     * The process ID that will be used by default in the generate method
+     * @internal
+     */
+    private [ProcessIdSymbol];
+    /**
+     * The worker ID that will be used by default in the generate method
+     * @internal
+     */
+    private [WorkerIdSymbol];
+    /**
+     * @param epoch the epoch to use
+     */
+    constructor(epoch: number | bigint | Date);
+    /**
+     * The epoch for this snowflake
+     */
+    get epoch(): bigint;
+    /**
+     * Gets the configured process ID
+     */
+    get processId(): bigint;
+    /**
+     * Sets the process ID that will be used by default for the {@link generate} method
+     * @param value The new value, will be coerced to BigInt and masked with `0b11111n`
+     */
+    set processId(value: number | bigint);
+    /**
+     * Gets the configured worker ID
+     */
+    get workerId(): bigint;
+    /**
+     * Sets the worker ID that will be used by default for the {@link generate} method
+     * @param value The new value, will be coerced to BigInt and masked with `0b11111n`
+     */
+    set workerId(value: number | bigint);
+    /**
+     * Generates a snowflake given an epoch and optionally a timestamp
+     * @param options options to pass into the generator, see {@link SnowflakeGenerateOptions}
+     *
+     * **note** when `increment` is not provided it defaults to the private `increment` of the instance
+     * @example
+     * ```typescript
+     * const epoch = new Date('2000-01-01T00:00:00.000Z');
+     * const snowflake = new Snowflake(epoch).generate();
+     * ```
+     * @returns A unique snowflake
+     */
+    generate({ increment, timestamp, workerId, processId }?: SnowflakeGenerateOptions): bigint;
+    /**
+     * 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: string | bigint): DeconstructedSnowflake;
+    /**
+     * 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: string | bigint): number;
+    /**
+     * 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`.
+     * @example Sort snowflakes in ascending order
+     * ```typescript
+     * const ids = ['737141877803057244', '1056191128120082432', '254360814063058944'];
+     * console.log(ids.sort((a, b) => Snowflake.compare(a, b)));
+     * // → ['254360814063058944', '737141877803057244', '1056191128120082432'];
+     * ```
+     * @example Sort snowflakes in descending order
+     * ```typescript
+     * const ids = ['737141877803057244', '1056191128120082432', '254360814063058944'];
+     * console.log(ids.sort((a, b) => -Snowflake.compare(a, b)));
+     * // → ['1056191128120082432', '737141877803057244', '254360814063058944'];
+     * ```
+     */
+    static compare(a: string | bigint, b: string | bigint): -1 | 0 | 1;
+}
+/**
+ * Options for Snowflake#generate
+ */
+interface SnowflakeGenerateOptions {
+    /**
+     * Timestamp or date of the snowflake to generate
+     * @default Date.now()
+     */
+    timestamp?: number | bigint | Date;
+    /**
+     * The increment to use
+     * @default 0n
+     * @remark keep in mind that this bigint is auto-incremented between generate calls
+     */
+    increment?: bigint;
+    /**
+     * The worker ID to use, will be truncated to 5 bits (0-31)
+     * @default 0n
+     */
+    workerId?: bigint;
+    /**
+     * The process ID to use, will be truncated to 5 bits (0-31)
+     * @default 1n
+     */
+    processId?: bigint;
+}
+/**
+ * Object returned by Snowflake#deconstruct
+ */
+interface DeconstructedSnowflake {
+    /**
+     * The id in BigInt form
+     */
+    id: bigint;
+    /**
+     * The timestamp stored in the snowflake
+     */
+    timestamp: bigint;
+    /**
+     * The worker id stored in the snowflake
+     */
+    workerId: bigint;
+    /**
+     * The process id stored in the snowflake
+     */
+    processId: bigint;
+    /**
+     * The increment stored in the snowflake
+     */
+    increment: bigint;
+    /**
+     * The epoch to use in the snowflake
+     */
+    epoch: bigint;
+}
+
+/**
+ * A class for parsing snowflake ids using Discord's snowflake epoch
+ *
+ * Which is 2015-01-01 at 00:00:00.000 UTC+0, {@linkplain https://discord.com/developers/docs/reference#snowflakes}
+ */
+declare const DiscordSnowflake: Snowflake;
+
+/**
+ * A class for parsing snowflake ids using Twitter's snowflake epoch
+ *
+ * Which is 2010-11-04 at 01:42:54.657 UTC+0, found in the archived snowflake repository {@linkplain https://github.com/twitter-archive/snowflake/blob/b3f6a3c6ca8e1b6847baa6ff42bf72201e2c2231/src/main/scala/com/twitter/service/snowflake/IdWorker.scala#L25}
+ */
+declare const TwitterSnowflake: Snowflake;
+
+export { DeconstructedSnowflake, DiscordSnowflake, MaximumIncrement, MaximumProcessId, MaximumWorkerId, Snowflake, SnowflakeGenerateOptions, TwitterSnowflake };