nyxx_commands 3.1.0

A framework for easily creating slash commands and text commands for Discord using the nyxx library.

3.1.0

New features:

• Default choices for CombineConverters and FallbackConverters can now be specified in the choices parameter
• You can now specify the Discord slash command option type to use in Converter, CombineConverter and FallbackConverters with the type parameter
• Added a new hideOriginalResponse option to CommandsOptions that allows you to hide the automatic acknowledgement of interactions with autoAcknowledgeInteractions
• Added a new acknowledge method to InteractionContext that allows you to override hideOriginalResponse
• Added a new hideOriginalResponse parameter to Command constructors that allows you to override CommandsOptions.hideOriginalResponse on a per-command basis
• Added a new hidden parameter to InteractionContext.respond that allows you to send an ephemeral response. The hidden state of the response sent is guaranteed to match the hidden parameter, however to avoid strange behaviour it is recommended to acknowledge the interaction with InteractionContext.acknowledge if the response is delayed
• Added a new mention parameter to MessageContext.respond that allows you to specify whether the reply to the command should mention the user or not
• Added a new UseConverter decorator that allows you to override the converter used to parse a specific argument
• Added converters for doubles and Mentionables
• Added a new global mentionOr function that can be used in CommandsPlugin.prefix to allow mention prefixes

Miscellaneous:

• autoAcknowledgeInteractions no longer immediately acknowledges interactions upon receiving them, allowing ephemeral responses to be correctly sent
• Bumped nyxx_interactions to 3.1.0
• Argument parsing is now done in parallel, making commands with multiple arguments faster to invoke

Deprecations:

• Setting the Discord slash command option type to use for a Dart Type via the discordTypes map is now deprecated. Use the type parameter in converter consutrctors instead
• Context.send is now deprecated as Context.respond is more appropriate for most cases. If Context.send was really what you wanted, use Context.channel.sendMessage instead

3.0.0

Breaking changes:

• The base Bot class has been replaced with a CommandsPlugin class that can be used as a plugin with nyxx 3.0.0
• nyxx and nyxx_interactions dependencies have been bumped to 3.0.0; versions 2.x are now unsupported
• BotOptions has been renamed to CommandsOptions and no longer supports the options found in ClientOptions. Create two seperate instances and pass them to NyxxFactory.createNyxx... and CommandsPlugin respectively, in the options named parameter
• The bot field on Context has been replaced with a client field pointing to the INyxx instance and a commands field pointing to the CommandsPlugin instance.

2.0.0:

Breaking changes:

• Messages sent by bot users will no longer be executed by default, see BotOptions.acceptBotCommands and BotOptions.acceptSelfCommands

New features:

• A new acceptBotCommands option has been added to BotOptions to allow executing commands from messages sent by other bot users
• A new acceptSelfCommands options has been added to BotOptions to allow executing commands from messages sent by the bot itself
• onPreCall and onPostCall streams on Commands and Groups can be used to register pre- and post- call hooks
• AbstractCheck class can be exetended to implement stateful checks
• CooldownCheck can be used to apply a cooldown to a command based on different criteria
• InteractionCheck and MessageCheck can be used with Check.any() to allow slash commands or text commands to bypass other checks
• Check.all() can be used to group checks

Bug fixes:

• Invalid cased command/group/argument names are now caught and a CommandRegistrationError is thrown
• StringView.escape() now correctly escapes from start to end and not start to index

1.0.0

• Version 1 was skipped to keep version consistent with the other nyxx libraries

0.4.0

Breaking changes:

• Exceptions have been reworked and are no longer named the same

New features:

• Converters can now specify pre-defined choices for their type, this behaviour can be overridden on a per-command basis with the @Choices decorator
• Command arguments can now have custom names with the @Name decorator

0.3.0

New features:

• Checks now integrate with Discord's slash command permissions
• Checks can now be asynchronous
• Added RoleCheck, UserCheck and GuildCheck that represent the basic Discord slash command permissions: role restricted, user restricted and guild restricted (guild command)
• Slash command arguments can have descriptions set with the @Description decorator

Breaking changes:

• Checks are no longer a simple function

0.2.0

Breaking changes:

• Reorder description and execute parameters in Command.textOnly and Command.slashOnly constructors.
• Remove syncDeleted option from BotOptions as nyxx_interactions removes them on sync anyways.

New features:

• Add send(MessageBuilder) and respond(MessageBuilder) methods to Context
• Add children as an optional argument to Command and Group constructor
• Add autoAcknowledgeInteractions option to BotOptions to determine whether to automatically respond to interaction events
• Commands can now restrict execution using checks

Bugfixes:

• InteractionContext.respond will no longer throw an error when responding immediately
• Slash Commands can no longer have direct slash command children
• Errors emitted outside of argument parsing and callback execution are now correctly sent to Bot.onCommandError

Miscellaneous:

• Text-only and slash-only commands can now have Context as their first argument type

0.1.0

• Initial release