@satorijs/adapter-discord 4.1.3 → 4.1.4

package/src/types/integration.ts

@@ -0,0 +1,130 @@
+import { integer, Internal, snowflake, timestamp, User } from '.'
+
+/** https://discord.com/developers/docs/resources/guild#integration-object-integration-structure */
+export interface Integration {
+  /** integration id */
+  id: snowflake
+  /** integration name */
+  name: string
+  /** integration type (twitch, youtube, or discord) */
+  type: string
+  /** is this integration enabled */
+  enabled: boolean
+  /** is this integration syncing */
+  syncing?: boolean
+  /** id that this integration uses for "subscribers" */
+  role_id?: snowflake
+  /** whether emoticons should be synced for this integration (twitch only currently) */
+  enable_emoticons?: boolean
+  /** the behavior of expiring subscribers */
+  expire_behavior?: IntegrationExpireBehavior
+  /** the grace period (in days) before expiring subscribers */
+  expire_grace_period?: integer
+  /** user for this integration */
+  user?: User
+  /** integration account information */
+  account: IntegrationAccount
+  /** when this integration was last synced */
+  synced_at?: timestamp
+  /** how many subscribers this integration has */
+  subscriber_count?: integer
+  /** has this integration been revoked */
+  revoked?: boolean
+  /** The bot/OAuth2 application for discord integrations */
+  application?: IntegrationApplication
+  /** the scopes the application has been authorized for */
+  scopes?: string[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-object-integration-expire-behaviors */
+export enum IntegrationExpireBehavior {
+  REMOVE_ROLE = 0,
+  KICK = 1,
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-account-object-integration-account-structure */
+export interface IntegrationAccount {
+  /** id of the account */
+  id: string
+  /** name of the account */
+  name: string
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-application-object-integration-application-structure */
+export interface IntegrationApplication {
+  /** the id of the app */
+  id: snowflake
+  /** the name of the app */
+  name: string
+  /** the icon hash of the app */
+  icon?: string
+  /** the description of the app */
+  description: string
+  /** the bot associated with this application */
+  bot?: User
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#guild-integrations-update-guild-integrations-update-event-fields */
+export interface GuildIntegrationsUpdateEvent {
+  /** id of the guild whose integrations were updated */
+  guild_id: snowflake
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#integration-create-integration-create-event-additional-fields */
+export interface IntegrationCreateEvent extends Integration {
+  /** id of the guild */
+  guild_id: snowflake
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#integration-update-integration-update-event-additional-fields */
+export interface IntegrationUpdateEvent extends Integration {
+  /** id of the guild */
+  guild_id: snowflake
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#integration-delete-integration-delete-event-fields */
+export interface IntegrationDeleteEvent {
+  /** integration id */
+  id: snowflake
+  /** id of the guild */
+  guild_id: snowflake
+  /** id of the bot/OAuth2 application for this discord integration */
+  application_id?: snowflake
+}
+
+declare module './gateway' {
+  interface GatewayEvents {
+    /** guild integration was updated */
+    GUILD_INTEGRATIONS_UPDATE: GuildIntegrationsUpdateEvent
+    /** guild integration was created */
+    INTEGRATION_CREATE: IntegrationCreateEvent
+    /** guild integration was updated */
+    INTEGRATION_UPDATE: IntegrationUpdateEvent
+    /** guild integration was deleted */
+    INTEGRATION_DELETE: IntegrationDeleteEvent
+  }
+}
+
+declare module './internal' {
+  interface Internal {
+    /**
+     * Returns a list of integration objects for the guild. Requires the MANAGE_GUILD permission.
+     * @see https://discord.com/developers/docs/resources/guild#get-guild-integrations
+     */
+    getGuildIntegrations(guild_id: snowflake): Promise<Integration[]>
+    /**
+     * Delete the attached integration object for the guild. Deletes any associated webhooks and kicks the associated bot if there is one. Requires the MANAGE_GUILD permission. Returns a 204 empty response on success. Fires a Guild Integrations Update Gateway event.
+     * @see https://discord.com/developers/docs/resources/guild#delete-guild-integration
+     */
+    deleteGuildIntegration(guild_id: snowflake, integration_id: snowflake): Promise<void>
+  }
+}
+
+Internal.define({
+  '/guilds/{guild.id}/integrations': {
+    GET: 'getGuildIntegrations',
+  },
+  '/guilds/{guild.id}/integrations/{integration.id}': {
+    DELETE: 'deleteGuildIntegration',
+  },
+})

package/src/types/interaction.ts

@@ -0,0 +1,283 @@
+import { AllowedMentions, ApplicationCommand, Attachment, Channel, Component, ComponentType, Embed, GuildMember, integer, Internal, Message, Role, snowflake, User } from '.'
+import * as Discord from '.'
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-structure */
+export interface Interaction {
+  /** id of the interaction */
+  id: snowflake
+  /** id of the application this interaction is for */
+  application_id: snowflake
+  /** the type of interaction */
+  type: Interaction.Type
+  /** the command data payload */
+  data?: InteractionData
+  /** the guild it was sent from */
+  guild_id?: snowflake
+  /** the channel it was sent from */
+  channel_id?: snowflake
+  /** guild member data for the invoking user, including permissions */
+  member?: GuildMember
+  /** user object for the invoking user, if invoked in a DM */
+  user?: User
+  /** a continuation token for responding to the interaction */
+  token: string
+  /** read-only property, always 1 */
+  version: integer
+  /** for components, the message they were attached to */
+  message?: Message
+  /** bitwise set of permissions the app or bot has within the channel the interaction was sent from */
+  app_permissions?: string
+  /** selected language of the invoking user */
+  locale?: string
+  /** guild's preferred locale, if invoked in a guild */
+  guild_locale?: string
+}
+
+export type InteractionData =
+  | InteractionData.ApplicationCommand
+  | InteractionData.MessageComponent
+  | InteractionData.ModalSubmit
+
+export namespace InteractionData {
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-application-command-data-structure */
+  export interface ApplicationCommand {
+    /** the ID of the invoked command */
+    id: snowflake
+    /** the name of the invoked command */
+    name: string
+    /** the type of the invoked command */
+    type: integer
+    /** converted users + roles + channels */
+    resolved?: ResolvedData
+    /** the params + values from the user */
+    options?: ApplicationCommand.Option[]
+    /** the id of the guild the command is registered to */
+    guild_id?: snowflake
+    /** id of the user or message targeted by a user or message command */
+    target_id?: snowflake
+  }
+
+  export namespace ApplicationCommand {
+    /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-application-command-interaction-data-option-structure */
+    export interface Option {
+      /** the name of the parameter */
+      name: string
+      /** value of application command option type */
+      type: Discord.ApplicationCommand.OptionType
+      /** the value of the pair */
+      value?: any
+      /** present if this option is a group or subcommand */
+      options?: Option[]
+      /** true if this option is the currently focused option for autocomplete */
+      focused?: boolean
+    }
+  }
+
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-message-component-data-structure */
+  export interface MessageComponent {
+    /** the custom_id of the component */
+    custom_id: string
+    /** the type of the component */
+    component_type: ComponentType
+    /** values the user selected in a select menu component */
+    values?: string[]
+  }
+
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-modal-submit-data-structure */
+  export interface ModalSubmit {
+    custom_id: string
+    components: Component[]
+  }
+}
+
+export namespace Interaction {
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-type */
+  export enum Type {
+    PING = 1,
+    APPLICATION_COMMAND = 2,
+    MESSAGE_COMPONENT = 3,
+    APPLICATION_COMMAND_AUTOCOMPLETE = 4,
+    MODAL_SUBMIT = 5,
+  }
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-resolved-data-structure */
+export interface ResolvedData {
+  /** the ids and User objects */
+  users?: Record<snowflake, User>
+  /** the ids and partial Member objects */
+  members?: Record<snowflake, Partial<GuildMember>>
+  /** the ids and Role objects */
+  roles?: Record<snowflake, Role>
+  /** the ids and partial Channel objects */
+  channels?: Record<snowflake, Partial<Channel>>
+  /** the ids and partial Message objects */
+  messages?: Record<snowflake, Partial<Message>>
+  /** the ids and attachment objects */
+  attachments?: Record<snowflake, Attachment>
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#message-interaction-object-message-interaction-structure */
+export interface MessageInteraction {
+  /** id of the interaction */
+  id: snowflake
+  /** the type of interaction */
+  type: Interaction.Type
+  /** the name of the application command */
+  name: string
+  /** the user who invoked the interaction */
+  user: User
+  /** member who invoked the interaction in the guild */
+  member?: Partial<GuildMember>
+}
+
+export namespace Interaction {
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-interaction-response-structure */
+  export interface Response {
+    /** the type of response */
+    type: CallbackType
+    /** an optional response message */
+    data?: CallbackData
+  }
+
+  /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type */
+  export enum CallbackType {
+    /** ACK a Ping */
+    PONG = 1,
+    /** respond to an interaction with a message */
+    CHANNEL_MESSAGE_WITH_SOURCE = 4,
+    /** ACK an interaction and edit a response later, the user sees a loading state */
+    DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE = 5,
+    /**
+     * for components, ACK an interaction and edit the original message later; the user does not see a loading state
+     * (only valid for [component-based](https://discord.com/developers/docs/interactions/message-components) interactions)
+     */
+    DEFERRED_UPDATE_MESSAGE = 6,
+    /**
+     * for components, edit the message the component was attached to
+     * (only valid for [component-based](https://discord.com/developers/docs/interactions/message-components) interactions)
+     */
+    UPDATE_MESSAGE = 7,
+    /** respond to an autocomplete interaction with suggested choices */
+    APPLICATION_COMMAND_AUTOCOMPLETE_RESULT = 8,
+    /**
+     * respond to an interaction with a popup modal
+     * (not available for `MODAL_SUBMIT` and `PING` interactions)
+     */
+    MODAL = 9,
+  }
+
+  export type CallbackData =
+    | CallbackData.Messages
+    | CallbackData.Autocomplete
+    | CallbackData.Modal
+
+  export namespace CallbackData {
+    /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-messages */
+    export interface Messages {
+      /** is the response TTS */
+      tts?: boolean
+      /** message content */
+      content?: string
+      /** supports up to 10 embeds */
+      embeds?: Embed[]
+      /** allowed mentions object */
+      allowed_mentions?: AllowedMentions
+      /** interaction callback data flags */
+      flags?: integer
+      /** message components */
+      components?: Component[]
+      /** attachment objects with filename and description */
+      attachments?: Partial<Attachment>[]
+    }
+
+    /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-autocomplete */
+    export interface Autocomplete {
+      /** autocomplete choices (max of 25 choices) */
+      choices: ApplicationCommand.OptionChoice[]
+    }
+
+    /** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-modal */
+    export interface Modal {
+      /** a developer-defined identifier for the modal, max 100 characters */
+      custom_id: string
+      /** the title of the popup modal, max 45 characters */
+      title: string
+      /** between 1 and 5 (inclusive) components that make up the modal */
+      components: Component[]
+    }
+  }
+}
+
+export interface InteractionCreateEvent extends Interaction { }
+
+declare module './gateway' {
+  interface GatewayEvents {
+    /** user used an interaction, such as an Application Command */
+    INTERACTION_CREATE: InteractionCreateEvent
+  }
+}
+
+declare module './internal' {
+  interface Internal {
+    /**
+     * Create a response to an Interaction from the gateway. Takes an interaction response. This endpoint also supports file attachments similar to the webhook endpoints. Refer to Uploading Files for details on uploading files and multipart/form-data requests.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response
+     */
+    createInteractionResponse(interaction_id: snowflake, token: string, params: Interaction.Response): Promise<void>
+    /**
+     * Returns the initial Interaction response. Functions the same as Get Webhook Message.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#get-original-interaction-response
+     */
+    getOriginalInteractionResponse(application_id: snowflake, token: string): Promise<Interaction.Response>
+    /**
+     * Edits the initial Interaction response. Functions the same as Edit Webhook Message.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#edit-original-interaction-response
+     */
+    editOriginalInteractionResponse(application_id: snowflake, token: string): Promise<Interaction.Response>
+    /**
+     * Deletes the initial Interaction response. Returns 204 No Content on success.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#delete-original-interaction-response
+     */
+    deleteOriginalInteractionResponse(application_id: snowflake, token: string): Promise<void>
+    /**
+     * Create a followup message for an Interaction. Functions the same as Execute Webhook, but wait is always true, and flags can be set to 64 in the body to send an ephemeral message. The thread_id, avatar_url, and username parameters are not supported when using this endpoint for interaction followups.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#create-followup-message
+     */
+    createFollowupMessage(application_id: snowflake, token: string): Promise<any>
+    /**
+     * Returns a followup message for an Interaction. Functions the same as Get Webhook Message. Does not support ephemeral followups.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#get-followup-message
+     */
+    getFollowupMessage(application_id: snowflake, token: string, message_id: snowflake): Promise<any>
+    /**
+     * Edits a followup message for an Interaction. Functions the same as Edit Webhook Message. Does not support ephemeral followups.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#edit-followup-message
+     */
+    editFollowupMessage(application_id: snowflake, token: string, message_id: snowflake): Promise<any>
+    /**
+     * Deletes a followup message for an Interaction. Returns 204 No Content on success. Does not support ephemeral followups.
+     * @see https://discord.com/developers/docs/interactions/receiving-and-responding#delete-followup-message
+     */
+    deleteFollowupMessage(application_id: snowflake, token: string, message_id: snowflake): Promise<void>
+  }
+}
+
+Internal.define({
+  '/interactions/{interaction.id}/{interaction.token}/callback': {
+    POST: 'createInteractionResponse',
+  },
+  '/webhooks/{application.id}/{interaction.token}/messages/@original': {
+    GET: 'getOriginalInteractionResponse',
+    PATCH: 'editOriginalInteractionResponse',
+    DELETE: 'deleteOriginalInteractionResponse',
+  },
+  '/webhooks/{application.id}/{interaction.token}': {
+    POST: 'createFollowupMessage',
+  },
+  '/webhooks/{application.id}/{interaction.token}/messages/{message.id}': {
+    GET: 'getFollowupMessage',
+    PATCH: 'editFollowupMessage',
+    DELETE: 'deleteFollowupMessage',
+  },
+})

package/src/types/internal.ts

@@ -0,0 +1,44 @@
+import { Dict, Logger, makeArray, Quester } from '@satorijs/satori'
+
+const logger = new Logger('discord')
+
+export class Internal {
+  constructor(private http: Quester) {}
+
+  static define(routes: Dict<Partial<Record<Quester.Method, string | string[]>>>) {
+    for (const path in routes) {
+      for (const key in routes[path]) {
+        const method = key as Quester.Method
+        for (const name of makeArray(routes[path][method])) {
+          Internal.prototype[name] = async function (this: Internal, ...args: any[]) {
+            const raw = args.join(', ')
+            const url = path.replace(/\{([^}]+)\}/g, () => {
+              if (!args.length) throw new Error(`too few arguments for ${path}, received ${raw}`)
+              return args.shift()
+            })
+            const config: Quester.AxiosRequestConfig = {}
+            if (args.length === 1) {
+              if (method === 'GET' || method === 'DELETE') {
+                config.params = args[0]
+              } else {
+                config.data = args[0]
+              }
+            } else if (args.length === 2 && method !== 'GET' && method !== 'DELETE') {
+              config.data = args[0]
+              config.params = args[1]
+            } else if (args.length > 1) {
+              throw new Error(`too many arguments for ${path}, received ${raw}`)
+            }
+            try {
+              logger.debug(`${method} ${url}`, config)
+              return await this.http(method, url, config)
+            } catch (error) {
+              if (!Quester.isAxiosError(error) || !error.response) throw error
+              throw new Error(`[${error.response.status}] ${JSON.stringify(error.response.data)}`)
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/src/types/invite.ts

@@ -0,0 +1,192 @@
+import { Application, Channel, Guild, GuildMember, GuildScheduledEvent, integer, Internal, snowflake, timestamp, User } from '.'
+
+/** https://discord.com/developers/docs/resources/invite#invite-object-invite-structure */
+export interface Invite {
+  /** the invite code (unique ID) */
+  code: string
+  /** the guild this invite is for */
+  guild?: Partial<Guild>
+  /** the channel this invite is for */
+  channel: Partial<Channel>
+  /** the user who created the invite */
+  inviter?: User
+  /** the type of target for this voice channel invite */
+  target_type?: Invite.TargetType
+  /** the user whose stream to display for this voice channel stream invite */
+  target_user?: User
+  /** the embedded application to open for this voice channel embedded application invite */
+  target_application?: Partial<Application>
+  /** approximate count of online members, returned from the GET /invites/<code> endpoint when with_counts is true */
+  approximate_presence_count?: integer
+  /** approximate count of total members, returned from the GET /invites/<code> endpoint when with_counts is true */
+  approximate_member_count?: integer
+  /** the expiration date of this invite, returned from the GET /invites/<code> endpoint when with_expiration is true */
+  expires_at?: timestamp
+  /** stage instance data if there is a public Stage instance in the Stage channel this invite is for */
+  stage_instance?: Invite.StageInstance
+  /** guild scheduled event data, only included if guild_scheduled_event_id contains a valid guild scheduled event id */
+  guild_scheduled_event?: GuildScheduledEvent
+}
+
+export namespace Invite {
+  /** https://discord.com/developers/docs/resources/invite#invite-object-invite-target-types */
+  export enum TargetType {
+    STREAM = 1,
+    EMBEDDED_APPLICATION = 2,
+  }
+
+  /** https://discord.com/developers/docs/resources/invite#invite-metadata-object-invite-metadata-structure */
+  export interface Metadata extends Invite {
+    /** number of times this invite has been used */
+    uses: integer
+    /** max number of times this invite can be used */
+    max_uses: integer
+    /** duration (in seconds) after which the invite expires */
+    max_age: integer
+    /** whether this invite only grants temporary membership */
+    temporary: boolean
+    /** when this invite was created */
+    created_at: timestamp
+  }
+
+  /** https://discord.com/developers/docs/resources/invite#invite-stage-instance-object-invite-stage-instance-structure */
+  export interface StageInstance {
+    /** the members speaking in the Stage */
+    members: Partial<GuildMember>[]
+    /** the number of users in the Stage */
+    participant_count: integer
+    /** the number of users speaking in the Stage */
+    speaker_count: integer
+    /** the topic of the Stage instance (1-120 characters) */
+    topic: string
+  }
+
+  export namespace Event {
+    /** https://discord.com/developers/docs/topics/gateway-events#invite-create-invite-create-event-fields */
+    export interface Create {
+      /** the channel the invite is for */
+      channel_id: snowflake
+      /** the unique invite code */
+      code: string
+      /** the time at which the invite was created */
+      created_at: timestamp
+      /** the guild of the invite */
+      guild_id?: snowflake
+      /** the user that created the invite */
+      inviter?: User
+      /** how long the invite is valid for (in seconds) */
+      max_age: integer
+      /** the maximum number of times the invite can be used */
+      max_uses: integer
+      /** the type of target for this voice channel invite */
+      target_type?: integer
+      /** the user whose stream to display for this voice channel stream invite */
+      target_user?: User
+      /** the embedded application to open for this voice channel embedded application invite */
+      target_application?: Partial<Application>
+      /** whether or not the invite is temporary (invited users will be kicked on disconnect unless they're assigned a role) */
+      temporary: boolean
+      /** how many times the invite has been used (always will be 0) */
+      uses: integer
+    }
+
+    /** https://discord.com/developers/docs/topics/gateway-events#invite-delete-invite-delete-event-fields */
+    export interface Delete {
+      /** the channel of the invite */
+      channel_id: snowflake
+      /** the guild of the invite */
+      guild_id?: snowflake
+      /** the unique invite code */
+      code: string
+    }
+  }
+
+  /** https://discord.com/developers/docs/resources/invite#get-invite-query-string-params */
+  export interface GetOptions {
+    /** whether to include invite metadata */
+    with_counts?: boolean
+    /** whether to include invite expiration date */
+    with_expiration?: boolean
+    /** the guild scheduled event to include with the invite */
+    guild_scheduled_event_id?: snowflake
+  }
+
+  /** https://discord.com/developers/docs/resources/channel#create-channel-invite-json-params */
+  export interface CreateParams {
+    /** duration of invite in seconds before expiry, or 0 for never. between 0 and 604800 (7 days) */
+    max_age: integer
+    /** max number of uses or 0 for unlimited. between 0 and 100 */
+    max_uses: integer
+    /** whether this invite only grants temporary membership */
+    temporary: boolean
+    /** if true, don't try to reuse a similar invite (useful for creating many unique one time use invites) */
+    unique: boolean
+    /** the type of target for this voice channel invite */
+    target_type: integer
+    /** the id of the user whose stream to display for this invite, required if target_type is 1, the user must be streaming in the channel */
+    target_user_id: snowflake
+    /** the id of the embedded application to open for this invite, required if target_type is 2, the application must have the EMBEDDED flag */
+    target_application_id: snowflake
+  }
+}
+
+declare module './gateway' {
+  interface GatewayEvents {
+    /** invite to a channel was created */
+    INVITE_CREATE: Invite.Event.Create
+    /** invite to a channel was deleted */
+    INVITE_DELETE: Invite.Event.Delete
+  }
+}
+
+declare module './internal' {
+  interface Internal {
+    /**
+     * Returns an invite object for the given code.
+     * @see https://discord.com/developers/docs/resources/invite#get-invite
+     */
+    getInvite(code: string, params?: Invite.GetOptions): Promise<Invite>
+    /**
+     * Delete an invite. Requires the MANAGE_CHANNELS permission on the channel this invite belongs to, or MANAGE_GUILD to remove any invite across the guild. Returns an invite object on success. Fires a Invite Delete Gateway event.
+     * @see https://discord.com/developers/docs/resources/invite#delete-invite
+     */
+    deleteInvite(code: string): Promise<Invite>
+    /**
+     * Returns a list of invite objects (with invite metadata) for the guild. Requires the MANAGE_GUILD permission.
+     * @see https://discord.com/developers/docs/resources/guild#get-guild-invites
+     */
+    getGuildInvites(guild_id: snowflake): Promise<Invite.Metadata[]>
+    /**
+     * Returns a partial invite object for guilds with that feature enabled. Requires the MANAGE_GUILD permission. code will be null if a vanity url for the guild is not set.
+     * @see https://discord.com/developers/docs/resources/guild#get-guild-vanity-url
+     */
+    getGuildVanityURL(guild_id: snowflake): Promise<Partial<Invite>>
+    /**
+     * Returns a list of invite objects (with invite metadata) for the channel. Only usable for guild channels. Requires the MANAGE_CHANNELS permission.
+     * @see https://discord.com/developers/docs/resources/channel#get-channel-invites
+     */
+    getChannelInvites(channel_id: string): Promise<Invite.Metadata[]>
+    /**
+     * Create a new invite object for the channel. Only usable for guild channels. Requires the CREATE_INSTANT_INVITE permission. All JSON parameters for this route are optional, however the request body is not. If you are not sending any fields, you still have to send an empty JSON object ({}). Returns an invite object. Fires an Invite Create Gateway event.
+     * @see https://discord.com/developers/docs/resources/channel#create-channel-invite
+     */
+    createChannelInvite(channel_id: string, params: Invite.CreateParams): Promise<void>
+  }
+}
+
+Internal.define({
+  '/invites/{invite.code}': {
+    GET: 'getInvite',
+    DELETE: 'deleteInvite',
+  },
+  '/guilds/{guild.id}/invites': {
+    GET: 'getGuildInvites',
+  },
+  '/guilds/{guild.id}/vanity-url': {
+    GET: 'getGuildVanityURL',
+  },
+  '/channels/{channel.id}/invites': {
+    GET: 'getChannelInvites',
+    POST: 'createChannelInvite',
+  },
+})