feat(interactions): add launchActivity method

packages/core/__tests__/types.test.ts

@@ -12,6 +12,7 @@ const api = new API(rest);
 const SNOWFLAKE = '123456789012345678' as const;
 const TOKEN = 'token' as const;
 const MODAL_COMPONENTS: APIActionRowComponent<APIModalActionRowComponent>[] = [] as const;
+const boolValue = true as boolean;
 
 describe('Interaction with_response overloads.', () => {
 	test('Replying returns RESTPostAPIInteractionCallbackWithResponseResult.', () =>
@@ -67,4 +68,19 @@ describe('Interaction with_response overloads.', () => {
 		assertType<Promise<undefined>>(
 			api.interactions.createModal(SNOWFLAKE, TOKEN, { title: '', custom_id: '', components: MODAL_COMPONENTS }),
 		));
+
+	test('Launch activity returns undefined.', () => {
+		assertType<Promise<undefined>>(api.interactions.launchActivity(SNOWFLAKE, TOKEN, { with_response: false }));
+		assertType<Promise<undefined>>(api.interactions.launchActivity(SNOWFLAKE, TOKEN));
+	});
+
+	test('Launch activity returns RESTPostAPIInteractionCallbackWithResponseResult.', () =>
+		assertType<Promise<RESTPostAPIInteractionCallbackWithResponseResult>>(
+			api.interactions.launchActivity(SNOWFLAKE, TOKEN, { with_response: true }),
+		));
+
+	test('Launch activity returns either RESTPostAPIInteractionCallbackWithResponseResult or undefined.', () =>
+		assertType<Promise<RESTPostAPIInteractionCallbackWithResponseResult | undefined>>(
+			api.interactions.launchActivity(SNOWFLAKE, TOKEN, { with_response: boolValue }),
+		));
 });

packages/core/src/api/interactions.ts

@@ -429,4 +429,70 @@ export class InteractionsAPI {
 
 		return with_response ? response : undefined;
 	}
+
+	/**
+	 * Launches an activity and returns an interaction callback object
+	 *
+	 * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
+	 * @param interactionId - The id of the interaction
+	 * @param interactionToken - The token of the interaction
+	 * @param body - The callback data for launching the activity
+	 * @param options - The options for launching the activity
+	 */
+	public async launchActivity(
+		interactionId: Snowflake,
+		interactionToken: string,
+		body: RESTPostAPIInteractionCallbackQuery & { with_response: true },
+		options?: Pick<RequestData, 'signal'>,
+	): Promise<RESTPostAPIInteractionCallbackWithResponseResult>;
+
+	/**
+	 * Launches an activity
+	 *
+	 * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
+	 * @param interactionId - The id of the interaction
+	 * @param interactionToken - The token of the interaction
+	 * @param body - The callback data for launching the activity
+	 * @param options - The options for launching the activity
+	 */
+	public async launchActivity(
+		interactionId: Snowflake,
+		interactionToken: string,
+		body?: RESTPostAPIInteractionCallbackQuery & { with_response?: false },
+		options?: Pick<RequestData, 'signal'>,
+	): Promise<undefined>;
+
+	/**
+	 * Launches an activity
+	 *
+	 * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#create-interaction-response}
+	 * @param interactionId - The id of the interaction
+	 * @param interactionToken - The token of the interaction
+	 * @param body - The callback data for launching the activity
+	 * @param options - The options for launching the activity
+	 */
+	public async launchActivity(
+		interactionId: Snowflake,
+		interactionToken: string,
+		body?: RESTPostAPIInteractionCallbackQuery,
+		options?: Pick<RequestData, 'signal'>,
+	): Promise<RESTPostAPIInteractionCallbackWithResponseResult | undefined>;
+
+	public async launchActivity(
+		interactionId: Snowflake,
+		interactionToken: string,
+		{ with_response }: RESTPostAPIInteractionCallbackQuery = {},
+		{ signal }: Pick<RequestData, 'signal'> = {},
+	) {
+		const response = await this.rest.post(Routes.interactionCallback(interactionId, interactionToken), {
+			query: makeURLSearchParams({ with_response }),
+			auth: false,
+			body: {
+				type: InteractionResponseType.LaunchActivity,
+			},
+			signal,
+		});
+
+		return with_response ? response : undefined;
+	}
 }