glyde/intents

Gateway intents: the IDENTIFY bitfield that decides which events Discord delivers.

Three are privileged and need switching on in the developer portal first. Asking for one you have not enabled closes the connection with 4014; a bit Discord has not assigned closes it with 4013, which is why this is opaque.

Types

Intent

</>

pub type Intent {
  Guilds
  GuildMembers
  GuildModeration
  GuildExpressions
  GuildIntegrations
  GuildWebhooks
  GuildInvites
  GuildVoiceStates
  GuildPresences
  GuildMessages
  GuildMessageReactions
  GuildMessageTyping
  DirectMessages
  DirectMessageReactions
  DirectMessageTyping
  MessageContent
  GuildScheduledEvents
  AutoModerationConfiguration
  AutoModerationExecution
  GuildMessagePolls
  DirectMessagePolls
}

Constructors

```
Guilds
```
```
GuildMembers
```
```
GuildModeration
```
```
GuildExpressions
```
```
GuildIntegrations
```
```
GuildWebhooks
```
```
GuildInvites
```
```
GuildVoiceStates
```
```
GuildPresences
```
```
GuildMessages
```
```
GuildMessageReactions
```
```
GuildMessageTyping
```
```
DirectMessages
```
```
DirectMessageReactions
```
```
DirectMessageTyping
```
```
MessageContent
```
```
GuildScheduledEvents
```
```
AutoModerationConfiguration
```
```
AutoModerationExecution
```
```
GuildMessagePolls
```
```
DirectMessagePolls
```

Intents

opaque </>

pub opaque type Intents

Values

add

</>

pub fn add(intents: Intents, intent: Intent) -> Intents

all

</>

pub fn all() -> Intents

Everything, privileged included. Discord refuses the connection with 4014 unless all three are enabled in the portal.

all_intents

</>

pub fn all_intents() -> List(Intent)

Every intent Discord currently defines, in bit order. A new variant has to be added here by hand; nothing in the compiler catches an omission, so every_bit_is_pinned_test counts this list against the bit table.

all_unprivileged

</>

pub fn all_unprivileged() -> Intents

Everything that does not need portal setup.

bit_index

</>

pub fn bit_index(intent: Intent) -> Int

The bit number, not its value, from Discord’s gateway intents table. Discord has assigned nothing to bits 17 to 19 or 22 to 23, and asking for one of those closes the connection with 4013.

contains

</>

pub fn contains(intents: Intents, intent: Intent) -> Bool

is_privileged

</>

pub fn is_privileged(intent: Intent) -> Bool

Exhaustive with no wildcard on purpose. A privileged intent Discord adds later would otherwise read as unprivileged here, all_unprivileged would ask for it, and the connection glyde promised would work closes with 4014.

new

</>

pub fn new(intents: List(Intent)) -> Intents

none

</>

pub fn none() -> Intents

No intents. Ungated events still arrive, READY and INTERACTION_CREATE among them, so this is right for a slash-command bot.

privileged

</>

pub fn privileged() -> List(Intent)

Enable these in the developer portal before asking for them. Above 100 servers they also need Discord’s approval.

privileged_in

</>

pub fn privileged_in(intents: Intents) -> List(Intent)

The privileged intents in this set, to name in an error message when Discord answers with 4014.

remove

</>

pub fn remove(intents: Intents, intent: Intent) -> Intents

to_int

</>

pub fn to_int(intents: Intents) -> Int

The bitfield for IDENTIFY. Discord wants a number here, unlike a permission set, which it sends and takes as a decimal string.

to_json

</>

pub fn to_json(intents: Intents) -> json.Json

to_list

</>

pub fn to_list(intents: Intents) -> List(Intent)

In bit order, and only the intents this build names. A bit assigned since is still carried through to_int untouched.

union

</>

pub fn union(a: Intents, b: Intents) -> Intents