@discordeno/gateway 19.0.0-next.bb85624 → 19.0.0-next.bcfeb5b
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/Shard.d.ts +7 -0
- package/dist/Shard.d.ts.map +1 -1
- package/dist/Shard.js +47 -43
- package/dist/Shard.js.map +1 -1
- package/dist/manager.d.ts +9 -3
- package/dist/manager.d.ts.map +1 -1
- package/dist/manager.js +40 -21
- package/dist/manager.js.map +1 -1
- package/dist/types.js.map +1 -1
- package/package.json +16 -16
package/dist/Shard.d.ts
CHANGED
|
@@ -48,6 +48,8 @@ export declare class DiscordenoShard {
|
|
|
48
48
|
constructor(options: ShardCreateOptions);
|
|
49
49
|
/** The gateway configuration which is used to connect to Discord. */
|
|
50
50
|
get gatewayConfig(): ShardGatewayConfig;
|
|
51
|
+
/** The url to connect to. Intially this is the discord gateway url, and then is switched to resume gateway url once a READY is received. */
|
|
52
|
+
get connectionUrl(): string;
|
|
51
53
|
/** Calculate the amount of requests which can safely be made per rate limit interval, before the gateway gets disconnected due to an exceeded rate limit. */
|
|
52
54
|
calculateSafeRequests(): number;
|
|
53
55
|
checkOffline(highPriority: boolean): Promise<void>;
|
|
@@ -71,6 +73,7 @@ export declare class DiscordenoShard {
|
|
|
71
73
|
handleClose(close: WebSocket.CloseEvent): Promise<void>;
|
|
72
74
|
/** Handles a incoming gateway packet. */
|
|
73
75
|
handleDiscordPacket(packet: DiscordGatewayPayload): Promise<void>;
|
|
76
|
+
forwardToBot(packet: DiscordGatewayPayload): void;
|
|
74
77
|
/** Handle an incoming gateway message. */
|
|
75
78
|
handleMessage(message: WebSocket.MessageEvent): Promise<void>;
|
|
76
79
|
/**
|
|
@@ -81,6 +84,8 @@ export declare class DiscordenoShard {
|
|
|
81
84
|
makePresence(): Promise<BotStatusUpdate | undefined>;
|
|
82
85
|
/** This function communicates with the management process, in order to know whether its free to identify. When this function resolves, this means that the shard is allowed to send an identify payload to discord. */
|
|
83
86
|
requestIdentify(): Promise<void>;
|
|
87
|
+
/** This function communicates with the management process, in order to tell it can identify the next shard. */
|
|
88
|
+
shardIsReady(): Promise<void>;
|
|
84
89
|
/** Start sending heartbeat payloads to Discord in the provided interval. */
|
|
85
90
|
startHeartbeating(interval: number): void;
|
|
86
91
|
/** Stop the heartbeating process with discord. */
|
|
@@ -163,6 +168,8 @@ export interface ShardCreateOptions {
|
|
|
163
168
|
events: ShardEvents;
|
|
164
169
|
/** The handler to request a space to make an identify request. */
|
|
165
170
|
requestIdentify?: () => Promise<void>;
|
|
171
|
+
/** The handler to alert the gateway manager that this shard has received a READY event. */
|
|
172
|
+
shardIsReady?: () => Promise<void>;
|
|
166
173
|
}
|
|
167
174
|
export default DiscordenoShard;
|
|
168
175
|
//# sourceMappingURL=Shard.d.ts.map
|
package/dist/Shard.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Shard.d.ts","sourceRoot":"","sources":["../src/Shard.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Shard.d.ts","sourceRoot":"","sources":["../src/Shard.ts"],"names":[],"mappings":"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"}
|
package/dist/Shard.js
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
import { GatewayCloseEventCodes, GatewayIntents, GatewayOpcodes } from '@discordeno/types';
|
|
2
|
-
import {
|
|
1
|
+
/* eslint-disable @typescript-eslint/no-confusing-void-expression */ import { GatewayCloseEventCodes, GatewayIntents, GatewayOpcodes } from '@discordeno/types';
|
|
2
|
+
import { Collection, LeakyBucket, camelize, delay, logger } from '@discordeno/utils';
|
|
3
3
|
import { inflateSync } from 'node:zlib';
|
|
4
4
|
import WebSocket from 'ws';
|
|
5
5
|
import { ShardSocketCloseCodes, ShardState } from './types.js';
|
|
6
6
|
export class DiscordenoShard {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
7
|
+
constructor(options){
|
|
8
|
+
/** The maximum of requests which can be send to discord per rate limit tick. Typically this value should not be changed. */ this.maxRequestsPerRateLimitTick = 120;
|
|
9
|
+
/** The previous payload sequence number. */ this.previousSequenceNumber = null;
|
|
10
|
+
/** In which interval (in milliseconds) the gateway resets it's rate limit. */ this.rateLimitResetInterval = 60000;
|
|
11
|
+
/** Current internal state of the this. */ this.state = ShardState.Offline;
|
|
12
|
+
/** The url provided by discord to use when resuming a connection for this this. */ this.resumeGatewayUrl = '';
|
|
13
|
+
/** The shard related event handlers. */ this.events = {};
|
|
14
|
+
/** Cache for pending gateway requests which should have been send while the gateway went offline. */ this.offlineSendQueue = [];
|
|
15
|
+
/** Resolve internal waiting states. Mapped by SelectedEvents => ResolveFunction */ this.resolves = new Map();
|
|
16
|
+
/** This managers cache related settings. */ this.cache = {
|
|
17
|
+
requestMembers: {
|
|
18
|
+
/**
|
|
18
19
|
* Whether or not request member requests should be cached.
|
|
19
20
|
* @default false
|
|
20
21
|
*/ enabled: false,
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
constructor(options){
|
|
22
|
+
/** The pending requests. */ pending: new Collection()
|
|
23
|
+
}
|
|
24
|
+
};
|
|
25
25
|
this.id = options.id;
|
|
26
26
|
this.connection = options.connection;
|
|
27
27
|
this.events = options.events;
|
|
@@ -30,6 +30,7 @@ export class DiscordenoShard {
|
|
|
30
30
|
interval: 45000
|
|
31
31
|
};
|
|
32
32
|
if (options.requestIdentify) this.requestIdentify = options.requestIdentify;
|
|
33
|
+
if (options.shardIsReady) this.shardIsReady = options.shardIsReady;
|
|
33
34
|
this.bucket = new LeakyBucket({
|
|
34
35
|
max: this.calculateSafeRequests(),
|
|
35
36
|
refillAmount: this.calculateSafeRequests(),
|
|
@@ -39,6 +40,10 @@ export class DiscordenoShard {
|
|
|
39
40
|
/** The gateway configuration which is used to connect to Discord. */ get gatewayConfig() {
|
|
40
41
|
return this.connection;
|
|
41
42
|
}
|
|
43
|
+
/** The url to connect to. Intially this is the discord gateway url, and then is switched to resume gateway url once a READY is received. */ get connectionUrl() {
|
|
44
|
+
// Use || and not ?? here. ?? will cause a bug.
|
|
45
|
+
return this.resumeGatewayUrl || this.gatewayConfig.url;
|
|
46
|
+
}
|
|
42
47
|
/** Calculate the amount of requests which can safely be made per rate limit interval, before the gateway gets disconnected due to an exceeded rate limit. */ calculateSafeRequests() {
|
|
43
48
|
// * 2 adds extra safety layer for discords OP 1 requests that we need to respond to
|
|
44
49
|
const safeRequests = this.maxRequestsPerRateLimitTick - Math.ceil(this.rateLimitResetInterval / this.heart.interval) * 2;
|
|
@@ -55,7 +60,7 @@ export class DiscordenoShard {
|
|
|
55
60
|
}
|
|
56
61
|
/** Close the socket connection to discord if present. */ close(code, reason) {
|
|
57
62
|
if (this.socket?.readyState !== WebSocket.OPEN) return;
|
|
58
|
-
|
|
63
|
+
this.socket?.close(code, reason);
|
|
59
64
|
}
|
|
60
65
|
/** Connect the shard with the gateway and start heartbeating. This will not identify the shard to the gateway. */ async connect() {
|
|
61
66
|
// Only set the shard to `Connecting` state,
|
|
@@ -67,20 +72,15 @@ export class DiscordenoShard {
|
|
|
67
72
|
this.state = ShardState.Connecting;
|
|
68
73
|
}
|
|
69
74
|
this.events.connecting?.(this);
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
if (this.state === ShardState.Resuming) {
|
|
74
|
-
url = new URL(this.resumeGatewayUrl);
|
|
75
|
-
}
|
|
76
|
-
url.searchParams.set('v', this.gatewayConfig.version.toString());
|
|
77
|
-
url.searchParams.set('encoding', 'json');
|
|
78
|
-
}
|
|
75
|
+
const url = new URL(this.connectionUrl);
|
|
76
|
+
url.searchParams.set('v', this.gatewayConfig.version.toString());
|
|
77
|
+
url.searchParams.set('encoding', 'json');
|
|
79
78
|
const socket = new WebSocket(url.toString());
|
|
80
79
|
this.socket = socket;
|
|
81
80
|
// TODO: proper event handling
|
|
82
81
|
socket.onerror = (event)=>console.log({
|
|
83
|
-
error: event
|
|
82
|
+
error: event,
|
|
83
|
+
shardId: this.id
|
|
84
84
|
});
|
|
85
85
|
socket.onclose = async (event)=>await this.handleClose(event);
|
|
86
86
|
socket.onmessage = async (message)=>await this.handleMessage(message);
|
|
@@ -114,8 +114,6 @@ export class DiscordenoShard {
|
|
|
114
114
|
if (!this.isOpen()) {
|
|
115
115
|
await this.connect();
|
|
116
116
|
}
|
|
117
|
-
// Wait until an identify is free for this this.
|
|
118
|
-
await this.requestIdentify();
|
|
119
117
|
this.send({
|
|
120
118
|
op: GatewayOpcodes.Identify,
|
|
121
119
|
d: {
|
|
@@ -133,6 +131,8 @@ export class DiscordenoShard {
|
|
|
133
131
|
return await new Promise((resolve)=>{
|
|
134
132
|
this.resolves.set('READY', ()=>{
|
|
135
133
|
this.events.identified?.(this);
|
|
134
|
+
// Tells the manager that this shard is ready
|
|
135
|
+
this.shardIsReady();
|
|
136
136
|
resolve();
|
|
137
137
|
});
|
|
138
138
|
// When identifying too fast,
|
|
@@ -148,7 +148,7 @@ export class DiscordenoShard {
|
|
|
148
148
|
return this.socket?.readyState === WebSocket.OPEN;
|
|
149
149
|
}
|
|
150
150
|
/** Attempt to resume the previous shards session with the gateway. */ async resume() {
|
|
151
|
-
|
|
151
|
+
logger.debug(`[Gateway] Resuming Shard #${this.id}`);
|
|
152
152
|
// It has been requested to resume the Shards session.
|
|
153
153
|
// It's possible that the shard is still connected with Discord's gateway therefore we need to forcefully close it.
|
|
154
154
|
if (this.isOpen()) {
|
|
@@ -156,12 +156,8 @@ export class DiscordenoShard {
|
|
|
156
156
|
}
|
|
157
157
|
// Shard has never identified, so we cannot resume.
|
|
158
158
|
if (!this.sessionId) {
|
|
159
|
-
|
|
160
|
-
// "GW DEBUG",
|
|
161
|
-
// `[Error] Trying to resume a shard (id: ${shardId}) that was not first identified.`,
|
|
162
|
-
// );
|
|
159
|
+
logger.debug(`[Shard] Trying to resume a shard #${this.id} that was NOT first identified. (No session id found)`);
|
|
163
160
|
return await this.identify();
|
|
164
|
-
// throw new Error(`[SHARD] Trying to resume a shard (id: ${this.id}) which was never identified`);
|
|
165
161
|
}
|
|
166
162
|
this.state = ShardState.Resuming;
|
|
167
163
|
// Before we can resume, we need to create a new connection with Discord's gateway.
|
|
@@ -229,6 +225,7 @@ export class DiscordenoShard {
|
|
|
229
225
|
case GatewayCloseEventCodes.RateLimited:
|
|
230
226
|
case GatewayCloseEventCodes.SessionTimedOut:
|
|
231
227
|
{
|
|
228
|
+
logger.debug(`[Shard] Gateway connection closing requiring re-identify. Code: ${close.code}`);
|
|
232
229
|
this.state = ShardState.Identifying;
|
|
233
230
|
this.events.disconnected?.(this);
|
|
234
231
|
return await this.identify();
|
|
@@ -318,8 +315,8 @@ export class DiscordenoShard {
|
|
|
318
315
|
}
|
|
319
316
|
case GatewayOpcodes.InvalidSession:
|
|
320
317
|
{
|
|
321
|
-
// gateway.debug("GW INVALID_SESSION", { shardId, payload: packet });
|
|
322
318
|
const resumable = packet.d;
|
|
319
|
+
logger.debug(`[Shard] Received Invalid Session for Shard #${this.id} with resumeable as ${resumable.toString()}`);
|
|
323
320
|
this.events.invalidSession?.(this, resumable);
|
|
324
321
|
// We need to wait for a random amount of time between 1 and 5
|
|
325
322
|
// Reference: https://discord.com/developers/docs/topics/gateway#resuming
|
|
@@ -328,7 +325,7 @@ export class DiscordenoShard {
|
|
|
328
325
|
this.resolves.delete('INVALID_SESSION');
|
|
329
326
|
// When resumable is false we need to re-identify
|
|
330
327
|
if (!resumable) {
|
|
331
|
-
await this.
|
|
328
|
+
await this.requestIdentify();
|
|
332
329
|
break;
|
|
333
330
|
}
|
|
334
331
|
// The session is invalid but apparently it is resumable
|
|
@@ -362,6 +359,9 @@ export class DiscordenoShard {
|
|
|
362
359
|
if (packet.s !== null) {
|
|
363
360
|
this.previousSequenceNumber = packet.s;
|
|
364
361
|
}
|
|
362
|
+
this.forwardToBot(packet);
|
|
363
|
+
}
|
|
364
|
+
forwardToBot(packet) {
|
|
365
365
|
// The necessary handling required for the Shards connection has been finished.
|
|
366
366
|
// Now the event can be safely forwarded.
|
|
367
367
|
this.events.message?.(this, camelize(packet));
|
|
@@ -386,8 +386,11 @@ export class DiscordenoShard {
|
|
|
386
386
|
return;
|
|
387
387
|
}
|
|
388
388
|
/** This function communicates with the management process, in order to know whether its free to identify. When this function resolves, this means that the shard is allowed to send an identify payload to discord. */ async requestIdentify() {}
|
|
389
|
+
/** This function communicates with the management process, in order to tell it can identify the next shard. */ async shardIsReady() {}
|
|
389
390
|
/** Start sending heartbeat payloads to Discord in the provided interval. */ startHeartbeating(interval) {
|
|
390
|
-
//
|
|
391
|
+
// If old heartbeast exist like after resume, clear the old ones.
|
|
392
|
+
if (this.heart.intervalId) clearInterval(this.heart.intervalId);
|
|
393
|
+
if (this.heart.timeoutId) clearTimeout(this.heart.timeoutId);
|
|
391
394
|
this.heart.interval = interval;
|
|
392
395
|
// Only set the shard's state to `Unidentified`
|
|
393
396
|
// if heartbeating has not been started due to an identify or resume action.
|
|
@@ -421,6 +424,7 @@ export class DiscordenoShard {
|
|
|
421
424
|
// The Shard needs to start a re-identify action accordingly.
|
|
422
425
|
// Reference: https://discord.com/developers/docs/topics/gateway#heartbeating-example-gateway-heartbeat-ack
|
|
423
426
|
if (!this.heart.acknowledged) {
|
|
427
|
+
logger.debug(`[Shard] Heartbeat not acknowledged for shard #${this.id}.`);
|
|
424
428
|
this.close(ShardSocketCloseCodes.ZombiedConnection, 'Zombied connection, did not receive an heartbeat ACK in time.');
|
|
425
429
|
return await this.identify();
|
|
426
430
|
}
|
|
@@ -458,7 +462,7 @@ export class DiscordenoShard {
|
|
|
458
462
|
* @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}
|
|
459
463
|
*/ async joinVoiceChannel(guildId, channelId, options) {
|
|
460
464
|
logger.debug(`[Shard] joinVoiceChannel guildId: ${guildId} channelId: ${channelId}`);
|
|
461
|
-
|
|
465
|
+
await this.send({
|
|
462
466
|
op: GatewayOpcodes.VoiceStateUpdate,
|
|
463
467
|
d: {
|
|
464
468
|
guild_id: guildId.toString(),
|
|
@@ -475,7 +479,7 @@ export class DiscordenoShard {
|
|
|
475
479
|
* @returns Promise<void>
|
|
476
480
|
*/ async editBotStatus(data) {
|
|
477
481
|
logger.debug(`[Shard] editBotStatus data: ${JSON.stringify(data)}`);
|
|
478
|
-
|
|
482
|
+
await this.editShardStatus(data);
|
|
479
483
|
}
|
|
480
484
|
/**
|
|
481
485
|
* Edits the bot's status on one shard.
|
|
@@ -485,7 +489,7 @@ export class DiscordenoShard {
|
|
|
485
489
|
* @returns Promise<void>
|
|
486
490
|
*/ async editShardStatus(data) {
|
|
487
491
|
logger.debug(`[Shard] editShardStatus shardId: ${this.id} -> data: ${JSON.stringify(data)}`);
|
|
488
|
-
|
|
492
|
+
await this.send({
|
|
489
493
|
op: GatewayOpcodes.PresenceUpdate,
|
|
490
494
|
d: {
|
|
491
495
|
since: null,
|
|
@@ -579,7 +583,7 @@ export class DiscordenoShard {
|
|
|
579
583
|
* @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}
|
|
580
584
|
*/ async leaveVoiceChannel(guildId) {
|
|
581
585
|
logger.debug(`[Shard] leaveVoiceChannel guildId: ${guildId} Shard ${this.id}`);
|
|
582
|
-
|
|
586
|
+
await this.send({
|
|
583
587
|
op: GatewayOpcodes.VoiceStateUpdate,
|
|
584
588
|
d: {
|
|
585
589
|
guild_id: guildId.toString(),
|
package/dist/Shard.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/Shard.ts"],"sourcesContent":["import type {\n AtLeastOne,\n BigString,\n Camelize,\n DiscordGatewayPayload,\n DiscordHello,\n DiscordMember,\n DiscordReady,\n RequestGuildMembers\n} from '@discordeno/types'\nimport { GatewayCloseEventCodes, GatewayIntents, GatewayOpcodes } from '@discordeno/types'\nimport { camelize, Collection, delay, LeakyBucket, logger } from '@discordeno/utils'\nimport { inflateSync } from 'node:zlib'\nimport WebSocket from 'ws'\nimport type { RequestMemberRequest } from './manager.js'\nimport type { BotStatusUpdate, ShardEvents, ShardGatewayConfig, ShardHeart, ShardSocketRequest, StatusUpdate, UpdateVoiceState } from './types.js'\nimport { ShardSocketCloseCodes, ShardState } from './types.js'\n\nexport class DiscordenoShard {\n /** The id of the shard */\n id: number\n /** The connection config details that this shard will used to connect to discord. */\n connection: ShardGatewayConfig\n /** This contains all the heartbeat information */\n heart: ShardHeart\n /** The maximum of requests which can be send to discord per rate limit tick. Typically this value should not be changed. */\n maxRequestsPerRateLimitTick: number = 120\n /** The previous payload sequence number. */\n previousSequenceNumber: number | null = null\n /** In which interval (in milliseconds) the gateway resets it's rate limit. */\n rateLimitResetInterval: number = 60000\n /** Current session id of the shard if present. */\n sessionId?: string\n /** This contains the WebSocket connection to Discord, if currently connected. */\n socket?: WebSocket\n /** Current internal state of the this. */\n state = ShardState.Offline\n /** The url provided by discord to use when resuming a connection for this this. */\n resumeGatewayUrl: string = ''\n /** The shard related event handlers. */\n events: ShardEvents = {}\n /** Cache for pending gateway requests which should have been send while the gateway went offline. */\n offlineSendQueue: Array<(_?: unknown) => void> = []\n /** Resolve internal waiting states. Mapped by SelectedEvents => ResolveFunction */\n resolves = new Map<'READY' | 'RESUMED' | 'INVALID_SESSION', (payload: DiscordGatewayPayload) => void>()\n /** Shard bucket. Only access this if you know what you are doing. Bucket for handling shard request rate limits. */\n bucket: LeakyBucket\n\n /** This managers cache related settings. */\n cache = {\n requestMembers: {\n /**\n * Whether or not request member requests should be cached.\n * @default false\n */\n enabled: false,\n /** The pending requests. */\n pending: new Collection<string, RequestMemberRequest>(),\n },\n }\n\n constructor(options: ShardCreateOptions) {\n this.id = options.id\n this.connection = options.connection\n this.events = options.events\n\n this.heart = {\n acknowledged: false,\n interval: 45000,\n }\n\n if (options.requestIdentify) this.requestIdentify = options.requestIdentify\n\n this.bucket = new LeakyBucket({\n max: this.calculateSafeRequests(),\n refillAmount: this.calculateSafeRequests(),\n refillInterval: 60000,\n })\n }\n\n /** The gateway configuration which is used to connect to Discord. */\n get gatewayConfig(): ShardGatewayConfig {\n return this.connection\n }\n\n /** Calculate the amount of requests which can safely be made per rate limit interval, before the gateway gets disconnected due to an exceeded rate limit. */\n calculateSafeRequests(): number {\n // * 2 adds extra safety layer for discords OP 1 requests that we need to respond to\n const safeRequests = this.maxRequestsPerRateLimitTick - Math.ceil(this.rateLimitResetInterval / this.heart.interval) * 2\n\n return safeRequests < 0 ? 0 : safeRequests\n }\n\n async checkOffline(highPriority: boolean): Promise<void> {\n if (!this.isOpen()) {\n await new Promise((resolve) => {\n // Higher priority requests get added at the beginning of the array.\n if (highPriority) this.offlineSendQueue.unshift(resolve)\n else this.offlineSendQueue.push(resolve)\n })\n }\n }\n\n /** Close the socket connection to discord if present. */\n close(code: number, reason: string): void {\n if (this.socket?.readyState !== WebSocket.OPEN) return\n\n return this.socket?.close(code, reason)\n }\n\n /** Connect the shard with the gateway and start heartbeating. This will not identify the shard to the gateway. */\n async connect(): Promise<DiscordenoShard> {\n // Only set the shard to `Connecting` state,\n // if the connection request does not come from an identify or resume action.\n if (![ShardState.Identifying, ShardState.Resuming].includes(this.state)) {\n this.state = ShardState.Connecting\n }\n this.events.connecting?.(this)\n\n let url = new URL(this.gatewayConfig.url)\n // If not connecting to a proxy but directly to discord need to handle resuming\n if (url.origin === 'wss://gateway.discord.gg') {\n if (this.state === ShardState.Resuming) {\n url = new URL(this.resumeGatewayUrl)\n }\n url.searchParams.set('v', this.gatewayConfig.version.toString())\n url.searchParams.set('encoding', 'json')\n }\n\n const socket = new WebSocket(url.toString())\n\n this.socket = socket\n\n // TODO: proper event handling\n socket.onerror = (event) => console.log({ error: event })\n\n socket.onclose = async (event) => await this.handleClose(event)\n\n socket.onmessage = async (message) => await this.handleMessage(message)\n\n return await new Promise((resolve) => {\n socket.onopen = () => {\n // Only set the shard to `Unidentified` state,\n // if the connection request does not come from an identify or resume action.\n if (![ShardState.Identifying, ShardState.Resuming].includes(this.state)) {\n this.state = ShardState.Unidentified\n }\n this.events.connected?.(this)\n\n resolve(this)\n }\n })\n }\n\n /** Identify the shard to the gateway. If not connected, this will also connect the shard to the gateway. */\n async identify(): Promise<void> {\n // A new identify has been requested even though there is already a connection open.\n // Therefore we need to close the old connection and heartbeating before creating a new one.\n if (this.isOpen()) {\n logger.debug(`CLOSING EXISTING SHARD: #${this.id}`)\n this.close(ShardSocketCloseCodes.ReIdentifying, 'Re-identifying closure of old connection.')\n }\n\n this.state = ShardState.Identifying\n this.events.identifying?.(this)\n\n // It is possible that the shard is in Heartbeating state but not identified,\n // so check whether there is already a gateway connection existing.\n // If not we need to create one before we identify.\n if (!this.isOpen()) {\n await this.connect()\n }\n\n // Wait until an identify is free for this this.\n await this.requestIdentify()\n\n this.send(\n {\n op: GatewayOpcodes.Identify,\n d: {\n token: `Bot ${this.gatewayConfig.token}`,\n compress: this.gatewayConfig.compress,\n properties: this.gatewayConfig.properties,\n intents: this.gatewayConfig.intents,\n shard: [this.id, this.gatewayConfig.totalShards],\n presence: await this.makePresence?.(),\n },\n },\n true,\n )\n\n return await new Promise((resolve) => {\n this.resolves.set('READY', () => {\n this.events.identified?.(this)\n resolve()\n })\n // When identifying too fast,\n // Discord sends an invalid session payload.\n // This can safely be ignored though and the shard starts a new identify action.\n this.resolves.set('INVALID_SESSION', () => {\n this.resolves.delete('READY')\n resolve()\n })\n })\n }\n\n /** Check whether the connection to Discord is currently open. */\n isOpen(): boolean {\n return this.socket?.readyState === WebSocket.OPEN\n }\n\n /** Attempt to resume the previous shards session with the gateway. */\n async resume(): Promise<void> {\n // gateway.debug(\"GW RESUMING\", { shardId });\n // It has been requested to resume the Shards session.\n // It's possible that the shard is still connected with Discord's gateway therefore we need to forcefully close it.\n if (this.isOpen()) {\n this.close(ShardSocketCloseCodes.ResumeClosingOldConnection, 'Reconnecting the shard, closing old connection.')\n }\n\n // Shard has never identified, so we cannot resume.\n if (!this.sessionId) {\n // gateway.debug(\n // \"GW DEBUG\",\n // `[Error] Trying to resume a shard (id: ${shardId}) that was not first identified.`,\n // );\n\n return await this.identify()\n\n // throw new Error(`[SHARD] Trying to resume a shard (id: ${this.id}) which was never identified`);\n }\n\n this.state = ShardState.Resuming\n\n // Before we can resume, we need to create a new connection with Discord's gateway.\n await this.connect()\n\n this.send(\n {\n op: GatewayOpcodes.Resume,\n d: {\n token: `Bot ${this.gatewayConfig.token}`,\n session_id: this.sessionId,\n seq: this.previousSequenceNumber ?? 0,\n },\n },\n true,\n )\n\n return await new Promise((resolve) => {\n this.resolves.set('RESUMED', () => resolve())\n // If it is attempted to resume with an invalid session id,\n // Discord sends an invalid session payload\n // Not erroring here since it is easy that this happens, also it would be not catchable\n this.resolves.set('INVALID_SESSION', () => {\n this.resolves.delete('RESUMED')\n resolve()\n })\n })\n }\n\n /** Send a message to Discord.\n * @param {boolean} [highPriority=false] - Whether this message should be send asap.\n */\n async send(message: ShardSocketRequest, highPriority = false): Promise<void> {\n // Before acquiring a token from the bucket, check whether the shard is currently offline or not.\n // Else bucket and token wait time just get wasted.\n await this.checkOffline(highPriority)\n\n await this.bucket.acquire(highPriority)\n\n // It's possible, that the shard went offline after a token has been acquired from the bucket.\n await this.checkOffline(highPriority)\n\n this.socket?.send(JSON.stringify(message))\n }\n\n /** Shutdown the this. Forcefully disconnect the shard from Discord. The shard may not attempt to reconnect with Discord. */\n async shutdown(): Promise<void> {\n this.close(ShardSocketCloseCodes.Shutdown, 'Shard shutting down.')\n this.state = ShardState.Offline\n }\n\n /** Handle a gateway connection close. */\n async handleClose(close: WebSocket.CloseEvent): Promise<void> {\n // gateway.debug(\"GW CLOSED\", { shardId, payload: event });\n\n this.stopHeartbeating()\n\n switch (close.code) {\n case ShardSocketCloseCodes.TestingFinished: {\n this.state = ShardState.Offline\n this.events.disconnected?.(this)\n\n return\n }\n // On these codes a manual start will be done.\n case ShardSocketCloseCodes.Shutdown:\n case ShardSocketCloseCodes.ReIdentifying:\n case ShardSocketCloseCodes.Resharded:\n case ShardSocketCloseCodes.ResumeClosingOldConnection:\n case ShardSocketCloseCodes.ZombiedConnection: {\n this.state = ShardState.Disconnected\n this.events.disconnected?.(this)\n\n // gateway.debug(\"GW CLOSED_RECONNECT\", { shardId, payload: event });\n return\n }\n // Gateway connection closes which require a new identify.\n case GatewayCloseEventCodes.UnknownOpcode:\n case GatewayCloseEventCodes.NotAuthenticated:\n case GatewayCloseEventCodes.InvalidSeq:\n case GatewayCloseEventCodes.RateLimited:\n case GatewayCloseEventCodes.SessionTimedOut: {\n this.state = ShardState.Identifying\n this.events.disconnected?.(this)\n\n return await this.identify()\n }\n // When these codes are received something went really wrong.\n // On those we cannot start a reconnect attempt.\n case GatewayCloseEventCodes.AuthenticationFailed:\n case GatewayCloseEventCodes.InvalidShard:\n case GatewayCloseEventCodes.ShardingRequired:\n case GatewayCloseEventCodes.InvalidApiVersion:\n case GatewayCloseEventCodes.InvalidIntents:\n case GatewayCloseEventCodes.DisallowedIntents: {\n this.state = ShardState.Offline\n this.events.disconnected?.(this)\n\n throw new Error(close.reason || 'Discord gave no reason! GG! You broke Discord!')\n }\n // Gateway connection closes on which a resume is allowed.\n case GatewayCloseEventCodes.UnknownError:\n case GatewayCloseEventCodes.DecodeError:\n case GatewayCloseEventCodes.AlreadyAuthenticated:\n default: {\n this.state = ShardState.Resuming\n this.events.disconnected?.(this)\n\n return await this.resume()\n }\n }\n }\n\n /** Handles a incoming gateway packet. */\n async handleDiscordPacket(packet: DiscordGatewayPayload): Promise<void> {\n // Edge case start: https://github.com/discordeno/discordeno/issues/2311\n this.heart.lastAck = Date.now()\n // Manually calculating the round trip time for users who need it.\n if (this.heart.lastBeat && !this.heart.acknowledged) {\n this.heart.rtt = this.heart.lastAck - this.heart.lastBeat\n }\n this.heart.acknowledged = true\n // Edge case end!\n\n switch (packet.op) {\n case GatewayOpcodes.Heartbeat: {\n // TODO: can this actually happen\n if (!this.isOpen()) return\n\n this.heart.lastBeat = Date.now()\n // Discord randomly sends this requiring an immediate heartbeat back.\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n this.events.heartbeat?.(this)\n\n break\n }\n case GatewayOpcodes.Hello: {\n const interval = (packet.d as DiscordHello).heartbeat_interval\n\n this.startHeartbeating(interval)\n\n if (this.state !== ShardState.Resuming) {\n const currentQueue = [...this.bucket.queue];\n // HELLO has been send on a non resume action.\n // This means that the shard starts a new session,\n // therefore the rate limit interval has been reset too.\n this.bucket = new LeakyBucket({\n max: this.calculateSafeRequests(),\n refillInterval: 60000,\n refillAmount: this.calculateSafeRequests(),\n })\n\n // Queue should not be lost on a re-identify.\n this.bucket.queue.unshift(...currentQueue);\n }\n\n this.events.hello?.(this)\n\n break\n }\n case GatewayOpcodes.HeartbeatACK: {\n this.events.heartbeatAck?.(this)\n\n break\n }\n case GatewayOpcodes.Reconnect: {\n // gateway.debug(\"GW RECONNECT\", { shardId });\n\n this.events.requestedReconnect?.(this)\n\n await this.resume()\n\n break\n }\n case GatewayOpcodes.InvalidSession: {\n // gateway.debug(\"GW INVALID_SESSION\", { shardId, payload: packet });\n const resumable = packet.d as boolean\n\n this.events.invalidSession?.(this, resumable)\n\n // We need to wait for a random amount of time between 1 and 5\n // Reference: https://discord.com/developers/docs/topics/gateway#resuming\n await delay(Math.floor((Math.random() * 4 + 1) * 1000))\n\n this.resolves.get('INVALID_SESSION')?.(packet)\n this.resolves.delete('INVALID_SESSION')\n\n // When resumable is false we need to re-identify\n if (!resumable) {\n await this.identify()\n\n break\n }\n\n // The session is invalid but apparently it is resumable\n await this.resume()\n\n break\n }\n }\n\n if (packet.t === 'RESUMED') {\n // gateway.debug(\"GW RESUMED\", { shardId });\n\n this.state = ShardState.Connected\n this.events.resumed?.(this)\n\n // Continue the requests which have been queued since the shard went offline.\n this.offlineSendQueue.map((resolve) => resolve())\n\n this.resolves.get('RESUMED')?.(packet)\n this.resolves.delete('RESUMED')\n } else if (packet.t === 'READY') {\n // Important for future resumes.\n\n const payload = packet.d as DiscordReady\n\n this.resumeGatewayUrl = payload.resume_gateway_url\n\n this.sessionId = payload.session_id\n this.state = ShardState.Connected\n\n // Continue the requests which have been queued since the shard went offline.\n // Important when this is a re-identify\n this.offlineSendQueue.map((resolve) => resolve())\n\n this.resolves.get('READY')?.(packet)\n this.resolves.delete('READY')\n }\n\n // Update the sequence number if it is present\n // `s` can be either `null` or a `number`.\n // In order to prevent update misses when `s` is `0` we check against null.\n if (packet.s !== null) {\n this.previousSequenceNumber = packet.s\n }\n\n // The necessary handling required for the Shards connection has been finished.\n // Now the event can be safely forwarded.\n this.events.message?.(this, camelize(packet))\n }\n\n /** Handle an incoming gateway message. */\n async handleMessage(message: WebSocket.MessageEvent): Promise<void> {\n let preProcessMessage = message.data\n\n // If message compression is enabled,\n // Discord might send zlib compressed payloads.\n if (this.gatewayConfig.compress && preProcessMessage instanceof Blob) {\n preProcessMessage = inflateSync(await preProcessMessage.arrayBuffer()).toString()\n }\n\n // Safeguard incase decompression failed to make a string.\n if (typeof preProcessMessage !== 'string') return\n\n return await this.handleDiscordPacket(JSON.parse(preProcessMessage) as DiscordGatewayPayload)\n }\n\n /**\n * Override in order to make the shards presence.\n * async in case devs create the presence based on eg. database values.\n * Passing the shard's id there to make it easier for the dev to use this function.\n */\n async makePresence(): Promise<BotStatusUpdate | undefined> {\n // eslint-disable-next-line no-useless-return\n return\n }\n\n /** This function communicates with the management process, in order to know whether its free to identify. When this function resolves, this means that the shard is allowed to send an identify payload to discord. */\n async requestIdentify(): Promise<void> {}\n\n /** Start sending heartbeat payloads to Discord in the provided interval. */\n startHeartbeating(interval: number): void {\n // gateway.debug(\"GW HEARTBEATING_STARTED\", { shardId, interval });\n\n this.heart.interval = interval\n\n // Only set the shard's state to `Unidentified`\n // if heartbeating has not been started due to an identify or resume action.\n if ([ShardState.Disconnected, ShardState.Offline].includes(this.state)) {\n this.state = ShardState.Unidentified\n }\n\n // The first heartbeat needs to be send with a random delay between `0` and `interval`\n // Using a `setTimeout(_, jitter)` here to accomplish that.\n // `Math.random()` can be `0` so we use `0.5` if this happens\n // Reference: https://discord.com/developers/docs/topics/gateway#heartbeating\n const jitter = Math.ceil(this.heart.interval * (Math.random() || 0.5))\n this.heart.timeoutId = setTimeout(() => {\n if (!this.isOpen()) return\n\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n\n this.heart.lastBeat = Date.now()\n this.heart.acknowledged = false\n\n // After the random heartbeat jitter we can start a normal interval.\n this.heart.intervalId = setInterval(async () => {\n if (!this.isOpen()) return\n // gateway.debug(\"GW DEBUG\", `Running setInterval in heartbeat file. Shard: ${shardId}`);\n\n // gateway.debug(\"GW HEARTBEATING\", { shardId, shard: currentShard });\n\n // The Shard did not receive a heartbeat ACK from Discord in time,\n // therefore we have to assume that the connection has failed or got \"zombied\".\n // The Shard needs to start a re-identify action accordingly.\n // Reference: https://discord.com/developers/docs/topics/gateway#heartbeating-example-gateway-heartbeat-ack\n if (!this.heart.acknowledged) {\n this.close(ShardSocketCloseCodes.ZombiedConnection, 'Zombied connection, did not receive an heartbeat ACK in time.')\n\n return await this.identify()\n }\n\n this.heart.acknowledged = false\n\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n\n this.heart.lastBeat = Date.now()\n\n this.events.heartbeat?.(this)\n }, this.heart.interval)\n }, jitter)\n }\n\n /** Stop the heartbeating process with discord. */\n stopHeartbeating(): void {\n // Clear the regular heartbeat interval.\n clearInterval(this.heart.intervalId)\n // It's possible that the Shard got closed before the first jittered heartbeat.\n // To go safe we should clear the related timeout too.\n clearTimeout(this.heart.timeoutId)\n }\n\n /**\n * Connects the bot user to a voice or stage channel.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n * @param channelId - The ID of the channel you want to join.\n *\n * @remarks\n * Requires the `CONNECT` permission.\n *\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n async joinVoiceChannel(\n guildId: BigString,\n channelId: BigString,\n options?: AtLeastOne<Omit<UpdateVoiceState, 'guildId' | 'channelId'>>,\n ): Promise<void> {\n logger.debug(`[Shard] joinVoiceChannel guildId: ${guildId} channelId: ${channelId}`)\n return await this.send({\n op: GatewayOpcodes.VoiceStateUpdate,\n d: {\n guild_id: guildId.toString(),\n channel_id: channelId.toString(),\n self_mute: Boolean(options?.selfMute),\n self_deaf: options?.selfDeaf ?? true,\n },\n })\n }\n\n /**\n * Edits the bot status in all shards that this gateway manages.\n *\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n async editBotStatus(data: StatusUpdate): Promise<void> {\n logger.debug(`[Shard] editBotStatus data: ${JSON.stringify(data)}`)\n return await this.editShardStatus(data)\n }\n\n /**\n * Edits the bot's status on one shard.\n *\n * @param shardId The shard id to edit the status for.\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n async editShardStatus(data: StatusUpdate): Promise<void> {\n logger.debug(`[Shard] editShardStatus shardId: ${this.id} -> data: ${JSON.stringify(data)}`)\n return await this.send({\n op: GatewayOpcodes.PresenceUpdate,\n d: {\n since: null,\n afk: false,\n activities: data.activities,\n status: data.status,\n },\n })\n }\n\n /**\n * Fetches the list of members for a guild over the gateway.\n *\n * @param guildId - The ID of the guild to get the list of members for.\n * @param options - The parameters for the fetching of the members.\n *\n * @remarks\n * If requesting the entire member list:\n * - Requires the `GUILD_MEMBERS` intent.\n *\n * If requesting presences ({@link RequestGuildMembers.presences | presences} set to `true`):\n * - Requires the `GUILD_PRESENCES` intent.\n *\n * If requesting a prefix ({@link RequestGuildMembers.query | query} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * If requesting a users by ID ({@link RequestGuildMembers.userIds | userIds} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * Fires a _Guild Members Chunk_ gateway event for every 1000 members fetched.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#request-guild-members}\n */\n async requestMembers(guildId: BigString, options?: Omit<RequestGuildMembers, 'guildId'>): Promise<Camelize<DiscordMember[]>> {\n // You can request 1 member without the intent\n // Check if intents is not 0 as proxy ws won't set intents in other instances\n if (this.connection.intents && (!options?.limit || options.limit > 1) && !(this.connection.intents & GatewayIntents.GuildMembers)) {\n throw new Error('MISSING_INTENT_GUILD_MEMBERS')\n }\n\n if (options?.userIds?.length) {\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> setting user limit based on userIds length: ${options.userIds.length}`)\n options.limit = options.userIds.length\n }\n\n const nonce = `${guildId}-${Date.now()}`\n\n // Gateway does not require caching these requests so directly send and return\n if (!this.cache.requestMembers?.enabled) {\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> skipping cache -> options ${JSON.stringify(options)}`)\n await this.send({\n op: GatewayOpcodes.RequestGuildMembers,\n d: {\n guild_id: guildId.toString(),\n // If a query is provided use it, OR if a limit is NOT provided use \"\"\n query: options?.query ?? (options?.limit ? undefined : ''),\n limit: options?.limit ?? 0,\n presences: options?.presences ?? false,\n user_ids: options?.userIds?.map((id) => id.toString()),\n nonce,\n },\n })\n return []\n }\n\n return await new Promise((resolve) => {\n this.cache.requestMembers?.pending.set(nonce, { nonce, resolve, members: [] })\n\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> requesting members -> data: ${JSON.stringify(options)}`)\n this.send({\n op: GatewayOpcodes.RequestGuildMembers,\n d: {\n guild_id: guildId.toString(),\n // If a query is provided use it, OR if a limit is NOT provided use \"\"\n query: options?.query ?? (options?.limit ? undefined : ''),\n limit: options?.limit ?? 0,\n presences: options?.presences ?? false,\n user_ids: options?.userIds?.map((id) => id.toString()),\n nonce,\n },\n })\n })\n }\n\n /**\n * Leaves the voice channel the bot user is currently in.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n *\n * @remarks\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n async leaveVoiceChannel(guildId: BigString): Promise<void> {\n logger.debug(`[Shard] leaveVoiceChannel guildId: ${guildId} Shard ${this.id}`)\n return await this.send({\n op: GatewayOpcodes.VoiceStateUpdate,\n d: {\n guild_id: guildId.toString(),\n channel_id: null,\n self_mute: false,\n self_deaf: false,\n },\n })\n }\n}\n\nexport interface ShardCreateOptions {\n /** The shard id */\n id: number\n /** The connection details */\n connection: ShardGatewayConfig\n /** The event handlers for events on the shard. */\n events: ShardEvents\n /** The handler to request a space to make an identify request. */\n requestIdentify?: () => Promise<void>\n}\n\nexport default DiscordenoShard\n"],"names":["GatewayCloseEventCodes","GatewayIntents","GatewayOpcodes","camelize","Collection","delay","LeakyBucket","logger","inflateSync","WebSocket","ShardSocketCloseCodes","ShardState","DiscordenoShard","maxRequestsPerRateLimitTick","previousSequenceNumber","rateLimitResetInterval","state","Offline","resumeGatewayUrl","events","offlineSendQueue","resolves","Map","cache","requestMembers","enabled","pending","constructor","options","id","connection","heart","acknowledged","interval","requestIdentify","bucket","max","calculateSafeRequests","refillAmount","refillInterval","gatewayConfig","safeRequests","Math","ceil","checkOffline","highPriority","isOpen","Promise","resolve","unshift","push","close","code","reason","socket","readyState","OPEN","connect","Identifying","Resuming","includes","Connecting","connecting","url","URL","origin","searchParams","set","version","toString","onerror","event","console","log","error","onclose","handleClose","onmessage","message","handleMessage","onopen","Unidentified","connected","identify","debug","ReIdentifying","identifying","send","op","Identify","d","token","compress","properties","intents","shard","totalShards","presence","makePresence","identified","delete","resume","ResumeClosingOldConnection","sessionId","Resume","session_id","seq","acquire","JSON","stringify","shutdown","Shutdown","stopHeartbeating","TestingFinished","disconnected","Resharded","ZombiedConnection","Disconnected","UnknownOpcode","NotAuthenticated","InvalidSeq","RateLimited","SessionTimedOut","AuthenticationFailed","InvalidShard","ShardingRequired","InvalidApiVersion","InvalidIntents","DisallowedIntents","Error","UnknownError","DecodeError","AlreadyAuthenticated","handleDiscordPacket","packet","lastAck","Date","now","lastBeat","rtt","Heartbeat","heartbeat","Hello","heartbeat_interval","startHeartbeating","currentQueue","queue","hello","HeartbeatACK","heartbeatAck","Reconnect","requestedReconnect","InvalidSession","resumable","invalidSession","floor","random","get","t","Connected","resumed","map","payload","resume_gateway_url","s","preProcessMessage","data","Blob","arrayBuffer","parse","jitter","timeoutId","setTimeout","intervalId","setInterval","clearInterval","clearTimeout","joinVoiceChannel","guildId","channelId","VoiceStateUpdate","guild_id","channel_id","self_mute","Boolean","selfMute","self_deaf","selfDeaf","editBotStatus","editShardStatus","PresenceUpdate","since","afk","activities","status","limit","GuildMembers","userIds","length","nonce","RequestGuildMembers","query","undefined","presences","user_ids","members","leaveVoiceChannel"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["../src/Shard.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-confusing-void-expression */\nimport type {\n AtLeastOne,\n BigString,\n Camelize,\n DiscordGatewayPayload,\n DiscordHello,\n DiscordMember,\n DiscordReady,\n RequestGuildMembers,\n} from '@discordeno/types'\nimport { GatewayCloseEventCodes, GatewayIntents, GatewayOpcodes } from '@discordeno/types'\nimport { Collection, LeakyBucket, camelize, delay, logger } from '@discordeno/utils'\nimport { inflateSync } from 'node:zlib'\nimport WebSocket from 'ws'\nimport type { RequestMemberRequest } from './manager.js'\nimport type { BotStatusUpdate, ShardEvents, ShardGatewayConfig, ShardHeart, ShardSocketRequest, StatusUpdate, UpdateVoiceState } from './types.js'\nimport { ShardSocketCloseCodes, ShardState } from './types.js'\n\nexport class DiscordenoShard {\n /** The id of the shard */\n id: number\n /** The connection config details that this shard will used to connect to discord. */\n connection: ShardGatewayConfig\n /** This contains all the heartbeat information */\n heart: ShardHeart\n /** The maximum of requests which can be send to discord per rate limit tick. Typically this value should not be changed. */\n maxRequestsPerRateLimitTick: number = 120\n /** The previous payload sequence number. */\n previousSequenceNumber: number | null = null\n /** In which interval (in milliseconds) the gateway resets it's rate limit. */\n rateLimitResetInterval: number = 60000\n /** Current session id of the shard if present. */\n sessionId?: string\n /** This contains the WebSocket connection to Discord, if currently connected. */\n socket?: WebSocket\n /** Current internal state of the this. */\n state = ShardState.Offline\n /** The url provided by discord to use when resuming a connection for this this. */\n resumeGatewayUrl: string = ''\n /** The shard related event handlers. */\n events: ShardEvents = {}\n /** Cache for pending gateway requests which should have been send while the gateway went offline. */\n offlineSendQueue: Array<(_?: unknown) => void> = []\n /** Resolve internal waiting states. Mapped by SelectedEvents => ResolveFunction */\n resolves = new Map<'READY' | 'RESUMED' | 'INVALID_SESSION', (payload: DiscordGatewayPayload) => void>()\n /** Shard bucket. Only access this if you know what you are doing. Bucket for handling shard request rate limits. */\n bucket: LeakyBucket\n\n /** This managers cache related settings. */\n cache = {\n requestMembers: {\n /**\n * Whether or not request member requests should be cached.\n * @default false\n */\n enabled: false,\n /** The pending requests. */\n pending: new Collection<string, RequestMemberRequest>(),\n },\n }\n\n constructor(options: ShardCreateOptions) {\n this.id = options.id\n this.connection = options.connection\n this.events = options.events\n\n this.heart = {\n acknowledged: false,\n interval: 45000,\n }\n\n if (options.requestIdentify) this.requestIdentify = options.requestIdentify\n if (options.shardIsReady) this.shardIsReady = options.shardIsReady\n\n this.bucket = new LeakyBucket({\n max: this.calculateSafeRequests(),\n refillAmount: this.calculateSafeRequests(),\n refillInterval: 60000,\n })\n }\n\n /** The gateway configuration which is used to connect to Discord. */\n get gatewayConfig(): ShardGatewayConfig {\n return this.connection\n }\n\n /** The url to connect to. Intially this is the discord gateway url, and then is switched to resume gateway url once a READY is received. */\n get connectionUrl(): string {\n // Use || and not ?? here. ?? will cause a bug.\n return this.resumeGatewayUrl || this.gatewayConfig.url\n }\n\n /** Calculate the amount of requests which can safely be made per rate limit interval, before the gateway gets disconnected due to an exceeded rate limit. */\n calculateSafeRequests(): number {\n // * 2 adds extra safety layer for discords OP 1 requests that we need to respond to\n const safeRequests = this.maxRequestsPerRateLimitTick - Math.ceil(this.rateLimitResetInterval / this.heart.interval) * 2\n\n return safeRequests < 0 ? 0 : safeRequests\n }\n\n async checkOffline(highPriority: boolean): Promise<void> {\n if (!this.isOpen()) {\n await new Promise((resolve) => {\n // Higher priority requests get added at the beginning of the array.\n if (highPriority) this.offlineSendQueue.unshift(resolve)\n else this.offlineSendQueue.push(resolve)\n })\n }\n }\n\n /** Close the socket connection to discord if present. */\n close(code: number, reason: string): void {\n if (this.socket?.readyState !== WebSocket.OPEN) return\n\n this.socket?.close(code, reason)\n }\n\n /** Connect the shard with the gateway and start heartbeating. This will not identify the shard to the gateway. */\n async connect(): Promise<DiscordenoShard> {\n // Only set the shard to `Connecting` state,\n // if the connection request does not come from an identify or resume action.\n if (![ShardState.Identifying, ShardState.Resuming].includes(this.state)) {\n this.state = ShardState.Connecting\n }\n this.events.connecting?.(this)\n\n const url = new URL(this.connectionUrl)\n url.searchParams.set('v', this.gatewayConfig.version.toString())\n url.searchParams.set('encoding', 'json')\n\n const socket = new WebSocket(url.toString())\n this.socket = socket\n\n // TODO: proper event handling\n socket.onerror = (event) => console.log({ error: event, shardId: this.id })\n socket.onclose = async (event) => await this.handleClose(event)\n socket.onmessage = async (message) => await this.handleMessage(message)\n\n return await new Promise((resolve) => {\n socket.onopen = () => {\n // Only set the shard to `Unidentified` state,\n // if the connection request does not come from an identify or resume action.\n if (![ShardState.Identifying, ShardState.Resuming].includes(this.state)) {\n this.state = ShardState.Unidentified\n }\n this.events.connected?.(this)\n\n resolve(this)\n }\n })\n }\n\n /** Identify the shard to the gateway. If not connected, this will also connect the shard to the gateway. */\n async identify(): Promise<void> {\n // A new identify has been requested even though there is already a connection open.\n // Therefore we need to close the old connection and heartbeating before creating a new one.\n if (this.isOpen()) {\n logger.debug(`CLOSING EXISTING SHARD: #${this.id}`)\n this.close(ShardSocketCloseCodes.ReIdentifying, 'Re-identifying closure of old connection.')\n }\n\n this.state = ShardState.Identifying\n this.events.identifying?.(this)\n\n // It is possible that the shard is in Heartbeating state but not identified,\n // so check whether there is already a gateway connection existing.\n // If not we need to create one before we identify.\n if (!this.isOpen()) {\n await this.connect()\n }\n\n this.send(\n {\n op: GatewayOpcodes.Identify,\n d: {\n token: `Bot ${this.gatewayConfig.token}`,\n compress: this.gatewayConfig.compress,\n properties: this.gatewayConfig.properties,\n intents: this.gatewayConfig.intents,\n shard: [this.id, this.gatewayConfig.totalShards],\n presence: await this.makePresence?.(),\n },\n },\n true,\n )\n\n return await new Promise((resolve) => {\n this.resolves.set('READY', () => {\n this.events.identified?.(this)\n // Tells the manager that this shard is ready\n this.shardIsReady()\n resolve()\n })\n // When identifying too fast,\n // Discord sends an invalid session payload.\n // This can safely be ignored though and the shard starts a new identify action.\n this.resolves.set('INVALID_SESSION', () => {\n this.resolves.delete('READY')\n resolve()\n })\n })\n }\n\n /** Check whether the connection to Discord is currently open. */\n isOpen(): boolean {\n return this.socket?.readyState === WebSocket.OPEN\n }\n\n /** Attempt to resume the previous shards session with the gateway. */\n async resume(): Promise<void> {\n logger.debug(`[Gateway] Resuming Shard #${this.id}`)\n // It has been requested to resume the Shards session.\n // It's possible that the shard is still connected with Discord's gateway therefore we need to forcefully close it.\n if (this.isOpen()) {\n this.close(ShardSocketCloseCodes.ResumeClosingOldConnection, 'Reconnecting the shard, closing old connection.')\n }\n\n // Shard has never identified, so we cannot resume.\n if (!this.sessionId) {\n logger.debug(`[Shard] Trying to resume a shard #${this.id} that was NOT first identified. (No session id found)`)\n\n return await this.identify()\n }\n\n this.state = ShardState.Resuming\n\n // Before we can resume, we need to create a new connection with Discord's gateway.\n await this.connect()\n\n this.send(\n {\n op: GatewayOpcodes.Resume,\n d: {\n token: `Bot ${this.gatewayConfig.token}`,\n session_id: this.sessionId,\n seq: this.previousSequenceNumber ?? 0,\n },\n },\n true,\n )\n\n return await new Promise((resolve) => {\n this.resolves.set('RESUMED', () => resolve())\n // If it is attempted to resume with an invalid session id,\n // Discord sends an invalid session payload\n // Not erroring here since it is easy that this happens, also it would be not catchable\n this.resolves.set('INVALID_SESSION', () => {\n this.resolves.delete('RESUMED')\n resolve()\n })\n })\n }\n\n /** Send a message to Discord.\n * @param {boolean} [highPriority=false] - Whether this message should be send asap.\n */\n async send(message: ShardSocketRequest, highPriority = false): Promise<void> {\n // Before acquiring a token from the bucket, check whether the shard is currently offline or not.\n // Else bucket and token wait time just get wasted.\n await this.checkOffline(highPriority)\n\n await this.bucket.acquire(highPriority)\n\n // It's possible, that the shard went offline after a token has been acquired from the bucket.\n await this.checkOffline(highPriority)\n\n this.socket?.send(JSON.stringify(message))\n }\n\n /** Shutdown the this. Forcefully disconnect the shard from Discord. The shard may not attempt to reconnect with Discord. */\n async shutdown(): Promise<void> {\n this.close(ShardSocketCloseCodes.Shutdown, 'Shard shutting down.')\n this.state = ShardState.Offline\n }\n\n /** Handle a gateway connection close. */\n async handleClose(close: WebSocket.CloseEvent): Promise<void> {\n // gateway.debug(\"GW CLOSED\", { shardId, payload: event });\n\n this.stopHeartbeating()\n\n switch (close.code) {\n case ShardSocketCloseCodes.TestingFinished: {\n this.state = ShardState.Offline\n this.events.disconnected?.(this)\n\n return\n }\n // On these codes a manual start will be done.\n case ShardSocketCloseCodes.Shutdown:\n case ShardSocketCloseCodes.ReIdentifying:\n case ShardSocketCloseCodes.Resharded:\n case ShardSocketCloseCodes.ResumeClosingOldConnection:\n case ShardSocketCloseCodes.ZombiedConnection: {\n this.state = ShardState.Disconnected\n this.events.disconnected?.(this)\n\n // gateway.debug(\"GW CLOSED_RECONNECT\", { shardId, payload: event });\n return\n }\n // Gateway connection closes which require a new identify.\n case GatewayCloseEventCodes.UnknownOpcode:\n case GatewayCloseEventCodes.NotAuthenticated:\n case GatewayCloseEventCodes.InvalidSeq:\n case GatewayCloseEventCodes.RateLimited:\n case GatewayCloseEventCodes.SessionTimedOut: {\n logger.debug(`[Shard] Gateway connection closing requiring re-identify. Code: ${close.code}`)\n this.state = ShardState.Identifying\n this.events.disconnected?.(this)\n\n return await this.identify()\n }\n // When these codes are received something went really wrong.\n // On those we cannot start a reconnect attempt.\n case GatewayCloseEventCodes.AuthenticationFailed:\n case GatewayCloseEventCodes.InvalidShard:\n case GatewayCloseEventCodes.ShardingRequired:\n case GatewayCloseEventCodes.InvalidApiVersion:\n case GatewayCloseEventCodes.InvalidIntents:\n case GatewayCloseEventCodes.DisallowedIntents: {\n this.state = ShardState.Offline\n this.events.disconnected?.(this)\n\n throw new Error(close.reason || 'Discord gave no reason! GG! You broke Discord!')\n }\n // Gateway connection closes on which a resume is allowed.\n case GatewayCloseEventCodes.UnknownError:\n case GatewayCloseEventCodes.DecodeError:\n case GatewayCloseEventCodes.AlreadyAuthenticated:\n default: {\n this.state = ShardState.Resuming\n this.events.disconnected?.(this)\n\n return await this.resume()\n }\n }\n }\n\n /** Handles a incoming gateway packet. */\n async handleDiscordPacket(packet: DiscordGatewayPayload): Promise<void> {\n // Edge case start: https://github.com/discordeno/discordeno/issues/2311\n this.heart.lastAck = Date.now()\n // Manually calculating the round trip time for users who need it.\n if (this.heart.lastBeat && !this.heart.acknowledged) {\n this.heart.rtt = this.heart.lastAck - this.heart.lastBeat\n }\n this.heart.acknowledged = true\n // Edge case end!\n\n switch (packet.op) {\n case GatewayOpcodes.Heartbeat: {\n // TODO: can this actually happen\n if (!this.isOpen()) return\n\n this.heart.lastBeat = Date.now()\n // Discord randomly sends this requiring an immediate heartbeat back.\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n this.events.heartbeat?.(this)\n\n break\n }\n case GatewayOpcodes.Hello: {\n const interval = (packet.d as DiscordHello).heartbeat_interval\n\n this.startHeartbeating(interval)\n\n if (this.state !== ShardState.Resuming) {\n const currentQueue = [...this.bucket.queue]\n // HELLO has been send on a non resume action.\n // This means that the shard starts a new session,\n // therefore the rate limit interval has been reset too.\n this.bucket = new LeakyBucket({\n max: this.calculateSafeRequests(),\n refillInterval: 60000,\n refillAmount: this.calculateSafeRequests(),\n })\n\n // Queue should not be lost on a re-identify.\n this.bucket.queue.unshift(...currentQueue)\n }\n\n this.events.hello?.(this)\n\n break\n }\n case GatewayOpcodes.HeartbeatACK: {\n this.events.heartbeatAck?.(this)\n\n break\n }\n case GatewayOpcodes.Reconnect: {\n // gateway.debug(\"GW RECONNECT\", { shardId });\n\n this.events.requestedReconnect?.(this)\n\n await this.resume()\n\n break\n }\n case GatewayOpcodes.InvalidSession: {\n const resumable = packet.d as boolean\n logger.debug(`[Shard] Received Invalid Session for Shard #${this.id} with resumeable as ${resumable.toString()}`)\n\n this.events.invalidSession?.(this, resumable)\n\n // We need to wait for a random amount of time between 1 and 5\n // Reference: https://discord.com/developers/docs/topics/gateway#resuming\n await delay(Math.floor((Math.random() * 4 + 1) * 1000))\n\n this.resolves.get('INVALID_SESSION')?.(packet)\n this.resolves.delete('INVALID_SESSION')\n\n // When resumable is false we need to re-identify\n if (!resumable) {\n await this.requestIdentify()\n\n break\n }\n\n // The session is invalid but apparently it is resumable\n await this.resume()\n\n break\n }\n }\n\n if (packet.t === 'RESUMED') {\n // gateway.debug(\"GW RESUMED\", { shardId });\n\n this.state = ShardState.Connected\n this.events.resumed?.(this)\n\n // Continue the requests which have been queued since the shard went offline.\n this.offlineSendQueue.map((resolve) => resolve())\n\n this.resolves.get('RESUMED')?.(packet)\n this.resolves.delete('RESUMED')\n } else if (packet.t === 'READY') {\n // Important for future resumes.\n\n const payload = packet.d as DiscordReady\n\n this.resumeGatewayUrl = payload.resume_gateway_url\n\n this.sessionId = payload.session_id\n this.state = ShardState.Connected\n\n // Continue the requests which have been queued since the shard went offline.\n // Important when this is a re-identify\n this.offlineSendQueue.map((resolve) => resolve())\n\n this.resolves.get('READY')?.(packet)\n this.resolves.delete('READY')\n }\n\n // Update the sequence number if it is present\n // `s` can be either `null` or a `number`.\n // In order to prevent update misses when `s` is `0` we check against null.\n if (packet.s !== null) {\n this.previousSequenceNumber = packet.s\n }\n\n this.forwardToBot(packet)\n }\n\n forwardToBot(packet: DiscordGatewayPayload): void {\n // The necessary handling required for the Shards connection has been finished.\n // Now the event can be safely forwarded.\n this.events.message?.(this, camelize(packet))\n }\n\n /** Handle an incoming gateway message. */\n async handleMessage(message: WebSocket.MessageEvent): Promise<void> {\n let preProcessMessage = message.data\n\n // If message compression is enabled,\n // Discord might send zlib compressed payloads.\n if (this.gatewayConfig.compress && preProcessMessage instanceof Blob) {\n preProcessMessage = inflateSync(await preProcessMessage.arrayBuffer()).toString()\n }\n\n // Safeguard incase decompression failed to make a string.\n if (typeof preProcessMessage !== 'string') return\n\n return await this.handleDiscordPacket(JSON.parse(preProcessMessage) as DiscordGatewayPayload)\n }\n\n /**\n * Override in order to make the shards presence.\n * async in case devs create the presence based on eg. database values.\n * Passing the shard's id there to make it easier for the dev to use this function.\n */\n async makePresence(): Promise<BotStatusUpdate | undefined> {\n // eslint-disable-next-line no-useless-return\n return\n }\n\n /** This function communicates with the management process, in order to know whether its free to identify. When this function resolves, this means that the shard is allowed to send an identify payload to discord. */\n async requestIdentify(): Promise<void> {}\n\n /** This function communicates with the management process, in order to tell it can identify the next shard. */\n async shardIsReady(): Promise<void> {}\n\n /** Start sending heartbeat payloads to Discord in the provided interval. */\n startHeartbeating(interval: number): void {\n // If old heartbeast exist like after resume, clear the old ones.\n if (this.heart.intervalId) clearInterval(this.heart.intervalId)\n if (this.heart.timeoutId) clearTimeout(this.heart.timeoutId)\n\n this.heart.interval = interval\n\n // Only set the shard's state to `Unidentified`\n // if heartbeating has not been started due to an identify or resume action.\n if ([ShardState.Disconnected, ShardState.Offline].includes(this.state)) {\n this.state = ShardState.Unidentified\n }\n\n // The first heartbeat needs to be send with a random delay between `0` and `interval`\n // Using a `setTimeout(_, jitter)` here to accomplish that.\n // `Math.random()` can be `0` so we use `0.5` if this happens\n // Reference: https://discord.com/developers/docs/topics/gateway#heartbeating\n const jitter = Math.ceil(this.heart.interval * (Math.random() || 0.5))\n this.heart.timeoutId = setTimeout(() => {\n if (!this.isOpen()) return\n\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n\n this.heart.lastBeat = Date.now()\n this.heart.acknowledged = false\n\n // After the random heartbeat jitter we can start a normal interval.\n this.heart.intervalId = setInterval(async () => {\n if (!this.isOpen()) return\n // gateway.debug(\"GW DEBUG\", `Running setInterval in heartbeat file. Shard: ${shardId}`);\n\n // gateway.debug(\"GW HEARTBEATING\", { shardId, shard: currentShard });\n\n // The Shard did not receive a heartbeat ACK from Discord in time,\n // therefore we have to assume that the connection has failed or got \"zombied\".\n // The Shard needs to start a re-identify action accordingly.\n // Reference: https://discord.com/developers/docs/topics/gateway#heartbeating-example-gateway-heartbeat-ack\n if (!this.heart.acknowledged) {\n logger.debug(`[Shard] Heartbeat not acknowledged for shard #${this.id}.`)\n this.close(ShardSocketCloseCodes.ZombiedConnection, 'Zombied connection, did not receive an heartbeat ACK in time.')\n\n return await this.identify()\n }\n\n this.heart.acknowledged = false\n\n // Using a direct socket.send call here because heartbeat requests are reserved by us.\n this.socket?.send(\n JSON.stringify({\n op: GatewayOpcodes.Heartbeat,\n d: this.previousSequenceNumber,\n }),\n )\n\n this.heart.lastBeat = Date.now()\n\n this.events.heartbeat?.(this)\n }, this.heart.interval)\n }, jitter)\n }\n\n /** Stop the heartbeating process with discord. */\n stopHeartbeating(): void {\n // Clear the regular heartbeat interval.\n clearInterval(this.heart.intervalId)\n // It's possible that the Shard got closed before the first jittered heartbeat.\n // To go safe we should clear the related timeout too.\n clearTimeout(this.heart.timeoutId)\n }\n\n /**\n * Connects the bot user to a voice or stage channel.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n * @param channelId - The ID of the channel you want to join.\n *\n * @remarks\n * Requires the `CONNECT` permission.\n *\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n async joinVoiceChannel(\n guildId: BigString,\n channelId: BigString,\n options?: AtLeastOne<Omit<UpdateVoiceState, 'guildId' | 'channelId'>>,\n ): Promise<void> {\n logger.debug(`[Shard] joinVoiceChannel guildId: ${guildId} channelId: ${channelId}`)\n await this.send({\n op: GatewayOpcodes.VoiceStateUpdate,\n d: {\n guild_id: guildId.toString(),\n channel_id: channelId.toString(),\n self_mute: Boolean(options?.selfMute),\n self_deaf: options?.selfDeaf ?? true,\n },\n })\n }\n\n /**\n * Edits the bot status in all shards that this gateway manages.\n *\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n async editBotStatus(data: StatusUpdate): Promise<void> {\n logger.debug(`[Shard] editBotStatus data: ${JSON.stringify(data)}`)\n await this.editShardStatus(data)\n }\n\n /**\n * Edits the bot's status on one shard.\n *\n * @param shardId The shard id to edit the status for.\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n async editShardStatus(data: StatusUpdate): Promise<void> {\n logger.debug(`[Shard] editShardStatus shardId: ${this.id} -> data: ${JSON.stringify(data)}`)\n await this.send({\n op: GatewayOpcodes.PresenceUpdate,\n d: {\n since: null,\n afk: false,\n activities: data.activities,\n status: data.status,\n },\n })\n }\n\n /**\n * Fetches the list of members for a guild over the gateway.\n *\n * @param guildId - The ID of the guild to get the list of members for.\n * @param options - The parameters for the fetching of the members.\n *\n * @remarks\n * If requesting the entire member list:\n * - Requires the `GUILD_MEMBERS` intent.\n *\n * If requesting presences ({@link RequestGuildMembers.presences | presences} set to `true`):\n * - Requires the `GUILD_PRESENCES` intent.\n *\n * If requesting a prefix ({@link RequestGuildMembers.query | query} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * If requesting a users by ID ({@link RequestGuildMembers.userIds | userIds} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * Fires a _Guild Members Chunk_ gateway event for every 1000 members fetched.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#request-guild-members}\n */\n async requestMembers(guildId: BigString, options?: Omit<RequestGuildMembers, 'guildId'>): Promise<Camelize<DiscordMember[]>> {\n // You can request 1 member without the intent\n // Check if intents is not 0 as proxy ws won't set intents in other instances\n if (this.connection.intents && (!options?.limit || options.limit > 1) && !(this.connection.intents & GatewayIntents.GuildMembers)) {\n throw new Error('MISSING_INTENT_GUILD_MEMBERS')\n }\n\n if (options?.userIds?.length) {\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> setting user limit based on userIds length: ${options.userIds.length}`)\n options.limit = options.userIds.length\n }\n\n const nonce = `${guildId}-${Date.now()}`\n\n // Gateway does not require caching these requests so directly send and return\n if (!this.cache.requestMembers?.enabled) {\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> skipping cache -> options ${JSON.stringify(options)}`)\n await this.send({\n op: GatewayOpcodes.RequestGuildMembers,\n d: {\n guild_id: guildId.toString(),\n // If a query is provided use it, OR if a limit is NOT provided use \"\"\n query: options?.query ?? (options?.limit ? undefined : ''),\n limit: options?.limit ?? 0,\n presences: options?.presences ?? false,\n user_ids: options?.userIds?.map((id) => id.toString()),\n nonce,\n },\n })\n return []\n }\n\n return await new Promise((resolve) => {\n this.cache.requestMembers?.pending.set(nonce, { nonce, resolve, members: [] })\n\n logger.debug(`[Shard] requestMembers guildId: ${guildId} -> requesting members -> data: ${JSON.stringify(options)}`)\n this.send({\n op: GatewayOpcodes.RequestGuildMembers,\n d: {\n guild_id: guildId.toString(),\n // If a query is provided use it, OR if a limit is NOT provided use \"\"\n query: options?.query ?? (options?.limit ? undefined : ''),\n limit: options?.limit ?? 0,\n presences: options?.presences ?? false,\n user_ids: options?.userIds?.map((id) => id.toString()),\n nonce,\n },\n })\n })\n }\n\n /**\n * Leaves the voice channel the bot user is currently in.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n *\n * @remarks\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n async leaveVoiceChannel(guildId: BigString): Promise<void> {\n logger.debug(`[Shard] leaveVoiceChannel guildId: ${guildId} Shard ${this.id}`)\n await this.send({\n op: GatewayOpcodes.VoiceStateUpdate,\n d: {\n guild_id: guildId.toString(),\n channel_id: null,\n self_mute: false,\n self_deaf: false,\n },\n })\n }\n}\n\nexport interface ShardCreateOptions {\n /** The shard id */\n id: number\n /** The connection details */\n connection: ShardGatewayConfig\n /** The event handlers for events on the shard. */\n events: ShardEvents\n /** The handler to request a space to make an identify request. */\n requestIdentify?: () => Promise<void>\n /** The handler to alert the gateway manager that this shard has received a READY event. */\n shardIsReady?: () => Promise<void>\n}\n\nexport default DiscordenoShard\n"],"names":["GatewayCloseEventCodes","GatewayIntents","GatewayOpcodes","Collection","LeakyBucket","camelize","delay","logger","inflateSync","WebSocket","ShardSocketCloseCodes","ShardState","DiscordenoShard","constructor","options","maxRequestsPerRateLimitTick","previousSequenceNumber","rateLimitResetInterval","state","Offline","resumeGatewayUrl","events","offlineSendQueue","resolves","Map","cache","requestMembers","enabled","pending","id","connection","heart","acknowledged","interval","requestIdentify","shardIsReady","bucket","max","calculateSafeRequests","refillAmount","refillInterval","gatewayConfig","connectionUrl","url","safeRequests","Math","ceil","checkOffline","highPriority","isOpen","Promise","resolve","unshift","push","close","code","reason","socket","readyState","OPEN","connect","Identifying","Resuming","includes","Connecting","connecting","URL","searchParams","set","version","toString","onerror","event","console","log","error","shardId","onclose","handleClose","onmessage","message","handleMessage","onopen","Unidentified","connected","identify","debug","ReIdentifying","identifying","send","op","Identify","d","token","compress","properties","intents","shard","totalShards","presence","makePresence","identified","delete","resume","ResumeClosingOldConnection","sessionId","Resume","session_id","seq","acquire","JSON","stringify","shutdown","Shutdown","stopHeartbeating","TestingFinished","disconnected","Resharded","ZombiedConnection","Disconnected","UnknownOpcode","NotAuthenticated","InvalidSeq","RateLimited","SessionTimedOut","AuthenticationFailed","InvalidShard","ShardingRequired","InvalidApiVersion","InvalidIntents","DisallowedIntents","Error","UnknownError","DecodeError","AlreadyAuthenticated","handleDiscordPacket","packet","lastAck","Date","now","lastBeat","rtt","Heartbeat","heartbeat","Hello","heartbeat_interval","startHeartbeating","currentQueue","queue","hello","HeartbeatACK","heartbeatAck","Reconnect","requestedReconnect","InvalidSession","resumable","invalidSession","floor","random","get","t","Connected","resumed","map","payload","resume_gateway_url","s","forwardToBot","preProcessMessage","data","Blob","arrayBuffer","parse","intervalId","clearInterval","timeoutId","clearTimeout","jitter","setTimeout","setInterval","joinVoiceChannel","guildId","channelId","VoiceStateUpdate","guild_id","channel_id","self_mute","Boolean","selfMute","self_deaf","selfDeaf","editBotStatus","editShardStatus","PresenceUpdate","since","afk","activities","status","limit","GuildMembers","userIds","length","nonce","RequestGuildMembers","query","undefined","presences","user_ids","members","leaveVoiceChannel"],"mappings":"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"}
|
package/dist/manager.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { AtLeastOne, BigString, Camelize, DiscordGetGatewayBot, DiscordMember, RequestGuildMembers } from '@discordeno/types';
|
|
2
|
-
import { Collection
|
|
2
|
+
import { Collection } from '@discordeno/utils';
|
|
3
3
|
import Shard from './Shard.js';
|
|
4
4
|
import type { ShardEvents, StatusUpdate, UpdateVoiceState } from './types.js';
|
|
5
5
|
export declare function createGatewayManager(options: CreateGatewayManagerOptions): GatewayManager;
|
|
@@ -19,6 +19,11 @@ export interface CreateGatewayManagerOptions {
|
|
|
19
19
|
* @default 5300
|
|
20
20
|
*/
|
|
21
21
|
spawnShardDelay?: number;
|
|
22
|
+
/**
|
|
23
|
+
* Whether to send the discord packets in snake case form.
|
|
24
|
+
* @default false
|
|
25
|
+
*/
|
|
26
|
+
preferSnakeCase?: boolean;
|
|
22
27
|
/**
|
|
23
28
|
* Total amount of shards your bot uses. Useful for zero-downtime updates or resharding.
|
|
24
29
|
* @default 1
|
|
@@ -98,7 +103,8 @@ export interface GatewayManager extends Required<CreateGatewayManagerOptions> {
|
|
|
98
103
|
id: number;
|
|
99
104
|
queue: number[];
|
|
100
105
|
}>;
|
|
101
|
-
|
|
106
|
+
/** Requests to identify shards are made based on whether it is available to be made. */
|
|
107
|
+
identifyRequests: Array<(value: void | PromiseLike<void>) => void>;
|
|
102
108
|
}>;
|
|
103
109
|
/** The shards that are created. */
|
|
104
110
|
shards: Map<number, Shard>;
|
|
@@ -118,7 +124,7 @@ export interface GatewayManager extends Required<CreateGatewayManagerOptions> {
|
|
|
118
124
|
identify: (shardId: number) => Promise<void>;
|
|
119
125
|
/** Kill a shard. Close a shards connection to Discord's gateway (if any) and remove it from the manager. */
|
|
120
126
|
kill: (shardId: number) => Promise<void>;
|
|
121
|
-
/** This function
|
|
127
|
+
/** This function makes sure that the bucket is allowed to make the next identify request. */
|
|
122
128
|
requestIdentify: (shardId: number) => Promise<void>;
|
|
123
129
|
/** Calculates the number of shards based on the guild id and total shards. */
|
|
124
130
|
calculateShardId: (guildId: BigString, totalShards?: number) => number;
|
package/dist/manager.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"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"}
|
package/dist/manager.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Collection, delay,
|
|
1
|
+
/* eslint-disable @typescript-eslint/no-confusing-void-expression */ import { Collection, delay, logger } from '@discordeno/utils';
|
|
2
2
|
import Shard from './Shard.js';
|
|
3
3
|
export function createGatewayManager(options) {
|
|
4
4
|
if (!options.connection) {
|
|
@@ -32,6 +32,7 @@ export function createGatewayManager(options) {
|
|
|
32
32
|
totalWorkers: options.totalWorkers ?? 4,
|
|
33
33
|
shardsPerWorker: options.shardsPerWorker ?? 25,
|
|
34
34
|
spawnShardDelay: options.spawnShardDelay ?? 5300,
|
|
35
|
+
preferSnakeCase: false,
|
|
35
36
|
shards: new Map(),
|
|
36
37
|
buckets: new Map(),
|
|
37
38
|
cache: {
|
|
@@ -52,13 +53,7 @@ export function createGatewayManager(options) {
|
|
|
52
53
|
(gateway.connection.sessionStartLimit.maxConcurrency === 1 ? 16 : gateway.connection.sessionStartLimit.maxConcurrency)) * gateway.connection.sessionStartLimit.maxConcurrency;
|
|
53
54
|
},
|
|
54
55
|
calculateWorkerId (shardId) {
|
|
55
|
-
|
|
56
|
-
let workerId = Math.floor(shardId / gateway.shardsPerWorker);
|
|
57
|
-
// If the workerId overflows the maximal allowed workers we by default just use to last worker.
|
|
58
|
-
if (workerId >= gateway.totalWorkers) {
|
|
59
|
-
// The Id of the last available worker is total -1
|
|
60
|
-
workerId = gateway.totalWorkers - 1;
|
|
61
|
-
}
|
|
56
|
+
const workerId = shardId % gateway.shardsPerWorker;
|
|
62
57
|
logger.debug(`[Gateway] Calculating workerId: Shard: ${shardId} -> Worker: ${workerId} -> Per Worker: ${gateway.shardsPerWorker} -> Total: ${gateway.totalWorkers}`);
|
|
63
58
|
return workerId;
|
|
64
59
|
},
|
|
@@ -67,9 +62,7 @@ export function createGatewayManager(options) {
|
|
|
67
62
|
logger.debug(`[Gateway] Preparing buckets for concurrency: ${i}`);
|
|
68
63
|
gateway.buckets.set(i, {
|
|
69
64
|
workers: [],
|
|
70
|
-
|
|
71
|
-
refillInterval: gateway.spawnShardDelay
|
|
72
|
-
})
|
|
65
|
+
identifyRequests: []
|
|
73
66
|
});
|
|
74
67
|
}
|
|
75
68
|
// ORGANIZE ALL SHARDS INTO THEIR OWN BUCKETS
|
|
@@ -99,6 +92,12 @@ export function createGatewayManager(options) {
|
|
|
99
92
|
});
|
|
100
93
|
}
|
|
101
94
|
}
|
|
95
|
+
for (const bucket of gateway.buckets.values()){
|
|
96
|
+
for (const worker of bucket.workers.values()){
|
|
97
|
+
// eslint-disable-next-line @typescript-eslint/require-array-sort-compare
|
|
98
|
+
worker.queue = worker.queue.sort((a, b)=>a - b);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
102
101
|
},
|
|
103
102
|
async spawnShards () {
|
|
104
103
|
// PREPARES ALL SHARDS IN SPECIFIC BUCKETS
|
|
@@ -120,7 +119,7 @@ export function createGatewayManager(options) {
|
|
|
120
119
|
},
|
|
121
120
|
async tellWorkerToIdentify (workerId, shardId, bucketId) {
|
|
122
121
|
logger.debug(`[Gateway] tell worker to identify (${workerId}, ${shardId}, ${bucketId})`);
|
|
123
|
-
|
|
122
|
+
await gateway.identify(shardId);
|
|
124
123
|
},
|
|
125
124
|
async identify (shardId) {
|
|
126
125
|
let shard = this.shards.get(shardId);
|
|
@@ -139,15 +138,31 @@ export function createGatewayManager(options) {
|
|
|
139
138
|
},
|
|
140
139
|
events: options.events,
|
|
141
140
|
requestIdentify: async ()=>{
|
|
142
|
-
await gateway.
|
|
141
|
+
await gateway.identify(shardId);
|
|
142
|
+
},
|
|
143
|
+
shardIsReady: async ()=>{
|
|
144
|
+
logger.debug(`[Shard] Shard #${shardId} is ready`);
|
|
145
|
+
await delay(gateway.spawnShardDelay);
|
|
146
|
+
logger.debug(`[Shard] Resolving shard identify request`);
|
|
147
|
+
gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency).identifyRequests.shift()?.();
|
|
143
148
|
}
|
|
144
149
|
});
|
|
150
|
+
if (this.preferSnakeCase) {
|
|
151
|
+
shard.forwardToBot = async (payload)=>{
|
|
152
|
+
options.events.message?.(shard, payload);
|
|
153
|
+
};
|
|
154
|
+
}
|
|
145
155
|
this.shards.set(shardId, shard);
|
|
146
156
|
}
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
157
|
+
const bucket = gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency);
|
|
158
|
+
if (!bucket) return;
|
|
159
|
+
return await new Promise((resolve)=>{
|
|
160
|
+
// Mark that we are making an identify request so another is not made.
|
|
161
|
+
bucket.identifyRequests.push(resolve);
|
|
162
|
+
logger.debug(`[Gateway] identifying shard #(${shardId}).`);
|
|
163
|
+
// This will trigger identify and when READY is received it will resolve the above request.
|
|
164
|
+
shard?.identify();
|
|
165
|
+
});
|
|
151
166
|
},
|
|
152
167
|
async kill (shardId) {
|
|
153
168
|
const shard = this.shards.get(shardId);
|
|
@@ -156,11 +171,15 @@ export function createGatewayManager(options) {
|
|
|
156
171
|
}
|
|
157
172
|
logger.debug(`[Gateway] kill shard (${shardId})`);
|
|
158
173
|
this.shards.delete(shardId);
|
|
159
|
-
|
|
174
|
+
await shard.shutdown();
|
|
160
175
|
},
|
|
161
176
|
async requestIdentify (shardId) {
|
|
162
177
|
logger.debug(`[Gateway] requesting identify`);
|
|
163
|
-
|
|
178
|
+
// const bucket = gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)
|
|
179
|
+
// if (!bucket) return
|
|
180
|
+
// return await new Promise((resolve) => {
|
|
181
|
+
// bucket.identifyRequests.push(resolve)
|
|
182
|
+
// })
|
|
164
183
|
},
|
|
165
184
|
// Helpers methods below this
|
|
166
185
|
calculateShardId (guildId, totalShards) {
|
|
@@ -197,7 +216,7 @@ export function createGatewayManager(options) {
|
|
|
197
216
|
throw new Error(`Shard (id: ${shardId}) not found.`);
|
|
198
217
|
}
|
|
199
218
|
logger.debug(`[Gateway] editShardStatus shardId: ${shardId} -> data: ${JSON.stringify(data)}`);
|
|
200
|
-
|
|
219
|
+
await shard.editShardStatus(data);
|
|
201
220
|
},
|
|
202
221
|
async requestMembers (guildId, options) {
|
|
203
222
|
const shardId = gateway.calculateShardId(guildId);
|
|
@@ -215,7 +234,7 @@ export function createGatewayManager(options) {
|
|
|
215
234
|
throw new Error(`Shard (id: ${shardId} not found`);
|
|
216
235
|
}
|
|
217
236
|
logger.debug(`[Gateway] leaveVoiceChannel guildId: ${guildId} Shard ${shardId}`);
|
|
218
|
-
|
|
237
|
+
await shard.leaveVoiceChannel(guildId);
|
|
219
238
|
}
|
|
220
239
|
};
|
|
221
240
|
return gateway;
|
package/dist/manager.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/manager.ts"],"sourcesContent":["import type { AtLeastOne, BigString, Camelize, DiscordGetGatewayBot, DiscordMember, RequestGuildMembers } from '@discordeno/types'\nimport { Collection, delay, LeakyBucket, logger } from '@discordeno/utils'\nimport Shard from './Shard.js'\nimport type { ShardEvents, StatusUpdate, UpdateVoiceState } from './types.js'\n\nexport function createGatewayManager(options: CreateGatewayManagerOptions): GatewayManager {\n if (!options.connection) {\n options.connection = {\n url: 'wss://gateway.discord.gg',\n shards: 1,\n sessionStartLimit: {\n maxConcurrency: 1,\n remaining: 1000,\n total: 1000,\n resetAfter: 1000 * 60 * 60 * 24,\n },\n }\n }\n\n const gateway: GatewayManager = {\n events: options.events,\n compress: options.compress ?? false,\n intents: options.intents ?? 0,\n properties: {\n os: options.properties?.os ?? process.platform,\n browser: options.properties?.browser ?? 'Discordeno',\n device: options.properties?.device ?? 'Discordeno',\n },\n token: options.token,\n url: options.url ?? options.connection.url ?? 'wss://gateway.discord.gg',\n version: options.version ?? 10,\n connection: options.connection,\n totalShards: options.totalShards ?? options.connection.shards ?? 1,\n lastShardId: options.lastShardId ?? 0,\n firstShardId: options.firstShardId ?? 0,\n totalWorkers: options.totalWorkers ?? 4,\n shardsPerWorker: options.shardsPerWorker ?? 25,\n spawnShardDelay: options.spawnShardDelay ?? 5300,\n shards: new Map(),\n buckets: new Map(),\n cache: {\n requestMembers: {\n enabled: options.cache?.requestMembers?.enabled ?? false,\n pending: new Collection(),\n },\n },\n\n calculateTotalShards() {\n // Bots under 100k servers do not have access to total shards.\n if (gateway.totalShards < 100) {\n logger.debug(`[Gateway] Calculating total shards: ${gateway.totalShards}`)\n return gateway.totalShards\n }\n\n logger.debug(`[Gateway] Calculating total shards`, gateway.totalShards, gateway.connection.sessionStartLimit.maxConcurrency)\n // Calculate a multiple of `maxConcurrency` which can be used to connect to the gateway.\n return (\n Math.ceil(\n gateway.totalShards /\n // If `maxConcurrency` is 1 we can safely use 16.\n (gateway.connection.sessionStartLimit.maxConcurrency === 1 ? 16 : gateway.connection.sessionStartLimit.maxConcurrency),\n ) * gateway.connection.sessionStartLimit.maxConcurrency\n )\n },\n calculateWorkerId(shardId) {\n // Ignore decimal numbers.\n let workerId = Math.floor(shardId / gateway.shardsPerWorker)\n // If the workerId overflows the maximal allowed workers we by default just use to last worker.\n if (workerId >= gateway.totalWorkers) {\n // The Id of the last available worker is total -1\n workerId = gateway.totalWorkers - 1\n }\n\n logger.debug(\n `[Gateway] Calculating workerId: Shard: ${shardId} -> Worker: ${workerId} -> Per Worker: ${gateway.shardsPerWorker} -> Total: ${gateway.totalWorkers}`,\n )\n\n return workerId\n },\n prepareBuckets() {\n for (let i = 0; i < gateway.connection.sessionStartLimit.maxConcurrency; ++i) {\n logger.debug(`[Gateway] Preparing buckets for concurrency: ${i}`)\n gateway.buckets.set(i, {\n workers: [],\n leak: new LeakyBucket({\n refillInterval: gateway.spawnShardDelay,\n }),\n })\n }\n\n // ORGANIZE ALL SHARDS INTO THEIR OWN BUCKETS\n for (let shardId = gateway.firstShardId; shardId <= gateway.lastShardId; ++shardId) {\n logger.debug(`[Gateway] Preparing buckets for shard: ${shardId}`)\n if (shardId >= gateway.totalShards) {\n throw new Error(`Shard (id: ${shardId}) is bigger or equal to the used amount of used shards which is ${gateway.totalShards}`)\n }\n\n const bucketId = shardId % gateway.connection.sessionStartLimit.maxConcurrency\n const bucket = gateway.buckets.get(bucketId)\n if (!bucket) {\n throw new Error(\n `Shard (id: ${shardId}) got assigned to an illegal bucket id: ${bucketId}, expected a bucket id between 0 and ${\n gateway.connection.sessionStartLimit.maxConcurrency - 1\n }`,\n )\n }\n\n // FIND A QUEUE IN THIS BUCKET THAT HAS SPACE\n // const worker = bucket.workers.find((w) => w.queue.length < gateway.shardsPerWorker);\n const workerId = gateway.calculateWorkerId(shardId)\n const worker = bucket.workers.find((w) => w.id === workerId)\n if (worker) {\n // IF THE QUEUE HAS SPACE JUST ADD IT TO THIS QUEUE\n worker.queue.push(shardId)\n } else {\n bucket.workers.push({ id: workerId, queue: [shardId] })\n }\n }\n },\n async spawnShards() {\n // PREPARES ALL SHARDS IN SPECIFIC BUCKETS\n gateway.prepareBuckets()\n\n // Prefer concurrency of forEach instead of forof\n await Promise.all(\n [...gateway.buckets.entries()].map(async ([bucketId, bucket]) => {\n for (const worker of bucket.workers) {\n for (const shardId of worker.queue) {\n await gateway.tellWorkerToIdentify(worker.id, shardId, bucketId)\n }\n }\n }),\n )\n },\n async shutdown(code, reason) {\n gateway.shards.forEach((shard) => shard.close(code, reason))\n\n await delay(5000)\n },\n async tellWorkerToIdentify(workerId, shardId, bucketId) {\n logger.debug(`[Gateway] tell worker to identify (${workerId}, ${shardId}, ${bucketId})`)\n return await gateway.identify(shardId)\n },\n async identify(shardId: number) {\n let shard = this.shards.get(shardId)\n logger.debug(`[Gateway] identifying ${shard ? 'existing' : 'new'} shard (${shardId})`)\n\n if (!shard) {\n shard = new Shard({\n id: shardId,\n connection: {\n compress: this.compress,\n intents: this.intents,\n properties: this.properties,\n token: this.token,\n totalShards: this.totalShards,\n url: this.url,\n version: this.version,\n },\n events: options.events,\n requestIdentify: async () => {\n await gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)!.leak.acquire()\n },\n })\n\n this.shards.set(shardId, shard)\n }\n\n logger.debug(`[Gateway] requesting to identify shard #(${shardId}) from bucket.`)\n await gateway.requestIdentify(shard.id)\n logger.debug(`[Gateway] Identify request successful for shard #(${shardId}).`)\n return await shard.identify()\n },\n async kill(shardId: number) {\n const shard = this.shards.get(shardId)\n if (!shard) {\n return logger.debug(`[Gateway] kill shard but not found (${shardId})`)\n }\n\n logger.debug(`[Gateway] kill shard (${shardId})`)\n this.shards.delete(shardId)\n return await shard.shutdown()\n },\n\n async requestIdentify(shardId: number) {\n logger.debug(`[Gateway] requesting identify`)\n await gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)!.leak.acquire()\n },\n\n // Helpers methods below this\n\n calculateShardId(guildId, totalShards) {\n // If none is provided, use the total shards number from gateway object.\n if (!totalShards) totalShards = gateway.totalShards\n // If it is only 1 shard, it will always be shard id 0\n if (totalShards === 1) {\n logger.debug(`[Gateway] calculateShardId (1 shard)`)\n return 0\n }\n\n logger.debug(`[Gateway] calculateShardId (guildId: ${guildId}, totalShards: ${totalShards})`)\n return Number((BigInt(guildId) >> 22n) % BigInt(totalShards))\n },\n\n async joinVoiceChannel(guildId, channelId, options) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId} not found`)\n }\n\n logger.debug(`[Gateway] joinVoiceChannel guildId: ${guildId} channelId: ${channelId}`)\n shard.joinVoiceChannel(guildId, channelId, options)\n },\n\n async editBotStatus(data) {\n logger.debug(`[Gateway] editBotStatus data: ${JSON.stringify(data)}`)\n await Promise.all(\n [...gateway.shards.values()].map(async (shard) => {\n gateway.editShardStatus(shard.id, data)\n }),\n )\n },\n\n async editShardStatus(shardId, data) {\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId}) not found.`)\n }\n\n logger.debug(`[Gateway] editShardStatus shardId: ${shardId} -> data: ${JSON.stringify(data)}`)\n return await shard.editShardStatus(data)\n },\n\n async requestMembers(guildId, options) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId}) not found.`)\n }\n\n logger.debug(`[Gateway] requestMembers guildId: ${guildId} -> options ${JSON.stringify(options)}`)\n return await shard.requestMembers(guildId, options)\n },\n\n async leaveVoiceChannel(guildId) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId} not found`)\n }\n\n logger.debug(`[Gateway] leaveVoiceChannel guildId: ${guildId} Shard ${shardId}`)\n return await shard.leaveVoiceChannel(guildId)\n },\n }\n\n return gateway\n}\n\nexport interface CreateGatewayManagerOptions {\n /**\n * Id of the first Shard which should get controlled by this manager.\n * @default 0\n */\n firstShardId?: number\n /**\n * Id of the last Shard which should get controlled by this manager.\n * @default 0\n */\n lastShardId?: number\n /**\n * Delay in milliseconds to wait before spawning next shard. OPTIMAL IS ABOVE 5100. YOU DON'T WANT TO HIT THE RATE LIMIT!!!\n * @default 5300\n */\n spawnShardDelay?: number\n /**\n * Total amount of shards your bot uses. Useful for zero-downtime updates or resharding.\n * @default 1\n */\n totalShards?: number\n /**\n * The amount of shards to load per worker.\n * @default 25\n */\n shardsPerWorker?: number\n /**\n * The total amount of workers to use for your bot.\n * @default 4\n */\n totalWorkers?: number\n /** Important data which is used by the manager to connect shards to the gateway. */\n connection?: Camelize<DiscordGetGatewayBot>\n /** Whether incoming payloads are compressed using zlib.\n *\n * @default false\n */\n compress?: boolean\n /** The calculated intent value of the events which the shard should receive.\n *\n * @default 0\n */\n intents?: number\n /** Identify properties to use */\n properties?: {\n /** Operating system the shard runs on.\n *\n * @default \"darwin\" | \"linux\" | \"windows\"\n */\n os: string\n /** The \"browser\" where this shard is running on.\n *\n * @default \"Discordeno\"\n */\n browser: string\n /** The device on which the shard is running.\n *\n * @default \"Discordeno\"\n */\n device: string\n }\n /** Bot token which is used to connect to Discord */\n token: string\n /** The URL of the gateway which should be connected to.\n *\n * @default \"wss://gateway.discord.gg\"\n */\n url?: string\n /** The gateway version which should be used.\n *\n * @default 10\n */\n version?: number\n /** The events handlers */\n events: ShardEvents\n /** This managers cache related settings. */\n cache?: {\n requestMembers?: {\n /**\n * Whether or not request member requests should be cached.\n * @default false\n */\n enabled?: boolean\n /** The pending requests. */\n pending: Collection<string, RequestMemberRequest>\n }\n }\n}\n\nexport interface GatewayManager extends Required<CreateGatewayManagerOptions> {\n /** The max concurrency buckets. Those will be created when the `spawnShards` (which calls `prepareBuckets` under the hood) function gets called. */\n buckets: Map<\n number,\n {\n workers: Array<{ id: number; queue: number[] }>\n leak: LeakyBucket\n }\n >\n /** The shards that are created. */\n shards: Map<number, Shard>\n /** Determine max number of shards to use based upon the max concurrency. */\n calculateTotalShards: () => number\n /** Determine the id of the worker which is handling a shard. */\n calculateWorkerId: (shardId: number) => number\n /** Prepares all the buckets that are available for identifying the shards. */\n prepareBuckets: () => void\n /** Start identifying all the shards. */\n spawnShards: () => Promise<void>\n /** Shutdown all shards. */\n shutdown: (code: number, reason: string) => Promise<void>\n /** Allows users to hook in and change to communicate to different workers across different servers or anything they like. For example using redis pubsub to talk to other servers. */\n tellWorkerToIdentify: (workerId: number, shardId: number, bucketId: number) => Promise<void>\n /** Tell the manager to identify a Shard. If this Shard is not already managed this will also add the Shard to the manager. */\n identify: (shardId: number) => Promise<void>\n /** Kill a shard. Close a shards connection to Discord's gateway (if any) and remove it from the manager. */\n kill: (shardId: number) => Promise<void>\n /** This function communicates with the parent manager, in order to know whether this manager is allowed to identify a new shard. */\n requestIdentify: (shardId: number) => Promise<void>\n /** Calculates the number of shards based on the guild id and total shards. */\n calculateShardId: (guildId: BigString, totalShards?: number) => number\n /**\n * Connects the bot user to a voice or stage channel.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n * @param channelId - The ID of the channel you want to join.\n *\n * @remarks\n * Requires the `CONNECT` permission.\n *\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n joinVoiceChannel: (guildId: BigString, channelId: BigString, options?: AtLeastOne<Omit<UpdateVoiceState, 'guildId' | 'channelId'>>) => Promise<void>\n /**\n * Edits the bot status in all shards that this gateway manages.\n *\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n editBotStatus: (data: StatusUpdate) => Promise<void>\n /**\n * Edits the bot's status on one shard.\n *\n * @param shardId The shard id to edit the status for.\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n editShardStatus: (shardId: number, data: StatusUpdate) => Promise<void>\n /**\n * Fetches the list of members for a guild over the gateway.\n *\n * @param guildId - The ID of the guild to get the list of members for.\n * @param options - The parameters for the fetching of the members.\n *\n * @remarks\n * If requesting the entire member list:\n * - Requires the `GUILD_MEMBERS` intent.\n *\n * If requesting presences ({@link RequestGuildMembers.presences | presences} set to `true`):\n * - Requires the `GUILD_PRESENCES` intent.\n *\n * If requesting a prefix ({@link RequestGuildMembers.query | query} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * If requesting a users by ID ({@link RequestGuildMembers.userIds | userIds} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * Fires a _Guild Members Chunk_ gateway event for every 1000 members fetched.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#request-guild-members}\n */\n requestMembers: (guildId: BigString, options?: Omit<RequestGuildMembers, 'guildId'>) => Promise<Camelize<DiscordMember[]>>\n /**\n * Leaves the voice channel the bot user is currently in.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n *\n * @remarks\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n leaveVoiceChannel: (guildId: BigString) => Promise<void>\n}\n\nexport interface RequestMemberRequest {\n /** The unique nonce for this request. */\n nonce: string\n /** The resolver handler to run when all members arrive. */\n resolve: (value: Camelize<DiscordMember[]> | PromiseLike<Camelize<DiscordMember[]>>) => void\n /** The members that have already arrived for this request. */\n members: Camelize<DiscordMember[]>\n}\n"],"names":["Collection","delay","LeakyBucket","logger","Shard","createGatewayManager","options","connection","url","shards","sessionStartLimit","maxConcurrency","remaining","total","resetAfter","gateway","events","compress","intents","properties","os","process","platform","browser","device","token","version","totalShards","lastShardId","firstShardId","totalWorkers","shardsPerWorker","spawnShardDelay","Map","buckets","cache","requestMembers","enabled","pending","calculateTotalShards","debug","Math","ceil","calculateWorkerId","shardId","workerId","floor","prepareBuckets","i","set","workers","leak","refillInterval","Error","bucketId","bucket","get","worker","find","w","id","queue","push","spawnShards","Promise","all","entries","map","tellWorkerToIdentify","shutdown","code","reason","forEach","shard","close","identify","requestIdentify","acquire","kill","delete","calculateShardId","guildId","Number","BigInt","joinVoiceChannel","channelId","editBotStatus","data","JSON","stringify","values","editShardStatus","leaveVoiceChannel"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["../src/manager.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-confusing-void-expression */\nimport type { AtLeastOne, BigString, Camelize, DiscordGetGatewayBot, DiscordMember, RequestGuildMembers } from '@discordeno/types'\nimport { Collection, delay, logger } from '@discordeno/utils'\nimport Shard from './Shard.js'\nimport type { ShardEvents, StatusUpdate, UpdateVoiceState } from './types.js'\n\nexport function createGatewayManager(options: CreateGatewayManagerOptions): GatewayManager {\n if (!options.connection) {\n options.connection = {\n url: 'wss://gateway.discord.gg',\n shards: 1,\n sessionStartLimit: {\n maxConcurrency: 1,\n remaining: 1000,\n total: 1000,\n resetAfter: 1000 * 60 * 60 * 24,\n },\n }\n }\n\n const gateway: GatewayManager = {\n events: options.events,\n compress: options.compress ?? false,\n intents: options.intents ?? 0,\n properties: {\n os: options.properties?.os ?? process.platform,\n browser: options.properties?.browser ?? 'Discordeno',\n device: options.properties?.device ?? 'Discordeno',\n },\n token: options.token,\n url: options.url ?? options.connection.url ?? 'wss://gateway.discord.gg',\n version: options.version ?? 10,\n connection: options.connection,\n totalShards: options.totalShards ?? options.connection.shards ?? 1,\n lastShardId: options.lastShardId ?? 0,\n firstShardId: options.firstShardId ?? 0,\n totalWorkers: options.totalWorkers ?? 4,\n shardsPerWorker: options.shardsPerWorker ?? 25,\n spawnShardDelay: options.spawnShardDelay ?? 5300,\n preferSnakeCase: false,\n shards: new Map(),\n buckets: new Map(),\n cache: {\n requestMembers: {\n enabled: options.cache?.requestMembers?.enabled ?? false,\n pending: new Collection(),\n },\n },\n\n calculateTotalShards() {\n // Bots under 100k servers do not have access to total shards.\n if (gateway.totalShards < 100) {\n logger.debug(`[Gateway] Calculating total shards: ${gateway.totalShards}`)\n return gateway.totalShards\n }\n\n logger.debug(`[Gateway] Calculating total shards`, gateway.totalShards, gateway.connection.sessionStartLimit.maxConcurrency)\n // Calculate a multiple of `maxConcurrency` which can be used to connect to the gateway.\n return (\n Math.ceil(\n gateway.totalShards /\n // If `maxConcurrency` is 1 we can safely use 16.\n (gateway.connection.sessionStartLimit.maxConcurrency === 1 ? 16 : gateway.connection.sessionStartLimit.maxConcurrency),\n ) * gateway.connection.sessionStartLimit.maxConcurrency\n )\n },\n calculateWorkerId(shardId) {\n const workerId = shardId % gateway.shardsPerWorker\n logger.debug(\n `[Gateway] Calculating workerId: Shard: ${shardId} -> Worker: ${workerId} -> Per Worker: ${gateway.shardsPerWorker} -> Total: ${gateway.totalWorkers}`,\n )\n return workerId\n },\n prepareBuckets() {\n for (let i = 0; i < gateway.connection.sessionStartLimit.maxConcurrency; ++i) {\n logger.debug(`[Gateway] Preparing buckets for concurrency: ${i}`)\n gateway.buckets.set(i, {\n workers: [],\n identifyRequests: [],\n })\n }\n\n // ORGANIZE ALL SHARDS INTO THEIR OWN BUCKETS\n for (let shardId = gateway.firstShardId; shardId <= gateway.lastShardId; ++shardId) {\n logger.debug(`[Gateway] Preparing buckets for shard: ${shardId}`)\n if (shardId >= gateway.totalShards) {\n throw new Error(`Shard (id: ${shardId}) is bigger or equal to the used amount of used shards which is ${gateway.totalShards}`)\n }\n\n const bucketId = shardId % gateway.connection.sessionStartLimit.maxConcurrency\n const bucket = gateway.buckets.get(bucketId)\n if (!bucket) {\n throw new Error(\n `Shard (id: ${shardId}) got assigned to an illegal bucket id: ${bucketId}, expected a bucket id between 0 and ${\n gateway.connection.sessionStartLimit.maxConcurrency - 1\n }`,\n )\n }\n\n // FIND A QUEUE IN THIS BUCKET THAT HAS SPACE\n // const worker = bucket.workers.find((w) => w.queue.length < gateway.shardsPerWorker);\n const workerId = gateway.calculateWorkerId(shardId)\n const worker = bucket.workers.find((w) => w.id === workerId)\n if (worker) {\n // IF THE QUEUE HAS SPACE JUST ADD IT TO THIS QUEUE\n worker.queue.push(shardId)\n } else {\n bucket.workers.push({ id: workerId, queue: [shardId] })\n }\n }\n\n for (const bucket of gateway.buckets.values()) {\n for (const worker of bucket.workers.values()) {\n // eslint-disable-next-line @typescript-eslint/require-array-sort-compare\n worker.queue = worker.queue.sort((a, b) => a - b)\n }\n }\n },\n async spawnShards() {\n // PREPARES ALL SHARDS IN SPECIFIC BUCKETS\n gateway.prepareBuckets()\n\n // Prefer concurrency of forEach instead of forof\n await Promise.all(\n [...gateway.buckets.entries()].map(async ([bucketId, bucket]) => {\n for (const worker of bucket.workers) {\n for (const shardId of worker.queue) {\n await gateway.tellWorkerToIdentify(worker.id, shardId, bucketId)\n }\n }\n }),\n )\n },\n async shutdown(code, reason) {\n gateway.shards.forEach((shard) => shard.close(code, reason))\n\n await delay(5000)\n },\n async tellWorkerToIdentify(workerId, shardId, bucketId) {\n logger.debug(`[Gateway] tell worker to identify (${workerId}, ${shardId}, ${bucketId})`)\n await gateway.identify(shardId)\n },\n async identify(shardId: number) {\n let shard = this.shards.get(shardId)\n logger.debug(`[Gateway] identifying ${shard ? 'existing' : 'new'} shard (${shardId})`)\n\n if (!shard) {\n shard = new Shard({\n id: shardId,\n connection: {\n compress: this.compress,\n intents: this.intents,\n properties: this.properties,\n token: this.token,\n totalShards: this.totalShards,\n url: this.url,\n version: this.version,\n },\n events: options.events,\n requestIdentify: async () => {\n await gateway.identify(shardId)\n },\n shardIsReady: async () => {\n logger.debug(`[Shard] Shard #${shardId} is ready`)\n await delay(gateway.spawnShardDelay)\n logger.debug(`[Shard] Resolving shard identify request`)\n gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)!.identifyRequests.shift()?.()\n },\n })\n\n if (this.preferSnakeCase) {\n shard.forwardToBot = async (payload) => {\n options.events.message?.(shard!, payload)\n }\n }\n\n this.shards.set(shardId, shard)\n }\n\n const bucket = gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)\n if (!bucket) return\n\n return await new Promise((resolve) => {\n // Mark that we are making an identify request so another is not made.\n bucket.identifyRequests.push(resolve)\n logger.debug(`[Gateway] identifying shard #(${shardId}).`)\n // This will trigger identify and when READY is received it will resolve the above request.\n shard?.identify()\n })\n },\n async kill(shardId: number) {\n const shard = this.shards.get(shardId)\n if (!shard) {\n return logger.debug(`[Gateway] kill shard but not found (${shardId})`)\n }\n\n logger.debug(`[Gateway] kill shard (${shardId})`)\n this.shards.delete(shardId)\n await shard.shutdown()\n },\n\n async requestIdentify(shardId: number) {\n logger.debug(`[Gateway] requesting identify`)\n // const bucket = gateway.buckets.get(shardId % gateway.connection.sessionStartLimit.maxConcurrency)\n // if (!bucket) return\n\n // return await new Promise((resolve) => {\n // bucket.identifyRequests.push(resolve)\n // })\n },\n\n // Helpers methods below this\n\n calculateShardId(guildId, totalShards) {\n // If none is provided, use the total shards number from gateway object.\n if (!totalShards) totalShards = gateway.totalShards\n // If it is only 1 shard, it will always be shard id 0\n if (totalShards === 1) {\n logger.debug(`[Gateway] calculateShardId (1 shard)`)\n return 0\n }\n\n logger.debug(`[Gateway] calculateShardId (guildId: ${guildId}, totalShards: ${totalShards})`)\n return Number((BigInt(guildId) >> 22n) % BigInt(totalShards))\n },\n\n async joinVoiceChannel(guildId, channelId, options) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId} not found`)\n }\n\n logger.debug(`[Gateway] joinVoiceChannel guildId: ${guildId} channelId: ${channelId}`)\n shard.joinVoiceChannel(guildId, channelId, options)\n },\n\n async editBotStatus(data) {\n logger.debug(`[Gateway] editBotStatus data: ${JSON.stringify(data)}`)\n await Promise.all(\n [...gateway.shards.values()].map(async (shard) => {\n gateway.editShardStatus(shard.id, data)\n }),\n )\n },\n\n async editShardStatus(shardId, data) {\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId}) not found.`)\n }\n\n logger.debug(`[Gateway] editShardStatus shardId: ${shardId} -> data: ${JSON.stringify(data)}`)\n await shard.editShardStatus(data)\n },\n\n async requestMembers(guildId, options) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId}) not found.`)\n }\n\n logger.debug(`[Gateway] requestMembers guildId: ${guildId} -> options ${JSON.stringify(options)}`)\n return await shard.requestMembers(guildId, options)\n },\n\n async leaveVoiceChannel(guildId) {\n const shardId = gateway.calculateShardId(guildId)\n const shard = gateway.shards.get(shardId)\n if (!shard) {\n throw new Error(`Shard (id: ${shardId} not found`)\n }\n\n logger.debug(`[Gateway] leaveVoiceChannel guildId: ${guildId} Shard ${shardId}`)\n await shard.leaveVoiceChannel(guildId)\n },\n }\n\n return gateway\n}\n\nexport interface CreateGatewayManagerOptions {\n /**\n * Id of the first Shard which should get controlled by this manager.\n * @default 0\n */\n firstShardId?: number\n /**\n * Id of the last Shard which should get controlled by this manager.\n * @default 0\n */\n lastShardId?: number\n /**\n * Delay in milliseconds to wait before spawning next shard. OPTIMAL IS ABOVE 5100. YOU DON'T WANT TO HIT THE RATE LIMIT!!!\n * @default 5300\n */\n spawnShardDelay?: number\n /**\n * Whether to send the discord packets in snake case form.\n * @default false\n */\n preferSnakeCase?: boolean\n /**\n * Total amount of shards your bot uses. Useful for zero-downtime updates or resharding.\n * @default 1\n */\n totalShards?: number\n /**\n * The amount of shards to load per worker.\n * @default 25\n */\n shardsPerWorker?: number\n /**\n * The total amount of workers to use for your bot.\n * @default 4\n */\n totalWorkers?: number\n /** Important data which is used by the manager to connect shards to the gateway. */\n connection?: Camelize<DiscordGetGatewayBot>\n /** Whether incoming payloads are compressed using zlib.\n *\n * @default false\n */\n compress?: boolean\n /** The calculated intent value of the events which the shard should receive.\n *\n * @default 0\n */\n intents?: number\n /** Identify properties to use */\n properties?: {\n /** Operating system the shard runs on.\n *\n * @default \"darwin\" | \"linux\" | \"windows\"\n */\n os: string\n /** The \"browser\" where this shard is running on.\n *\n * @default \"Discordeno\"\n */\n browser: string\n /** The device on which the shard is running.\n *\n * @default \"Discordeno\"\n */\n device: string\n }\n /** Bot token which is used to connect to Discord */\n token: string\n /** The URL of the gateway which should be connected to.\n *\n * @default \"wss://gateway.discord.gg\"\n */\n url?: string\n /** The gateway version which should be used.\n *\n * @default 10\n */\n version?: number\n /** The events handlers */\n events: ShardEvents\n /** This managers cache related settings. */\n cache?: {\n requestMembers?: {\n /**\n * Whether or not request member requests should be cached.\n * @default false\n */\n enabled?: boolean\n /** The pending requests. */\n pending: Collection<string, RequestMemberRequest>\n }\n }\n}\n\nexport interface GatewayManager extends Required<CreateGatewayManagerOptions> {\n /** The max concurrency buckets. Those will be created when the `spawnShards` (which calls `prepareBuckets` under the hood) function gets called. */\n buckets: Map<\n number,\n {\n workers: Array<{ id: number; queue: number[] }>\n /** Requests to identify shards are made based on whether it is available to be made. */\n identifyRequests: Array<(value: void | PromiseLike<void>) => void>\n }\n >\n /** The shards that are created. */\n shards: Map<number, Shard>\n /** Determine max number of shards to use based upon the max concurrency. */\n calculateTotalShards: () => number\n /** Determine the id of the worker which is handling a shard. */\n calculateWorkerId: (shardId: number) => number\n /** Prepares all the buckets that are available for identifying the shards. */\n prepareBuckets: () => void\n /** Start identifying all the shards. */\n spawnShards: () => Promise<void>\n /** Shutdown all shards. */\n shutdown: (code: number, reason: string) => Promise<void>\n /** Allows users to hook in and change to communicate to different workers across different servers or anything they like. For example using redis pubsub to talk to other servers. */\n tellWorkerToIdentify: (workerId: number, shardId: number, bucketId: number) => Promise<void>\n /** Tell the manager to identify a Shard. If this Shard is not already managed this will also add the Shard to the manager. */\n identify: (shardId: number) => Promise<void>\n /** Kill a shard. Close a shards connection to Discord's gateway (if any) and remove it from the manager. */\n kill: (shardId: number) => Promise<void>\n /** This function makes sure that the bucket is allowed to make the next identify request. */\n requestIdentify: (shardId: number) => Promise<void>\n /** Calculates the number of shards based on the guild id and total shards. */\n calculateShardId: (guildId: BigString, totalShards?: number) => number\n /**\n * Connects the bot user to a voice or stage channel.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n * @param channelId - The ID of the channel you want to join.\n *\n * @remarks\n * Requires the `CONNECT` permission.\n *\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n joinVoiceChannel: (guildId: BigString, channelId: BigString, options?: AtLeastOne<Omit<UpdateVoiceState, 'guildId' | 'channelId'>>) => Promise<void>\n /**\n * Edits the bot status in all shards that this gateway manages.\n *\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n editBotStatus: (data: StatusUpdate) => Promise<void>\n /**\n * Edits the bot's status on one shard.\n *\n * @param shardId The shard id to edit the status for.\n * @param data The status data to set the bots status to.\n * @returns Promise<void>\n */\n editShardStatus: (shardId: number, data: StatusUpdate) => Promise<void>\n /**\n * Fetches the list of members for a guild over the gateway.\n *\n * @param guildId - The ID of the guild to get the list of members for.\n * @param options - The parameters for the fetching of the members.\n *\n * @remarks\n * If requesting the entire member list:\n * - Requires the `GUILD_MEMBERS` intent.\n *\n * If requesting presences ({@link RequestGuildMembers.presences | presences} set to `true`):\n * - Requires the `GUILD_PRESENCES` intent.\n *\n * If requesting a prefix ({@link RequestGuildMembers.query | query} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * If requesting a users by ID ({@link RequestGuildMembers.userIds | userIds} non-`undefined`):\n * - Returns a maximum of 100 members.\n *\n * Fires a _Guild Members Chunk_ gateway event for every 1000 members fetched.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#request-guild-members}\n */\n requestMembers: (guildId: BigString, options?: Omit<RequestGuildMembers, 'guildId'>) => Promise<Camelize<DiscordMember[]>>\n /**\n * Leaves the voice channel the bot user is currently in.\n *\n * This function sends the _Update Voice State_ gateway command over the gateway behind the scenes.\n *\n * @param guildId - The ID of the guild the voice channel to leave is in.\n *\n * @remarks\n * Fires a _Voice State Update_ gateway event.\n *\n * @see {@link https://discord.com/developers/docs/topics/gateway#update-voice-state}\n */\n leaveVoiceChannel: (guildId: BigString) => Promise<void>\n}\n\nexport interface RequestMemberRequest {\n /** The unique nonce for this request. */\n nonce: string\n /** The resolver handler to run when all members arrive. */\n resolve: (value: Camelize<DiscordMember[]> | PromiseLike<Camelize<DiscordMember[]>>) => void\n /** The members that have already arrived for this request. */\n members: Camelize<DiscordMember[]>\n}\n"],"names":["Collection","delay","logger","Shard","createGatewayManager","options","connection","url","shards","sessionStartLimit","maxConcurrency","remaining","total","resetAfter","gateway","events","compress","intents","properties","os","process","platform","browser","device","token","version","totalShards","lastShardId","firstShardId","totalWorkers","shardsPerWorker","spawnShardDelay","preferSnakeCase","Map","buckets","cache","requestMembers","enabled","pending","calculateTotalShards","debug","Math","ceil","calculateWorkerId","shardId","workerId","prepareBuckets","i","set","workers","identifyRequests","Error","bucketId","bucket","get","worker","find","w","id","queue","push","values","sort","a","b","spawnShards","Promise","all","entries","map","tellWorkerToIdentify","shutdown","code","reason","forEach","shard","close","identify","requestIdentify","shardIsReady","shift","forwardToBot","payload","message","resolve","kill","delete","calculateShardId","guildId","Number","BigInt","joinVoiceChannel","channelId","editBotStatus","data","JSON","stringify","editShardStatus","leaveVoiceChannel"],"mappings":"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"}
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ActivityTypes, Camelize, DiscordActivity, DiscordGatewayPayload, GatewayOpcodes, PresenceStatus } from '@discordeno/types'\nimport type Shard from './Shard.js'\n\nexport enum ShardState {\n /** Shard is fully connected to the gateway and receiving events from Discord. */\n Connected = 0,\n /** Shard started to connect to the gateway. This is only used if the shard is not currently trying to identify or resume. */\n Connecting = 1,\n /** Shard got disconnected and reconnection actions have been started. */\n Disconnected = 2,\n /** The shard is connected to the gateway but only heartbeating. At this state the shard has not been identified with discord. */\n Unidentified = 3,\n /** Shard is trying to identify with the gateway to create a new session. */\n Identifying = 4,\n /** Shard is trying to resume a session with the gateway. */\n Resuming = 5,\n /** Shard got shut down studied or due to a not (self) fixable error and may not attempt to reconnect on its own. */\n Offline = 6,\n}\n\nexport interface ShardGatewayConfig {\n /** Whether incoming payloads are compressed using zlib.\n *\n * @default false\n */\n compress: boolean\n /** The calculated intent value of the events which the shard should receive.\n *\n * @default 0\n */\n intents: number\n /** Identify properties to use */\n properties: {\n /** Operating system the shard runs on.\n *\n * @default \"darwin\" | \"linux\" | \"windows\"\n */\n os: string\n /** The \"browser\" where this shard is running on.\n *\n * @default \"Discordeno\"\n */\n browser: string\n /** The device on which the shard is running.\n *\n * @default \"Discordeno\"\n */\n device: string\n }\n /** Bot token which is used to connect to Discord */\n token: string\n /** The URL of the gateway which should be connected to.\n *\n * @default \"wss://gateway.discord.gg\"\n */\n url: string\n /** The gateway version which should be used.\n *\n * @default 10\n */\n version: number\n /**\n * The total number of shards to connect to across the entire bot.\n * @default 1\n */\n totalShards: number\n}\n\nexport interface ShardHeart {\n /** Whether or not the heartbeat was acknowledged by Discord in time. */\n acknowledged: boolean\n /** Interval between heartbeats requested by Discord. */\n interval: number\n /** Id of the interval, which is used for sending the heartbeats. */\n intervalId?: NodeJS.Timer\n /** Unix (in milliseconds) timestamp when the last heartbeat ACK was received from Discord. */\n lastAck?: number\n /** Unix timestamp (in milliseconds) when the last heartbeat was sent. */\n lastBeat?: number\n /** Round trip time (in milliseconds) from Shard to Discord and back.\n * Calculated using the heartbeat system.\n * Note: this value is undefined until the first heartbeat to Discord has happened.\n */\n rtt?: number\n /** Id of the timeout which is used for sending the first heartbeat to Discord since it's \"special\". */\n timeoutId?: NodeJS.Timeout\n}\n\nexport interface ShardEvents {\n /** A heartbeat has been send. */\n heartbeat?: (shard: Shard) => unknown\n /** A heartbeat ACK was received. */\n heartbeatAck?: (shard: Shard) => unknown\n /** Shard has received a Hello payload. */\n hello?: (shard: Shard) => unknown\n /** The Shards session has been invalidated. */\n invalidSession?: (shard: Shard, resumable: boolean) => unknown\n /** The shard has started a resume action. */\n resuming?: (shard: Shard) => unknown\n /** The shard has successfully resumed an old session. */\n resumed?: (shard: Shard) => unknown\n /** Discord has requested the Shard to reconnect. */\n requestedReconnect?: (shard: Shard) => unknown\n /** The shard started to connect to Discord's gateway. */\n connecting?: (shard: Shard) => unknown\n /** The shard is connected with Discord's gateway. */\n connected?: (shard: Shard) => unknown\n /** The shard has been disconnected from Discord's gateway. */\n disconnected?: (shard: Shard) => unknown\n /** The shard has started to identify itself to Discord. */\n identifying?: (shard: Shard) => unknown\n /** The shard has successfully been identified itself with Discord. */\n identified?: (shard: Shard) => unknown\n /** The shard has received a message from Discord. */\n message?: (shard: Shard, payload: Camelize<DiscordGatewayPayload>) => unknown\n}\n\nexport enum ShardSocketCloseCodes {\n /** A regular Shard shutdown. */\n Shutdown = 3000,\n /** A resume has been requested and therefore the old connection needs to be closed. */\n ResumeClosingOldConnection = 3024,\n /** Did not receive a heartbeat ACK in time.\n * Closing the shard and creating a new session.\n */\n ZombiedConnection = 3010,\n /** Discordeno's gateway tests hae been finished, therefore the Shard can be turned off. */\n TestingFinished = 3064,\n /** Special close code reserved for Discordeno's zero-downtime resharding system. */\n Resharded = 3065,\n /** Shard is re-identifying therefore the old connection needs to be closed. */\n ReIdentifying = 3066,\n}\n\nexport interface ShardSocketRequest {\n /** The OP-Code for the payload to send. */\n op: GatewayOpcodes\n /** Payload data. */\n d: unknown\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#update-presence */\nexport interface BotStatusUpdate {\n // /** Unix time (in milliseconds) of when the client went idle, or null if the client is not idle */\n since: number | null\n /** The user's activities */\n activities: BotActivity[]\n /** The user's new status */\n status: keyof typeof PresenceStatus\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#activity-object */\nexport interface BotActivity {\n name: string\n type: ActivityTypes\n url?: string\n}\n\n/** https://discord.com/developers/docs/topics/gateway#update-voice-state */\nexport interface UpdateVoiceState {\n /** id of the guild */\n guildId: string\n /** id of the voice channel client wants to join (null if disconnecting) */\n channelId: string | null\n /** Is the client muted */\n selfMute: boolean\n /** Is the client deafened */\n selfDeaf: boolean\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#update-presence */\nexport interface StatusUpdate {\n // /** Unix time (in milliseconds) of when the client went idle, or null if the client is not idle */\n // since: number | null;\n /** The user's activities */\n activities?: Camelize<Array<Omit<DiscordActivity, 'created_at'>>>\n /** The user's new status */\n status: keyof typeof PresenceStatus\n // /** Whether or not the client is afk */\n // afk: boolean;\n}\n"],"names":["ShardState","Connected","Connecting","Disconnected","Unidentified","Identifying","Resuming","Offline","ShardSocketCloseCodes","Shutdown","ResumeClosingOldConnection","ZombiedConnection","TestingFinished","Resharded","ReIdentifying"],"mappings":"
|
|
1
|
+
{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ActivityTypes, Camelize, DiscordActivity, DiscordGatewayPayload, GatewayOpcodes, PresenceStatus } from '@discordeno/types'\nimport type Shard from './Shard.js'\n\nexport enum ShardState {\n /** Shard is fully connected to the gateway and receiving events from Discord. */\n Connected = 0,\n /** Shard started to connect to the gateway. This is only used if the shard is not currently trying to identify or resume. */\n Connecting = 1,\n /** Shard got disconnected and reconnection actions have been started. */\n Disconnected = 2,\n /** The shard is connected to the gateway but only heartbeating. At this state the shard has not been identified with discord. */\n Unidentified = 3,\n /** Shard is trying to identify with the gateway to create a new session. */\n Identifying = 4,\n /** Shard is trying to resume a session with the gateway. */\n Resuming = 5,\n /** Shard got shut down studied or due to a not (self) fixable error and may not attempt to reconnect on its own. */\n Offline = 6,\n}\n\nexport interface ShardGatewayConfig {\n /** Whether incoming payloads are compressed using zlib.\n *\n * @default false\n */\n compress: boolean\n /** The calculated intent value of the events which the shard should receive.\n *\n * @default 0\n */\n intents: number\n /** Identify properties to use */\n properties: {\n /** Operating system the shard runs on.\n *\n * @default \"darwin\" | \"linux\" | \"windows\"\n */\n os: string\n /** The \"browser\" where this shard is running on.\n *\n * @default \"Discordeno\"\n */\n browser: string\n /** The device on which the shard is running.\n *\n * @default \"Discordeno\"\n */\n device: string\n }\n /** Bot token which is used to connect to Discord */\n token: string\n /** The URL of the gateway which should be connected to.\n *\n * @default \"wss://gateway.discord.gg\"\n */\n url: string\n /** The gateway version which should be used.\n *\n * @default 10\n */\n version: number\n /**\n * The total number of shards to connect to across the entire bot.\n * @default 1\n */\n totalShards: number\n}\n\nexport interface ShardHeart {\n /** Whether or not the heartbeat was acknowledged by Discord in time. */\n acknowledged: boolean\n /** Interval between heartbeats requested by Discord. */\n interval: number\n /** Id of the interval, which is used for sending the heartbeats. */\n intervalId?: NodeJS.Timer\n /** Unix (in milliseconds) timestamp when the last heartbeat ACK was received from Discord. */\n lastAck?: number\n /** Unix timestamp (in milliseconds) when the last heartbeat was sent. */\n lastBeat?: number\n /** Round trip time (in milliseconds) from Shard to Discord and back.\n * Calculated using the heartbeat system.\n * Note: this value is undefined until the first heartbeat to Discord has happened.\n */\n rtt?: number\n /** Id of the timeout which is used for sending the first heartbeat to Discord since it's \"special\". */\n timeoutId?: NodeJS.Timeout\n}\n\nexport interface ShardEvents {\n /** A heartbeat has been send. */\n heartbeat?: (shard: Shard) => unknown\n /** A heartbeat ACK was received. */\n heartbeatAck?: (shard: Shard) => unknown\n /** Shard has received a Hello payload. */\n hello?: (shard: Shard) => unknown\n /** The Shards session has been invalidated. */\n invalidSession?: (shard: Shard, resumable: boolean) => unknown\n /** The shard has started a resume action. */\n resuming?: (shard: Shard) => unknown\n /** The shard has successfully resumed an old session. */\n resumed?: (shard: Shard) => unknown\n /** Discord has requested the Shard to reconnect. */\n requestedReconnect?: (shard: Shard) => unknown\n /** The shard started to connect to Discord's gateway. */\n connecting?: (shard: Shard) => unknown\n /** The shard is connected with Discord's gateway. */\n connected?: (shard: Shard) => unknown\n /** The shard has been disconnected from Discord's gateway. */\n disconnected?: (shard: Shard) => unknown\n /** The shard has started to identify itself to Discord. */\n identifying?: (shard: Shard) => unknown\n /** The shard has successfully been identified itself with Discord. */\n identified?: (shard: Shard) => unknown\n /** The shard has received a message from Discord. */\n message?: (shard: Shard, payload: Camelize<DiscordGatewayPayload>) => unknown\n}\n\nexport enum ShardSocketCloseCodes {\n /** A regular Shard shutdown. */\n Shutdown = 3000,\n /** A resume has been requested and therefore the old connection needs to be closed. */\n ResumeClosingOldConnection = 3024,\n /** Did not receive a heartbeat ACK in time.\n * Closing the shard and creating a new session.\n */\n ZombiedConnection = 3010,\n /** Discordeno's gateway tests hae been finished, therefore the Shard can be turned off. */\n TestingFinished = 3064,\n /** Special close code reserved for Discordeno's zero-downtime resharding system. */\n Resharded = 3065,\n /** Shard is re-identifying therefore the old connection needs to be closed. */\n ReIdentifying = 3066,\n}\n\nexport interface ShardSocketRequest {\n /** The OP-Code for the payload to send. */\n op: GatewayOpcodes\n /** Payload data. */\n d: unknown\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#update-presence */\nexport interface BotStatusUpdate {\n // /** Unix time (in milliseconds) of when the client went idle, or null if the client is not idle */\n since: number | null\n /** The user's activities */\n activities: BotActivity[]\n /** The user's new status */\n status: keyof typeof PresenceStatus\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#activity-object */\nexport interface BotActivity {\n name: string\n type: ActivityTypes\n url?: string\n}\n\n/** https://discord.com/developers/docs/topics/gateway#update-voice-state */\nexport interface UpdateVoiceState {\n /** id of the guild */\n guildId: string\n /** id of the voice channel client wants to join (null if disconnecting) */\n channelId: string | null\n /** Is the client muted */\n selfMute: boolean\n /** Is the client deafened */\n selfDeaf: boolean\n}\n\n/** https://discord.com/developers/docs/topics/gateway-events#update-presence */\nexport interface StatusUpdate {\n // /** Unix time (in milliseconds) of when the client went idle, or null if the client is not idle */\n // since: number | null;\n /** The user's activities */\n activities?: Camelize<Array<Omit<DiscordActivity, 'created_at'>>>\n /** The user's new status */\n status: keyof typeof PresenceStatus\n // /** Whether or not the client is afk */\n // afk: boolean;\n}\n"],"names":["ShardState","Connected","Connecting","Disconnected","Unidentified","Identifying","Resuming","Offline","ShardSocketCloseCodes","Shutdown","ResumeClosingOldConnection","ZombiedConnection","TestingFinished","Resharded","ReIdentifying"],"mappings":"WAGO;UAAKA,UAAU;IAAVA,WAAAA,WACV,+EAA+E,GAC/EC,eAAY,KAAZA;IAFUD,WAAAA,WAGV,2HAA2H,GAC3HE,gBAAa,KAAbA;IAJUF,WAAAA,WAKV,uEAAuE,GACvEG,kBAAe,KAAfA;IANUH,WAAAA,WAOV,+HAA+H,GAC/HI,kBAAe,KAAfA;IARUJ,WAAAA,WASV,0EAA0E,GAC1EK,iBAAc,KAAdA;IAVUL,WAAAA,WAWV,0DAA0D,GAC1DM,cAAW,KAAXA;IAZUN,WAAAA,WAaV,kHAAkH,GAClHO,aAAU,KAAVA;GAdUP,eAAAA;WAkHL;UAAKQ,qBAAqB;IAArBA,sBAAAA,sBACV,8BAA8B,GAC9BC,cAAW,QAAXA;IAFUD,sBAAAA,sBAGV,qFAAqF,GACrFE,gCAA6B,QAA7BA;IAJUF,sBAAAA,sBAKV;;GAEC,GACDG,uBAAoB,QAApBA;IARUH,sBAAAA,sBASV,yFAAyF,GACzFI,qBAAkB,QAAlBA;IAVUJ,sBAAAA,sBAWV,kFAAkF,GAClFK,eAAY,QAAZA;IAZUL,sBAAAA,sBAaV,6EAA6E,GAC7EM,mBAAgB,QAAhBA;GAdUN,0BAAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@discordeno/gateway",
|
|
3
|
-
"version": "19.0.0-next.
|
|
3
|
+
"version": "19.0.0-next.bcfeb5b",
|
|
4
4
|
"main": "./dist/index.js",
|
|
5
5
|
"types": "./dist/index.d.ts",
|
|
6
6
|
"type": "module",
|
|
@@ -24,27 +24,27 @@
|
|
|
24
24
|
"test:test-type": "tsc --project tsconfig.test.json"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@discordeno/types": "19.0.0-next.
|
|
28
|
-
"@discordeno/utils": "19.0.0-next.
|
|
29
|
-
"ws": "^8.
|
|
27
|
+
"@discordeno/types": "19.0.0-next.bcfeb5b",
|
|
28
|
+
"@discordeno/utils": "19.0.0-next.bcfeb5b",
|
|
29
|
+
"ws": "^8.13.0"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|
|
32
|
-
"@swc/cli": "^0.1.
|
|
33
|
-
"@swc/core": "^1.3.
|
|
34
|
-
"@types/chai": "^4",
|
|
35
|
-
"@types/mocha": "^10",
|
|
36
|
-
"@types/node": "^18.
|
|
32
|
+
"@swc/cli": "^0.1.62",
|
|
33
|
+
"@swc/core": "^1.3.40",
|
|
34
|
+
"@types/chai": "^4.3.4",
|
|
35
|
+
"@types/mocha": "^10.0.1",
|
|
36
|
+
"@types/node": "^18.15.3",
|
|
37
37
|
"@types/sinon": "^10.0.13",
|
|
38
|
-
"@types/ws": "^8.5.
|
|
39
|
-
"c8": "^7.
|
|
38
|
+
"@types/ws": "^8.5.4",
|
|
39
|
+
"c8": "^7.13.0",
|
|
40
40
|
"chai": "^4.3.7",
|
|
41
|
-
"eslint": "^8.0
|
|
41
|
+
"eslint": "^8.36.0",
|
|
42
42
|
"eslint-config-discordeno": "*",
|
|
43
|
-
"mocha": "^10.
|
|
44
|
-
"sinon": "^15.0.
|
|
43
|
+
"mocha": "^10.2.0",
|
|
44
|
+
"sinon": "^15.0.2",
|
|
45
45
|
"ts-node": "^10.9.1",
|
|
46
46
|
"tsconfig": "*",
|
|
47
|
-
"typescript": "^4.9.
|
|
48
|
-
"uWebSockets.js": "uNetworking/uWebSockets.js#
|
|
47
|
+
"typescript": "^4.9.5",
|
|
48
|
+
"uWebSockets.js": "https://github.com/uNetworking/uWebSockets.js.git#commit=42c9c0d5d31f46ca4115dc75672b0037ec970f28"
|
|
49
49
|
}
|
|
50
50
|
}
|