Command options

resolveCommandOptions reads a chat input command's data and hands back an object ready to pass as seed variables. Whatever the user typed into the command becomes available to the template by option name.

For developers

import { resolveCommandOptions } from '@tagscript/plugin-discord';
import { Interpreter, StrictVarsParser } from 'tagscript';

const ts = new Interpreter(new StrictVarsParser());

const response = await ts.run(template, resolveCommandOptions(interaction.data));

The argument is the data object off the interaction payload, typed APIChatInputApplicationCommandInteractionData. Each option becomes a variable named after it, and its type decides which transformer is used:

An option's value is only ever an ID. The objects behind those IDs live in data.resolved, which Discord fills in for you, and that is where every transformer above reads from. An option missing from resolved is skipped, so the variable is absent rather than holding a bare snowflake.

Subcommands and subcommand groups are flattened with a - separated prefix, and the names themselves are exposed as subCommand and subCommandGroup.

{subCommand}
{sub-command-member}
{sub-command-group-sub-command-channel}

Merge in anything else you want the template to see:

const response = await ts.run(template, {
	...resolveCommandOptions(interaction.data),
	member: new MemberTransformer(interaction.member),
	guild: new GuildTransformer(guild),
});

mapOptions is exported too, for the case where you hold the options array and the resolved data separately.

For template authors

The names come from the command your bot's authors set up, so ask them which options exist. A command with a reason option gives you {reason}, and inside a subcommand called ban it becomes {ban-reason}.

Colours

resolveColor is also exported. It accepts 0x37b2cb, #ed4245, ed4245, a plain number, Random, or a Discord colour name such as Red, and returns a number. It returns the input unchanged instead of throwing when it cannot resolve a value, which is what keeps a bad colour in a template from ending the render. The names it knows are exported as Colors.

API reference

resolveCommandOptions, mapOptions, resolveColor