fix(reload): adapt to new docs command approach

* original idea of workflow action is not feasible (in-process version cache required by docs cmd defaulting)
* command needs to reload versions and re-deploy global commands (docs
  cmd rebuilt based on newly fetched versions)
* move command building process into a function to make it available externally
* abstract the list of global commands to be available externally
* re-deploy commands and refresh version cache when command is used

resolves #232

Author: almostSouji

src/deployFunctions/deployGlobal.ts

@@ -9,13 +9,14 @@ import { TagCommand } from '../interactions/tag.js';
 import { TestTagCommand } from '../interactions/testtag.js';
 import { deploy } from './deploy.js';
 
-void deploy([
+export const staticGlobalCommands = [
 	DiscordDocsCommand,
-	DocsCommand,
 	GuideCommand,
 	MdnCommand,
 	NodeCommand,
 	TagCommand,
 	TestTagCommand,
 	DTypesCommand,
-]);
+];
+
+void deploy([...staticGlobalCommands, DocsCommand]);

src/handling/handleApplicationCommand.ts

@@ -4,6 +4,8 @@ import type { Collection } from '@discordjs/collection';
 import type { APIApplicationCommandInteraction } from 'discord-api-types/v10';
 import { ApplicationCommandType } from 'discord-api-types/v10';
 import type { Response } from 'polka';
+import { deploy } from '../deployFunctions/deploy.js';
+import { staticGlobalCommands } from '../deployFunctions/deployGlobal.js';
 import { algoliaResponse } from '../functions/algoliaResponse.js';
 import { resolveOptionsToDocsAutoComplete } from '../functions/autocomplete/docsAutoComplete.js';
 import { djsDocs } from '../functions/docs.js';
@@ -14,6 +16,7 @@ import { showTag, reloadTags } from '../functions/tag.js';
 import { testTag } from '../functions/testtag.js';
 import type { DiscordDocsCommand } from '../interactions/discorddocs.js';
 import type { DTypesCommand } from '../interactions/discordtypes.js';
+import { buildDocsCommand, DocsCommand } from '../interactions/docs.js';
 import type { GuideCommand } from '../interactions/guide.js';
 import type { MdnCommand } from '../interactions/mdn.js';
 import type { NodeCommand } from '../interactions/node.js';
@@ -143,8 +146,13 @@ export async function handleApplicationCommand(
 			}
 
 			case 'reloadversions': {
-				await reloadDjsVersions();
-				prepareResponse(res, `Reloaded versions for all ${inlineCode('@discordjs')} packages.`, { ephemeral: true });
+				const versions = await reloadDjsVersions();
+				const updatedDocsCommand = await buildDocsCommand(versions);
+				await deploy([...staticGlobalCommands, updatedDocsCommand]);
+
+				prepareResponse(res, `Reloaded versions for all supported packages (dependency of discord.js).`, {
+					ephemeral: true,
+				});
 				break;
 			}
 		}

src/interactions/docs.ts

@@ -1,53 +1,53 @@
 import { ApplicationCommandOptionType } from 'discord-api-types/v10';
-import { reloadDjsVersions } from '../util/djsdocs.js';
+import { type DjsVersions, reloadDjsVersions } from '../util/djsdocs.js';
 
 const versions = await reloadDjsVersions();
-if (!versions.packages.length) {
-	throw new Error('Error while loading versions');
+export async function buildDocsCommand(versions: DjsVersions) {
+	return {
+		name: 'docs',
+		description: 'Display discord.js documentation',
+		options: [
+			{
+				type: ApplicationCommandOptionType.String,
+				name: 'query',
+				description: 'Phrase to search for',
+				required: true,
+				autocomplete: true,
+			},
+			{
+				type: ApplicationCommandOptionType.Boolean,
+				name: 'hide',
+				description: 'Hide command output (default: False)',
+				required: false,
+			},
+			{
+				type: ApplicationCommandOptionType.String,
+				name: 'version',
+				description: 'Version of discord.js to use (default: Latest release)',
+				choices: versions.versions
+					.get('discord.js')
+					?.slice(0, 25)
+					.map((version) => {
+						return {
+							name: version,
+							value: version,
+						};
+					}) ?? [
+					{
+						name: 'main',
+						value: 'main',
+					},
+				],
+				required: false,
+			},
+			{
+				type: ApplicationCommandOptionType.User,
+				name: 'mention',
+				description: 'User to mention',
+				required: false,
+			},
+		],
+	} as const;
 }
 
-export const DocsCommand = {
-	name: 'docs',
-	description: 'Display discord.js documentation',
-	options: [
-		{
-			type: ApplicationCommandOptionType.String,
-			name: 'query',
-			description: 'Phrase to search for',
-			required: true,
-			autocomplete: true,
-		},
-		{
-			type: ApplicationCommandOptionType.Boolean,
-			name: 'hide',
-			description: 'Hide command output (default: False)',
-			required: false,
-		},
-		{
-			type: ApplicationCommandOptionType.String,
-			name: 'version',
-			description: 'Version of discord.js to use (default: Latest release)',
-			choices: versions.versions
-				.get('discord.js')
-				?.slice(0, 25)
-				.map((version) => {
-					return {
-						name: version,
-						value: version,
-					};
-				}) ?? [
-				{
-					name: 'main',
-					value: 'main',
-				},
-			],
-			required: false,
-		},
-		{
-			type: ApplicationCommandOptionType.User,
-			name: 'mention',
-			description: 'User to mention',
-			required: false,
-		},
-	],
-} as const;
+export const DocsCommand = await buildDocsCommand(versions);