feat(Args): add guild argument (#626)

* feat(Args): add guild argument

* fix: rename guild argument

* fix: some fixes
Co-authored-by: Jeroen Claassens <[email protected]>

src/arguments/CoreGuild.ts

@@ -0,0 +1,22 @@
+import type { PieceContext } from '@sapphire/pieces';
+import type { Guild } from 'discord.js';
+import { resolveGuild } from '../lib/resolvers/guild';
+import { Argument } from '../lib/structures/Argument';
+
+export class CoreArgument extends Argument<Guild> {
+	public constructor(context: PieceContext) {
+		super(context, { name: 'guild' });
+	}
+
+	public async run(parameter: string, context: Argument.Context): Argument.AsyncResult<Guild> {
+		const resolved = await resolveGuild(parameter);
+		return resolved.mapErrInto((identifier) =>
+			this.error({
+				parameter,
+				identifier,
+				message: 'The given argument did not resolve to a Discord guild.',
+				context
+			})
+		);
+	}
+}

src/lib/errors/Identifiers.ts

@@ -12,6 +12,7 @@ export enum Identifiers {
 	ArgumentFloatError = 'floatError',
 	ArgumentFloatTooLarge = 'floatTooLarge',
 	ArgumentFloatTooSmall = 'floatTooSmall',
+	ArgumentGuildError = 'guildError',
 	ArgumentGuildCategoryChannelError = 'categoryChannelError',
 	ArgumentGuildChannelError = 'guildChannelError',
 	ArgumentGuildChannelMissingGuildError = 'guildChannelMissingGuildError',

src/lib/resolvers/guild.ts

@@ -0,0 +1,16 @@
+import { SnowflakeRegex } from '@sapphire/discord-utilities';
+import { container } from '@sapphire/pieces';
+import { Result } from '@sapphire/result';
+import type { Guild } from 'discord.js';
+import { Identifiers } from '../errors/Identifiers';
+
+export async function resolveGuild(parameter: string): Promise<Result<Guild, Identifiers.ArgumentGuildError>> {
+	const guildId = SnowflakeRegex.exec(parameter)?.groups?.id;
+	const guild = guildId ? await container.client.guilds.fetch(guildId).catch(() => null) : null;
+
+	if (guild) {
+		return Result.ok(guild);
+	}
+
+	return Result.err(Identifiers.ArgumentGuildError);
+}

src/lib/resolvers/index.ts

@@ -5,6 +5,7 @@ export * from './dmChannel';
 export { resolveEmoji } from './emoji';
 export * from './enum';
 export * from './float';
+export * from './guild';
 export * from './guildCategoryChannel';
 export * from './guildChannel';
 export * from './guildNewsChannel';