@seedcord/core 0.3.0 → 0.4.0

package/dist/{cursor-DKKKUa_7.d.mts → cursor-BcRfmTSo.d.mts}

@@ -1,9 +1,9 @@
-import { n as CommandBuilder, r as DeployResult, t as Constructor } from "./basic-Dng__Ena.mjs";
-import { H as InteractionRoutes, O as Notice, g as CoreBase, j as AckState, k as ReplyTelemetry } from "./Plugin-B6iRzm3g.mjs";
+import { t as Constructor } from "./basic-Dng__Ena.mjs";
+import { b as Notice, r as CoreBase, z as InteractionRoutes } from "./phases-F8yvPd60.mjs";
 import "reflect-metadata";
 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, Snowflake } 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;
@@ -95,73 +95,6 @@ type CacheOf<Route extends keyof SlashRegistry> = [Route] extends [never] ? unde
   cache: infer Cache;
 } ? Cache : undefined;
 //#endregion
-//#region src/commands/CommandInjector.d.ts
-/** What {@link Commands} resolves to for one slash route. */
-interface CommandInfo {
-  /** The clickable `</config set:id>` mention. A route whose id did not resolve falls back to `/config set`. */
-  readonly mention: string;
-  /** The deployed command id. Absent when the command deployed to two or more guilds. */
-  readonly id?: string;
-  /** The full route, e.g. `config/set`. */
-  readonly route: string;
-  /** The route's own description, taken from the subcommand for a nested route. */
-  readonly description: string;
-}
-/** Each registered slash route mapped to its deployed command. */
-type InjectedCommandMap = { [K in keyof SlashRegistry]: CommandInfo; };
-/**
- * The bot's deployed slash commands, keyed by {@link SlashRegistry}. Filled by
- * {@link CommandInjector} after each deploy, and a read before that throws.
- *
- * @example
- * ```ts
- * import { Commands } from '@seedcord/gateway';
- *
- * await this.reply(`Try ${Commands['config/set'].mention}`);
- *
- * // a help listing
- * const lines = Object.values(Commands).map((c) => `${c.mention} ${c.description}`);
- * ```
- */
-declare const Commands: InjectedCommandMap;
-/** What {@link ContextMenus} resolves to for one context-menu command. */
-interface ContextMenuInfo {
-  /** The deployed command id. Absent when the command deployed to two or more guilds. */
-  readonly id?: string;
-  /** The name shown in Discord's right-click menu. */
-  readonly name: string;
-  readonly kind: ContextMenuKind;
-}
-/** Deployed context-menu commands, split by kind because Discord scopes name uniqueness per command type. */
-interface InjectedContextMenuMap {
-  readonly user: { [K in keyof UserContextMenuRegistry]: ContextMenuInfo; };
-  readonly message: { [K in keyof MessageContextMenuRegistry]: ContextMenuInfo; };
-}
-/**
- * The bot's deployed context-menu commands. Filled by {@link CommandInjector} after each deploy, and a read
- * before that throws.
- *
- * @example
- * ```ts
- * import { ContextMenus } from '@seedcord/gateway';
- *
- * const id = ContextMenus.user['View Profile'].id;
- * ```
- */
-declare const ContextMenus: InjectedContextMenuMap;
-/** @internal */
-declare class CommandInjector {
-  private readonly logger;
-  inject(deploy: DeployResult, all: readonly CommandBuilder[]): void;
-  private injectMenus;
-  private indexByKey;
-  private indexGuilds;
-  private resolveId;
-  private toMention;
-  private toPlain;
-  private clear;
-}
-//#endregion
 //#region src/components/builderTypes.d.ts
 /**
  * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
@@ -430,6 +363,8 @@ interface CustomIdField<Decoded> {
   readonly max?: number;
   /** The allowed values, for a oneOf field. */
   readonly choices?: readonly string[];
+  /** Whether this field also carries null. */
+  readonly nullable?: boolean;
   /** Phantom only, carries the decoded type and is never set at runtime. */
   readonly decoded?: Decoded;
 }
@@ -447,6 +382,16 @@ type CustomIdShape = Record<string, CustomIdField<unknown>>;
 type DecodedParams<Shape extends CustomIdShape> = { [Name in keyof Shape]: Shape[Name] extends CustomIdField<infer Decoded> ? Decoded : never; };
 //#endregion
 //#region src/customId/CustomId.d.ts
+/** Per-field options every {@link CustomId} chain method takes. */
+interface FieldOptions<Nullable extends boolean = boolean> {
+  /**
+   * Whether the field also carries null. A nullable field costs one extra slot on the wire.
+   *
+   * @defaultValue `false`
+   */
+  nullable?: Nullable;
+}
+type Nullish<Decoded, Nullable extends boolean> = Nullable extends true ? Decoded | null : Decoded;
 /** Strip the layout hash off the routeKey to recover the stable prefix the controller routes by. @internal */
 declare function prefixOf(wire: string): string;
 /**
@@ -488,7 +433,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('ban').snowflake('userId');
    * ```
    */
-  snowflake<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<Snowflake>>>;
+  snowflake<Name extends string, const Nullable extends boolean = false>(name: Name, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<Snowflake, Nullable>>>>;
   /**
    * Add a UUID field, decoded as a lowercase uuid string.
    *
@@ -497,7 +442,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('ticket').uuid('ticketId');
    * ```
    */
-  uuid<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<string>>>;
+  uuid<Name extends string, const Nullable extends boolean = false>(name: Name, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<string, Nullable>>>>;
   /**
    * Add an integer field with no bounds, for a value up to 2^53.
    *
@@ -506,7 +451,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('shop').int('amount');
    * ```
    */
-  int<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<number>>>;
+  int<Name extends string, const Nullable extends boolean = false>(name: Name, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<number, Nullable>>>>;
   /**
    * Add an integer field bounded by min and max, so it packs into fewer characters on the wire.
    *
@@ -515,7 +460,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('paginate').int('page', 1, 50);
    * ```
    */
-  int<Name extends string>(name: Name, min: number, max: number): CustomId<Prefix, Shape & Record<Name, CustomIdField<number>>>;
+  int<Name extends string, const Nullable extends boolean = false>(name: Name, min: number, max: number, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<number, Nullable>>>>;
   /**
    * Add a boolean flag.
    *
@@ -524,7 +469,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('settings').bool('silent');
    * ```
    */
-  bool<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<boolean>>>;
+  bool<Name extends string, const Nullable extends boolean = false>(name: Name, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<boolean, Nullable>>>>;
   /**
    * Add a field that is one value from a fixed list, decoded as the literal union. No `as const` needed.
    *
@@ -533,7 +478,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * 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]>>>;
+  oneOf<Name extends string, const Choices extends NonEmptyTuple<string>, const Nullable extends boolean = false>(name: Name, choices: Choices, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<Choices[number], Nullable>>>>;
   /**
    * Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
    * expensive field on the wire.
@@ -543,7 +488,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    * new CustomId('note').str('message');
    * ```
    */
-  str<Name extends string>(name: Name): CustomId<Prefix, Shape & Record<Name, CustomIdField<string>>>;
+  str<Name extends string, const Nullable extends boolean = false>(name: Name, opts?: FieldOptions<Nullable>): CustomId<Prefix, Shape & Record<Name, CustomIdField<Nullish<string, Nullable>>>>;
   /**
    * Mint a wire string from values. Throws if a value is out of its field's range or the wire is over 100 chars.
    *
@@ -615,65 +560,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
@@ -888,7 +774,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
@@ -1096,5 +983,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, UserContextMenuRegistry as Ct, 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, NamesFor as St, GuildPermissionsContext as T, interactionRoutesOf as U, areRoutes as V, selectMenuRouteOf as W, prefixOf as X, decodeFor as Y, DecodedParams as Z, pickNotice as _, SlashRegistry as _t, AutocompleteOptions as a, RowType as at, JoinNames as b, MenuCacheFor as bt, FocusedField as c, Commands as ct, RequirePermissionsOptions as d, InjectedCommandMap as dt, Promisable as et, RequireRole as f, InjectedContextMenuMap as ft, GateNoticeOptions as g, SlashOption as gt, PermissionScope as h, RouteCache as ht, AutocompletableNames as i, BuilderType as it, SerializedReply as j, BaseReplySender as k, RequireBotPermissions as l, ContextMenuInfo as lt, PermissionNames as m, OptionKind as mt, PageCursor as n, BuilderComponent as nt, ChoiceValueOf as o, CommandInfo as ot, RequireRoleOptions as p, CacheFor as pt, AnyCustomId as q, pageCursor as r, RowComponent as rt, EntryFor as s, CommandInjector as st, PAGE_MAX as t, IsNever as tt, RequirePermissions as u, ContextMenus as ut, GateFitsWith as v, SlashRouteEntry as vt, GateContextBase as w, TwoOrMore as x, MessageContextMenuRegistry as xt, IntersectRequired as y, ContextMenuKind as yt, RoutableConstructor as z };
-//# sourceMappingURL=cursor-DKKKUa_7.d.mts.map
+export { Promisable as $, serializeReply as A, contextMenuRouteOf as B, Gate as C, defineEffectGate as D, RequiredOf as E, ContextMenuNamesBrand as F, AnyCustomId as G, selectMenuRouteOf as H, SlashRouteBrand as I, decodeFor as J, CustomId as K, RoutableConstructor as L, ComponentDefsBrand as M, ComponentKindBrand as N, defineGate as O, ContextMenuKindBrand as P, RegisterCommand as Q, SelectMenuKind as R, EffectGate as S, GuildPermissionsContext as T, storeComponentRoute as U, interactionRoutesOf as V, storeInteractionRoute as W, DecodedParams as X, prefixOf as Y, CommandMeta as Z, pickNotice as _, AutocompleteOptions as a, CacheFor as at, JoinNames as b, FocusedField as c, SlashOption as ct, RequirePermissionsOptions as d, ContextMenuKind as dt, IsNever as et, RequireRole as f, MenuCacheFor as ft, GateNoticeOptions as g, PermissionScope as h, UserContextMenuRegistry as ht, AutocompletableNames as i, RowType as it, AutocompleteRouteBrand as j, SerializedReply as k, RequireBotPermissions as l, SlashRegistry as lt, PermissionNames as m, NamesFor as mt, PageCursor as n, RowComponent as nt, ChoiceValueOf as o, OptionKind as ot, RequireRoleOptions as p, MessageContextMenuRegistry as pt, FieldOptions as q, pageCursor as r, BuilderType as rt, EntryFor as s, RouteCache as st, PAGE_MAX as t, BuilderComponent as tt, RequirePermissions as u, SlashRouteEntry as ut, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, areRoutes as z };
+//# sourceMappingURL=cursor-BcRfmTSo.d.mts.map