@minesa-org/mini-interaction 0.1.1 → 0.1.2

package/dist/builders/ModalStringSelectMenuBuilder.d.ts

@@ -1,5 +1,6 @@
 import { type APISelectMenuOption, type APIStringSelectComponent } from "discord-api-types/v10";
 import type { JSONEncodable } from "./shared.js";
+import type { StringSelectMenuOptionBuilder } from "./StringSelectMenuOptionBuilder.js";
 /** Shape describing initial modal string select menu data accepted by the builder. */
 export type ModalStringSelectMenuBuilderData = {
     customId?: string;
@@ -44,11 +45,15 @@ export declare class ModalStringSelectMenuBuilder implements JSONEncodable<APISt
     /**
      * Adds an option to the select menu.
      */
-    addOption(option: APISelectMenuOption): this;
+    addOption(option: APISelectMenuOption | StringSelectMenuOptionBuilder | JSONEncodable<APISelectMenuOption>): this;
+    /**
+     * Appends new option entries to the select menu.
+     */
+    addOptions(...options: (APISelectMenuOption | StringSelectMenuOptionBuilder | JSONEncodable<APISelectMenuOption>)[]): this;
     /**
      * Replaces all options in the select menu.
      */
-    setOptions(options: Iterable<APISelectMenuOption>): this;
+    setOptions(options: Iterable<APISelectMenuOption | StringSelectMenuOptionBuilder | JSONEncodable<APISelectMenuOption>>): this;
     /**
      * Serialises the builder into an API compatible string select menu payload.
      */

package/dist/builders/ModalStringSelectMenuBuilder.js

@@ -62,14 +62,36 @@ export class ModalStringSelectMenuBuilder {
      * Adds an option to the select menu.
      */
     addOption(option) {
-        this.data.options.push(option);
+        if ("toJSON" in option && typeof option.toJSON === "function") {
+            this.data.options.push({ ...option.toJSON() });
+        }
+        else {
+            this.data.options.push({ ...option });
+        }
+        return this;
+    }
+    /**
+     * Appends new option entries to the select menu.
+     */
+    addOptions(...options) {
+        this.data.options.push(...options.map((option) => {
+            if ("toJSON" in option && typeof option.toJSON === "function") {
+                return { ...option.toJSON() };
+            }
+            return { ...option };
+        }));
         return this;
     }
     /**
      * Replaces all options in the select menu.
      */
     setOptions(options) {
-        this.data.options = Array.from(options);
+        this.data.options = Array.from(options, (option) => {
+            if ("toJSON" in option && typeof option.toJSON === "function") {
+                return { ...option.toJSON() };
+            }
+            return { ...option };
+        });
         return this;
     }
     /**

package/dist/builders/StringSelectMenuBuilder.d.ts

@@ -1,5 +1,6 @@
 import { type APISelectMenuOption, type APIStringSelectComponent } from "discord-api-types/v10";
 import type { JSONEncodable } from "./shared.js";
+import type { StringSelectMenuOptionBuilder } from "./StringSelectMenuOptionBuilder.js";
 /** Shape describing initial string select menu data accepted by the builder. */
 export type StringSelectMenuBuilderData = {
     customId?: string;
@@ -39,11 +40,11 @@ export declare class StringSelectMenuBuilder implements JSONEncodable<APIStringS
     /**
      * Appends new option entries to the select menu.
      */
-    addOptions(...options: APISelectMenuOption[]): this;
+    addOptions(...options: (APISelectMenuOption | StringSelectMenuOptionBuilder | JSONEncodable<APISelectMenuOption>)[]): this;
     /**
      * Replaces the current option set with the provided iterable.
      */
-    setOptions(options: Iterable<APISelectMenuOption>): this;
+    setOptions(options: Iterable<APISelectMenuOption | StringSelectMenuOptionBuilder | JSONEncodable<APISelectMenuOption>>): this;
     /**
      * Serialises the builder into an API compatible string select menu payload.
      */

package/dist/builders/StringSelectMenuBuilder.js

@@ -54,14 +54,24 @@ export class StringSelectMenuBuilder {
      * Appends new option entries to the select menu.
      */
     addOptions(...options) {
-        this.data.options.push(...options.map((option) => ({ ...option })));
+        this.data.options.push(...options.map((option) => {
+            if ("toJSON" in option && typeof option.toJSON === "function") {
+                return { ...option.toJSON() };
+            }
+            return { ...option };
+        }));
         return this;
     }
     /**
      * Replaces the current option set with the provided iterable.
      */
     setOptions(options) {
-        this.data.options = Array.from(options, (option) => ({ ...option }));
+        this.data.options = Array.from(options, (option) => {
+            if ("toJSON" in option && typeof option.toJSON === "function") {
+                return { ...option.toJSON() };
+            }
+            return { ...option };
+        });
         return this;
     }
     /**

package/dist/builders/StringSelectMenuOptionBuilder.d.ts

@@ -0,0 +1,46 @@
+import type { APIMessageComponentEmoji, APISelectMenuOption } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial string select menu option data accepted by the builder. */
+export type StringSelectMenuOptionBuilderData = {
+    label?: string;
+    value?: string;
+    description?: string;
+    emoji?: string | APIMessageComponentEmoji;
+    default?: boolean;
+};
+/** Builder for Discord string select menu option components. */
+export declare class StringSelectMenuOptionBuilder implements JSONEncodable<APISelectMenuOption> {
+    private data;
+    /**
+     * Creates a new string select menu option builder with optional seed data.
+     */
+    constructor(data?: StringSelectMenuOptionBuilderData);
+    /**
+     * Sets the user-facing name of the option (max 100 characters).
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the dev-defined value of the option (max 100 characters).
+     */
+    setValue(value: string): this;
+    /**
+     * Sets an additional description of the option (max 100 characters).
+     */
+    setDescription(description: string | null | undefined): this;
+    /**
+     * Sets the emoji to display to the left of the option.
+     * Accepts:
+     * - Unicode emoji: "😀"
+     * - Custom emoji string: "<:name:id>" or "<a:name:id>"
+     * - Emoji object: { name: "😀" } or { name: "name", id: "id", animated: true }
+     */
+    setEmoji(emoji: string | APIMessageComponentEmoji | null | undefined): this;
+    /**
+     * Sets whether this option should be already-selected by default.
+     */
+    setDefault(isDefault: boolean): this;
+    /**
+     * Serialises the builder into an API compatible select menu option payload.
+     */
+    toJSON(): APISelectMenuOption;
+}

package/dist/builders/StringSelectMenuOptionBuilder.js

@@ -0,0 +1,106 @@
+/**
+ * Parses an emoji string into an APIMessageComponentEmoji object.
+ * Supports:
+ * - Unicode emojis: "😀"
+ * - Custom emojis: "<:name:id>" or "<a:name:id>"
+ * - Emoji objects: { name: "😀" } or { name: "name", id: "id" }
+ */
+function parseEmoji(emoji) {
+    if (typeof emoji === "object") {
+        return emoji;
+    }
+    // Check for custom emoji format: <:name:id> or <a:name:id>
+    const customEmojiMatch = emoji.match(/^<(a)?:([^:]+):(\d+)>$/);
+    if (customEmojiMatch) {
+        return {
+            name: customEmojiMatch[2],
+            id: customEmojiMatch[3],
+            animated: customEmojiMatch[1] === "a",
+        };
+    }
+    // Treat as unicode emoji
+    return { name: emoji };
+}
+/** Builder for Discord string select menu option components. */
+export class StringSelectMenuOptionBuilder {
+    data;
+    /**
+     * Creates a new string select menu option builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            label: data.label,
+            value: data.value,
+            description: data.description,
+            emoji: data.emoji ? parseEmoji(data.emoji) : undefined,
+            default: data.default,
+        };
+    }
+    /**
+     * Sets the user-facing name of the option (max 100 characters).
+     */
+    setLabel(label) {
+        this.data.label = label;
+        return this;
+    }
+    /**
+     * Sets the dev-defined value of the option (max 100 characters).
+     */
+    setValue(value) {
+        this.data.value = value;
+        return this;
+    }
+    /**
+     * Sets an additional description of the option (max 100 characters).
+     */
+    setDescription(description) {
+        this.data.description = description ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the emoji to display to the left of the option.
+     * Accepts:
+     * - Unicode emoji: "😀"
+     * - Custom emoji string: "<:name:id>" or "<a:name:id>"
+     * - Emoji object: { name: "😀" } or { name: "name", id: "id", animated: true }
+     */
+    setEmoji(emoji) {
+        this.data.emoji = emoji ? parseEmoji(emoji) : undefined;
+        return this;
+    }
+    /**
+     * Sets whether this option should be already-selected by default.
+     */
+    setDefault(isDefault) {
+        this.data.default = isDefault;
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible select menu option payload.
+     */
+    toJSON() {
+        const { label, value } = this.data;
+        if (!label) {
+            throw new Error("[StringSelectMenuOptionBuilder] label is required.");
+        }
+        if (!value) {
+            throw new Error("[StringSelectMenuOptionBuilder] value is required.");
+        }
+        if (label.length > 100) {
+            throw new Error("[StringSelectMenuOptionBuilder] label must be 100 characters or less.");
+        }
+        if (value.length > 100) {
+            throw new Error("[StringSelectMenuOptionBuilder] value must be 100 characters or less.");
+        }
+        if (this.data.description && this.data.description.length > 100) {
+            throw new Error("[StringSelectMenuOptionBuilder] description must be 100 characters or less.");
+        }
+        return {
+            label,
+            value,
+            description: this.data.description,
+            emoji: this.data.emoji ? { ...this.data.emoji } : undefined,
+            default: this.data.default,
+        };
+    }
+}

package/dist/builders/index.d.ts

@@ -5,6 +5,8 @@ export { ButtonBuilder } from "./ButtonBuilder.js";
 export type { ButtonBuilderData } from "./ButtonBuilder.js";
 export { StringSelectMenuBuilder } from "./StringSelectMenuBuilder.js";
 export type { StringSelectMenuBuilderData } from "./StringSelectMenuBuilder.js";
+export { StringSelectMenuOptionBuilder } from "./StringSelectMenuOptionBuilder.js";
+export type { StringSelectMenuOptionBuilderData } from "./StringSelectMenuOptionBuilder.js";
 export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export type { RoleSelectMenuBuilderData } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";

package/dist/builders/index.js

@@ -2,6 +2,7 @@
 export { ActionRowBuilder } from "./ActionRowBuilder.js";
 export { ButtonBuilder } from "./ButtonBuilder.js";
 export { StringSelectMenuBuilder } from "./StringSelectMenuBuilder.js";
+export { StringSelectMenuOptionBuilder } from "./StringSelectMenuOptionBuilder.js";
 export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
 export { ModalStringSelectMenuBuilder } from "./ModalStringSelectMenuBuilder.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@minesa-org/mini-interaction",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",