@seedcord/http 0.1.0-next.0 → 0.1.0-next.2

package/dist/edge.index-joDL39cK.cjs

@@ -0,0 +1,1426 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+//#endregion
+let _seedcord_errors_internal = require("@seedcord/errors/internal");
+let envapt = require("envapt");
+let _discordjs_rest = require("@discordjs/rest");
+let _seedcord_core = require("@seedcord/core");
+let _seedcord_core_internal = require("@seedcord/core/internal");
+let _seedcord_logger = require("@seedcord/logger");
+let _seedcord_rate_limiter = require("@seedcord/rate-limiter");
+let discord_api_types_v10 = require("discord-api-types/v10");
+let _discordjs_core_http_only = require("@discordjs/core/http-only");
+let _seedcord_utils_internal = require("@seedcord/utils/internal");
+let _seedcord_errors = require("@seedcord/errors");
+
+//#region src/reply/ReplySender.ts
+function wireAllowedMentions(mentions) {
+	const { repliedUser, ...wire } = mentions;
+	return {
+		...wire,
+		...repliedUser !== void 0 && { replied_user: repliedUser }
+	};
+}
+function wireAttachments(files) {
+	if (!files?.some((file) => file.description)) return null;
+	return files.map((file, index) => ({
+		id: index,
+		...file.name && { filename: file.name },
+		...file.description && { description: file.description }
+	}));
+}
+function callbackData(reply, flags) {
+	const attachments = wireAttachments(reply.files);
+	return {
+		flags,
+		components: reply.components,
+		...reply.allowedMentions && { allowed_mentions: wireAllowedMentions(reply.allowedMentions) },
+		...attachments && { attachments }
+	};
+}
+/**
+* Writes interaction responses over the Discord REST callback and webhook endpoints. Construction is
+* internal to the repliable handler bases and the dispatcher.
+*/
+var ReplySender = class extends _seedcord_core_internal.BaseReplySender {
+	ref;
+	rest;
+	constructor(ref, rest, routeId, bus) {
+		super(routeId, "unacked", bus && {
+			bus,
+			interactionId: ref.id
+		});
+		this.ref = ref;
+		this.rest = rest;
+	}
+	async writeReply(response, opts) {
+		const reply = this.serialize(response);
+		const result = await this.callback(discord_api_types_v10.InteractionResponseType.ChannelMessageWithSource, callbackData(reply, (0, _seedcord_core_internal.sendFlags)(opts)), reply.files);
+		return this.createdMessage(result);
+	}
+	async writeDefer(opts) {
+		await this.callback(discord_api_types_v10.InteractionResponseType.DeferredChannelMessageWithSource, { flags: (0, _seedcord_core_internal.deferFlags)(opts) });
+	}
+	async writeDeferUpdate() {
+		await this.callback(discord_api_types_v10.InteractionResponseType.DeferredMessageUpdate);
+	}
+	async writeUpdate(response) {
+		const reply = this.serialize(response);
+		const result = await this.callback(discord_api_types_v10.InteractionResponseType.UpdateMessage, callbackData(reply, discord_api_types_v10.MessageFlags.IsComponentsV2), reply.files);
+		return this.createdMessage(result);
+	}
+	async writeFollowUp(response, opts) {
+		const reply = this.serialize(response);
+		return await this.rest.post(discord_api_types_v10.Routes.webhook(this.ref.application_id, this.ref.token), {
+			body: callbackData(reply, (0, _seedcord_core_internal.sendFlags)(opts)),
+			query: new URLSearchParams({ wait: "true" }),
+			...reply.files && { files: this.rawFiles(reply.files) }
+		});
+	}
+	writeEditOriginal(response) {
+		return this.editMessage(discord_api_types_v10.Routes.webhookMessage(this.ref.application_id, this.ref.token), this.serialize(response));
+	}
+	writeEditTarget(targetId, response) {
+		const route = discord_api_types_v10.Routes.webhookMessage(this.ref.application_id, this.ref.token, targetId);
+		return this.editMessage(route, this.serialize(response));
+	}
+	async writeDeleteOriginal() {
+		await this.rest.delete(discord_api_types_v10.Routes.webhookMessage(this.ref.application_id, this.ref.token));
+	}
+	async writeDeleteTarget(targetId) {
+		await this.rest.delete(discord_api_types_v10.Routes.webhookMessage(this.ref.application_id, this.ref.token, targetId));
+	}
+	async writeModal(data) {
+		await this.callback(discord_api_types_v10.InteractionResponseType.Modal, data);
+	}
+	async callback(type, data, files) {
+		const withResponse = type === discord_api_types_v10.InteractionResponseType.ChannelMessageWithSource || type === discord_api_types_v10.InteractionResponseType.UpdateMessage;
+		return await this.rest.post(discord_api_types_v10.Routes.interactionCallback(this.ref.id, this.ref.token), {
+			body: {
+				type,
+				...data !== void 0 && { data }
+			},
+			...withResponse && { query: new URLSearchParams({ with_response: "true" }) },
+			...files && { files: this.rawFiles(files) }
+		});
+	}
+	async editMessage(route, reply) {
+		return await this.rest.patch(route, {
+			body: callbackData(reply, discord_api_types_v10.MessageFlags.IsComponentsV2),
+			...reply.files && { files: this.rawFiles(reply.files) }
+		});
+	}
+	rawFiles(files) {
+		return files.map((file, index) => ({
+			name: file.name ?? `file-${index}`,
+			data: file.attachment
+		}));
+	}
+	createdMessage(result) {
+		return result.resource?.message;
+	}
+};
+
+//#endregion
+//#region src/api.ts
+const apis = /* @__PURE__ */ new WeakMap();
+function apiFor(rest) {
+	let api = apis.get(rest);
+	if (!api) {
+		api = new _discordjs_core_http_only.API(rest);
+		apis.set(rest, api);
+	}
+	return api;
+}
+
+//#endregion
+//#region src/handlers/RepliableHandler.ts
+/**
+* Shared base the repliable HTTP interaction handlers extend.
+*
+* Not a public entry point. Extend {@link SlashHandler}, {@link ButtonHandler}, {@link ModalHandler},
+* {@link SelectMenuHandler}, or {@link ContextMenuHandler} instead. This class binds the core reply base
+* to the http sender.
+*
+* @typeParam Event - The repliable interaction type this handler processes
+*/
+var RepliableHandler = class extends _seedcord_core.RepliableHandler {
+	buildSender(event, core, routeId) {
+		return new ReplySender({
+			application_id: event.application_id,
+			id: event.id,
+			token: event.token
+		}, core.rest, routeId, core.bus);
+	}
+	/**
+	* Typed Discord REST API (`@discordjs/core/http-only`) over `core.rest`, one instance per core.
+	* The interaction callbacks on `api.interactions` bypass the reply surface. The
+	* `no-raw-interaction-acks` rule flags them in handler classes.
+	*/
+	get api() {
+		return apiFor(this.core.rest);
+	}
+};
+
+//#endregion
+//#region src/gates/context.ts
+function interactionGateContext(payload, core, routeId) {
+	const member = payload.member ?? null;
+	const resolved = member?.user ?? payload.user;
+	return {
+		kind: "interaction",
+		core,
+		interaction: payload,
+		user: resolved,
+		member,
+		userId: resolved?.id ?? null,
+		guildId: payload.guild_id ?? null,
+		channelId: payload.channel?.id ?? null,
+		memberRoleIds: member?.roles ?? [],
+		memberPermissions: member ? BigInt(member.permissions) : null,
+		appPermissions: BigInt(payload.app_permissions),
+		routeId
+	};
+}
+
+//#endregion
+//#region src/dispatch/slashRouteOf.ts
+/**
+* Computes the dispatch route for a chat-input or autocomplete payload, the raw-payload port of the
+* gateway's `slashRouteOf`. Both assemble keys through `buildSlashRoute`, so a dispatched interaction
+* and a generated registry key always match.
+*/
+function slashRouteOf(data) {
+	const first = data.options?.[0];
+	if (first?.type === discord_api_types_v10.ApplicationCommandOptionType.SubcommandGroup) return (0, _seedcord_utils_internal.buildSlashRoute)(data.name, first.options[0]?.name, first.name);
+	if (first?.type === discord_api_types_v10.ApplicationCommandOptionType.Subcommand) return (0, _seedcord_utils_internal.buildSlashRoute)(data.name, first.name);
+	return data.name;
+}
+
+//#endregion
+//#region src/dispatch/reportFault.ts
+let faultLogger;
+function logger$1() {
+	faultLogger ??= new _seedcord_logger.Logger("Faults", { channel: "errors" });
+	return faultLogger;
+}
+/**
+* Publishes a fault on the bus, the raw-payload equivalent of the reporting half of gateway's
+* `extractErrorResponse`. A reported {@link Notice} publishes `handledException`, everything else
+* publishes `unknownException`.
+*
+* @internal
+*/
+function reportFault(error, uuid, payload, core) {
+	const throttle = _seedcord_core_internal.FaultThrottle.for(core);
+	const key = `${routeKeyOf(payload)}:${nameOf(error)}`;
+	if (!throttle.shouldReport(key)) {
+		logger$1().debug(`throttled duplicate fault ${_seedcord_logger.paint.mute(key)}`);
+		return;
+	}
+	const source = interactionSource(payload);
+	if (error instanceof _seedcord_core.Notice && source) core.bus[_seedcord_core_internal.PublishDefault]("handledException", {
+		denial: error,
+		uuid,
+		source
+	});
+	else core.bus[_seedcord_core_internal.PublishDefault]("unknownException", {
+		uuid,
+		error,
+		...actors(payload),
+		metadata: payload
+	});
+	throttle.markReported(key);
+}
+function routeKeyOf(payload) {
+	if (payload.type === discord_api_types_v10.InteractionType.ApplicationCommandAutocomplete) return `autocomplete:${slashRouteOf(payload.data)}`;
+	if (payload.type === discord_api_types_v10.InteractionType.ApplicationCommand) return payload.data.type === discord_api_types_v10.ApplicationCommandType.ChatInput ? slashRouteOf(payload.data) : payload.data.name;
+	return (0, _seedcord_core_internal.prefixOf)(payload.data.custom_id) || payload.data.custom_id;
+}
+function nameOf(error) {
+	if (error instanceof _seedcord_core.Notice) return error.name;
+	if (error instanceof _discordjs_rest.DiscordAPIError) return String(error.code);
+	return error.constructor.name;
+}
+function actors(payload) {
+	const user = payload.member?.user ?? payload.user;
+	return {
+		guild: void 0,
+		user: user ? {
+			id: user.id,
+			username: user.username
+		} : void 0
+	};
+}
+function interactionSource(payload) {
+	const user = payload.member?.user ?? payload.user;
+	if (!user) return null;
+	const common = {
+		kind: "interaction",
+		userId: user.id,
+		guildId: payload.guild_id ?? null,
+		channelId: payload.channel?.id ?? null,
+		interactionId: payload.id,
+		raw: payload
+	};
+	if (payload.type === discord_api_types_v10.InteractionType.ApplicationCommand) {
+		const isSlash = payload.data.type === discord_api_types_v10.ApplicationCommandType.ChatInput;
+		return {
+			...common,
+			interactionKind: isSlash ? "slash" : "context-menu",
+			command: routeKeyOf(payload),
+			customId: null
+		};
+	}
+	if (payload.type === discord_api_types_v10.InteractionType.ModalSubmit) return {
+		...common,
+		interactionKind: "modal",
+		command: null,
+		customId: payload.data.custom_id
+	};
+	if (payload.type === discord_api_types_v10.InteractionType.MessageComponent) {
+		const isButton = payload.data.component_type === discord_api_types_v10.ComponentType.Button;
+		return {
+			...common,
+			interactionKind: isButton ? "button" : "select",
+			command: null,
+			customId: payload.data.custom_id
+		};
+	}
+	return null;
+}
+
+//#endregion
+//#region src/dispatch/dispatchInteraction.ts
+let dispatchLogger;
+function logger() {
+	dispatchLogger ??= new _seedcord_logger.Logger("Dispatcher", { channel: "interactions" });
+	return dispatchLogger;
+}
+function createCore(config, token) {
+	const draft = {
+		config,
+		rateLimiter: config.store ?? new _seedcord_rate_limiter.MemoryRateLimiter(),
+		rest: new _discordjs_rest.REST().setToken(token)
+	};
+	draft.bus = new _seedcord_core.Bus(draft);
+	return draft;
+}
+function isHandlerCtor(value) {
+	return typeof value === "function" && value.prototype instanceof _seedcord_core.BaseHandler;
+}
+const HARMLESS_API_CODES = new Set([
+	discord_api_types_v10.RESTJSONErrorCodes.UnknownInteraction,
+	discord_api_types_v10.RESTJSONErrorCodes.InteractionHasAlreadyBeenAcknowledged,
+	discord_api_types_v10.RESTJSONErrorCodes.UnknownMessage
+]);
+async function sendGuarded(routeId, send) {
+	try {
+		await send();
+	} catch (error) {
+		if (error instanceof _discordjs_rest.DiscordAPIError && HARMLESS_API_CODES.has(error.code)) {
+			logger().debug(`boundary send hit harmless code ${_seedcord_logger.paint.amber(String(error.code))}`);
+			return;
+		}
+		logger().error(`boundary send failed for route ${_seedcord_logger.paint.sky.bold(routeId)}`, error);
+	}
+}
+async function respondEmptyChoices(scope) {
+	await (0, _seedcord_core_internal.reportedWrite)({
+		bus: scope.core.bus,
+		interactionId: scope.payload.id
+	}, scope.routeId, "respond", () => scope.core.rest.post(discord_api_types_v10.Routes.interactionCallback(scope.payload.id, scope.payload.token), { body: {
+		type: discord_api_types_v10.InteractionResponseType.ApplicationCommandAutocompleteResult,
+		data: { choices: [] }
+	} }));
+}
+function renderContext(core, uuid) {
+	const developerUsername = core.config.notifications?.developerUsername;
+	return developerUsername === void 0 ? { uuid } : {
+		uuid,
+		developerUsername
+	};
+}
+async function handleNotice(notice, uuid, scope) {
+	if (notice.report) {
+		logger().error(`${notice.name}: ${_seedcord_logger.paint.mute(uuid)}`, notice);
+		reportFault(notice, uuid, scope.payload, scope.core);
+	}
+	const { sender } = scope;
+	if (!sender) {
+		await sendGuarded(scope.routeId, () => respondEmptyChoices(scope));
+		return;
+	}
+	const response = notice.render(renderContext(scope.core, uuid));
+	await sendGuarded(scope.routeId, () => sender.send(response, { ephemeral: notice.ephemeral }));
+}
+async function handleRawFault(error, uuid, scope) {
+	const { core, sender } = scope;
+	if (core.config.errors?.errorStack ?? false) logger().error(_seedcord_logger.paint.mute(uuid), error);
+	else logger().error(`${_seedcord_logger.paint.mute(uuid)} | ${error.message}`);
+	reportFault(error, uuid, scope.payload, core);
+	if (!sender) {
+		await sendGuarded(scope.routeId, () => respondEmptyChoices(scope));
+		return;
+	}
+	const override = core.config.errors?.defaultError;
+	const response = (override ? new override(uuid) : new _seedcord_core.Fault()).render(renderContext(core, uuid));
+	await sendGuarded(scope.routeId, () => sender.send(response, { ephemeral: true }));
+}
+async function handleFault(caught, scope) {
+	if (caught instanceof _seedcord_core.Silence) {
+		if (caught.reason !== void 0) logger().debug(`Silence: ${caught.reason}`);
+		return;
+	}
+	const uuid = crypto.randomUUID();
+	if (caught instanceof _seedcord_core.Notice) {
+		await handleNotice(caught, uuid, scope);
+		return;
+	}
+	const error = (0, _seedcord_core_internal.asError)(caught);
+	const ignore = new Set(scope.core.config.errors?.ignoreApiCodes ?? []);
+	if (error instanceof _discordjs_rest.DiscordAPIError && ignore.has(error.code)) {
+		logger().debug(`swallowed api code ${_seedcord_logger.paint.amber(String(error.code))}`);
+		return;
+	}
+	await handleRawFault(error, uuid, scope);
+}
+function unhandledRouteId(match) {
+	if (match.routeId) return match.routeId;
+	const key = match.attemptedKey ?? "";
+	return `${match.kind}:${key.length > 0 ? key : "unrouted"}`;
+}
+function freshScope(match, payload, core) {
+	const ref = {
+		application_id: payload.application_id,
+		id: payload.id,
+		token: payload.token
+	};
+	const routeId = unhandledRouteId(match);
+	return {
+		core,
+		payload,
+		routeId,
+		sender: match.kind === "autocomplete" ? null : new ReplySender(ref, core.rest, routeId, core.bus)
+	};
+}
+function dispatchReporter(match, payload, core) {
+	const startedAt = performance.now();
+	const queuedMs = (0, _seedcord_core_internal.queuedMsFor)(payload.id);
+	return (outcome) => {
+		core.bus[_seedcord_core_internal.PublishDefault]("interactionDispatched", (0, _seedcord_core_internal.dispatchedPayload)({
+			routeId: unhandledRouteId(match),
+			interactionId: payload.id,
+			kind: match.kind,
+			outcome,
+			fallback: match.routeId === null,
+			startedAt,
+			queuedMs
+		}));
+	};
+}
+async function answer(caught, scope, report, outcome = (0, _seedcord_core_internal.outcomeFor)(caught)) {
+	try {
+		await handleFault(caught, scope);
+	} finally {
+		report(outcome);
+	}
+}
+async function loadHandlerCtor(match, payload, core, report) {
+	const routeId = unhandledRouteId(match);
+	let exported;
+	try {
+		exported = await match.load();
+	} catch (caught) {
+		logger().error(`Route ${_seedcord_logger.paint.sky.bold(routeId)} failed to load its handler.`, caught);
+		await answer(caught, freshScope(match, payload, core), report, "failed");
+		return null;
+	}
+	if (isHandlerCtor(exported)) return exported;
+	logger().error(`Route ${_seedcord_logger.paint.sky.bold(routeId)} loaded an export that is not a handler class.`);
+	await answer(/* @__PURE__ */ new Error(`route ${routeId} loaded an export that is not a handler class`), freshScope(match, payload, core), report, "failed");
+	return null;
+}
+/**
+* Runs the pre-ack phase for a matched interaction. Loads the route's handler class, constructs it, and
+* runs its gates, and the sender posts any refusal. Returns the post-ack execute continuation, or null
+* when a gate refuses or nothing can run.
+*/
+async function dispatchInteraction(args) {
+	const { match, payload, core } = args;
+	const report = dispatchReporter(match, payload, core);
+	const ctor = await loadHandlerCtor(match, payload, core, report);
+	if (!ctor) return null;
+	const dispatch = new _seedcord_core.DispatchContext(unhandledRouteId(match));
+	let handler;
+	try {
+		handler = new ctor(payload, core, dispatch);
+	} catch (caught) {
+		await answer(caught, freshScope(match, payload, core), report);
+		return null;
+	}
+	const scope = {
+		core,
+		payload,
+		routeId: unhandledRouteId(match),
+		sender: handler instanceof RepliableHandler ? handler.getSender() : null
+	};
+	const refusal = await gateRefusal(ctor, match, payload, core);
+	if (refusal) {
+		await answer(refusal.caught, scope, report);
+		return null;
+	}
+	return async () => {
+		try {
+			await handler.execute();
+			report("handled");
+		} catch (caught) {
+			await answer(caught, scope, report);
+		}
+	};
+}
+async function gateRefusal(ctor, match, payload, core) {
+	if (match.kind === "autocomplete" || payload.type === discord_api_types_v10.InteractionType.ApplicationCommandAutocomplete) return null;
+	const monitor = (0, _seedcord_core_internal.slowGateMonitor)();
+	try {
+		await (0, _seedcord_core_internal.runHandlerGates)(ctor, interactionGateContext(payload, core, match.routeId), match.routeId ?? void 0, monitor?.observe);
+		return null;
+	} catch (caught) {
+		return { caught };
+	} finally {
+		monitor?.report(match.routeId);
+	}
+}
+
+//#endregion
+//#region src/dispatch/registerSubscribers.ts
+/**
+* Registers a manifest's subscribers on the bus without importing them. Each row's module loads on
+* the first publish of one of its keys, which keeps an isolate that never publishes free of the cost.
+*
+* @internal
+*/
+function registerSubscribers(bus, manifest) {
+	for (const row of manifest.subscriberRoutes) bus.register({
+		keys: row.keys,
+		frequency: row.frequency,
+		resolve: async () => {
+			const keys = row.keys.join(", ");
+			let module;
+			try {
+				module = await row.load();
+			} catch (caught) {
+				throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.RouteModuleLoadFailed, [keys, row.from], { cause: caught });
+			}
+			if (!Object.hasOwn(module, row.exportName)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.InteractionRouteExportMissing, [
+				keys,
+				row.exportName,
+				row.from
+			]);
+			const exported = module[row.exportName];
+			if (typeof exported !== "function" || !(exported.prototype instanceof _seedcord_core.Subscriber)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.SubscriberRouteNotASubscriber, [
+				keys,
+				row.exportName,
+				row.from
+			]);
+			return exported;
+		}
+	});
+}
+
+//#endregion
+//#region src/inputs/HttpSlashOptions.ts
+var HttpSlashOptions = class {
+	leaves = /* @__PURE__ */ new Map();
+	resolved;
+	constructor(data) {
+		this.resolved = data.resolved;
+		let options = data.options ?? [];
+		const first = options[0];
+		if (first?.type === discord_api_types_v10.ApplicationCommandOptionType.SubcommandGroup) options = first.options;
+		const second = options[0];
+		if (second?.type === discord_api_types_v10.ApplicationCommandOptionType.Subcommand) options = second.options ?? [];
+		for (const option of options) if (option.type !== discord_api_types_v10.ApplicationCommandOptionType.Subcommand && option.type !== discord_api_types_v10.ApplicationCommandOptionType.SubcommandGroup) this.leaves.set(option.name, option);
+	}
+	getString(name) {
+		const leaf = this.leaves.get(name);
+		return leaf?.type === discord_api_types_v10.ApplicationCommandOptionType.String ? leaf.value : null;
+	}
+	getInteger(name) {
+		const leaf = this.leaves.get(name);
+		return leaf?.type === discord_api_types_v10.ApplicationCommandOptionType.Integer ? numeric(leaf.value) : null;
+	}
+	getNumber(name) {
+		const leaf = this.leaves.get(name);
+		return leaf?.type === discord_api_types_v10.ApplicationCommandOptionType.Number ? numeric(leaf.value) : null;
+	}
+	getBoolean(name) {
+		const leaf = this.leaves.get(name);
+		return leaf?.type === discord_api_types_v10.ApplicationCommandOptionType.Boolean ? leaf.value : null;
+	}
+	getUser(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.User) return null;
+		return this.resolved?.users?.[leaf.value] ?? null;
+	}
+	getMember(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.User) return null;
+		return this.resolved?.members?.[leaf.value] ?? null;
+	}
+	getChannel(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.Channel) return null;
+		return this.resolved?.channels?.[leaf.value] ?? null;
+	}
+	getRole(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.Role) return null;
+		return this.resolved?.roles?.[leaf.value] ?? null;
+	}
+	getAttachment(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.Attachment) return null;
+		return this.resolved?.attachments?.[leaf.value] ?? null;
+	}
+	getMentionable(name) {
+		const leaf = this.leaves.get(name);
+		if (leaf?.type !== discord_api_types_v10.ApplicationCommandOptionType.Mentionable) return null;
+		const resolved = this.resolved;
+		return resolved?.members?.[leaf.value] ?? resolved?.users?.[leaf.value] ?? resolved?.roles?.[leaf.value] ?? null;
+	}
+	getFocused() {
+		for (const leaf of this.leaves.values()) if ("focused" in leaf && leaf.focused === true) return {
+			name: leaf.name,
+			value: String(leaf.value)
+		};
+		return null;
+	}
+};
+function numeric(value) {
+	if (typeof value === "number") return value;
+	if (value.trim() === "") return null;
+	const parsed = Number(value);
+	return Number.isNaN(parsed) ? null : parsed;
+}
+
+//#endregion
+//#region src/handlers/interaction/AutocompleteHandler.ts
+/**
+* Base class for an autocomplete handler on the HTTP transport.
+*
+* Pass the command route(s) from the generated registry as the generic. Branch on the focused field with
+* `this.match`, read already-entered sibling options with `this.options`, and find which command fired
+* with `this.route`.
+*
+* @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'search'`.
+*/
+var AutocompleteHandler = class extends _seedcord_core.BaseHandler {
+	constructor(event, core, dispatch) {
+		super(event, core, dispatch, "interactions");
+	}
+	/**
+	* Typed Discord REST API (`@discordjs/core/http-only`) over `core.rest`, one instance per core.
+	*/
+	get api() {
+		return apiFor(this.core.rest);
+	}
+	resolver;
+	get reader() {
+		this.resolver ??= new HttpSlashOptions(this.event.data);
+		return this.resolver;
+	}
+	/**
+	* The focused option for this interaction. `value` is always the raw partial string the user is typing,
+	* even for an integer or number option, so coerce it yourself when you need a number.
+	*/
+	get focused() {
+		const focused = this.reader.getFocused();
+		if (!focused) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.AutocompleteNoFocusedOption);
+		return focused;
+	}
+	/**
+	* Run the arm for the focused field. An autocomplete always dispatches by which field is focused, so
+	* match is how you read it.
+	*
+	* Provide one arm per autocompletable field across the registered commands, keyed by field name. Each
+	* arm receives the focused partial value and a `respond` typed to that field's choice value. The
+	* arms must cover every autocompletable field, a missing field or an unknown key is a compile error. A
+	* focused field with no arm, only reachable from a stale-deployed command, throws at runtime.
+	*
+	* @param arms - One handler per autocompletable field, keyed by field name.
+	* @returns The result of the arm that ran.
+	*/
+	async match(arms) {
+		const { name, value } = this.focused;
+		const respond = (choices) => this.respond(choices);
+		const arm = Object.hasOwn(arms, name) ? arms[name] : void 0;
+		if (!arm) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.AutocompleteMatchArmMissing, [name]);
+		return await arm(value, respond);
+	}
+	/** Send autocomplete suggestions, callback type 8. Prefer {@link match}, which restricts each field's choices to its declared type. */
+	async respond(choices) {
+		const routeId = this.dispatch?.routeId ?? "autocomplete";
+		await (0, _seedcord_core_internal.reportedWrite)({
+			bus: this.core.bus,
+			interactionId: this.event.id
+		}, routeId, "respond", () => this.core.rest.post(discord_api_types_v10.Routes.interactionCallback(this.event.id, this.event.token), { body: {
+			type: discord_api_types_v10.InteractionResponseType.ApplicationCommandAutocompleteResult,
+			data: { choices }
+		} }));
+	}
+	/** The firing command route, for a field whose completion differs per registered command. */
+	get route() {
+		return slashRouteOf(this.event.data);
+	}
+	/**
+	* The already-entered options on this command, restricted to the kinds Discord resolves during autocomplete
+	* (string, integer, number, boolean) with every read nullable, since a sibling is partial while the user
+	* types the focused field. The focused field is on `this.focused`.
+	*/
+	get options() {
+		return this.reader;
+	}
+};
+
+//#endregion
+//#region src/handlers/defaults/UnhandledAutocomplete.ts
+/**
+* Default handler for autocomplete no manifest row matches.
+* Empty choices are the only legal answer, they clear the pending state.
+*
+* @internal
+*/
+var UnhandledAutocomplete = class extends AutocompleteHandler {
+	async execute() {
+		await this.respond([]);
+	}
+};
+
+//#endregion
+//#region src/handlers/interaction/InteractionHandler.ts
+/**
+* Shared base the repliable interaction handlers extend.
+*
+* Not a public entry point. Extend {@link SlashHandler}, {@link ContextMenuHandler}, {@link ButtonHandler},
+* {@link SelectMenuHandler}, or {@link ModalHandler} instead. This class adds `showModal` on top of the
+* reply members.
+*
+* @typeParam Event - The repliable interaction type this handler processes
+*/
+var InteractionHandler = class extends RepliableHandler {
+	constructor(event, core, dispatch) {
+		super(event, core, dispatch);
+	}
+	/**
+	* Open a modal. Must be the initial response to this interaction. The modal kind rejects this call at
+	* compile time (Discord forbids a modal in response to a modal).
+	*/
+	showModal(modal) {
+		return this.sender.showModal(modal);
+	}
+};
+
+//#endregion
+//#region src/handlers/defaults/UnhandledRepliable.ts
+/**
+* Default handler for interactions no manifest row matches. A reply failure here
+* goes directly to the dispatch fault boundary, so it needs no guard of its own.
+*
+* @internal
+*/
+var UnhandledRepliable = class extends InteractionHandler {
+	async execute() {
+		await this.reply("Feature not implemented yet.");
+	}
+};
+
+//#endregion
+//#region src/dispatch/resolve.ts
+const COMPONENT_KIND = {
+	button: "button",
+	stringSelect: "stringMenu",
+	userSelect: "userMenu",
+	roleSelect: "roleMenu",
+	channelSelect: "channelMenu",
+	mentionableSelect: "mentionableMenu",
+	modal: "modal"
+};
+function commandKind(type) {
+	switch (type) {
+		case discord_api_types_v10.ApplicationCommandType.ChatInput: return "slash";
+		case discord_api_types_v10.ApplicationCommandType.User: return "userContextMenu";
+		case discord_api_types_v10.ApplicationCommandType.Message: return "messageContextMenu";
+		default: return null;
+	}
+}
+function componentMapKey(type) {
+	switch (type) {
+		case discord_api_types_v10.ComponentType.Button: return "button";
+		case discord_api_types_v10.ComponentType.StringSelect: return "stringSelect";
+		case discord_api_types_v10.ComponentType.UserSelect: return "userSelect";
+		case discord_api_types_v10.ComponentType.RoleSelect: return "roleSelect";
+		case discord_api_types_v10.ComponentType.ChannelSelect: return "channelSelect";
+		case discord_api_types_v10.ComponentType.MentionableSelect: return "mentionableSelect";
+		default: return null;
+	}
+}
+function namedExport(routeId, row) {
+	return async () => {
+		let moduleExports;
+		try {
+			moduleExports = await row.load();
+		} catch (caught) {
+			throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.RouteModuleLoadFailed, [routeId, row.from], { cause: caught });
+		}
+		if (!Object.hasOwn(moduleExports, row.exportName)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.InteractionRouteExportMissing, [
+			routeId,
+			row.exportName,
+			row.from
+		]);
+		return moduleExports[row.exportName];
+	};
+}
+function describeRow(row) {
+	return `${row.exportName} (${row.from})`;
+}
+/**
+* Builds the per-kind lookup maps.
+*
+* @throws A **SeedcordError** when two rows resolve to the same route.
+*/
+function buildRouteMaps(manifest) {
+	const maps = {
+		slash: /* @__PURE__ */ new Map(),
+		userContextMenu: /* @__PURE__ */ new Map(),
+		messageContextMenu: /* @__PURE__ */ new Map(),
+		autocomplete: /* @__PURE__ */ new Map(),
+		components: {
+			button: /* @__PURE__ */ new Map(),
+			stringSelect: /* @__PURE__ */ new Map(),
+			userSelect: /* @__PURE__ */ new Map(),
+			roleSelect: /* @__PURE__ */ new Map(),
+			channelSelect: /* @__PURE__ */ new Map(),
+			mentionableSelect: /* @__PURE__ */ new Map(),
+			modal: /* @__PURE__ */ new Map()
+		}
+	};
+	const owners = /* @__PURE__ */ new Map();
+	function set(map, kind, key, row) {
+		const routeId = `${kind}:${key}`;
+		const owner = owners.get(routeId);
+		if (owner) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.InteractionDuplicateRoute, [
+			routeId,
+			describeRow(owner),
+			describeRow(row)
+		]);
+		owners.set(routeId, row);
+		map.set(key, {
+			kind,
+			routeId,
+			load: namedExport(routeId, row)
+		});
+	}
+	for (const row of manifest.commandRoutes) {
+		const kind = commandKind(row.type);
+		if (kind) set(maps[kind], kind, row.name, row);
+	}
+	for (const row of manifest.autocompleteRoutes) set(maps.autocomplete, "autocomplete", row.name, row);
+	for (const row of manifest.componentRoutes) set(maps.components[row.kind], COMPONENT_KIND[row.kind], row.prefix, row);
+	return maps;
+}
+function unhandled(kind, attemptedKey) {
+	return {
+		kind,
+		routeId: null,
+		attemptedKey,
+		load: () => Promise.resolve(kind === "autocomplete" ? UnhandledAutocomplete : UnhandledRepliable)
+	};
+}
+/**
+* Matches a verified non-PING interaction to its manifest row. A known kind with no row resolves to the
+* unhandled default, whose handler replies "Feature not implemented yet." (empty choices on autocomplete).
+* Null is an unrecognized payload shape, which the engine acks with a 202 without dispatching.
+* Components and modals route by the stable customId prefix, so a wire whose layout hash drifted still
+* routes to its handler, where decode refuses with `StaleCustomId`.
+*/
+function resolve(maps, interaction) {
+	switch (interaction.type) {
+		case discord_api_types_v10.InteractionType.ApplicationCommand: {
+			if (interaction.data.type === discord_api_types_v10.ApplicationCommandType.ChatInput) {
+				const route = slashRouteOf(interaction.data);
+				return maps.slash.get(route) ?? unhandled("slash", route);
+			}
+			const kind = commandKind(interaction.data.type);
+			return kind ? maps[kind].get(interaction.data.name) ?? unhandled(kind, interaction.data.name) : null;
+		}
+		case discord_api_types_v10.InteractionType.ApplicationCommandAutocomplete: {
+			const route = slashRouteOf(interaction.data);
+			return maps.autocomplete.get(route) ?? unhandled("autocomplete", route);
+		}
+		case discord_api_types_v10.InteractionType.MessageComponent: {
+			const key = componentMapKey(interaction.data.component_type);
+			if (!key) return null;
+			const prefix = (0, _seedcord_core_internal.prefixOf)(interaction.data.custom_id);
+			return maps.components[key].get(prefix) ?? unhandled(COMPONENT_KIND[key], prefix);
+		}
+		case discord_api_types_v10.InteractionType.ModalSubmit: {
+			const prefix = (0, _seedcord_core_internal.prefixOf)(interaction.data.custom_id);
+			return maps.components.modal.get(prefix) ?? unhandled("modal", prefix);
+		}
+		default: return null;
+	}
+}
+
+//#endregion
+//#region src/receiver/Ed25519Verifier.ts
+const PUBLIC_KEY_BYTES = 32;
+const SIGNATURE_BYTES = 64;
+const HEX_RADIX = 16;
+const HEX_PATTERN = /^[0-9a-f]+$/i;
+function hexToBytes(hex, byteLength) {
+	if (hex.length !== byteLength * 2 || !HEX_PATTERN.test(hex)) return null;
+	const bytes = new Uint8Array(byteLength);
+	for (let index = 0; index < byteLength; index++) bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), HEX_RADIX);
+	return bytes;
+}
+const encoder = new TextEncoder();
+var Ed25519Verifier = class {
+	key;
+	constructor(publicKeyHex) {
+		const publicKey = hexToBytes(publicKeyHex, PUBLIC_KEY_BYTES);
+		if (!publicKey) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.ConfigIncorrectPublicKey);
+		this.key = crypto.subtle.importKey("raw", publicKey, "Ed25519", false, ["verify"]);
+	}
+	async verify(signatureHex, timestamp, body) {
+		const signature = hexToBytes(signatureHex, SIGNATURE_BYTES);
+		if (!signature) return false;
+		const timestampBytes = encoder.encode(timestamp);
+		const message = new Uint8Array(timestampBytes.length + body.length);
+		message.set(timestampBytes, 0);
+		message.set(body, timestampBytes.length);
+		return crypto.subtle.verify("Ed25519", await this.key, signature, message);
+	}
+};
+
+//#endregion
+//#region src/receiver/ReplayGuard.ts
+const REPLAY_WINDOW_MS = 3e5;
+const SWEEP_GAP_MS = 6e4;
+const MS_PER_SECOND = 1e3;
+const TIMESTAMP_PATTERN = /^\d+$/;
+var ReplayGuard = class {
+	seen = /* @__PURE__ */ new Map();
+	lastSweep = Date.now();
+	accepts(signatureHex, timestampHeader) {
+		const now = Date.now();
+		this.maybeSweep(now);
+		if (!TIMESTAMP_PATTERN.test(timestampHeader)) return false;
+		const timestampMs = Number(timestampHeader) * MS_PER_SECOND;
+		if (Math.abs(now - timestampMs) > REPLAY_WINDOW_MS) return false;
+		const rejectUntil = this.seen.get(signatureHex);
+		if (rejectUntil !== void 0 && rejectUntil >= now) return false;
+		this.seen.set(signatureHex, timestampMs + REPLAY_WINDOW_MS);
+		return true;
+	}
+	maybeSweep(now) {
+		if (now - this.lastSweep < SWEEP_GAP_MS) return;
+		this.lastSweep = now;
+		for (const [signature, rejectUntil] of this.seen) if (rejectUntil < now) this.seen.delete(signature);
+	}
+};
+
+//#endregion
+//#region src/engine.ts
+const SIGNATURE_HEADER = "x-signature-ed25519";
+const TIMESTAMP_HEADER = "x-signature-timestamp";
+const ACCEPTED = 202;
+const BAD_REQUEST = 400;
+const UNAUTHORIZED = 401;
+const METHOD_NOT_ALLOWED = 405;
+const PING = discord_api_types_v10.InteractionType.Ping;
+const decoder = new TextDecoder();
+function hasInteractionType(payload) {
+	return typeof payload === "object" && payload !== null && "type" in payload && typeof payload.type === "number";
+}
+function buildEngine(core, maps) {
+	if (!envapt.Envapter.has("DISCORD_PUBLIC_KEY")) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.ConfigMissingPublicKey);
+	const verifier = new Ed25519Verifier(envapt.Envapter.getRequired("DISCORD_PUBLIC_KEY", envapt.Converters.String));
+	const replays = new ReplayGuard();
+	const inFlight = /* @__PURE__ */ new Set();
+	const logger = new _seedcord_logger.Logger("Engine", { channel: "bot" });
+	async function dispatchMatched(match, payload, ctx) {
+		const start = await dispatchInteraction({
+			match,
+			payload,
+			core
+		});
+		if (!start) return;
+		const work = start().catch(rootFault);
+		if (ctx) ctx.waitUntil(work);
+		else {
+			inFlight.add(work);
+			work.finally(() => inFlight.delete(work));
+		}
+	}
+	function rootFault(caught) {
+		const error = (0, _seedcord_core_internal.asError)(caught);
+		logger.error("dispatch failed past the boundary", error);
+		core.bus[_seedcord_core_internal.PublishDefault]("unhandledInteractionError", { error });
+	}
+	const handle = async (request, ctx) => {
+		if (request.method !== "POST") return new Response(null, {
+			status: METHOD_NOT_ALLOWED,
+			headers: { allow: "POST" }
+		});
+		const signature = request.headers.get(SIGNATURE_HEADER);
+		const timestamp = request.headers.get(TIMESTAMP_HEADER);
+		if (signature === null || timestamp === null) return new Response(null, { status: UNAUTHORIZED });
+		const body = new Uint8Array(await request.arrayBuffer());
+		if (!await verifier.verify(signature, timestamp, body)) return new Response(null, { status: UNAUTHORIZED });
+		if (!replays.accepts(signature, timestamp)) return new Response(null, { status: UNAUTHORIZED });
+		let payload;
+		try {
+			payload = JSON.parse(decoder.decode(body));
+		} catch {
+			return new Response(null, { status: BAD_REQUEST });
+		}
+		if (!hasInteractionType(payload)) return new Response(null, { status: BAD_REQUEST });
+		if (payload.type === PING) return Response.json({ type: discord_api_types_v10.InteractionResponseType.Pong });
+		try {
+			core.bus[_seedcord_core_internal.PublishDefault]("anyInteraction", { interaction: payload });
+			const match = resolve(maps, payload);
+			if (match) await dispatchMatched(match, payload, ctx);
+		} catch (caught) {
+			rootFault(caught);
+		}
+		return new Response(null, { status: ACCEPTED });
+	};
+	return {
+		handle,
+		inFlight
+	};
+}
+
+//#endregion
+//#region src/createSeedcord.ts
+/**
+* Builds the HTTP-interactions engine, a `(request, ctx?) => Promise<Response>` handler.
+*
+* The handler verifies the Ed25519 signature over the raw request bytes, rejects stale or replayed
+* requests, answers a PING with an in-body PONG, and acks every other interaction with an empty 202.
+* The engine dispatches a matched interaction through the manifest before the 202 goes out. Gates run
+* first and the sender posts any refusal over the REST callback. `execute()` continues past the 202 under
+* `ctx.waitUntil` when the caller passes one (the edge entry), and an engine-held in-flight set tracks
+* it otherwise (node paths). It reads only the method, headers, and body. Mount it at any path.
+*
+* Reads `DISCORD_PUBLIC_KEY` and `DISCORD_BOT_TOKEN` from the environment through envapt and throws a
+* `SeedcordError` when either is missing or malformed.
+*/
+function createSeedcord(config, manifest) {
+	const core = createCore(config, (0, _seedcord_errors_internal.validateDiscordToken)(envapt.Envapter.get("DISCORD_BOT_TOKEN")));
+	core.bus.registerDefaults();
+	registerSubscribers(core.bus, manifest);
+	return buildEngine(core, buildRouteMaps(manifest)).handle;
+}
+
+//#endregion
+//#region src/handlers/interaction/SlashHandler.ts
+/**
+* Base class for a chat-input (slash) command handler on the HTTP transport.
+*
+* Pass the route from the generated registry as the generic, then read `this.options` for a single
+* command or `this.match` for several. Command authoring stays plain discord.js, `seedcord codegen`
+* reads its `toJSON()` to type these options.
+*
+* @typeParam Route - One or more route keys from {@link SlashOptionRegistry}, e.g. `'ban'` or `'ban' | 'kick'`.
+*/
+var SlashHandler = class extends InteractionHandler {
+	resolver;
+	/**
+	* The typed options for this command's route. Required options drop the null, choices narrow to their
+	* literal union, and only the getters for kinds this command actually uses appear. Rich kinds resolve
+	* from the interaction's `resolved` data.
+	*/
+	get options() {
+		this.resolver ??= new HttpSlashOptions(this.event.data);
+		return this.resolver;
+	}
+	/**
+	* Run the arm for whichever command fired. Use this only when the handler is registered for several
+	* routes.
+	*
+	* Provide one arm per registered route, keyed by its route string, and each arm receives that route's
+	* own narrowed options. The arms must cover every route in the generic, a missing route or an unknown
+	* key is a compile error.
+	*
+	* @param arms - One handler per registered route, keyed by route string.
+	* @returns The result of the arm that ran.
+	*/
+	async match(arms) {
+		const route = slashRouteOf(this.event.data);
+		const arm = Object.hasOwn(arms, route) ? arms[route] : void 0;
+		if (!arm) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.SlashMatchArmMissing, [route]);
+		return await arm(this.options);
+	}
+};
+
+//#endregion
+//#region src/handlers/interaction/ContextMenuHandler.ts
+/**
+* Base class for a context-menu command handler on the HTTP transport (right-click a user or a message).
+*
+* Pass the kind from {@link ApplicationCommandType} as the generic. Read the right-clicked entity from
+* `this.target`, an `APIUser` for a user menu and an `APIMessage` for a message menu. Context menus carry
+* no options, so a handler registered for several names reads `this.target` uniformly with no per-name
+* branch.
+*
+* @typeParam Kind - `ApplicationCommandType.User` or `ApplicationCommandType.Message`.
+*/
+var ContextMenuHandler = class extends InteractionHandler {
+	get target() {
+		const data = this.event.data;
+		return data.type === discord_api_types_v10.ApplicationCommandType.User ? data.resolved.users[data.target_id] : data.resolved.messages[data.target_id];
+	}
+	/**
+	* The right-clicked user's guild member, resolved only on user menus fired in a guild. Reading it on a
+	* message menu is a compile error.
+	*/
+	get targetMember() {
+		const data = this.event.data;
+		return data.type === discord_api_types_v10.ApplicationCommandType.User ? data.resolved.members?.[data.target_id] ?? null : null;
+	}
+};
+
+//#endregion
+//#region src/handlers/interaction/components/ComponentHandler.ts
+/**
+* Shared base the customId-routed component handlers extend on the HTTP transport.
+*
+* Not a public entry point. Extend {@link ButtonHandler}, {@link SelectMenuHandler}, or {@link ModalHandler}
+* instead. This class defines the customId decode, the route matching, and the source-message verbs
+* `update` and `deferUpdate`.
+*
+* @typeParam Event - The component or modal interaction type this handler processes
+* @typeParam Defs - The customId route definitions registered on the concrete handler
+*/
+var ComponentHandler = class extends InteractionHandler {
+	/** Rewrite the source message this component interaction came from. */
+	update(response) {
+		return this.sender.update(response);
+	}
+	/** Acknowledge the component without changing the source message. */
+	deferUpdate() {
+		return this.sender.deferUpdate();
+	}
+	decoded;
+	get route() {
+		this.decoded ??= (0, _seedcord_core_internal.decodeComponentRoute)(this.constructor, this.event.data.custom_id);
+		return this.decoded;
+	}
+	/**
+	* The decoded params of the single route this handler is registered for.
+	*
+	* Reading this decodes `this.event.data.custom_id` once (cached after the first read) and throws
+	* `StaleCustomId` or `InvalidCustomId` when the wire no longer matches the current shape, which the
+	* dispatcher boundary turns into a reply. On a handler registered for several routes this is
+	* `never`, so use {@link match} instead.
+	*/
+	get params() {
+		return this.route.params;
+	}
+	/**
+	* Run the arm for whichever route the component was minted from. Use this only when the handler is
+	* registered for several routes. A single-route handler reads `this.params` directly. On a multi-route
+	* handler `this.params` is `never`, so match is the only way to read the decoded params.
+	*
+	* Provide one arm per registered route, keyed by its prefix, and each arm receives that route's own
+	* decoded params. The arms cover every registered route prefix, checked at compile time, and a prefix
+	* unmatched at runtime throws `CustomIdMatchArmMissing`. Decoding runs before any arm, so a stale or
+	* corrupt wire throws before an arm body executes.
+	*
+	* @param arms - One callback per registered route, keyed by prefix.
+	* @returns The result of the arm that ran.
+	*
+	* @example
+	* ```ts
+	* \@ButtonRoute(Approve, Reject)
+	* class ReviewButtons extends ButtonHandler<[typeof Approve, typeof Reject]> {
+	*     async execute() {
+	*         await this.match({
+	*             approve: ({ userId }) => this.reply(`approved <@${userId}>`),
+	*             reject: ({ userId }) => this.reply(`rejected <@${userId}>`)
+	*         });
+	*     }
+	* }
+	* ```
+	*/
+	async match(arms) {
+		const { prefix, params } = this.route;
+		const arm = Object.hasOwn(arms, prefix) ? arms[prefix] : void 0;
+		if (!arm) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CustomIdMatchArmMissing, [prefix]);
+		return await arm(params);
+	}
+};
+
+//#endregion
+//#region src/handlers/interaction/components/ButtonHandler.ts
+/**
+* Base class for a button interaction handler on the HTTP transport.
+*
+* Register the customId definitions this handler decodes with `@ButtonRoute`, list the same ones in the
+* generic, then read `this.params` for a single route or `this.match` for several. Reply through the
+* handler members, or rewrite the source message with `this.update`. Passing different definitions to the
+* decorator and the generic is a compile error.
+*
+* @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ApproveId]`.
+*/
+var ButtonHandler = class extends ComponentHandler {};
+
+//#endregion
+//#region src/handlers/interaction/components/SelectMenuHandler.ts
+/**
+* Base class for a select menu handler on the HTTP transport.
+*
+* Pass the select kind first and the customId definitions second, the same order as `@SelectMenuRoute`,
+* so `this.event.data` and its `values`/`resolved` are narrowed to that kind. Read `this.params` for a
+* single route or `this.match` for several, and reply through the handler members or rewrite the source
+* message with `this.update`.
+*
+* @typeParam Kind - The select kind from {@link SelectMenuKind}, e.g. `SelectMenuKind.User`.
+* @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof AssignId]`.
+*/
+var SelectMenuHandler = class extends ComponentHandler {};
+
+//#endregion
+//#region src/handlers/interaction/components/ModalHandler.ts
+/**
+* Base class for a modal submit handler on the HTTP transport.
+*
+* Register the customId definitions this handler decodes with `@ModalRoute` and list the same ones in the
+* generic. Read the submitted inputs off `this.event.data.components`. Reply through the handler members.
+* Discord forbids opening a modal in response to a modal, so `showModal` fails compilation on this kind.
+*
+* @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ConfigId]`.
+*/
+var ModalHandler = class extends ComponentHandler {
+	/** Rewrite the message this modal was opened from (only when a component opened it). */
+	update(response) {
+		this.ensureSourceMessage("update");
+		return super.update(response);
+	}
+	/** Silently acknowledge, leaving the source message untouched. */
+	deferUpdate() {
+		this.ensureSourceMessage("deferUpdate");
+		return super.deferUpdate();
+	}
+	ensureSourceMessage(method) {
+		if (this.event.message) return;
+		throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.ReplyUpdateWithoutSource, [method, this.routeId]);
+	}
+};
+
+//#endregion
+//#region src/subscribers/index.ts
+/**
+* Base class for an HTTP subscriber, binding `this.core` to the HTTP {@link Core}.
+*
+* @typeParam KeyOfSubscribers - The subscription key this handler receives
+*/
+var Subscriber = class extends _seedcord_core.Subscriber {};
+/**
+* Base class for an HTTP subscriber that delivers its event to a Discord webhook, binding
+* `this.core` to the HTTP {@link Core}.
+*
+* @typeParam KeyOfSubscribers - The subscription key this reporter receives
+*/
+var WebhookLog = class extends _seedcord_core.WebhookLog {};
+
+//#endregion
+//#region src/gates/Gated.ts
+/**
+* Attaches gates to an HTTP interaction handler. The gates run before `execute`, and a gate refusing stops
+* the handler with the reply or drop the gate threw. Multiple gates are ANDed, so each must pass. A gate
+* that requires a context the handler does not provide (a button gate on a slash handler, a gate on an
+* autocomplete handler, or a `RequirePermissions([...], { in: 'guild' })` gate the http transport cannot
+* satisfy) is a compile error at this line, and the error names the gate and the handler kind. Place it
+* above the route decorator.
+*
+* Combine gates with {@link and} or {@link or} to build a single gate from multiple arms.
+*
+* @example
+* ```ts
+* import { PermissionFlagsBits } from 'discord-api-types/v10';
+*
+* \@Gated(GuildOnly(), RequirePermissions([PermissionFlagsBits.ManageMessages]))
+* \@SlashRoute('purge')
+* class Purge extends SlashHandler<'purge'> {
+*     async execute() {
+*         // both gates passed, so this runs in a guild with a caller who can moderate this channel
+*     }
+* }
+* ```
+*
+* @typeParam Gates - The non-empty tuple of gates to run, in order, against the handler's context.
+* @typeParam TCtor - The decorated handler's constructor, checked against every gate's required context.
+* @param gates - One or more gates to attach, each ANDed so the handler runs only when all pass.
+* @param ctor - The handler class being decorated, rejected at compile time when a gate requires a context it lacks.
+*
+* @see {@link defineGate}
+* @see {@link defineEffectGate}
+* @decorator
+*/
+function Gated(...gates) {
+	return function(ctor) {
+		const existing = Reflect.getMetadata(_seedcord_core_internal.GatedMetadataKey, ctor) ?? [];
+		Reflect.defineMetadata(_seedcord_core_internal.GatedMetadataKey, [...existing, ...gates], ctor);
+	};
+}
+
+//#endregion
+//#region src/version.ts
+/** Package version */
+const version = "0.1.0-next.2";
+
+//#endregion
+Object.defineProperty(exports, 'AutocompleteHandler', {
+  enumerable: true,
+  get: function () {
+    return AutocompleteHandler;
+  }
+});
+Object.defineProperty(exports, 'ButtonHandler', {
+  enumerable: true,
+  get: function () {
+    return ButtonHandler;
+  }
+});
+Object.defineProperty(exports, 'ComponentHandler', {
+  enumerable: true,
+  get: function () {
+    return ComponentHandler;
+  }
+});
+Object.defineProperty(exports, 'ContextMenuHandler', {
+  enumerable: true,
+  get: function () {
+    return ContextMenuHandler;
+  }
+});
+Object.defineProperty(exports, 'Gated', {
+  enumerable: true,
+  get: function () {
+    return Gated;
+  }
+});
+Object.defineProperty(exports, 'InteractionHandler', {
+  enumerable: true,
+  get: function () {
+    return InteractionHandler;
+  }
+});
+Object.defineProperty(exports, 'ModalHandler', {
+  enumerable: true,
+  get: function () {
+    return ModalHandler;
+  }
+});
+Object.defineProperty(exports, 'RepliableHandler', {
+  enumerable: true,
+  get: function () {
+    return RepliableHandler;
+  }
+});
+Object.defineProperty(exports, 'SelectMenuHandler', {
+  enumerable: true,
+  get: function () {
+    return SelectMenuHandler;
+  }
+});
+Object.defineProperty(exports, 'SlashHandler', {
+  enumerable: true,
+  get: function () {
+    return SlashHandler;
+  }
+});
+Object.defineProperty(exports, 'Subscriber', {
+  enumerable: true,
+  get: function () {
+    return Subscriber;
+  }
+});
+Object.defineProperty(exports, 'WebhookLog', {
+  enumerable: true,
+  get: function () {
+    return WebhookLog;
+  }
+});
+Object.defineProperty(exports, '__exportAll', {
+  enumerable: true,
+  get: function () {
+    return __exportAll;
+  }
+});
+Object.defineProperty(exports, '__reExport', {
+  enumerable: true,
+  get: function () {
+    return __reExport;
+  }
+});
+Object.defineProperty(exports, 'buildEngine', {
+  enumerable: true,
+  get: function () {
+    return buildEngine;
+  }
+});
+Object.defineProperty(exports, 'buildRouteMaps', {
+  enumerable: true,
+  get: function () {
+    return buildRouteMaps;
+  }
+});
+Object.defineProperty(exports, 'createSeedcord', {
+  enumerable: true,
+  get: function () {
+    return createSeedcord;
+  }
+});
+Object.defineProperty(exports, 'version', {
+  enumerable: true,
+  get: function () {
+    return version;
+  }
+});
+//# sourceMappingURL=edge.index-joDL39cK.cjs.map