@seedcord/core 0.1.0-next.7 → 0.1.0

package/dist/{AutocompleteOptions-DLp_B8as.d.mts → cursor-j5bRcn2O.d.mts}

@@ -1,9 +1,41 @@
-import { t as Constructor } from "./basic-D7bDlgSP.mjs";
-import { A as Notice, N as AckState, W as InteractionRoutes, j as ReplyTelemetry, y as CoreBase } from "./Plugin-3rlH0uxH.mjs";
-import { APIMessageTopLevelComponent, APIModalInteractionResponseCallbackData, ApplicationCommandType, ChannelType, Snowflake } from "discord-api-types/v10";
+import { n as CommandBuilder, r as DeployResult, t as Constructor } from "./basic-1hebYVcN.mjs";
+import { A as AckState, D as Notice, O as ReplyTelemetry, V as InteractionRoutes, g as CoreBase } from "./Plugin-BZit5HUI.mjs";
 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";
 
+//#region src/registries/ContextMenuRegistry.d.ts
+/** The two context-menu command kinds Discord defines. */
+type ContextMenuKind = ApplicationCommandType.User | ApplicationCommandType.Message;
+/**
+ * Maps each user context-menu command name to a presence marker. Populated by `seedcord codegen`, which
+ * reads every command's `toJSON()` and emits a `declare module '@seedcord/gateway'` augmentation, so
+ * `keyof UserContextMenuRegistry` is the compile-time union of every registered user context-menu name.
+ * Do not augment it by hand, run `seedcord codegen`.
+ *
+ * Kept separate from {@link MessageContextMenuRegistry} because Discord allows a user command and a message
+ * command to share a name, so a single name-keyed registry would collapse a legal pair.
+ *
+ * @example
+ * ```ts
+ * // seedcord-gen.d.ts (emitted, committed)
+ * declare module '@seedcord/gateway' {
+ *   interface UserContextMenuRegistry {
+ *     'View Profile': true;
+ *   }
+ * }
+ * ```
+ */
+interface UserContextMenuRegistry {}
+/**
+ * Maps each message context-menu command name to a presence marker. Populated by `seedcord codegen`, so
+ * `keyof MessageContextMenuRegistry` is the compile-time union of every registered message context-menu
+ * name. Do not augment it by hand, run `seedcord codegen`.
+ *
+ * Kept separate from {@link UserContextMenuRegistry}, see that interface for why.
+ */
+interface MessageContextMenuRegistry {}
+//#endregion
 //#region src/registries/SlashOptionRegistry.d.ts
 /** A slash option kind as a plain string union (`string`, `channel`, ...), keyed to the registry. */
 type OptionKind = 'string' | 'integer' | 'number' | 'boolean' | 'user' | 'channel' | 'role' | 'mentionable' | 'attachment';
@@ -33,6 +65,77 @@ interface SlashOption {
  */
 interface SlashOptionRegistry {}
 //#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 SlashOptionRegistry]: CommandInfo };
+/**
+ * The bot's deployed slash commands, keyed by {@link SlashOptionRegistry}. 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;
+/**
+ * Records each deployed command on {@link Commands} and {@link ContextMenus}.
+ *
+ * @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.
@@ -232,6 +335,33 @@ sum();
 */
 type NonEmptyTuple<T = unknown> = readonly [T, ...T[]];
 //#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/promisable.d.ts
+/**
+Create a type that represents either the value or the value wrapped in `PromiseLike`.
+
+Use-cases:
+- A function accepts a callback that may either return a value synchronously or may return a promised value.
+- This type could be the return type of `Promise#then()`, `Promise#catch()`, and `Promise#finally()` callbacks.
+
+Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/31394) if you want to have this type as a built-in in TypeScript.
+
+@example
+```
+import type {Promisable} from 'type-fest';
+
+async function logger(getLogEntry: () => Promisable<string>): Promise<void> {
+	const entry = await getLogEntry();
+	console.log(entry);
+}
+
+await logger(() => 'foo');
+await logger(() => Promise.resolve('bar'));
+```
+
+@category Async
+*/
+type Promisable<T> = T | PromiseLike<T>;
+//#endregion
 //#region src/decorators/Command.d.ts
 type CommandCtor = Constructor<BuilderComponent<'command' | 'context_menu'>>;
 interface GlobalMeta {
@@ -456,17 +586,17 @@ declare function interactionRoutesOf(constructor: RoutableConstructor): [Interac
 declare function storeInteractionRoute(route: InteractionRoutes, routes: string | readonly string[], constructor: RoutableConstructor): void;
 declare function storeComponentRoute(route: InteractionRoutes, defs: readonly AnyCustomId[], constructor: RoutableConstructor): void;
 declare function selectMenuRouteOf(kind: SelectMenuKind): InteractionRoutes;
-declare function contextMenuRouteOf(kind: ApplicationCommandType.User | ApplicationCommandType.Message): InteractionRoutes;
+declare function contextMenuRouteOf(kind: ContextMenuKind): InteractionRoutes;
 //#endregion
 //#region src/reply/serializeReply.d.ts
 /** Serialized message data the transport wire writers consume. */
-interface SerializedReply {
+interface SerializedReply<TNative = never> {
   readonly components: APIMessageTopLevelComponent[];
   readonly allowedMentions?: ReplyResponse['allowedMentions'];
-  readonly files?: ReplyResponse['files'];
+  readonly files?: ReplyResponse<TNative>['files'];
 }
 /** Wraps a string in a TextDisplay component. */
-declare function serializeReply(response: ReplyResponse | string, routeId: string): SerializedReply;
+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()`. */
@@ -481,7 +611,7 @@ interface ModalLike {
  */
 declare abstract class BaseReplySender<TMessage extends {
   id: string;
-}> {
+}, TNative = never> {
   protected readonly routeId: string;
   private readonly telemetry?;
   private state;
@@ -490,7 +620,7 @@ declare abstract class BaseReplySender<TMessage extends {
   protected constructor(routeId: string, initialState?: AckState, telemetry?: ReplyTelemetry | undefined);
   private report;
   private attempt;
-  reply(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage>;
+  reply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
   defer(opts?: DeferOpts): Promise<void>;
   deferUpdate(): Promise<void>;
   /**
@@ -498,30 +628,30 @@ declare abstract class BaseReplySender<TMessage extends {
    * 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 | string): Promise<TMessage>;
-  followUp(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage>;
-  edit(response: ReplyResponse | string): Promise<TMessage>;
-  edit(target: TMessage, response: ReplyResponse | string): Promise<TMessage>;
+  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 | string, opts?: SendOpts): Promise<TMessage>;
+  send(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;
   /** Must be the initial response. */
   showModal(modal: ModalLike): Promise<void>;
-  protected serialize(response: ReplyResponse | string): SerializedReply;
+  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 | string, opts?: SendOpts): Promise<TMessage | undefined>;
+  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 | string): Promise<TMessage | undefined>;
-  protected abstract writeFollowUp(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage>;
-  protected abstract writeEditOriginal(response: ReplyResponse | string): Promise<TMessage>;
-  protected abstract writeEditTarget(targetId: string, response: ReplyResponse | string): Promise<TMessage>;
+  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>;
@@ -771,14 +901,16 @@ interface GateNoticeOptions {
 }
 declare function pickNotice(options: GateNoticeOptions | undefined, makeDefault: (message?: string) => Notice): Notice;
 //#endregion
-//#region src/gates/catalog/permissions.d.ts
+//#region src/permissions/bits.d.ts
 /**
  * The permission flag bits a caller or the bot must hold. Pass the `PermissionFlagsBits` values from
  * `discord-api-types/v10` (or `discord.js`).
  */
 type PermissionScope = readonly bigint[];
-/** Permission bit to its prettified human-readable name, for the missing-permission refusal. */
+/** Permission bit to its prettified human-readable name. */
 declare const PermissionNames: Map<bigint, string>;
+//#endregion
+//#region src/gates/catalog/permissions.d.ts
 /**
  * Options for {@link RequirePermissions} and {@link RequireBotPermissions}.
  */
@@ -938,5 +1070,15 @@ type Getter<Route extends keyof SlashOptionRegistry, Kind extends OptionKind, Me
  */
 type AutocompleteOptions<Route extends keyof SlashOptionRegistry> = Getter<Route, 'string', 'getString'> & Getter<Route, 'integer', 'getInteger'> & Getter<Route, 'number', 'getNumber'> & Getter<Route, 'boolean', 'getBoolean'>;
 //#endregion
-export { SlashOptionRegistry as $, RoutableConstructor as A, decodeFor as B, RequiredOf as C, ModalLike as D, BaseReplySender as E, selectMenuRouteOf as F, RegisterCommand as G, CustomIdField as H, storeComponentRoute as I, RowComponent as J, IsNever as K, storeInteractionRoute as L, areRoutes as M, contextMenuRouteOf as N, SerializedReply as O, interactionRoutesOf as P, SlashOption as Q, AnyCustomId as R, GuildPermissionsContext as S, defineGate as T, DecodedParams as U, prefixOf as V, CommandMeta as W, RowType as X, BuilderType as Y, OptionKind as Z, JoinNames as _, FocusedField as a, Gate as b, RequireBotPermissions as c, RequireRole as d, RequireRoleOptions as f, IntersectRequired as g, GateFitsWith as h, EntryFor as i, SelectMenuKind as j, serializeReply as k, RequirePermissions as l, pickNotice as m, AutocompleteOptions as n, PermissionNames as o, GateNoticeOptions as p, BuilderComponent as q, ChoiceValueOf as r, PermissionScope as s, AutocompletableNames as t, RequirePermissionsOptions as u, TwoOrMore as v, defineEffectGate as w, GateContextBase as x, EffectGate as y, CustomId as z };
-//# sourceMappingURL=AutocompleteOptions-DLp_B8as.d.mts.map
+//#region src/pagination/cursor.d.ts
+declare const PAGE_MAX = 1000000;
+/** Page cursor for a paginator. */
+type PageCursor<Prefix extends string> = CustomId<Prefix, {
+  page: CustomIdField<number>;
+  slot: CustomIdField<number>;
+}>;
+/** Build the page cursor for a paginator. */
+declare function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix>;
+//#endregion
+export { RowType as $, ModalLike as A, storeInteractionRoute as B, Gate as C, defineEffectGate as D, RequiredOf as E, areRoutes as F, DecodedParams as G, CustomId as H, contextMenuRouteOf as I, Promisable as J, CommandMeta as K, interactionRoutesOf as L, serializeReply as M, RoutableConstructor as N, defineGate as O, SelectMenuKind as P, BuilderType as Q, selectMenuRouteOf as R, EffectGate as S, GuildPermissionsContext as T, decodeFor as U, AnyCustomId as V, prefixOf as W, BuilderComponent as X, IsNever as Y, RowComponent as Z, pickNotice as _, AutocompleteOptions as a, InjectedCommandMap as at, JoinNames as b, FocusedField as c, SlashOption as ct, RequirePermissionsOptions as d, MessageContextMenuRegistry as dt, CommandInfo as et, RequireRole as f, UserContextMenuRegistry as ft, GateNoticeOptions as g, PermissionScope as h, AutocompletableNames as i, ContextMenus as it, SerializedReply as j, BaseReplySender as k, RequireBotPermissions as l, SlashOptionRegistry as lt, PermissionNames as m, PageCursor as n, Commands as nt, ChoiceValueOf as o, InjectedContextMenuMap as ot, RequireRoleOptions as p, RegisterCommand as q, pageCursor as r, ContextMenuInfo as rt, EntryFor as s, OptionKind as st, PAGE_MAX as t, CommandInjector as tt, RequirePermissions as u, ContextMenuKind as ut, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, storeComponentRoute as z };
+//# sourceMappingURL=cursor-j5bRcn2O.d.mts.map

package/dist/{index-Dueqztyy.d.mts → index-DafutfX8.d.mts}

@@ -1,7 +1,7 @@
-import { t as Constructor } from "./basic-D7bDlgSP.mjs";
-import { C as Subscriber, O as SubscriptionKey, y as CoreBase } from "./Plugin-3rlH0uxH.mjs";
+import { t as Constructor } from "./basic-1hebYVcN.mjs";
+import { T as SubscriptionKey, b as Subscriber, g as CoreBase } from "./Plugin-BZit5HUI.mjs";
 import { APIMessageTopLevelComponent } from "discord-api-types/v10";
-import { EventFrequency } from "@seedcord/types";
+import { EventFrequency, ReplyFile } from "@seedcord/types";
 
 //#region src/subscribers/decorators/Subscribe.d.ts
 /**
@@ -44,18 +44,11 @@ interface SubscribeOptions {
 declare function Subscribe<TSubscriber extends SubscriptionKey>(subscriber: TSubscriber, options?: SubscribeOptions): <HandlerCtor extends Constructor<Subscriber<TSubscriber, CoreBase>>>(constructor: HandlerCtor) => void;
 //#endregion
 //#region src/subscribers/bases/WebhookSender.d.ts
-/**
- * A file attached to a webhook report.
- */
-interface WebhookFile {
-  name: string;
-  description: string;
-  /** A `Buffer` still satisfies this, it extends `Uint8Array`. */
-  data: Uint8Array | string;
+/** A file attached to a webhook report. */
+interface WebhookFile extends ReplyFile {
+  readonly description: string;
 }
-/**
- * The payload {@link WebhookSender.send} posts.
- */
+/** The payload {@link WebhookSender.send} posts. */
 interface WebhookSendOptions {
   flags: number;
   username: string;
@@ -139,4 +132,4 @@ declare abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey, TCor
 declare function WebhookUrl(envKey: string): <HandlerCtor extends Constructor<WebhookLog<SubscriptionKey, CoreBase>>>(constructor: HandlerCtor) => void;
 //#endregion
 export { Subscribe as a, WebhookFile as i, WebhookLog as n, SubscribeOptions as o, WebhookReport as r, WebhookUrl as t };
-//# sourceMappingURL=index-Dueqztyy.d.mts.map
+//# sourceMappingURL=index-DafutfX8.d.mts.map