19.0.0-next.2d02c32 • Published 9 months ago

@discordeno/gateway v19.0.0-next.2d02c32

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
9 months ago

Discordeno WS

Discord API library for Node.JS, Deno & Bun

Discord codecov action status

!WARNING Using a Standalone / Proxy WS is mean for advanced developers only

Standalone WebSocket to connect to the Discord API.

  • Zero Downtime Updates:

    • Your bot can be updated in a matter of seconds. With normal sharding, you have to restart which also has to process identifying all your shards with a 1/~5s rate limit. With WS handling moved to a proxy process, this allows you to instantly get the bot code restarted without any concerns of delays. If you have a bot on 200,000 servers normally this would mean a 20 minute delay to restart your bot if you made a small change and restarted.
  • Zero Downtime Resharding:

    • Discord stops letting your bot get added to new servers at certain points in time. For example, suppose you had 150,000 servers running 150 shards. The maximum amount of servers your shards could hold is 150 * 2500 = 375,000. If your bot reaches this, it can no longer join new servers until it re-shards.
    • DD proxy provides 2 types of re-sharding. Automated and manual. You can also have both.
      • Automated: This system will automatically begin a Zero-downtime resharding process behind the scenes when you reach 80% of your maximum servers allowed by your shards. For example, since 375,000 was the max, at 300,000 we would begin re-sharding behind the scenes with ZERO DOWNTIME.
        • 80% of maximum servers reached (The % of 80% is customizable.)
        • Identify limits have room to allow re-sharding. (Also customizable)
      • Manual: You can also trigger this manually should you choose.
  • Horizontal Scaling:

    • The proxy system allows you to scale the bot horizontally. When you reach a huge size, you can either keep spending more money to keep beefing up your server or you can buy several cheaper servers and scale horizontally. The proxy means you can have WS handling on a completely separate system.
  • No Loss Restarts:

    • When you restart a bot without the proxy system, normally you would lose many events. Users may be using commands or messages are sent that will not be filtered. As your bot's grow this number rises dramatically. Users may join who wont get the auto-roles or any other actions your bot should take. With the proxy system, you can keep restarting your bot and never lose any events. Events will be put into a queue while your bot is down(max size of queue is customizable), once the bot is available the queue will begin processing all events.
  • Controllers:

    • The controller aspect gives you full control over everything inside the proxy. You can provide a function to simply override the handler. For example, if you would like a certain function to do something different, instead of having to fork and maintain your fork, you can just provide a function to override.
  • Clustering With Workers:

    • Take full advantage of all your CPU cores by using workers to spread the load. Control how many shards per worker and how many workers to maximize efficiency!

Links

19.0.0-next.01437eb

12 months ago

19.0.0-next.fb8af2b

12 months ago

19.0.0-next.b61cabe

12 months ago

19.0.0-next.895cc17

11 months ago

19.0.0-next.45bfa05

10 months ago

19.0.0-next.c1fd19c

12 months ago

19.0.0-next.d6898f2

11 months ago

19.0.0-next.08a5e44

11 months ago

19.0.0-next.4899d0a

11 months ago

19.0.0-next.6584a3b

11 months ago

19.0.0-next.8dc6c3f

11 months ago

19.0.0-next.e315ee6

12 months ago

19.0.0-next.b706358

11 months ago

19.0.0-next.3122285

12 months ago

19.0.0-next.402f1b3

12 months ago

19.0.0-next.c1b0dc9

11 months ago

19.0.0-next.22a6117

11 months ago

19.0.0-next.2421ae2

12 months ago

19.0.0-next.6ac3486

12 months ago

19.0.0-next.9e516a0

11 months ago

19.0.0-next.8ad8b5d

12 months ago

19.0.0-next.84e145e

12 months ago

19.0.0-next.658acfb

12 months ago

19.0.0-next.7c404ee

12 months ago

19.0.0-next.48902bc

10 months ago

19.0.0-next.faaa8af

12 months ago

19.0.0-next.9e101a0

12 months ago

19.0.0-next.4142946

12 months ago

19.0.0-next.b1bfe94

10 months ago

19.0.0-next.985801c

11 months ago

19.0.0-next.791943a

12 months ago

19.0.0-next.bb6b8df

11 months ago

19.0.0-next.b3a8c86

11 months ago

19.0.0-next.62b3122

11 months ago

19.0.0-next.a0510da

11 months ago

19.0.0-next.c7b44e5

12 months ago

19.0.0-next.27fc12e

12 months ago

19.0.0-next.c400009

11 months ago

19.0.0-next.0819d2b

12 months ago

19.0.0-next.304a61c

11 months ago

19.0.0-next.943821f

11 months ago

19.0.0-next.57fa3d4

10 months ago

19.0.0-next.ce4eb2c

11 months ago

19.0.0-next.495c532

12 months ago

19.0.0-next.ef4cc80

12 months ago

19.0.0-next.0a54931

12 months ago

19.0.0-next.991609d

12 months ago

19.0.0-next.e0209cf

12 months ago

19.0.0-next.9e1ada6

11 months ago

19.0.0-next.4778968

12 months ago

19.0.0-next.40ad082

11 months ago

19.0.0-next.352887c

11 months ago

19.0.0-next.2353343

12 months ago

19.0.0-next.ee11d39

12 months ago

19.0.0-next.746f0a9

11 months ago

19.0.0-next.ab2930c

11 months ago

19.0.0-next.14b0158

11 months ago

19.0.0-next.a80036f

11 months ago