@seedcord/core 0.4.1 → 0.6.0

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { A as translateSerializationError, C as NotInDm, D as defineEffectGate, E as OnCooldown, F as checkAckLegality, H as storeComponentRoute, I as sendTarget, K as NoticeCard, L as SelectMenuKind, M as publishResponse, O as defineGate, P as AckTrace, S as NotAllowed, T as NotOwner, U as storeInteractionRoute, V as selectMenuRouteOf, a as RequirePermissions, c as hasAll, d as pickNotice, h as runCheck, i as RequireBotPermissions, j as attemptWrite, k as serializeReply, l as missingNames, m as rollbackCommits, n as pageCursor, o as RequireRole, p as markCommits, q as Notice, r as Silence, t as PAGE_MAX, u as presentNames, v as HasDangerousPermissions, w as NotInGuild, x as NeedsAny, y as MissingPermissions, z as contextMenuRouteOf } from "./cursor-CaT051ii.mjs";
-import { A as RowComponent, d as WebhookLog, f as Subscriber, g as CommandMetadataKey, k as BuilderComponent, l as WebhookUrl, t as Bus, u as Subscribe, x as InteractionRoutes } from "./Bus-yJGE6Fs2.mjs";
-import { n as Commands, r as ContextMenus } from "./subscribers-DVa-Pr45.mjs";
+import { A as translateSerializationError, B as storeComponentRoute, C as NotInDm, D as defineEffectGate, E as OnCooldown, F as checkAckLegality, G as Notice, I as sendTarget, M as publishResponse, O as defineGate, P as AckTrace, R as contextMenuRouteOf, S as NotAllowed, T as NotOwner, V as storeInteractionRoute, W as NoticeCard, a as RequirePermissions, c as hasAll, d as pickNotice, h as runCheck, i as RequireBotPermissions, j as attemptWrite, k as serializeReply, l as missingNames, m as rollbackCommits, n as pageCursor, o as RequireRole, p as markCommits, r as Silence, t as PAGE_MAX, u as presentNames, v as HasDangerousPermissions, w as NotInGuild, x as NeedsAny, y as MissingPermissions } from "./cursor-BkI9lxy2.mjs";
+import { A as RowComponent, d as WebhookLog, f as Subscriber, g as CommandMetadataKey, k as BuilderComponent, l as WebhookUrl, t as Bus, u as Subscribe, y as InteractionKind } from "./Bus-dGy6xq3F.mjs";
+import { n as Commands, r as ContextMenus } from "./subscribers-A8lNU5yM.mjs";
 import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
 import "reflect-metadata";
-import { CustomId, setCustomIdErrors, setCustomIdErrors as setCustomIdErrors$1 } from "@seedcord/custom-id";
+import { CustomId, decodeFor, prefixOf, setCustomIdErrors, setCustomIdErrors as setCustomIdErrors$1 } from "@seedcord/custom-id";
 import { ActionRowBuilder, ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { ApplicationCommandType, ButtonStyle } from "discord-api-types/v10";
 import { SeedcordErrorCode } from "@seedcord/errors";
@@ -193,24 +193,121 @@ function ModalRoute(...defs) {
 	};
 }
 /**
-* Routes select menu interactions to handler classes.
+* Routes string select menu interactions to a `StringMenuHandler`.
 *
-* Pass the select kind and the {@link CustomId} definition(s) this handler decodes. The handler's
-* generic must list the same kind and definitions, or it is a compile error.
+* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
+* generic. The handler reads the chosen option values from `this.values`.
+*
+* @param defs - The customId definition(s) this handler decodes, one per route.
+* @decorator
+* @example
+* ```ts
+* \@StringMenuRoute(TopicsId)
+* class Topics extends StringMenuHandler<[typeof TopicsId]> {
+*     async execute() {
+*         await this.update(`following ${this.values.join(', ')}`);
+*     }
+* }
+* ```
+*/
+function StringMenuRoute(...defs) {
+	return function(constructor) {
+		storeComponentRoute("stringMenu", defs, constructor);
+	};
+}
+/**
+* Routes user select menu interactions to a `UserMenuHandler`.
+*
+* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
+* generic. Beside `this.values` the handler declares `this.users` and `this.members`. Discord resolves
+* the members only inside a guild.
+*
+* @param defs - The customId definition(s) this handler decodes, one per route.
+* @decorator
+* @example
+* ```ts
+* \@UserMenuRoute(AssignId)
+* class Assign extends UserMenuHandler<[typeof AssignId]> {
+*     async execute() {
+*         const { roleId } = this.params;
+*         await this.reply(`assigning ${this.users.size} member(s) to <@&${roleId}>`);
+*     }
+* }
+* ```
+*/
+function UserMenuRoute(...defs) {
+	return function(constructor) {
+		storeComponentRoute("userMenu", defs, constructor);
+	};
+}
+/**
+* Routes role select menu interactions to a `RoleMenuHandler`.
+*
+* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
+* generic. Beside `this.values` the handler declares `this.roles`.
+*
+* @param defs - The customId definition(s) this handler decodes, one per route.
+* @decorator
+* @example
+* ```ts
+* \@RoleMenuRoute(GrantId)
+* class Grant extends RoleMenuHandler<[typeof GrantId]> {
+*     async execute() {
+*         await this.update(`granting ${this.roles.size} role(s)`);
+*     }
+* }
+* ```
+*/
+function RoleMenuRoute(...defs) {
+	return function(constructor) {
+		storeComponentRoute("roleMenu", defs, constructor);
+	};
+}
+/**
+* Routes channel select menu interactions to a `ChannelMenuHandler`.
+*
+* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
+* generic. Beside `this.values` the handler declares `this.channels`.
 *
-* @param type - Select menu kind from {@link SelectMenuKind}.
 * @param defs - The customId definition(s) this handler decodes, one per route.
 * @decorator
+* @example
+* ```ts
+* \@ChannelMenuRoute(LogTargetId)
+* class LogTarget extends ChannelMenuHandler<[typeof LogTargetId]> {
+*     async execute() {
+*         await this.update(`logging to ${this.channels.size} channel(s)`);
+*     }
+* }
+* ```
+*/
+function ChannelMenuRoute(...defs) {
+	return function(constructor) {
+		storeComponentRoute("channelMenu", defs, constructor);
+	};
+}
+/**
+* Routes mentionable select menu interactions to a `MentionableMenuHandler`.
 *
+* Pass the {@link CustomId} definition(s) this handler decodes and list the same ones in the handler's
+* generic. A mentionable menu accepts users and roles together. `this.users`, `this.members`, and
+* `this.roles` can each come back empty.
+*
+* @param defs - The customId definition(s) this handler decodes, one per route.
+* @decorator
 * @example
-* ```typescript
-* \@SelectMenuRoute(SelectMenuKind.User, AssignId)
-* class AssignSelect extends SelectMenuHandler<SelectMenuKind.User, [typeof AssignId]> {}
+* ```ts
+* \@MentionableMenuRoute(InviteId)
+* class Invite extends MentionableMenuHandler<[typeof InviteId]> {
+*     async execute() {
+*         await this.update(`inviting ${this.users.size} user(s) and ${this.roles.size} role(s)`);
+*     }
+* }
 * ```
 */
-function SelectMenuRoute(type, ...defs) {
+function MentionableMenuRoute(...defs) {
 	return function(constructor) {
-		storeComponentRoute(selectMenuRouteOf(type), defs, constructor);
+		storeComponentRoute("mentionableMenu", defs, constructor);
 	};
 }
 
@@ -875,7 +972,7 @@ function paginate(items, page, perPage) {
 }
 
 //#endregion
-//#region src/pagination/controls.ts
+//#region src/pagination/Controls.ts
 const DEFAULT_LABEL = {
 	first: "First",
 	prev: "Prev",
@@ -1080,8 +1177,8 @@ var CursorSourceBase = class {
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.4.1";
+const version = "0.6.0";
 
 //#endregion
-export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RowComponent, SelectMenuKind, SelectMenuRoute, ShutdownPhase, Silence, SlashRoute, StartupPhase, Subscribe, Subscriber, UserContextMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, defineEffectGate, defineGate, mergeRoles, or, paginate, setCustomIdErrors, version };
+export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, ChannelMenuRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, InteractionKind, MentionableMenuRoute, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RoleMenuRoute, RowComponent, ShutdownPhase, Silence, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, Subscriber, UserContextMenuRoute, UserMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, decodeFor, defineEffectGate, defineGate, mergeRoles, or, paginate, prefixOf, setCustomIdErrors, version };
 //# sourceMappingURL=index.mjs.map