chapterjs 0.3.0 → 0.5.0

package/dist/events/registry.d.ts

@@ -1,7 +1,7 @@
 import type { CacheLimits } from '../cache/cache.js';
 import type { Snowflake } from '../discord/types/common.js';
 import type { GatewayDispatchEventName, GatewayDispatchEvents } from '../discord/types/gateway-events.js';
-import type { Channel, DMChannel, GuildChannel, GuildTextBasedChannel, TextBasedChannel, ThreadChannel, VoiceChannel } from '../structures/channel.js';
+import type { DMChannel, GuildChannel, GuildTextBasedChannel, TextBasedChannel, ThreadChannel, VoiceChannel } from '../structures/channel.js';
 import type { Context } from '../structures/context.js';
 import type { GuildEmoji } from '../structures/emoji.js';
 import type { AuditLogEntry, Guild, ScheduledEvent, VoiceState } from '../structures/guild.js';
@@ -11,7 +11,152 @@ import type { DmMessage, GuildMessage, MemberMessage, Message, PrivateMessage, R
 import type { Role } from '../structures/role.js';
 import type { User, UserPresence } from '../structures/user.js';
 import type { TranslationContext } from '../messages/messages.js';
-/** What your function receives, for each event. */
+/**
+ * A message that was deleted: what is known of it. The message itself is
+ * only there when the bot remembered it.
+ */
+export interface DeletedMessage {
+    /** The id of the deleted message. */
+    id: Snowflake;
+    /** The id of the channel the message was in. */
+    channelId: Snowflake;
+    /** The channel, when the bot knows it. */
+    channel: TextBasedChannel | null;
+    /** The id of the server; `null` for a private message. */
+    guildId: Snowflake | null;
+    /** The message as it was, when the bot remembered it. */
+    before: Message | null;
+}
+/** A reaction added to a message, or removed from it. */
+export interface UserReaction {
+    /** The emoji of the reaction. */
+    emoji: ReactionEmoji;
+    /** Who reacted. */
+    user: User;
+    /** Who reacted, as a member of the server: `null` in a private message, or when the bot does not remember them. */
+    member: GuildMember | null;
+    /** Whether it is a super reaction. */
+    burst: boolean;
+    /** The id of the message. */
+    messageId: Snowflake;
+    /** The message, when the bot remembers it. */
+    message: Message | null;
+    /** The id of the channel of the message. */
+    channelId: Snowflake;
+    /** The channel of the message, when the bot knows it. */
+    channel: TextBasedChannel | null;
+    /** The id of the server; `null` in a private message. */
+    guildId: Snowflake | null;
+}
+/** A reaction added to a message: what Discord tells of its message too. */
+export interface AddedReaction extends UserReaction {
+    /** The id of who wrote the message, when Discord says it. */
+    messageAuthorId: Snowflake | null;
+}
+/** Reactions removed from a message at once: all of them, or every reaction of one emoji. */
+export interface ClearedReactions {
+    /** The emoji whose reactions were removed; `null` when all were. */
+    emoji: ReactionEmoji | null;
+    /** The id of the message. */
+    messageId: Snowflake;
+    /** The message, when the bot remembers it. */
+    message: Message | null;
+    /** The id of the channel of the message. */
+    channelId: Snowflake;
+    /** The channel of the message, when the bot knows it. */
+    channel: TextBasedChannel | null;
+    /** The id of the server; `null` in a private message. */
+    guildId: Snowflake | null;
+}
+/** A vote in a poll, given or taken back. */
+export interface PollVote {
+    /** The id Discord gave to the answer: today, its position in the poll, `1` for the first answer. */
+    answerId: number;
+    /** Who voted. */
+    user: User;
+    /** Who voted, as a member of the server, when the bot remembers it. */
+    member: GuildMember | null;
+    /** The id of the message of the poll. */
+    messageId: Snowflake;
+    /** The message of the poll, when the bot remembers it. */
+    message: Message | null;
+    /** The id of the channel of the poll. */
+    channelId: Snowflake;
+    /** The channel of the poll, when the bot knows it. */
+    channel: TextBasedChannel | null;
+    /** The id of the server; `null` in a private message. */
+    guildId: Snowflake | null;
+}
+/** Someone typing in a channel. */
+export interface Typing {
+    /** Who is typing. */
+    user: User;
+    /** Who is typing, as a member of the server; `null` in a private message. */
+    member: GuildMember | null;
+    /** When they started. */
+    startedAt: Date;
+    /** The id of the channel. */
+    channelId: Snowflake;
+    /** The channel, when the bot knows it. */
+    channel: TextBasedChannel | null;
+    /** The id of the server; `null` in a private message. */
+    guildId: Snowflake | null;
+}
+/** An invite that was deleted, or expired: what is left of it. */
+export interface DeletedInvite {
+    /** The code of the invite (`discord.gg/code`). */
+    code: string;
+    /** The channel the invite led to. */
+    channel: GuildChannel;
+}
+/** Someone in a voice channel: who, where, and their voice state. */
+export interface VoiceActivity {
+    /** Who it is. */
+    member: GuildMember;
+    /** The voice channel. */
+    channel: VoiceChannel;
+    /** Their voice state: muted, deafened, streaming... */
+    state: VoiceState;
+}
+/** Someone who went from one voice channel to another. */
+export interface VoiceMove {
+    /** Who moved. */
+    member: GuildMember;
+    /** The channel they left. */
+    from: VoiceChannel;
+    /** The channel they are in now. */
+    to: VoiceChannel;
+    /** Their voice state, as it is now. */
+    state: VoiceState;
+}
+/** Someone in a voice channel whose voice state changed. */
+export interface VoiceChange extends VoiceActivity {
+    /** Their voice state as it was. */
+    before: VoiceState;
+}
+/** Someone's status or activity, as it is now, and whose it is. */
+export interface PresenceChange extends UserPresence {
+    /** The id of whose presence changed. */
+    userId: Snowflake;
+    /** The account of whose presence changed, when the bot knows it. */
+    user: User | null;
+    /** Whose presence changed, as a member of the server, when the bot remembers it. */
+    member: GuildMember | null;
+}
+/** Someone interested in a scheduled event, or no longer. */
+export interface ScheduledEventInterest {
+    /** The id of the scheduled event. */
+    scheduledEventId: Snowflake;
+    /** Who it is. */
+    user: User;
+    /** Who it is, as a member of the server, when the bot remembers it. */
+    member: GuildMember | null;
+}
+/**
+ * What your function receives, for each event: what the event is about,
+ * the server it happened in, and `t`. The widest form: the options of a
+ * file narrow it (`ContextOf`).
+ */
 export interface EventContexts {
     /** The bot is connected and knows every server it is in. */
     ready: {
@@ -24,26 +169,22 @@ export interface EventContexts {
     messageCreate: {
         /** The message that was sent. */
         message: Message;
+        /** The server; `null` for a private message. */
+        guild: Guild | null;
     };
     /** A message was edited. */
     messageUpdate: {
         /** The message, as it is now. */
         message: Message;
+        /** The server; `null` for a private message. */
+        guild: Guild | null;
     };
     /** A message was deleted. */
     messageDelete: {
-        /** The id of the deleted message. */
-        messageId: Snowflake;
-        /** The id of the channel the message was in. */
-        channelId: Snowflake;
-        /** The id of the server; `null` for a private message. */
-        guildId: Snowflake | null;
+        /** The message that was deleted. */
+        message: DeletedMessage;
         /** The server; `null` for a private message. */
         guild: Guild | null;
-        /** The channel, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The message as it was, when the bot remembered it. */
-        message: Message | null;
     };
     /** Someone joined a server. */
     memberJoin: {
@@ -58,8 +199,6 @@ export interface EventContexts {
         user: User;
         /** The server they left. */
         guild: Guild;
-        /** The member as it was, when the bot knew it. */
-        member: GuildMember | null;
     };
     /** A member changed: nickname, roles, timeout, avatar... */
     memberUpdate: {
@@ -81,17 +220,32 @@ export interface EventContexts {
     /** A channel was created. */
     channelCreate: {
         /** The new channel or thread. */
-        channel: GuildChannel | ThreadChannel | Channel;
+        channel: GuildChannel | ThreadChannel;
+        /**
+         * The server of the channel: Discord only sends these events, with the
+         * Guilds intent, for the channels of a server.
+         */
+        guild: Guild;
     };
     /** A channel changed: name, topic, permissions... */
     channelUpdate: {
         /** The channel or thread, as it is now. */
-        channel: GuildChannel | ThreadChannel | Channel;
+        channel: GuildChannel | ThreadChannel;
+        /**
+         * The server of the channel: Discord only sends these events, with the
+         * Guilds intent, for the channels of a server.
+         */
+        guild: Guild;
     };
     /** A channel was deleted. */
     channelDelete: {
         /** The channel or thread as it was. */
-        channel: GuildChannel | ThreadChannel | Channel;
+        channel: GuildChannel | ThreadChannel;
+        /**
+         * The server of the channel: Discord only sends these events, with the
+         * Guilds intent, for the channels of a server.
+         */
+        guild: Guild;
     };
     /** A role was created. */
     roleCreate: {
@@ -109,12 +263,10 @@ export interface EventContexts {
     };
     /** A role was deleted. */
     roleDelete: {
-        /** The id of the deleted role. */
-        roleId: Snowflake;
-        /** The server the role was in. */
-        guild: Guild;
         /** The role as it was. */
         role: Role;
+        /** The server the role was in. */
+        guild: Guild;
     };
     /** The server changed: name, icon, settings... */
     guildUpdate: {
@@ -162,17 +314,13 @@ export interface EventContexts {
         invite: Invite;
         /** The server the invite leads to. */
         guild: Guild;
-        /** The channel the invite leads to. */
-        channel: GuildChannel;
     };
     /** An invite was deleted, or expired. */
     inviteDelete: {
-        /** The code of the invite (`discord.gg/code`). */
-        code: string;
+        /** The invite that was deleted. */
+        invite: DeletedInvite;
         /** The server the invite led to. */
         guild: Guild;
-        /** The channel the invite led to. */
-        channel: GuildChannel;
     };
     /** Something was added to the audit log of a server. */
     auditLogEntryCreate: {
@@ -183,125 +331,43 @@ export interface EventContexts {
     };
     /** Someone added a reaction to a message. */
     reactionAdd: {
-        /** The emoji of the reaction. */
-        emoji: ReactionEmoji;
-        /** Who reacted. */
-        user: User;
-        /** Who reacted, as a member of the server; `null` in a private message. */
-        member: GuildMember | null;
-        /** Whether it is a super reaction. */
-        burst: boolean;
-        /** The id of the message. */
-        messageId: Snowflake;
-        /** The message, when the bot remembers it. */
-        message: Message | null;
-        /** The id of who wrote the message, when Discord says it. */
-        messageAuthorId: Snowflake | null;
-        /** The id of the channel of the message. */
-        channelId: Snowflake;
-        /** The channel of the message, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** The reaction that was added. */
+        reaction: AddedReaction;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
     /** Someone removed their reaction from a message. */
     reactionRemove: {
-        /** The emoji of the reaction. */
-        emoji: ReactionEmoji;
-        /** Who had reacted. */
-        user: User;
-        /** Who had reacted, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
-        /** Whether it was a super reaction. */
-        burst: boolean;
-        /** The id of the message. */
-        messageId: Snowflake;
-        /** The message, when the bot remembers it. */
-        message: Message | null;
-        /** The id of the channel of the message. */
-        channelId: Snowflake;
-        /** The channel of the message, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** The reaction that was removed. */
+        reaction: UserReaction;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
     /** The reactions of a message were removed: all of them, or every reaction of one emoji. */
     reactionClear: {
-        /** The emoji whose reactions were removed; `null` when all were. */
-        emoji: ReactionEmoji | null;
-        /** The id of the message. */
-        messageId: Snowflake;
-        /** The message, when the bot remembers it. */
-        message: Message | null;
-        /** The id of the channel of the message. */
-        channelId: Snowflake;
-        /** The channel of the message, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** The reactions that were removed. */
+        reactions: ClearedReactions;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
     /** Someone voted in a poll. */
     pollVoteAdd: {
-        /** The id Discord gave to the answer they voted for: today, its position in the poll, `1` for the first answer. */
-        answerId: number;
-        /** Who voted. */
-        user: User;
-        /** Who voted, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
-        /** The id of the message of the poll. */
-        messageId: Snowflake;
-        /** The message of the poll, when the bot remembers it. */
-        message: Message | null;
-        /** The id of the channel of the poll. */
-        channelId: Snowflake;
-        /** The channel of the poll, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** The vote. */
+        vote: PollVote;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
     /** Someone took back their vote in a poll. */
     pollVoteRemove: {
-        /** The id Discord gave to the answer they no longer vote for: today, its position in the poll, `1` for the first answer. */
-        answerId: number;
-        /** Who had voted. */
-        user: User;
-        /** Who had voted, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
-        /** The id of the message of the poll. */
-        messageId: Snowflake;
-        /** The message of the poll, when the bot remembers it. */
-        message: Message | null;
-        /** The id of the channel of the poll. */
-        channelId: Snowflake;
-        /** The channel of the poll, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** The vote taken back. */
+        vote: PollVote;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
     /** Someone started typing in a channel. */
     typingStart: {
-        /** Who is typing. */
-        user: User;
-        /** Who is typing, as a member of the server; `null` in a private message. */
-        member: GuildMember | null;
-        /** When they started. */
-        startedAt: Date;
-        /** The id of the channel. */
-        channelId: Snowflake;
-        /** The channel, when the bot knows it. */
-        channel: TextBasedChannel | null;
-        /** The id of the server; `null` in a private message. */
-        guildId: Snowflake | null;
+        /** Who is typing, and where. */
+        typing: Typing;
         /** The server; `null` in a private message. */
         guild: Guild | null;
     };
@@ -311,8 +377,6 @@ export interface EventContexts {
         thread: ThreadChannel;
         /** Who was added, as a member of the server. */
         member: GuildMember;
-        /** The account of who was added. */
-        user: User;
         /** The server of the thread. */
         guild: Guild;
     };
@@ -322,8 +386,6 @@ export interface EventContexts {
         thread: ThreadChannel;
         /** The id of who was removed. */
         userId: Snowflake;
-        /** The account of who was removed, when the bot knows it. */
-        user: User | null;
         /** Who was removed, as a member of the server, when the bot remembers it. */
         member: GuildMember | null;
         /** The server of the thread. */
@@ -331,62 +393,36 @@ export interface EventContexts {
     };
     /** Someone joined a voice channel. */
     voiceJoin: {
-        /** Who joined. */
-        member: GuildMember;
-        /** The channel they joined. */
-        channel: VoiceChannel;
-        /** Their voice state: muted, deafened, streaming... */
-        voice: VoiceState;
+        /** Who joined, the channel, and their voice state. */
+        voice: VoiceActivity;
         /** The server of the channel. */
         guild: Guild;
     };
     /** Someone left a voice channel, or was disconnected. */
     voiceLeave: {
-        /** Who left. */
-        member: GuildMember;
-        /** The channel they left. */
-        channel: VoiceChannel;
-        /** Their voice state as it was, in that channel. */
-        voice: VoiceState;
+        /** Who left, the channel they left, and their voice state as it was. */
+        voice: VoiceActivity;
         /** The server of the channel. */
         guild: Guild;
     };
     /** Someone went from one voice channel to another, or was moved. */
     voiceMove: {
-        /** Who moved. */
-        member: GuildMember;
-        /** The channel they left. */
-        from: VoiceChannel;
-        /** The channel they are in now. */
-        to: VoiceChannel;
-        /** Their voice state, as it is now. */
-        voice: VoiceState;
+        /** Who moved, from where, to where. */
+        voice: VoiceMove;
         /** The server of the channels. */
         guild: Guild;
     };
     /** Someone in a voice channel changed: muted, deafened, started a stream or a camera... */
     voiceUpdate: {
-        /** Who changed. */
-        member: GuildMember;
-        /** The channel they are in. */
-        channel: VoiceChannel;
-        /** Their voice state, as it is now. */
-        voice: VoiceState;
-        /** Their voice state as it was. */
-        before: VoiceState;
+        /** Who changed, their voice state now and before. */
+        voice: VoiceChange;
         /** The server of the channel. */
         guild: Guild;
     };
     /** Someone's status or activity changed: online, idle, playing a game... */
     presenceUpdate: {
-        /** The id of whose presence changed. */
-        userId: Snowflake;
-        /** The account of whose presence changed, when the bot knows it. */
-        user: User | null;
-        /** Whose presence changed, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
-        /** Their status, activities and devices, as they are now. */
-        presence: UserPresence;
+        /** The presence as it is now, and whose it is. */
+        presence: PresenceChange;
         /** The server the change is seen from. */
         guild: Guild;
     };
@@ -413,23 +449,15 @@ export interface EventContexts {
     };
     /** Someone said they are interested in a scheduled event. */
     scheduledEventUserAdd: {
-        /** The id of the scheduled event. */
-        scheduledEventId: Snowflake;
-        /** Who is interested. */
-        user: User;
-        /** Who is interested, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
+        /** Who is interested, in which scheduled event. */
+        interest: ScheduledEventInterest;
         /** The server of the scheduled event. */
         guild: Guild;
     };
     /** Someone is no longer interested in a scheduled event. */
     scheduledEventUserRemove: {
-        /** The id of the scheduled event. */
-        scheduledEventId: Snowflake;
-        /** Who is no longer interested. */
-        user: User;
-        /** Who is no longer interested, as a member of the server, when the bot remembers it. */
-        member: GuildMember | null;
+        /** Who is no longer interested, in which scheduled event. */
+        interest: ScheduledEventInterest;
         /** The server of the scheduled event. */
         guild: Guild;
     };
@@ -493,88 +521,67 @@ type IsOn<Options, Key extends string> = Key extends keyof Options ? Exclude<Opt
  * it says nothing, every place it may be when it is only known to be one.
  */
 type WhereOf<Options> = 'where' extends keyof Options ? [Exclude<Options['where'], undefined>] extends [never] ? 'guild' : Exclude<Options['where'], undefined> : 'guild';
-/** A message of a server: its author is a member unless bots are let in. */
-type ServerMessage<Options> = IsOn<Options, 'bots'> extends true ? GuildMessage : MemberMessage;
-/** The message a file receives: what its options let through. */
-type MessageFor<Options, Where = WhereOf<Options>> = Where extends 'guild' ? ServerMessage<Options> : Where extends 'dm' ? DmMessage : ServerMessage<Options> | PrivateMessage;
-type Deleted = Omit<EventContexts['messageDelete'], 'guildId' | 'guild' | 'channel' | 'message'>;
-/** A message deleted in a server. */
-interface DeletedInGuild extends Deleted {
-    /** The id of the server. */
-    guildId: Snowflake;
-    /** The server the message was in. */
-    guild: Guild;
-    /** The channel the message was in. */
-    channel: GuildTextBasedChannel;
-    /** The message as it was, when the bot remembered it. */
-    message: GuildMessage | null;
-}
-/** A private message deleted, for a file that receives both kinds. */
-interface DeletedInPrivate extends Deleted {
-    /** No server: the message was private. */
-    guildId: null;
-    /** No server: the message was private. */
-    guild: null;
-    /** The private conversation, when the bot knows it. */
-    channel: DMChannel | null;
-    /** The message as it was, when the bot remembered it. */
-    message: PrivateMessage | null;
-}
-/** A private message deleted, for a file that only receives those. */
-interface DeletedInDm extends Deleted {
-    /** The private conversation, when the bot knows it. */
-    channel: DMChannel | null;
-    /** The message as it was, when the bot remembered it. */
-    message: DmMessage | null;
-}
-type DeletedFor<Where> = Where extends 'guild' ? DeletedInGuild : Where extends 'dm' ? DeletedInDm : DeletedInGuild | DeletedInPrivate;
-/** Where something happened in a server: the server and the channel are there. */
-interface ServerPlace {
+/**
+ * Something about a message, told apart by where it happened: in a server
+ * the server is there and the channel is one of the server; in private,
+ * the conversation, when the bot knows it.
+ */
+interface InServer {
     /** The id of the server. */
     guildId: Snowflake;
-    /** The server. */
-    guild: Guild;
     /** The channel. */
     channel: GuildTextBasedChannel;
 }
-/** Where something happened in private, for a file that receives both kinds. */
-interface PrivatePlace {
+/** In private, for a file that receives both kinds. */
+interface InPrivate {
     /** No server: it happened in private. */
     guildId: null;
-    /** No server: it happened in private. */
-    guild: null;
     /** The private conversation, when the bot knows it. */
     channel: DMChannel | null;
 }
-/** Where something happened in private, for a file that only receives that. */
-interface DmPlace {
+/** In private, for a file that only receives that. */
+interface InDm {
     /** The private conversation, when the bot knows it. */
     channel: DMChannel | null;
 }
-/** The message of something that happened in a server. */
+/** The fields of an object that its place narrows. */
+type PlaceKeys = 'guildId' | 'channel' | 'message' | 'member' | 'before';
+/** `T` without what its place narrows: the rest is the same everywhere. */
+type Unplaced<T> = Omit<T, PlaceKeys>;
+/**
+ * What a file receives for an event of servers and private messages,
+ * following where it listens: the object of the event under `Key`, and
+ * the server when there is one. With `'both'`, a union told apart by
+ * `guild`.
+ */
+type Placed<Where, Key extends string, InGuild, Private, Dm> = Where extends 'guild' ? {
+    [K in Key]: InGuild;
+} & {
+    guild: Guild;
+} : Where extends 'dm' ? {
+    [K in Key]: Dm;
+} : ({
+    [K in Key]: InGuild;
+} & {
+    guild: Guild;
+}) | ({
+    [K in Key]: Private;
+} & {
+    guild: null;
+});
+/** A message the bot remembers, in each place. */
 interface ServerMessagePart {
     /** The message, when the bot remembers it. */
     message: GuildMessage | null;
 }
-/** The message of something that happened in private, for both kinds. */
 interface PrivateMessagePart {
     /** The message, when the bot remembers it. */
     message: PrivateMessage | null;
 }
-/** The message of something that happened in private, for that only. */
 interface DmMessagePart {
     /** The message, when the bot remembers it. */
     message: DmMessage | null;
 }
-/** The fields an event of servers and private messages narrows. */
-type PlaceKeys = 'guildId' | 'guild' | 'channel' | 'message' | 'member';
-/**
- * What a file receives for an event of servers and private messages,
- * following where it listens: the same fields, plus what each place has.
- */
-type Placed<Where, Common, InServer, InPrivate, InDm> = Where extends 'guild' ? Common & InServer : Where extends 'dm' ? Common & InDm : (Common & InServer) | (Common & InPrivate);
-/** An event about a message, with or without the member who did it. */
-type OnMessage<Name extends EventName, Options, Member> = Placed<WhereOf<Options>, Omit<EventContexts[Name], PlaceKeys>, ServerPlace & ServerMessagePart & Member, PrivatePlace & PrivateMessagePart & ([keyof Member] extends [never] ? object : NoMember), DmPlace & DmMessagePart>;
 /** No member in private: who did it is `user`. */
 interface NoMember {
     /** No member: it happened in private. */
@@ -590,24 +597,39 @@ interface KnownMember {
     /** Who did it, as a member of the server, when the bot remembers it. */
     member: GuildMember | null;
 }
+/** An object about a message (a reaction, a vote), narrowed by where. */
+type AboutMessage<Where, Key extends string, T, Member> = Placed<Where, Key, Unplaced<T> & InServer & ServerMessagePart & Member, Unplaced<T> & InPrivate & PrivateMessagePart & ([keyof Member] extends [never] ? object : NoMember), Unplaced<T> & InDm & DmMessagePart>;
+/** A message of a server: its author is a member unless bots are let in. */
+type ServerMessage<Options> = IsOn<Options, 'bots'> extends true ? GuildMessage : MemberMessage;
+/** A message deleted in a server. */
+interface DeletedInGuild extends Unplaced<DeletedMessage>, InServer {
+    /** The message as it was, when the bot remembered it. */
+    before: GuildMessage | null;
+}
+/** A private message deleted, for a file that receives both kinds. */
+interface DeletedInPrivate extends Unplaced<DeletedMessage>, InPrivate {
+    /** The message as it was, when the bot remembered it. */
+    before: PrivateMessage | null;
+}
+/** A private message deleted, for a file that only receives those. */
+interface DeletedInDm extends Unplaced<DeletedMessage>, InDm {
+    /** The message as it was, when the bot remembered it. */
+    before: DmMessage | null;
+}
 /**
  * The events whose handler receives something more precise than
  * `EventContexts`, following where its file listens.
  */
 interface NarrowedContexts<Options> {
-    messageCreate: {
-        message: MessageFor<Options>;
-    };
-    messageUpdate: {
-        message: MessageFor<Options>;
-    };
-    messageDelete: DeletedFor<WhereOf<Options>>;
-    reactionAdd: OnMessage<'reactionAdd', Options, SentMember>;
-    reactionRemove: OnMessage<'reactionRemove', Options, KnownMember>;
-    reactionClear: OnMessage<'reactionClear', Options, object>;
-    pollVoteAdd: OnMessage<'pollVoteAdd', Options, KnownMember>;
-    pollVoteRemove: OnMessage<'pollVoteRemove', Options, KnownMember>;
-    typingStart: Placed<WhereOf<Options>, Omit<EventContexts['typingStart'], PlaceKeys>, ServerPlace & SentMember, PrivatePlace & NoMember, DmPlace>;
+    messageCreate: Placed<WhereOf<Options>, 'message', ServerMessage<Options>, PrivateMessage, DmMessage>;
+    messageUpdate: Placed<WhereOf<Options>, 'message', ServerMessage<Options>, PrivateMessage, DmMessage>;
+    messageDelete: Placed<WhereOf<Options>, 'message', DeletedInGuild, DeletedInPrivate, DeletedInDm>;
+    reactionAdd: AboutMessage<WhereOf<Options>, 'reaction', AddedReaction, SentMember>;
+    reactionRemove: AboutMessage<WhereOf<Options>, 'reaction', UserReaction, KnownMember>;
+    reactionClear: AboutMessage<WhereOf<Options>, 'reactions', ClearedReactions, object>;
+    pollVoteAdd: AboutMessage<WhereOf<Options>, 'vote', PollVote, KnownMember>;
+    pollVoteRemove: AboutMessage<WhereOf<Options>, 'vote', PollVote, KnownMember>;
+    typingStart: Placed<WhereOf<Options>, 'typing', Unplaced<Typing> & InServer & SentMember, Unplaced<Typing> & InPrivate & NoMember, Unplaced<Typing> & InDm>;
 }
 /**
  * What your function receives for an event, given the options its file passed