@seedcord/core 0.9.4 → 0.11.0-next.0

package/dist/cursor-CgNBnJfu.mjs

@@ -1,802 +0,0 @@
-import { A as BuilderComponent, C as InteractionRouteKeys, S as InteractionMiddlewareMetadataKey, b as InteractionKind, x as InteractionMetadataKey } from "./Bus-BxPa-Uvp.mjs";
-import { n as asError, t as PublishDefault } from "./publishDefault-BuSZPbjT.mjs";
-import "reflect-metadata";
-import { CustomId, decodeFor } from "@seedcord/custom-id";
-import { TextDisplayBuilder } from "@discordjs/builders";
-import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
-import { SeedcordErrorCode, paint } from "@seedcord/errors";
-import { SeedcordError, SeedcordTypeError } from "@seedcord/errors/internal";
-import { Logger } from "@seedcord/logger";
-import { prettify, toEpochSeconds } from "@seedcord/utils";
-
-//#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 {@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) {
-		super(message, options);
-		this.name = new.target.name;
-		Error.captureStackTrace(this, this.constructor);
-	}
-};
-
-//#endregion
-//#region src/stops/NoticeCard.ts
-var NoticeCard = class extends BuilderComponent {
-	constructor(description, title = "Cannot Proceed") {
-		super("container");
-		this.instance.addTextDisplayComponents(new TextDisplayBuilder().setContent(`### ${title}\n${description}`));
-	}
-};
-
-//#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.for("seedcord:custom-id:component-defs");
-/**
-* 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 SeedcordError(SeedcordErrorCode.CustomIdHandlerRouteMissing, [handlerClass.name]);
-	return decodeFor(defs, wire);
-}
-
-//#endregion
-//#region src/decorators/interactionRoutes.ts
-function areRoutes(routes) {
-	return Array.isArray(routes) && routes.every((route) => typeof route === "string");
-}
-function interactionRoutesOf(constructor) {
-	const pairs = [];
-	for (const route of Object.values(InteractionKind)) {
-		const meta = Reflect.getMetadata(InteractionRouteKeys[route], constructor);
-		if (areRoutes(meta)) pairs.push([route, meta]);
-	}
-	return pairs;
-}
-function storeInteractionRoute(route, routes, constructor) {
-	const key = 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(InteractionMetadataKey, true, constructor);
-}
-function storeComponentRoute(route, defs, constructor) {
-	storeInteractionRoute(route, defs.map((def) => def.prefix), constructor);
-	Reflect.defineMetadata(ComponentDefsKey, defs, constructor);
-}
-function contextMenuRouteOf(kind) {
-	return kind === ApplicationCommandType.User ? "userContextMenu" : "messageContextMenu";
-}
-
-//#endregion
-//#region src/decorators/middleware.ts
-/**
-* Registers an interaction middleware. It runs after the dispatcher builds the handler and before its
-* gates, over that handler's reply surface.
-*
-* @param options - The kinds this middleware runs on and its ordering.
-* @decorator
-*
-* @example
-* ```ts
-* \@RegisterInteractionMiddleware({ kinds: [InteractionKind.Button], priority: 10 })
-* class Audit extends InteractionMiddleware<InteractionKind.Button> {
-*     async execute() {
-*         this.logger.info(this.dispatch.routeId);
-*     }
-* }
-* ```
-*
-* @throws A **SeedcordTypeError** If `priority` is not a finite number.
-*/
-function RegisterInteractionMiddleware(options = {}) {
-	return function(ctor) {
-		const priority = Number(options.priority ?? 0);
-		if (!Number.isFinite(priority)) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInvalidMiddlewarePriority);
-		if (options.kinds?.length === 0) throw new SeedcordTypeError(SeedcordErrorCode.DecoratorEmptyMiddlewareFilter, ["kinds"]);
-		const metadata = {
-			priority,
-			...options.kinds && { kinds: options.kinds }
-		};
-		Reflect.defineMetadata(InteractionMiddlewareMetadataKey, metadata, ctor);
-	};
-}
-/** @internal */
-function interactionMiddlewareMetaOf(constructor) {
-	return Reflect.getMetadata(InteractionMiddlewareMetadataKey, constructor);
-}
-
-//#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 { routeId } = telemetry.dispatch;
-	const write = {
-		dispatchId: telemetry.dispatch.id,
-		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(routeId)} ${report.method} ${report.outcome} ${paint.mute("in")} ${Math.round(durationMs)}ms`);
-}
-async function reportedWrite(telemetry, method, write) {
-	const startedAt = performance.now();
-	const result = await attemptWrite(telemetry, method, startedAt, write);
-	publishResponse(telemetry, {
-		method,
-		startedAt,
-		outcome: "sent",
-		messageId: null
-	});
-	return result;
-}
-async function attemptWrite(telemetry, method, startedAt, write) {
-	try {
-		return await write();
-	} catch (caught) {
-		publishResponse(telemetry, {
-			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
-/**
-* 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 your transport package
-*
-* @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 your transport package
-* @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);
-		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 ${retryAt(resetAt)}.`);
-		this.resetAt = resetAt;
-		this.summary = `try again ${retryAt(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 = [...new Set(summaries)];
-	}
-	render() {
-		const bullets = this.summaries.map((summary) => `• ${summary}`).join("\n");
-		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 {
-	subject;
-	missingPerms;
-	customLead;
-	constructor(message, subject, missingPerms) {
-		super(message ?? "A required permission is missing.");
-		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");
-		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;
-		this.summary = `${subject} must not hold ${dangerousPerms.join(", ")}`;
-	}
-	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(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
-};
-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 your transport package
-*
-* @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';
-*
-* // 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 {
-	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 { translateSerializationError as A, contextMenuRouteOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, checkAckLegality as F, decodeComponentRoute as G, storeComponentRoute as H, sendTarget as I, NoticeCard as K, RegisterInteractionMiddleware as L, publishResponse as M, reportedWrite as N, defineGate as O, AckTrace as P, interactionMiddlewareMetaOf as R, NotAllowed as S, NotOwner as T, storeInteractionRoute as U, interactionRoutesOf as V, ComponentDefsKey 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, attemptWrite as j, serializeReply as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, Notice 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, areRoutes as z };
-//# sourceMappingURL=cursor-CgNBnJfu.mjs.map