@minesa-org/mini-interaction 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Minesa™
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# Mini Interaction
+
+Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).

package/dist/builders/ActionRowBuilder.d.ts

@@ -0,0 +1,25 @@
+import type { APIActionRowComponent } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+import type { MiniComponentActionRow } from "../types/ComponentTypes.js";
+/** Values accepted when composing component action rows. */
+export type ActionRowComponentLike<T extends MiniComponentActionRow> = JSONEncodable<T> | T;
+/** Builder for Discord action row components. */
+export declare class ActionRowBuilder<T extends MiniComponentActionRow = MiniComponentActionRow> implements JSONEncodable<APIActionRowComponent<T>> {
+    private components;
+    /**
+     * Creates a new action row builder with optional seed components.
+     */
+    constructor(components?: Iterable<ActionRowComponentLike<T>>);
+    /**
+     * Appends additional components to the action row.
+     */
+    addComponents(...components: ActionRowComponentLike<T>[]): this;
+    /**
+     * Replaces the current action row contents.
+     */
+    setComponents(components: Iterable<ActionRowComponentLike<T>>): this;
+    /**
+     * Serialises the builder into an API compatible action row payload.
+     */
+    toJSON(): APIActionRowComponent<T>;
+}

package/dist/builders/ActionRowBuilder.js

@@ -0,0 +1,35 @@
+import { ComponentType } from "discord-api-types/v10";
+import { resolveJSONEncodable } from "./shared.js";
+/** Builder for Discord action row components. */
+export class ActionRowBuilder {
+    components;
+    /**
+     * Creates a new action row builder with optional seed components.
+     */
+    constructor(components = []) {
+        this.components = Array.from(components);
+    }
+    /**
+     * Appends additional components to the action row.
+     */
+    addComponents(...components) {
+        this.components.push(...components);
+        return this;
+    }
+    /**
+     * Replaces the current action row contents.
+     */
+    setComponents(components) {
+        this.components = Array.from(components);
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible action row payload.
+     */
+    toJSON() {
+        return {
+            type: ComponentType.ActionRow,
+            components: this.components.map((component) => resolveJSONEncodable(component)),
+        };
+    }
+}

package/dist/builders/ButtonBuilder.d.ts

@@ -0,0 +1,53 @@
+import { type APIButtonComponent, type APIMessageComponentEmoji } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+import { ButtonStyle } from "../types/ButtonStyle.js";
+/** Shape describing initial button data accepted by the builder. */
+export type ButtonBuilderData = {
+    style?: ButtonStyle;
+    label?: string;
+    emoji?: APIMessageComponentEmoji;
+    customId?: string;
+    url?: string;
+    disabled?: boolean;
+    skuId?: string;
+};
+/** Builder for Discord button components. */
+export declare class ButtonBuilder implements JSONEncodable<APIButtonComponent> {
+    private data;
+    /**
+     * Creates a new button builder with optional seed data.
+     */
+    constructor(data?: ButtonBuilderData);
+    /**
+     * Sets the visual style of the button.
+     */
+    setStyle(style: ButtonStyle): this;
+    /**
+     * Sets or clears the button label text.
+     */
+    setLabel(label: string | null | undefined): this;
+    /**
+     * Sets or clears the emoji displayed on the button.
+     */
+    setEmoji(emoji: APIMessageComponentEmoji | null | undefined): this;
+    /**
+     * Configures the button as an interaction component with the provided custom identifier.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Configures the button as a link button.
+     */
+    setURL(url: string): this;
+    /**
+     * Configures the button as a premium purchase button.
+     */
+    setSKUId(skuId: string): this;
+    /**
+     * Toggles whether the button is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Serialises the builder into an API compatible button payload.
+     */
+    toJSON(): APIButtonComponent;
+}

package/dist/builders/ButtonBuilder.js

@@ -0,0 +1,124 @@
+import { ComponentType, } from "discord-api-types/v10";
+import { ButtonStyle } from "../types/ButtonStyle.js";
+/** Builder for Discord button components. */
+export class ButtonBuilder {
+    data;
+    /**
+     * Creates a new button builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            style: data.style ?? ButtonStyle.Secondary,
+            label: data.label,
+            emoji: data.emoji ? { ...data.emoji } : undefined,
+            customId: data.customId,
+            url: data.url,
+            disabled: data.disabled,
+            skuId: data.skuId,
+        };
+    }
+    /**
+     * Sets the visual style of the button.
+     */
+    setStyle(style) {
+        this.data.style = style;
+        return this;
+    }
+    /**
+     * Sets or clears the button label text.
+     */
+    setLabel(label) {
+        this.data.label = label ?? undefined;
+        return this;
+    }
+    /**
+     * Sets or clears the emoji displayed on the button.
+     */
+    setEmoji(emoji) {
+        this.data.emoji = emoji ? { ...emoji } : undefined;
+        return this;
+    }
+    /**
+     * Configures the button as an interaction component with the provided custom identifier.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        if (this.data.style === ButtonStyle.Link) {
+            this.data.style = ButtonStyle.Secondary;
+        }
+        this.data.url = undefined;
+        this.data.skuId = undefined;
+        return this;
+    }
+    /**
+     * Configures the button as a link button.
+     */
+    setURL(url) {
+        this.data.url = url;
+        this.data.customId = undefined;
+        this.data.skuId = undefined;
+        this.data.style = ButtonStyle.Link;
+        return this;
+    }
+    /**
+     * Configures the button as a premium purchase button.
+     */
+    setSKUId(skuId) {
+        this.data.skuId = skuId;
+        this.data.customId = undefined;
+        this.data.url = undefined;
+        this.data.style = ButtonStyle.Premium;
+        return this;
+    }
+    /**
+     * Toggles whether the button is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible button payload.
+     */
+    toJSON() {
+        const { style, label, emoji, disabled } = this.data;
+        if (style === ButtonStyle.Link) {
+            const url = this.data.url;
+            if (!url) {
+                throw new Error("[ButtonBuilder] Link buttons must have a URL.");
+            }
+            return {
+                type: ComponentType.Button,
+                style,
+                label,
+                emoji: emoji ? { ...emoji } : undefined,
+                disabled,
+                url,
+            };
+        }
+        if (style === ButtonStyle.Premium) {
+            const skuId = this.data.skuId;
+            if (!skuId) {
+                throw new Error("[ButtonBuilder] Premium buttons must have an SKU id.");
+            }
+            return {
+                type: ComponentType.Button,
+                style,
+                disabled,
+                sku_id: skuId,
+            };
+        }
+        const customId = this.data.customId;
+        if (!customId) {
+            throw new Error("[ButtonBuilder] Non-link buttons must have a custom id.");
+        }
+        return {
+            type: ComponentType.Button,
+            style,
+            label,
+            emoji: emoji ? { ...emoji } : undefined,
+            disabled,
+            custom_id: customId,
+        };
+    }
+}

package/dist/builders/ChannelSelectMenuBuilder.d.ts

@@ -0,0 +1,58 @@
+import { SelectMenuDefaultValueType, type APIChannelSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import { ChannelType } from "../types/ChannelType.js";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial channel select menu data accepted by the builder. */
+export type ChannelSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    channelTypes?: ChannelType[];
+    defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>[];
+};
+/** Builder for Discord channel select menu components. */
+export declare class ChannelSelectMenuBuilder implements JSONEncodable<APIChannelSelectComponent> {
+    private data;
+    /**
+     * Creates a new channel select menu builder with optional seed data.
+     */
+    constructor(data?: ChannelSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no channel is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of channels that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of channels that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as requiring at least the minimum number of selections.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Filters selectable channels by the provided channel types.
+     */
+    setChannelTypes(channelTypes: Iterable<ChannelType>): this;
+    /**
+     * Replaces the default channel selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>>): this;
+    /**
+     * Serialises the builder into an API compatible channel select menu payload.
+     */
+    toJSON(): APIChannelSelectComponent;
+}

package/dist/builders/ChannelSelectMenuBuilder.js

@@ -0,0 +1,111 @@
+import { ComponentType, SelectMenuDefaultValueType, } from "discord-api-types/v10";
+/** Builder for Discord channel select menu components. */
+export class ChannelSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new channel select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            channelTypes: data.channelTypes
+                ? [...data.channelTypes]
+                : undefined,
+            defaultValues: data.defaultValues
+                ? data.defaultValues.map((value) => ({
+                    ...value,
+                    type: SelectMenuDefaultValueType.Channel,
+                }))
+                : undefined,
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no channel is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of channels that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of channels that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as requiring at least the minimum number of selections.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Filters selectable channels by the provided channel types.
+     */
+    setChannelTypes(channelTypes) {
+        this.data.channelTypes = Array.from(channelTypes);
+        return this;
+    }
+    /**
+     * Replaces the default channel selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues, (value) => ({
+            ...value,
+            type: SelectMenuDefaultValueType.Channel,
+        }));
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible channel select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ChannelSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.ChannelSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            channel_types: this.data.channelTypes
+                ? [...this.data.channelTypes]
+                : undefined,
+            default_values: this.data.defaultValues?.map((value) => ({
+                ...value,
+                type: SelectMenuDefaultValueType.Channel,
+            })),
+        };
+    }
+}

package/dist/builders/ModalBuilder.d.ts

@@ -0,0 +1,40 @@
+import type { APIModalInteractionResponseCallbackComponent, APIModalInteractionResponseCallbackData } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Values accepted when composing modal component rows. */
+export type ModalComponentLike = JSONEncodable<APIModalInteractionResponseCallbackComponent> | APIModalInteractionResponseCallbackComponent;
+/** Shape describing initial modal data accepted by the builder. */
+export type ModalBuilderData = {
+    customId?: string;
+    title?: string;
+    components?: Iterable<ModalComponentLike>;
+};
+/** Builder for Discord modal interaction responses. */
+export declare class ModalBuilder implements JSONEncodable<APIModalInteractionResponseCallbackData> {
+    private customId?;
+    private title?;
+    private components;
+    /**
+     * Creates a new modal builder with optional seed data.
+     */
+    constructor(data?: ModalBuilderData);
+    /**
+     * Sets the custom identifier returned when the modal is submitted.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets the modal title displayed to users.
+     */
+    setTitle(title: string): this;
+    /**
+     * Appends component rows to the modal body.
+     */
+    addComponents(...components: ModalComponentLike[]): this;
+    /**
+     * Replaces all component rows for the modal.
+     */
+    setComponents(components: Iterable<ModalComponentLike>): this;
+    /**
+     * Serialises the builder into an API compatible modal response payload.
+     */
+    toJSON(): APIModalInteractionResponseCallbackData;
+}

package/dist/builders/ModalBuilder.js

@@ -0,0 +1,65 @@
+import { resolveJSONEncodable } from "./shared.js";
+/** Builder for Discord modal interaction responses. */
+export class ModalBuilder {
+    customId;
+    title;
+    components;
+    /**
+     * Creates a new modal builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.customId = data.customId;
+        this.title = data.title;
+        this.components = data.components ? Array.from(data.components) : [];
+    }
+    /**
+     * Sets the custom identifier returned when the modal is submitted.
+     */
+    setCustomId(customId) {
+        this.customId = customId;
+        return this;
+    }
+    /**
+     * Sets the modal title displayed to users.
+     */
+    setTitle(title) {
+        this.title = title;
+        return this;
+    }
+    /**
+     * Appends component rows to the modal body.
+     */
+    addComponents(...components) {
+        this.components.push(...components);
+        return this;
+    }
+    /**
+     * Replaces all component rows for the modal.
+     */
+    setComponents(components) {
+        this.components = Array.from(components);
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible modal response payload.
+     */
+    toJSON() {
+        if (!this.customId) {
+            throw new Error("[ModalBuilder] custom id is required.");
+        }
+        if (!this.title) {
+            throw new Error("[ModalBuilder] title is required.");
+        }
+        if (this.components.length === 0) {
+            throw new Error("[ModalBuilder] at least one component is required.");
+        }
+        if (this.components.length > 5) {
+            throw new Error("[ModalBuilder] no more than 5 components can be provided.");
+        }
+        return {
+            custom_id: this.customId,
+            title: this.title,
+            components: this.components.map((component) => resolveJSONEncodable(component)),
+        };
+    }
+}

package/dist/builders/RoleSelectMenuBuilder.d.ts

@@ -0,0 +1,52 @@
+import { SelectMenuDefaultValueType, type APIRoleSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial role select menu data accepted by the builder. */
+export type RoleSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>[];
+};
+/** Builder for Discord role select menu components. */
+export declare class RoleSelectMenuBuilder implements JSONEncodable<APIRoleSelectComponent> {
+    private data;
+    /**
+     * Creates a new role select menu builder with optional seed data.
+     */
+    constructor(data?: RoleSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no role is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of roles that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of roles that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as requiring at least the minimum number of selections.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Replaces the default role selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>>): this;
+    /**
+     * Serialises the builder into an API compatible role select menu payload.
+     */
+    toJSON(): APIRoleSelectComponent;
+}

package/dist/builders/RoleSelectMenuBuilder.js

@@ -0,0 +1,98 @@
+import { ComponentType, SelectMenuDefaultValueType, } from "discord-api-types/v10";
+/** Builder for Discord role select menu components. */
+export class RoleSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new role select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            defaultValues: data.defaultValues
+                ? data.defaultValues.map((value) => ({
+                    ...value,
+                    type: SelectMenuDefaultValueType.Role,
+                }))
+                : undefined,
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no role is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of roles that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of roles that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as requiring at least the minimum number of selections.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Replaces the default role selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues, (value) => ({
+            ...value,
+            type: SelectMenuDefaultValueType.Role,
+        }));
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible role select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[RoleSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.RoleSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            default_values: this.data.defaultValues?.map((value) => ({
+                ...value,
+                type: SelectMenuDefaultValueType.Role,
+            })),
+        };
+    }
+}