@discordjs/ws 0.1.0

package/dist/utils/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sources":["../../src/utils/utils.ts"],"sourcesContent":["import type { ShardRange } from '../ws/WebSocketManager';\n\nexport type Awaitable<T> = T | Promise<T>;\n\n/**\n * Yields the numbers in the given range as an array\n * @example\n * range({ start: 3, end: 5 }); // [3, 4, 5]\n */\nexport function range({ start, end }: ShardRange): number[] {\n\treturn Array.from({ length: end - start + 1 }, (_, i) => i + start);\n}\n\n/**\n * Lazily evaluate a callback, storing its result\n */\nexport function lazy<T>(cb: () => T): () => T {\n\tlet defaultValue: T;\n\treturn () => (defaultValue ??= cb());\n}\n"],"names":[],"mappings":";;;;AAAO,SAAS,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;AACtC,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AACtE,CAAC;AACM,SAAS,IAAI,CAAC,EAAE,EAAE;AACzB,EAAE,IAAI,YAAY,CAAC;AACnB,EAAE,OAAO,MAAM,YAAY,KAAK,YAAY,GAAG,EAAE,EAAE,CAAC,CAAC;AACrD;;;;;"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,13 @@
+import type { ShardRange } from '../ws/WebSocketManager';
+export declare type Awaitable<T> = T | Promise<T>;
+/**
+ * Yields the numbers in the given range as an array
+ * @example
+ * range({ start: 3, end: 5 }); // [3, 4, 5]
+ */
+export declare function range({ start, end }: ShardRange): number[];
+/**
+ * Lazily evaluate a callback, storing its result
+ */
+export declare function lazy<T>(cb: () => T): () => T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,oBAAY,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,MAAM,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAG5C"}

package/dist/utils/utils.mjs

@@ -0,0 +1,10 @@
+function range({ start, end }) {
+  return Array.from({ length: end - start + 1 }, (_, i) => i + start);
+}
+function lazy(cb) {
+  let defaultValue;
+  return () => defaultValue ?? (defaultValue = cb());
+}
+
+export { lazy, range };
+//# sourceMappingURL=utils.mjs.map

package/dist/utils/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sources":["../../src/utils/utils.ts"],"sourcesContent":["import type { ShardRange } from '../ws/WebSocketManager';\n\nexport type Awaitable<T> = T | Promise<T>;\n\n/**\n * Yields the numbers in the given range as an array\n * @example\n * range({ start: 3, end: 5 }); // [3, 4, 5]\n */\nexport function range({ start, end }: ShardRange): number[] {\n\treturn Array.from({ length: end - start + 1 }, (_, i) => i + start);\n}\n\n/**\n * Lazily evaluate a callback, storing its result\n */\nexport function lazy<T>(cb: () => T): () => T {\n\tlet defaultValue: T;\n\treturn () => (defaultValue ??= cb());\n}\n"],"names":[],"mappings":"AAAO,SAAS,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;AACtC,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AACtE,CAAC;AACM,SAAS,IAAI,CAAC,EAAE,EAAE;AACzB,EAAE,IAAI,YAAY,CAAC;AACnB,EAAE,OAAO,MAAM,YAAY,KAAK,YAAY,GAAG,EAAE,EAAE,CAAC,CAAC;AACrD;;;;"}

package/dist/ws/WebSocketManager.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const async_event_emitter = require('@vladfrangu/async_event_emitter');
+const v10 = require('discord-api-types/v10');
+const SimpleShardingStrategy = require('../strategies/sharding/SimpleShardingStrategy.cjs');
+const constants = require('../utils/constants.cjs');
+const utils = require('../utils/utils.cjs');
+
+class WebSocketManager extends async_event_emitter.AsyncEventEmitter {
+  constructor(options) {
+    super();
+    this.gatewayInformation = null;
+    this.shardIds = null;
+    this.strategy = new SimpleShardingStrategy.SimpleShardingStrategy(this);
+    this.options = { ...constants.DefaultWebSocketManagerOptions, ...options };
+  }
+  setStrategy(strategy) {
+    this.strategy = strategy;
+    return this;
+  }
+  async fetchGatewayInformation(force = false) {
+    if (this.gatewayInformation) {
+      if (this.gatewayInformation.expiresAt <= Date.now()) {
+        this.gatewayInformation = null;
+      } else if (!force) {
+        return this.gatewayInformation.data;
+      }
+    }
+    const data = await this.options.rest.get(v10.Routes.gatewayBot());
+    this.gatewayInformation = { data, expiresAt: Date.now() + data.session_start_limit.reset_after };
+    return this.gatewayInformation.data;
+  }
+  async updateShardCount(shardCount) {
+    await this.strategy.destroy({ reason: "User is adjusting their shards" });
+    this.options.shardCount = shardCount;
+    const shardIds = await this.getShardIds(true);
+    await this.strategy.spawn(shardIds);
+    return this;
+  }
+  async getShardCount() {
+    if (this.options.shardCount) {
+      return this.options.shardCount;
+    }
+    const shardIds = await this.getShardIds();
+    return Math.max(...shardIds) + 1;
+  }
+  async getShardIds(force = false) {
+    if (this.shardIds && !force) {
+      return this.shardIds;
+    }
+    let shardIds;
+    if (this.options.shardIds) {
+      if (Array.isArray(this.options.shardIds)) {
+        shardIds = this.options.shardIds;
+      } else {
+        shardIds = utils.range(this.options.shardIds);
+      }
+    } else {
+      const data = await this.fetchGatewayInformation();
+      shardIds = utils.range({ start: 0, end: (this.options.shardCount ?? data.shards) - 1 });
+    }
+    this.shardIds = shardIds;
+    return shardIds;
+  }
+  async connect() {
+    const shardCount = await this.getShardCount();
+    await this.updateShardCount(shardCount);
+    await this.strategy.connect();
+  }
+  destroy(options) {
+    return this.strategy.destroy(options);
+  }
+  send(shardId, payload) {
+    return this.strategy.send(shardId, payload);
+  }
+}
+
+exports.WebSocketManager = WebSocketManager;
+//# sourceMappingURL=WebSocketManager.cjs.map

package/dist/ws/WebSocketManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketManager.cjs","sources":["../../src/ws/WebSocketManager.ts"],"sourcesContent":["import type { REST } from '@discordjs/rest';\nimport { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';\nimport {\n\tAPIGatewayBotInfo,\n\tGatewayIdentifyProperties,\n\tGatewayPresenceUpdateData,\n\tRESTGetAPIGatewayBotResult,\n\tGatewayIntentBits,\n\tRoutes,\n\tGatewaySendPayload,\n} from 'discord-api-types/v10';\nimport type { WebSocketShardDestroyOptions, WebSocketShardEventsMap } from './WebSocketShard';\nimport type { IShardingStrategy } from '../strategies/sharding/IShardingStrategy';\nimport { SimpleShardingStrategy } from '../strategies/sharding/SimpleShardingStrategy';\nimport { CompressionMethod, DefaultWebSocketManagerOptions, Encoding } from '../utils/constants';\nimport { Awaitable, range } from '../utils/utils';\n\n/**\n * Represents a range of shard ids\n */\nexport interface ShardRange {\n\tstart: number;\n\tend: number;\n}\n\n/**\n * Session information for a given shard, used to resume a session\n */\nexport interface SessionInfo {\n\t/**\n\t * Session id for this shard\n\t */\n\tsessionId: string;\n\t/**\n\t * The sequence number of the last message sent by the shard\n\t */\n\tsequence: number;\n\t/**\n\t * The id of the shard\n\t */\n\tshardId: number;\n\t/**\n\t * The total number of shards at the time of this shard identifying\n\t */\n\tshardCount: number;\n}\n\n/**\n * Required options for the WebSocketManager\n */\nexport interface RequiredWebSocketManagerOptions {\n\t/**\n\t * The token to use for identifying with the gateway\n\t */\n\ttoken: string;\n\t/**\n\t * The intents to request\n\t */\n\tintents: GatewayIntentBits;\n\t/**\n\t * The REST instance to use for fetching gateway information\n\t */\n\trest: REST;\n}\n\n/**\n * Optional additional configuration for the WebSocketManager\n */\nexport interface OptionalWebSocketManagerOptions {\n\t/**\n\t * The total number of shards across all WebsocketManagers you intend to instantiate.\n\t * Use `null` to use Discord's recommended shard count\n\t */\n\tshardCount: number | null;\n\t/**\n\t * The ids of the shards this WebSocketManager should manage.\n\t * Use `null` to simply spawn 0 through `shardCount - 1`\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   shardIds: [1, 3, 7], // spawns shard 1, 3, and 7, nothing else\n\t * });\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   shardIds: {\n\t *     start: 3,\n\t *     end: 6,\n\t *   }, // spawns shards 3, 4, 5, and 6\n\t * });\n\t */\n\tshardIds: number[] | ShardRange | null;\n\t/**\n\t * Value between 50 and 250, total number of members where the gateway will stop sending offline members in the guild member list\n\t */\n\tlargeThreshold: number | null;\n\t/**\n\t * Initial presence data to send to the gateway when identifying\n\t */\n\tinitialPresence: GatewayPresenceUpdateData | null;\n\t/**\n\t * Properties to send to the gateway when identifying\n\t */\n\tidentifyProperties: GatewayIdentifyProperties;\n\t/**\n\t * The gateway version to use\n\t * @default '10'\n\t */\n\tversion: string;\n\t/**\n\t * The encoding to use\n\t * @default 'json'\n\t */\n\tencoding: Encoding;\n\t/**\n\t * The compression method to use\n\t * @default null (no compression)\n\t */\n\tcompression: CompressionMethod | null;\n\t/**\n\t * Function used to retrieve session information (and attempt to resume) for a given shard\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   async retrieveSessionInfo(shardId): Awaitable<SessionInfo | null> {\n\t *     // Fetch this info from redis or similar\n\t *     return { sessionId: string, sequence: number };\n\t *     // Return null if no information is found\n\t *   },\n\t * });\n\t */\n\tretrieveSessionInfo: (shardId: number) => Awaitable<SessionInfo | null>;\n\t/**\n\t * Function used to store session information for a given shard\n\t */\n\tupdateSessionInfo: (shardId: number, sessionInfo: SessionInfo | null) => Awaitable<void>;\n\t/**\n\t * How long to wait for a shard to connect before giving up\n\t */\n\thandshakeTimeout: number | null;\n\t/**\n\t * How long to wait for a shard's HELLO packet before giving up\n\t */\n\thelloTimeout: number | null;\n\t/**\n\t * How long to wait for a shard's READY packet before giving up\n\t */\n\treadyTimeout: number | null;\n}\n\nexport type WebSocketManagerOptions = RequiredWebSocketManagerOptions & OptionalWebSocketManagerOptions;\n\nexport type ManagerShardEventsMap = {\n\t[K in keyof WebSocketShardEventsMap]: [\n\t\tWebSocketShardEventsMap[K] extends [] ? { shardId: number } : WebSocketShardEventsMap[K][0] & { shardId: number },\n\t];\n};\n\nexport class WebSocketManager extends AsyncEventEmitter<ManagerShardEventsMap> {\n\t/**\n\t * The options being used by this manager\n\t */\n\tpublic readonly options: WebSocketManagerOptions;\n\n\t/**\n\t * Internal cache for a GET /gateway/bot result\n\t */\n\tprivate gatewayInformation: {\n\t\tdata: APIGatewayBotInfo;\n\t\texpiresAt: number;\n\t} | null = null;\n\n\t/**\n\t * Internal cache for the shard ids\n\t */\n\tprivate shardIds: number[] | null = null;\n\n\t/**\n\t * Strategy used to manage shards\n\t * @default SimpleManagerToShardStrategy\n\t */\n\tprivate strategy: IShardingStrategy = new SimpleShardingStrategy(this);\n\n\tpublic constructor(options: RequiredWebSocketManagerOptions & Partial<OptionalWebSocketManagerOptions>) {\n\t\tsuper();\n\t\tthis.options = { ...DefaultWebSocketManagerOptions, ...options };\n\t}\n\n\tpublic setStrategy(strategy: IShardingStrategy) {\n\t\tthis.strategy = strategy;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Fetches the gateway information from Discord - or returns it from cache if available\n\t * @param force Whether to ignore the cache and force a fresh fetch\n\t */\n\tpublic async fetchGatewayInformation(force = false) {\n\t\tif (this.gatewayInformation) {\n\t\t\tif (this.gatewayInformation.expiresAt <= Date.now()) {\n\t\t\t\tthis.gatewayInformation = null;\n\t\t\t} else if (!force) {\n\t\t\t\treturn this.gatewayInformation.data;\n\t\t\t}\n\t\t}\n\n\t\tconst data = (await this.options.rest.get(Routes.gatewayBot())) as RESTGetAPIGatewayBotResult;\n\n\t\tthis.gatewayInformation = { data, expiresAt: Date.now() + data.session_start_limit.reset_after };\n\t\treturn this.gatewayInformation.data;\n\t}\n\n\t/**\n\t * Updates your total shard count on-the-fly, spawning shards as needed\n\t * @param shardCount The new shard count to use\n\t */\n\tpublic async updateShardCount(shardCount: number | null) {\n\t\tawait this.strategy.destroy({ reason: 'User is adjusting their shards' });\n\t\tthis.options.shardCount = shardCount;\n\n\t\tconst shardIds = await this.getShardIds(true);\n\t\tawait this.strategy.spawn(shardIds);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Yields the total number of shards across for your bot, accounting for Discord recommendations\n\t */\n\tpublic async getShardCount(): Promise<number> {\n\t\tif (this.options.shardCount) {\n\t\t\treturn this.options.shardCount;\n\t\t}\n\n\t\tconst shardIds = await this.getShardIds();\n\t\treturn Math.max(...shardIds) + 1;\n\t}\n\n\t/**\n\t * Yields the ids of the shards this manager should manage\n\t */\n\tpublic async getShardIds(force = false): Promise<number[]> {\n\t\tif (this.shardIds && !force) {\n\t\t\treturn this.shardIds;\n\t\t}\n\n\t\tlet shardIds: number[];\n\t\tif (this.options.shardIds) {\n\t\t\tif (Array.isArray(this.options.shardIds)) {\n\t\t\t\tshardIds = this.options.shardIds;\n\t\t\t} else {\n\t\t\t\tshardIds = range(this.options.shardIds);\n\t\t\t}\n\t\t} else {\n\t\t\tconst data = await this.fetchGatewayInformation();\n\t\t\tshardIds = range({ start: 0, end: (this.options.shardCount ?? data.shards) - 1 });\n\t\t}\n\n\t\tthis.shardIds = shardIds;\n\t\treturn shardIds;\n\t}\n\n\tpublic async connect() {\n\t\tconst shardCount = await this.getShardCount();\n\t\t// First, make sure all our shards are spawned\n\t\tawait this.updateShardCount(shardCount);\n\t\tawait this.strategy.connect();\n\t}\n\n\tpublic destroy(options?: Omit<WebSocketShardDestroyOptions, 'recover'>) {\n\t\treturn this.strategy.destroy(options);\n\t}\n\n\tpublic send(shardId: number, payload: GatewaySendPayload) {\n\t\treturn this.strategy.send(shardId, payload);\n\t}\n}\n"],"names":["AsyncEventEmitter","SimpleShardingStrategy","DefaultWebSocketManagerOptions","Routes","range"],"mappings":"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"}

package/dist/ws/WebSocketManager.d.ts

@@ -0,0 +1,186 @@
+import type { REST } from '@discordjs/rest';
+import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
+import { APIGatewayBotInfo, GatewayIdentifyProperties, GatewayPresenceUpdateData, GatewayIntentBits, GatewaySendPayload } from 'discord-api-types/v10';
+import type { WebSocketShardDestroyOptions, WebSocketShardEventsMap } from './WebSocketShard';
+import type { IShardingStrategy } from '../strategies/sharding/IShardingStrategy';
+import { CompressionMethod, Encoding } from '../utils/constants';
+import { Awaitable } from '../utils/utils';
+/**
+ * Represents a range of shard ids
+ */
+export interface ShardRange {
+    start: number;
+    end: number;
+}
+/**
+ * Session information for a given shard, used to resume a session
+ */
+export interface SessionInfo {
+    /**
+     * Session id for this shard
+     */
+    sessionId: string;
+    /**
+     * The sequence number of the last message sent by the shard
+     */
+    sequence: number;
+    /**
+     * The id of the shard
+     */
+    shardId: number;
+    /**
+     * The total number of shards at the time of this shard identifying
+     */
+    shardCount: number;
+}
+/**
+ * Required options for the WebSocketManager
+ */
+export interface RequiredWebSocketManagerOptions {
+    /**
+     * The token to use for identifying with the gateway
+     */
+    token: string;
+    /**
+     * The intents to request
+     */
+    intents: GatewayIntentBits;
+    /**
+     * The REST instance to use for fetching gateway information
+     */
+    rest: REST;
+}
+/**
+ * Optional additional configuration for the WebSocketManager
+ */
+export interface OptionalWebSocketManagerOptions {
+    /**
+     * The total number of shards across all WebsocketManagers you intend to instantiate.
+     * Use `null` to use Discord's recommended shard count
+     */
+    shardCount: number | null;
+    /**
+     * The ids of the shards this WebSocketManager should manage.
+     * Use `null` to simply spawn 0 through `shardCount - 1`
+     * @example
+     * const manager = new WebSocketManager({
+     *   shardIds: [1, 3, 7], // spawns shard 1, 3, and 7, nothing else
+     * });
+     * @example
+     * const manager = new WebSocketManager({
+     *   shardIds: {
+     *     start: 3,
+     *     end: 6,
+     *   }, // spawns shards 3, 4, 5, and 6
+     * });
+     */
+    shardIds: number[] | ShardRange | null;
+    /**
+     * Value between 50 and 250, total number of members where the gateway will stop sending offline members in the guild member list
+     */
+    largeThreshold: number | null;
+    /**
+     * Initial presence data to send to the gateway when identifying
+     */
+    initialPresence: GatewayPresenceUpdateData | null;
+    /**
+     * Properties to send to the gateway when identifying
+     */
+    identifyProperties: GatewayIdentifyProperties;
+    /**
+     * The gateway version to use
+     * @default '10'
+     */
+    version: string;
+    /**
+     * The encoding to use
+     * @default 'json'
+     */
+    encoding: Encoding;
+    /**
+     * The compression method to use
+     * @default null (no compression)
+     */
+    compression: CompressionMethod | null;
+    /**
+     * Function used to retrieve session information (and attempt to resume) for a given shard
+     * @example
+     * const manager = new WebSocketManager({
+     *   async retrieveSessionInfo(shardId): Awaitable<SessionInfo | null> {
+     *     // Fetch this info from redis or similar
+     *     return { sessionId: string, sequence: number };
+     *     // Return null if no information is found
+     *   },
+     * });
+     */
+    retrieveSessionInfo: (shardId: number) => Awaitable<SessionInfo | null>;
+    /**
+     * Function used to store session information for a given shard
+     */
+    updateSessionInfo: (shardId: number, sessionInfo: SessionInfo | null) => Awaitable<void>;
+    /**
+     * How long to wait for a shard to connect before giving up
+     */
+    handshakeTimeout: number | null;
+    /**
+     * How long to wait for a shard's HELLO packet before giving up
+     */
+    helloTimeout: number | null;
+    /**
+     * How long to wait for a shard's READY packet before giving up
+     */
+    readyTimeout: number | null;
+}
+export declare type WebSocketManagerOptions = RequiredWebSocketManagerOptions & OptionalWebSocketManagerOptions;
+export declare type ManagerShardEventsMap = {
+    [K in keyof WebSocketShardEventsMap]: [
+        WebSocketShardEventsMap[K] extends [] ? {
+            shardId: number;
+        } : WebSocketShardEventsMap[K][0] & {
+            shardId: number;
+        }
+    ];
+};
+export declare class WebSocketManager extends AsyncEventEmitter<ManagerShardEventsMap> {
+    /**
+     * The options being used by this manager
+     */
+    readonly options: WebSocketManagerOptions;
+    /**
+     * Internal cache for a GET /gateway/bot result
+     */
+    private gatewayInformation;
+    /**
+     * Internal cache for the shard ids
+     */
+    private shardIds;
+    /**
+     * Strategy used to manage shards
+     * @default SimpleManagerToShardStrategy
+     */
+    private strategy;
+    constructor(options: RequiredWebSocketManagerOptions & Partial<OptionalWebSocketManagerOptions>);
+    setStrategy(strategy: IShardingStrategy): this;
+    /**
+     * Fetches the gateway information from Discord - or returns it from cache if available
+     * @param force Whether to ignore the cache and force a fresh fetch
+     */
+    fetchGatewayInformation(force?: boolean): Promise<APIGatewayBotInfo>;
+    /**
+     * Updates your total shard count on-the-fly, spawning shards as needed
+     * @param shardCount The new shard count to use
+     */
+    updateShardCount(shardCount: number | null): Promise<this>;
+    /**
+     * Yields the total number of shards across for your bot, accounting for Discord recommendations
+     */
+    getShardCount(): Promise<number>;
+    /**
+     * Yields the ids of the shards this manager should manage
+     */
+    getShardIds(force?: boolean): Promise<number[]>;
+    connect(): Promise<void>;
+    destroy(options?: Omit<WebSocketShardDestroyOptions, 'recover'>): Awaitable<void>;
+    send(shardId: number, payload: GatewaySendPayload): Awaitable<void>;
+}
+//# sourceMappingURL=WebSocketManager.d.ts.map

package/dist/ws/WebSocketManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketManager.d.ts","sourceRoot":"","sources":["../../src/ws/WebSocketManager.ts"],"names":[],"mappings":"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"}

package/dist/ws/WebSocketManager.mjs

@@ -0,0 +1,77 @@
+import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
+import { Routes } from 'discord-api-types/v10';
+import { SimpleShardingStrategy } from '../strategies/sharding/SimpleShardingStrategy.mjs';
+import { DefaultWebSocketManagerOptions } from '../utils/constants.mjs';
+import { range } from '../utils/utils.mjs';
+
+class WebSocketManager extends AsyncEventEmitter {
+  constructor(options) {
+    super();
+    this.gatewayInformation = null;
+    this.shardIds = null;
+    this.strategy = new SimpleShardingStrategy(this);
+    this.options = { ...DefaultWebSocketManagerOptions, ...options };
+  }
+  setStrategy(strategy) {
+    this.strategy = strategy;
+    return this;
+  }
+  async fetchGatewayInformation(force = false) {
+    if (this.gatewayInformation) {
+      if (this.gatewayInformation.expiresAt <= Date.now()) {
+        this.gatewayInformation = null;
+      } else if (!force) {
+        return this.gatewayInformation.data;
+      }
+    }
+    const data = await this.options.rest.get(Routes.gatewayBot());
+    this.gatewayInformation = { data, expiresAt: Date.now() + data.session_start_limit.reset_after };
+    return this.gatewayInformation.data;
+  }
+  async updateShardCount(shardCount) {
+    await this.strategy.destroy({ reason: "User is adjusting their shards" });
+    this.options.shardCount = shardCount;
+    const shardIds = await this.getShardIds(true);
+    await this.strategy.spawn(shardIds);
+    return this;
+  }
+  async getShardCount() {
+    if (this.options.shardCount) {
+      return this.options.shardCount;
+    }
+    const shardIds = await this.getShardIds();
+    return Math.max(...shardIds) + 1;
+  }
+  async getShardIds(force = false) {
+    if (this.shardIds && !force) {
+      return this.shardIds;
+    }
+    let shardIds;
+    if (this.options.shardIds) {
+      if (Array.isArray(this.options.shardIds)) {
+        shardIds = this.options.shardIds;
+      } else {
+        shardIds = range(this.options.shardIds);
+      }
+    } else {
+      const data = await this.fetchGatewayInformation();
+      shardIds = range({ start: 0, end: (this.options.shardCount ?? data.shards) - 1 });
+    }
+    this.shardIds = shardIds;
+    return shardIds;
+  }
+  async connect() {
+    const shardCount = await this.getShardCount();
+    await this.updateShardCount(shardCount);
+    await this.strategy.connect();
+  }
+  destroy(options) {
+    return this.strategy.destroy(options);
+  }
+  send(shardId, payload) {
+    return this.strategy.send(shardId, payload);
+  }
+}
+
+export { WebSocketManager };
+//# sourceMappingURL=WebSocketManager.mjs.map

package/dist/ws/WebSocketManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketManager.mjs","sources":["../../src/ws/WebSocketManager.ts"],"sourcesContent":["import type { REST } from '@discordjs/rest';\nimport { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';\nimport {\n\tAPIGatewayBotInfo,\n\tGatewayIdentifyProperties,\n\tGatewayPresenceUpdateData,\n\tRESTGetAPIGatewayBotResult,\n\tGatewayIntentBits,\n\tRoutes,\n\tGatewaySendPayload,\n} from 'discord-api-types/v10';\nimport type { WebSocketShardDestroyOptions, WebSocketShardEventsMap } from './WebSocketShard';\nimport type { IShardingStrategy } from '../strategies/sharding/IShardingStrategy';\nimport { SimpleShardingStrategy } from '../strategies/sharding/SimpleShardingStrategy';\nimport { CompressionMethod, DefaultWebSocketManagerOptions, Encoding } from '../utils/constants';\nimport { Awaitable, range } from '../utils/utils';\n\n/**\n * Represents a range of shard ids\n */\nexport interface ShardRange {\n\tstart: number;\n\tend: number;\n}\n\n/**\n * Session information for a given shard, used to resume a session\n */\nexport interface SessionInfo {\n\t/**\n\t * Session id for this shard\n\t */\n\tsessionId: string;\n\t/**\n\t * The sequence number of the last message sent by the shard\n\t */\n\tsequence: number;\n\t/**\n\t * The id of the shard\n\t */\n\tshardId: number;\n\t/**\n\t * The total number of shards at the time of this shard identifying\n\t */\n\tshardCount: number;\n}\n\n/**\n * Required options for the WebSocketManager\n */\nexport interface RequiredWebSocketManagerOptions {\n\t/**\n\t * The token to use for identifying with the gateway\n\t */\n\ttoken: string;\n\t/**\n\t * The intents to request\n\t */\n\tintents: GatewayIntentBits;\n\t/**\n\t * The REST instance to use for fetching gateway information\n\t */\n\trest: REST;\n}\n\n/**\n * Optional additional configuration for the WebSocketManager\n */\nexport interface OptionalWebSocketManagerOptions {\n\t/**\n\t * The total number of shards across all WebsocketManagers you intend to instantiate.\n\t * Use `null` to use Discord's recommended shard count\n\t */\n\tshardCount: number | null;\n\t/**\n\t * The ids of the shards this WebSocketManager should manage.\n\t * Use `null` to simply spawn 0 through `shardCount - 1`\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   shardIds: [1, 3, 7], // spawns shard 1, 3, and 7, nothing else\n\t * });\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   shardIds: {\n\t *     start: 3,\n\t *     end: 6,\n\t *   }, // spawns shards 3, 4, 5, and 6\n\t * });\n\t */\n\tshardIds: number[] | ShardRange | null;\n\t/**\n\t * Value between 50 and 250, total number of members where the gateway will stop sending offline members in the guild member list\n\t */\n\tlargeThreshold: number | null;\n\t/**\n\t * Initial presence data to send to the gateway when identifying\n\t */\n\tinitialPresence: GatewayPresenceUpdateData | null;\n\t/**\n\t * Properties to send to the gateway when identifying\n\t */\n\tidentifyProperties: GatewayIdentifyProperties;\n\t/**\n\t * The gateway version to use\n\t * @default '10'\n\t */\n\tversion: string;\n\t/**\n\t * The encoding to use\n\t * @default 'json'\n\t */\n\tencoding: Encoding;\n\t/**\n\t * The compression method to use\n\t * @default null (no compression)\n\t */\n\tcompression: CompressionMethod | null;\n\t/**\n\t * Function used to retrieve session information (and attempt to resume) for a given shard\n\t * @example\n\t * const manager = new WebSocketManager({\n\t *   async retrieveSessionInfo(shardId): Awaitable<SessionInfo | null> {\n\t *     // Fetch this info from redis or similar\n\t *     return { sessionId: string, sequence: number };\n\t *     // Return null if no information is found\n\t *   },\n\t * });\n\t */\n\tretrieveSessionInfo: (shardId: number) => Awaitable<SessionInfo | null>;\n\t/**\n\t * Function used to store session information for a given shard\n\t */\n\tupdateSessionInfo: (shardId: number, sessionInfo: SessionInfo | null) => Awaitable<void>;\n\t/**\n\t * How long to wait for a shard to connect before giving up\n\t */\n\thandshakeTimeout: number | null;\n\t/**\n\t * How long to wait for a shard's HELLO packet before giving up\n\t */\n\thelloTimeout: number | null;\n\t/**\n\t * How long to wait for a shard's READY packet before giving up\n\t */\n\treadyTimeout: number | null;\n}\n\nexport type WebSocketManagerOptions = RequiredWebSocketManagerOptions & OptionalWebSocketManagerOptions;\n\nexport type ManagerShardEventsMap = {\n\t[K in keyof WebSocketShardEventsMap]: [\n\t\tWebSocketShardEventsMap[K] extends [] ? { shardId: number } : WebSocketShardEventsMap[K][0] & { shardId: number },\n\t];\n};\n\nexport class WebSocketManager extends AsyncEventEmitter<ManagerShardEventsMap> {\n\t/**\n\t * The options being used by this manager\n\t */\n\tpublic readonly options: WebSocketManagerOptions;\n\n\t/**\n\t * Internal cache for a GET /gateway/bot result\n\t */\n\tprivate gatewayInformation: {\n\t\tdata: APIGatewayBotInfo;\n\t\texpiresAt: number;\n\t} | null = null;\n\n\t/**\n\t * Internal cache for the shard ids\n\t */\n\tprivate shardIds: number[] | null = null;\n\n\t/**\n\t * Strategy used to manage shards\n\t * @default SimpleManagerToShardStrategy\n\t */\n\tprivate strategy: IShardingStrategy = new SimpleShardingStrategy(this);\n\n\tpublic constructor(options: RequiredWebSocketManagerOptions & Partial<OptionalWebSocketManagerOptions>) {\n\t\tsuper();\n\t\tthis.options = { ...DefaultWebSocketManagerOptions, ...options };\n\t}\n\n\tpublic setStrategy(strategy: IShardingStrategy) {\n\t\tthis.strategy = strategy;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Fetches the gateway information from Discord - or returns it from cache if available\n\t * @param force Whether to ignore the cache and force a fresh fetch\n\t */\n\tpublic async fetchGatewayInformation(force = false) {\n\t\tif (this.gatewayInformation) {\n\t\t\tif (this.gatewayInformation.expiresAt <= Date.now()) {\n\t\t\t\tthis.gatewayInformation = null;\n\t\t\t} else if (!force) {\n\t\t\t\treturn this.gatewayInformation.data;\n\t\t\t}\n\t\t}\n\n\t\tconst data = (await this.options.rest.get(Routes.gatewayBot())) as RESTGetAPIGatewayBotResult;\n\n\t\tthis.gatewayInformation = { data, expiresAt: Date.now() + data.session_start_limit.reset_after };\n\t\treturn this.gatewayInformation.data;\n\t}\n\n\t/**\n\t * Updates your total shard count on-the-fly, spawning shards as needed\n\t * @param shardCount The new shard count to use\n\t */\n\tpublic async updateShardCount(shardCount: number | null) {\n\t\tawait this.strategy.destroy({ reason: 'User is adjusting their shards' });\n\t\tthis.options.shardCount = shardCount;\n\n\t\tconst shardIds = await this.getShardIds(true);\n\t\tawait this.strategy.spawn(shardIds);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Yields the total number of shards across for your bot, accounting for Discord recommendations\n\t */\n\tpublic async getShardCount(): Promise<number> {\n\t\tif (this.options.shardCount) {\n\t\t\treturn this.options.shardCount;\n\t\t}\n\n\t\tconst shardIds = await this.getShardIds();\n\t\treturn Math.max(...shardIds) + 1;\n\t}\n\n\t/**\n\t * Yields the ids of the shards this manager should manage\n\t */\n\tpublic async getShardIds(force = false): Promise<number[]> {\n\t\tif (this.shardIds && !force) {\n\t\t\treturn this.shardIds;\n\t\t}\n\n\t\tlet shardIds: number[];\n\t\tif (this.options.shardIds) {\n\t\t\tif (Array.isArray(this.options.shardIds)) {\n\t\t\t\tshardIds = this.options.shardIds;\n\t\t\t} else {\n\t\t\t\tshardIds = range(this.options.shardIds);\n\t\t\t}\n\t\t} else {\n\t\t\tconst data = await this.fetchGatewayInformation();\n\t\t\tshardIds = range({ start: 0, end: (this.options.shardCount ?? data.shards) - 1 });\n\t\t}\n\n\t\tthis.shardIds = shardIds;\n\t\treturn shardIds;\n\t}\n\n\tpublic async connect() {\n\t\tconst shardCount = await this.getShardCount();\n\t\t// First, make sure all our shards are spawned\n\t\tawait this.updateShardCount(shardCount);\n\t\tawait this.strategy.connect();\n\t}\n\n\tpublic destroy(options?: Omit<WebSocketShardDestroyOptions, 'recover'>) {\n\t\treturn this.strategy.destroy(options);\n\t}\n\n\tpublic send(shardId: number, payload: GatewaySendPayload) {\n\t\treturn this.strategy.send(shardId, payload);\n\t}\n}\n"],"names":[],"mappings":"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"}