Skip to main content

CreateGatewayManagerOptions

@discordeno/gateway

Documentation / @discordeno/gateway / CreateGatewayManagerOptions

Interface: CreateGatewayManagerOptions

Defined in: gateway/src/manager.ts:602

Properties​

cache?​

optional cache: object

Defined in: gateway/src/manager.ts:685

This managers cache related settings.

requestMembers?​

optional requestMembers: object

requestMembers.enabled?​

optional requestMembers.enabled: boolean

Whether or not request member requests should be cached.

Default​
false

compress?​

optional compress: boolean

Defined in: gateway/src/manager.ts:644

Whether incoming payloads are compressed using zlib.

Default​

false

connection?​

optional connection: object

Defined in: gateway/src/manager.ts:639

Important data which is used by the manager to connect shards to the gateway.

sessionStartLimit​

sessionStartLimit: object

sessionStartLimit.maxConcurrency​

sessionStartLimit.maxConcurrency: number

sessionStartLimit.remaining​

sessionStartLimit.remaining: number

sessionStartLimit.resetAfter​

sessionStartLimit.resetAfter: number

sessionStartLimit.total​

sessionStartLimit.total: number

shards​

shards: number

url​

url: string

events?​

optional events: ShardEvents

Defined in: gateway/src/manager.ts:683

The events handlers

firstShardId?​

optional firstShardId: number

Defined in: gateway/src/manager.ts:607

Id of the first Shard which should get controlled by this manager.

Default​

0

intents?​

optional intents: number

Defined in: gateway/src/manager.ts:651

The calculated intent value of the events which the shard should receive.

Default​

0

lastShardId?​

optional lastShardId: number

Defined in: gateway/src/manager.ts:612

Id of the last Shard which should get controlled by this manager.

Default​

0

logger?​

optional logger: Pick<{ debug: (...args) => void; error: (...args) => void; fatal: (...args) => void; info: (...args) => void; log: (level, ...args) => void; setDepth: (level) => void; setLevel: (level) => void; warn: (...args) => void; }, "debug" | "info" | "warn" | "error" | "fatal">

Defined in: gateway/src/manager.ts:698

The logger that the gateway manager will use.

Default​

logger // The logger exported by @discordeno/utils

makePresence()?​

optional makePresence: () => Promise<undefined | BotStatusUpdate>

Defined in: gateway/src/manager.ts:705

Make the presence for when the bot connects to the gateway

Returns​

Promise<undefined | BotStatusUpdate>

Remarks​

This function will be called each time a Shard is going to identify

preferSnakeCase?​

optional preferSnakeCase: boolean

Defined in: gateway/src/manager.ts:622

Whether to send the discord packets in snake case form.

Default​

false

properties?​

optional properties: object

Defined in: gateway/src/manager.ts:653

Identify properties to use

browser​

browser: string

The "browser" where this shard is running on.

Default​
"Discordeno"

device​

device: string

The device on which the shard is running.

Default​
"Discordeno"

os​

os: string

Operating system the shard runs on.

Default​
"darwin" | "linux" | "windows"

resharding?​

optional resharding: object

Defined in: gateway/src/manager.ts:707

Options related to resharding.

checkInterval​

checkInterval: number

The interval in milliseconds, of how often to check whether resharding is needed and reshard automatically. Set to -1 to disable auto resharding.

Default​
28800000 (8 hours)

enabled​

enabled: boolean

Whether or not automated resharding should be enabled.

Default​
true

getSessionInfo()?​

optional getSessionInfo: () => Promise<{ sessionStartLimit: { maxConcurrency: number; remaining: number; resetAfter: number; total: number; }; shards: number; url: string; }>

Handler to get shard count and other session info.

Returns​

Promise<{ sessionStartLimit: { maxConcurrency: number; remaining: number; resetAfter: number; total: number; }; shards: number; url: string; }>

shardsFullPercentage​

shardsFullPercentage: number

The % of how full a shard is when resharding should be triggered.

Remarks​

We use discord recommended shard value to get an approximation of the shard full percentage to compare with this value so the bot may not reshard at the exact percentage provided but may reshard when it is a bit higher than the provided percentage. For accurate calculation, you may override the checkIfReshardingIsNeeded function

Default​
80 as in 80%

updateGuildsShardId()?​

optional updateGuildsShardId: (guildIds, shardId) => Promise<void>

Handler to edit the shard id on any cached guilds.

Parameters​
guildIds​

string[]

shardId​

number

Returns​

Promise<void>

shardsPerWorker?​

optional shardsPerWorker: number

Defined in: gateway/src/manager.ts:632

The amount of shards to load per worker.

Default​

25

spawnShardDelay?​

optional spawnShardDelay: number

Defined in: gateway/src/manager.ts:617

Delay in milliseconds to wait before spawning next shard. OPTIMAL IS ABOVE 5100. YOU DON'T WANT TO HIT THE RATE LIMIT!!!

Default​

5300

token​

token: string

Defined in: gateway/src/manager.ts:671

Bot token which is used to connect to Discord

totalShards?​

optional totalShards: number

Defined in: gateway/src/manager.ts:627

Total amount of shards your bot uses. Useful for zero-downtime updates or resharding.

Default​

1

totalWorkers?​

optional totalWorkers: number

Defined in: gateway/src/manager.ts:637

The total amount of workers to use for your bot.

Default​

4

transportCompression?​

optional transportCompression: null | TransportCompression

Defined in: gateway/src/manager.ts:646

What transport compression should be used

url?​

optional url: string

Defined in: gateway/src/manager.ts:676

The URL of the gateway which should be connected to.

Default​

"wss://gateway.discord.gg"

version?​

optional version: number

Defined in: gateway/src/manager.ts:681

The gateway version which should be used.

Default​

10