lunibee 0.2.2 → 0.2.4

package/dist/builders/embed.d.ts

@@ -1,65 +1,98 @@
 /** 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 2.0. */
+/** @deprecated Use {@link CreateEmbed}. Removed in 0.3.0. */
 export declare const EmbedBuilder: typeof CreateEmbed;
-/** @deprecated Use {@link CreateEmbed}. Removed in 2.0. */
+/** @deprecated Use {@link CreateEmbed}. Removed in 0.3.0. */
 export type EmbedBuilder = CreateEmbed;

package/dist/builders/index.d.ts

@@ -1,7 +1,7 @@
 export { CreateEmbed } from "./embed.js";
 export type { EmbedField } from "./embed.js";
 export { CreateButton, ButtonType, ComponentEnum, CreateActionRow, CreateStringSelect, CreateStringSelectMenu, CreateEntitySelect, CreateUserSelectMenu, CreateRoleSelectMenu, CreateMentionableSelectMenu, CreateChannelSelectMenu, CreateModal, CreateTextInput, TextInputType, CreateContainer, CreateSection, CreateTextDisplay, CreateMediaGallery, CreateFileComponent, CreateSeparator, CreateThumbnail, CreateContentInventoryEntry, componentsV2Message, } from "./components.js";
-export { CreateSlashCommand, CreateStringOption, CreateIntegerOption, CreateNumberOption, CreateBooleanOption, CreateUserOption, CreateChannelOption, CreateRoleOption, CreateMentionableOption, CreateAttachmentOption, CreateSubcommand, CreateSubcommandGroup, ApplicationCommandOptionEnum, CreateUserCommand, CreateMessageCommand, CreateContextMenuCommand, } from "./commands.js";
+export { CreateSlashCommand, CreateCommandOption, CreateStringOption, CreateIntegerOption, CreateNumberOption, CreateBooleanOption, CreateUserOption, CreateChannelOption, CreateRoleOption, CreateMentionableOption, CreateAttachmentOption, CreateSubcommand, CreateSubcommandGroup, ApplicationCommandOptionEnum, CreateUserCommand, CreateMessageCommand, CreateContextMenuCommand, } from "./commands.js";
 export { CreateAttachment, type AttachmentData } from "./attachment.js";
 export { AttachmentBuilder } from "./attachment.js";
 export { EmbedBuilder } from "./embed.js";

package/dist/builders/index.js

@@ -185,16 +185,6 @@ var IntentBits = {
   directMessagePolls: 1 << 25
 };
 // packages/types/src/index.ts
-var ButtonType = {
-  Primary: 1,
-  Secondary: 2,
-  Success: 3,
-  Danger: 4,
-  Link: 5,
-  Premium: 6
-};
-
-// packages/builders/src/components.ts
 var ComponentEnum = {
   ActionRow: 1,
   Button: 2,
@@ -213,6 +203,16 @@ var ComponentEnum = {
   ContentInventoryEntry: 16,
   Container: 17
 };
+var ButtonType = {
+  Primary: 1,
+  Secondary: 2,
+  Success: 3,
+  Danger: 4,
+  Link: 5,
+  Premium: 6
+};
+
+// packages/builders/src/components.ts
 var TextInputType = { Short: 1, Paragraph: 2 };
 
 class CreateActionRow {
@@ -240,38 +240,50 @@ class CreateActionRow {
   }
 }
 
-class CreateStringSelect {
-  #data = {
-    type: ComponentEnum.StringSelect
-  };
+class CreateSelectMenu {
+  #select;
+  constructor(data) {
+    this.#select = data;
+  }
   setCustomId(value) {
     validateText(value, 100, "Component custom ID");
-    this.#data.custom_id = value;
+    this.#select.custom_id = value;
     return this;
   }
   setPlaceholder(value) {
     validateText(value, 150, "Component placeholder");
-    this.#data.placeholder = value;
+    this.#select.placeholder = value;
     return this;
   }
   setMinValues(value) {
     validateCount(value, "min_values", 0);
-    this.#data.min_values = value;
+    this.#select.min_values = value;
     return this;
   }
   setMaxValues(value) {
     validateCount(value, "max_values", 1);
-    this.#data.max_values = value;
+    this.#select.max_values = value;
     return this;
   }
   setRequired(value = true) {
-    this.#data.required = value;
+    this.#select.required = value;
     return this;
   }
   setDisabled(value = true) {
-    this.#data.disabled = value;
+    this.#select.disabled = value;
     return this;
   }
+}
+
+class CreateStringSelect extends CreateSelectMenu {
+  #data;
+  constructor() {
+    const data = {
+      type: ComponentEnum.StringSelect
+    };
+    super(data);
+    this.#data = data;
+  }
   addOptions(...options) {
     if (!options.length)
       throw new TypeError("At least one select option is required.");
@@ -387,40 +399,14 @@ class CreateButton {
   }
 }
 
-class CreateEntitySelect {
+class CreateEntitySelect extends CreateSelectMenu {
   #data;
   constructor(type) {
     if (type !== ComponentEnum.UserSelect && type !== ComponentEnum.RoleSelect && type !== ComponentEnum.MentionableSelect && type !== ComponentEnum.ChannelSelect)
       throw new TypeError("Invalid select component type.");
-    this.#data = { type };
-  }
-  setCustomId(value) {
-    validateText(value, 100, "Component custom ID");
-    this.#data.custom_id = value;
-    return this;
-  }
-  setPlaceholder(value) {
-    validateText(value, 150, "Component placeholder");
-    this.#data.placeholder = value;
-    return this;
-  }
-  setMinValues(value) {
-    validateCount(value, "min_values", 0);
-    this.#data.min_values = value;
-    return this;
-  }
-  setMaxValues(value) {
-    validateCount(value, "max_values", 1);
-    this.#data.max_values = value;
-    return this;
-  }
-  setRequired(value = true) {
-    this.#data.required = value;
-    return this;
-  }
-  setDisabled(value = true) {
-    this.#data.disabled = value;
-    return this;
+    const data = { type };
+    super(data);
+    this.#data = data;
   }
   setDefaultValues(...values) {
     this.#data.default_values = values.map((value) => ({ ...value }));
@@ -800,6 +786,10 @@ var ApplicationCommandOptionEnum = {
   Number: 10,
   Attachment: 11
 };
+function validateContexts(contexts) {
+  if (contexts.some((context) => context !== 0 && context !== 1 && context !== 2))
+    throw new RangeError("Command contexts must be 0, 1 or 2.");
+}
 
 class CreateSlashCommand {
   #data = { type: 1 };
@@ -813,6 +803,11 @@ class CreateSlashCommand {
     this.#data.description = description;
     return this;
   }
+  setContexts(...contexts) {
+    validateContexts(contexts);
+    this.#data.contexts = [...contexts];
+    return this;
+  }
   setDMPermission(enabled) {
     this.#data.dm_permission = enabled;
     return this;
@@ -869,16 +864,7 @@ class CreateSlashCommand {
     return structuredClone(this.#data);
   }
   addOption(option) {
-    const options = this.#data.options ?? [];
-    if (options.length >= 25)
-      throw new RangeError("An application command cannot contain more than 25 options.");
-    const payload = option.toJSON();
-    if (options.some((existing) => existing.name === payload.name))
-      throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
-    if (payload.required === true && options.some((existing) => existing.required !== true))
-      throw new RangeError("Required application command options must be placed before optional options.");
-    options.push(payload);
-    this.#data.options = options;
+    this.#data.options = appendOption(this.#data.options, option.toJSON(), "application command");
     return this;
   }
 }
@@ -916,21 +902,9 @@ class CreateStringOption extends CreateCommandOption {
     super(ApplicationCommandOptionEnum.String);
   }
   addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    for (const choice of choices) {
-      validateText2(choice.name, "Choice name", 100);
+    for (const choice of choices)
       validateText2(choice.value, "Choice value", 100);
-    }
-    this.data.choices = [
-      ...current,
-      ...choices.map((choice) => ({ ...choice }))
-    ];
+    appendChoices(this.data, choices);
     return this;
   }
   setMinLength(value) {
@@ -947,18 +921,21 @@ class CreateStringOption extends CreateCommandOption {
   }
 }
 
-class CreateIntegerOption extends CreateCommandOption {
-  constructor() {
-    super(ApplicationCommandOptionEnum.Integer);
+class CreateNumericOption extends CreateCommandOption {
+  #integer;
+  constructor(type, integer) {
+    super(type);
+    this.#integer = integer;
   }
   setMinValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "min_value", true);
+    validateNumberRange(value, -MAX_SAFE, MAX_SAFE, "min_value", this.#integer);
     this.data.min_value = value;
     return this;
   }
   setMaxValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "max_value", true);
-    if (this.data.min_value !== undefined && this.data.min_value > value)
+    validateNumberRange(value, -MAX_SAFE, MAX_SAFE, "max_value", this.#integer);
+    const min = this.data.min_value;
+    if (min !== undefined && min > value)
       throw new RangeError("min_value cannot exceed max_value.");
     this.data.max_value = value;
     return this;
@@ -970,50 +947,20 @@ class CreateIntegerOption extends CreateCommandOption {
     return this;
   }
   addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    this.data.choices = [...current, ...choices];
+    appendChoices(this.data, choices);
     return this;
   }
 }
 
-class CreateNumberOption extends CreateCommandOption {
+class CreateIntegerOption extends CreateNumericOption {
   constructor() {
-    super(ApplicationCommandOptionEnum.Number);
-  }
-  setMinValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "min_value", false);
-    this.data.min_value = value;
-    return this;
+    super(ApplicationCommandOptionEnum.Integer, true);
   }
-  setMaxValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "max_value", false);
-    if (this.data.min_value !== undefined && this.data.min_value > value)
-      throw new RangeError("min_value cannot exceed max_value.");
-    this.data.max_value = value;
-    return this;
-  }
-  setAutocomplete(enabled = true) {
-    if (enabled && Array.isArray(this.data.choices) && this.data.choices.length)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    this.data.autocomplete = enabled;
-    return this;
-  }
-  addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    this.data.choices = [...current, ...choices];
-    return this;
+}
+
+class CreateNumberOption extends CreateNumericOption {
+  constructor() {
+    super(ApplicationCommandOptionEnum.Number, false);
   }
 }
 
@@ -1092,17 +1039,9 @@ class CreateSubcommand extends CreateCommandOption {
   }
   addChildOption(option) {
     const options = this.data.options ?? [];
-    if (options.length >= 25)
-      throw new RangeError("A subcommand cannot contain more than 25 options.");
-    const payload = option.toJSON();
-    if (options.some((existing) => existing.name === payload.name))
-      throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
-    if (payload.required === true && options.some((existing) => existing.required !== true))
-      throw new RangeError("Required subcommand options must be placed before optional options.");
     if (options.some((existing) => existing.type === ApplicationCommandOptionEnum.Subcommand))
       throw new RangeError("Subcommands cannot contain nested subcommands.");
-    options.push(payload);
-    this.data.options = options;
+    this.data.options = appendOption(options, option.toJSON(), "subcommand");
     return this;
   }
 }
@@ -1125,6 +1064,29 @@ class CreateSubcommandGroup extends CreateCommandOption {
     return this;
   }
 }
+var MAX_SAFE = Number.MAX_SAFE_INTEGER;
+function appendOption(options, payload, parent) {
+  const list = options ?? [];
+  if (list.length >= 25)
+    throw new RangeError(`${parent === "subcommand" ? "A subcommand" : "An application command"} cannot contain more than 25 options.`);
+  if (list.some((existing) => existing.name === payload.name))
+    throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
+  if (payload.required === true && list.some((existing) => existing.required !== true))
+    throw new RangeError(`Required ${parent} options must be placed before optional options.`);
+  return [...list, payload];
+}
+function appendChoices(data, choices) {
+  const current = data.choices ?? [];
+  if (!choices.length)
+    throw new TypeError("At least one choice is required.");
+  if (data.autocomplete === true)
+    throw new RangeError("Autocomplete options cannot define choices.");
+  if (current.length + choices.length > 25)
+    throw new RangeError("An option cannot contain more than 25 choices.");
+  for (const choice of choices)
+    validateText2(choice.name, "Choice name", 100);
+  data.choices = [...current, ...choices.map((choice) => ({ ...choice }))];
+}
 function validateName(value, field) {
   if (!/^[\p{L}\p{N}_-]{1,32}$/u.test(value) || value !== value.toLowerCase())
     throw new RangeError(`${field} must contain 1-32 lowercase letters, numbers, underscores, or hyphens.`);
@@ -1172,8 +1134,7 @@ class CreateContextMenuCommand {
     return this;
   }
   setContexts(...contexts) {
-    if (contexts.some((context) => context !== 0 && context !== 1 && context !== 2))
-      throw new RangeError("Command contexts must be 0, 1 or 2.");
+    validateContexts(contexts);
     this.data.contexts = [...contexts];
     return this;
   }
@@ -1215,13 +1176,14 @@ var UserCommandBuilder = CreateUserCommand;
 var UserOptionBuilder = CreateUserOption;
 var ApplicationCommandOptionType = ApplicationCommandOptionEnum;
 // packages/builders/src/attachment.ts
-import { readFile } from "fs/promises";
-import { basename } from "path";
+import { readFile, realpath } from "fs/promises";
+import { basename, isAbsolute, relative, resolve } from "path";
 
 class CreateAttachment {
   name;
   description;
   file;
+  root;
   constructor(file, data) {
     this.file = file;
     if (typeof data === "string") {
@@ -1229,6 +1191,7 @@ class CreateAttachment {
     } else {
       this.name = data?.name ?? (typeof file === "string" ? basename(file) : "file.bin");
       this.description = data?.description;
+      this.root = data?.root;
     }
   }
   setName(name) {
@@ -1245,7 +1208,8 @@ class CreateAttachment {
   }
   async toBuffer() {
     if (typeof this.file === "string") {
-      const buffer = await readFile(this.file);
+      const path = this.root === undefined ? this.file : await insideRoot(this.root, this.file);
+      const buffer = await readFile(path);
       return new Uint8Array(buffer);
     }
     if (this.file instanceof Uint8Array)
@@ -1263,6 +1227,16 @@ class CreateAttachment {
   }
 }
 var AttachmentBuilder = CreateAttachment;
+async function insideRoot(root, file) {
+  const base = await realpath(root);
+  const target = await realpath(resolve(base, file)).catch(() => {
+    throw new Error("Attachment file was not found inside its root.");
+  });
+  const rel = relative(base, target);
+  if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
+    throw new Error("Attachment file is outside its root folder.");
+  return target;
+}
 export {
   ActionRowBuilder,
   ApplicationCommandOptionEnum,
@@ -1288,6 +1262,7 @@ export {
   CreateButton,
   CreateChannelOption,
   CreateChannelSelectMenu,
+  CreateCommandOption,
   CreateContainer,
   CreateContentInventoryEntry,
   CreateContextMenuCommand,
@@ -1348,4 +1323,4 @@ export {
   componentsV2Message
 };
 
-//# debugId=E27BC2383A77150B64756E2164756E21
+//# debugId=AAEFB888B204975D64756E2164756E21