lunibee 0.2.3 → 0.2.4

package/dist/builders/commands.d.ts

@@ -17,8 +17,10 @@ export type ApplicationCommandOptionEnum = (typeof ApplicationCommandOptionEnum)
 /** Builds Discord application command payloads. */
 export declare class CreateSlashCommand {
     #private;
-    /** Sets the command name. */ setName(name: string): this;
-    /** Sets the command description. */ setDescription(description: string): this;
+    /** Sets the command name. */
+    setName(name: string): this;
+    /** Sets the command description. */
+    setDescription(description: string): this;
     /** Sets where the command can be used: 0 guilds, 1 the bot's DMs, 2 other DMs. @throws {RangeError} For any other value. */
     setContexts(...contexts: number[]): this;
     /** @deprecated Discord deprecated `dm_permission`. Use {@link CreateSlashCommand.setContexts}: `setContexts(0)` for guilds only, `setContexts(0, 1)` to allow the bot's DMs. Removed in 0.3.0. */
@@ -27,99 +29,154 @@ export declare class CreateSlashCommand {
     setNSFW(nsfw?: boolean): this;
     /** Sets whether the command is NSFW. */
     setNsfw(nsfw?: boolean): this;
-    /** Sets command default member permissions. */ setDefaultMemberPermissions(permissions: bigint | number | string | null): this;
-    /** Sets command integration types. */ setIntegrationTypes(...types: number[]): this;
-    /** Adds a string option. */ addStringOption(configure: (option: CreateStringOption) => CreateStringOption): this;
-    /** Adds an integer option. */ addIntegerOption(configure: (option: CreateIntegerOption) => CreateIntegerOption): this;
-    /** Adds a number option. */ addNumberOption(configure: (option: CreateNumberOption) => CreateNumberOption): this;
-    /** Adds a boolean option. */ addBooleanOption(configure: (option: CreateBooleanOption) => CreateBooleanOption): this;
-    /** Adds a user option. */ addUserOption(configure: (option: CreateUserOption) => CreateUserOption): this;
-    /** Adds a channel option. */ addChannelOption(configure: (option: CreateChannelOption) => CreateChannelOption): this;
-    /** Adds a role option. */ addRoleOption(configure: (option: CreateRoleOption) => CreateRoleOption): this;
-    /** Adds a mentionable option. */ addMentionableOption(configure: (option: CreateMentionableOption) => CreateMentionableOption): this;
-    /** Adds an attachment option. */ addAttachmentOption(configure: (option: CreateAttachmentOption) => CreateAttachmentOption): this;
-    /** Adds a subcommand. */ addSubcommand(configure: (option: CreateSubcommand) => CreateSubcommand): this;
-    /** Adds a subcommand group. */ addSubcommandGroup(configure: (option: CreateSubcommandGroup) => CreateSubcommandGroup): this;
-    /** Serializes the command payload. */ toJSON(): Record<string, unknown>;
-    /** Adds a validated top-level command option. */ protected addOption(option: CreateCommandOption): this;
+    /** Sets command default member permissions. */
+    setDefaultMemberPermissions(permissions: bigint | number | string | null): this;
+    /** Sets command integration types. */
+    setIntegrationTypes(...types: number[]): this;
+    /** Adds a string option. */
+    addStringOption(configure: (option: CreateStringOption) => CreateStringOption): this;
+    /** Adds an integer option. */
+    addIntegerOption(configure: (option: CreateIntegerOption) => CreateIntegerOption): this;
+    /** Adds a number option. */
+    addNumberOption(configure: (option: CreateNumberOption) => CreateNumberOption): this;
+    /** Adds a boolean option. */
+    addBooleanOption(configure: (option: CreateBooleanOption) => CreateBooleanOption): this;
+    /** Adds a user option. */
+    addUserOption(configure: (option: CreateUserOption) => CreateUserOption): this;
+    /** Adds a channel option. */
+    addChannelOption(configure: (option: CreateChannelOption) => CreateChannelOption): this;
+    /** Adds a role option. */
+    addRoleOption(configure: (option: CreateRoleOption) => CreateRoleOption): this;
+    /** Adds a mentionable option. */
+    addMentionableOption(configure: (option: CreateMentionableOption) => CreateMentionableOption): this;
+    /** Adds an attachment option. */
+    addAttachmentOption(configure: (option: CreateAttachmentOption) => CreateAttachmentOption): this;
+    /** Adds a subcommand. */
+    addSubcommand(configure: (option: CreateSubcommand) => CreateSubcommand): this;
+    /** Adds a subcommand group. */
+    addSubcommandGroup(configure: (option: CreateSubcommandGroup) => CreateSubcommandGroup): this;
+    /** Serializes the command payload. */
+    toJSON(): Record<string, unknown>;
+    /** Adds a validated top-level command option. */
+    protected addOption(option: CreateCommandOption): this;
 }
 /** Base builder for command options. */
 export declare class CreateCommandOption {
     protected readonly data: Record<string, unknown>;
-    /** Creates an option builder. */ constructor(type: number);
-    /** Sets the option name. */ setName(name: string): this;
-    /** Sets the option description. */ setDescription(description: string): this;
-    /** Makes the option required or optional. */ setRequired(required?: boolean): this;
-    /** Sets autocomplete. */ setAutocomplete(enabled?: boolean): this;
-    /** Serializes the option payload. */ toJSON(): Record<string, unknown>;
+    /** Creates an option builder. */
+    constructor(type: number);
+    /** Sets the option name. */
+    setName(name: string): this;
+    /** Sets the option description. */
+    setDescription(description: string): this;
+    /** Makes the option required or optional. */
+    setRequired(required?: boolean): this;
+    /** Sets autocomplete. */
+    setAutocomplete(enabled?: boolean): this;
+    /** Serializes the option payload. */
+    toJSON(): Record<string, unknown>;
 }
 /** Builds a string command option. */
 export declare class CreateStringOption extends CreateCommandOption {
-    /** Creates a string option. */ constructor();
-    /** Adds string choices. */ addChoices(...choices: Array<{
+    /** Creates a string option. */
+    constructor();
+    /** Adds string choices. */
+    addChoices(...choices: Array<{
         name: string;
         value: string;
     }>): this;
-    /** Sets the minimum string length. */ setMinLength(value: number): this;
-    /** Sets the maximum string length. */ setMaxLength(value: number): this;
+    /** Sets the minimum string length. */
+    setMinLength(value: number): this;
+    /** Sets the maximum string length. */
+    setMaxLength(value: number): this;
 }
-/** Builds an integer command option. */
-export declare class CreateIntegerOption extends CreateCommandOption {
-    constructor();
+/** Shared bounds, choices and autocomplete rules of integer and number options. */
+export declare class CreateNumericOption extends CreateCommandOption {
+    #private;
+    /** Creates a numeric option; `integer` rejects fractional bounds. */
+    constructor(type: number, integer: boolean);
+    /** Sets the minimum value. */
     setMinValue(value: number): this;
+    /** Sets the maximum value; it cannot be below the minimum. */
     setMaxValue(value: number): this;
+    /** Enables autocomplete; options with choices cannot use it. */
     setAutocomplete(enabled?: boolean): this;
+    /** Adds fixed choices. */
     addChoices(...choices: {
         name: string;
         value: number;
     }[]): this;
 }
+/** Builds an integer command option. */
+export declare class CreateIntegerOption extends CreateNumericOption {
+    constructor();
+}
 /** Builds a number command option. */
-export declare class CreateNumberOption extends CreateCommandOption {
+export declare class CreateNumberOption extends CreateNumericOption {
     constructor();
-    setMinValue(value: number): this;
-    setMaxValue(value: number): this;
-    setAutocomplete(enabled?: boolean): this;
-    addChoices(...choices: {
-        name: string;
-        value: number;
-    }[]): this;
 }
-/** Builds a boolean command option. */ export declare class CreateBooleanOption extends CreateCommandOption {
-    /** Creates a boolean option. */ constructor();
+/** Builds a boolean command option. */
+export declare class CreateBooleanOption extends CreateCommandOption {
+    /** Creates a boolean option. */
+    constructor();
 }
-/** Builds a user command option. */ export declare class CreateUserOption extends CreateCommandOption {
-    /** Creates a user option. */ constructor();
+/** Builds a user command option. */
+export declare class CreateUserOption extends CreateCommandOption {
+    /** Creates a user option. */
+    constructor();
 }
-/** Builds a role command option. */ export declare class CreateRoleOption extends CreateCommandOption {
-    /** Creates a role option. */ constructor();
+/** Builds a role command option. */
+export declare class CreateRoleOption extends CreateCommandOption {
+    /** Creates a role option. */
+    constructor();
 }
-/** Builds a mentionable command option. */ export declare class CreateMentionableOption extends CreateCommandOption {
-    /** Creates a mentionable option. */ constructor();
+/** Builds a mentionable command option. */
+export declare class CreateMentionableOption extends CreateCommandOption {
+    /** Creates a mentionable option. */
+    constructor();
 }
-/** Builds an attachment command option. */ export declare class CreateAttachmentOption extends CreateCommandOption {
-    /** Creates an attachment option. */ constructor();
+/** Builds an attachment command option. */
+export declare class CreateAttachmentOption extends CreateCommandOption {
+    /** Creates an attachment option. */
+    constructor();
 }
-/** Builds a channel command option. */ export declare class CreateChannelOption extends CreateCommandOption {
-    /** Creates a channel option. */ constructor();
-    /** Restricts accepted channel types. */ addChannelTypes(...types: number[]): this;
+/** Builds a channel command option. */
+export declare class CreateChannelOption extends CreateCommandOption {
+    /** Creates a channel option. */
+    constructor();
+    /** Restricts accepted channel types. */
+    addChannelTypes(...types: number[]): this;
 }
-/** Builds a nested subcommand. */ export declare class CreateSubcommand extends CreateCommandOption {
-    /** Creates a subcommand. */ constructor();
-    /** Adds a string option to this subcommand. */ addStringOption(configure: (option: CreateStringOption) => CreateStringOption): this;
-    /** Adds an integer option to this subcommand. */ addIntegerOption(configure: (option: CreateIntegerOption) => CreateIntegerOption): this;
-    /** Adds a number option to this subcommand. */ addNumberOption(configure: (option: CreateNumberOption) => CreateNumberOption): this;
-    /** Adds a boolean option to this subcommand. */ addBooleanOption(configure: (option: CreateBooleanOption) => CreateBooleanOption): this;
-    /** Adds a user option to this subcommand. */ addUserOption(configure: (option: CreateUserOption) => CreateUserOption): this;
-    /** Adds a channel option to this subcommand. */ addChannelOption(configure: (option: CreateChannelOption) => CreateChannelOption): this;
-    /** Adds a role option to this subcommand. */ addRoleOption(configure: (option: CreateRoleOption) => CreateRoleOption): this;
-    /** Adds a mentionable option to this subcommand. */ addMentionableOption(configure: (option: CreateMentionableOption) => CreateMentionableOption): this;
-    /** Adds an attachment option to this subcommand. */ addAttachmentOption(configure: (option: CreateAttachmentOption) => CreateAttachmentOption): this;
+/** Builds a nested subcommand. */
+export declare class CreateSubcommand extends CreateCommandOption {
+    /** Creates a subcommand. */
+    constructor();
+    /** Adds a string option to this subcommand. */
+    addStringOption(configure: (option: CreateStringOption) => CreateStringOption): this;
+    /** Adds an integer option to this subcommand. */
+    addIntegerOption(configure: (option: CreateIntegerOption) => CreateIntegerOption): this;
+    /** Adds a number option to this subcommand. */
+    addNumberOption(configure: (option: CreateNumberOption) => CreateNumberOption): this;
+    /** Adds a boolean option to this subcommand. */
+    addBooleanOption(configure: (option: CreateBooleanOption) => CreateBooleanOption): this;
+    /** Adds a user option to this subcommand. */
+    addUserOption(configure: (option: CreateUserOption) => CreateUserOption): this;
+    /** Adds a channel option to this subcommand. */
+    addChannelOption(configure: (option: CreateChannelOption) => CreateChannelOption): this;
+    /** Adds a role option to this subcommand. */
+    addRoleOption(configure: (option: CreateRoleOption) => CreateRoleOption): this;
+    /** Adds a mentionable option to this subcommand. */
+    addMentionableOption(configure: (option: CreateMentionableOption) => CreateMentionableOption): this;
+    /** Adds an attachment option to this subcommand. */
+    addAttachmentOption(configure: (option: CreateAttachmentOption) => CreateAttachmentOption): this;
     protected addChildOption(option: CreateCommandOption): this;
 }
-/** Builds a nested subcommand group. */ export declare class CreateSubcommandGroup extends CreateCommandOption {
-    /** Creates a subcommand group. */ constructor();
-    /** Adds a subcommand to this group. */ addSubcommand(configure: (option: CreateSubcommand) => CreateSubcommand): this;
+/** Builds a nested subcommand group. */
+export declare class CreateSubcommandGroup extends CreateCommandOption {
+    /** Creates a subcommand group. */
+    constructor();
+    /** Adds a subcommand to this group. */
+    addSubcommand(configure: (option: CreateSubcommand) => CreateSubcommand): this;
 }
 /** Builder for application commands that appear in right-click context menus.
  * Discord.js-familiar: `new CreateContextMenuCommand().setName("x").setType(2)`. */

package/dist/builders/components.d.ts

@@ -1,32 +1,11 @@
-import { ButtonType } from "@lunibee/types";
-export { ButtonType };
-/** Component type constants exposed by Lunibee. */
-export declare const ComponentEnum: {
-    readonly ActionRow: 1;
-    readonly Button: 2;
-    readonly StringSelect: 3;
-    readonly TextInput: 4;
-    readonly UserSelect: 5;
-    readonly RoleSelect: 6;
-    readonly MentionableSelect: 7;
-    readonly ChannelSelect: 8;
-    readonly Section: 9;
-    readonly TextDisplay: 10;
-    readonly Thumbnail: 11;
-    readonly MediaGallery: 12;
-    readonly File: 13;
-    readonly Separator: 14;
-    readonly ContentInventoryEntry: 16;
-    readonly Container: 17;
-};
+import { ButtonType, ComponentEnum } from "@lunibee/types";
+export { ButtonType, ComponentEnum };
 export declare const TextInputType: {
     readonly Short: 1;
     readonly Paragraph: 2;
 };
 /** One {@link TextInputType} value, usable as a type. */
 export type TextInputType = (typeof TextInputType)[keyof typeof TextInputType];
-/** One {@link ComponentEnum} value, usable as a type. */
-export type ComponentEnum = (typeof ComponentEnum)[keyof typeof ComponentEnum];
 export interface APIComponentEmoji {
     id?: string | null;
     name?: string | null;
@@ -157,14 +136,20 @@ export declare class CreateActionRow<T extends {
     clearComponents(): this;
     toJSON(): APIActionRowComponent;
 }
-export declare class CreateStringSelect {
+/** Setters shared by string and entity select menus. */
+export declare class CreateSelectMenu {
     #private;
+    protected constructor(data: APIStringSelectComponent | APIEntitySelectComponent);
     setCustomId(value: string): this;
     setPlaceholder(value: string): this;
     setMinValues(value: number): this;
     setMaxValues(value: number): this;
     setRequired(value?: boolean): this;
     setDisabled(value?: boolean): this;
+}
+export declare class CreateStringSelect extends CreateSelectMenu {
+    #private;
+    constructor();
     addOptions(...options: APISelectOption[]): this;
     toJSON(): APIStringSelectComponent;
 }
@@ -181,15 +166,9 @@ export declare class CreateButton {
     setDisabled(value?: boolean): this;
     toJSON(): APIButtonComponent;
 }
-export declare class CreateEntitySelect {
+export declare class CreateEntitySelect extends CreateSelectMenu {
     #private;
     constructor(type: typeof ComponentEnum.UserSelect | typeof ComponentEnum.RoleSelect | typeof ComponentEnum.MentionableSelect | typeof ComponentEnum.ChannelSelect);
-    setCustomId(value: string): this;
-    setPlaceholder(value: string): this;
-    setMinValues(value: number): this;
-    setMaxValues(value: number): this;
-    setRequired(value?: boolean): this;
-    setDisabled(value?: boolean): this;
     setDefaultValues(...values: APISelectDefaultValue[]): this;
     toJSON(): APIEntitySelectComponent;
 }

package/dist/builders/embed.d.ts

@@ -1,62 +1,95 @@
 /** Discord API embed field payload. */
 export interface EmbedField {
-    /** Field name. */ name: string;
-    /** Field value. */ value: string;
-    /** Whether the field is displayed inline. */ inline?: boolean;
+    /** Field name. */
+    name: string;
+    /** Field value. */
+    value: string;
+    /** Whether the field is displayed inline. */
+    inline?: boolean;
 }
 /** Discord API embed footer payload. */
 export interface EmbedFooter {
-    /** Footer text. */ text: string;
-    /** Footer icon URL. */ icon_url?: string;
+    /** Footer text. */
+    text: string;
+    /** Footer icon URL. */
+    icon_url?: string;
 }
 /** Discord API embed author payload. */
 export interface EmbedAuthor {
-    /** Author display name. */ name: string;
-    /** Author URL. */ url?: string;
-    /** Author icon URL. */ icon_url?: string;
+    /** Author display name. */
+    name: string;
+    /** Author URL. */
+    url?: string;
+    /** Author icon URL. */
+    icon_url?: string;
 }
 /** Strict Discord API embed payload. */
 export interface APIEmbed {
-    /** Embed title. */ title?: string;
-    /** Embed description. */ description?: string;
-    /** Embed URL. */ url?: string;
-    /** Embed color. */ color?: number;
-    /** ISO-8601 timestamp. */ timestamp?: string;
-    /** Embed footer. */ footer?: EmbedFooter;
-    /** Embed author. */ author?: EmbedAuthor;
-    /** Thumbnail payload. */ thumbnail?: {
+    /** Embed title. */
+    title?: string;
+    /** Embed description. */
+    description?: string;
+    /** Embed URL. */
+    url?: string;
+    /** Embed color. */
+    color?: number;
+    /** ISO-8601 timestamp. */
+    timestamp?: string;
+    /** Embed footer. */
+    footer?: EmbedFooter;
+    /** Embed author. */
+    author?: EmbedAuthor;
+    /** Thumbnail payload. */
+    thumbnail?: {
         url: string;
     };
-    /** Image payload. */ image?: {
+    /** Image payload. */
+    image?: {
         url: string;
     };
-    /** Embed fields. */ fields?: EmbedField[];
+    /** Embed fields. */
+    fields?: EmbedField[];
 }
 /** Builds compile-time-safe rich embed payloads for Discord API requests. */
 export declare class CreateEmbed {
     #private;
-    /** Sets the embed title. @param value Title text, or null to clear. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ setTitle(value: string | null): this;
-    /** Sets the embed description. @param value Description text, or null to clear. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ setDescription(value: string | null): this;
-    /** Sets the embed URL. @param value Absolute URL, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setURL(value: string | null): this;
-    /** Sets the embed color. @param value RGB integer. @returns This builder. @throws {RangeError} If color is outside 24-bit RGB range. */ setColor(value: number): this;
-    /** Sets the embed timestamp. @param value Date value. @returns This builder. @throws {RangeError} If date is invalid. */ setTimestamp(value?: Date): this;
-    /** Sets the embed footer. @param value Footer payload. @returns This builder. @throws {RangeError} If footer text exceeds Discord's limit. */ setFooter(value: EmbedFooter): this;
-    /** Sets the embed author. @param value Author payload. @returns This builder. @throws {RangeError} If author name exceeds Discord's limit. */ setAuthor(value: EmbedAuthor): this;
-    /** Sets the thumbnail URL. @param value Thumbnail URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setThumbnail(value: {
+    /** Sets the embed title. @param value Title text, or null to clear. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */
+    setTitle(value: string | null): this;
+    /** Sets the embed description. @param value Description text, or null to clear. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */
+    setDescription(value: string | null): this;
+    /** Sets the embed URL. @param value Absolute URL, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */
+    setURL(value: string | null): this;
+    /** Sets the embed color. @param value RGB integer. @returns This builder. @throws {RangeError} If color is outside 24-bit RGB range. */
+    setColor(value: number): this;
+    /** Sets the embed timestamp. @param value Date value. @returns This builder. @throws {RangeError} If date is invalid. */
+    setTimestamp(value?: Date): this;
+    /** Sets the embed footer. @param value Footer payload. @returns This builder. @throws {RangeError} If footer text exceeds Discord's limit. */
+    setFooter(value: EmbedFooter): this;
+    /** Sets the embed author. @param value Author payload. @returns This builder. @throws {RangeError} If author name exceeds Discord's limit. */
+    setAuthor(value: EmbedAuthor): this;
+    /** Sets the thumbnail URL. @param value Thumbnail URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */
+    setThumbnail(value: {
         url: string;
     } | string | null): this;
-    /** Sets the image URL. @param value Image URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setImage(value: {
+    /** Sets the image URL. @param value Image URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */
+    setImage(value: {
         url: string;
     } | string | null): this;
     /** Adds embed fields. Accepts both the spread form `addFields(a, b)` and the
      * single-array form `addFields([a, b])` for discord.js `RestOrArray` parity.
-     * @param fields Field payloads, spread or as a single array. @returns This builder. @throws {RangeError} If the 25-field limit is exceeded. */ addFields(...fields: EmbedField[] | [EmbedField[]]): this;
+     * @param fields Field payloads, spread or as a single array. @returns This builder. @throws {RangeError} If the 25-field limit is exceeded. */
+    addFields(...fields: EmbedField[] | [EmbedField[]]): this;
     setFields(fields: EmbedField[]): this;
-    /** Replaces fields starting at an index. @param index Start index. @param deleteCount Number of fields to remove. @param fields Replacement fields. @returns This builder. @throws {RangeError} If arguments are invalid or the 25-field limit is exceeded. */ spliceFields(index: number, deleteCount: number, ...fields: EmbedField[]): this;
-    /** Removes all embed fields. @returns This builder. */ clearFields(): this;
-    /** Removes the embed title. @returns This builder. */ clearTitle(): this;
-    /** Removes the embed description. @returns This builder. */ clearDescription(): this;
-    /** Returns a deep-cloned Discord API payload. @returns Strict embed payload. */ get data(): APIEmbed;
+    /** Replaces fields starting at an index. @param index Start index. @param deleteCount Number of fields to remove. @param fields Replacement fields. @returns This builder. @throws {RangeError} If arguments are invalid or the 25-field limit is exceeded. */
+    spliceFields(index: number, deleteCount: number, ...fields: EmbedField[]): this;
+    /** Removes all embed fields. @returns This builder. */
+    clearFields(): this;
+    /** Removes the embed title. @returns This builder. */
+    clearTitle(): this;
+    /** Removes the embed description. @returns This builder. */
+    clearDescription(): this;
+    /** Returns a deep-cloned Discord API payload. @returns Strict embed payload. */
+    get data(): APIEmbed;
     toJSON(): APIEmbed;
 }
 /** @deprecated Use {@link CreateEmbed}. Removed in 0.3.0. */