@sapphire/decorators 7.0.0-pr-589.aa473f9.0 → 7.0.0-pr-935.7da5c8bb

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils.ts","../../src/base-decorators.ts","../../src/djs-decorators.ts","../../src/piece-decorators.ts"],"names":["target","DecoratorIdentifiers"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * The function precondition interface.\n */\nexport interface FunctionPrecondition {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): boolean | Promise<boolean>;\n}\n\n/**\n * The fallback interface, this is called when the function precondition returns or resolves with a falsy value.\n */\nexport interface FunctionFallback {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): unknown;\n}\n\n/**\n * Utility to make a method decorator with lighter syntax and inferred types.\n *\n * ```typescript\n * // Enumerable function\n *\tfunction enumerableMethod(value: boolean) {\n *\t\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n *\t\t\tdescriptor.enumerable = value;\n *\t\t});\n *\t}\n * ```\n * @param fn The method to decorate\n */\nexport function createMethodDecorator(fn: MethodDecorator): MethodDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make a class decorator with lighter syntax and inferred types.\n * @param fn The class to decorate\n * @see {@link ApplyOptions}\n */\nexport function createClassDecorator<TFunction extends (...args: any[]) => void>(fn: TFunction): ClassDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make function preconditions.\n *\n * ```typescript\n * // No fallback (returns undefined)\n * function requireGuild(value: number) {\n *   return createFunctionPrecondition((message: Message) =>\n *     message.guild !== null\n *   );\n * }\n *\n * // With fallback\n * function requireGuild(\n *   value: number,\n *   fallback: () => unknown = () => undefined\n * ) {\n *   return createFunctionPrecondition(\n *     (message: Message) => message.guild !== null,\n *     fallback\n *   );\n * }\n * ```\n * @since 1.0.0\n * @param precondition The function that defines whether or not the function should be run, returning the returned value from fallback\n * @param fallback The fallback value that defines what the method should return in case the precondition fails\n */\nexport function createFunctionPrecondition(precondition: FunctionPrecondition, fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tconst method = descriptor.value;\n\t\tif (!method) throw new Error('Function preconditions require a [[value]].');\n\t\tif (typeof method !== 'function') throw new Error('Function preconditions can only be applied to functions.');\n\n\t\tdescriptor.value = async function descriptorValue(this: (...args: any[]) => any, ...args: any[]) {\n\t\t\tconst canRun = await precondition(...args);\n\t\t\treturn canRun ? method.call(this, ...args) : fallback.call(this, ...args);\n\t\t} as unknown as undefined;\n\t});\n}\n\n/**\n * Creates a new proxy to efficiently add properties to class without creating subclasses\n * @param target The constructor of the class to modify\n * @param handler The handler function to modify the constructor behavior for the target\n * @hidden\n */\nexport function createProxy<T extends object>(target: T, handler: Omit<ProxyHandler<T>, 'get'>): T {\n\treturn new Proxy(target, {\n\t\t...handler,\n\t\tget: (target, property) => {\n\t\t\tconst value = Reflect.get(target, property);\n\t\t\treturn typeof value === 'function' ? (...args: readonly unknown[]) => value.apply(target, args) : value;\n\t\t}\n\t});\n}\n","import { createMethodDecorator } from './utils';\n\n/**\n * Decorator that sets the enumerable property of a class field to the desired value.\n * @param value Whether the property should be enumerable or not\n */\nexport function Enumerable(value: boolean) {\n\treturn (target: object, key: string) => {\n\t\tReflect.defineProperty(target, key, {\n\t\t\tenumerable: value,\n\t\t\tset(this: unknown, val: unknown) {\n\t\t\t\tReflect.defineProperty(this as object, key, {\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\tenumerable: value,\n\t\t\t\t\tvalue: val,\n\t\t\t\t\twritable: true\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\t};\n}\n\n/**\n * Decorator that sets the enumerable property of a class method to the desired value.\n * @param value Whether the method should be enumerable or not\n */\nexport function EnumerableMethod(value: boolean) {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tdescriptor.enumerable = value;\n\t});\n}\n","import { isDMChannel, isGuildBasedChannel } from '@sapphire/discord.js-utilities';\nimport { UserError } from '@sapphire/framework';\nimport { isNullish } from '@sapphire/utilities';\nimport { PermissionFlagsBits, PermissionsBitField, type BaseInteraction, type Message, type PermissionResolvable } from 'discord.js';\nimport { createFunctionPrecondition, type FunctionFallback } from './utils';\n\nexport enum DecoratorIdentifiers {\n\tRequiresClientPermissionsGuildOnly = 'requiresClientPermissionsGuildOnly',\n\tRequiresClientPermissionsMissingPermissions = 'requiresClientPermissionsMissingPermissions',\n\tRequiresUserPermissionsGuildOnly = 'requiresUserPermissionsGuildOnly',\n\tRequiresUserPermissionsMissingPermissions = 'requiresUserPermissionsMissingPermissions'\n}\n\nconst DMAvailablePermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\t//\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel\n\t]).bitfield & PermissionsBitField.All\n);\n\nconst DMAvailableUserPermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel,\n\t\tPermissionFlagsBits.UseExternalStickers,\n\t\tPermissionFlagsBits.MentionEveryone\n\t]).bitfield & PermissionsBitField.All\n);\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the client that is to execute the command. For setting permissions required user of the command see {@link RequiresUserPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresClientPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresClientPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailablePermissions.bitfield);\n\n\treturn createFunctionPrecondition((context: Message | BaseInteraction) => {\n\t\tconst { channel } = context;\n\t\tconst member = context.guild?.members.me;\n\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because I do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(channel) && !isNullish(member)) {\n\t\t\tconst missingPermissions = channel.permissionsFor(member).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but I am not allowed to do that. I am missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the user of the command. For setting permissions required for the client see {@link RequiresClientPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresUserPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresUserPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailableUserPermissions.bitfield);\n\n\treturn createFunctionPrecondition((context: Message | BaseInteraction) => {\n\t\tconst { channel } = context;\n\t\tconst member = context.guild?.members.me;\n\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because you do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(channel) && !isNullish(member)) {\n\t\t\tconst missingPermissions = channel.permissionsFor(member).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but you are not allowed to do that. You are missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Requires the message to be run in a guild context, this decorator requires the first argument to be a {@link Message} or {@link BaseInteraction} instance which includes all interaction types\n * @since 1.0.0\n * @param fallback The fallback value passed to {@link createFunctionPrecondition}\n */\nexport function RequiresGuildContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((context: Message | BaseInteraction) => context.guild !== null, fallback);\n}\n\n/**\n * Requires the message to be run in a dm context, this decorator requires the first argument to be a {@link Message} or {@link BaseInteraction} instance which includes all interaction types\n * @since 1.0.0\n * @param fallback The fallback value passed to {@link createFunctionPrecondition}\n */\nexport function RequiresDMContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((context: Message | BaseInteraction) => context.guild === null, fallback);\n}\n","import { container, type ApplicationCommandRegistryRegisterOptions, type Command, type Piece } from '@sapphire/framework';\nimport type { Container } from '@sapphire/pieces';\nimport type { Ctor } from '@sapphire/utilities';\nimport {\n\tApplicationCommandType,\n\ttype ContextMenuCommandBuilder,\n\ttype SlashCommandBuilder,\n\ttype SlashCommandOptionsOnlyBuilder,\n\ttype SlashCommandSubcommandsOnlyBuilder\n} from 'discord.js';\nimport { createClassDecorator, createProxy } from './utils';\n\nconst applicationDecoratorsMap = new WeakMap<CommandTarget<any>, DecoratorMap<any>[]>();\nconst proxyApplicationCommandToOriginal = new WeakMap<CommandTarget<any>, CommandTarget<any>>();\nconst originalApplicationCommandToProxy = new WeakMap<CommandTarget<any>, CommandTarget<any>>();\n\n/**\n * Decorator function that applies given options to any Sapphire piece\n * @param optionsOrFn The options or function that returns options to pass to the piece constructor\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import type { Message } from 'discord.js';\n *\n * @ApplyOptions<Command.Options>({\n *   description: 'ping pong',\n *   enabled: true\n * })\n * export class UserCommand extends Command {\n *   public override async messageRun(message: Message) {\n *     const msg = await message.channel.send('Ping?');\n *\n *     return msg.edit(\n *       `Pong! Client Latency ${Math.round(this.container.client.ws.ping)}ms. API Latency ${msg.createdTimestamp - message.createdTimestamp}ms.`\n *     );\n *   }\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Listener } from '@sapphire/framework';\n * import { GatewayDispatchEvents, GatewayMessageDeleteDispatch } from 'discord.js';\n *\n * @ApplyOptions<Listener.Options>(({ container }) => ({\n *   description: 'Handle Raw Message Delete events',\n *   emitter: container.client.ws,\n *   event: GatewayDispatchEvents.MessageDelete\n * }))\n * export class UserListener extends Listener {\n *   public override run(data: GatewayMessageDeleteDispatch['d']): void {\n *     if (!data.guild_id) return;\n *\n *     const guild = this.container.client.guilds.cache.get(data.guild_id);\n *     if (!guild || !guild.channels.cache.has(data.channel_id)) return;\n *\n *     // Do something with the data\n *   }\n * }\n * ```\n */\nexport function ApplyOptions<T extends Piece.Options>(optionsOrFn: T | ((parameters: ApplyOptionsCallbackParameters) => T)): ClassDecorator {\n\treturn createClassDecorator((target: Ctor<ConstructorParameters<typeof Piece>, Piece>) =>\n\t\tcreateProxy(target, {\n\t\t\tconstruct: (ctor, [context, baseOptions = {}]: [Piece.LoaderContext, Piece.Options]) =>\n\t\t\t\tnew ctor(context, {\n\t\t\t\t\t...baseOptions,\n\t\t\t\t\t...(typeof optionsOrFn === 'function' ? optionsOrFn({ container, context }) : optionsOrFn)\n\t\t\t\t})\n\t\t})\n\t);\n}\n\n/**\n * Decorator for registering chat input command.\n * @param optionsFn The function that returns options to pass to the registry.\n * @example\n * ```typescript\n * import { RegisterChatInputCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n *\n * (at)RegisterChatInputCommand((builder, command) => builder\n *   .setName(command.name)\n *   .setDescription(command.description)\n * )\n * export class UserCommand extends Command {\n * \t public override chatInputRun(interaction: Command.ChatInputCommandInteraction) {\n * \t   \treturn interaction.reply({ content: 'HI!' });\n * \t }\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterChatInputCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n *\n * (at)RegisterChatInputCommand((builder, command) => builder\n *\t\t.setName(command.name)\n *\t\t.setDescription(command.description),\n *\t{\n *\t\tidHints: ['737141877803057244'],\n *\t\tguildIds: ['737141877803057244']\n *\t}\n * )\n * export class UserCommand extends Command {\n * \t public override chatInputRun(interaction: Command.ChatInputCommandInteraction) {\n * \t   \treturn interaction.reply({ content: 'HI!' });\n * \t }\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterChatInputCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n *\n * (at)RegisterChatInputCommand((builder) => builder\n *   .setName('hi')\n *   .setDescription('Sends a hi message')\n * )\n * export class UserCommand extends Command {\n * \t public override chatInputRun(interaction: Command.ChatInputCommandInteraction) {\n * \t   \treturn interaction.reply({ content: 'HI!' });\n * \t }\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions, RegisterChatInputCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Command.Options>({\n *   description: 'ping pong',\n *   enabled: true\n * })\n * (at)RegisterChatInputCommand((builder, command) => builder\n *   .setName(command.name)\n *   .setDescription(command.description)\n * )\n * export class UserCommand extends Command { *\n * \t public override chatInputRun(interaction: Command.ChatInputCommandInteraction) {\n * \t   \treturn interaction.reply({ content: 'HI!' });\n * \t }\n * }\n * ```\n */\nexport function RegisterChatInputCommand<CMD extends Command = Command>(\n\toptionsFn: ChatInputCommandDecoratorsMap<CMD>['optionsFn'],\n\tregistryOptions?: ApplicationCommandRegistryRegisterOptions\n): ClassDecorator {\n\treturn createClassDecorator((target: CommandTarget<CMD>) =>\n\t\tcollectApplicationCommandDecorators(target, { type: 'RegisterChatInputCommand', optionsFn, registryOptions })\n\t);\n}\n\n/**\n * Decorator for registering message context menu command.\n * @param optionsFn The function that returns options to pass to the registry.\n * @example\n * ```typescript\n * import { RegisterMessageContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterMessageContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterMessageContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterMessageContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall),\n *\t{\n *\t\tidHints: ['737141877803057244'],\n *\t\tguildIds: ['737141877803057244']\n *\t}\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterMessageContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterMessageContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterMessageContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterMessageContextMenuCommand((builder) => builder\n * \t .setName('Send HI')\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions, RegisterMessageContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)ApplyOptions<Command.Options>({\n *   enabled: true\n * })\n * (at)RegisterMessageContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n */\nexport function RegisterMessageContextMenuCommand<CMD extends Command = Command>(\n\toptionsFn: ContextMenuCommandDecoratorsMap<CMD>['optionsFn'],\n\tregistryOptions?: ApplicationCommandRegistryRegisterOptions\n): ClassDecorator {\n\treturn createClassDecorator((target: CommandTarget<CMD>) =>\n\t\tcollectApplicationCommandDecorators(target, { type: 'RegisterMessageContextMenuCommand', optionsFn, registryOptions })\n\t);\n}\n\n/**\n * Decorator for registering user context menu command.\n * @param optionsFn The function that returns options to pass to the registry.\n * @example\n * ```typescript\n * import { RegisterUserContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type UserContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterUserContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: UserContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * ```\n * @example\n * ```typescript\n * import { RegisterUserContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type MessageContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterUserContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall),\n *\t{\n *\t\tidHints: ['737141877803057244'],\n *\t\tguildIds: ['737141877803057244']\n *\t}\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { RegisterUserContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type UserContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)RegisterUserContextMenuCommand((builder, command) => builder\n * \t .setName('Send HI')\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: UserContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: `HI ${interaction.targetUser}!` })\n * \t}\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions, RegisterUserContextMenuCommand } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import { ApplicationIntegrationType, InteractionContextType, type UserContextMenuCommandInteraction } from 'discord.js';\n *\n * (at)ApplyOptions<Command.Options>({\n *   enabled: true\n * })\n * (at)RegisterUserContextMenuCommand((builder, command) => builder\n * \t .setName(command.name)\n * \t .setContexts(InteractionContextType.Guild)\n * \t .setIntegrationTypes(ApplicationIntegrationType.GuildInstall)\n * )\n * export class UserCommand extends Command {\n * \tpublic override contextMenuRun(interaction: MessageContextMenuCommandInteraction) {\n * \t\treturn interaction.reply({ content: 'HI!' })\n * \t}\n * }\n * ```\n */\nexport function RegisterUserContextMenuCommand<CMD extends Command = Command>(\n\toptionsFn: ContextMenuCommandDecoratorsMap<CMD>['optionsFn'],\n\tregistryOptions?: ApplicationCommandRegistryRegisterOptions\n): ClassDecorator {\n\treturn createClassDecorator((target: CommandTarget<CMD>) =>\n\t\tcollectApplicationCommandDecorators(target, { type: 'RegisterUserContextMenuCommand', optionsFn, registryOptions })\n\t);\n}\n\nfunction collectApplicationCommandDecorators<CMD extends Command>(target: CommandTarget<CMD>, decorator: DecoratorMap<CMD>): CommandTarget<CMD> {\n\tconst original = proxyApplicationCommandToOriginal.get(target) ?? target;\n\n\tconst exisiting = applicationDecoratorsMap.get(original) ?? [];\n\texisiting.push(decorator);\n\tapplicationDecoratorsMap.set(original, exisiting);\n\n\tif (originalApplicationCommandToProxy.has(original)) return originalApplicationCommandToProxy.get(original)!;\n\n\tconst proxied = createProxy(target, {\n\t\tconstruct(originalTarget, argArray) {\n\t\t\tconst command: CMD = Reflect.construct(originalTarget, argArray);\n\t\t\tconst decorators = applicationDecoratorsMap.get(original) as DecoratorMap<CMD>[];\n\n\t\t\tconst originalRegister = command.registerApplicationCommands?.bind(command);\n\t\t\tcommand.registerApplicationCommands = function registerApplicationCommands(registry: Command.Registry) {\n\t\t\t\tfor (const deco of decorators) {\n\t\t\t\t\tswitch (deco.type) {\n\t\t\t\t\t\tcase 'RegisterChatInputCommand': {\n\t\t\t\t\t\t\tregistry.registerChatInputCommand((builder) => deco.optionsFn(builder, command), deco.registryOptions);\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tcase 'RegisterMessageContextMenuCommand': {\n\t\t\t\t\t\t\tregistry.registerContextMenuCommand(\n\t\t\t\t\t\t\t\t(builder) => deco.optionsFn(builder, command).setType(ApplicationCommandType.Message),\n\t\t\t\t\t\t\t\tdeco.registryOptions\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tcase 'RegisterUserContextMenuCommand': {\n\t\t\t\t\t\t\tregistry.registerContextMenuCommand(\n\t\t\t\t\t\t\t\t(builder) => deco.optionsFn(builder, command).setType(ApplicationCommandType.User),\n\t\t\t\t\t\t\t\tdeco.registryOptions\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (originalRegister) return originalRegister.call(this, registry);\n\t\t\t};\n\n\t\t\treturn command;\n\t\t}\n\t});\n\n\tproxyApplicationCommandToOriginal.set(proxied, original);\n\toriginalApplicationCommandToProxy.set(original, proxied);\n\n\treturn proxied;\n}\n\nexport interface ApplyOptionsCallbackParameters {\n\tcontainer: Container;\n\tcontext: Piece.LoaderContext;\n}\n\ninterface ChatInputCommandDecoratorsMap<CMD extends Command> {\n\ttype: 'RegisterChatInputCommand';\n\toptionsFn: (\n\t\tbuilder: SlashCommandBuilder,\n\t\tcommand: ThisType<CMD> & CMD\n\t) => SlashCommandBuilder | SlashCommandSubcommandsOnlyBuilder | SlashCommandOptionsOnlyBuilder;\n\tregistryOptions?: ApplicationCommandRegistryRegisterOptions;\n}\n\ninterface ContextMenuCommandDecoratorsMap<CMD extends Command> {\n\ttype: 'RegisterMessageContextMenuCommand' | 'RegisterUserContextMenuCommand';\n\toptionsFn: (\n\t\tbuilder: ContextMenuCommandBuilder, //\n\t\tcommand: ThisType<CMD> & CMD\n\t) => ContextMenuCommandBuilder;\n\tregistryOptions?: ApplicationCommandRegistryRegisterOptions;\n}\n\ntype CommandTarget<CMD extends Command> = Ctor<ConstructorParameters<typeof Command>, CMD>;\ntype DecoratorMap<CMD extends Command> = ChatInputCommandDecoratorsMap<CMD> | ContextMenuCommandDecoratorsMap<CMD>;\n"]}

package/package.json

@@ -1,43 +1,52 @@
 {
   "name": "@sapphire/decorators",
-  "version": "7.0.0-pr-589.aa473f9.0",
+  "version": "7.0.0-pr-935.7da5c8bb",
   "description": "Useful TypeScript decorators for Sapphire Framework Discord bots",
   "author": "@sapphire",
   "license": "MIT",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/cjs/index.d.cts",
   "exports": {
-    "import": "./dist/index.mjs",
-    "require": "./dist/index.js",
-    "types": "./dist/index.d.ts"
+    "import": {
+      "types": "./dist/esm/index.d.mts",
+      "default": "./dist/esm/index.mjs"
+    },
+    "require": {
+      "types": "./dist/cjs/index.d.cts",
+      "default": "./dist/cjs/index.cjs"
+    }
   },
   "sideEffects": false,
   "homepage": "https://github.com/sapphiredev/utilities/tree/main/packages/decorators",
   "scripts": {
     "test": "vitest run",
     "lint": "eslint src tests --ext ts --fix -c ../../.eslintrc",
-    "build": "tsup",
+    "build": "yarn gen-index && tsup && yarn build:rename-cjs-index",
+    "build:rename-cjs-index": "tsx ../../scripts/rename-cjs-index.cts",
     "docs": "typedoc-json-parser",
     "prepack": "yarn build",
     "bump": "cliff-jumper",
-    "check-update": "cliff-jumper --dry-run"
+    "check-update": "cliff-jumper --dry-run",
+    "gen-index": "tsx ../../scripts/gen-index.cts decorators --write"
   },
   "dependencies": {
-    "tslib": "^2.5.0"
+    "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@favware/cliff-jumper": "^2.0.0",
-    "@sapphire/discord-utilities": "^3.0.3",
-    "@sapphire/discord.js-utilities": "^6.0.7",
-    "@sapphire/ratelimits": "^2.4.6",
-    "@sapphire/result": "^2.6.3",
-    "@sapphire/utilities": "^3.11.1",
-    "@vitest/coverage-c8": "^0.30.1",
-    "tsup": "^6.7.0",
-    "typedoc": "^0.24.6",
-    "typedoc-json-parser": "^7.3.2",
-    "typescript": "^5.0.4",
-    "vitest": "^0.30.1"
+    "@favware/cliff-jumper": "^6.0.0",
+    "@sapphire/discord-utilities": "^3.5.0",
+    "@sapphire/discord.js-utilities": "^7.3.3",
+    "@sapphire/ratelimits": "^2.4.11",
+    "@sapphire/result": "^2.7.3",
+    "@sapphire/utilities": "^3.18.2",
+    "@vitest/coverage-v8": "^3.2.4",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.6",
+    "typedoc": "^0.26.11",
+    "typedoc-json-parser": "^10.2.0",
+    "typescript": "~5.4.5",
+    "vitest": "^3.2.4"
   },
   "repository": {
     "type": "git",
@@ -45,9 +54,7 @@
     "directory": "packages/decorators"
   },
   "files": [
-    "dist/**/*.js*",
-    "dist/**/*.mjs*",
-    "dist/**/*.d*"
+    "dist/"
   ],
   "engines": {
     "node": ">=v14.0.0",

package/dist/index.d.ts

@@ -1,240 +0,0 @@
-import { PermissionResolvable } from 'discord.js';
-import { Piece } from '@sapphire/framework';
-import { Container } from '@sapphire/pieces';
-
-/**
- * Decorator that sets the enumerable property of a class field to the desired value.
- * @param value Whether the property should be enumerable or not
- */
-declare function Enumerable(value: boolean): (target: unknown, key: string) => void;
-/**
- * Decorator that sets the enumerable property of a class method to the desired value.
- * @param value Whether the method should be enumerable or not
- */
-declare function EnumerableMethod(value: boolean): MethodDecorator;
-
-/**
- * The function precondition interface.
- */
-interface FunctionPrecondition {
-    /**
-     * The arguments passed to the function or class' method.
-     */
-    (...args: any[]): boolean | Promise<boolean>;
-}
-/**
- * The fallback interface, this is called when the function precondition returns or resolves with a falsy value.
- */
-interface FunctionFallback {
-    /**
-     * The arguments passed to the function or class' method.
-     */
-    (...args: any[]): unknown;
-}
-/**
- * Utility to make a method decorator with lighter syntax and inferred types.
- *
- * ```typescript
- * // Enumerable function
- *	function enumerableMethod(value: boolean) {
- *		return createMethodDecorator((_target, _propertyKey, descriptor) => {
- *			descriptor.enumerable = value;
- *		});
- *	}
- * ```
- * @param fn The method to decorate
- */
-declare function createMethodDecorator(fn: MethodDecorator): MethodDecorator;
-/**
- * Utility to make a class decorator with lighter syntax and inferred types.
- * @param fn The class to decorate
- * @see {@link ApplyOptions}
- */
-declare function createClassDecorator<TFunction extends (...args: any[]) => void>(fn: TFunction): ClassDecorator;
-/**
- * Utility to make function preconditions.
- *
- * ```typescript
- * // No fallback (returns undefined)
- * function requireGuild(value: number) {
- *   return createFunctionPrecondition((message: Message) =>
- *     message.guild !== null
- *   );
- * }
- *
- * // With fallback
- * function requireGuild(
- *   value: number,
- *   fallback: () => unknown = () => undefined
- * ) {
- *   return createFunctionPrecondition(
- *     (message: Message) => message.guild !== null,
- *     fallback
- *   );
- * }
- * ```
- * @since 1.0.0
- * @param precondition The function that defines whether or not the function should be run, returning the returned value from fallback
- * @param fallback The fallback value that defines what the method should return in case the precondition fails
- */
-declare function createFunctionPrecondition(precondition: FunctionPrecondition, fallback?: FunctionFallback): MethodDecorator;
-/**
- * Creates a new proxy to efficiently add properties to class without creating subclasses
- * @param target The constructor of the class to modify
- * @param handler The handler function to modify the constructor behavior for the target
- * @hidden
- */
-declare function createProxy<T extends object>(target: T, handler: Omit<ProxyHandler<T>, 'get'>): T;
-
-declare enum DecoratorIdentifiers {
-    RequiresClientPermissionsGuildOnly = "requiresClientPermissionsGuildOnly",
-    RequiresClientPermissionsMissingPermissions = "requiresClientPermissionsMissingPermissions",
-    RequiresUserPermissionsGuildOnly = "requiresUserPermissionsGuildOnly",
-    RequiresUserPermissionsMissingPermissions = "requiresUserPermissionsMissingPermissions"
-}
-/**
- * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.
- * @remark This decorator applies to the client that is to execute the command. For setting permissions required user of the command see {@link RequiresUserPermissions}
- * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.
- * @param permissionsResolvable Permissions that the method should have.
- * @example
- * ```typescript
- * import { ApplyOptions, RequiresClientPermissions } from '@sapphire/decorators';
- * import { Subcommand } from '@sapphire/plugin-subcommands';
- * import type { Message } from 'discord.js';
- *
- * (at)ApplyOptions<Subcommand.Options>({
- * 	aliases: ['cws'],
- * 	description: 'A basic command with some subcommands',
- * 	subCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]
- * })
- * export default class extends Subcommand {
- *     // Anyone should be able to view the result, but not modify
- * 	public async show(message: Message) {
- * 		return message.channel.send('Showing!');
- * 	}
- *
- * 	(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.
- * 	public async add(message: Message) {
- * 		return message.channel.send('Adding!');
- * 	}
- *
- * 	(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.
- * 	public async remove(message: Message) {
- * 		return message.channel.send('Removing!');
- * 	}
- *
- * 	(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.
- * 	public async reset(message: Message) {
- * 		return message.channel.send('Resetting!');
- * 	}
- * }
- * ```
- */
-declare const RequiresClientPermissions: (...permissionsResolvable: PermissionResolvable[]) => MethodDecorator;
-/**
- * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.
- * @remark This decorator applies to the user of the command. For setting permissions required for the client see {@link RequiresClientPermissions}
- * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.
- * @param permissionsResolvable Permissions that the method should have.
- * @example
- * ```typescript
- * import { ApplyOptions, RequiresUserPermissions } from '@sapphire/decorators';
- * import { Subcommand } from '@sapphire/plugin-subcommands';
- * import type { Message } from 'discord.js';
- *
- * (at)ApplyOptions<Subcommand.Options>({
- * 	aliases: ['cws'],
- * 	description: 'A basic command with some subcommands',
- * 	subCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]
- * })
- * export default class extends Subcommand {
- *     // Anyone should be able to view the result, but not modify
- * 	public async show(message: Message) {
- * 		return message.channel.send('Showing!');
- * 	}
- *
- * 	(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.
- * 	public async add(message: Message) {
- * 		return message.channel.send('Adding!');
- * 	}
- *
- * 	(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.
- * 	public async remove(message: Message) {
- * 		return message.channel.send('Removing!');
- * 	}
- *
- * 	(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.
- * 	public async reset(message: Message) {
- * 		return message.channel.send('Resetting!');
- * 	}
- * }
- * ```
- */
-declare const RequiresUserPermissions: (...permissionsResolvable: PermissionResolvable[]) => MethodDecorator;
-/**
- * Requires the message to be run in a guild context, this decorator requires the first argument to be a `Message` instance
- * @since 1.0.0
- * @param fallback The fallback value passed to `createFunctionInhibitor`
- */
-declare function RequiresGuildContext(fallback?: FunctionFallback): MethodDecorator;
-/**
- * Requires the message to be run in a dm context, this decorator requires the first argument to be a `Message` instance
- * @since 1.0.0
- * @param fallback The fallback value passed to `createFunctionInhibitor`
- */
-declare function RequiresDMContext(fallback?: FunctionFallback): MethodDecorator;
-
-/**
- * Decorator function that applies given options to any Sapphire piece
- * @param options The options to pass to the piece constructor
- * @example
- * ```typescript
- * import { ApplyOptions } from '@sapphire/decorators';
- * import { Command } from '@sapphire/framework';
- * import type { Message } from 'discord.js';
- *
- * @ApplyOptions<Command.Options>({
- *   description: 'ping pong',
- *   enabled: true
- * })
- * export class UserCommand extends Command {
- *   public override async messageRun(message: Message) {
- *     const msg = await message.channel.send('Ping?');
- *
- *     return msg.edit(
- *       `Pong! Client Latency ${Math.round(this.container.client.ws.ping)}ms. API Latency ${msg.createdTimestamp - message.createdTimestamp}ms.`
- *     );
- *   }
- * }
- * ```
- * @example
- * ```typescript
- * import { ApplyOptions } from '@sapphire/decorators';
- * import { Listener } from '@sapphire/framework';
- * import { GatewayDispatchEvents, GatewayMessageDeleteDispatch } from 'discord.js';
- *
- * @ApplyOptions<Listener.Options>(({ container }) => ({
- *   description: 'Handle Raw Message Delete events',
- *   emitter: container.client.ws,
- *   event: GatewayDispatchEvents.MessageDelete
- * }))
- * export class UserListener extends Listener {
- *   public override run(data: GatewayMessageDeleteDispatch['d']): void {
- *     if (!data.guild_id) return;
- *
- *     const guild = this.container.client.guilds.cache.get(data.guild_id);
- *     if (!guild || !guild.channels.cache.has(data.channel_id)) return;
- *
- *     // Do something with the data
- *   }
- * }
- * ```
- */
-declare function ApplyOptions<T extends Piece.Options>(optionsOrFn: T | ((parameters: ApplyOptionsCallbackParameters) => T)): ClassDecorator;
-interface ApplyOptionsCallbackParameters {
-    container: Container;
-    context: Piece.Context;
-}
-
-export { ApplyOptions, ApplyOptionsCallbackParameters, DecoratorIdentifiers, Enumerable, EnumerableMethod, FunctionFallback, FunctionPrecondition, RequiresClientPermissions, RequiresDMContext, RequiresGuildContext, RequiresUserPermissions, createClassDecorator, createFunctionPrecondition, createMethodDecorator, createProxy };

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils.ts","../src/base-decorators.ts","../src/djs-decorators.ts","../src/piece-decorators.ts"],"names":["target","DecoratorIdentifiers"],"mappings":"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","sourcesContent":["/**\n * The function precondition interface.\n */\nexport interface FunctionPrecondition {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): boolean | Promise<boolean>;\n}\n\n/**\n * The fallback interface, this is called when the function precondition returns or resolves with a falsy value.\n */\nexport interface FunctionFallback {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): unknown;\n}\n\n/**\n * Utility to make a method decorator with lighter syntax and inferred types.\n *\n * ```typescript\n * // Enumerable function\n *\tfunction enumerableMethod(value: boolean) {\n *\t\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n *\t\t\tdescriptor.enumerable = value;\n *\t\t});\n *\t}\n * ```\n * @param fn The method to decorate\n */\nexport function createMethodDecorator(fn: MethodDecorator): MethodDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make a class decorator with lighter syntax and inferred types.\n * @param fn The class to decorate\n * @see {@link ApplyOptions}\n */\nexport function createClassDecorator<TFunction extends (...args: any[]) => void>(fn: TFunction): ClassDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make function preconditions.\n *\n * ```typescript\n * // No fallback (returns undefined)\n * function requireGuild(value: number) {\n *   return createFunctionPrecondition((message: Message) =>\n *     message.guild !== null\n *   );\n * }\n *\n * // With fallback\n * function requireGuild(\n *   value: number,\n *   fallback: () => unknown = () => undefined\n * ) {\n *   return createFunctionPrecondition(\n *     (message: Message) => message.guild !== null,\n *     fallback\n *   );\n * }\n * ```\n * @since 1.0.0\n * @param precondition The function that defines whether or not the function should be run, returning the returned value from fallback\n * @param fallback The fallback value that defines what the method should return in case the precondition fails\n */\nexport function createFunctionPrecondition(precondition: FunctionPrecondition, fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tconst method = descriptor.value;\n\t\tif (!method) throw new Error('Function preconditions require a [[value]].');\n\t\tif (typeof method !== 'function') throw new Error('Function preconditions can only be applied to functions.');\n\n\t\tdescriptor.value = async function descriptorValue(this: (...args: any[]) => any, ...args: any[]) {\n\t\t\tconst canRun = await precondition(...args);\n\t\t\treturn canRun ? method.call(this, ...args) : fallback.call(this, ...args);\n\t\t} as unknown as undefined;\n\t});\n}\n\n/**\n * Creates a new proxy to efficiently add properties to class without creating subclasses\n * @param target The constructor of the class to modify\n * @param handler The handler function to modify the constructor behavior for the target\n * @hidden\n */\nexport function createProxy<T extends object>(target: T, handler: Omit<ProxyHandler<T>, 'get'>): T {\n\treturn new Proxy(target, {\n\t\t...handler,\n\t\tget: (target, property) => {\n\t\t\tconst value = Reflect.get(target, property);\n\t\t\treturn typeof value === 'function' ? (...args: readonly unknown[]) => value.apply(target, args) : value;\n\t\t}\n\t});\n}\n","import type { NonNullObject } from '@sapphire/utilities';\nimport { createMethodDecorator } from './utils';\n\n/**\n * Decorator that sets the enumerable property of a class field to the desired value.\n * @param value Whether the property should be enumerable or not\n */\nexport function Enumerable(value: boolean) {\n\treturn (target: unknown, key: string) => {\n\t\tReflect.defineProperty(target as NonNullObject, key, {\n\t\t\tenumerable: value,\n\t\t\tset(this: unknown, val: unknown) {\n\t\t\t\tReflect.defineProperty(this as NonNullObject, key, {\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\tenumerable: value,\n\t\t\t\t\tvalue: val,\n\t\t\t\t\twritable: true\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\t};\n}\n\n/**\n * Decorator that sets the enumerable property of a class method to the desired value.\n * @param value Whether the method should be enumerable or not\n */\nexport function EnumerableMethod(value: boolean) {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tdescriptor.enumerable = value;\n\t});\n}\n","import { isDMChannel, isGuildBasedChannel } from '@sapphire/discord.js-utilities';\nimport { UserError } from '@sapphire/framework';\nimport { Message, PermissionFlagsBits, PermissionsBitField, type PermissionResolvable } from 'discord.js';\nimport { createFunctionPrecondition, type FunctionFallback } from './utils';\n\nexport enum DecoratorIdentifiers {\n\tRequiresClientPermissionsGuildOnly = 'requiresClientPermissionsGuildOnly',\n\tRequiresClientPermissionsMissingPermissions = 'requiresClientPermissionsMissingPermissions',\n\tRequiresUserPermissionsGuildOnly = 'requiresUserPermissionsGuildOnly',\n\tRequiresUserPermissionsMissingPermissions = 'requiresUserPermissionsMissingPermissions'\n}\n\nconst DMAvailablePermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\t//\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel\n\t]).bitfield & PermissionsBitField.All\n);\n\nconst DMAvailableUserPermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel,\n\t\tPermissionFlagsBits.UseExternalStickers,\n\t\tPermissionFlagsBits.MentionEveryone\n\t]).bitfield & PermissionsBitField.All\n);\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the client that is to execute the command. For setting permissions required user of the command see {@link RequiresUserPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresClientPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresClientPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailablePermissions.bitfield);\n\n\treturn createFunctionPrecondition((message: Message) => {\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(message.channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because I do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(message.channel)) {\n\t\t\tconst missingPermissions = message.channel.permissionsFor(message.guild!.members.me!).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but I am not allowed to do that. I am missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the user of the command. For setting permissions required for the client see {@link RequiresClientPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresUserPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresUserPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailableUserPermissions.bitfield);\n\n\treturn createFunctionPrecondition((message: Message) => {\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(message.channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because you do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(message.channel)) {\n\t\t\tconst missingPermissions = message.channel.permissionsFor(message.member!).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but you are not allowed to do that. You are missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Requires the message to be run in a guild context, this decorator requires the first argument to be a `Message` instance\n * @since 1.0.0\n * @param fallback The fallback value passed to `createFunctionInhibitor`\n */\nexport function RequiresGuildContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((message: Message) => message.guild !== null, fallback);\n}\n\n/**\n * Requires the message to be run in a dm context, this decorator requires the first argument to be a `Message` instance\n * @since 1.0.0\n * @param fallback The fallback value passed to `createFunctionInhibitor`\n */\nexport function RequiresDMContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((message: Message) => message.guild === null, fallback);\n}\n","import { container, type Piece } from '@sapphire/framework';\nimport type { Container } from '@sapphire/pieces';\nimport type { Ctor } from '@sapphire/utilities';\nimport { createClassDecorator, createProxy } from './utils';\n\n/**\n * Decorator function that applies given options to any Sapphire piece\n * @param options The options to pass to the piece constructor\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import type { Message } from 'discord.js';\n *\n * @ApplyOptions<Command.Options>({\n *   description: 'ping pong',\n *   enabled: true\n * })\n * export class UserCommand extends Command {\n *   public override async messageRun(message: Message) {\n *     const msg = await message.channel.send('Ping?');\n *\n *     return msg.edit(\n *       `Pong! Client Latency ${Math.round(this.container.client.ws.ping)}ms. API Latency ${msg.createdTimestamp - message.createdTimestamp}ms.`\n *     );\n *   }\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Listener } from '@sapphire/framework';\n * import { GatewayDispatchEvents, GatewayMessageDeleteDispatch } from 'discord.js';\n *\n * @ApplyOptions<Listener.Options>(({ container }) => ({\n *   description: 'Handle Raw Message Delete events',\n *   emitter: container.client.ws,\n *   event: GatewayDispatchEvents.MessageDelete\n * }))\n * export class UserListener extends Listener {\n *   public override run(data: GatewayMessageDeleteDispatch['d']): void {\n *     if (!data.guild_id) return;\n *\n *     const guild = this.container.client.guilds.cache.get(data.guild_id);\n *     if (!guild || !guild.channels.cache.has(data.channel_id)) return;\n *\n *     // Do something with the data\n *   }\n * }\n * ```\n */\nexport function ApplyOptions<T extends Piece.Options>(optionsOrFn: T | ((parameters: ApplyOptionsCallbackParameters) => T)): ClassDecorator {\n\treturn createClassDecorator((target: Ctor<ConstructorParameters<typeof Piece>, Piece>) =>\n\t\tcreateProxy(target, {\n\t\t\tconstruct: (ctor, [context, baseOptions = {}]: [Piece.Context, Piece.Options]) =>\n\t\t\t\tnew ctor(context, {\n\t\t\t\t\t...baseOptions,\n\t\t\t\t\t...(typeof optionsOrFn === 'function' ? optionsOrFn({ container, context }) : optionsOrFn)\n\t\t\t\t})\n\t\t})\n\t);\n}\n\nexport interface ApplyOptionsCallbackParameters {\n\tcontainer: Container;\n\tcontext: Piece.Context;\n}\n"]}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils.ts","../src/base-decorators.ts","../src/djs-decorators.ts","../src/piece-decorators.ts"],"names":["target","DecoratorIdentifiers"],"mappings":"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","sourcesContent":["/**\n * The function precondition interface.\n */\nexport interface FunctionPrecondition {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): boolean | Promise<boolean>;\n}\n\n/**\n * The fallback interface, this is called when the function precondition returns or resolves with a falsy value.\n */\nexport interface FunctionFallback {\n\t/**\n\t * The arguments passed to the function or class' method.\n\t */\n\t(...args: any[]): unknown;\n}\n\n/**\n * Utility to make a method decorator with lighter syntax and inferred types.\n *\n * ```typescript\n * // Enumerable function\n *\tfunction enumerableMethod(value: boolean) {\n *\t\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n *\t\t\tdescriptor.enumerable = value;\n *\t\t});\n *\t}\n * ```\n * @param fn The method to decorate\n */\nexport function createMethodDecorator(fn: MethodDecorator): MethodDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make a class decorator with lighter syntax and inferred types.\n * @param fn The class to decorate\n * @see {@link ApplyOptions}\n */\nexport function createClassDecorator<TFunction extends (...args: any[]) => void>(fn: TFunction): ClassDecorator {\n\treturn fn;\n}\n\n/**\n * Utility to make function preconditions.\n *\n * ```typescript\n * // No fallback (returns undefined)\n * function requireGuild(value: number) {\n *   return createFunctionPrecondition((message: Message) =>\n *     message.guild !== null\n *   );\n * }\n *\n * // With fallback\n * function requireGuild(\n *   value: number,\n *   fallback: () => unknown = () => undefined\n * ) {\n *   return createFunctionPrecondition(\n *     (message: Message) => message.guild !== null,\n *     fallback\n *   );\n * }\n * ```\n * @since 1.0.0\n * @param precondition The function that defines whether or not the function should be run, returning the returned value from fallback\n * @param fallback The fallback value that defines what the method should return in case the precondition fails\n */\nexport function createFunctionPrecondition(precondition: FunctionPrecondition, fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tconst method = descriptor.value;\n\t\tif (!method) throw new Error('Function preconditions require a [[value]].');\n\t\tif (typeof method !== 'function') throw new Error('Function preconditions can only be applied to functions.');\n\n\t\tdescriptor.value = async function descriptorValue(this: (...args: any[]) => any, ...args: any[]) {\n\t\t\tconst canRun = await precondition(...args);\n\t\t\treturn canRun ? method.call(this, ...args) : fallback.call(this, ...args);\n\t\t} as unknown as undefined;\n\t});\n}\n\n/**\n * Creates a new proxy to efficiently add properties to class without creating subclasses\n * @param target The constructor of the class to modify\n * @param handler The handler function to modify the constructor behavior for the target\n * @hidden\n */\nexport function createProxy<T extends object>(target: T, handler: Omit<ProxyHandler<T>, 'get'>): T {\n\treturn new Proxy(target, {\n\t\t...handler,\n\t\tget: (target, property) => {\n\t\t\tconst value = Reflect.get(target, property);\n\t\t\treturn typeof value === 'function' ? (...args: readonly unknown[]) => value.apply(target, args) : value;\n\t\t}\n\t});\n}\n","import type { NonNullObject } from '@sapphire/utilities';\nimport { createMethodDecorator } from './utils';\n\n/**\n * Decorator that sets the enumerable property of a class field to the desired value.\n * @param value Whether the property should be enumerable or not\n */\nexport function Enumerable(value: boolean) {\n\treturn (target: unknown, key: string) => {\n\t\tReflect.defineProperty(target as NonNullObject, key, {\n\t\t\tenumerable: value,\n\t\t\tset(this: unknown, val: unknown) {\n\t\t\t\tReflect.defineProperty(this as NonNullObject, key, {\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\tenumerable: value,\n\t\t\t\t\tvalue: val,\n\t\t\t\t\twritable: true\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\t};\n}\n\n/**\n * Decorator that sets the enumerable property of a class method to the desired value.\n * @param value Whether the method should be enumerable or not\n */\nexport function EnumerableMethod(value: boolean) {\n\treturn createMethodDecorator((_target, _propertyKey, descriptor) => {\n\t\tdescriptor.enumerable = value;\n\t});\n}\n","import { isDMChannel, isGuildBasedChannel } from '@sapphire/discord.js-utilities';\nimport { UserError } from '@sapphire/framework';\nimport { Message, PermissionFlagsBits, PermissionsBitField, type PermissionResolvable } from 'discord.js';\nimport { createFunctionPrecondition, type FunctionFallback } from './utils';\n\nexport enum DecoratorIdentifiers {\n\tRequiresClientPermissionsGuildOnly = 'requiresClientPermissionsGuildOnly',\n\tRequiresClientPermissionsMissingPermissions = 'requiresClientPermissionsMissingPermissions',\n\tRequiresUserPermissionsGuildOnly = 'requiresUserPermissionsGuildOnly',\n\tRequiresUserPermissionsMissingPermissions = 'requiresUserPermissionsMissingPermissions'\n}\n\nconst DMAvailablePermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\t//\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel\n\t]).bitfield & PermissionsBitField.All\n);\n\nconst DMAvailableUserPermissions = new PermissionsBitField(\n\t~new PermissionsBitField([\n\t\tPermissionFlagsBits.AddReactions,\n\t\tPermissionFlagsBits.AttachFiles,\n\t\tPermissionFlagsBits.EmbedLinks,\n\t\tPermissionFlagsBits.ReadMessageHistory,\n\t\tPermissionFlagsBits.SendMessages,\n\t\tPermissionFlagsBits.UseExternalEmojis,\n\t\tPermissionFlagsBits.ViewChannel,\n\t\tPermissionFlagsBits.UseExternalStickers,\n\t\tPermissionFlagsBits.MentionEveryone\n\t]).bitfield & PermissionsBitField.All\n);\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the client that is to execute the command. For setting permissions required user of the command see {@link RequiresUserPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresClientPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresClientPermissions('BAN_MEMBERS') // This subcommand requires the client to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresClientPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailablePermissions.bitfield);\n\n\treturn createFunctionPrecondition((message: Message) => {\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(message.channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because I do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(message.channel)) {\n\t\t\tconst missingPermissions = message.channel.permissionsFor(message.guild!.members.me!).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresClientPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but I am not allowed to do that. I am missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Allows you to set permissions required for individual methods. This is particularly useful for subcommands that require specific permissions.\n * @remark This decorator applies to the user of the command. For setting permissions required for the client see {@link RequiresClientPermissions}\n * @remark This decorator makes the decorated function asynchronous, so any result should be `await`ed.\n * @param permissionsResolvable Permissions that the method should have.\n * @example\n * ```typescript\n * import { ApplyOptions, RequiresUserPermissions } from '@sapphire/decorators';\n * import { Subcommand } from '@sapphire/plugin-subcommands';\n * import type { Message } from 'discord.js';\n *\n * (at)ApplyOptions<Subcommand.Options>({\n * \taliases: ['cws'],\n * \tdescription: 'A basic command with some subcommands',\n * \tsubCommands: ['add', 'remove', 'reset', { input: 'show', default: true }]\n * })\n * export default class extends Subcommand {\n *     // Anyone should be able to view the result, but not modify\n * \tpublic async show(message: Message) {\n * \t\treturn message.channel.send('Showing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async add(message: Message) {\n * \t\treturn message.channel.send('Adding!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async remove(message: Message) {\n * \t\treturn message.channel.send('Removing!');\n * \t}\n *\n * \t(at)RequiresUserPermissions('BAN_MEMBERS') // This subcommand requires the user of the command to be able to ban members.\n * \tpublic async reset(message: Message) {\n * \t\treturn message.channel.send('Resetting!');\n * \t}\n * }\n * ```\n */\nexport const RequiresUserPermissions = (...permissionsResolvable: PermissionResolvable[]): MethodDecorator => {\n\tconst resolved = new PermissionsBitField(permissionsResolvable);\n\tconst resolvedIncludesServerPermissions = Boolean(resolved.bitfield & DMAvailableUserPermissions.bitfield);\n\n\treturn createFunctionPrecondition((message: Message) => {\n\t\tif (resolvedIncludesServerPermissions && isDMChannel(message.channel)) {\n\t\t\tthrow new UserError({\n\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsGuildOnly,\n\t\t\t\tmessage: 'Sorry, but that command can only be used in a server because you do not have sufficient permissions in DMs'\n\t\t\t});\n\t\t}\n\n\t\tif (isGuildBasedChannel(message.channel)) {\n\t\t\tconst missingPermissions = message.channel.permissionsFor(message.member!).missing(resolved);\n\n\t\t\tif (missingPermissions.length) {\n\t\t\t\tthrow new UserError({\n\t\t\t\t\tidentifier: DecoratorIdentifiers.RequiresUserPermissionsMissingPermissions,\n\t\t\t\t\tmessage: `Sorry, but you are not allowed to do that. You are missing the permissions: ${missingPermissions}`,\n\t\t\t\t\tcontext: {\n\t\t\t\t\t\tmissing: missingPermissions\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\n/**\n * Requires the message to be run in a guild context, this decorator requires the first argument to be a `Message` instance\n * @since 1.0.0\n * @param fallback The fallback value passed to `createFunctionInhibitor`\n */\nexport function RequiresGuildContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((message: Message) => message.guild !== null, fallback);\n}\n\n/**\n * Requires the message to be run in a dm context, this decorator requires the first argument to be a `Message` instance\n * @since 1.0.0\n * @param fallback The fallback value passed to `createFunctionInhibitor`\n */\nexport function RequiresDMContext(fallback: FunctionFallback = (): void => undefined): MethodDecorator {\n\treturn createFunctionPrecondition((message: Message) => message.guild === null, fallback);\n}\n","import { container, type Piece } from '@sapphire/framework';\nimport type { Container } from '@sapphire/pieces';\nimport type { Ctor } from '@sapphire/utilities';\nimport { createClassDecorator, createProxy } from './utils';\n\n/**\n * Decorator function that applies given options to any Sapphire piece\n * @param options The options to pass to the piece constructor\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Command } from '@sapphire/framework';\n * import type { Message } from 'discord.js';\n *\n * @ApplyOptions<Command.Options>({\n *   description: 'ping pong',\n *   enabled: true\n * })\n * export class UserCommand extends Command {\n *   public override async messageRun(message: Message) {\n *     const msg = await message.channel.send('Ping?');\n *\n *     return msg.edit(\n *       `Pong! Client Latency ${Math.round(this.container.client.ws.ping)}ms. API Latency ${msg.createdTimestamp - message.createdTimestamp}ms.`\n *     );\n *   }\n * }\n * ```\n * @example\n * ```typescript\n * import { ApplyOptions } from '@sapphire/decorators';\n * import { Listener } from '@sapphire/framework';\n * import { GatewayDispatchEvents, GatewayMessageDeleteDispatch } from 'discord.js';\n *\n * @ApplyOptions<Listener.Options>(({ container }) => ({\n *   description: 'Handle Raw Message Delete events',\n *   emitter: container.client.ws,\n *   event: GatewayDispatchEvents.MessageDelete\n * }))\n * export class UserListener extends Listener {\n *   public override run(data: GatewayMessageDeleteDispatch['d']): void {\n *     if (!data.guild_id) return;\n *\n *     const guild = this.container.client.guilds.cache.get(data.guild_id);\n *     if (!guild || !guild.channels.cache.has(data.channel_id)) return;\n *\n *     // Do something with the data\n *   }\n * }\n * ```\n */\nexport function ApplyOptions<T extends Piece.Options>(optionsOrFn: T | ((parameters: ApplyOptionsCallbackParameters) => T)): ClassDecorator {\n\treturn createClassDecorator((target: Ctor<ConstructorParameters<typeof Piece>, Piece>) =>\n\t\tcreateProxy(target, {\n\t\t\tconstruct: (ctor, [context, baseOptions = {}]: [Piece.Context, Piece.Options]) =>\n\t\t\t\tnew ctor(context, {\n\t\t\t\t\t...baseOptions,\n\t\t\t\t\t...(typeof optionsOrFn === 'function' ? optionsOrFn({ container, context }) : optionsOrFn)\n\t\t\t\t})\n\t\t})\n\t);\n}\n\nexport interface ApplyOptionsCallbackParameters {\n\tcontainer: Container;\n\tcontext: Piece.Context;\n}\n"]}