feat: add support for user-installable apps

package.json

@@ -33,8 +33,8 @@
 		"prepack:esm": "rollup-type-bundler -d dist/esm -t .mts"
 	},
 	"dependencies": {
-		"@discordjs/builders": "^1.8.2",
-		"@sapphire/discord-utilities": "^3.4.0",
+		"@discordjs/builders": "^1.9.0",
+		"@sapphire/discord-utilities": "^3.4.1",
 		"@sapphire/discord.js-utilities": "^7.3.0",
 		"@sapphire/lexure": "^1.1.7",
 		"@sapphire/pieces": "^4.3.1",
@@ -60,7 +60,7 @@
 		"@vitest/coverage-v8": "^2.0.5",
 		"concurrently": "^8.2.2",
 		"cz-conventional-changelog": "^3.3.0",
-		"discord.js": "^14.15.3",
+		"discord.js": "^14.16.1",
 		"esbuild-plugin-file-path-extensions": "^2.1.2",
 		"esbuild-plugin-version-injector": "^1.2.1",
 		"eslint": "^8.57.0",

src/lib/utils/application-commands/compute-differences/contexts.ts

@@ -0,0 +1,54 @@
+import type { InteractionContextType } from 'discord.js';
+import type { CommandDifference } from './_shared';
+
+export function* checkInteractionContextTypes(
+	existingContexts?: InteractionContextType[],
+	newContexts?: InteractionContextType[]
+): Generator<CommandDifference> {
+	// 0. No existing contexts and now we have contexts
+	if (!existingContexts && newContexts?.length) {
+		yield {
+			key: 'contexts',
+			original: 'no contexts present',
+			expected: 'contexts present'
+		};
+	}
+	// 1. Existing contexts and now we have no contexts
+	else if (existingContexts?.length && !newContexts?.length) {
+		yield {
+			key: 'contexts',
+			original: 'contexts present',
+			expected: 'no contexts present'
+		};
+	}
+	// 2. Maybe changes in order or additions, log
+	else if (newContexts?.length) {
+		let index = 0;
+
+		for (const newContext of newContexts) {
+			const currentIndex = index++;
+
+			if (existingContexts![currentIndex] !== newContext) {
+				yield {
+					key: `contexts[${currentIndex}]`,
+					original: `contexts type ${existingContexts?.[currentIndex]}`,
+					expected: `contexts type ${newContext}`
+				};
+			}
+		}
+
+		if (index < existingContexts!.length) {
+			let type: InteractionContextType;
+
+			while ((type = existingContexts![index]) !== undefined) {
+				yield {
+					key: `contexts[${index}]`,
+					original: `context ${type} present`,
+					expected: `no context present`
+				};
+
+				index++;
+			}
+		}
+	}
+}

src/lib/utils/application-commands/compute-differences/integration_types.ts

@@ -0,0 +1,54 @@
+import type { ApplicationIntegrationType } from 'discord.js';
+import type { CommandDifference } from './_shared';
+
+export function* checkIntegrationTypes(
+	existingIntegrationTypes?: ApplicationIntegrationType[],
+	newIntegrationTypes?: ApplicationIntegrationType[]
+): Generator<CommandDifference> {
+	// 0. No existing integration types and now we have integration types
+	if (!existingIntegrationTypes?.length && newIntegrationTypes?.length) {
+		yield {
+			key: 'integrationTypes',
+			original: 'no integration types present',
+			expected: 'integration types present'
+		};
+	}
+	// 1. Existing integration types and now we have no integration types
+	else if (existingIntegrationTypes?.length && !newIntegrationTypes?.length) {
+		yield {
+			key: 'integrationTypes',
+			original: 'integration types present',
+			expected: 'no integration types present'
+		};
+	}
+	// 2. Maybe changes in order or additions, log
+	else if (newIntegrationTypes?.length) {
+		let index = 0;
+
+		for (const newIntegrationType of newIntegrationTypes) {
+			const currentIndex = index++;
+
+			if (existingIntegrationTypes![currentIndex] !== newIntegrationType) {
+				yield {
+					key: `integrationTypes[${currentIndex}]`,
+					original: `integration type ${existingIntegrationTypes?.[currentIndex]}`,
+					expected: `integration type ${newIntegrationType}`
+				};
+			}
+		}
+
+		if (index < existingIntegrationTypes!.length) {
+			let type: ApplicationIntegrationType;
+
+			while ((type = existingIntegrationTypes![index]) !== undefined) {
+				yield {
+					key: `integrationTypes[${index}]`,
+					original: `integration type ${type} present`,
+					expected: 'no integration type present'
+				};
+
+				index++;
+			}
+		}
+	}
+}

src/lib/utils/application-commands/computeDifferences.ts

@@ -12,6 +12,8 @@
 import { checkLocalizations } from './compute-differences/localizations';
 import { checkName } from './compute-differences/name';
 import { checkOptions } from './compute-differences/options';
+import { checkIntegrationTypes } from './compute-differences/integration_types';
+import { checkInteractionContextTypes } from './compute-differences/contexts';
 
 /**
  * @returns `true` if there are differences, `false` otherwise
@@ -44,7 +46,7 @@
 
 			// Check dmPermission only for non-guild commands
 			if (!guildCommand) {
 				yield* checkDMPermission(existingCommand.dm_permission, casted.dm_permission);
 			}
 
 			// Check defaultMemberPermissions
@@ -61,6 +63,12 @@
 				originalLocalizedDescriptions: originalLocalizedNames,
 				expectedLocalizedDescriptions: expectedLocalizedNames
 			});
+
+			// Check integration types
+			yield* checkIntegrationTypes(existingCommand.integration_types, casted.integration_types);
+
+			// Check contexts
+			yield* checkInteractionContextTypes(existingCommand.contexts, casted.contexts);
 		}
 
 		return;
@@ -85,7 +93,7 @@
 
 	// Check dmPermission
 	if (!guildCommand) {
 		yield* checkDMPermission(existingCommand.dm_permission, casted.dm_permission);
 	}
 
 	// Check defaultMemberPermissions
@@ -106,5 +114,11 @@
 		expectedLocalizedDescriptions
 	});
 
+	// Check integration types
+	yield* checkIntegrationTypes(existingCommand.integration_types, casted.integration_types);
+
+	// Check contexts
+	yield* checkInteractionContextTypes(existingCommand.contexts, casted.contexts);
+
 	yield* checkOptions(existingCommand.options, casted.options);
 }

src/lib/utils/application-commands/normalizeInputs.ts

@@ -15,7 +15,9 @@
 import {
 	ApplicationCommand,
 	PermissionsBitField,
+	type ApplicationIntegrationType,
 	type ChatInputApplicationCommandData,
+	type InteractionContextType,
 	type MessageApplicationCommandData,
 	type UserApplicationCommandData
 } from 'discord.js';
@@ -31,7 +33,7 @@
 }
 
 function addDefaultsToChatInputJSON(data: RESTPostAPIChatInputApplicationCommandsJSONBody): RESTPostAPIChatInputApplicationCommandsJSONBody {
 	data.dm_permission ??= true;
 	data.type ??= ApplicationCommandType.ChatInput;
 	data.default_member_permissions ??= null;
 
@@ -39,7 +41,7 @@
 }
 
 function addDefaultsToContextMenuJSON(data: RESTPostAPIContextMenuApplicationCommandsJSONBody): RESTPostAPIContextMenuApplicationCommandsJSONBody {
 	data.dm_permission ??= true;
 	data.default_member_permissions ??= null;
 
 	return data;
@@ -71,7 +73,9 @@
 		description_localizations: command.descriptionLocalizations,
 		type: ApplicationCommandType.ChatInput,
 		dm_permission: command.dmPermission,
-		nsfw: command.nsfw
+		nsfw: command.nsfw,
+		integration_types: command.integrationTypes as ApplicationIntegrationType[] | undefined,
+		contexts: command.contexts as InteractionContextType[] | undefined
 	};
 
 	if (typeof command.defaultMemberPermissions !== 'undefined') {
@@ -108,7 +112,9 @@
 		name_localizations: command.nameLocalizations,
 		type: command.type,
 		dm_permission: command.dmPermission,
-		nsfw: command.nsfw
+		nsfw: command.nsfw,
+		integration_types: command.integrationTypes as ApplicationIntegrationType[] | undefined,
+		contexts: command.contexts as InteractionContextType[] | undefined
 	};
 
 	if (typeof command.defaultMemberPermissions !== 'undefined') {
@@ -123,9 +129,11 @@
 	const returnData = {
 		name: command.name,
 		name_localizations: command.nameLocalizations,
 		dm_permission: command.dmPermission,
 		nsfw: command.nsfw,
-		default_member_permissions: command.defaultMemberPermissions?.bitfield.toString() ?? null
+		default_member_permissions: command.defaultMemberPermissions?.bitfield.toString() ?? null,
+		integration_types: command.integrationTypes,
+		contexts: command.contexts
 	} as RESTPostAPIApplicationCommandsJSONBody;
 
 	if (command.type === ApplicationCommandType.ChatInput) {

src/optional-listeners/message-command-listeners/CoreMessageCommandTyping.ts

@@ -1,5 +1,5 @@
 import { isStageChannel } from '@sapphire/discord.js-utilities';
-import type { Message } from 'discord.js';
+import { ChannelType, type Message } from 'discord.js';
 import { Listener } from '../../lib/structures/Listener';
 import type { MessageCommand } from '../../lib/types/CommandTypes';
 import { Events, type MessageCommandRunPayload } from '../../lib/types/Events';
@@ -15,6 +15,10 @@ export class CoreListener extends Listener<typeof Events.MessageCommandRun> {
 			return;
 		}
 
+		if (message.channel.type === ChannelType.GroupDM) {
+			return;
+		}
+
 		try {
 			await message.channel.sendTyping();
 		} catch (error) {

src/optional-listeners/message-command-listeners/CorePreMessageParser.ts

@@ -1,5 +1,5 @@
 import { isDMChannel } from '@sapphire/discord.js-utilities';
-import { PermissionFlagsBits, PermissionsBitField, type Message } from 'discord.js';
+import { ChannelType, PermissionFlagsBits, PermissionsBitField, type Message } from 'discord.js';
 import { Listener } from '../../lib/structures/Listener';
 import { Events } from '../../lib/types/Events';
 
@@ -40,6 +40,7 @@ export class CoreListener extends Listener<typeof Events.PreMessageParsed> {
 	}
 
 	private async canRunInChannel(message: Message): Promise<boolean> {
+		if (message.channel.type === ChannelType.GroupDM) return false;
 		if (isDMChannel(message.channel)) return true;
 
 		const me = await message.guild?.members.fetchMe();

src/preconditions/ClientPermissions.ts

@@ -154,6 +154,7 @@ export class CorePrecondition extends AllFlowsPrecondition {
 		Stream: 'Stream',
 		UseApplicationCommands: 'Use Application Commands',
 		UseEmbeddedActivities: 'Start Activities',
+		UseExternalApps: 'Use External Apps',
 		UseExternalEmojis: 'Use External Emojis',
 		UseExternalSounds: 'Use External Sounds',
 		UseExternalStickers: 'Use External Stickers',