lunibee 0.2.0 → 0.2.2

package/README.md

@@ -162,12 +162,12 @@ Available lifecycle methods include `reply()`, `deferReply()`, `editReply()`, `d
 
 Lunibee provides strict builders for Discord payloads (Discord.js V2 compatible), including:
 
-- `ActionRowBuilder`
-- `ButtonBuilder`
-- `StringSelectBuilder`
-- `EmbedBuilder`
-- `ModalBuilder`
-- `TextInputBuilder`
+- `CreateActionRow`
+- `CreateButton`
+- `CreateStringSelect`
+- `CreateEmbed`
+- `CreateModal`
+- `CreateTextInput`
 
 Builders validate Discord limits before serialization and expose typed `toJSON()` payloads.
 

package/dist/builders/attachment.d.ts

@@ -4,7 +4,7 @@ export interface AttachmentData {
     file: Uint8Array | ArrayBuffer | Blob | Buffer | string;
 }
 /** Builder for message attachments and file uploads. */
-export declare class AttachmentBuilder {
+export declare class CreateAttachment {
     name: string;
     description?: string;
     file: Uint8Array | ArrayBuffer | Blob | Buffer | string;
@@ -18,3 +18,7 @@ export declare class AttachmentBuilder {
     /** Resolves the attachment payload to a binary Uint8Array. */
     toBuffer(): Promise<Uint8Array>;
 }
+/** @deprecated Use {@link CreateAttachment}. Removed in 2.0. */
+export declare const AttachmentBuilder: typeof CreateAttachment;
+/** @deprecated Use {@link CreateAttachment}. Removed in 2.0. */
+export type AttachmentBuilder = CreateAttachment;

package/dist/builders/commands.d.ts

@@ -1,5 +1,5 @@
 /** Discord application command option types. */
-export declare const ApplicationCommandOptionType: {
+export declare const ApplicationCommandOptionEnum: {
     readonly Subcommand: 1;
     readonly SubcommandGroup: 2;
     readonly String: 3;
@@ -12,8 +12,10 @@ export declare const ApplicationCommandOptionType: {
     readonly Number: 10;
     readonly Attachment: 11;
 };
+/** One {@link ApplicationCommandOptionEnum} value, usable as a type. */
+export type ApplicationCommandOptionEnum = (typeof ApplicationCommandOptionEnum)[keyof typeof ApplicationCommandOptionEnum];
 /** Builds Discord application command payloads. */
-export declare class SlashCommandBuilder {
+export declare class CreateSlashCommand {
     #private;
     /** Sets the command name. */ setName(name: string): this;
     /** Sets the command description. */ setDescription(description: string): this;
@@ -24,22 +26,22 @@ export declare class SlashCommandBuilder {
     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: StringOptionBuilder) => StringOptionBuilder): this;
-    /** Adds an integer option. */ addIntegerOption(configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder): this;
-    /** Adds a number option. */ addNumberOption(configure: (option: NumberOptionBuilder) => NumberOptionBuilder): this;
-    /** Adds a boolean option. */ addBooleanOption(configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder): this;
-    /** Adds a user option. */ addUserOption(configure: (option: UserOptionBuilder) => UserOptionBuilder): this;
-    /** Adds a channel option. */ addChannelOption(configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder): this;
-    /** Adds a role option. */ addRoleOption(configure: (option: RoleOptionBuilder) => RoleOptionBuilder): this;
-    /** Adds a mentionable option. */ addMentionableOption(configure: (option: MentionableOptionBuilder) => MentionableOptionBuilder): this;
-    /** Adds an attachment option. */ addAttachmentOption(configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder): this;
-    /** Adds a subcommand. */ addSubcommand(configure: (option: SubcommandBuilder) => SubcommandBuilder): this;
-    /** Adds a subcommand group. */ addSubcommandGroup(configure: (option: SubcommandGroupBuilder) => SubcommandGroupBuilder): 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: CommandOptionBuilder): this;
+    /** Adds a validated top-level command option. */ protected addOption(option: CreateCommandOption): this;
 }
 /** Base builder for command options. */
-export declare class CommandOptionBuilder {
+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;
@@ -49,7 +51,7 @@ export declare class CommandOptionBuilder {
     /** Serializes the option payload. */ toJSON(): Record<string, unknown>;
 }
 /** Builds a string command option. */
-export declare class StringOptionBuilder extends CommandOptionBuilder {
+export declare class CreateStringOption extends CreateCommandOption {
     /** Creates a string option. */ constructor();
     /** Adds string choices. */ addChoices(...choices: Array<{
         name: string;
@@ -59,7 +61,7 @@ export declare class StringOptionBuilder extends CommandOptionBuilder {
     /** Sets the maximum string length. */ setMaxLength(value: number): this;
 }
 /** Builds an integer command option. */
-export declare class IntegerOptionBuilder extends CommandOptionBuilder {
+export declare class CreateIntegerOption extends CreateCommandOption {
     constructor();
     setMinValue(value: number): this;
     setMaxValue(value: number): this;
@@ -70,7 +72,7 @@ export declare class IntegerOptionBuilder extends CommandOptionBuilder {
     }[]): this;
 }
 /** Builds a number command option. */
-export declare class NumberOptionBuilder extends CommandOptionBuilder {
+export declare class CreateNumberOption extends CreateCommandOption {
     constructor();
     setMinValue(value: number): this;
     setMaxValue(value: number): this;
@@ -80,45 +82,45 @@ export declare class NumberOptionBuilder extends CommandOptionBuilder {
         value: number;
     }[]): this;
 }
-/** Builds a boolean command option. */ export declare class BooleanOptionBuilder extends CommandOptionBuilder {
+/** Builds a boolean command option. */ export declare class CreateBooleanOption extends CreateCommandOption {
     /** Creates a boolean option. */ constructor();
 }
-/** Builds a user command option. */ export declare class UserOptionBuilder extends CommandOptionBuilder {
+/** Builds a user command option. */ export declare class CreateUserOption extends CreateCommandOption {
     /** Creates a user option. */ constructor();
 }
-/** Builds a role command option. */ export declare class RoleOptionBuilder extends CommandOptionBuilder {
+/** Builds a role command option. */ export declare class CreateRoleOption extends CreateCommandOption {
     /** Creates a role option. */ constructor();
 }
-/** Builds a mentionable command option. */ export declare class MentionableOptionBuilder extends CommandOptionBuilder {
+/** Builds a mentionable command option. */ export declare class CreateMentionableOption extends CreateCommandOption {
     /** Creates a mentionable option. */ constructor();
 }
-/** Builds an attachment command option. */ export declare class AttachmentOptionBuilder extends CommandOptionBuilder {
+/** Builds an attachment command option. */ export declare class CreateAttachmentOption extends CreateCommandOption {
     /** Creates an attachment option. */ constructor();
 }
-/** Builds a channel command option. */ export declare class ChannelOptionBuilder extends CommandOptionBuilder {
+/** 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 SubcommandBuilder extends CommandOptionBuilder {
+/** Builds a nested subcommand. */ export declare class CreateSubcommand extends CreateCommandOption {
     /** Creates a subcommand. */ constructor();
-    /** Adds a string option to this subcommand. */ addStringOption(configure: (option: StringOptionBuilder) => StringOptionBuilder): this;
-    /** Adds an integer option to this subcommand. */ addIntegerOption(configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder): this;
-    /** Adds a number option to this subcommand. */ addNumberOption(configure: (option: NumberOptionBuilder) => NumberOptionBuilder): this;
-    /** Adds a boolean option to this subcommand. */ addBooleanOption(configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder): this;
-    /** Adds a user option to this subcommand. */ addUserOption(configure: (option: UserOptionBuilder) => UserOptionBuilder): this;
-    /** Adds a channel option to this subcommand. */ addChannelOption(configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder): this;
-    /** Adds a role option to this subcommand. */ addRoleOption(configure: (option: RoleOptionBuilder) => RoleOptionBuilder): this;
-    /** Adds a mentionable option to this subcommand. */ addMentionableOption(configure: (option: MentionableOptionBuilder) => MentionableOptionBuilder): this;
-    /** Adds an attachment option to this subcommand. */ addAttachmentOption(configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder): this;
-    protected addChildOption(option: CommandOptionBuilder): this;
-}
-/** Builds a nested subcommand group. */ export declare class SubcommandGroupBuilder extends CommandOptionBuilder {
+    /** 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: SubcommandBuilder) => SubcommandBuilder): this;
+    /** 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 ContextMenuCommandBuilder().setName("x").setType(2)`. */
-export declare class ContextMenuCommandBuilder {
+ * Discord.js-familiar: `new CreateContextMenuCommand().setName("x").setType(2)`. */
+export declare class CreateContextMenuCommand {
     protected readonly data: Record<string, unknown>;
     constructor(type?: 2 | 3);
     /** Sets the command type: 2 = USER, 3 = MESSAGE. @throws {RangeError} For any other type. */
@@ -136,22 +138,106 @@ export declare class ContextMenuCommandBuilder {
     setDefaultMemberPermissions(permissions: bigint | number | string | null): this;
     /** Sets whether the command is available in direct messages. */
     setDMPermission(enabled: boolean): this;
-    /** Sets command integration types. */
+    /** Sets command integration types (0 guild install, 1 user install). */
     setIntegrationTypes(...types: number[]): 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;
+    /** Sets the name shown per locale, e.g. `{ "es-ES": "Ver perfil" }`; null clears it. */
+    setNameLocalizations(localizations: Record<string, string> | null): this;
     /** Serializes the command payload for the Discord API. */
     toJSON(): Record<string, unknown>;
 }
 /** Builds a User context menu command (appears when right-clicking a user, type 2).
  * @example
- * new UserCommandBuilder().setName("View Profile").toJSON()
+ * new CreateUserCommand().setName("View Profile").toJSON()
  */
-export declare class UserCommandBuilder extends ContextMenuCommandBuilder {
+export declare class CreateUserCommand extends CreateContextMenuCommand {
     constructor();
 }
 /** Builds a Message context menu command (appears when right-clicking a message, type 3).
  * @example
- * new MessageCommandBuilder().setName("Translate Message").toJSON()
+ * new CreateMessageCommand().setName("Translate Message").toJSON()
  */
-export declare class MessageCommandBuilder extends ContextMenuCommandBuilder {
+export declare class CreateMessageCommand extends CreateContextMenuCommand {
     constructor();
 }
+/** @deprecated Use {@link CreateAttachmentOption}. Removed in 2.0. */
+export declare const AttachmentOptionBuilder: typeof CreateAttachmentOption;
+/** @deprecated Use {@link CreateAttachmentOption}. Removed in 2.0. */
+export type AttachmentOptionBuilder = CreateAttachmentOption;
+/** @deprecated Use {@link CreateBooleanOption}. Removed in 2.0. */
+export declare const BooleanOptionBuilder: typeof CreateBooleanOption;
+/** @deprecated Use {@link CreateBooleanOption}. Removed in 2.0. */
+export type BooleanOptionBuilder = CreateBooleanOption;
+/** @deprecated Use {@link CreateChannelOption}. Removed in 2.0. */
+export declare const ChannelOptionBuilder: typeof CreateChannelOption;
+/** @deprecated Use {@link CreateChannelOption}. Removed in 2.0. */
+export type ChannelOptionBuilder = CreateChannelOption;
+/** @deprecated Use {@link CreateCommandOption}. Removed in 2.0. */
+export declare const CommandOptionBuilder: typeof CreateCommandOption;
+/** @deprecated Use {@link CreateCommandOption}. Removed in 2.0. */
+export type CommandOptionBuilder = CreateCommandOption;
+/** @deprecated Use {@link CreateContextMenuCommand}. Removed in 2.0. */
+export declare const ContextMenuCommandBuilder: typeof CreateContextMenuCommand;
+/** @deprecated Use {@link CreateContextMenuCommand}. Removed in 2.0. */
+export type ContextMenuCommandBuilder = CreateContextMenuCommand;
+/** @deprecated Use {@link CreateIntegerOption}. Removed in 2.0. */
+export declare const IntegerOptionBuilder: typeof CreateIntegerOption;
+/** @deprecated Use {@link CreateIntegerOption}. Removed in 2.0. */
+export type IntegerOptionBuilder = CreateIntegerOption;
+/** @deprecated Use {@link CreateMentionableOption}. Removed in 2.0. */
+export declare const MentionableOptionBuilder: typeof CreateMentionableOption;
+/** @deprecated Use {@link CreateMentionableOption}. Removed in 2.0. */
+export type MentionableOptionBuilder = CreateMentionableOption;
+/** @deprecated Use {@link CreateMessageCommand}. Removed in 2.0. */
+export declare const MessageCommandBuilder: typeof CreateMessageCommand;
+/** @deprecated Use {@link CreateMessageCommand}. Removed in 2.0. */
+export type MessageCommandBuilder = CreateMessageCommand;
+/** @deprecated Use {@link CreateNumberOption}. Removed in 2.0. */
+export declare const NumberOptionBuilder: typeof CreateNumberOption;
+/** @deprecated Use {@link CreateNumberOption}. Removed in 2.0. */
+export type NumberOptionBuilder = CreateNumberOption;
+/** @deprecated Use {@link CreateRoleOption}. Removed in 2.0. */
+export declare const RoleOptionBuilder: typeof CreateRoleOption;
+/** @deprecated Use {@link CreateRoleOption}. Removed in 2.0. */
+export type RoleOptionBuilder = CreateRoleOption;
+/** @deprecated Use {@link CreateSlashCommand}. Removed in 2.0. */
+export declare const SlashCommandBuilder: typeof CreateSlashCommand;
+/** @deprecated Use {@link CreateSlashCommand}. Removed in 2.0. */
+export type SlashCommandBuilder = CreateSlashCommand;
+/** @deprecated Use {@link CreateStringOption}. Removed in 2.0. */
+export declare const StringOptionBuilder: typeof CreateStringOption;
+/** @deprecated Use {@link CreateStringOption}. Removed in 2.0. */
+export type StringOptionBuilder = CreateStringOption;
+/** @deprecated Use {@link CreateSubcommand}. Removed in 2.0. */
+export declare const SubcommandBuilder: typeof CreateSubcommand;
+/** @deprecated Use {@link CreateSubcommand}. Removed in 2.0. */
+export type SubcommandBuilder = CreateSubcommand;
+/** @deprecated Use {@link CreateSubcommandGroup}. Removed in 2.0. */
+export declare const SubcommandGroupBuilder: typeof CreateSubcommandGroup;
+/** @deprecated Use {@link CreateSubcommandGroup}. Removed in 2.0. */
+export type SubcommandGroupBuilder = CreateSubcommandGroup;
+/** @deprecated Use {@link CreateUserCommand}. Removed in 2.0. */
+export declare const UserCommandBuilder: typeof CreateUserCommand;
+/** @deprecated Use {@link CreateUserCommand}. Removed in 2.0. */
+export type UserCommandBuilder = CreateUserCommand;
+/** @deprecated Use {@link CreateUserOption}. Removed in 2.0. */
+export declare const UserOptionBuilder: typeof CreateUserOption;
+/** @deprecated Use {@link CreateUserOption}. Removed in 2.0. */
+export type UserOptionBuilder = CreateUserOption;
+/** @deprecated Use {@link ApplicationCommandOptionEnum}. Removed in 2.0. */
+export declare const ApplicationCommandOptionType: {
+    readonly Subcommand: 1;
+    readonly SubcommandGroup: 2;
+    readonly String: 3;
+    readonly Integer: 4;
+    readonly Boolean: 5;
+    readonly User: 6;
+    readonly Channel: 7;
+    readonly Role: 8;
+    readonly Mentionable: 9;
+    readonly Number: 10;
+    readonly Attachment: 11;
+};
+/** @deprecated Use {@link ApplicationCommandOptionEnum}. Removed in 2.0. */
+export type ApplicationCommandOptionType = ApplicationCommandOptionEnum;