@seedcord/core 0.3.0 → 0.4.0

package/dist/{cursor-Cv1Ui6gZ.mjs → cursor-GBUYz3jk.mjs}

@@ -1,158 +1,13 @@
-import { b as InteractionRoutes, f as BuilderComponent, v as InteractionMetadataKey, w as contextMenuLeaves, y as InteractionRouteKeys } from "./Bus-DcuUtOEL.mjs";
+import { C as InteractionMetadataKey, T as InteractionRoutes, g as BuilderComponent, w as InteractionRouteKeys } from "./Bus-BVwmKc-A.mjs";
+import { n as asError, t as PublishDefault } from "./publishDefault-D826XXDQ.mjs";
 import "reflect-metadata";
-import { SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
+import { TextDisplayBuilder } from "@discordjs/builders";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
 import { Logger } from "@seedcord/logger";
-import { routeLeavesOf } from "@seedcord/utils/internal";
 import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
-import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
+import { SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
 import { prettify, toEpochSeconds } from "@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 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 SlashRegistry}. 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)];
-}
-/** @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);
-	}
-};
-
-//#endregion
 //#region src/stops/Notice.ts
 /**
 * Base class for a user-facing refusal or a reported fault.
@@ -207,8 +62,9 @@ var Notice = class extends Error {
 	*/
 	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.
+	* A short one-line reason. When every arm of an {@link or} gate refuses and each one sets this, `or`
+	* throws a refusal listing them under `You need to meet at least one of these:`. Write a verb phrase that
+	* finishes that line, for example, "be the bot owner".
 	*/
 	summary;
 	constructor(message, options) {
@@ -328,6 +184,9 @@ function isBounded(field) {
 	return field.kind === "snowflake" || field.kind === "uuid" || field.kind === "bool" || field.kind === "oneOf";
 }
 function radixOf(field) {
+	return kindRadix(field) + (field.nullable === true ? 1n : 0n);
+}
+function kindRadix(field) {
 	switch (field.kind) {
 		case "snowflake": return 1n << 64n;
 		case "uuid": return 1n << 128n;
@@ -342,6 +201,13 @@ function radixOf(field) {
 	}
 }
 function boundedToBigint(field, name, value) {
+	if (field.nullable === true) {
+		if (value === null) return 0n;
+		return boundedToBigint({
+			...field,
+			nullable: false
+		}, name, value) + 1n;
+	}
 	const slot = boundedSlot(field, name, value);
 	if (slot < 0n || slot >= radixOf(field)) outOfRange(name, value);
 	return slot;
@@ -372,6 +238,13 @@ function outOfRange(name, value) {
 	throw new SeedcordRangeError(SeedcordErrorCode.CustomIdValueOutOfRange, [name, String(value)]);
 }
 function bigintToBoundedValue(field, slot) {
+	if (field.nullable === true) return slot === 0n ? null : bigintToBoundedValue({
+		...field,
+		nullable: false
+	}, slot - 1n);
+	return kindValue(field, slot);
+}
+function kindValue(field, slot) {
 	switch (field.kind) {
 		case "snowflake": return slot.toString();
 		case "uuid": return bigintToUuid(slot);
@@ -385,7 +258,16 @@ 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)}`;
 }
+const ABSENT = "0";
+const PRESENT = "1";
 function encodeUnboundedToken(field, name, value) {
+	if (field.nullable === true) {
+		if (value === null) return ABSENT;
+		return PRESENT + encodeUnboundedToken({
+			...field,
+			nullable: false
+		}, name, value);
+	}
 	if (field.kind === "int") {
 		if (!Number.isSafeInteger(value)) outOfRange(name, value);
 		return bigintToBase64(zigzagEncode(value));
@@ -393,6 +275,15 @@ function encodeUnboundedToken(field, name, value) {
 	return escapeToken(value);
 }
 function decodeUnboundedToken(field, piece) {
+	if (field.nullable === true) {
+		const marker = piece.charAt(0);
+		if (marker === ABSENT && piece.length === 1) return null;
+		if (marker !== PRESENT) throw new InvalidCustomId(`bad presence marker ${JSON.stringify(marker)}`);
+		return decodeUnboundedToken({
+			...field,
+			nullable: false
+		}, piece.slice(1));
+	}
 	if (field.kind !== "int") return unescapeToken(piece);
 	if (piece === "") throw new InvalidCustomId("empty integer token");
 	const decoded = zigzagDecode(base64ToBigint(piece));
@@ -405,6 +296,7 @@ function computeLayoutHash(shape) {
 		name,
 		field.kind,
 		isBounded(field),
+		field.nullable === true,
 		field.kind === "oneOf" ? field.choices ?? [] : null,
 		field.kind === "int" ? [field.min ?? null, field.max ?? null] : null
 	]));
@@ -510,14 +402,14 @@ var CustomId = class CustomId {
 	/** 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 SeedcordError(SeedcordErrorCode.CustomIdInvalidPrefix, [prefix]);
+		if (!prefix || /[:\x1B\x1F]/.test(prefix)) throw new SeedcordTypeError(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 SeedcordError(SeedcordErrorCode.CustomIdReservedFieldName, [name]);
-		if (name in this.shape) throw new SeedcordError(SeedcordErrorCode.CustomIdDuplicateFieldName, [name]);
+		if (/^(?:0|[1-9]\d*)$/.test(name)) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdReservedFieldName, [name]);
+		if (name in this.shape) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdDuplicateFieldName, [name]);
 		const shape = {
 			...this.shape,
 			[name]: field
@@ -532,8 +424,11 @@ var CustomId = class CustomId {
 	* new CustomId('ban').snowflake('userId');
 	* ```
 	*/
-	snowflake(name) {
-		return this.add(name, { kind: "snowflake" });
+	snowflake(name, opts) {
+		return this.add(name, {
+			...opts,
+			kind: "snowflake"
+		});
 	}
 	/**
 	* Add a UUID field, decoded as a lowercase uuid string.
@@ -543,21 +438,29 @@ var CustomId = class CustomId {
 	* new CustomId('ticket').uuid('ticketId');
 	* ```
 	*/
-	uuid(name) {
-		return this.add(name, { kind: "uuid" });
+	uuid(name, opts) {
+		return this.add(name, {
+			...opts,
+			kind: "uuid"
+		});
 	}
-	int(name, min, max) {
-		if (min !== void 0 && max !== void 0 && min > max) throw new SeedcordError(SeedcordErrorCode.CustomIdInvalidBounds, [
+	int(name, minOrOpts, max, opts) {
+		const min = typeof minOrOpts === "number" ? minOrOpts : void 0;
+		if (min !== void 0 && max !== void 0 && min > max) throw new SeedcordRangeError(SeedcordErrorCode.CustomIdInvalidBounds, [
 			name,
 			min,
 			max
 		]);
-		const field = min === void 0 || max === void 0 ? { kind: "int" } : {
-			kind: "int",
+		const options = typeof minOrOpts === "number" ? opts : minOrOpts;
+		const bounds = min === void 0 || max === void 0 ? {} : {
 			min,
 			max
 		};
-		return this.add(name, field);
+		return this.add(name, {
+			...options,
+			kind: "int",
+			...bounds
+		});
 	}
 	/**
 	* Add a boolean flag.
@@ -567,8 +470,11 @@ var CustomId = class CustomId {
 	* new CustomId('settings').bool('silent');
 	* ```
 	*/
-	bool(name) {
-		return this.add(name, { kind: "bool" });
+	bool(name, opts) {
+		return this.add(name, {
+			...opts,
+			kind: "bool"
+		});
 	}
 	/**
 	* Add a field that is one value from a fixed list, decoded as the literal union. No `as const` needed.
@@ -578,9 +484,10 @@ var CustomId = class CustomId {
 	* new CustomId('poll').oneOf('choice', ['yes', 'no', 'abstain']);
 	* ```
 	*/
-	oneOf(name, choices) {
-		if (choices.length === 0) throw new SeedcordError(SeedcordErrorCode.CustomIdEmptyChoices, [name]);
+	oneOf(name, choices, opts) {
+		if (choices.length === 0) throw new SeedcordRangeError(SeedcordErrorCode.CustomIdEmptyChoices, [name]);
 		return this.add(name, {
+			...opts,
 			kind: "oneOf",
 			choices
 		});
@@ -594,8 +501,11 @@ var CustomId = class CustomId {
 	* new CustomId('note').str('message');
 	* ```
 	*/
-	str(name) {
-		return this.add(name, { kind: "string" });
+	str(name, opts) {
+		return this.add(name, {
+			...opts,
+			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.
@@ -713,6 +623,285 @@ function contextMenuRouteOf(kind) {
 	return kind === ApplicationCommandType.User ? "userContextMenu" : "messageContextMenu";
 }
 
+//#endregion
+//#region src/reply/ackLegality.ts
+const showModalReason = {
+	reason: "this interaction was already acknowledged",
+	alternative: "showModal() must be the initial response."
+};
+function deferReason(what) {
+	return {
+		reason: `this interaction was already acknowledged with ${what}`,
+		alternative: "A deferral can only be the initial response."
+	};
+}
+const ILLEGAL = {
+	reply: {
+		"deferred-reply": {
+			reason: "this interaction was already deferred",
+			alternative: "Use edit() to fill the deferred reply or followUp() for a new message."
+		},
+		"deferred-update": {
+			reason: "this interaction was already acknowledged with a deferred update",
+			alternative: "Use followUp() for a new message."
+		},
+		replied: {
+			reason: "this interaction was already replied to",
+			alternative: "Use followUp() for a new message or edit() to rewrite the reply."
+		}
+	},
+	defer: {
+		"deferred-reply": deferReason("a deferred reply"),
+		"deferred-update": deferReason("a deferred update"),
+		replied: deferReason("a reply")
+	},
+	deferUpdate: {
+		"deferred-reply": deferReason("a deferred reply"),
+		"deferred-update": deferReason("a deferred update"),
+		replied: deferReason("a reply")
+	},
+	update: {
+		"deferred-reply": {
+			reason: "this interaction was deferred as a reply",
+			alternative: "The placeholder is yours via edit(). update() rewrites a source message."
+		},
+		replied: {
+			reason: "this interaction was already replied to",
+			alternative: "update() rewrites a source message. Use edit() or followUp() instead."
+		}
+	},
+	followUp: { unacked: {
+		reason: "this interaction has not been acknowledged yet",
+		alternative: "Ack first with reply() or defer()."
+	} },
+	edit: { unacked: {
+		reason: "nothing has been sent yet",
+		alternative: "Send with reply() or defer() first, then edit() rewrites it."
+	} },
+	delete: { unacked: {
+		reason: "nothing has been sent yet",
+		alternative: "Acknowledge first with reply() or defer(), then delete() removes it."
+	} },
+	showModal: {
+		"deferred-reply": showModalReason,
+		"deferred-update": showModalReason,
+		replied: showModalReason
+	}
+};
+const SEND_TARGET = {
+	unacked: "reply",
+	"deferred-reply": "edit",
+	"deferred-update": "followUp",
+	replied: "followUp"
+};
+function checkAckLegality(method, state, routeId, ackedBy) {
+	if (method === "send") return;
+	const illegal = ILLEGAL[method][state];
+	if (!illegal) return;
+	throw new SeedcordError(SeedcordErrorCode.ReplyIllegalAckState, [
+		method,
+		illegal.reason,
+		illegal.alternative,
+		routeId
+	], { cause: ackedBy });
+}
+function sendTarget(state) {
+	return SEND_TARGET[state];
+}
+
+//#endregion
+//#region src/reply/AckTrace.ts
+var AckTrace = class extends Error {
+	constructor(method) {
+		super(`${method}() acknowledged this interaction`);
+		this.name = "AckTrace";
+	}
+};
+
+//#endregion
+//#region src/reply/responseReport.ts
+let replyLogger;
+function logger() {
+	replyLogger ??= new Logger("Reply", { channel: "interactions" });
+	return replyLogger;
+}
+/** @internal */
+function publishResponse(telemetry, report) {
+	const durationMs = performance.now() - report.startedAt;
+	const write = {
+		routeId: report.routeId,
+		interactionId: telemetry.interactionId,
+		method: report.method,
+		durationMs
+	};
+	telemetry.bus[PublishDefault]("responseAttempted", report.outcome === "failed" ? {
+		...write,
+		outcome: "failed",
+		messageId: null,
+		error: report.error
+	} : {
+		...write,
+		outcome: "sent",
+		messageId: report.messageId
+	});
+	logger().trace(`${paint.sky.bold(report.routeId)} ${report.method} ${report.outcome} ${paint.mute("in")} ${Math.round(durationMs)}ms`);
+}
+async function reportedWrite(telemetry, routeId, method, write) {
+	const startedAt = performance.now();
+	const result = await attemptWrite(telemetry, routeId, method, startedAt, write);
+	publishResponse(telemetry, {
+		routeId,
+		method,
+		startedAt,
+		outcome: "sent",
+		messageId: null
+	});
+	return result;
+}
+async function attemptWrite(telemetry, routeId, method, startedAt, write) {
+	try {
+		return await write();
+	} catch (caught) {
+		publishResponse(telemetry, {
+			routeId,
+			method,
+			startedAt,
+			outcome: "failed",
+			error: asError(caught)
+		});
+		throw caught;
+	}
+}
+
+//#endregion
+//#region src/reply/translateSerialization.ts
+const MAX_DEPTH = 8;
+const OPERATOR_WORD = {
+	"<=": "at most",
+	">=": "at least",
+	"<": "fewer than",
+	">": "more than"
+};
+const KIND_WORD = {
+	string: "a string",
+	number: "a number",
+	boolean: "a boolean",
+	bigint: "a bigint",
+	array: "a list",
+	tuple: "a list",
+	date: "a date",
+	object: "an object"
+};
+function asRecord(value) {
+	return typeof value === "object" && value !== null ? value : null;
+}
+function firstLine(message) {
+	if (typeof message !== "string") return "unknown validation failure";
+	return message.split("\n")[0] ?? message;
+}
+const GIVEN_PREVIEW_LIMIT = 40;
+function gotPhrase(given) {
+	if (given === void 0) return "nothing";
+	if (given === null) return "null";
+	if (typeof given === "string") {
+		if (given.length === 0) return "an empty string";
+		if (given.length > GIVEN_PREVIEW_LIMIT) return `${given.length} characters`;
+		return JSON.stringify(given);
+	}
+	if (Array.isArray(given)) return given.length === 0 ? "an empty list" : `${given.length} items`;
+	if (typeof given === "number" || typeof given === "bigint" || typeof given === "boolean") return String(given);
+	if (typeof given === "object") return given.constructor?.name ?? "an object";
+	return typeof given;
+}
+function needPhrase(expected, given) {
+	const bounds = [...expected.matchAll(/expected(\.length)?\s*(<=|>=|<|>)\s*(\d+)/g)];
+	if (bounds.length === 0) return null;
+	return bounds.map(([, lengthPart, operator, limit]) => {
+		const word = OPERATOR_WORD[operator ?? ""] ?? operator ?? "";
+		if (!lengthPart) return `${word} ${limit}`;
+		const unit = typeof given === "string" ? "character" : "item";
+		return `${word} ${limit} ${Number(limit) === 1 ? unit : `${unit}s`}`;
+	}).join(" and ");
+}
+function instanceName(expected) {
+	if (typeof expected === "function" && expected.name) return expected.name;
+	return "specific class instance";
+}
+function describeLeaf(record) {
+	if (typeof record.constraint === "string") {
+		const need = typeof record.expected === "string" ? needPhrase(record.expected, record.given) : null;
+		if (need) return `need ${need}, got ${gotPhrase(record.given)}`;
+		return `${firstLine(record.message)}${"given" in record ? ` (got ${gotPhrase(record.given)})` : ""}`;
+	}
+	if (typeof record.expected === "function") return `need a ${instanceName(record.expected)}, got ${gotPhrase(record.given)}`;
+	if (typeof record.validator === "string") {
+		const kind = KIND_WORD[record.validator.replace(/^s\./, "").replace(/\(.*$/, "")];
+		if (kind) return `need ${kind}, got ${gotPhrase(record.given)}`;
+		return `${firstLine(record.message)}, got ${gotPhrase(record.given)}`;
+	}
+	return firstLine(record.message);
+}
+function describeUnion(branches, depth) {
+	const records = [];
+	for (const branch of branches) {
+		const record = asRecord(branch);
+		if (record) records.push(record);
+	}
+	const bounded = records.find((record) => typeof record.constraint === "string");
+	if (bounded) return describeLeaf(bounded);
+	const names = [];
+	let allInstances = records.length > 0;
+	for (const record of records) if (typeof record.expected === "function") names.push(instanceName(record.expected));
+	else allInstances = false;
+	if (allInstances) return `need a ${[...new Set(names)].join(" or ")}, got ${gotPhrase(records[0]?.given)}`;
+	return detailOf(branches[0], depth + 1);
+}
+function detailOf(value, depth) {
+	const record = asRecord(value);
+	if (!record || depth >= MAX_DEPTH) return firstLine(record?.message);
+	if (Array.isArray(record.errors) && record.errors.length > 0) {
+		const errors = record.errors;
+		const [first] = errors;
+		if (Array.isArray(first)) {
+			const [key, inner] = first;
+			return `${String(key)}: ${detailOf(inner, depth + 1)}`;
+		}
+		return describeUnion(errors, depth);
+	}
+	return describeLeaf(record);
+}
+function translateSerializationError(error, componentClass, index, routeId) {
+	const detail = detailOf(error, 0);
+	return new SeedcordError(SeedcordErrorCode.ReplyComponentSerialization, [
+		componentClass,
+		index,
+		detail,
+		routeId
+	], { cause: error });
+}
+
+//#endregion
+//#region src/reply/serializeReply.ts
+function serializeReply(response, routeId) {
+	if (typeof response === "string") try {
+		return { components: [new TextDisplayBuilder().setContent(response).toJSON()] };
+	} catch (error) {
+		throw translateSerializationError(error, "TextDisplayBuilder", 0, routeId);
+	}
+	return {
+		components: response.components.map((component, index) => {
+			try {
+				return component.toJSON();
+			} catch (error) {
+				const name = component.constructor?.name;
+				throw translateSerializationError(error, !name || name === "Object" ? "component" : name, index, routeId);
+			}
+		}),
+		...response.allowedMentions && { allowedMentions: response.allowedMentions },
+		...response.files && { files: response.files }
+	};
+}
+
 //#endregion
 //#region src/gates/Gate.ts
 /**
@@ -807,23 +996,30 @@ var GateNotice = class extends Notice {
 var NotOwner = class extends GateNotice {
 	constructor(message = "Only the bot owner can use this.") {
 		super(message);
+		this.summary = "be the bot owner";
 	}
 };
 var NotInGuild = class extends GateNotice {
 	constructor(message = "This can only be used in a server.") {
 		super(message);
+		this.summary = "be in a server";
 	}
 };
 var NotInDm = class extends GateNotice {
 	constructor(message = "This can only be used in a direct message.") {
 		super(message);
+		this.summary = "be in a direct message";
 	}
 };
+function retryAt(resetAt) {
+	return `<t:${toEpochSeconds(resetAt)}:R>`;
+}
 var OnCooldown = class extends GateNotice {
 	resetAt;
 	constructor(resetAt, message) {
-		super(message ?? `You are doing that too fast. Try again <t:${toEpochSeconds(resetAt)}:R>.`);
+		super(message ?? `You are doing that too fast. Try again ${retryAt(resetAt)}.`);
 		this.resetAt = resetAt;
+		this.summary = `try again ${retryAt(resetAt)}`;
 	}
 };
 var NotAllowed = class extends Notice {
@@ -838,16 +1034,17 @@ var NeedsAny = class extends Notice {
 	summaries;
 	constructor(summaries) {
 		super("not allowed");
-		this.summaries = summaries;
+		this.summaries = [...new Set(summaries)];
 	}
 	render() {
 		const bullets = this.summaries.map((summary) => `• ${summary}`).join("\n");
-		return { components: [new NoticeCard(`You need any of:\n${bullets}`).component] };
+		return { components: [new NoticeCard(`You need to meet at least one of these:\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."));
+		this.summary = roleId ? `hold the <@&${roleId}> role` : "hold the required role";
 	}
 };
 var MissingPermissions = class extends Notice {
@@ -859,6 +1056,8 @@ var MissingPermissions = class extends Notice {
 		this.subject = subject;
 		this.missingPerms = missingPerms;
 		this.customLead = message;
+		const names = missingPerms.join(", ");
+		this.summary = subject === null ? `hold ${names}` : `${subject} needs ${names}`;
 	}
 	render() {
 		const bullets = this.missingPerms.map((perm) => `• ${perm}`).join("\n");
@@ -875,6 +1074,7 @@ var HasDangerousPermissions = class extends Notice {
 		this.subject = subject;
 		this.dangerousPerms = dangerousPerms;
 		this.customLead = message;
+		this.summary = `${subject} must not hold ${dangerousPerms.join(", ")}`;
 	}
 	render() {
 		const bullets = this.dangerousPerms.map((perm) => `• ${perm}`).join("\n");
@@ -1022,8 +1222,9 @@ function RequireRole(roleId, options) {
 * ```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');
+* // a helper under a guildMemberAdd handler, stopping when this guild configured nothing to send
+* const template = await settings.welcome(member.guild.id);
+* if (!template) throw new Silence('no welcome message set');
 * ```
 */
 var Silence = class extends Error {
@@ -1048,5 +1249,5 @@ function pageCursor(prefix) {
 }
 
 //#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-Cv1Ui6gZ.mjs.map
+export { translateSerializationError as A, interactionRoutesOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, checkAckLegality as F, decodeComponentRoute as G, storeComponentRoute as H, sendTarget as I, prefixOf as J, CustomId as K, SelectMenuKind as L, publishResponse as M, reportedWrite as N, defineGate as O, AckTrace as P, areRoutes as R, NotAllowed as S, NotOwner as T, storeInteractionRoute as U, selectMenuRouteOf as V, ComponentDefsKey as W, Notice as X, NoticeCard as Y, 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, attemptWrite as j, serializeReply as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, decodeFor 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, contextMenuRouteOf as z };
+//# sourceMappingURL=cursor-GBUYz3jk.mjs.map