@seedcord/core 0.5.0 → 0.7.0

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { H as Notice, I as InteractionKind, S as AckState, _ as SubscriptionData, b as ReplyTelemetry, c as Subscriber, d as DispatchOutcome, f as FaultSource, g as ResponseSent, h as ResponseOutcome, i as Bus, l as AttemptedWrite, m as ResponseFailed, n as StartupPhase, p as ResponseAttempt, r as CoreBase, t as ShutdownPhase, v as SubscriptionKey, y as Subscriptions } from "./phases-D0a8BV9Z.mjs";
-import { $ as MessageContextMenuRegistry, C as Gate, D as defineEffectGate, E as RequiredOf, F as ContextMenuNamesBrand, H as RowComponent, I as SlashRouteBrand, M as ComponentDefsBrand, N as ComponentKindBrand, O as defineGate, P as ContextMenuKindBrand, R as RegisterCommand, S as EffectGate, T as GuildPermissionsContext, U as BuilderType, V as BuilderComponent, W as RowType, Y as SlashRegistry, Z as ContextMenuKind, a as AutocompleteOptions, b as JoinNames, d as RequirePermissionsOptions, et as NamesFor, f as RequireRole, g as GateNoticeOptions, h as PermissionScope, j as AutocompleteRouteBrand, k as SerializedReply, l as RequireBotPermissions, n as PageCursor, p as RequireRoleOptions, tt as UserContextMenuRegistry, u as RequirePermissions, w as GateContextBase, x as TwoOrMore, y as IntersectRequired, z as Promisable } from "./cursor-8Y2zpF-Y.mjs";
+import { G as Notice, H as MiddlewareKind, N as DispatchContext, R as InteractionKind, S as AckState, _ as SubscriptionData, b as ReplyTelemetry, c as Subscriber, d as DispatchOutcome, f as FaultSource, g as ResponseSent, h as ResponseOutcome, i as Bus, l as AttemptedWrite, m as ResponseFailed, n as StartupPhase, p as ResponseAttempt, r as CoreBase, t as ShutdownPhase, v as SubscriptionKey, y as Subscriptions } from "./phases-DJf12l5T.mjs";
+import { $ as BuilderType, B as AutocompleteRouteBrand, C as Gate, D as defineEffectGate, E as RequiredOf, H as ComponentKindBrand, J as RegisterCommand, K as SlashRouteBrand, L as InteractionMiddlewareOptions, M as EventDispatchResult, N as HandlerOutcome, O as defineGate, P as HandlerResult, Q as RowComponent, R as RegisterInteractionMiddleware, S as EffectGate, T as GuildPermissionsContext, U as ContextMenuKindBrand, V as ComponentDefsBrand, W as ContextMenuNamesBrand, Y as Promisable, Z as BuilderComponent, a as AutocompleteOptions, at as SlashRegistry, b as JoinNames, d as RequirePermissionsOptions, dt as UserContextMenuRegistry, et as RowType, f as RequireRole, g as GateNoticeOptions, h as PermissionScope, j as DispatchResult, k as SerializedReply, l as RequireBotPermissions, lt as MessageContextMenuRegistry, n as PageCursor, p as RequireRoleOptions, st as ContextMenuKind, u as RequirePermissions, ut as NamesFor, w as GateContextBase, x as TwoOrMore, y as IntersectRequired } from "./cursor-BY5dmiz6.mjs";
 import { t as Constructor } from "./basic-Dng__Ena.mjs";
-import { a as Subscribe, i as WebhookFile, n as WebhookLog, o as SubscribeOptions, r as WebhookReport, t as WebhookUrl } from "./index-CD8l15aZ.mjs";
+import { a as Subscribe, i as WebhookFile, n as WebhookLog, o as SubscribeOptions, r as WebhookReport, t as WebhookUrl } from "./index-BS1hH9Sh.mjs";
 import "reflect-metadata";
-import { AnyCustomId, CustomId, FieldOptions, setCustomIdErrors } from "@seedcord/custom-id";
+import { AnyCustomId, AnyCustomId as AnyCustomId$1, CustomId, CustomIdField, CustomIdShape, DecodedParams, DecodedRoute, FieldOptions, decodeFor, prefixOf, setCustomIdErrors } from "@seedcord/custom-id";
 import { ActionRowBuilder, ButtonBuilder } from "@discordjs/builders";
 import { APIMessageComponentEmoji, APIModalInteractionResponseCallbackData, ApplicationCommandType, ButtonStyle } from "discord-api-types/v10";
 import { Logger } from "@seedcord/logger";
@@ -83,12 +83,12 @@ type ComponentOf<TCtor extends AnyHandlerCtor> = InstanceType<TCtor> extends {
   [ComponentKindBrand]?: infer Brand extends ComponentBrand;
 } ? Brand : never;
 type DefsOf<TCtor extends AnyHandlerCtor> = InstanceType<TCtor> extends {
-  [ComponentDefsBrand]?: infer Defs extends readonly AnyCustomId[];
+  [ComponentDefsBrand]?: infer Defs extends readonly AnyCustomId$1[];
 } ? Defs : never;
-type AssertSlashRoute<Route extends keyof SlashRegistry, TCtor extends AnyHandlerCtor> = [Route] extends [SlashRouteOf<TCtor>] ? [SlashRouteOf<TCtor>] extends [Route] ? TCtor : Constructor<['SlashHandler declares a route the SlashRoute decorator does not list', SlashRouteOf<TCtor>]> : Constructor<['SlashRoute does not match the SlashHandler generic', Route]>;
-type AssertAutocompleteRoute<Route extends keyof SlashRegistry, TCtor extends AnyHandlerCtor> = [Route] extends [AutocompleteRouteOf<TCtor>] ? [AutocompleteRouteOf<TCtor>] extends [Route] ? TCtor : Constructor<['AutocompleteHandler declares a command the AutocompleteRoute decorator does not list', AutocompleteRouteOf<TCtor>]> : Constructor<['AutocompleteRoute does not match the AutocompleteHandler generic', Route]>;
-type AssertContextMenuRoute<Kind extends ContextMenuKind, Names extends NamesFor<Kind>, TCtor extends AnyHandlerCtor> = [Kind] extends [ContextMenuKindOf<TCtor>] ? [ContextMenuKindOf<TCtor>] extends [Kind] ? [Names] extends [ContextMenuNamesOf<TCtor>] ? [ContextMenuNamesOf<TCtor>] extends [Names] ? TCtor : Constructor<['ContextMenuHandler declares a name the ContextMenuRoute decorator does not list', ContextMenuNamesOf<TCtor>]> : Constructor<['ContextMenuRoute lists a name the ContextMenuHandler generic does not declare', Names]> : Constructor<['ContextMenuHandler declares a kind the ContextMenuRoute decorator does not match', ContextMenuKindOf<TCtor>]> : Constructor<['ContextMenuRoute does not match the ContextMenuHandler generic', Kind]>;
-type AssertComponentRoute<Brand extends ComponentBrand, Defs extends readonly AnyCustomId[], TCtor extends AnyHandlerCtor> = [ComponentOf<TCtor>] extends [Brand] ? [Brand] extends [ComponentOf<TCtor>] ? [DefsOf<TCtor>] extends [Defs] ? TCtor : Constructor<['the customId definitions do not match the handler generic', DefsOf<TCtor>]> : Constructor<['the decorator does not match the handler kind', ComponentOf<TCtor>]> : Constructor<['the decorator does not match the handler kind', ComponentOf<TCtor>]>;
+type AssertSlashRoute<Route extends keyof SlashRegistry, TCtor extends AnyHandlerCtor> = [Route] extends [SlashRouteOf<TCtor>] ? [SlashRouteOf<TCtor>] extends [Route] ? TCtor : Constructor<['SlashHandler declares a route that the SlashRoute decorator does not list', SlashRouteOf<TCtor>]> : Constructor<['SlashRoute does not match the SlashHandler generic', Route]>;
+type AssertAutocompleteRoute<Route extends keyof SlashRegistry, TCtor extends AnyHandlerCtor> = [Route] extends [AutocompleteRouteOf<TCtor>] ? [AutocompleteRouteOf<TCtor>] extends [Route] ? TCtor : Constructor<['AutocompleteHandler declares a command that the AutocompleteRoute decorator does not list', AutocompleteRouteOf<TCtor>]> : Constructor<['AutocompleteRoute does not match the AutocompleteHandler generic', Route]>;
+type AssertContextMenuRoute<Kind extends ContextMenuKind, Names extends NamesFor<Kind>, TCtor extends AnyHandlerCtor> = [Kind] extends [ContextMenuKindOf<TCtor>] ? [ContextMenuKindOf<TCtor>] extends [Kind] ? [Names] extends [ContextMenuNamesOf<TCtor>] ? [ContextMenuNamesOf<TCtor>] extends [Names] ? TCtor : Constructor<['ContextMenuHandler declares a name that the ContextMenuRoute decorator does not list', ContextMenuNamesOf<TCtor>]> : Constructor<['ContextMenuRoute lists a name that the ContextMenuHandler generic does not declare', Names]> : Constructor<['ContextMenuHandler declares a kind that the ContextMenuRoute decorator does not match', ContextMenuKindOf<TCtor>]> : Constructor<['ContextMenuRoute does not match the ContextMenuHandler generic', Kind]>;
+type AssertComponentRoute<Brand extends ComponentBrand, Defs extends readonly AnyCustomId$1[], TCtor extends AnyHandlerCtor> = [ComponentOf<TCtor>] extends [Brand] ? [Brand] extends [ComponentOf<TCtor>] ? [DefsOf<TCtor>] extends [Defs] ? TCtor : Constructor<['the customId definitions do not match the handler generic', DefsOf<TCtor>]> : Constructor<['the decorator does not match the handler kind', ComponentOf<TCtor>]> : Constructor<['the decorator does not match the handler kind', ComponentOf<TCtor>]>;
 /**
  * Routes one or more slash commands to a `SlashHandler`.
  *
@@ -179,7 +179,7 @@ declare function MessageContextMenuRoute<const Names extends NamesFor<Applicatio
  * @param defs - The customId definition(s) this handler decodes, one per route.
  * @decorator
  */
-declare function ButtonRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.Button, Defs, TCtor>) => void;
+declare function ButtonRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.Button, Defs, TCtor>) => void;
 /**
  * Routes modal submissions to handler classes.
  *
@@ -190,7 +190,7 @@ declare function ButtonRoute<const Defs extends readonly AnyCustomId[]>(...defs:
  * @param defs - The customId definition(s) this handler decodes, one per route.
  * @decorator
  */
-declare function ModalRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.Modal, Defs, TCtor>) => void;
+declare function ModalRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.Modal, Defs, TCtor>) => void;
 /**
  * Routes string select menu interactions to a `StringMenuHandler`.
  *
@@ -209,7 +209,7 @@ declare function ModalRoute<const Defs extends readonly AnyCustomId[]>(...defs:
  * }
  * ```
  */
-declare function StringMenuRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.StringMenu, Defs, TCtor>) => void;
+declare function StringMenuRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.StringMenu, Defs, TCtor>) => void;
 /**
  * Routes user select menu interactions to a `UserMenuHandler`.
  *
@@ -230,7 +230,7 @@ declare function StringMenuRoute<const Defs extends readonly AnyCustomId[]>(...d
  * }
  * ```
  */
-declare function UserMenuRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.UserMenu, Defs, TCtor>) => void;
+declare function UserMenuRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.UserMenu, Defs, TCtor>) => void;
 /**
  * Routes role select menu interactions to a `RoleMenuHandler`.
  *
@@ -249,7 +249,7 @@ declare function UserMenuRoute<const Defs extends readonly AnyCustomId[]>(...def
  * }
  * ```
  */
-declare function RoleMenuRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.RoleMenu, Defs, TCtor>) => void;
+declare function RoleMenuRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.RoleMenu, Defs, TCtor>) => void;
 /**
  * Routes channel select menu interactions to a `ChannelMenuHandler`.
  *
@@ -268,7 +268,7 @@ declare function RoleMenuRoute<const Defs extends readonly AnyCustomId[]>(...def
  * }
  * ```
  */
-declare function ChannelMenuRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.ChannelMenu, Defs, TCtor>) => void;
+declare function ChannelMenuRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.ChannelMenu, Defs, TCtor>) => void;
 /**
  * Routes mentionable select menu interactions to a `MentionableMenuHandler`.
  *
@@ -288,27 +288,7 @@ declare function ChannelMenuRoute<const Defs extends readonly AnyCustomId[]>(...
  * }
  * ```
  */
-declare function MentionableMenuRoute<const Defs extends readonly AnyCustomId[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.MentionableMenu, Defs, TCtor>) => void;
-//#endregion
-//#region src/dispatch/DispatchContext.d.ts
-/**
- * The per-dispatch bag. Any code can merge fields into it by declaration merging, the
- * same pattern as {@link SlashRegistry}. It stays empty until one does, so `keyof DispatchState` is
- * `never` and the bag is inert.
- */
-interface DispatchState {}
-/**
- * A typed bag allocated once per interaction dispatch and handed to the handler. The middleware and i18n
- * work reads and writes it through {@link DispatchState}. Today the bag is empty, so it only carries the
- * dispatched `routeId`.
- */
-declare class DispatchContext {
-  readonly routeId: string | null;
-  private readonly state;
-  constructor(routeId: string | null);
-  set<Key extends keyof DispatchState>(key: Key, value: DispatchState[Key]): void;
-  get<Key extends keyof DispatchState>(key: Key): DispatchState[Key] | undefined;
-}
+declare function MentionableMenuRoute<const Defs extends readonly AnyCustomId$1[]>(...defs: Defs): <TCtor extends AnyHandlerCtor>(constructor: AssertComponentRoute<InteractionKind.MentionableMenu, Defs, TCtor>) => void;
 //#endregion
 //#region src/handlers/BaseHandler.d.ts
 /**
@@ -322,8 +302,9 @@ declare abstract class BaseHandler<Event, TCore extends CoreBase> {
   readonly core: TCore;
   protected readonly event: Event;
   protected readonly logger: Logger;
-  protected readonly dispatch?: DispatchContext | undefined;
-  protected constructor(event: Event, core: TCore, dispatch?: DispatchContext, channel?: LoggerChannelId);
+  /** The bag for this dispatch. Each interaction gets its own. Every handler for one event shares a single bag. */
+  protected readonly dispatch: DispatchContext;
+  protected constructor(event: Event, core: TCore, dispatch: DispatchContext, channel?: LoggerChannelId);
   /**
    * Holds the main logic of your handler. The dispatcher calls it after the handler's gates pass, so a
    * gate that refuses stops `execute()` from running.
@@ -345,12 +326,12 @@ interface ModalLike {
 declare abstract class BaseReplySender<TMessage extends {
   id: string;
 }, TNative = never> {
-  protected readonly routeId: string;
   private readonly telemetry;
   private state;
   private readonly sent;
   private ackedBy?;
-  protected constructor(routeId: string, telemetry: ReplyTelemetry, initialState?: AckState);
+  protected constructor(telemetry: ReplyTelemetry, initialState?: AckState);
+  protected get routeId(): string;
   private report;
   private attempt;
   reply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
@@ -392,8 +373,8 @@ declare abstract class BaseReplySender<TMessage extends {
 //#endregion
 //#region src/handlers/RepliableHandler.d.ts
 /**
- * Shared base the repliable handlers on both transports extend. Defines the reply members over the sender
- * the transport builds.
+ * Shared base the repliable handlers on both transports extend. Defines the reply members over one sender.
+ * A handler builds its own through `buildSender`. A middleware takes the handler's.
  *
  * @typeParam Event - The repliable interaction type this handler processes
  * @typeParam TCore - The transport's Core
@@ -407,8 +388,8 @@ declare abstract class RepliableHandler<Event, TCore extends CoreBase, TMessage
   /** The reply surface for this interaction. Pass the handler to reply from outside its class. */
   readonly sender: TSender;
   protected readonly routeId: string;
-  protected constructor(event: Event, core: TCore, dispatch?: DispatchContext);
-  protected abstract buildSender(event: Event, core: TCore, routeId: string): TSender;
+  protected constructor(event: Event, core: TCore, dispatch: DispatchContext, sender?: TSender);
+  protected abstract buildSender(event: Event, core: TCore, dispatch: DispatchContext): TSender;
   /** Send the initial response, exactly once. */
   protected reply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
   /** Show a "thinking" placeholder, then fill it later with {@link edit}. */
@@ -860,7 +841,7 @@ interface PageView<Item> {
  */
 declare function paginate<Item>(items: readonly Item[], page: number, perPage: number): PageView<Item>;
 //#endregion
-//#region src/pagination/controls.d.ts
+//#region src/pagination/Controls.d.ts
 /** The five built-in nav controls. */
 type ControlKey = 'first' | 'prev' | 'indicator' | 'next' | 'last';
 type CustomIdStyle = ButtonStyle.Primary | ButtonStyle.Secondary | ButtonStyle.Success | ButtonStyle.Danger;
@@ -982,5 +963,5 @@ declare abstract class PaginatorBase<Item, Prefix extends string, Ctx> {
 /** Package version */
 declare const version: string;
 //#endregion
-export { ArraySourceBase, type AttemptedWrite, type AutocompleteOptions, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, type BuilderType, Bus, ButtonRoute, ChannelMenuRoute, type CommandInfo, Commands, type ContextMenuInfo, ContextMenus, type ControlCosmetics, type ControlKey, Cooldown, type CooldownOptions, type CoreBase, CursorSourceBase, CustomId, DispatchContext, type DispatchOutcome, type DispatchState, DmOnly, type EffectGate, Fault, type FaultSource, type FieldOptions, type Gate, type GateContextBase, type GateNoticeOptions, GuildOnly, type GuildPermissionsContext, type InjectedCommandMap, type InjectedContextMenuMap, InteractionKind, type ItemRender, MentionableMenuRoute, type MessageContextMenuRegistry, MessageContextMenuRoute, type ModalLike, ModalRoute, Notice, OwnerOnly, type PageRender, type PageSourceBase, type PageView, PaginatorBase, type PaginatorConfig, type PaginatorControls, type PermissionAssertion, type PermissionNoticeOverrides, type PermissionScope, RegisterCommand, RepliableHandler, RequireBotPermissions, RequirePermissions, type RequirePermissionsOptions, RequireRole, type RequireRoleOptions, type RequiredOf, ResolvedEmoji, type ResponseAttempt, type ResponseFailed, type ResponseOutcome, type ResponseSent, RoleMenuRoute, RowComponent, type RowType, ShutdownPhase, Silence, type SlashRegistry, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, type SubscribeOptions, Subscriber, type SubscriptionData, type SubscriptionKey, type Subscriptions, type UserContextMenuRegistry, UserContextMenuRoute, UserMenuRoute, type WebhookFile, WebhookLog, type WebhookReport, WebhookUrl, and, assertPermissions, defineEffectGate, defineGate, mergeRoles, or, paginate, setCustomIdErrors, version };
+export { type AnyCustomId, ArraySourceBase, type AttemptedWrite, type AutocompleteOptions, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, type BuilderType, Bus, ButtonRoute, ChannelMenuRoute, type CommandInfo, Commands, type ContextMenuInfo, ContextMenus, type ControlCosmetics, type ControlKey, Cooldown, type CooldownOptions, type CoreBase, CursorSourceBase, CustomId, type CustomIdField, type CustomIdShape, type DecodedParams, type DecodedRoute, DispatchContext, type DispatchOutcome, type DispatchResult, DmOnly, type EffectGate, type EventDispatchResult, Fault, type FaultSource, type FieldOptions, type Gate, type GateContextBase, type GateNoticeOptions, GuildOnly, type GuildPermissionsContext, type HandlerOutcome, type HandlerResult, type InjectedCommandMap, type InjectedContextMenuMap, InteractionKind, type InteractionMiddlewareOptions, type ItemRender, MentionableMenuRoute, type MessageContextMenuRegistry, MessageContextMenuRoute, type MiddlewareKind, type ModalLike, ModalRoute, Notice, OwnerOnly, type PageRender, type PageSourceBase, type PageView, PaginatorBase, type PaginatorConfig, type PaginatorControls, type PermissionAssertion, type PermissionNoticeOverrides, type PermissionScope, RegisterCommand, RegisterInteractionMiddleware, RepliableHandler, RequireBotPermissions, RequirePermissions, type RequirePermissionsOptions, RequireRole, type RequireRoleOptions, type RequiredOf, ResolvedEmoji, type ResponseAttempt, type ResponseFailed, type ResponseOutcome, type ResponseSent, RoleMenuRoute, RowComponent, type RowType, ShutdownPhase, Silence, type SlashRegistry, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, type SubscribeOptions, Subscriber, type SubscriptionData, type SubscriptionKey, type Subscriptions, type UserContextMenuRegistry, UserContextMenuRoute, UserMenuRoute, type WebhookFile, WebhookLog, type WebhookReport, WebhookUrl, and, assertPermissions, decodeFor, defineEffectGate, defineGate, mergeRoles, or, paginate, prefixOf, setCustomIdErrors, version };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { A as translateSerializationError, B as storeComponentRoute, C as NotInDm, D as defineEffectGate, E as OnCooldown, F as checkAckLegality, G as Notice, I as sendTarget, M as publishResponse, O as defineGate, P as AckTrace, R as contextMenuRouteOf, S as NotAllowed, T as NotOwner, V as storeInteractionRoute, W as NoticeCard, a as RequirePermissions, c as hasAll, d as pickNotice, h as runCheck, i as RequireBotPermissions, j as attemptWrite, k as serializeReply, l as missingNames, m as rollbackCommits, n as pageCursor, o as RequireRole, p as markCommits, r as Silence, t as PAGE_MAX, u as presentNames, v as HasDangerousPermissions, w as NotInGuild, x as NeedsAny, y as MissingPermissions } from "./cursor-BkI9lxy2.mjs";
-import { A as RowComponent, d as WebhookLog, f as Subscriber, g as CommandMetadataKey, k as BuilderComponent, l as WebhookUrl, t as Bus, u as Subscribe, y as InteractionKind } from "./Bus-dGy6xq3F.mjs";
-import { n as Commands, r as ContextMenus } from "./subscribers-A8lNU5yM.mjs";
+import { A as translateSerializationError, B as contextMenuRouteOf, C as NotInDm, D as defineEffectGate, E as OnCooldown, F as checkAckLegality, H as storeComponentRoute, I as sendTarget, K as NoticeCard, L as RegisterInteractionMiddleware, M as publishResponse, O as defineGate, P as AckTrace, S as NotAllowed, T as NotOwner, U as storeInteractionRoute, a as RequirePermissions, c as hasAll, d as pickNotice, h as runCheck, i as RequireBotPermissions, j as attemptWrite, k as serializeReply, l as missingNames, m as rollbackCommits, n as pageCursor, o as RequireRole, p as markCommits, q as Notice, r as Silence, t as PAGE_MAX, u as presentNames, v as HasDangerousPermissions, w as NotInGuild, x as NeedsAny, y as MissingPermissions } from "./cursor-CFNKLVlk.mjs";
+import { A as BuilderComponent, b as InteractionKind, d as WebhookLog, f as Subscriber, g as CommandMetadataKey, j as RowComponent, l as WebhookUrl, t as Bus, u as Subscribe } from "./Bus-Djm6688b.mjs";
+import { n as Commands, r as ContextMenus } from "./subscribers-Bf4cBTvK.mjs";
 import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
 import "reflect-metadata";
-import { CustomId, setCustomIdErrors, setCustomIdErrors as setCustomIdErrors$1 } from "@seedcord/custom-id";
+import { CustomId, decodeFor, prefixOf, setCustomIdErrors, setCustomIdErrors as setCustomIdErrors$1 } from "@seedcord/custom-id";
 import { ActionRowBuilder, ButtonBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { ApplicationCommandType, ButtonStyle } from "discord-api-types/v10";
 import { SeedcordErrorCode } from "@seedcord/errors";
@@ -320,7 +320,8 @@ function MentionableMenuRoute(...defs) {
 */
 var DispatchContext = class {
 	routeId;
-	state = {};
+	state = Object.create(null);
+	id = crypto.randomUUID();
 	constructor(routeId) {
 		this.routeId = routeId;
 	}
@@ -330,6 +331,16 @@ var DispatchContext = class {
 	get(key) {
 		return this.state[key];
 	}
+	/**
+	* Read a key that must be present, with `undefined` stripped from the result.
+	*
+	* @throws A **SeedcordError** If nothing set the key on this dispatch.
+	*/
+	require(key) {
+		const value = this.state[key];
+		if (value === void 0) throw new SeedcordError(SeedcordErrorCode.DispatchStateMissing, [String(key)]);
+		return value;
+	}
 };
 
 //#endregion
@@ -345,6 +356,7 @@ var BaseHandler = class {
 	core;
 	event;
 	logger;
+	/** The bag for this dispatch. Each interaction gets its own. Every handler for one event shares a single bag. */
 	dispatch;
 	constructor(event, core, dispatch, channel) {
 		this.core = core;
@@ -357,8 +369,8 @@ var BaseHandler = class {
 //#endregion
 //#region src/handlers/RepliableHandler.ts
 /**
-* Shared base the repliable handlers on both transports extend. Defines the reply members over the sender
-* the transport builds.
+* Shared base the repliable handlers on both transports extend. Defines the reply members over one sender.
+* A handler builds its own through `buildSender`. A middleware takes the handler's.
 *
 * @typeParam Event - The repliable interaction type this handler processes
 * @typeParam TCore - The transport's Core
@@ -370,10 +382,10 @@ var RepliableHandler = class extends BaseHandler {
 	/** The reply surface for this interaction. Pass the handler to reply from outside its class. */
 	sender;
 	routeId;
-	constructor(event, core, dispatch) {
+	constructor(event, core, dispatch, sender) {
 		super(event, core, dispatch, "interactions");
-		this.routeId = dispatch?.routeId ?? this.constructor.name;
-		this.sender = this.buildSender(event, core, this.routeId);
+		this.routeId = dispatch.routeId;
+		this.sender = sender ?? this.buildSender(event, core, dispatch);
 	}
 	/** Send the initial response, exactly once. */
 	reply(response, opts) {
@@ -410,19 +422,19 @@ var RepliableHandler = class extends BaseHandler {
 * supplies the writers.
 */
 var BaseReplySender = class {
-	routeId;
 	telemetry;
 	state;
 	sent = /* @__PURE__ */ new Set();
 	ackedBy;
-	constructor(routeId, telemetry, initialState = "unacked") {
-		this.routeId = routeId;
+	constructor(telemetry, initialState = "unacked") {
 		this.telemetry = telemetry;
 		this.state = initialState;
 	}
+	get routeId() {
+		return this.telemetry.dispatch.routeId;
+	}
 	report(method, startedAt, messageId) {
 		publishResponse(this.telemetry, {
-			routeId: this.routeId,
 			method,
 			startedAt,
 			outcome: "sent",
@@ -430,7 +442,7 @@ var BaseReplySender = class {
 		});
 	}
 	async attempt(method, startedAt, write) {
-		return await attemptWrite(this.telemetry, this.routeId, method, startedAt, write);
+		return await attemptWrite(this.telemetry, method, startedAt, write);
 	}
 	async reply(response, opts) {
 		this.checkLegality("reply");
@@ -806,7 +818,7 @@ function Cooldown(duration, options) {
 		limit: options.limit
 	};
 	const anonId = anonSeq++;
-	const keyOf = (ctx) => `cooldown:${ctx.routeId ?? `anon${anonId}`}:${per}:w${windowMs}:l${options?.limit ?? 1}:${scopeValue(ctx, per)}`;
+	const keyOf = (ctx) => `cooldown:${ctx.declaredRoute ?? `anon${anonId}`}:${per}:w${windowMs}:l${options?.limit ?? 1}:${scopeValue(ctx, per)}`;
 	return defineEffectGate("Cooldown", async (ctx) => {
 		const result = await ctx.core.rateLimiter.peek(keyOf(ctx), window);
 		if (!result.limited) return;
@@ -972,7 +984,7 @@ function paginate(items, page, perPage) {
 }
 
 //#endregion
-//#region src/pagination/controls.ts
+//#region src/pagination/Controls.ts
 const DEFAULT_LABEL = {
 	first: "First",
 	prev: "Prev",
@@ -1177,8 +1189,8 @@ var CursorSourceBase = class {
 //#endregion
 //#region src/index.ts
 /** Package version */
-const version = "0.5.0";
+const version = "0.7.0";
 
 //#endregion
-export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, ChannelMenuRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, InteractionKind, MentionableMenuRoute, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RoleMenuRoute, RowComponent, ShutdownPhase, Silence, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, Subscriber, UserContextMenuRoute, UserMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, defineEffectGate, defineGate, mergeRoles, or, paginate, setCustomIdErrors, version };
+export { ArraySourceBase, AutocompleteRoute, BaseHandler, BaseReplySender, BuilderComponent, Bus, ButtonRoute, ChannelMenuRoute, Commands, ContextMenus, Cooldown, CursorSourceBase, CustomId, DispatchContext, DmOnly, Fault, GuildOnly, InteractionKind, MentionableMenuRoute, MessageContextMenuRoute, ModalRoute, Notice, OwnerOnly, PaginatorBase, RegisterCommand, RegisterInteractionMiddleware, RepliableHandler, RequireBotPermissions, RequirePermissions, RequireRole, ResolvedEmoji, RoleMenuRoute, RowComponent, ShutdownPhase, Silence, SlashRoute, StartupPhase, StringMenuRoute, Subscribe, Subscriber, UserContextMenuRoute, UserMenuRoute, WebhookLog, WebhookUrl, and, assertPermissions, decodeFor, defineEffectGate, defineGate, mergeRoles, or, paginate, prefixOf, setCustomIdErrors, version };
 //# sourceMappingURL=index.mjs.map