lunibee 0.1.6 → 0.1.7

package/README.md

@@ -132,10 +132,10 @@ REST-created and Gateway-updated resources are routed through manager cache muta
 
 ## Permissions
 
-`PermissionsBitField` provides named and raw permission checks:
+`PermissionSet` provides named and raw permission checks:
 
 ```ts
-if (member.permissions.has("ManageMessages")) {
+if (member.permissions.has(Permission.manageMessages)) {
     // permitted
 }
 ```
@@ -162,7 +162,7 @@ Lunibee provides strict builders for Discord payloads (Discord.js V2 compatible)
 
 - `ActionRowBuilder`
 - `ButtonBuilder`
-- `StringSelectMenuBuilder`
+- `StringSelectBuilder`
 - `EmbedBuilder`
 - `ModalBuilder`
 - `TextInputBuilder`

package/dist/builders/commands.d.ts

@@ -116,3 +116,40 @@ export declare class NumberOptionBuilder extends CommandOptionBuilder {
     /** Creates a subcommand group. */ constructor();
     /** Adds a subcommand to this group. */ addSubcommand(configure: (option: SubcommandBuilder) => SubcommandBuilder): this;
 }
+/** Base builder for application commands that appear in right-click context menus. */
+declare class ContextMenuCommandBuilder {
+    protected readonly data: Record<string, unknown>;
+    constructor(type: 2 | 3);
+    /** Sets the command name (shown in the right-click menu).
+     * Unlike CHAT_INPUT commands, USER (type 2) and MESSAGE (type 3) context-menu
+     * command names may contain uppercase letters and spaces, so no lowercase/charset
+     * validation is applied here — only Discord's 1-32 length limit and a non-empty
+     * (non-whitespace) requirement are enforced.
+     * @param name Display name; 1-32 characters, mixed case and spaces allowed.
+     * @throws {RangeError} If the name is empty/whitespace-only or exceeds 32 characters.
+     */
+    setName(name: string): this;
+    /** Sets default member permissions required to see this command. */
+    setDefaultMemberPermissions(permissions: bigint | number | string | null): this;
+    /** Sets whether the command is available in direct messages. */
+    setDMPermission(enabled: boolean): this;
+    /** Sets command integration types. */
+    setIntegrationTypes(...types: number[]): 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()
+ */
+export declare class UserCommandBuilder extends ContextMenuCommandBuilder {
+    constructor();
+}
+/** Builds a Message context menu command (appears when right-clicking a message, type 3).
+ * @example
+ * new MessageCommandBuilder().setName("Translate Message").toJSON()
+ */
+export declare class MessageCommandBuilder extends ContextMenuCommandBuilder {
+    constructor();
+}
+export {};

package/dist/builders/components.d.ts

@@ -1,3 +1,5 @@
+import { ButtonStyle } from "@lunibee/types";
+export { ButtonStyle };
 /** Component type constants exposed by Lunibee. */
 export declare const ComponentType: {
     readonly ActionRow: 1;
@@ -17,13 +19,6 @@ export declare const ComponentType: {
     readonly ContentInventoryEntry: 16;
     readonly Container: 17;
 };
-export declare const ButtonStyle: {
-    readonly Primary: 1;
-    readonly Secondary: 2;
-    readonly Success: 3;
-    readonly Danger: 4;
-    readonly Link: 5;
-};
 export declare const TextInputStyle: {
     readonly Short: 1;
     readonly Paragraph: 2;
@@ -35,7 +30,7 @@ export interface APIComponentEmoji {
 }
 export interface APIButtonComponent {
     type: typeof ComponentType.Button;
-    style: 1 | 2 | 3 | 4 | 5;
+    style: 1 | 2 | 3 | 4 | 5 | 6;
     custom_id?: string;
     label?: string;
     emoji?: APIComponentEmoji;
@@ -67,6 +62,7 @@ export interface APIEntitySelectComponent {
     max_values?: number;
     required?: boolean;
     disabled?: boolean;
+    default_values?: APISelectDefaultValue[];
 }
 export interface APITextInputComponent {
     type: typeof ComponentType.TextInput;
@@ -108,6 +104,11 @@ export interface APIMediaGalleryComponent {
         };
     }[];
 }
+/** Default values accepted by an auto-populated entity select. */
+export interface APISelectDefaultValue {
+    id: string;
+    type: "user" | "role" | "channel";
+}
 export interface APIFileComponent {
     type: typeof ComponentType.File;
     file: {
@@ -126,6 +127,8 @@ export interface APIThumbnailComponent {
     proxy_url?: string;
     width?: number;
     height?: number;
+    description?: string;
+    spoiler?: boolean;
 }
 export interface APIContentInventoryEntryComponent {
     type: typeof ComponentType.ContentInventoryEntry;
@@ -135,6 +138,7 @@ export interface APIContainerComponent {
     type: typeof ComponentType.Container;
     components: APIComponent[];
     accent_color?: number;
+    spoiler?: boolean;
 }
 export type APIComponent = APIActionRowComponent | APIButtonComponent | APIStringSelectComponent | APIEntitySelectComponent | APITextInputComponent | APISectionComponent | APITextDisplayComponent | APIThumbnailComponent | APIMediaGalleryComponent | APIFileComponent | APISeparatorComponent | APIContentInventoryEntryComponent | APIContainerComponent;
 export declare class ActionRowBuilder<T extends {
@@ -177,10 +181,7 @@ export declare class EntitySelectBuilder {
     setMaxValues(value: number): this;
     setRequired(value?: boolean): this;
     setDisabled(value?: boolean): this;
-    setDefaultValues(...values: {
-        id: string;
-        type: "user" | "role" | "channel";
-    }[]): this;
+    setDefaultValues(...values: APISelectDefaultValue[]): this;
     toJSON(): APIEntitySelectComponent;
 }
 export declare class ModalBuilder {
@@ -210,6 +211,8 @@ export declare class ContainerBuilder {
         toJSON(): APIComponent;
     }[]): this;
     setAccentColor(color: number): this;
+    /** Marks the whole container as a spoiler (blurred until clicked). */
+    setSpoiler(spoiler?: boolean): this;
     toJSON(): APIContainerComponent;
 }
 export declare class SectionBuilder {
@@ -250,6 +253,10 @@ export declare class SeparatorBuilder {
 export declare class ThumbnailBuilder {
     #private;
     setUrl(url: string): this;
+    /** Sets the thumbnail's alt-text description. */
+    setDescription(description: string): this;
+    /** Marks the thumbnail as a spoiler (blurred until clicked). */
+    setSpoiler(spoiler?: boolean): this;
     toJSON(): APIThumbnailComponent;
 }
 export declare class ContentInventoryEntryBuilder {

package/dist/builders/embed.d.ts

@@ -48,7 +48,9 @@ export declare class EmbedBuilder {
     /** Sets the image URL. @param value Image URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ setImage(value: {
         url: string;
     } | string): this;
-    /** Adds embed fields. @param fields Field payloads. @returns This builder. @throws {RangeError} If the 25-field limit is exceeded. */ addFields(...fields: EmbedField[]): 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;
     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;

package/dist/builders/index.d.ts

@@ -1,5 +1,5 @@
 export { EmbedBuilder } from "./embed.js";
 export type { EmbedField } from "./embed.js";
 export { ButtonBuilder, ButtonStyle, ComponentType, ActionRowBuilder, StringSelectBuilder, EntitySelectBuilder, ModalBuilder, TextInputBuilder, TextInputStyle, ContainerBuilder, SectionBuilder, TextDisplayBuilder, MediaGalleryBuilder, FileComponentBuilder, SeparatorBuilder, ThumbnailBuilder, ContentInventoryEntryBuilder, } from "./components.js";
-export { SlashCommandBuilder, StringOptionBuilder, IntegerOptionBuilder, NumberOptionBuilder, BooleanOptionBuilder, UserOptionBuilder, ChannelOptionBuilder, RoleOptionBuilder, MentionableOptionBuilder, AttachmentOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, ApplicationCommandOptionType, } from "./commands.js";
+export { SlashCommandBuilder, StringOptionBuilder, IntegerOptionBuilder, NumberOptionBuilder, BooleanOptionBuilder, UserOptionBuilder, ChannelOptionBuilder, RoleOptionBuilder, MentionableOptionBuilder, AttachmentOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, ApplicationCommandOptionType, UserCommandBuilder, MessageCommandBuilder, } from "./commands.js";
 export { AttachmentBuilder, type AttachmentData } from "./attachment.js";

package/dist/builders/index.js

@@ -53,16 +53,20 @@ class EmbedBuilder {
     return this;
   }
   addFields(...fields) {
-    if (!fields.length)
+    const resolved = fields.length === 1 && Array.isArray(fields[0]) ? fields[0] : fields;
+    if (!resolved.length)
       throw new TypeError("At least one embed field is required.");
     const current = this.#data.fields ?? [];
-    if (current.length + fields.length > 25)
+    if (current.length + resolved.length > 25)
       throw new RangeError("An embed cannot contain more than 25 fields.");
-    for (const field of fields) {
+    for (const field of resolved) {
       validate(field.name, 256, "Embed field name");
       validate(field.value, 1024, "Embed field value");
     }
-    this.#data.fields = [...current, ...fields.map((field) => ({ ...field }))];
+    this.#data.fields = [
+      ...current,
+      ...resolved.map((field) => ({ ...field }))
+    ];
     return this;
   }
   setFields(fields) {
@@ -110,6 +114,67 @@ function url(value, field) {
     throw new TypeError(`${field} must be a valid URL.`, { cause: error });
   }
 }
+// packages/types/src/index.ts
+var GatewayIntentBits = {
+  Guilds: 1 << 0,
+  GuildMembers: 1 << 1,
+  GuildModeration: 1 << 2,
+  GuildExpressions: 1 << 3,
+  GuildIntegrations: 1 << 4,
+  GuildWebhooks: 1 << 5,
+  GuildInvites: 1 << 6,
+  GuildVoiceStates: 1 << 7,
+  GuildPresences: 1 << 8,
+  GuildMessages: 1 << 9,
+  GuildMessageReactions: 1 << 10,
+  GuildMessageTyping: 1 << 11,
+  DirectMessages: 1 << 12,
+  DirectMessageReactions: 1 << 13,
+  DirectMessageTyping: 1 << 14,
+  MessageContent: 1 << 15,
+  GuildScheduledEvents: 1 << 16,
+  AutoModerationConfiguration: 1 << 20,
+  AutoModerationExecution: 1 << 21,
+  GuildMessagePolls: 1 << 24,
+  DirectMessagePolls: 1 << 25
+};
+var IntentBits = {
+  guild: 1 << 0,
+  guilds: 1 << 0,
+  guildMembers: 1 << 1,
+  guildModeration: 1 << 2,
+  guildBans: 1 << 2,
+  guildExpressions: 1 << 3,
+  guildEmojis: 1 << 3,
+  guildEmojisAndStickers: 1 << 3,
+  guildIntegrations: 1 << 4,
+  guildWebhooks: 1 << 5,
+  guildInvites: 1 << 6,
+  guildVoiceStates: 1 << 7,
+  guildPresences: 1 << 8,
+  guildMessages: 1 << 9,
+  guildMessage: 1 << 9,
+  guildMessageReactions: 1 << 10,
+  guildMessageTyping: 1 << 11,
+  directMessages: 1 << 12,
+  directMessageReactions: 1 << 13,
+  directMessageTyping: 1 << 14,
+  messageContent: 1 << 15,
+  guildScheduledEvents: 1 << 16,
+  autoModerationConfiguration: 1 << 20,
+  autoModerationExecution: 1 << 21,
+  guildMessagePolls: 1 << 24,
+  directMessagePolls: 1 << 25
+};
+var ButtonStyle = {
+  Primary: 1,
+  Secondary: 2,
+  Success: 3,
+  Danger: 4,
+  Link: 5,
+  Premium: 6
+};
+
 // packages/builders/src/components.ts
 var ComponentType = {
   ActionRow: 1,
@@ -129,13 +194,6 @@ var ComponentType = {
   ContentInventoryEntry: 16,
   Container: 17
 };
-var ButtonStyle = {
-  Primary: 1,
-  Secondary: 2,
-  Success: 3,
-  Danger: 4,
-  Link: 5
-};
 var TextInputStyle = { Short: 1, Paragraph: 2 };
 
 class ActionRowBuilder {
@@ -244,7 +302,9 @@ class ButtonBuilder {
     try {
       url2 = new URL(value);
     } catch (error) {
-      throw new TypeError("Button URL must be a valid URL.", { cause: error });
+      throw new TypeError("Button URL must be a valid URL.", {
+        cause: error
+      });
     }
     this.#data.style = ButtonStyle.Link;
     delete this.#data.custom_id;
@@ -300,7 +360,7 @@ class EntitySelectBuilder {
     return this;
   }
   setDefaultValues(...values) {
-    this.#data.default_values = values;
+    this.#data.default_values = values.map((value) => ({ ...value }));
     return this;
   }
   toJSON() {
@@ -391,6 +451,7 @@ class TextInputBuilder {
 class ContainerBuilder {
   #components = [];
   #accentColor;
+  #spoiler;
   addComponents(...components) {
     if (!components.length)
       throw new TypeError("At least one component is required.");
@@ -404,12 +465,20 @@ class ContainerBuilder {
     this.#accentColor = color;
     return this;
   }
+  setSpoiler(spoiler = true) {
+    this.#spoiler = spoiler;
+    return this;
+  }
   toJSON() {
-    return {
+    const data = {
       type: ComponentType.Container,
-      components: this.#components.map((c) => c.toJSON()),
-      accent_color: this.#accentColor
+      components: this.#components.map((c) => c.toJSON())
     };
+    if (this.#accentColor !== undefined)
+      data.accent_color = this.#accentColor;
+    if (this.#spoiler !== undefined)
+      data.spoiler = this.#spoiler;
+    return data;
   }
 }
 
@@ -520,16 +589,32 @@ class SeparatorBuilder {
 
 class ThumbnailBuilder {
   #url = "";
+  #description;
+  #spoiler;
   setUrl(url2) {
     validateText(url2, 2048, "Thumbnail URL");
     this.#url = url2;
     return this;
   }
+  setDescription(description) {
+    validateText(description, 1024, "Thumbnail description");
+    this.#description = description;
+    return this;
+  }
+  setSpoiler(spoiler = true) {
+    this.#spoiler = spoiler;
+    return this;
+  }
   toJSON() {
-    return {
+    const data = {
       type: ComponentType.Thumbnail,
       url: this.#url
     };
+    if (this.#description !== undefined)
+      data.description = this.#description;
+    if (this.#spoiler !== undefined)
+      data.spoiler = this.#spoiler;
+    return data;
   }
 }
 
@@ -918,6 +1003,46 @@ function validateNumberRange(value, minimum, maximum, field, integerOnly = true)
   if (!Number.isFinite(value) || integerOnly && !Number.isInteger(value) || value < minimum || value > maximum)
     throw new RangeError(`${field} must be ${integerOnly ? "an integer" : "a number"} between ${minimum} and ${maximum}.`);
 }
+
+class ContextMenuCommandBuilder {
+  data;
+  constructor(type) {
+    this.data = { type };
+  }
+  setName(name) {
+    if (typeof name !== "string" || name.trim().length < 1 || name.length > 32)
+      throw new RangeError("Command name must contain 1-32 characters.");
+    this.data.name = name;
+    return this;
+  }
+  setDefaultMemberPermissions(permissions) {
+    this.data.default_member_permissions = permissions === null ? null : BigInt(permissions).toString();
+    return this;
+  }
+  setDMPermission(enabled) {
+    this.data.dm_permission = enabled;
+    return this;
+  }
+  setIntegrationTypes(...types) {
+    this.data.integration_types = [...types];
+    return this;
+  }
+  toJSON() {
+    return structuredClone(this.data);
+  }
+}
+
+class UserCommandBuilder extends ContextMenuCommandBuilder {
+  constructor() {
+    super(2);
+  }
+}
+
+class MessageCommandBuilder extends ContextMenuCommandBuilder {
+  constructor() {
+    super(3);
+  }
+}
 // packages/builders/src/attachment.ts
 import { readFile } from "fs/promises";
 import { basename } from "path";
@@ -963,7 +1088,7 @@ class AttachmentBuilder {
     if (typeof Buffer !== "undefined" && Buffer.isBuffer(this.file)) {
       return new Uint8Array(this.file);
     }
-    return new Uint8Array;
+    throw new TypeError("Attachment file must be a supported binary value or file path.");
   }
 }
 export {
@@ -984,6 +1109,7 @@ export {
   IntegerOptionBuilder,
   MediaGalleryBuilder,
   MentionableOptionBuilder,
+  MessageCommandBuilder,
   ModalBuilder,
   NumberOptionBuilder,
   RoleOptionBuilder,
@@ -998,7 +1124,8 @@ export {
   TextInputBuilder,
   TextInputStyle,
   ThumbnailBuilder,
+  UserCommandBuilder,
   UserOptionBuilder
 };
 
-//# debugId=14619C67BE7B82B464756E2164756E21
+//# debugId=1FE9A1C7B4113D0264756E2164756E21