@wolfstar/create-http-framework 2.1.4 → 2.2.0-next-20260831123711

package/template/base/src/lib/setup/all.ts.hbs

@@ -0,0 +1,8 @@
+import { setup as envRun } from '@wolfstar/env-utilities';
+/* oxlint-disable import/first -- side-effect setup modules must run after env load preparation */
+import './logger.js';
+
+export function setup() {
+	// From dist/lib/setup → .env at the project root
+	envRun(new URL('../../../.env', import.meta.url));
+}

package/template/base/src/lib/setup/logger.js.hbs

@@ -0,0 +1,4 @@
+import { container } from '@wolfstar/http-framework';
+import { Logger } from '@wolfstar/logger';
+
+container.logger = new Logger();

package/template/base/src/lib/setup/logger.ts.hbs

@@ -0,0 +1,10 @@
+import { container } from '@wolfstar/http-framework';
+import { Logger } from '@wolfstar/logger';
+
+container.logger = new Logger();
+
+declare module '@sapphire/pieces' {
+	interface Container {
+		logger: Logger;
+	}
+}

package/template/base/src/lib/types/augments.ts.hbs

@@ -0,0 +1,13 @@
+import type { IntegerString } from '@wolfstar/env-utilities';
+
+declare module '@wolfstar/env-utilities' {
+	interface Env {
+		DISCORD_CLIENT_ID: string;
+		DISCORD_TOKEN: string;
+		DISCORD_PUBLIC_KEY: string;
+
+		HTTP_ADDRESS: string;
+		HTTP_PORT: IntegerString;
+		HTTP_POST_PATH: string;
+	}
+}

package/template/base/src/main.js.hbs

@@ -0,0 +1,31 @@
+import { setup } from './lib/setup/all.js';
+import { envParseInteger, envParseString } from '@wolfstar/env-utilities';
+import { Client, container } from '@wolfstar/http-framework';
+import { createBanner } from '@wolfstar/start-banner';
+import { morning } from 'gradient-string';
+
+await setup();
+
+const client = new Client();
+await client.load();
+
+const address = envParseString('HTTP_ADDRESS', '0.0.0.0');
+const port = envParseInteger('HTTP_PORT', {{port}});
+await client.listen({ address, port });
+
+console.log(
+	morning.multiline(
+		createBanner({
+			logo: ['   *  .  *', ' .  ★  . ', '*  .  *  .'],
+			name: ['{{name}}'],
+			extra: [
+				'',
+				`Loaded: ${container.stores.get('commands').size} commands`,
+				`      : ${container.stores.get('interaction-handlers').size} interaction handlers`,
+				`Listening: ${address}:${port}`
+			]
+		})
+	)
+);
+
+container.logger.info('Ready');

package/template/base/src/main.ts.hbs

@@ -0,0 +1,31 @@
+import { setup } from './lib/setup/all.js';
+import { envParseInteger, envParseString } from '@wolfstar/env-utilities';
+import { Client, container } from '@wolfstar/http-framework';
+import { createBanner } from '@wolfstar/start-banner';
+import { morning } from 'gradient-string';
+
+await setup();
+
+const client = new Client();
+await client.load();
+
+const address = envParseString('HTTP_ADDRESS', '0.0.0.0');
+const port = envParseInteger('HTTP_PORT', {{port}});
+await client.listen({ address, port });
+
+console.log(
+	morning.multiline(
+		createBanner({
+			logo: [String.raw`   *  .  *`, String.raw` .  ★  . `, String.raw`*  .  *  .`],
+			name: ['{{name}}'],
+			extra: [
+				'',
+				`Loaded: ${container.stores.get('commands').size} commands`,
+				`      : ${container.stores.get('interaction-handlers').size} interaction handlers`,
+				`Listening: ${address}:${port}`
+			]
+		})
+	)
+);
+
+container.logger.info('Ready');

package/template/features/i18n/src/commands/ping.js.hbs

@@ -0,0 +1,18 @@
+import { Command } from '@wolfstar/http-framework';
+import { applyLocalizedBuilder, getSupportedUserLanguageT } from '@wolfstar/plugin-i18next';
+import { ApplicationIntegrationType, InteractionContextType, MessageFlags } from 'discord-api-types/v10';
+
+export class PingCommand extends Command {
+	registerApplicationCommands(registry) {
+		registry.registerChatInputCommand((builder) =>
+			applyLocalizedBuilder(builder, 'commands/ping:name', 'commands/ping:description')
+				.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+				.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+		);
+	}
+
+	chatInputRun(interaction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/ping:reply'), flags: MessageFlags.Ephemeral });
+	}
+}

package/template/features/i18n/src/commands/ping.ts.hbs

@@ -0,0 +1,15 @@
+import { Command, RegisterCommand } from '@wolfstar/http-framework';
+import { applyLocalizedBuilder, getSupportedUserLanguageT } from '@wolfstar/plugin-i18next';
+import { ApplicationIntegrationType, InteractionContextType, MessageFlags } from 'discord-api-types/v10';
+
+@RegisterCommand((builder) =>
+	applyLocalizedBuilder(builder, 'commands/ping:name', 'commands/ping:description') //
+		.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+		.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+)
+export class PingCommand extends Command {
+	public override chatInputRun(interaction: Command.ChatInputInteraction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/ping:reply'), flags: MessageFlags.Ephemeral });
+	}
+}

package/template/features/i18n/src/locales/en-US/commands/ping.json

@@ -0,0 +1,5 @@
+{
+	"name": "ping",
+	"description": "Replies with pong!",
+	"reply": "Pong!"
+}

package/template/features/i18n/src/main.js.hbs

@@ -0,0 +1,37 @@
+import '@wolfstar/plugin-i18next/register';
+import { setup } from './lib/setup/all.js';
+import { envParseInteger, envParseString } from '@wolfstar/env-utilities';
+import { Client, container } from '@wolfstar/http-framework';
+import { createBanner } from '@wolfstar/start-banner';
+import { morning } from 'gradient-string';
+
+await setup();
+
+const client = new Client({
+	i18n: {
+		defaultLanguageDirectory: new URL('locales', import.meta.url).pathname,
+		defaultName: 'en-US'
+	}
+});
+await client.load();
+
+const address = envParseString('HTTP_ADDRESS', '0.0.0.0');
+const port = envParseInteger('HTTP_PORT', {{port}});
+await client.listen({ address, port });
+
+console.log(
+	morning.multiline(
+		createBanner({
+			logo: ['   *  .  *', ' .  ★  . ', '*  .  *  .'],
+			name: ['{{name}}'],
+			extra: [
+				'',
+				`Loaded: ${container.stores.get('commands').size} commands`,
+				`      : ${container.stores.get('interaction-handlers').size} interaction handlers`,
+				`Listening: ${address}:${port}`
+			]
+		})
+	)
+);
+
+container.logger.info('Ready');

package/template/features/i18n/src/main.ts.hbs

@@ -0,0 +1,37 @@
+import '@wolfstar/plugin-i18next/register';
+import { setup } from './lib/setup/all.js';
+import { envParseInteger, envParseString } from '@wolfstar/env-utilities';
+import { Client, container } from '@wolfstar/http-framework';
+import { createBanner } from '@wolfstar/start-banner';
+import { morning } from 'gradient-string';
+
+await setup();
+
+const client = new Client({
+	i18n: {
+		defaultLanguageDirectory: new URL('locales', import.meta.url).pathname,
+		defaultName: 'en-US'
+	}
+});
+await client.load();
+
+const address = envParseString('HTTP_ADDRESS', '0.0.0.0');
+const port = envParseInteger('HTTP_PORT', {{port}});
+await client.listen({ address, port });
+
+console.log(
+	morning.multiline(
+		createBanner({
+			logo: [String.raw`   *  .  *`, String.raw` .  ★  . `, String.raw`*  .  *  .`],
+			name: ['{{name}}'],
+			extra: [
+				'',
+				`Loaded: ${container.stores.get('commands').size} commands`,
+				`      : ${container.stores.get('interaction-handlers').size} interaction handlers`,
+				`Listening: ${address}:${port}`
+			]
+		})
+	)
+);
+
+container.logger.info('Ready');

package/template/features/subcommands/src/commands/math.js.hbs

@@ -0,0 +1,41 @@
+import { Command } from '@wolfstar/http-framework';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+export class MathCommand extends Command {
+	registerApplicationCommands(registry) {
+		registry
+			.registerChatInputCommand((builder) =>
+				builder
+					.setName('math')
+					.setDescription('Perform basic arithmetic')
+					.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+					.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+			)
+			.registerSubcommand(
+				(builder) =>
+					builder
+						.setName('add')
+						.setDescription('Add two numbers')
+						.addIntegerOption((option) => option.setName('left').setDescription('The left operand').setRequired(true))
+						.addIntegerOption((option) => option.setName('right').setDescription('The right operand').setRequired(true)),
+				'add'
+			)
+			.registerSubcommand(
+				(builder) =>
+					builder
+						.setName('subtract')
+						.setDescription('Subtract two numbers')
+						.addIntegerOption((option) => option.setName('left').setDescription('The left operand').setRequired(true))
+						.addIntegerOption((option) => option.setName('right').setDescription('The right operand').setRequired(true)),
+				'subtract'
+			);
+	}
+
+	add(interaction, { left, right }) {
+		return interaction.reply({ content: `${left} + ${right} = ${left + right}` });
+	}
+
+	subtract(interaction, { left, right }) {
+		return interaction.reply({ content: `${left} - ${right} = ${left - right}` });
+	}
+}

package/template/features/subcommands/src/commands/math.ts.hbs

@@ -0,0 +1,38 @@
+import { Command, RegisterCommand, RegisterSubcommand } from '@wolfstar/http-framework';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+@RegisterCommand((builder) =>
+	builder //
+		.setName('math')
+		.setDescription('Perform basic arithmetic')
+		.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+		.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+)
+export class MathCommand extends Command {
+	@RegisterSubcommand((builder) =>
+		builder //
+			.setName('add')
+			.setDescription('Add two numbers')
+			.addIntegerOption((option) => option.setName('left').setDescription('The left operand').setRequired(true))
+			.addIntegerOption((option) => option.setName('right').setDescription('The right operand').setRequired(true))
+	)
+	public add(interaction: Command.ChatInputInteraction, { left, right }: MathOptions) {
+		return interaction.reply({ content: `${left} + ${right} = ${left + right}` });
+	}
+
+	@RegisterSubcommand((builder) =>
+		builder //
+			.setName('subtract')
+			.setDescription('Subtract two numbers')
+			.addIntegerOption((option) => option.setName('left').setDescription('The left operand').setRequired(true))
+			.addIntegerOption((option) => option.setName('right').setDescription('The right operand').setRequired(true))
+	)
+	public subtract(interaction: Command.ChatInputInteraction, { left, right }: MathOptions) {
+		return interaction.reply({ content: `${left} - ${right} = ${left - right}` });
+	}
+}
+
+interface MathOptions {
+	left: number;
+	right: number;
+}

package/template/features/subcommands-advanced/src/commands/settings.js.hbs

@@ -0,0 +1,53 @@
+import { Command } from '@wolfstar/http-framework';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+export class SettingsCommand extends Command {
+	registerApplicationCommands(registry) {
+		registry
+			.registerChatInputCommand((builder) =>
+				builder
+					.setName('settings')
+					.setDescription('Manage your settings')
+					.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+					.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+			)
+			.registerSubcommandGroup((builder) => builder.setName('profile').setDescription('Manage your profile settings'))
+			.registerSubcommand((builder) => builder.setName('get').setDescription('View your current profile name'), 'profileGet', 'profile')
+			.registerSubcommand(
+				(builder) =>
+					builder
+						.setName('set')
+						.setDescription('Set your profile name')
+						.addStringOption((option) => option.setName('name').setDescription('The new profile name').setRequired(true)),
+				'profileSet',
+				'profile'
+			)
+			.registerSubcommandGroup((builder) => builder.setName('notifications').setDescription('Manage your notification settings'))
+			.registerSubcommand(
+				(builder) => builder.setName('enable').setDescription('Enable notifications'),
+				'notificationsEnable',
+				'notifications'
+			)
+			.registerSubcommand(
+				(builder) => builder.setName('disable').setDescription('Disable notifications'),
+				'notificationsDisable',
+				'notifications'
+			);
+	}
+
+	profileGet(interaction) {
+		return interaction.reply({ content: 'Your profile name is not set yet.' });
+	}
+
+	profileSet(interaction, { name }) {
+		return interaction.reply({ content: `Your profile name is now "${name}".` });
+	}
+
+	notificationsEnable(interaction) {
+		return interaction.reply({ content: 'Notifications enabled.' });
+	}
+
+	notificationsDisable(interaction) {
+		return interaction.reply({ content: 'Notifications disabled.' });
+	}
+}

package/template/features/subcommands-advanced/src/commands/settings.ts.hbs

@@ -0,0 +1,70 @@
+import { Command, RegisterCommand, RegisterSubcommand, RegisterSubcommandGroup } from '@wolfstar/http-framework';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+@RegisterCommand((builder) =>
+	builder //
+		.setName('settings')
+		.setDescription('Manage your settings')
+		.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+		.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+)
+export class SettingsCommand extends Command {
+	@RegisterSubcommandGroup((builder) =>
+		builder //
+			.setName('profile')
+			.setDescription('Manage your profile settings')
+	)
+	@RegisterSubcommand(
+		(builder) =>
+			builder //
+				.setName('get')
+				.setDescription('View your current profile name'),
+		'profile'
+	)
+	public profileGet(interaction: Command.ChatInputInteraction) {
+		return interaction.reply({ content: 'Your profile name is not set yet.' });
+	}
+
+	@RegisterSubcommand(
+		(builder) =>
+			builder //
+				.setName('set')
+				.setDescription('Set your profile name')
+				.addStringOption((option) => option.setName('name').setDescription('The new profile name').setRequired(true)),
+		'profile'
+	)
+	public profileSet(interaction: Command.ChatInputInteraction, { name }: SettingsProfileSetOptions) {
+		return interaction.reply({ content: `Your profile name is now "${name}".` });
+	}
+
+	@RegisterSubcommandGroup((builder) =>
+		builder //
+			.setName('notifications')
+			.setDescription('Manage your notification settings')
+	)
+	@RegisterSubcommand(
+		(builder) =>
+			builder //
+				.setName('enable')
+				.setDescription('Enable notifications'),
+		'notifications'
+	)
+	public notificationsEnable(interaction: Command.ChatInputInteraction) {
+		return interaction.reply({ content: 'Notifications enabled.' });
+	}
+
+	@RegisterSubcommand(
+		(builder) =>
+			builder //
+				.setName('disable')
+				.setDescription('Disable notifications'),
+		'notifications'
+	)
+	public notificationsDisable(interaction: Command.ChatInputInteraction) {
+		return interaction.reply({ content: 'Notifications disabled.' });
+	}
+}
+
+interface SettingsProfileSetOptions {
+	name: string;
+}

package/template/features/subcommands-advanced-i18n/src/commands/settings.js.hbs

@@ -0,0 +1,78 @@
+import { Command } from '@wolfstar/http-framework';
+import { applyLocalizedBuilder, getSupportedUserLanguageT } from '@wolfstar/plugin-i18next';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+export class SettingsCommand extends Command {
+	registerApplicationCommands(registry) {
+		registry
+			.registerChatInputCommand((builder) =>
+				applyLocalizedBuilder(builder, 'commands/settings:name', 'commands/settings:description')
+					.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+					.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+			)
+			.registerSubcommandGroup((builder) =>
+				applyLocalizedBuilder(builder, 'commands/settings:profileName', 'commands/settings:profileDescription')
+			)
+			.registerSubcommand(
+				(builder) => applyLocalizedBuilder(builder, 'commands/settings:profileGetName', 'commands/settings:profileGetDescription'),
+				'profileGet',
+				'profile'
+			)
+			.registerSubcommand(
+				(builder) =>
+					applyLocalizedBuilder(builder, 'commands/settings:profileSetName', 'commands/settings:profileSetDescription').addStringOption(
+						(option) =>
+							applyLocalizedBuilder(
+								option,
+								'commands/settings:optionsNameName',
+								'commands/settings:optionsNameDescription'
+							).setRequired(true)
+					),
+				'profileSet',
+				'profile'
+			)
+			.registerSubcommandGroup((builder) =>
+				applyLocalizedBuilder(builder, 'commands/settings:notificationsName', 'commands/settings:notificationsDescription')
+			)
+			.registerSubcommand(
+				(builder) =>
+					applyLocalizedBuilder(
+						builder,
+						'commands/settings:notificationsEnableName',
+						'commands/settings:notificationsEnableDescription'
+					),
+				'notificationsEnable',
+				'notifications'
+			)
+			.registerSubcommand(
+				(builder) =>
+					applyLocalizedBuilder(
+						builder,
+						'commands/settings:notificationsDisableName',
+						'commands/settings:notificationsDisableDescription'
+					),
+				'notificationsDisable',
+				'notifications'
+			);
+	}
+
+	profileGet(interaction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:profileGetResult') });
+	}
+
+	profileSet(interaction, { name }) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:profileSetResult', { name }) });
+	}
+
+	notificationsEnable(interaction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:notificationsEnableResult') });
+	}
+
+	notificationsDisable(interaction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:notificationsDisableResult') });
+	}
+}

package/template/features/subcommands-advanced-i18n/src/commands/settings.ts.hbs

@@ -0,0 +1,62 @@
+import { Command, RegisterCommand, RegisterSubcommand, RegisterSubcommandGroup } from '@wolfstar/http-framework';
+import { applyLocalizedBuilder, getSupportedUserLanguageT } from '@wolfstar/plugin-i18next';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+@RegisterCommand((builder) =>
+	applyLocalizedBuilder(builder, 'commands/settings:name', 'commands/settings:description') //
+		.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+		.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+)
+export class SettingsCommand extends Command {
+	@RegisterSubcommandGroup((builder) =>
+		applyLocalizedBuilder(builder, 'commands/settings:profileName', 'commands/settings:profileDescription')
+	)
+	@RegisterSubcommand(
+		(builder) => applyLocalizedBuilder(builder, 'commands/settings:profileGetName', 'commands/settings:profileGetDescription'),
+		'profile'
+	)
+	public profileGet(interaction: Command.ChatInputInteraction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:profileGetResult') });
+	}
+
+	@RegisterSubcommand(
+		(builder) =>
+			applyLocalizedBuilder(builder, 'commands/settings:profileSetName', 'commands/settings:profileSetDescription').addStringOption(
+				(option) =>
+					applyLocalizedBuilder(option, 'commands/settings:optionsNameName', 'commands/settings:optionsNameDescription').setRequired(true)
+			),
+		'profile'
+	)
+	public profileSet(interaction: Command.ChatInputInteraction, { name }: SettingsProfileSetOptions) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:profileSetResult', { name }) });
+	}
+
+	@RegisterSubcommandGroup((builder) =>
+		applyLocalizedBuilder(builder, 'commands/settings:notificationsName', 'commands/settings:notificationsDescription')
+	)
+	@RegisterSubcommand(
+		(builder) =>
+			applyLocalizedBuilder(builder, 'commands/settings:notificationsEnableName', 'commands/settings:notificationsEnableDescription'),
+		'notifications'
+	)
+	public notificationsEnable(interaction: Command.ChatInputInteraction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:notificationsEnableResult') });
+	}
+
+	@RegisterSubcommand(
+		(builder) =>
+			applyLocalizedBuilder(builder, 'commands/settings:notificationsDisableName', 'commands/settings:notificationsDisableDescription'),
+		'notifications'
+	)
+	public notificationsDisable(interaction: Command.ChatInputInteraction) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/settings:notificationsDisableResult') });
+	}
+}
+
+interface SettingsProfileSetOptions {
+	name: string;
+}

package/template/features/subcommands-advanced-i18n/src/locales/en-US/commands/settings.json

@@ -0,0 +1,22 @@
+{
+	"name": "settings",
+	"description": "Manage your settings",
+	"profileName": "profile",
+	"profileDescription": "Manage your profile settings",
+	"profileGetName": "get",
+	"profileGetDescription": "View your current profile name",
+	"profileGetResult": "Your profile name is not set yet.",
+	"profileSetName": "set",
+	"profileSetDescription": "Set your profile name",
+	"profileSetResult": "Your profile name is now \"{{name}}\".",
+	"notificationsName": "notifications",
+	"notificationsDescription": "Manage your notification settings",
+	"notificationsEnableName": "enable",
+	"notificationsEnableDescription": "Enable notifications",
+	"notificationsEnableResult": "Notifications enabled.",
+	"notificationsDisableName": "disable",
+	"notificationsDisableDescription": "Disable notifications",
+	"notificationsDisableResult": "Notifications disabled.",
+	"optionsNameName": "name",
+	"optionsNameDescription": "The new profile name"
+}

package/template/features/subcommands-i18n/src/commands/math.js.hbs

@@ -0,0 +1,46 @@
+import { Command } from '@wolfstar/http-framework';
+import { applyLocalizedBuilder, getSupportedUserLanguageT } from '@wolfstar/plugin-i18next';
+import { ApplicationIntegrationType, InteractionContextType } from 'discord-api-types/v10';
+
+export class MathCommand extends Command {
+	registerApplicationCommands(registry) {
+		registry
+			.registerChatInputCommand((builder) =>
+				applyLocalizedBuilder(builder, 'commands/math:name', 'commands/math:description')
+					.setIntegrationTypes(ApplicationIntegrationType.GuildInstall, ApplicationIntegrationType.UserInstall)
+					.setContexts(InteractionContextType.Guild, InteractionContextType.BotDM, InteractionContextType.PrivateChannel)
+			)
+			.registerSubcommand(
+				(builder) =>
+					applyLocalizedBuilder(builder, 'commands/math:addName', 'commands/math:addDescription')
+						.addIntegerOption((option) =>
+							applyLocalizedBuilder(option, 'commands/math:optionsLeftName', 'commands/math:optionsLeftDescription').setRequired(true)
+						)
+						.addIntegerOption((option) =>
+							applyLocalizedBuilder(option, 'commands/math:optionsRightName', 'commands/math:optionsRightDescription').setRequired(true)
+						),
+				'add'
+			)
+			.registerSubcommand(
+				(builder) =>
+					applyLocalizedBuilder(builder, 'commands/math:subtractName', 'commands/math:subtractDescription')
+						.addIntegerOption((option) =>
+							applyLocalizedBuilder(option, 'commands/math:optionsLeftName', 'commands/math:optionsLeftDescription').setRequired(true)
+						)
+						.addIntegerOption((option) =>
+							applyLocalizedBuilder(option, 'commands/math:optionsRightName', 'commands/math:optionsRightDescription').setRequired(true)
+						),
+				'subtract'
+			);
+	}
+
+	add(interaction, { left, right }) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/math:addResult', { left, right, result: left + right }) });
+	}
+
+	subtract(interaction, { left, right }) {
+		const t = getSupportedUserLanguageT(interaction);
+		return interaction.reply({ content: t('commands/math:subtractResult', { left, right, result: left - right }) });
+	}
+}