@seedcord/core 0.1.0-next.6 → 0.1.0-next.8

package/dist/{permissions-RVCBhL2n.mjs → cursor-BvSH8tgw.mjs}

@@ -1,45 +1,173 @@
+import { d as InteractionRouteKeys, f as InteractionRoutes, g as contextMenuLeaves, i as BuilderComponent, u as InteractionMetadataKey } from "./publishDefault-CldnxcT2.mjs";
 import "reflect-metadata";
+import { SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
+import { Logger, paint } from "@seedcord/logger";
+import { routeLeavesOf } from "@seedcord/utils/internal";
+import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
 import { SeedcordErrorCode } from "@seedcord/errors";
-import { SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
-import { ApplicationCommandType, InteractionContextType, PermissionFlagsBits } from "discord-api-types/v10";
-import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
+import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
 import { prettify, toEpochSeconds } from "@seedcord/utils";
 
-//#region src/metadataKeys.ts
-let InteractionRoutes = /* @__PURE__ */ function(InteractionRoutes) {
-	InteractionRoutes["Slash"] = "slash";
-	InteractionRoutes["Button"] = "button";
-	InteractionRoutes["Modal"] = "modal";
-	InteractionRoutes["StringMenu"] = "stringMenu";
-	InteractionRoutes["UserMenu"] = "userMenu";
-	InteractionRoutes["RoleMenu"] = "roleMenu";
-	InteractionRoutes["ChannelMenu"] = "channelMenu";
-	InteractionRoutes["MentionableMenu"] = "mentionableMenu";
-	InteractionRoutes["MessageContextMenu"] = "messageContextMenu";
-	InteractionRoutes["UserContextMenu"] = "userContextMenu";
-	InteractionRoutes["Autocomplete"] = "autocomplete";
-	return InteractionRoutes;
-}({});
-const InteractionMetadataKey = Symbol("seedcord:interaction:metadata");
-const InteractionRouteKeys = {
-	["slash"]: Symbol("seedcord:interaction:slash"),
-	["button"]: Symbol("seedcord:interaction:button"),
-	["modal"]: Symbol("seedcord:interaction:modal"),
-	["stringMenu"]: Symbol("seedcord:interaction:stringMenu"),
-	["userMenu"]: Symbol("seedcord:interaction:userMenu"),
-	["roleMenu"]: Symbol("seedcord:interaction:roleMenu"),
-	["channelMenu"]: Symbol("seedcord:interaction:channelMenu"),
-	["mentionableMenu"]: Symbol("seedcord:interaction:mentionableMenu"),
-	["messageContextMenu"]: Symbol("seedcord:interaction:messageContextMenu"),
-	["userContextMenu"]: Symbol("seedcord:interaction:userContextMenu"),
-	["autocomplete"]: Symbol("seedcord:interaction:autocomplete")
+//#region src/miscellaneous/guarded.ts
+/**
+* A backing record for a generated accessor. Null-prototype, on a plain object a key named `__proto__` sets
+* the store's prototype and adds no entry.
+*
+* @internal
+*/
+function accessorStore() {
+	return Object.create(null);
+}
+/** Empties a store in place, keeping the reference the accessor's Proxy wraps. @internal */
+function clearStore(store) {
+	for (const key of Object.keys(store)) Reflect.deleteProperty(store, key);
+}
+/**
+* Wraps a generated accessor's backing record so a read of an absent key throws. Handler modules import before
+* startup fills the record, and an unguarded read there returns `undefined` and renders as an empty string.
+*
+* @internal
+*/
+function guardedAccessor(accessor, storage) {
+	return new Proxy(storage, { get(target, key, receiver) {
+		if (typeof key !== "string" || Object.hasOwn(target, key)) return Reflect.get(target, key, receiver);
+		throw new SeedcordError(SeedcordErrorCode.CoreAccessorUnresolved, [accessor, key]);
+	} });
+}
+
+//#endregion
+//#region src/commands/CommandInjector.ts
+const commandStorage = accessorStore();
+const userMenuStorage = accessorStore();
+const messageMenuStorage = accessorStore();
+/**
+* The bot's deployed slash commands, keyed by {@link SlashOptionRegistry}. Filled by
+* {@link CommandInjector} after each deploy, and a read before that throws.
+*
+* @example
+* ```ts
+* import { Commands } from '@seedcord/gateway';
+*
+* await this.reply(`Try ${Commands['config/set'].mention}`);
+*
+* // a help listing
+* const lines = Object.values(Commands).map((c) => `${c.mention} ${c.description}`);
+* ```
+*/
+const Commands = guardedAccessor("Commands", commandStorage);
+/**
+* The bot's deployed context-menu commands. Filled by {@link CommandInjector} after each deploy, and a read
+* before that throws.
+*
+* @example
+* ```ts
+* import { ContextMenus } from '@seedcord/gateway';
+*
+* const id = ContextMenus.user['View Profile'].id;
+* ```
+*/
+const ContextMenus = {
+	user: guardedAccessor("ContextMenus.user", userMenuStorage),
+	message: guardedAccessor("ContextMenus.message", messageMenuStorage)
+};
+const MULTI_GUILD = Symbol("seedcord:commands:multi-guild");
+function commandKey(type, name) {
+	return `${type}:${name}`;
+}
+function slashBuildersOf(all) {
+	const slash = all.filter((command) => command instanceof SlashCommandBuilder);
+	return [...new Set(slash)];
+}
+/**
+* Records each deployed command on {@link Commands} and {@link ContextMenus}.
+*
+* @internal
+*/
+var CommandInjector = class {
+	logger = new Logger("Commands", { channel: "bot" });
+	inject(deploy, all) {
+		this.clear();
+		const ids = {
+			global: this.indexByKey(deploy.global),
+			guild: this.indexGuilds(deploy.guilds),
+			warned: /* @__PURE__ */ new Set()
+		};
+		let clickable = 0;
+		for (const command of slashBuildersOf(all)) {
+			const id = this.resolveId(ApplicationCommandType.ChatInput, command.name, ids, "falling back to plain text (not clickable)");
+			for (const leaf of routeLeavesOf(command.toJSON())) {
+				commandStorage[leaf.route] = {
+					mention: id ? this.toMention(leaf.route, id) : this.toPlain(leaf.route),
+					...id && { id },
+					route: leaf.route,
+					description: leaf.description
+				};
+				if (id) clickable++;
+			}
+		}
+		const menus = contextMenuLeaves(all);
+		this.injectMenus(menus.user, ApplicationCommandType.User, userMenuStorage, ids);
+		this.injectMenus(menus.message, ApplicationCommandType.Message, messageMenuStorage, ids);
+		this.logger.utils.summary("Linked commands", {
+			clickable,
+			plain: Object.keys(commandStorage).length - clickable,
+			"context menus": menus.user.size + menus.message.size
+		});
+	}
+	injectMenus(names, kind, storage, ids) {
+		for (const name of names) {
+			const id = this.resolveId(kind, name, ids, "leaving its id unset");
+			storage[name] = {
+				...id && { id },
+				name,
+				kind
+			};
+		}
+	}
+	indexByKey(collection) {
+		const map = /* @__PURE__ */ new Map();
+		for (const command of collection.values()) map.set(commandKey(command.type, command.name), command.id);
+		return map;
+	}
+	indexGuilds(guilds) {
+		const map = /* @__PURE__ */ new Map();
+		for (const collection of guilds.values()) for (const command of collection.values()) {
+			const key = commandKey(command.type, command.name);
+			const existing = map.get(key);
+			if (existing === void 0) map.set(key, command.id);
+			else if (existing !== command.id) map.set(key, MULTI_GUILD);
+		}
+		return map;
+	}
+	resolveId(type, name, ids, consequence) {
+		const key = commandKey(type, name);
+		const global = ids.global.get(key);
+		if (global) return global;
+		const guild = ids.guild.get(key);
+		if (guild === void 0) return void 0;
+		if (guild === MULTI_GUILD) {
+			if (!ids.warned.has(key)) {
+				this.logger.warn(`${paint.sky.bold(name)} is deployed to multiple guilds, ${consequence}.`);
+				ids.warned.add(key);
+			}
+			return;
+		}
+		return guild;
+	}
+	toMention(route, id) {
+		return `</${route.replaceAll("/", " ")}:${id}>`;
+	}
+	toPlain(route) {
+		return `/${route.replaceAll("/", " ")}`;
+	}
+	clear() {
+		for (const store of [
+			commandStorage,
+			userMenuStorage,
+			messageMenuStorage
+		]) clearStore(store);
+	}
 };
-const MiddlewareMetadataKey = Symbol("seedcord:middleware:metadata");
-const EventMetadataKey = Symbol("seedcord:event:metadata");
-const CommandMetadataKey = Symbol("seedcord:command:metadata");
-const GatedMetadataKey = Symbol("seedcord:gated:metadata");
-const SubscribeMetadataKey = Symbol("seedcord:subscribe:metadata");
-const WebhookUrlMetadataKey = Symbol("seedcord:webhookUrl:metadata");
 
 //#endregion
 //#region src/stops/Notice.ts
@@ -107,202 +235,6 @@ var Notice = class extends Error {
 	}
 };
 
-//#endregion
-//#region src/components/botColorHolder.ts
-const DEFAULT_COLOR = "Default";
-let current = DEFAULT_COLOR;
-function setBotColor(color) {
-	current = color ?? DEFAULT_COLOR;
-}
-function getBotColor() {
-	return current;
-}
-
-//#endregion
-//#region src/components/builderTypes.ts
-/**
-* Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
-*
-* @internal
-*/
-const BuilderTypes = {
-	command: SlashCommandBuilder,
-	context_menu: ContextMenuCommandBuilder,
-	subcommand: SlashCommandSubcommandBuilder,
-	group: SlashCommandSubcommandGroupBuilder,
-	embed: EmbedBuilder,
-	modal: ModalBuilder,
-	label: LabelBuilder,
-	text_input: TextInputBuilder,
-	file_upload: FileUploadBuilder,
-	checkbox: CheckboxBuilder,
-	checkbox_group: CheckboxGroupBuilder,
-	checkbox_group_option: CheckboxGroupOptionBuilder,
-	radio_group: RadioGroupBuilder,
-	radio_group_option: RadioGroupOptionBuilder,
-	button: ButtonBuilder,
-	menu_string: StringSelectMenuBuilder,
-	menu_option_string: StringSelectMenuOptionBuilder,
-	menu_user: UserSelectMenuBuilder,
-	menu_channel: ChannelSelectMenuBuilder,
-	menu_mentionable: MentionableSelectMenuBuilder,
-	menu_role: RoleSelectMenuBuilder,
-	container: ContainerBuilder,
-	text_display: TextDisplayBuilder,
-	file: FileBuilder,
-	media: MediaGalleryBuilder,
-	section: SectionBuilder,
-	separator: SeparatorBuilder
-};
-/**
-* Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
-*
-* @internal
-*/
-const RowTypes = {
-	button: ActionRowBuilder,
-	menu_string: ActionRowBuilder,
-	menu_user: ActionRowBuilder,
-	menu_channel: ActionRowBuilder,
-	menu_mentionable: ActionRowBuilder,
-	menu_role: ActionRowBuilder
-};
-
-//#endregion
-//#region src/components/colors.ts
-const Colors = {
-	Aqua: 1752220,
-	Blue: 3447003,
-	Blurple: 5793266,
-	DarkAqua: 1146986,
-	DarkBlue: 2123412,
-	DarkButNotBlack: 2895667,
-	DarkerGrey: 8359053,
-	DarkGold: 12745742,
-	DarkGreen: 2067276,
-	DarkGrey: 9936031,
-	DarkNavy: 2899536,
-	DarkOrange: 11027200,
-	DarkPurple: 7419530,
-	DarkRed: 10038562,
-	DarkVividPink: 11342935,
-	Default: 0,
-	Fuchsia: 15418782,
-	Gold: 15844367,
-	Green: 5763719,
-	Grey: 9807270,
-	Greyple: 10070709,
-	LightGrey: 12370112,
-	LuminousVividPink: 15277667,
-	Navy: 3426654,
-	NotQuiteBlack: 2303786,
-	Orange: 15105570,
-	Purple: 10181046,
-	Red: 15548997,
-	White: 16777215,
-	Yellow: 16705372
-};
-
-//#endregion
-//#region src/components/resolveColor.ts
-const MAX_COLOR = 16777215;
-const RED_SHIFT = 16;
-const GREEN_SHIFT = 8;
-const palette = Colors;
-/**
-* Resolves a {@link BotColor} to the integer Discord expects.
-*
-* Ported from discord.js (Apache-2.0), `resolveColor` in src/util/Util.js.
-*/
-function resolveColor(color) {
-	let resolved;
-	if (typeof color === "string") {
-		if (color === "Random") return Math.floor(Math.random() * 16777216);
-		if (color === "Default") return 0;
-		if (/^#?[\da-f]{6}$/i.test(color)) return Number.parseInt(color.replace("#", ""), 16);
-		resolved = palette[color];
-	} else if (typeof color === "number") resolved = color;
-	else resolved = (color[0] << RED_SHIFT) + (color[1] << GREEN_SHIFT) + color[2];
-	if (resolved === void 0 || !Number.isSafeInteger(resolved)) throw new SeedcordTypeError(SeedcordErrorCode.ColorUnresolvable, [JSON.stringify(color)]);
-	if (resolved < 0 || resolved > MAX_COLOR) throw new SeedcordRangeError(SeedcordErrorCode.ColorOutOfRange);
-	return resolved;
-}
-
-//#endregion
-//#region src/components/Component.ts
-/**
-* Base class for Discord component wrappers.
-*
-* @typeParam TComponent - The Discord.js component type being wrapped
-*
-* @internal
-*/
-var BaseComponent = class {
-	_component;
-	constructor(ComponentClass) {
-		this._component = new ComponentClass();
-	}
-	/**
-	* The wrapped builder, for calling Discord.js methods like setTitle() and setDescription() inside a subclass.
-	*
-	* @example this.instance.setTitle('My Modal')
-	*/
-	get instance() {
-		return this._component;
-	}
-};
-/**
-* Base class for Discord.js builder components
-*
-* Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with
-* Seedcord-specific defaults and helper methods.
-*
-* @typeParam BuilderKey - The type of Discord.js builder being wrapped
-*/
-var BuilderComponent = class extends BaseComponent {
-	type;
-	colorApplied = false;
-	constructor(type) {
-		const ComponentClass = BuilderTypes[type];
-		super(ComponentClass);
-		this.type = type;
-		if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) this.instance.setContexts(InteractionContextType.Guild);
-	}
-	get component() {
-		this.applyBotColor();
-		return this.instance;
-	}
-	applyBotColor() {
-		if (this.colorApplied) return;
-		this.colorApplied = true;
-		const color = getBotColor();
-		if (this.instance instanceof EmbedBuilder) {
-			if (this.instance.data.color === void 0) this.instance.setColor(resolveColor(color));
-		} else if (this.instance instanceof ContainerBuilder) {
-			const accent = this.instance.data.accent_color;
-			if (accent === null || accent === void 0) this.instance.setAccentColor(color === "Default" ? void 0 : resolveColor(color));
-		}
-	}
-};
-/**
-* Base class for Discord action row components
-*
-* Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.
-*
-* @typeParam RowKey - The Discord.js action row type being wrapped
-*/
-var RowComponent = class extends BaseComponent {
-	type;
-	constructor(type) {
-		const ComponentClass = RowTypes[type];
-		super(ComponentClass);
-		this.type = type;
-	}
-	get component() {
-		return this.instance;
-	}
-};
-
 //#endregion
 //#region src/stops/NoticeCard.ts
 /**
@@ -955,6 +887,21 @@ var MissingPermissions = class extends Notice {
 		return { components: [new NoticeCard(`${this.customLead ?? `${this.subject === null ? "You are" : `${this.subject} is`} missing the following permission entries:`}\n\n${bullets}`).component] };
 	}
 };
+var HasDangerousPermissions = class extends Notice {
+	subject;
+	dangerousPerms;
+	customLead;
+	constructor(message, subject, dangerousPerms) {
+		super(message ?? "A dangerous permission is enabled.");
+		this.subject = subject;
+		this.dangerousPerms = dangerousPerms;
+		this.customLead = message;
+	}
+	render() {
+		const bullets = this.dangerousPerms.map((perm) => `• ${perm}`).join("\n");
+		return { components: [new NoticeCard(`${this.customLead ?? `${this.subject} has the following permission entries that must not be enabled:`}\n\n${bullets}`).component] };
+	}
+};
 
 //#endregion
 //#region src/gates/effects.ts
@@ -995,10 +942,37 @@ function pickNotice(options, makeDefault) {
 }
 
 //#endregion
-//#region src/gates/catalog/permissions.ts
-/** Permission bit to its prettified human-readable name, for the missing-permission refusal. */
+//#region src/permissions/bits.ts
+/** Permission bit to its prettified human-readable name. */
 const PermissionNames = new Map(Object.entries(PermissionFlagsBits).map(([key, bit]) => [bit, prettify(key)]));
 const ADMINISTRATOR = PermissionFlagsBits.Administrator;
+function nameOf(bit) {
+	return PermissionNames.get(bit) ?? String(bit);
+}
+function holds(held, bit) {
+	return (held & ADMINISTRATOR) === ADMINISTRATOR || (held & bit) === bit;
+}
+/** @internal */
+function hasAll(held, scope) {
+	return scope.every((bit) => holds(held, bit));
+}
+/** @internal only reached once hasAll failed, so the administrator bit is absent */
+function missingNames(held, scope) {
+	return scope.reduce((names, bit) => {
+		if ((held & bit) !== bit) names.push(nameOf(bit));
+		return names;
+	}, []);
+}
+/** @internal */
+function presentNames(held, scope) {
+	return scope.reduce((names, bit) => {
+		if (holds(held, bit)) names.push(nameOf(bit));
+		return names;
+	}, []);
+}
+
+//#endregion
+//#region src/gates/catalog/permissions.ts
 const MEMBER_CHECK = {
 	unresolved: "Your server member data could not be resolved. Try again.",
 	subject: null
@@ -1007,16 +981,6 @@ const BOT_CHECK = {
 	unresolved: "The bot's permissions could not be resolved. Try again.",
 	subject: "The bot"
 };
-function hasAll(held, scope) {
-	if ((held & ADMINISTRATOR) === ADMINISTRATOR) return true;
-	return scope.every((bit) => (held & bit) === bit);
-}
-function missingNames(held, scope) {
-	return scope.reduce((names, bit) => {
-		if ((held & bit) !== bit) names.push(PermissionNames.get(bit) ?? String(bit));
-		return names;
-	}, []);
-}
 function refusePermissions(held, scope, options, guildId, kind) {
 	if (held === null) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message ?? (guildId ? kind.unresolved : void 0)));
 	if (hasAll(held, scope)) return;
@@ -1067,5 +1031,43 @@ function RequireRole(roleId, options) {
 }
 
 //#endregion
-export { decodeComponentRoute as A, EventMetadataKey as B, areRoutes as C, storeComponentRoute as D, selectMenuRouteOf as E, BuilderComponent as F, MiddlewareMetadataKey as G, InteractionMetadataKey as H, RowComponent as I, SubscribeMetadataKey as K, setBotColor as L, decodeFor as M, prefixOf as N, storeInteractionRoute as O, NoticeCard as P, Notice as R, SelectMenuKind as S, interactionRoutesOf as T, InteractionRouteKeys as U, GatedMetadataKey as V, InteractionRoutes as W, NotInGuild as _, pickNotice as a, defineEffectGate as b, rollbackCommits as c, GateNotice as d, MissingPermissions as f, NotInDm as g, NotAllowed as h, RequireRole as i, CustomId as j, ComponentDefsKey as k, runCheck as l, NeedsAny as m, RequireBotPermissions as n, discardCommits as o, MissingRole as p, WebhookUrlMetadataKey as q, RequirePermissions as r, markCommits as s, PermissionNames as t, runCommits as u, NotOwner as v, contextMenuRouteOf as w, defineGate as x, OnCooldown as y, CommandMetadataKey as z };
-//# sourceMappingURL=permissions-RVCBhL2n.mjs.map
+//#region src/stops/Silence.ts
+/**
+* Throw to stop a handler with no reply and no report.
+*
+* The framework boundary catches `Silence` before {@link Notice}, makes zero Discord calls, and stops.
+* Ideally you'd only throw this in `EventHandlers` (or `Gates` for those), because it doesn't make sense to
+* leave the user with no reply for an interaction.
+*
+* @example
+* ```ts
+* import { Silence } from '@seedcord/gateway';
+*
+* // before any reply or defer, drop the interaction with no reply and no report
+* if (await isBlacklisted(interaction.user.id)) throw new Silence('blacklisted user');
+* ```
+*/
+var Silence = class extends Error {
+	reason;
+	/**
+	* @param reason - Optional note written only to a debug log, never shown to the user or reported.
+	*/
+	constructor(reason) {
+		super(reason ?? "Silence");
+		this.reason = reason;
+		Error.captureStackTrace(this, this.constructor);
+	}
+};
+
+//#endregion
+//#region src/pagination/cursor.ts
+const PAGE_MAX = 1e6;
+const SLOT_MAX = 4;
+/** Build the page cursor for a paginator. */
+function pageCursor(prefix) {
+	return new CustomId(prefix).int("page", 0, PAGE_MAX).int("slot", 0, SLOT_MAX);
+}
+
+//#endregion
+export { areRoutes as A, prefixOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, storeInteractionRoute as F, ContextMenus as G, Notice as H, ComponentDefsKey as I, guardedAccessor as J, accessorStore as K, decodeComponentRoute as L, interactionRoutesOf as M, selectMenuRouteOf as N, defineGate as O, storeComponentRoute as P, CustomId as R, NotAllowed as S, NotOwner as T, CommandInjector as U, NoticeCard as V, Commands as W, GateNotice as _, RequirePermissions as a, MissingRole as b, hasAll as c, pickNotice as d, discardCommits as f, runCommits as g, runCheck as h, RequireBotPermissions as i, contextMenuRouteOf as j, SelectMenuKind as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, clearStore as q, Silence as r, PermissionNames as s, PAGE_MAX as t, presentNames as u, HasDangerousPermissions as v, NotInGuild as w, NeedsAny as x, MissingPermissions as y, decodeFor as z };
+//# sourceMappingURL=cursor-BvSH8tgw.mjs.map