@minesa-org/mini-interaction 0.4.1 → 0.4.3

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

@@ -4,8 +4,8 @@ export type { AttachmentOptionBuilder, ChannelOptionBuilder, MentionableOptionBu
 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 { InteractionCommand, SlashCommandHandler, UserCommandHandler, MessageCommandHandler, AppCommandHandler, CommandHandler, } from "./types/Commands.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";
@@ -14,7 +14,7 @@ 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";
@@ -32,4 +32,6 @@ export { verifyAndParseInteraction } from "./core/interactions/InteractionVerifi
 export { InteractionRouter } from "./router/InteractionRouter.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

@@ -3,7 +3,7 @@ export { UserCommandBuilder, MessageCommandBuilder, AppCommandBuilder, } from ".
 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";
@@ -24,4 +24,5 @@ export { InteractionContext } from "./core/interactions/InteractionContext.js";
 export { verifyAndParseInteraction } from "./core/interactions/InteractionVerifier.js";
 export { InteractionRouter } from "./router/InteractionRouter.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/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/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.1",
+  "version": "0.4.3",
   "description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
   "type": "module",
   "main": "dist/index.js",