@seedcord/core 0.4.0 → 0.5.0

package/dist/{Plugin-CG9pWbPF.d.mts → Plugin-iAaWcLaD.d.mts}

@@ -1,4 +1,4 @@
-import { n as StartupPhase, r as CoreBase, t as ShutdownPhase } from "./phases-F8yvPd60.mjs";
+import { n as StartupPhase, r as CoreBase, t as ShutdownPhase } from "./phases-D0a8BV9Z.mjs";
 import { Logger } from "@seedcord/logger";
 import { FrameworkChannel, HmrAware, HmrUpdateEvent, Tail, TypedExclude } from "@seedcord/types";
 //#region src/plugin/brands.d.ts
@@ -190,4 +190,4 @@ type CoreParamTooNarrow = Record<'this plugin constructor must take CoreBase as
 type CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0] ? unknown : CoreParamTooNarrow;
 //#endregion
 export { PluginCtor as a, PluginOptions as c, Transport as d, TransportAssert as f, PluginArgs as i, Runtime as l, Initializeable as n, PluginLike as o, PluginLifecycleSpec as p, Plugin as r, ChannelKeyAssert as s, CoreParamAssert as t, RuntimeAssert as u };
-//# sourceMappingURL=Plugin-CG9pWbPF.d.mts.map
+//# sourceMappingURL=Plugin-iAaWcLaD.d.mts.map

package/dist/{cursor-BcRfmTSo.d.mts → cursor-8Y2zpF-Y.d.mts}

@@ -1,8 +1,9 @@
+import { H as Notice, r as CoreBase } from "./phases-D0a8BV9Z.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 { 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, ApplicationCommandType, ChannelType, Snowflake } from "discord-api-types/v10";
+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. */
@@ -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,202 +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[];
-  /** Whether this field also carries null. */
-  readonly nullable?: boolean;
-  /** 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
-/** 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;
-/**
- * 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, 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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('ticket').uuid('ticketId');
-   * ```
-   */
-  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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('shop').int('amount');
-   * ```
-   */
-  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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('paginate').int('page', 1, 50);
-   * ```
-   */
-  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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('settings').bool('silent');
-   * ```
-   */
-  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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('poll').oneOf('choice', ['yes', 'no', 'abstain']);
-   * ```
-   */
-  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.
-   *
-   * @example
-   * ```ts
-   * new CustomId('note').str('message');
-   * ```
-   */
-  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.
-   *
-   * @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 {
-  String = "string",
-  User = "user",
-  Role = "role",
-  Channel = "channel",
-  Mentionable = "mentionable"
-}
-type RoutableConstructor = new (...args: never[]) => unknown;
-declare function areRoutes(routes: unknown): routes is string[];
-/**
- * every stored route kind and its route strings on a decorated constructor. the build's manifest
- * emitter reads the same pairs.
- */
-declare function interactionRoutesOf(constructor: RoutableConstructor): [InteractionRoutes, string[]][];
-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: ContextMenuKind): InteractionRoutes;
-//#endregion
 //#region src/decorators/brands.d.ts
 declare const SlashRouteBrand: unique symbol;
 declare const AutocompleteRouteBrand: unique symbol;
@@ -983,5 +764,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 { 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
+export { MessageContextMenuRegistry as $, serializeReply as A, IsNever as B, Gate as C, defineEffectGate as D, RequiredOf as E, ContextMenuNamesBrand as F, CacheFor as G, RowComponent as H, SlashRouteBrand as I, SlashOption as J, OptionKind as K, CommandMeta as L, ComponentDefsBrand as M, ComponentKindBrand as N, defineGate as O, ContextMenuKindBrand as P, MenuCacheFor as Q, RegisterCommand as R, EffectGate as S, GuildPermissionsContext as T, BuilderType as U, BuilderComponent as V, RowType as W, SlashRouteEntry as X, SlashRegistry as Y, ContextMenuKind as Z, pickNotice as _, AutocompleteOptions as a, JoinNames as b, FocusedField as c, RequirePermissionsOptions as d, NamesFor as et, RequireRole as f, GateNoticeOptions as g, PermissionScope as h, AutocompletableNames as i, AutocompleteRouteBrand as j, SerializedReply as k, RequireBotPermissions as l, PermissionNames as m, PageCursor as n, ChoiceValueOf as o, RequireRoleOptions as p, RouteCache as q, pageCursor as r, EntryFor as s, PAGE_MAX as t, UserContextMenuRegistry as tt, RequirePermissions as u, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, Promisable as z };
+//# sourceMappingURL=cursor-8Y2zpF-Y.d.mts.map