@seedcord/core 0.3.1 → 0.4.1

package/dist/{cursor-BANzac53.d.mts → cursor-CO_MTgdZ.d.mts}

@@ -1,9 +1,10 @@
+import { H as Notice, R as InteractionRoutes, r as CoreBase } from "./phases-C5Steaa2.mjs";
 import { t as Constructor } from "./basic-Dng__Ena.mjs";
-import { g as ReplyTelemetry, h as Notice, k as InteractionRoutes, r as CoreBase, v as AckState } from "./phases-hBxMCD2V.mjs";
 import "reflect-metadata";
+import { AnyCustomId, CustomId, CustomIdField } from "@seedcord/custom-id";
 import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
-import { APIMessageTopLevelComponent, APIModalInteractionResponseCallbackData, ApplicationCommandType, ChannelType, Snowflake } from "discord-api-types/v10";
-import { DeferOpts, ReplyResponse, SendOpts } from "@seedcord/types";
+import { APIMessageTopLevelComponent, ApplicationCommandType, ChannelType } from "discord-api-types/v10";
+import { ReplyResponse } from "@seedcord/types";
 //#region src/registries/ContextMenuRegistry.d.ts
 /** The two context-menu command kinds Discord defines. */
 type ContextMenuKind = ApplicationCommandType.User | ApplicationCommandType.Message;
@@ -263,30 +264,6 @@ type B = IsTrueFixed<never>;
 */
 type IsNever<T> = [T] extends [never] ? true : false;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/non-empty-tuple.d.ts
-/**
-Matches any non-empty tuple.
-
-@example
-```
-import type {NonEmptyTuple} from 'type-fest';
-
-const sum = (...numbers: NonEmptyTuple<number>) => numbers.reduce((total, value) => total + value, 0);
-
-sum(1, 2, 3);
-// Ok
-
-// @ts-expect-error
-sum();
-// Error: Expected at least 1 arguments, but got 0.
-```
-
-@see {@link RequireAtLeastOne} for objects
-
-@category Array
-*/
-type NonEmptyTuple<T = unknown> = readonly [T, ...T[]];
-//#endregion
 //#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/promisable.d.ts
 /**
 Create a type that represents either the value or the value wrapped in `PromiseLike`.
@@ -348,169 +325,6 @@ declare function RegisterCommand(scope: 'global'): (ctor: CommandCtor) => void;
  */
 declare function RegisterCommand(scope: 'guild', guilds: string[]): (ctor: CommandCtor) => void;
 //#endregion
-//#region src/customId/Field.d.ts
-/**
- * One field in a customId shape, its wire kind plus the type it decodes to.
- *
- * @internal
- */
-interface CustomIdField<Decoded> {
-  /** Which wire encoding this field uses. */
-  readonly kind: 'snowflake' | 'uuid' | 'int' | 'bool' | 'oneOf' | 'string';
-  /** Lower bound, for a bounded int field. */
-  readonly min?: number;
-  /** Upper bound, for a bounded int field. */
-  readonly max?: number;
-  /** The allowed values, for a oneOf field. */
-  readonly choices?: readonly string[];
-  /** Phantom only, carries the decoded type and is never set at runtime. */
-  readonly decoded?: Decoded;
-}
-/**
- * The set of fields a customId carries, keyed by name.
- *
- * @internal
- */
-type CustomIdShape = Record<string, CustomIdField<unknown>>;
-/**
- * The decoded result, each field name mapped to its decoded type.
- *
- * @internal
- */
-type DecodedParams<Shape extends CustomIdShape> = { [Name in keyof Shape]: Shape[Name] extends CustomIdField<infer Decoded> ? Decoded : never; };
-//#endregion
-//#region src/customId/CustomId.d.ts
-/** Strip the layout hash off the routeKey to recover the stable prefix the controller routes by. @internal */
-declare function prefixOf(wire: string): string;
-/**
- * A typed customId. The single source of truth shared by the component that mints it and the handler
- * that reads it. This gives you typed reads on the `.customId` field in components. Values are packed
- * into a compact wire string, which fits more of them inside Discord's 100-char limit.
- *
- * @typeParam Prefix - The stable route prefix, e.g. 'approve'.
- * @typeParam Shape - The accumulated fields, filled in by the chain.
- *
- * @example
- * ```ts
- * const ApproveId = new CustomId('approve')
- *     .snowflake('userId')
- *     .oneOf('action', ['approve', 'deny']);
- *
- * // Set the custom id on a button when creating it.
- * new ButtonBuilder().setCustomId(ApproveId.encode({ userId: '123', action: 'approve' }));
- *
- * // in the handler, userId comes back a string
- * const { userId, action } = this.params; // userId: string, action: 'approve' | 'deny'
- * await this.event.guild?.members.fetch(userId);
- * ```
- */
-declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}> {
-  /** The stable route prefix, e.g. 'approve'. */
-  readonly prefix: Prefix;
-  /** The field definitions accumulated by the chain, keyed by name. */
-  readonly shape: Shape;
-  /** The prefix plus a short hash of the shape, the part of the wire before the colon. */
-  readonly routeKey: string;
-  constructor(prefix: Prefix, shape?: Shape);
-  private add;
-  /**
-   * Add a Discord ID field, decoded as a string (the `Snowflake` type from discord-api-types).
-   *
-   * @example
-   * ```ts
-   * new CustomId('ban').snowflake('userId');
-   * ```
-   */
-  snowflake<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<Snowflake>>>;
-  /**
-   * Add a UUID field, decoded as a lowercase uuid string.
-   *
-   * @example
-   * ```ts
-   * new CustomId('ticket').uuid('ticketId');
-   * ```
-   */
-  uuid<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<string>>>;
-  /**
-   * Add an integer field with no bounds, for a value up to 2^53.
-   *
-   * @example
-   * ```ts
-   * new CustomId('shop').int('amount');
-   * ```
-   */
-  int<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<number>>>;
-  /**
-   * Add an integer field bounded by min and max, so it packs into fewer characters on the wire.
-   *
-   * @example
-   * ```ts
-   * new CustomId('paginate').int('page', 1, 50);
-   * ```
-   */
-  int<Name extends string>(name: Name, min: number, max: number): CustomId<Prefix, Shape & Record<Name, CustomIdField<number>>>;
-  /**
-   * Add a boolean flag.
-   *
-   * @example
-   * ```ts
-   * new CustomId('settings').bool('silent');
-   * ```
-   */
-  bool<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<boolean>>>;
-  /**
-   * Add a field that is one value from a fixed list, decoded as the literal union. No `as const` needed.
-   *
-   * @example
-   * ```ts
-   * new CustomId('poll').oneOf('choice', ['yes', 'no', 'abstain']);
-   * ```
-   */
-  oneOf<Name extends string, const Choices extends NonEmptyTuple<string>>(name: Name, choices: Choices): CustomId<Prefix, Shape & Record<Name, CustomIdField<Choices[number]>>>;
-  /**
-   * Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
-   * expensive field on the wire.
-   *
-   * @example
-   * ```ts
-   * new CustomId('note').str('message');
-   * ```
-   */
-  str<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<string>>>;
-  /**
-   * Mint a wire string from values. Throws if a value is out of its field's range or the wire is over 100 chars.
-   *
-   * @param values - One value per field, typed by the chain.
-   * @returns The wire string to put on the component's customId.
-   */
-  encode(values: DecodedParams<Shape>): string;
-  /**
-   * Read a wire string back into values.
-   *
-   * - This will refuse with a default Notice when the shape changed since the wire was minted.
-   * - Or refuse with a different default Notice on a corrupt or foreign wire.
-   *
-   * @param wire - The customId string from the interaction.
-   * @returns The decoded values, typed by the chain.
-   */
-  decode(wire: string): DecodedParams<Shape>;
-  /** True if this wire was minted from this customId's prefix, ignoring the shape hash. */
-  owns(wire: string): boolean;
-}
-/** @internal */
-type AnyCustomId = CustomId<string, CustomIdShape>;
-/**
- * The outcome of decoding a wire against several customIds, the matched prefix paired with its values.
- *
- * @internal
- */
-type DecodedRoute<Defs extends readonly AnyCustomId[]> = { [Index in keyof Defs]: Defs[Index] extends AnyCustomId ? {
-  readonly prefix: Defs[Index]['prefix'];
-  readonly params: DecodedParams<Defs[Index]['shape']>;
-} : never; }[number];
-/** @internal */
-declare function decodeFor<Defs extends readonly AnyCustomId[]>(defs: Defs, wire: string): DecodedRoute<Defs>;
-//#endregion
 //#region src/decorators/interactionRoutes.d.ts
 /** The select menu kinds the select route decorators take. */
 declare enum SelectMenuKind {
@@ -548,65 +362,6 @@ interface SerializedReply<TNative = never> {
 }
 declare function serializeReply<TNative>(response: ReplyResponse<TNative> | string, routeId: string): SerializedReply<TNative>;
 //#endregion
-//#region src/reply/BaseReplySender.d.ts
-/** The shape djs modal builders emit from `toJSON()`. */
-interface ModalLike {
-  toJSON(): APIModalInteractionResponseCallbackData;
-}
-/**
- * Tracks acknowledgement state and throws a translated `SeedcordError` on an illegal verb before any
- * transport call. Every verb runs the legality check, calls the transport's wire writer, then updates
- * the state and the ack trace. Each transport binds `TMessage` to its own created-message type and
- * supplies the writers.
- */
-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);
-  private report;
-  private attempt;
-  reply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
-  defer(opts?: DeferOpts): Promise<void>;
-  deferUpdate(): Promise<void>;
-  /**
-   * After a deferUpdate the state stays deferred-update. Calling this again rewrites. The returned message
-   * is the source message, editable only through a bare `update` or `edit`. A targeted `edit` or `delete`
-   * of it throws the foreign-target error.
-   */
-  update(response: ReplyResponse<TNative> | string): Promise<TMessage>;
-  followUp(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
-  edit(response: ReplyResponse<TNative> | string): Promise<TMessage>;
-  edit(target: TMessage, response: ReplyResponse<TNative> | string): Promise<TMessage>;
-  delete(): Promise<void>;
-  delete(target: TMessage): Promise<void>;
-  /** Routes to the verb the current ack state permits. Every state has a route, so the illegal-ack throw is unreachable. */
-  send(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
-  /** Must be the initial response. */
-  showModal(modal: ModalLike): Promise<void>;
-  protected serialize(response: ReplyResponse<TNative> | string): SerializedReply<TNative>;
-  protected remember(created: TMessage): TMessage;
-  private requireMessage;
-  private editOriginal;
-  private checkLegality;
-  private transition;
-  protected guardModalSource(): void;
-  protected abstract writeReply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage | undefined>;
-  protected abstract writeDefer(opts?: DeferOpts): Promise<void>;
-  protected abstract writeDeferUpdate(): Promise<void>;
-  protected abstract writeUpdate(response: ReplyResponse<TNative> | string): Promise<TMessage | undefined>;
-  protected abstract writeFollowUp(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
-  protected abstract writeEditOriginal(response: ReplyResponse<TNative> | string): Promise<TMessage>;
-  protected abstract writeEditTarget(targetId: string, response: ReplyResponse<TNative> | string): Promise<TMessage>;
-  protected abstract writeDeleteOriginal(): Promise<void>;
-  protected abstract writeDeleteTarget(targetId: string): Promise<void>;
-  protected abstract writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;
-}
-//#endregion
 //#region src/gates/Gate.d.ts
 /**
  * The transport-agnostic gate context, the scalar identity of the acting user resolvable from any
@@ -821,7 +576,8 @@ type RequiredOf<TGate> = TGate extends Gate<infer Ctx> ? Ctx : never;
 type IntersectRequired<Gates extends readonly Gate<GateContextBase>[]> = Gates extends readonly [infer First extends Gate<GateContextBase>, ...infer Rest extends readonly Gate<GateContextBase>[]] ? RequiredOf<First> & IntersectRequired<Rest> : unknown;
 type TwoOrMore<Item> = readonly [Item, Item, ...Item[]];
 type GateName<TGate> = TGate extends Gate<GateContextBase, infer Name> ? Name : string;
-type JoinNames<Gates extends readonly Gate<GateContextBase>[], Sep extends string> = Gates extends readonly [infer Only extends Gate<GateContextBase>] ? GateName<Only> : Gates extends readonly [infer First extends Gate<GateContextBase>, ...infer Rest extends readonly Gate<GateContextBase>[]] ? `${GateName<First>}${Sep}${JoinNames<Rest, Sep>}` : string;
+type Grouped<Name extends string> = Name extends `${string} & ${string}` | `${string} | ${string}` ? `(${Name})` : Name;
+type JoinNames<Gates extends readonly Gate<GateContextBase>[], Sep extends string> = Gates extends readonly [infer Only extends Gate<GateContextBase>] ? Grouped<GateName<Only>> : Gates extends readonly [infer First extends Gate<GateContextBase>, ...infer Rest extends readonly Gate<GateContextBase>[]] ? `${Grouped<GateName<First>>}${Sep}${JoinNames<Rest, Sep>}` : string;
 type GateMismatch<Name extends string, Want extends string, Got extends string> = `gate '${Name}' requires a ${Want} handler, and this handler is ${Got}`;
 type GateFitsWith<Provided, ProvidedLabel extends string, TGate, ReqLabel extends string> = [Provided] extends [RequiredOf<TGate>] ? TGate : Constructor<[GateMismatch<GateName<TGate>, ReqLabel, ProvidedLabel>]>;
 //#endregion
@@ -1029,5 +785,5 @@ type PageCursor<Prefix extends string> = CustomId<Prefix, {
 /** Build the page cursor for a paginator. */
 declare function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix>;
 //#endregion
-export { RegisterCommand as $, ModalLike as A, SelectMenuKind as B, Gate as C, defineEffectGate as D, RequiredOf as E, ComponentKindBrand as F, storeComponentRoute as G, contextMenuRouteOf as H, ContextMenuKindBrand as I, CustomId as J, storeInteractionRoute as K, ContextMenuNamesBrand as L, serializeReply as M, AutocompleteRouteBrand as N, defineGate as O, ComponentDefsBrand as P, CommandMeta as Q, SlashRouteBrand as R, EffectGate as S, GuildPermissionsContext as T, interactionRoutesOf as U, areRoutes as V, selectMenuRouteOf as W, prefixOf as X, decodeFor as Y, DecodedParams as Z, pickNotice as _, AutocompleteOptions as a, RowType as at, JoinNames as b, FocusedField as c, RouteCache as ct, RequirePermissionsOptions as d, SlashRouteEntry as dt, Promisable as et, RequireRole as f, ContextMenuKind as ft, GateNoticeOptions as g, UserContextMenuRegistry as gt, PermissionScope as h, NamesFor as ht, AutocompletableNames as i, BuilderType as it, SerializedReply as j, BaseReplySender as k, RequireBotPermissions as l, SlashOption as lt, PermissionNames as m, MessageContextMenuRegistry as mt, PageCursor as n, BuilderComponent as nt, ChoiceValueOf as o, CacheFor as ot, RequireRoleOptions as p, MenuCacheFor as pt, AnyCustomId as q, pageCursor as r, RowComponent as rt, EntryFor as s, OptionKind as st, PAGE_MAX as t, IsNever as tt, RequirePermissions as u, SlashRegistry as ut, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, RoutableConstructor as z };
-//# sourceMappingURL=cursor-BANzac53.d.mts.map
+export { CacheFor as $, serializeReply as A, contextMenuRouteOf as B, Gate as C, defineEffectGate as D, RequiredOf as E, ContextMenuNamesBrand as F, CommandMeta as G, selectMenuRouteOf as H, SlashRouteBrand as I, IsNever as J, RegisterCommand as K, RoutableConstructor as L, ComponentDefsBrand as M, ComponentKindBrand as N, defineGate as O, ContextMenuKindBrand as P, RowType as Q, SelectMenuKind as R, EffectGate as S, GuildPermissionsContext as T, storeComponentRoute as U, interactionRoutesOf as V, storeInteractionRoute as W, RowComponent as X, BuilderComponent as Y, BuilderType as Z, pickNotice as _, AutocompleteOptions as a, ContextMenuKind as at, JoinNames as b, FocusedField as c, NamesFor as ct, RequirePermissionsOptions as d, OptionKind as et, RequireRole as f, GateNoticeOptions as g, PermissionScope as h, AutocompletableNames as i, SlashRouteEntry as it, AutocompleteRouteBrand as j, SerializedReply as k, RequireBotPermissions as l, UserContextMenuRegistry as lt, PermissionNames as m, PageCursor as n, SlashOption as nt, ChoiceValueOf as o, MenuCacheFor as ot, RequireRoleOptions as p, Promisable as q, pageCursor as r, SlashRegistry as rt, EntryFor as s, MessageContextMenuRegistry as st, PAGE_MAX as t, RouteCache as tt, RequirePermissions as u, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, areRoutes as z };
+//# sourceMappingURL=cursor-CO_MTgdZ.d.mts.map