User installed apps

discord/discord-api-docs#6723
discord/discord-api-docs#6726
discord/discord-api-docs#6727
discord/discord-api-docs#6728

lib/Constants.ts

@@ -112,6 +112,17 @@ export enum UserFlags {
  RESTRICTED_COLLABORATOR = 2 ** 51,
 }
 
+export enum ApplicationIntegrationTypes {
+ GUILD_INSTALL = 0,
+ USER_INSTALL = 1,
+}
+
+export enum InteractionContextTypes {
+ GUILD = 0,
+ BOT_DM = 1,
+ PRIVATE_CHANNEL = 2,
+}
+
 export enum ApplicationFlags {
  EMBEDDED_RELEASED = 1 << 1,
  MANAGED_EMOJI = 1 << 2,

lib/routes/Applications.ts

@@ -49,10 +49,12 @@ export default class Applications {
  method: "PUT",
  path: Routes.APPLICATION_COMMANDS(applicationID),
  json: opts.map(opt => ({
- default_member_permissions: opt.defaultMemberPermissions,
+ contexts: opt.contexts,
  description: opt.description,
+ default_member_permissions: opt.defaultMemberPermissions,
  description_localizations: opt.descriptionLocalizations,
  dm_permission: opt.dmPermission,
+ integration_types: opt.integrationTypes,
  name: opt.name,
  name_localizations: opt.nameLocalizations,
  nsfw: opt.nsfw,
@@ -101,10 +103,12 @@ export default class Applications {
  method: "POST",
  path: Routes.APPLICATION_COMMANDS(applicationID),
  json: {
+ contexts: opt.contexts,
  default_member_permissions: opt.defaultMemberPermissions,
  description: opt.description,
  description_localizations: opt.descriptionLocalizations,
  dm_permission: opt.dmPermission,
+ integration_types: opt.integrationTypes,
  name: opt.name,
  name_localizations: opt.nameLocalizations,
  nsfw: opt.nsfw,
@@ -220,6 +224,7 @@ export default class Applications {
  flags: options.flags,
  icon: options.icon,
  install_params: options.installParams,
+ integration_types_config: options.integrationTypesConfig,
  interactions_endpoint_url: options.interactionsEndpointURL,
  role_connections_verification_url: options.roleConnectionsVerificationURL,
  tags: options.tags
@@ -240,10 +245,12 @@ export default class Applications {
  method: "PATCH",
  path: Routes.APPLICATION_COMMAND(applicationID, commandID),
  json: {
+ contexts: opt.contexts,
  default_member_permissions: opt.defaultMemberPermissions,
  description: opt.description,
  description_localizations: opt.descriptionLocalizations,
  dm_permission: opt.dmPermission,
+ integration_types: opt.integrationTypes,
  name: opt.name,
  name_localizations: opt.nameLocalizations,
  nsfw: opt.nsfw,

lib/structures/Application.ts

@@ -3,10 +3,10 @@ import ClientApplication from "./ClientApplication";
 import OAuthGuild from "./OAuthGuild";
 import type Client from "../Client";
 import type { InstallParams } from "../types/oauth";
-import type { ImageFormat } from "../Constants";
+import type { ApplicationIntegrationTypes, ImageFormat } from "../Constants";
 import * as Routes from "../util/Routes";
 import type { JSONApplication } from "../types/json";
-import type { RESTApplication } from "../types";
+import type { IntegrationTypesConfig, RESTApplication } from "../types";
 
 /** Represents an application. */
 export default class Application extends ClientApplication {
@@ -26,6 +26,10 @@ export default class Application extends ClientApplication {
  icon: string | null;
  /** Settings for this application's in-app authorization link, if enabled. */
  installParams?: InstallParams;
+ /** The install types available for this application. */
+ integrationTypes: Array<ApplicationIntegrationTypes>;
+ /** The configs for the install types available for this application. */
+ integrationTypesConfig: IntegrationTypesConfig;
  /** This applications interaction endpoint url, if any. */
  interactionsEndpointURL: string | null;
  /** The name of the application. */
@@ -56,6 +60,8 @@ export default class Application extends ClientApplication {
  this.guild = null;
  this.guildID = data.guild_id ?? null;
  this.icon = null;
+ this.integrationTypes = [];
+ this.integrationTypesConfig = {};
  this.interactionsEndpointURL = null;
  this.name = data.name;
  this.roleConnectionsVerificationURL = null;
@@ -89,6 +95,12 @@ export default class Application extends ClientApplication {
  if (data.install_params !== undefined) {
  this.installParams = data.install_params;
  }
+ if (data.integration_types !== undefined) {
+ this.integrationTypes = data.integration_types;
+ }
+ if (data.integration_types_config !== undefined) {
+ this.integrationTypesConfig = Object.fromEntries(Object.entries(data.integration_types_config).map(([key, value]) => [key, { oauth2InstallParams: value.oauth2_install_params }]));
+ }
  if (data.interactions_endpoint_url !== undefined) {
  this.interactionsEndpointURL = data.interactions_endpoint_url;
  }
@@ -153,6 +165,8 @@ export default class Application extends ClientApplication {
  guildID: this.guildID,
  icon: this.icon,
  installParams: this.installParams,
+ integrationTypes: this.integrationTypes,
+ integrationTypesConfig: this.integrationTypesConfig,
  interactionsEndpointURL: this.interactionsEndpointURL,
  name: this.name,
  primarySKUID: this.primarySKUID,

lib/structures/ApplicationCommand.ts

@@ -4,7 +4,7 @@ import Permission from "./Permission";
 import type Guild from "./Guild";
 import type ClientApplication from "./ClientApplication";
 import type Client from "../Client";
-import { ApplicationCommandTypes } from "../Constants";
+import { ApplicationCommandTypes, type InteractionContextTypes, type ApplicationIntegrationTypes } from "../Constants";
 import type {
  ApplicationCommandOptionConversion,
  ApplicationCommandOptions,
@@ -24,6 +24,8 @@ export default class ApplicationCommand<T extends ApplicationCommandTypes = Appl
  application?: ClientApplication;
  /** The ID of application this command is for. */
  applicationID: string;
+ /** The contexts in which this application command can be used in. */
+ contexts: Array<InteractionContextTypes>;
  /** The default permissions for this command. */
  defaultMemberPermissions: Permission | null;
  /** The description of this command. Empty string for non `CHAT_INPUT` commands. */
@@ -36,6 +38,8 @@ export default class ApplicationCommand<T extends ApplicationCommandTypes = Appl
  dmPermission?: boolean;
  /** The id of the guild this command is in (guild commands only). */
  guildID: string | null;
+ /** The installation contexts in which this command is available. */
+ integrationTypes: Array<ApplicationIntegrationTypes>;
  /** The name of this command. */
  name: string;
  /** A dictionary of [locales](https://discord.com/developers/docs/reference#locales) to localized names. */
@@ -54,12 +58,14 @@ export default class ApplicationCommand<T extends ApplicationCommandTypes = Appl
  super(data.id, client);
  this.application = client["_application"] && client.application.id === data.application_id ? client.application : undefined;
  this.applicationID = data.application_id;
+ this.contexts = data.contexts;
  this.defaultMemberPermissions = data.default_member_permissions ? new Permission(data.default_member_permissions) : null;
  this.description = data.description as never;
  this.descriptionLocalizations = data.description_localizations;
  this.descriptionLocalized = data.description_localized;
  this.dmPermission = data.dm_permission;
  this.guildID = data.guild_id ?? null;
+ this.integrationTypes = data.integration_types;
  this.name = data.name;
  this.nameLocalizations = data.name_localizations;
  this.nameLocalized = data.name_localized;
@@ -135,11 +141,13 @@ export default class ApplicationCommand<T extends ApplicationCommandTypes = Appl
  return {
  ...super.toJSON(),
  applicationID: this.applicationID,
+ contexts: this.contexts,
  defaultMemberPermissions: this.defaultMemberPermissions?.toJSON(),
  description: this.description,
  descriptionLocalizations: this.descriptionLocalizations,
  dmPermission: this.dmPermission,
  guildID: this.guildID ?? undefined,
+ integrationTypes: this.integrationTypes,
  name: this.name,
  nameLocalizations: this.nameLocalizations,
  nsfw: this.nsfw,

lib/structures/AutocompleteInteraction.ts

@@ -8,8 +8,14 @@ import GuildChannel from "./GuildChannel";
 import type PrivateChannel from "./PrivateChannel";
 import type Entitlement from "./Entitlement";
 import type TestEntitlement from "./TestEntitlement";
-import { InteractionResponseTypes, type InteractionTypes } from "../Constants";
-import type { AutocompleteChoice, AutocompleteInteractionData, InteractionGuild, RawAutocompleteInteraction } from "../types/interactions";
+import { InteractionResponseTypes, type InteractionTypes, type InteractionContextTypes } from "../Constants";
+import type {
+ AuthorizingIntegrationOwners,
+ AutocompleteChoice,
+ AutocompleteInteractionData,
+ InteractionGuild,
+ RawAutocompleteInteraction
+} from "../types/interactions";
 import type Client from "../Client";
 import type { AnyTextableGuildChannel, AnyInteractionChannel } from "../types/channels";
 import type { JSONAutocompleteInteraction } from "../types/json";
@@ -21,10 +27,14 @@ import { UncachedError } from "../util/Errors";
 export default class AutocompleteInteraction<T extends AnyInteractionChannel | Uncached = AnyInteractionChannel | Uncached> extends Interaction {
  private _cachedChannel!: T extends AnyInteractionChannel ? T : undefined;
  private _cachedGuild?: T extends AnyTextableGuildChannel ? Guild : Guild | null;
- /** The permissions the bot has in the channel this interaction was sent from, if this interaction is sent from a guild. */
- appPermissions: T extends AnyTextableGuildChannel ? Permission : Permission | undefined;
+ /** The permissions the bot has in the channel this interaction was sent from. If in a dm/group dm, this will contain `ATTACH_FILES`, `EMBED_LINKS`, and `MENTION_EVERYONE`. In addition, `USE_EXTERNAL_EMOJIS` will be included for DMs with the app's bot user. */
+ appPermissions: Permission;
+ /** Details about the authorizing user or server for the installation(s) relevant to the interaction. See [Discord's docs](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object) for more information. */
+ authorizingIntegrationOwners: AuthorizingIntegrationOwners;
  /** The ID of the channel this interaction was sent from. */
  channelID: string;
+ /** The context this interaction was sent from. */
+ context?: InteractionContextTypes;
  /** The data associated with the interaction. */
  data: AutocompleteInteractionData;
  /** The entitlements for the user that created this interaction, and the guild it was created in. */
@@ -46,8 +56,10 @@ export default class AutocompleteInteraction<T extends AnyInteractionChannel | U
  user: User;
  constructor(data: RawAutocompleteInteraction, client: Client) {
  super(data, client);
- this.appPermissions = (data.app_permissions === undefined ? undefined : new Permission(data.app_permissions)) as T extends AnyTextableGuildChannel ? Permission : Permission | undefined;
+ this.appPermissions = new Permission(data.app_permissions ?? "0");
+ this.authorizingIntegrationOwners = data.authorizing_integration_owners;
  this.channelID = data.channel_id!;
+ this.context = data.context;
  this.data = {
  guildID: data.data.guild_id,
  id: data.data.id,
@@ -109,15 +121,18 @@ export default class AutocompleteInteraction<T extends AnyInteractionChannel | U
  override toJSON(): JSONAutocompleteInteraction {
  return {
  ...super.toJSON(),
- appPermissions: this.appPermissions?.toJSON(),
- channel: this.channelID,
- data: this.data,
- guildID: this.guildID ?? undefined,
- guildLocale: this.guildLocale,
- locale: this.locale,
- member: this.member?.toJSON(),
- type: this.type,
- user: this.user.toJSON()
+ appPermissions: this.appPermissions.toJSON(),
+ authorizingIntegrationOwners: this.authorizingIntegrationOwners,
+ channel: this.channelID, // TODO: remove in 1.10.0
+ channelID: this.channelID,
+ context: this.context,
+ data: this.data,
+ guildID: this.guildID ?? undefined,
+ guildLocale: this.guildLocale,
+ locale: this.locale,
+ member: this.member?.toJSON(),
+ type: this.type,
+ user: this.user.toJSON()
  };
  }
 }

lib/structures/CommandInteraction.ts

@@ -13,15 +13,16 @@ import InteractionResolvedChannel from "./InteractionResolvedChannel";
 import type Entitlement from "./Entitlement";
 import type TestEntitlement from "./TestEntitlement";
 import TypedCollection from "../util/TypedCollection";
-import { ApplicationCommandTypes, InteractionResponseTypes, type InteractionTypes } from "../Constants";
+import { ApplicationCommandTypes, InteractionResponseTypes, type InteractionTypes, type InteractionContextTypes } from "../Constants";
 import type {
  ApplicationCommandInteractionData,
  InteractionContent,
  ModalData,
  RawApplicationCommandInteraction,
  ApplicationCommandInteractionResolvedData,
  InitialInteractionContent,
- InteractionGuild
+ InteractionGuild,
+ AuthorizingIntegrationOwners
 } from "../types/interactions";
 import type Client from "../Client";
 import type { RawMember } from "../types/guilds";
@@ -37,10 +38,14 @@ import MessageInteractionResponse, { type FollowupMessageInteractionResponse, ty
 export default class CommandInteraction<T extends AnyInteractionChannel | Uncached = AnyInteractionChannel | Uncached, C extends ApplicationCommandTypes = ApplicationCommandTypes> extends Interaction {
  private _cachedChannel!: T extends AnyInteractionChannel ? T : undefined;
  private _cachedGuild?: T extends AnyTextableGuildChannel ? Guild : Guild | null;
- /** The permissions the bot has in the channel this interaction was sent from, if this interaction is sent from a guild. */
- appPermissions: T extends AnyTextableGuildChannel ? Permission : Permission | undefined;
+ /** The permissions the bot has in the channel this interaction was sent from. If in a dm/group dm, this will contain `ATTACH_FILES`, `EMBED_LINKS`, and `MENTION_EVERYONE`. In addition, `USE_EXTERNAL_EMOJIS` will be included for DMs with the app's bot user. */
+ appPermissions: Permission;
+ /** Details about the authorizing user or server for the installation(s) relevant to the interaction. See [Discord's docs](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object) for more information. */
+ authorizingIntegrationOwners: AuthorizingIntegrationOwners;
  /** The ID of the channel this interaction was sent from. */
  channelID: string;
+ /** The context this interaction was sent from. */
+ context?: InteractionContextTypes;
  /** The data associated with the interaction. */
  data: ApplicationCommandInteractionData<T, C>;
  /** The entitlements for the user that created this interaction, and the guild it was created in. */
@@ -62,8 +67,10 @@ export default class CommandInteraction<T extends AnyInteractionChannel | Uncach
  user: User;
  constructor(data: RawApplicationCommandInteraction, client: Client) {
  super(data, client);
- this.appPermissions = (data.app_permissions === undefined ? undefined : new Permission(data.app_permissions)) as T extends AnyTextableGuildChannel ? Permission : Permission | undefined;
+ this.appPermissions = new Permission(data.app_permissions ?? "0");
+ this.authorizingIntegrationOwners = data.authorizing_integration_owners;
  this.channelID = data.channel_id!;
+ this.context = data.context;
  const resolved: ApplicationCommandInteractionResolvedData = {
  attachments: new TypedCollection(Attachment, client),
  channels: new TypedCollection(InteractionResolvedChannel, client),
@@ -316,15 +323,17 @@ export default class CommandInteraction<T extends AnyInteractionChannel | Uncach
  override toJSON(): JSONCommandInteraction {
  return {
  ...super.toJSON(),
- appPermissions: this.appPermissions?.toJSON(),
- channelID: this.channelID,
- data: this.data,
- guildID: this.guildID ?? undefined,
- guildLocale: this.guildLocale,
- locale: this.locale,
- member: this.member?.toJSON(),
- type: this.type,
- user: this.user.toJSON()
+ appPermissions: this.appPermissions.toJSON(),
+ authorizingIntegrationOwners: this.authorizingIntegrationOwners,
+ channelID: this.channelID,
+ context: this.context,
+ data: this.data,
+ guildID: this.guildID ?? undefined,
+ guildLocale: this.guildLocale,
+ locale: this.locale,
+ member: this.member?.toJSON(),
+ type: this.type,
+ user: this.user.toJSON()
  };
  }
 }