@minesa-org/mini-interaction 0.4.0 → 0.4.3

package/README.md

@@ -1,34 +1,144 @@
-# Mini Interaction
+# 🌌 Mini Interaction
 
-Discord interactions framework for HTTP/webhook bots with direct Discord API v10 payload compatibility.
+> **Sleek, Modular, and Type-Safe Discord Interactions Framework.**
 
-## Quick start (slash command)
+Mini Interaction is a high-performance framework designed for building Discord HTTP/Webhook-based bots. It provides a modular architecture that separates concerns, making your bot easier to maintain, test, and scale.
+
+---
+
+## ✨ Features
+
+- **🚀 Modular Router**: Easily map commands, components, and modals to handlers.
+- **⚡ Core V10 Engine**: Native support for Discord API v10 payloads.
+- **🛡️ Type Safety**: Full TypeScript support with rich autocompletion.
+- **🧩 Fluent Builders**: Construct complex messages and components with a premium API.
+- **🔐 Integrated OAuth**: Simple handlers for Discord OAuth2 flows.
+- **🗃️ Mini Database**: Lightweight, document-based storage integration.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @minesa-org/mini-interaction
+```
+
+---
+
+## 🛠️ Quick Start
+
+Mini Interaction uses a modular approach with a dedicated Router and Context.
+
+### 1. Define your Router
 ```ts
-import { LegacyMiniInteractionAdapter } from '@minesa-org/mini-interaction';
+import { InteractionRouter } from '@minesa-org/mini-interaction';
+
+const router = new InteractionRouter();
+
+// Register a slash command
+router.onCommand('ping', async (interaction, ctx) => {
+  return ctx.reply({ content: '🏓 Pong!' });
+});
 
-const adapter = new LegacyMiniInteractionAdapter({ publicKey, applicationId, token });
-adapter.router.onCommand('ping', async (_interaction, ctx) => ctx.reply({ content: 'pong' }));
+// Register a component handler
+router.onComponent('my_button', async (interaction, ctx) => {
+  return ctx.reply({ content: 'Button clicked!', ephemeral: true });
+});
 ```
 
-## Modal example (label + upload + select)
+### 2. Handle Interactions
 ```ts
-import {
-  ModalBuilder,
-  LabelBuilder,
-  TextInputBuilder,
-  FileUploadBuilder,
-  ModalRoleSelectMenuBuilder,
+import { 
+  verifyAndParseInteraction, 
+  InteractionContext, 
+  DiscordRestClient 
 } from '@minesa-org/mini-interaction';
+
+const rest = new DiscordRestClient({ 
+  applicationId: process.env.DISCORD_APP_ID, 
+  token: process.env.DISCORD_TOKEN 
+});
+
+// In your web server (e.g., Next.js, Vercel, Express)
+export async function POST(req) {
+  const body = await req.text();
+  const signature = req.headers.get('x-signature-ed25519');
+  const timestamp = req.headers.get('x-signature-timestamp');
+
+  // Verify and parse the interaction
+  const interaction = await verifyAndParseInteraction({
+    body,
+    signature,
+    timestamp,
+    publicKey: process.env.DISCORD_PUBLIC_KEY
+  });
+
+  if (interaction.type === 1) return Response.json({ type: 1 });
+
+  const ctx = new InteractionContext({ interaction, rest });
+  const response = await router.dispatch(interaction, ctx);
+
+  return Response.json(response ?? ctx.deferReply());
+}
 ```
 
-## Radio example
+---
+
+## 🎨 Message Builders
+
+Mini Interaction provides a rich set of builders to create beautiful Discord content.
+
+```ts
+import { ModalBuilder, TextInputBuilder, TextInputStyle } from '@minesa-org/mini-interaction';
+
+const modal = new ModalBuilder()
+  .setCustomId('feedback_form')
+  .setTitle('Send us Feedback')
+  .addComponents(
+    new TextInputBuilder()
+      .setCustomId('feedback_text')
+      .setLabel('Your Message')
+      .setStyle(TextInputStyle.Paragraph)
+      .setPlaceholder('Tell us what you think...')
+  );
+```
+
+---
+
+## 📡 Advanced Routing
+
+You can organize your handlers into separate modules for better scalability.
+
 ```ts
-import { RadioBuilder } from '@minesa-org/mini-interaction';
+// components/modals.ts
+router.onModal('feedback_submit', async (interaction, ctx) => {
+  const feedback = interaction.getTextFieldValue('feedback_text');
+  // Process feedback...
+  return ctx.reply({ content: 'Thank you for your feedback!' });
+});
+```
+
+---
+
+## 🛡️ Error Handling
+
+Mini Interaction includes built-in validation to ensure your payloads follow Discord's requirements.
 
-const radio = new RadioBuilder()
-  .setCustomId('flavor')
-  .addOptions({ label: 'Vanilla', value: 'v', default: true }, { label: 'Chocolate', value: 'c' });
+```ts
+import { ValidationError } from '@minesa-org/mini-interaction';
+
+try {
+  const builder = new TextInputBuilder().setCustomId(''); // Too short!
+  builder.toJSON();
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error(`Validation failed for ${error.component}: ${error.message}`);
+  }
+}
 ```
 
-## Error handling
-Catch `ValidationError` from builders to surface actionable diagnostics.
+---
+
+## 📜 License
+
+MIT © [Minesa](https://github.com/minesa-org)

package/dist/builders/ActionRowBuilder.d.ts

@@ -1,12 +1,11 @@
-import type { APIActionRowComponent } from "discord-api-types/v10";
 import type { JSONEncodable } from "./shared.js";
-import type { ActionRowComponent } from "../types/ComponentTypes.js";
+import type { ActionRowComponent, MiniActionRow } from "../types/ComponentTypes.js";
 /** Values accepted when composing component action rows. */
 export type ActionRowComponentLike<T extends ActionRowComponent> = JSONEncodable<T> | T;
 /** Builder for creating Action Row components. */
-export declare class ActionRowBuilder<T extends ActionRowComponent> implements JSONEncodable<APIActionRowComponent<T>> {
+export declare class ActionRowBuilder<T extends ActionRowComponent> implements JSONEncodable<MiniActionRow<T>> {
     private components;
-    constructor(data?: Partial<APIActionRowComponent<T>>);
+    constructor(data?: Partial<MiniActionRow<T>>);
     /**
      * Adds components to this action row.
      *
@@ -19,5 +18,5 @@ export declare class ActionRowBuilder<T extends ActionRowComponent> implements J
      * @param components - The new components to set.
      */
     setComponents(...components: (T | JSONEncodable<T>)[]): this;
-    toJSON(): APIActionRowComponent<T>;
+    toJSON(): MiniActionRow<T>;
 }

package/dist/builders/CheckboxBuilder.d.ts

@@ -0,0 +1,17 @@
+import type { JSONEncodable } from './shared.js';
+import { APICheckboxComponent, APICheckboxOption } from '../types/checkbox.js';
+export type CheckboxBuilderData = {
+    customId?: string;
+    required?: boolean;
+    disabled?: boolean;
+    options?: APICheckboxOption[];
+};
+export declare class CheckboxBuilder implements JSONEncodable<APICheckboxComponent> {
+    private readonly data;
+    constructor(data?: CheckboxBuilderData);
+    setCustomId(customId: string): this;
+    setRequired(required: boolean): this;
+    setDisabled(disabled: boolean): this;
+    addOptions(...options: APICheckboxOption[]): this;
+    toJSON(): APICheckboxComponent;
+}

package/dist/builders/CheckboxBuilder.js

@@ -0,0 +1,24 @@
+import { CHECKBOX_COMPONENT_TYPE } from '../types/checkbox.js';
+import { assertDefined, assertStringLength, ValidationError } from '../types/validation.js';
+export class CheckboxBuilder {
+    data;
+    constructor(data = {}) { this.data = { ...data, options: data.options ? [...data.options] : [] }; }
+    setCustomId(customId) { this.data.customId = customId; return this; }
+    setRequired(required) { this.data.required = required; return this; }
+    setDisabled(disabled) { this.data.disabled = disabled; return this; }
+    addOptions(...options) { this.data.options = [...(this.data.options ?? []), ...options]; return this; }
+    toJSON() {
+        const customId = assertDefined('CheckboxBuilder', 'custom_id', this.data.customId);
+        assertStringLength('CheckboxBuilder', 'custom_id', customId, 1, 100);
+        const options = [...(this.data.options ?? [])];
+        if (options.length === 0 || options.length > 25)
+            throw new ValidationError('CheckboxBuilder', 'options', 'must contain 1-25 options');
+        for (const [index, option] of options.entries()) {
+            assertStringLength('CheckboxBuilder', `options[${index}].label`, option.label, 1, 100);
+            assertStringLength('CheckboxBuilder', `options[${index}].value`, option.value, 1, 100);
+            if (option.description)
+                assertStringLength('CheckboxBuilder', `options[${index}].description`, option.description, 1, 100);
+        }
+        return { type: CHECKBOX_COMPONENT_TYPE, custom_id: customId, disabled: this.data.disabled, required: this.data.required, options };
+    }
+}

package/dist/builders/index.d.ts

@@ -38,3 +38,5 @@ export type { ContainerBuilderData, SectionBuilderData, TextDisplayBuilderData,
 export type { JSONEncodable } from "./shared.js";
 export { RadioBuilder } from "./RadioBuilder.js";
 export type { RadioBuilderData } from "./RadioBuilder.js";
+export { CheckboxBuilder } from "./CheckboxBuilder.js";
+export type { CheckboxBuilderData } from "./CheckboxBuilder.js";

package/dist/builders/index.js

@@ -18,3 +18,4 @@ export { AutomodRuleBuilder } from "./AutomodRuleBuilder.js";
 export { EmbedBuilder } from "./EmbedBuilder.js";
 export { ContainerBuilder, SectionBuilder, TextDisplayBuilder, SeparatorBuilder, GalleryBuilder, GalleryItemBuilder, ThumbnailBuilder, } from "./MiniContainerBuilder.js";
 export { RadioBuilder } from "./RadioBuilder.js";
+export { CheckboxBuilder } from "./CheckboxBuilder.js";

package/dist/index.d.ts

@@ -1,25 +1,20 @@
-/** Entry point re-exporting MiniInteraction helpers, builders, and shared types. */
-export { MiniInteraction } from "./clients/MiniInteraction.js";
-export type { RoleConnectionMetadataField } from "./clients/MiniInteraction.js";
 export { CommandBuilder, CommandContext, IntegrationType, } from "./commands/CommandBuilder.js";
 export { UserCommandBuilder, MessageCommandBuilder, AppCommandBuilder, } from "./commands/ContextMenuCommandBuilder.js";
 export type { AttachmentOptionBuilder, ChannelOptionBuilder, MentionableOptionBuilder, NumberOptionBuilder, RoleOptionBuilder, StringOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, UserOptionBuilder, } from "./commands/CommandBuilder.js";
 export { CommandInteractionOptionResolver, createCommandInteraction, } from "./utils/CommandInteractionOptions.js";
 export { CommandInteraction, MentionableOption, ResolvedUserOption, } from "./utils/CommandInteractionOptions.js";
 export { UserContextMenuInteraction, MessageContextMenuInteraction, AppCommandInteraction, } from "./utils/ContextMenuInteraction.js";
-export type { InteractionFetchHandler, InteractionNodeHandler, InteractionHandlerResult, InteractionRequest, InteractionClientOptions, DiscordOAuthAuthorizeContext, DiscordOAuthCallbackOptions, DiscordOAuthCallbackTemplates, DiscordOAuthErrorTemplateContext, DiscordOAuthServerErrorTemplateContext, DiscordOAuthStateTemplateContext, DiscordOAuthSuccessTemplateContext, DiscordOAuthVerificationPageOptions, } from "./clients/MiniInteraction.js";
-export type { InteractionCommand, SlashCommandHandler, UserCommandHandler, MessageCommandHandler, AppCommandHandler, CommandHandler, } from "./types/Commands.js";
-export type { ComponentCommand, ButtonComponentHandler, StringSelectComponentHandler, RoleSelectComponentHandler, UserSelectComponentHandler, ChannelSelectComponentHandler, MentionableSelectComponentHandler, ComponentHandler, ModalCommand, ModalHandler, InteractionHandler, } from "./clients/MiniInteraction.js";
-export { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
+export type { InteractionCommand, SlashCommandHandler, UserCommandHandler, MessageCommandHandler, AppCommandHandler, CommandHandler, ComponentInteraction, InteractionComponent, InteractionModal, } from "./types/Commands.js";
+export { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, RadioInteraction, CheckboxInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
 export { ModalSubmitInteraction } from "./utils/ModalSubmitInteraction.js";
 export { RoleConnectionMetadataTypes } from "./types/RoleConnectionMetadataTypes.js";
 export { ChannelType } from "./types/ChannelType.js";
-export { InteractionFollowUpFlags, InteractionReplyFlags, InteractionFlags, } from "./types/InteractionFlags.js";
+export { InteractionFlags, } from "./types/InteractionFlags.js";
 export { ButtonStyle } from "./types/ButtonStyle.js";
 export { SeparatorSpacingSize } from "./types/SeparatorSpacingSize.js";
 export { TextInputStyle } from "discord-api-types/v10";
 export { MiniPermFlags } from "./types/PermissionFlags.js";
-export type { ActionRowComponent, MessageActionRowComponent, } from "./types/ComponentTypes.js";
+export type { ActionRowComponent, MessageActionRowComponent, InteractionComponentData, } from "./types/ComponentTypes.js";
 export * from "./builders/index.js";
 export { MiniDataBuilder } from "./database/MiniDataBuilder.js";
 export type { DataField } from "./database/MiniDataBuilder.js";
@@ -35,8 +30,8 @@ export { InteractionContext } from "./core/interactions/InteractionContext.js";
 export type { InteractionContextOptions } from "./core/interactions/InteractionContext.js";
 export { verifyAndParseInteraction } from "./core/interactions/InteractionVerifier.js";
 export { InteractionRouter } from "./router/InteractionRouter.js";
-export { LegacyMiniInteractionAdapter } from "./compat/LegacyMiniInteractionAdapter.js";
-export type { LegacyAdapterOptions } from "./compat/LegacyMiniInteractionAdapter.js";
 export type { APIRadioComponent, APIRadioOption } from "./types/radio.js";
 export { RADIO_COMPONENT_TYPE } from "./types/radio.js";
+export type { APICheckboxComponent, APICheckboxOption } from "./types/checkbox.js";
+export { CHECKBOX_COMPONENT_TYPE } from "./types/checkbox.js";
 export { ValidationError } from "./types/validation.js";

package/dist/index.js

@@ -1,15 +1,13 @@
-/** Entry point re-exporting MiniInteraction helpers, builders, and shared types. */
-export { MiniInteraction } from "./clients/MiniInteraction.js";
 export { CommandBuilder, CommandContext, IntegrationType, } from "./commands/CommandBuilder.js";
 export { UserCommandBuilder, MessageCommandBuilder, AppCommandBuilder, } from "./commands/ContextMenuCommandBuilder.js";
 export { CommandInteractionOptionResolver, createCommandInteraction, } from "./utils/CommandInteractionOptions.js";
 export { CommandInteraction, MentionableOption, ResolvedUserOption, } from "./utils/CommandInteractionOptions.js";
 export { UserContextMenuInteraction, MessageContextMenuInteraction, AppCommandInteraction, } from "./utils/ContextMenuInteraction.js";
-export { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
+export { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, RadioInteraction, CheckboxInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
 export { ModalSubmitInteraction } from "./utils/ModalSubmitInteraction.js";
 export { RoleConnectionMetadataTypes } from "./types/RoleConnectionMetadataTypes.js";
 export { ChannelType } from "./types/ChannelType.js";
-export { InteractionFollowUpFlags, InteractionReplyFlags, InteractionFlags, } from "./types/InteractionFlags.js";
+export { InteractionFlags, } from "./types/InteractionFlags.js";
 export { ButtonStyle } from "./types/ButtonStyle.js";
 export { SeparatorSpacingSize } from "./types/SeparatorSpacingSize.js";
 export { TextInputStyle } from "discord-api-types/v10";
@@ -25,6 +23,6 @@ export { DiscordRestClient } from "./core/http/DiscordRestClient.js";
 export { InteractionContext } from "./core/interactions/InteractionContext.js";
 export { verifyAndParseInteraction } from "./core/interactions/InteractionVerifier.js";
 export { InteractionRouter } from "./router/InteractionRouter.js";
-export { LegacyMiniInteractionAdapter } from "./compat/LegacyMiniInteractionAdapter.js";
 export { RADIO_COMPONENT_TYPE } from "./types/radio.js";
+export { CHECKBOX_COMPONENT_TYPE } from "./types/checkbox.js";
 export { ValidationError } from "./types/validation.js";

package/dist/types/Commands.d.ts

@@ -1,6 +1,8 @@
 import type { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody, RESTPostAPIContextMenuApplicationCommandsJSONBody, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody } from "discord-api-types/v10";
 import type { CommandInteraction } from "../utils/CommandInteractionOptions.js";
 import type { UserContextMenuInteraction, MessageContextMenuInteraction, AppCommandInteraction } from "../utils/ContextMenuInteraction.js";
+import type { ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, RadioInteraction, CheckboxInteraction } from "../utils/MessageComponentInteraction.js";
+import type { ModalSubmitInteraction } from "../utils/ModalSubmitInteraction.js";
 import type { JSONEncodable } from "../builders/shared.js";
 import type { CommandBuilder } from "../commands/CommandBuilder.js";
 import type { MessageCommandBuilder, UserCommandBuilder, AppCommandBuilder } from "../commands/ContextMenuCommandBuilder.js";
@@ -19,5 +21,17 @@ export type InteractionCommand = {
     data: RESTPostAPIChatInputApplicationCommandsJSONBody | RESTPostAPIContextMenuApplicationCommandsJSONBody | RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody | CommandBuilder | UserCommandBuilder | MessageCommandBuilder | AppCommandBuilder | JSONEncodable<RESTPostAPIChatInputApplicationCommandsJSONBody | RESTPostAPIContextMenuApplicationCommandsJSONBody | RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody>;
     handler: CommandHandler;
 };
+/** Handler for any message component interaction */
+export type ComponentInteraction = ButtonInteraction | StringSelectInteraction | RoleSelectInteraction | UserSelectInteraction | ChannelSelectInteraction | MentionableSelectInteraction | RadioInteraction | CheckboxInteraction;
+/** Structure for a standalone component handler */
+export type InteractionComponent = {
+    customId: string;
+    handler: (interaction: ComponentInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+};
+/** Structure for a standalone modal handler */
+export type InteractionModal = {
+    customId: string;
+    handler: (interaction: ModalSubmitInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+};
 /** Map of command names to their registered MiniInteraction command definitions. */
 export type InteractionCommandsMap = Map<string, InteractionCommand>;

package/dist/types/ComponentTypes.d.ts

@@ -1,5 +1,19 @@
-import type { APIComponentInActionRow, APIComponentInMessageActionRow } from "discord-api-types/v10";
+import type { APIComponentInActionRow, APIComponentInMessageActionRow, APIModalInteractionResponseCallbackComponent } from "discord-api-types/v10";
+import type { APIRadioComponent } from "./radio.js";
+import type { APICheckboxComponent } from "./checkbox.js";
 /** Defines a component structure for use in ActionRow builders. */
-export type ActionRowComponent = APIComponentInActionRow;
+export type ActionRowComponent = APIComponentInActionRow | APIRadioComponent | APICheckboxComponent;
 /** Defines a message component structure for use in message builders. */
-export type MessageActionRowComponent = APIComponentInMessageActionRow;
+export type MessageActionRowComponent = APIComponentInMessageActionRow | APIRadioComponent | APICheckboxComponent;
+/** Structure for an action row containing mini-interaction components. */
+export interface MiniActionRow<T extends ActionRowComponent = ActionRowComponent> {
+    type: 1;
+    components: T[];
+}
+/** Structure for a message action row containing mini-interaction components. */
+export interface MessageMiniActionRow<T extends MessageActionRowComponent = MessageActionRowComponent> {
+    type: 1;
+    components: T[];
+}
+/** Generic type for any supported interaction component data. */
+export type InteractionComponentData = MessageActionRowComponent | APIModalInteractionResponseCallbackComponent;

package/dist/types/InteractionFlags.d.ts

@@ -3,7 +3,3 @@ export declare enum InteractionFlags {
     IsComponentsV2 = 32768,
     SuppressEmbeds = 4
 }
-/** @deprecated Use InteractionFlags instead. */
-export { InteractionFlags as InteractionReplyFlags };
-/** @deprecated Use InteractionFlags instead. */
-export { InteractionFlags as InteractionFollowUpFlags };

package/dist/types/InteractionFlags.js

@@ -4,7 +4,3 @@ export var InteractionFlags;
     InteractionFlags[InteractionFlags["IsComponentsV2"] = 32768] = "IsComponentsV2";
     InteractionFlags[InteractionFlags["SuppressEmbeds"] = 4] = "SuppressEmbeds";
 })(InteractionFlags || (InteractionFlags = {}));
-/** @deprecated Use InteractionFlags instead. */
-export { InteractionFlags as InteractionReplyFlags };
-/** @deprecated Use InteractionFlags instead. */
-export { InteractionFlags as InteractionFollowUpFlags };

package/dist/types/checkbox.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Discord API support for checkbox components may lag behind discord-api-types releases.
+ * These local contracts are runtime-validated and serialized as raw component payloads.
+ */
+export declare const CHECKBOX_COMPONENT_TYPE: 2002;
+export type APICheckboxOption = {
+    label: string;
+    value: string;
+    description?: string;
+    emoji?: {
+        id?: string;
+        name?: string;
+        animated?: boolean;
+    };
+    default?: boolean;
+};
+export type APICheckboxComponent = {
+    type: typeof CHECKBOX_COMPONENT_TYPE;
+    custom_id: string;
+    disabled?: boolean;
+    required?: boolean;
+    options: APICheckboxOption[];
+};

package/dist/types/checkbox.js

@@ -0,0 +1,5 @@
+/**
+ * Discord API support for checkbox components may lag behind discord-api-types releases.
+ * These local contracts are runtime-validated and serialized as raw component payloads.
+ */
+export const CHECKBOX_COMPONENT_TYPE = 2002;

package/dist/utils/MessageComponentInteraction.d.ts

@@ -138,6 +138,44 @@ export interface MentionableSelectInteraction extends Omit<APIMessageComponentIn
     trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const MentionableSelectInteraction: {};
+/**
+ * Radio interaction with helper methods.
+ */
+export interface RadioInteraction extends Omit<APIMessageComponentInteraction, "data"> {
+    data: APIMessageStringSelectInteractionData;
+    values: string[];
+    getStringValues: () => string[];
+    getResponse: () => APIInteractionResponse | null;
+    reply: (data: InteractionMessageData) => Promise<APIInteractionResponseChannelMessageWithSource>;
+    deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
+    update: (data?: InteractionMessageData) => Promise<APIInteractionResponseUpdateMessage>;
+    deferUpdate: () => APIInteractionResponseDeferredMessageUpdate;
+    showModal: (data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
+}
+export declare const RadioInteraction: {};
+/**
+ * Checkbox interaction with helper methods.
+ */
+export interface CheckboxInteraction extends Omit<APIMessageComponentInteraction, "data"> {
+    data: APIMessageStringSelectInteractionData;
+    values: string[];
+    getStringValues: () => string[];
+    getResponse: () => APIInteractionResponse | null;
+    reply: (data: InteractionMessageData) => Promise<APIInteractionResponseChannelMessageWithSource>;
+    deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
+    update: (data?: InteractionMessageData) => Promise<APIInteractionResponseUpdateMessage>;
+    deferUpdate: () => APIInteractionResponseDeferredMessageUpdate;
+    showModal: (data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
+}
+export declare const CheckboxInteraction: {};
 /**
  * Represents a component interaction augmented with helper response methods.
  *

package/dist/utils/MessageComponentInteraction.js

@@ -8,6 +8,8 @@ export const RoleSelectInteraction = {};
 export const UserSelectInteraction = {};
 export const ChannelSelectInteraction = {};
 export const MentionableSelectInteraction = {};
+export const RadioInteraction = {};
+export const CheckboxInteraction = {};
 export const MessageComponentInteraction = {};
 /**
  * Wraps a raw component interaction with helper methods mirroring Discord's expected responses.

package/dist/utils/ModalSubmitInteraction.js

@@ -183,9 +183,12 @@ export function createModalSubmitInteraction(interaction, helpers) {
     const getChannel = (customId) => getChannels(customId)[0];
     const getAttachment = (customId) => {
         const value = getComponentValue(customId);
-        if (!value || Array.isArray(value))
+        if (!value)
             return undefined;
-        return interaction.data.resolved?.attachments?.[value];
+        const attachmentId = Array.isArray(value) ? value[0] : value;
+        if (!attachmentId)
+            return undefined;
+        return interaction.data.resolved?.attachments?.[attachmentId];
     };
     return Object.assign(interaction, {
         reply,

package/dist/utils/interactionMessageHelpers.d.ts

@@ -1,11 +1,12 @@
 import type { APIInteractionResponseCallbackData, MessageFlags } from "discord-api-types/v10";
-import type { APIActionRowComponent, APIComponentInMessageActionRow, APIContainerComponent } from "discord-api-types/v10";
+import type { APIContainerComponent } from "discord-api-types/v10";
 import type { JSONEncodable } from "../builders/shared.js";
 import { InteractionFlags } from "../types/InteractionFlags.js";
+import type { MessageMiniActionRow } from "../types/ComponentTypes.js";
 /** Union of helper flag enums and raw Discord message flags. */
 export type MessageFlagLike = MessageFlags | InteractionFlags;
 /** Top-level components allowed in messages (ActionRows or Containers) */
-export type TopLevelComponent = APIActionRowComponent<APIComponentInMessageActionRow> | APIContainerComponent;
+export type TopLevelComponent = MessageMiniActionRow | APIContainerComponent;
 /** Message payload accepted by helper reply/edit functions. */
 export type InteractionMessageData = {
     content?: string;

package/dist/utils/interactionMessageHelpers.js

@@ -10,6 +10,8 @@ const COMPONENTS_V2_TYPES = new Set([
     ComponentType.Thumbnail,
     18, // Label
     19, // FileUpload
+    2001, // Radio
+    2002, // Checkbox
 ]);
 /**
  * Normalises helper flag enums into the raw Discord `MessageFlags` bitfield.

package/package.json

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