@seedcord/core 0.1.3 → 0.2.0-next.0

package/dist/cursor-DFgJ70_B.cjs

@@ -1,1339 +0,0 @@
-const require_publishDefault = require('./publishDefault-D52iT8mF.cjs');
-require("reflect-metadata");
-let _discordjs_builders = require("@discordjs/builders");
-let _seedcord_logger = require("@seedcord/logger");
-let _seedcord_utils_internal = require("@seedcord/utils/internal");
-let discord_api_types_v10 = require("discord-api-types/v10");
-let _seedcord_errors = require("@seedcord/errors");
-let _seedcord_errors_internal = require("@seedcord/errors/internal");
-let _seedcord_utils = require("@seedcord/utils");
-
-//#region src/miscellaneous/guarded.ts
-function accessorStore() {
-	return Object.create(null);
-}
-function clearStore(store) {
-	for (const key of Object.keys(store)) Reflect.deleteProperty(store, key);
-}
-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 _seedcord_errors_internal.SeedcordError(_seedcord_errors.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 _discordjs_builders.SlashCommandBuilder);
-	return [...new Set(slash)];
-}
-/** @internal */
-var CommandInjector = class {
-	logger = new _seedcord_logger.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(discord_api_types_v10.ApplicationCommandType.ChatInput, command.name, ids, "falling back to plain text (not clickable)");
-			for (const leaf of (0, _seedcord_utils_internal.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 = require_publishDefault.contextMenuLeaves(all);
-		this.injectMenus(menus.user, discord_api_types_v10.ApplicationCommandType.User, userMenuStorage, ids);
-		this.injectMenus(menus.message, discord_api_types_v10.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(`${_seedcord_logger.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);
-	}
-};
-
-//#endregion
-//#region src/stops/Notice.ts
-/**
-* Base class for a user-facing refusal or a reported fault.
-*
-* Throw a `Notice` to stop a handler and reply to the user. The framework catches it at the controller
-* boundary and renders {@link Notice.render}, which always decides what the user sees. With `report`
-* false that render is all that happens. With `report` true the framework also logs the fault and
-* publishes it to the `handledException` bus. A raw, non-Notice throw shows the generic message.
-*
-* @example
-* ```ts
-* import { Notice, BuilderComponent, type RenderContext, type ReplyResponse } from '@seedcord/gateway';
-* import { TextDisplayBuilder } from '@discordjs/builders';
-*
-* // reading `.component` applies the configured bot color to the container accent
-* class TooPoorCard extends BuilderComponent<'container'> {
-*     constructor(balance: number) {
-*         super('container');
-*         this.instance.addTextDisplayComponents(
-*             new TextDisplayBuilder().setContent(`### Insufficient balance\nYou need more than ${balance} coins.`)
-*         );
-*     }
-* }
-*
-* class TooPoor extends Notice {
-*     constructor(private readonly balance: number) {
-*         super(`balance ${balance} is below the cost`);
-*     }
-*
-*     render(_ctx: RenderContext): ReplyResponse {
-*         return { components: [new TooPoorCard(this.balance).component] };
-*     }
-* }
-*
-* // in a handler, throwing stops the handler and replies with render(ctx)
-* if (wallet.balance < cost) throw new TooPoor(wallet.balance);
-* ```
-*/
-var Notice = class extends Error {
-	/**
-	* Whether this denial is a reported fault. True also logs it and publishes it to the `handledException`
-	* bus. The user always sees {@link Notice.render} either way.
-	*
-	* @defaultValue `false`
-	*/
-	report = false;
-	/**
-	* Whether the reply is ephemeral, seen only by the invoking user. Set it false for a refusal the
-	* whole channel should see.
-	*
-	* @defaultValue `true`
-	*/
-	ephemeral = true;
-	/**
-	* A short one-line reason. When every arm of an `or` gate refuses and each refusal sets this, `or`
-	* lists them as the reply.
-	*/
-	summary;
-	constructor(message, options) {
-		super(message, options);
-		this.name = new.target.name;
-		Error.captureStackTrace(this, this.constructor);
-	}
-};
-
-//#endregion
-//#region src/stops/NoticeCard.ts
-var NoticeCard = class extends require_publishDefault.BuilderComponent {
-	constructor(description, title = "Cannot Proceed") {
-		super("container");
-		this.instance.addTextDisplayComponents(new _discordjs_builders.TextDisplayBuilder().setContent(`### ${title}\n${description}`));
-	}
-};
-
-//#endregion
-//#region src/customId/Errors.ts
-/**
-* Thrown when a customId was minted by an older version of its shape.
-*
-* This is normal after the shape changes.
-*/
-var StaleCustomId = class extends Notice {
-	constructor(prefix) {
-		super(`Stale customId for "${prefix}".`);
-	}
-	render() {
-		return { components: [new NoticeCard("This button or menu is from an older version. Please run the command again.", "Outdated").component] };
-	}
-};
-/**
-* Thrown when a customId wire is corrupt or tampered with and cannot be trusted.
-*
-* It reports because this is an odd case that should not happen.
-*/
-var InvalidCustomId = class extends Notice {
-	constructor(detail) {
-		super(`Invalid customId. ${detail}`);
-		this.report = true;
-	}
-	render() {
-		return { components: [new NoticeCard("Something went wrong. Please try again.").component] };
-	}
-};
-
-//#endregion
-//#region src/customId/codec.ts
-const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
-const BASE = 64n;
-const CHAR_TO_VALUE = new Map([...ALPHABET].map((char, index) => [char, index]));
-const DELIMITER = "";
-const ESCAPE = "\x1B";
-/** @internal */
-const HASH_LENGTH = 3;
-const SAFE_MAX = BigInt(Number.MAX_SAFE_INTEGER);
-const SAFE_MIN = BigInt(Number.MIN_SAFE_INTEGER);
-function bigintToBase64(value) {
-	if (value === 0n) return ALPHABET.charAt(0);
-	let text = "";
-	for (let remaining = value; remaining > 0n; remaining /= BASE) text = ALPHABET.charAt(Number(remaining % BASE)) + text;
-	return text;
-}
-function base64ToBigint(text) {
-	let value = 0n;
-	for (const char of text) {
-		const digit = CHAR_TO_VALUE.get(char);
-		if (digit === void 0) throw new InvalidCustomId(`bad character ${JSON.stringify(char)}`);
-		value = value * BASE + BigInt(digit);
-	}
-	return value;
-}
-function zigzagEncode(value) {
-	const big = BigInt(value);
-	return big >= 0n ? big << 1n : (-big << 1n) - 1n;
-}
-function zigzagDecode(encoded) {
-	return (encoded & 1n) === 1n ? -(encoded + 1n >> 1n) : encoded >> 1n;
-}
-function escapeToken(text) {
-	return text.replaceAll(/[\x1B\x1F]/g, (char) => ESCAPE + char);
-}
-function unescapeToken(text) {
-	let out = "";
-	for (let i = 0; i < text.length; i++) {
-		if (text.charAt(i) !== ESCAPE) {
-			out += text.charAt(i);
-			continue;
-		}
-		const next = text.charAt(i + 1);
-		if (next === "") throw new InvalidCustomId("dangling escape at end of token");
-		out += next;
-		i++;
-	}
-	return out;
-}
-function splitTokens(body) {
-	const pieces = [];
-	let current = "";
-	for (let i = 0; i < body.length; i++) {
-		const char = body.charAt(i);
-		if (char === ESCAPE) {
-			current += char + body.charAt(i + 1);
-			i++;
-		} else if (char === DELIMITER) {
-			pieces.push(current);
-			current = "";
-		} else current += char;
-	}
-	pieces.push(current);
-	return pieces;
-}
-function isBounded(field) {
-	if (field.kind === "int") return field.min !== void 0 && field.max !== void 0;
-	return field.kind === "snowflake" || field.kind === "uuid" || field.kind === "bool" || field.kind === "oneOf";
-}
-function radixOf(field) {
-	switch (field.kind) {
-		case "snowflake": return 1n << 64n;
-		case "uuid": return 1n << 128n;
-		case "bool": return 2n;
-		case "oneOf":
-			if (!field.choices?.length) throw new InvalidCustomId("oneOf field has no choices");
-			return BigInt(field.choices.length);
-		case "int":
-			if (field.min === void 0 || field.max === void 0) throw new InvalidCustomId("bounded int field is missing a bound");
-			return BigInt(field.max) - BigInt(field.min) + 1n;
-		default: throw new InvalidCustomId(`field kind ${field.kind} has no radix`);
-	}
-}
-function boundedToBigint(field, name, value) {
-	const slot = boundedSlot(field, name, value);
-	if (slot < 0n || slot >= radixOf(field)) outOfRange(name, value);
-	return slot;
-}
-function boundedSlot(field, name, value) {
-	switch (field.kind) {
-		case "snowflake":
-			if (typeof value !== "string" || !/^\d+$/.test(value)) return outOfRange(name, value);
-			return BigInt(value);
-		case "uuid": {
-			if (typeof value !== "string") return outOfRange(name, value);
-			const hex = value.replaceAll("-", "");
-			if (!/^[0-9a-fA-F]{32}$/.test(hex)) return outOfRange(name, value);
-			return BigInt(`0x${hex}`);
-		}
-		case "bool": return value ? 1n : 0n;
-		case "oneOf": {
-			const index = (field.choices ?? []).indexOf(value);
-			return index === -1 ? outOfRange(name, value) : BigInt(index);
-		}
-		case "int":
-			if (!Number.isInteger(value)) return outOfRange(name, value);
-			return BigInt(value - (field.min ?? 0));
-		default: return outOfRange(name, value);
-	}
-}
-function outOfRange(name, value) {
-	throw new _seedcord_errors_internal.SeedcordRangeError(_seedcord_errors.SeedcordErrorCode.CustomIdValueOutOfRange, [name, String(value)]);
-}
-function bigintToBoundedValue(field, slot) {
-	switch (field.kind) {
-		case "snowflake": return slot.toString();
-		case "uuid": return bigintToUuid(slot);
-		case "bool": return slot === 1n;
-		case "oneOf": return (field.choices ?? [])[Number(slot)];
-		case "int": return Number(slot) + (field.min ?? 0);
-		default: throw new InvalidCustomId(`field kind ${field.kind} is not bounded`);
-	}
-}
-function bigintToUuid(value) {
-	const hex = value.toString(16).padStart(32, "0");
-	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-function encodeUnboundedToken(field, name, value) {
-	if (field.kind === "int") {
-		if (!Number.isSafeInteger(value)) outOfRange(name, value);
-		return bigintToBase64(zigzagEncode(value));
-	}
-	return escapeToken(value);
-}
-function decodeUnboundedToken(field, piece) {
-	if (field.kind !== "int") return unescapeToken(piece);
-	if (piece === "") throw new InvalidCustomId("empty integer token");
-	const decoded = zigzagDecode(base64ToBigint(piece));
-	if (decoded > SAFE_MAX || decoded < SAFE_MIN) throw new InvalidCustomId("integer out of safe range");
-	return Number(decoded);
-}
-/** @internal */
-function computeLayoutHash(shape) {
-	const signature = JSON.stringify(Object.entries(shape).map(([name, field]) => [
-		name,
-		field.kind,
-		isBounded(field),
-		field.kind === "oneOf" ? field.choices ?? [] : null,
-		field.kind === "int" ? [field.min ?? null, field.max ?? null] : null
-	]));
-	const modulus = BASE ** BigInt(3);
-	let hash = 0n;
-	for (const char of signature) hash = (hash * 131n + BigInt(char.charCodeAt(0))) % modulus;
-	let text = "";
-	for (let i = 0; i < 3; i++) {
-		text = ALPHABET.charAt(Number(hash % BASE)) + text;
-		hash /= BASE;
-	}
-	return text;
-}
-/** @internal */
-function encodeBody(shape, values) {
-	const fields = Object.entries(shape);
-	const pieces = [];
-	const bounded = fields.filter(([, field]) => isBounded(field));
-	if (bounded.length > 0) {
-		let packed = 0n;
-		for (const [name, field] of bounded) packed = packed * radixOf(field) + boundedToBigint(field, name, values[name]);
-		pieces.push(bigintToBase64(packed));
-	}
-	for (const [name, field] of fields) if (!isBounded(field)) pieces.push(encodeUnboundedToken(field, name, values[name]));
-	return pieces.join(DELIMITER);
-}
-function unpackBounded(bounded, blob, result) {
-	if (blob === void 0 || blob === "") throw new InvalidCustomId("empty packed block");
-	let packed = base64ToBigint(blob);
-	for (const [name, field] of [...bounded].reverse()) {
-		const radix = radixOf(field);
-		result[name] = bigintToBoundedValue(field, packed % radix);
-		packed /= radix;
-	}
-	if (packed !== 0n) throw new InvalidCustomId("leftover bits after unpacking");
-}
-/** @internal */
-function decodeBody(shape, body) {
-	const fields = Object.entries(shape);
-	const bounded = fields.filter(([, field]) => isBounded(field));
-	const unbounded = fields.filter(([, field]) => !isBounded(field));
-	const expected = (bounded.length > 0 ? 1 : 0) + unbounded.length;
-	if (expected === 0) {
-		if (body !== "") throw new InvalidCustomId(`expected an empty body, got ${JSON.stringify(body)}`);
-		return {};
-	}
-	const pieces = splitTokens(body);
-	if (pieces.length !== expected) throw new InvalidCustomId(`expected ${expected} piece(s), got ${pieces.length}`);
-	const result = {};
-	let cursor = 0;
-	if (bounded.length > 0) {
-		unpackBounded(bounded, pieces[cursor], result);
-		cursor++;
-	}
-	for (const [name, field] of unbounded) {
-		const piece = pieces[cursor];
-		cursor++;
-		if (piece === void 0) throw new InvalidCustomId("missing trailing piece");
-		result[name] = decodeUnboundedToken(field, piece);
-	}
-	return result;
-}
-
-//#endregion
-//#region src/customId/CustomId.ts
-const MAX_WIRE_LENGTH = 100;
-function routeKeyOf(wire) {
-	const colon = wire.indexOf(":");
-	return colon === -1 ? "" : wire.slice(0, colon);
-}
-/** Strip the layout hash off the routeKey to recover the stable prefix the controller routes by. @internal */
-function prefixOf(wire) {
-	const key = routeKeyOf(wire);
-	return key.length <= 3 ? "" : key.slice(0, key.length - 3);
-}
-/**
-* A typed customId. The single source of truth shared by the component that mints it and the handler
-* that reads it. This gives you typed reads on the `.customId` field in components. Values are packed
-* into a compact wire string, which fits more of them inside Discord's 100-char limit.
-*
-* @typeParam Prefix - The stable route prefix, e.g. 'approve'.
-* @typeParam Shape - The accumulated fields, filled in by the chain.
-*
-* @example
-* ```ts
-* const ApproveId = new CustomId('approve')
-*     .snowflake('userId')
-*     .oneOf('action', ['approve', 'deny']);
-*
-* // Set the custom id on a button when creating it.
-* new ButtonBuilder().setCustomId(ApproveId.encode({ userId: '123', action: 'approve' }));
-*
-* // in the handler, userId comes back a string
-* const { userId, action } = this.params; // userId: string, action: 'approve' | 'deny'
-* await this.event.guild?.members.fetch(userId);
-* ```
-*/
-var CustomId = class CustomId {
-	/** The stable route prefix, e.g. 'approve'. */
-	prefix;
-	/** The field definitions accumulated by the chain, keyed by name. */
-	shape;
-	/** The prefix plus a short hash of the shape, the part of the wire before the colon. */
-	routeKey;
-	constructor(prefix, shape = {}) {
-		if (!prefix || /[:\x1B\x1F]/.test(prefix)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdInvalidPrefix, [prefix]);
-		this.prefix = prefix;
-		this.shape = shape;
-		this.routeKey = prefix + computeLayoutHash(shape);
-	}
-	add(name, field) {
-		if (/^(?:0|[1-9]\d*)$/.test(name)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdReservedFieldName, [name]);
-		if (name in this.shape) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdDuplicateFieldName, [name]);
-		const shape = {
-			...this.shape,
-			[name]: field
-		};
-		return new CustomId(this.prefix, shape);
-	}
-	/**
-	* Add a Discord ID field, decoded as a string (the `Snowflake` type from discord-api-types).
-	*
-	* @example
-	* ```ts
-	* new CustomId('ban').snowflake('userId');
-	* ```
-	*/
-	snowflake(name) {
-		return this.add(name, { kind: "snowflake" });
-	}
-	/**
-	* Add a UUID field, decoded as a lowercase uuid string.
-	*
-	* @example
-	* ```ts
-	* new CustomId('ticket').uuid('ticketId');
-	* ```
-	*/
-	uuid(name) {
-		return this.add(name, { kind: "uuid" });
-	}
-	int(name, min, max) {
-		if (min !== void 0 && max !== void 0 && min > max) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdInvalidBounds, [
-			name,
-			min,
-			max
-		]);
-		const field = min === void 0 || max === void 0 ? { kind: "int" } : {
-			kind: "int",
-			min,
-			max
-		};
-		return this.add(name, field);
-	}
-	/**
-	* Add a boolean flag.
-	*
-	* @example
-	* ```ts
-	* new CustomId('settings').bool('silent');
-	* ```
-	*/
-	bool(name) {
-		return this.add(name, { kind: "bool" });
-	}
-	/**
-	* Add a field that is one value from a fixed list, decoded as the literal union. No `as const` needed.
-	*
-	* @example
-	* ```ts
-	* new CustomId('poll').oneOf('choice', ['yes', 'no', 'abstain']);
-	* ```
-	*/
-	oneOf(name, choices) {
-		if (choices.length === 0) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdEmptyChoices, [name]);
-		return this.add(name, {
-			kind: "oneOf",
-			choices
-		});
-	}
-	/**
-	* Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
-	* expensive field on the wire.
-	*
-	* @example
-	* ```ts
-	* new CustomId('note').str('message');
-	* ```
-	*/
-	str(name) {
-		return this.add(name, { kind: "string" });
-	}
-	/**
-	* Mint a wire string from values. Throws if a value is out of its field's range or the wire is over 100 chars.
-	*
-	* @param values - One value per field, typed by the chain.
-	* @returns The wire string to put on the component's customId.
-	*/
-	encode(values) {
-		const wire = `${this.routeKey}:${encodeBody(this.shape, values)}`;
-		if (wire.length > MAX_WIRE_LENGTH) throw new _seedcord_errors_internal.SeedcordRangeError(_seedcord_errors.SeedcordErrorCode.CustomIdWireTooLong, [wire.length]);
-		return wire;
-	}
-	/**
-	* Read a wire string back into values.
-	*
-	* - This will refuse with a default Notice when the shape changed since the wire was minted.
-	* - Or refuse with a different default Notice on a corrupt or foreign wire.
-	*
-	* @param wire - The customId string from the interaction.
-	* @returns The decoded values, typed by the chain.
-	*/
-	decode(wire) {
-		const key = routeKeyOf(wire);
-		if (key !== this.routeKey) {
-			if (prefixOf(wire) === this.prefix) throw new StaleCustomId(this.prefix);
-			throw new InvalidCustomId(`routeKey ${JSON.stringify(key)} is not ${JSON.stringify(this.routeKey)}`);
-		}
-		return decodeBody(this.shape, wire.slice(key.length + 1));
-	}
-	/** True if this wire was minted from this customId's prefix, ignoring the shape hash. */
-	owns(wire) {
-		return prefixOf(wire) === this.prefix;
-	}
-};
-/** @internal */
-function decodeFor(defs, wire) {
-	const match = defs.find((def) => def.owns(wire));
-	if (!match) throw new InvalidCustomId(`no customId owns ${JSON.stringify(routeKeyOf(wire))}`);
-	return {
-		prefix: match.prefix,
-		params: match.decode(wire)
-	};
-}
-
-//#endregion
-//#region src/customId/routing.ts
-/**
-* route decorators store a handler's customId defs here, so the component base can decode
-* against them at runtime.
-*
-* @internal
-*/
-const ComponentDefsKey = Symbol("seedcord:customId:componentDefs");
-/**
-* throws `CustomIdHandlerRouteMissing` when the class has no stored defs. a drifted or corrupt wire
-* throws `StaleCustomId` or `InvalidCustomId`.
-*
-* @internal
-*/
-function decodeComponentRoute(handlerClass, wire) {
-	const defs = Reflect.getMetadata(ComponentDefsKey, handlerClass);
-	if (!defs) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdHandlerRouteMissing, [handlerClass.name]);
-	return decodeFor(defs, wire);
-}
-
-//#endregion
-//#region src/decorators/interactionRoutes.ts
-/** The select menu kinds the select route decorators take. */
-let SelectMenuKind = /* @__PURE__ */ function(SelectMenuKind) {
-	SelectMenuKind["String"] = "string";
-	SelectMenuKind["User"] = "user";
-	SelectMenuKind["Role"] = "role";
-	SelectMenuKind["Channel"] = "channel";
-	SelectMenuKind["Mentionable"] = "mentionable";
-	return SelectMenuKind;
-}({});
-function areRoutes(routes) {
-	return Array.isArray(routes) && routes.every((route) => typeof route === "string");
-}
-/**
-* every stored route kind and its route strings on a decorated constructor. the build's manifest
-* emitter reads the same pairs.
-*/
-function interactionRoutesOf(constructor) {
-	const pairs = [];
-	for (const route of Object.values(require_publishDefault.InteractionRoutes)) {
-		const meta = Reflect.getMetadata(require_publishDefault.InteractionRouteKeys[route], constructor);
-		if (areRoutes(meta)) pairs.push([route, meta]);
-	}
-	return pairs;
-}
-function storeInteractionRoute(route, routes, constructor) {
-	const key = require_publishDefault.InteractionRouteKeys[route];
-	const saved = Reflect.getMetadata(key, constructor);
-	const existing = areRoutes(saved) ? saved : [];
-	const toStore = typeof routes === "string" ? [routes] : routes;
-	Reflect.defineMetadata(key, [...existing, ...toStore], constructor);
-	Reflect.defineMetadata(require_publishDefault.InteractionMetadataKey, true, constructor);
-}
-function storeComponentRoute(route, defs, constructor) {
-	storeInteractionRoute(route, defs.map((def) => def.prefix), constructor);
-	Reflect.defineMetadata(ComponentDefsKey, defs, constructor);
-}
-const SELECT_ROUTES = {
-	["string"]: "stringMenu",
-	["user"]: "userMenu",
-	["role"]: "roleMenu",
-	["channel"]: "channelMenu",
-	["mentionable"]: "mentionableMenu"
-};
-function selectMenuRouteOf(kind) {
-	return SELECT_ROUTES[kind];
-}
-function contextMenuRouteOf(kind) {
-	return kind === discord_api_types_v10.ApplicationCommandType.User ? "userContextMenu" : "messageContextMenu";
-}
-
-//#endregion
-//#region src/gates/Gate.ts
-/**
-* Builds a {@link Gate} from a check. The check refuses by throwing a Notice or a Silence and passes
-* by returning. The required context is inferred from `ctx`, so annotate it as narrowly as the fields
-* the check reads. No annotation defaults to {@link GateContextBase}, an agnostic gate that fits every
-* handler.
-*
-* @typeParam Name - The gate's name, captured as a literal for mismatch errors.
-* @typeParam Ctx - The context the check reads, inferred from the `ctx` annotation.
-*
-* @param name - The gate's name, used in mismatch errors.
-* @param fn - The check, which refuses by throwing a Notice or a Silence and passes by returning.
-*
-* @see {@link defineEffectGate}
-* @see the `@Gated` decorator from `seedcord`
-*
-* @example
-* ```ts
-* // a gate factory that takes its own option and closes over it
-* function MinRoles(min: number): Gate<GateContextBase, 'MinRoles'> {
-*     return defineGate('MinRoles', (ctx) => {
-*         if (ctx.memberRoleIds.length < min) throw new NotEnoughRoles(min);
-*     });
-* }
-* ```
-*
-* @example
-* ```ts
-* // agnostic gate (no ctx annotation): fits any handler
-* const Owner = defineGate('owner', (ctx) => {
-*     if (!ctx.userId) throw new NotOwner();
-* });
-* ```
-*/
-function defineGate(name, fn) {
-	return {
-		name,
-		check: async (ctx) => fn(ctx)
-	};
-}
-/**
-* Builds an {@link EffectGate} from a `check` and a `commit`. `check` peeks and refuses by throwing, and
-* `commit` applies the side effect, running only once the whole gate set passes so a later refusal never
-* commits. In an `or`, a refusing arm's queued commit is rolled back. This is how {@link Cooldown} peeks
-* in `check` and charges the slot in `commit`.
-*
-* @typeParam Name - The gate's literal name, used to name a mismatch error.
-* @typeParam Ctx - The context both `check` and `commit` read, inferred from the `ctx` annotation.
-*
-* @param name - The gate's name, used in mismatch errors.
-* @param check - Peeks and refuses by throwing, without applying the side effect.
-* @param commit - Applies the side effect, running only after the whole gate set passes.
-*
-* @see {@link defineGate}
-* @see the `@Gated` decorator from `seedcord`
-* @see {@link Cooldown}
-*
-* @example
-* ```ts
-* // an effect-gate factory that takes its own limit and closes over it
-* function UsesPerDay(max: number): EffectGate<GateContextBase, 'UsesPerDay'> {
-*     return defineEffectGate(
-*         'UsesPerDay',
-*         (ctx) => {
-*             // peek and refuse by throwing. do not mutate yet
-*             if (usedToday(ctx.userId) >= max) throw new OutOfUsesNotice(max);
-*         },
-*         (ctx) => {
-*             // runs only after the whole gate set passes
-*             recordUse(ctx.userId);
-*         }
-*     );
-* }
-* ```
-*/
-function defineEffectGate(name, check, commit) {
-	return {
-		name,
-		check: async (ctx) => check(ctx),
-		commit: async (ctx) => commit(ctx)
-	};
-}
-
-//#endregion
-//#region src/notices/index.ts
-var GateNotice = class extends Notice {
-	render() {
-		return { components: [new NoticeCard(this.message).component] };
-	}
-};
-var NotOwner = class extends GateNotice {
-	constructor(message = "Only the bot owner can use this.") {
-		super(message);
-	}
-};
-var NotInGuild = class extends GateNotice {
-	constructor(message = "This can only be used in a server.") {
-		super(message);
-	}
-};
-var NotInDm = class extends GateNotice {
-	constructor(message = "This can only be used in a direct message.") {
-		super(message);
-	}
-};
-var OnCooldown = class extends GateNotice {
-	resetAt;
-	constructor(resetAt, message) {
-		super(message ?? `You are doing that too fast. Try again <t:${(0, _seedcord_utils.toEpochSeconds)(resetAt)}:R>.`);
-		this.resetAt = resetAt;
-	}
-};
-var NotAllowed = class extends Notice {
-	constructor() {
-		super("not allowed");
-	}
-	render() {
-		return { components: [new NoticeCard("You are not allowed to use this command.").component] };
-	}
-};
-var NeedsAny = class extends Notice {
-	summaries;
-	constructor(summaries) {
-		super("not allowed");
-		this.summaries = summaries;
-	}
-	render() {
-		const bullets = this.summaries.map((summary) => `• ${summary}`).join("\n");
-		return { components: [new NoticeCard(`You need any of:\n${bullets}`).component] };
-	}
-};
-var MissingRole = class extends GateNotice {
-	constructor(message, roleId) {
-		super(message ?? (roleId ? `You need the <@&${roleId}> role to use this.` : "You do not have the required role."));
-	}
-};
-var MissingPermissions = class extends Notice {
-	subject;
-	missingPerms;
-	customLead;
-	constructor(message, subject, missingPerms) {
-		super(message ?? "A required permission is missing.");
-		this.subject = subject;
-		this.missingPerms = missingPerms;
-		this.customLead = message;
-	}
-	render() {
-		const bullets = this.missingPerms.map((perm) => `• ${perm}`).join("\n");
-		const lead = this.customLead ?? `${this.subject === null ? "You are" : `${this.subject} is`} missing the following permission entries:`;
-		return { components: [new NoticeCard(`${lead}\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");
-		const lead = this.customLead ?? `${this.subject} has the following permission entries that must not be enabled:`;
-		return { components: [new NoticeCard(`${lead}\n\n${bullets}`).component] };
-	}
-};
-
-//#endregion
-//#region src/gates/effects.ts
-const commitQueues = /* @__PURE__ */ new WeakMap();
-function isEffectGate(gate) {
-	return typeof gate.commit === "function";
-}
-async function runCheck(gate, ctx) {
-	await gate.check(ctx);
-	if (!isEffectGate(gate)) return;
-	let queue = commitQueues.get(ctx);
-	if (!queue) {
-		queue = [];
-		commitQueues.set(ctx, queue);
-	}
-	queue.push(() => gate.commit(ctx));
-}
-async function runCommits(ctx) {
-	const queue = commitQueues.get(ctx);
-	if (!queue) return;
-	for (const commit of queue) await commit();
-}
-function discardCommits(ctx) {
-	commitQueues.delete(ctx);
-}
-function markCommits(ctx) {
-	return commitQueues.get(ctx)?.length ?? 0;
-}
-function rollbackCommits(ctx, mark) {
-	const queue = commitQueues.get(ctx);
-	if (queue && queue.length > mark) queue.length = mark;
-}
-
-//#endregion
-//#region src/gates/catalog/options.ts
-function pickNotice(options, makeDefault) {
-	return options?.notice ?? makeDefault(options?.message);
-}
-
-//#endregion
-//#region src/permissions/bits.ts
-const PermissionNames = new Map(Object.entries(discord_api_types_v10.PermissionFlagsBits).map(([key, bit]) => [bit, (0, _seedcord_utils.prettify)(key)]));
-const ADMINISTRATOR = discord_api_types_v10.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
-};
-const BOT_CHECK = {
-	unresolved: "The bot's permissions could not be resolved. Try again.",
-	subject: "The bot"
-};
-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;
-	throw pickNotice(options?.missing, (message) => new MissingPermissions(message, kind.subject, missingNames(held, scope)));
-}
-function RequirePermissions(scope, options) {
-	if (options?.in === "guild") return defineGate("RequirePermissions", (ctx) => {
-		refusePermissions(ctx.memberGuildPermissions, scope, options, ctx.guildId, MEMBER_CHECK);
-	});
-	return defineGate("RequirePermissions", (ctx) => {
-		refusePermissions(ctx.memberPermissions, scope, options, ctx.guildId, MEMBER_CHECK);
-	});
-}
-function RequireBotPermissions(scope, options) {
-	if (options?.in === "guild") return defineGate("RequireBotPermissions", (ctx) => {
-		refusePermissions(ctx.appGuildPermissions, scope, options, ctx.guildId, BOT_CHECK);
-	});
-	return defineGate("RequireBotPermissions", (ctx) => {
-		refusePermissions(ctx.appPermissions, scope, options, ctx.guildId, BOT_CHECK);
-	});
-}
-/**
-* Requires the caller to hold `roleId`, read from the member's role ids. Refuses outside a guild first,
-* then when the role is missing. Roles are guild-global, so there is no scope dimension.
-*
-* @param roleId - The role snowflake the caller must hold.
-* @param options - Override each refusal, the outside-guild one with `notInGuild` and the missing-role one with `missingRole`.
-*
-* @see the `@Gated` decorator from `seedcord`
-*
-* @example
-* ```ts
-* \@Gated(RequireRole('123456789012345678'))
-* \@SlashRoute('vip')
-* class VipHandler extends SlashHandler<'vip'> {
-*     async execute() {
-*         // ...
-*     }
-* }
-* ```
-*/
-function RequireRole(roleId, options) {
-	return defineGate("RequireRole", (ctx) => {
-		if (!ctx.guildId) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message));
-		if (ctx.memberRoleIds.includes(roleId)) return;
-		throw pickNotice(options?.missingRole, (message) => new MissingRole(message, roleId));
-	});
-}
-
-//#endregion
-//#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
-Object.defineProperty(exports, 'CommandInjector', {
-  enumerable: true,
-  get: function () {
-    return CommandInjector;
-  }
-});
-Object.defineProperty(exports, 'Commands', {
-  enumerable: true,
-  get: function () {
-    return Commands;
-  }
-});
-Object.defineProperty(exports, 'ComponentDefsKey', {
-  enumerable: true,
-  get: function () {
-    return ComponentDefsKey;
-  }
-});
-Object.defineProperty(exports, 'ContextMenus', {
-  enumerable: true,
-  get: function () {
-    return ContextMenus;
-  }
-});
-Object.defineProperty(exports, 'CustomId', {
-  enumerable: true,
-  get: function () {
-    return CustomId;
-  }
-});
-Object.defineProperty(exports, 'GateNotice', {
-  enumerable: true,
-  get: function () {
-    return GateNotice;
-  }
-});
-Object.defineProperty(exports, 'HasDangerousPermissions', {
-  enumerable: true,
-  get: function () {
-    return HasDangerousPermissions;
-  }
-});
-Object.defineProperty(exports, 'MissingPermissions', {
-  enumerable: true,
-  get: function () {
-    return MissingPermissions;
-  }
-});
-Object.defineProperty(exports, 'MissingRole', {
-  enumerable: true,
-  get: function () {
-    return MissingRole;
-  }
-});
-Object.defineProperty(exports, 'NeedsAny', {
-  enumerable: true,
-  get: function () {
-    return NeedsAny;
-  }
-});
-Object.defineProperty(exports, 'NotAllowed', {
-  enumerable: true,
-  get: function () {
-    return NotAllowed;
-  }
-});
-Object.defineProperty(exports, 'NotInDm', {
-  enumerable: true,
-  get: function () {
-    return NotInDm;
-  }
-});
-Object.defineProperty(exports, 'NotInGuild', {
-  enumerable: true,
-  get: function () {
-    return NotInGuild;
-  }
-});
-Object.defineProperty(exports, 'NotOwner', {
-  enumerable: true,
-  get: function () {
-    return NotOwner;
-  }
-});
-Object.defineProperty(exports, 'Notice', {
-  enumerable: true,
-  get: function () {
-    return Notice;
-  }
-});
-Object.defineProperty(exports, 'NoticeCard', {
-  enumerable: true,
-  get: function () {
-    return NoticeCard;
-  }
-});
-Object.defineProperty(exports, 'OnCooldown', {
-  enumerable: true,
-  get: function () {
-    return OnCooldown;
-  }
-});
-Object.defineProperty(exports, 'PAGE_MAX', {
-  enumerable: true,
-  get: function () {
-    return PAGE_MAX;
-  }
-});
-Object.defineProperty(exports, 'PermissionNames', {
-  enumerable: true,
-  get: function () {
-    return PermissionNames;
-  }
-});
-Object.defineProperty(exports, 'RequireBotPermissions', {
-  enumerable: true,
-  get: function () {
-    return RequireBotPermissions;
-  }
-});
-Object.defineProperty(exports, 'RequirePermissions', {
-  enumerable: true,
-  get: function () {
-    return RequirePermissions;
-  }
-});
-Object.defineProperty(exports, 'RequireRole', {
-  enumerable: true,
-  get: function () {
-    return RequireRole;
-  }
-});
-Object.defineProperty(exports, 'SelectMenuKind', {
-  enumerable: true,
-  get: function () {
-    return SelectMenuKind;
-  }
-});
-Object.defineProperty(exports, 'Silence', {
-  enumerable: true,
-  get: function () {
-    return Silence;
-  }
-});
-Object.defineProperty(exports, 'accessorStore', {
-  enumerable: true,
-  get: function () {
-    return accessorStore;
-  }
-});
-Object.defineProperty(exports, 'areRoutes', {
-  enumerable: true,
-  get: function () {
-    return areRoutes;
-  }
-});
-Object.defineProperty(exports, 'clearStore', {
-  enumerable: true,
-  get: function () {
-    return clearStore;
-  }
-});
-Object.defineProperty(exports, 'contextMenuRouteOf', {
-  enumerable: true,
-  get: function () {
-    return contextMenuRouteOf;
-  }
-});
-Object.defineProperty(exports, 'decodeComponentRoute', {
-  enumerable: true,
-  get: function () {
-    return decodeComponentRoute;
-  }
-});
-Object.defineProperty(exports, 'decodeFor', {
-  enumerable: true,
-  get: function () {
-    return decodeFor;
-  }
-});
-Object.defineProperty(exports, 'defineEffectGate', {
-  enumerable: true,
-  get: function () {
-    return defineEffectGate;
-  }
-});
-Object.defineProperty(exports, 'defineGate', {
-  enumerable: true,
-  get: function () {
-    return defineGate;
-  }
-});
-Object.defineProperty(exports, 'discardCommits', {
-  enumerable: true,
-  get: function () {
-    return discardCommits;
-  }
-});
-Object.defineProperty(exports, 'guardedAccessor', {
-  enumerable: true,
-  get: function () {
-    return guardedAccessor;
-  }
-});
-Object.defineProperty(exports, 'hasAll', {
-  enumerable: true,
-  get: function () {
-    return hasAll;
-  }
-});
-Object.defineProperty(exports, 'interactionRoutesOf', {
-  enumerable: true,
-  get: function () {
-    return interactionRoutesOf;
-  }
-});
-Object.defineProperty(exports, 'markCommits', {
-  enumerable: true,
-  get: function () {
-    return markCommits;
-  }
-});
-Object.defineProperty(exports, 'missingNames', {
-  enumerable: true,
-  get: function () {
-    return missingNames;
-  }
-});
-Object.defineProperty(exports, 'pageCursor', {
-  enumerable: true,
-  get: function () {
-    return pageCursor;
-  }
-});
-Object.defineProperty(exports, 'pickNotice', {
-  enumerable: true,
-  get: function () {
-    return pickNotice;
-  }
-});
-Object.defineProperty(exports, 'prefixOf', {
-  enumerable: true,
-  get: function () {
-    return prefixOf;
-  }
-});
-Object.defineProperty(exports, 'presentNames', {
-  enumerable: true,
-  get: function () {
-    return presentNames;
-  }
-});
-Object.defineProperty(exports, 'rollbackCommits', {
-  enumerable: true,
-  get: function () {
-    return rollbackCommits;
-  }
-});
-Object.defineProperty(exports, 'runCheck', {
-  enumerable: true,
-  get: function () {
-    return runCheck;
-  }
-});
-Object.defineProperty(exports, 'runCommits', {
-  enumerable: true,
-  get: function () {
-    return runCommits;
-  }
-});
-Object.defineProperty(exports, 'selectMenuRouteOf', {
-  enumerable: true,
-  get: function () {
-    return selectMenuRouteOf;
-  }
-});
-Object.defineProperty(exports, 'storeComponentRoute', {
-  enumerable: true,
-  get: function () {
-    return storeComponentRoute;
-  }
-});
-Object.defineProperty(exports, 'storeInteractionRoute', {
-  enumerable: true,
-  get: function () {
-    return storeInteractionRoute;
-  }
-});
-//# sourceMappingURL=cursor-DFgJ70_B.cjs.map