@minesa-org/mini-interaction 0.3.14 → 0.4.1

package/dist/core/interactions/InteractionContext.d.ts

@@ -0,0 +1,25 @@
+import type { APIInteractionResponse, APIInteractionResponseCallbackData, APIModalInteractionResponseCallbackData } from 'discord-api-types/v10';
+import type { ParsedInteraction } from '../../types/discord.js';
+import { DiscordRestClient } from '../http/DiscordRestClient.js';
+export type InteractionContextOptions = {
+    interaction: ParsedInteraction;
+    rest: DiscordRestClient;
+    autoAck?: {
+        enabled: boolean;
+        delayMs?: number;
+    };
+    onDiagnostic?: (message: string) => void;
+};
+export declare class InteractionContext {
+    private readonly options;
+    private responded;
+    private autoAckTimer?;
+    constructor(options: InteractionContextOptions);
+    reply(data: APIInteractionResponseCallbackData): APIInteractionResponse;
+    deferReply(ephemeral?: boolean): APIInteractionResponse;
+    showModal(data: APIModalInteractionResponseCallbackData): APIInteractionResponse;
+    editReply(body: unknown): Promise<unknown>;
+    followUp(body: unknown): Promise<unknown>;
+    get hasResponded(): boolean;
+    private clearAutoAck;
+}

package/dist/core/interactions/InteractionContext.js

@@ -0,0 +1,44 @@
+export class InteractionContext {
+    options;
+    responded = false;
+    autoAckTimer;
+    constructor(options) {
+        this.options = options;
+        if (options.autoAck?.enabled) {
+            const delay = options.autoAck.delayMs ?? 2000;
+            this.autoAckTimer = setTimeout(() => {
+                if (!this.responded) {
+                    options.onDiagnostic?.(`[InteractionContext] auto-ack triggered for ${this.options.interaction.id}`);
+                }
+            }, delay);
+        }
+    }
+    reply(data) {
+        this.responded = true;
+        this.clearAutoAck();
+        return { type: 4, data };
+    }
+    deferReply(ephemeral = false) {
+        this.responded = true;
+        this.clearAutoAck();
+        return { type: 5, data: ephemeral ? { flags: 64 } : undefined };
+    }
+    showModal(data) {
+        this.responded = true;
+        this.clearAutoAck();
+        return { type: 9, data };
+    }
+    editReply(body) {
+        return this.options.rest.editOriginal(this.options.interaction.token, body);
+    }
+    followUp(body) {
+        return this.options.rest.createFollowup(this.options.interaction.token, body);
+    }
+    get hasResponded() {
+        return this.responded;
+    }
+    clearAutoAck() {
+        if (this.autoAckTimer)
+            clearTimeout(this.autoAckTimer);
+    }
+}

package/dist/core/interactions/InteractionVerifier.d.ts

@@ -0,0 +1,8 @@
+import type { APIInteraction } from 'discord-api-types/v10';
+export type VerifyInteractionRequest = {
+    body: string | Uint8Array;
+    signature: string;
+    timestamp: string;
+    publicKey: string;
+};
+export declare function verifyAndParseInteraction(request: VerifyInteractionRequest): Promise<APIInteraction>;

package/dist/core/interactions/InteractionVerifier.js

@@ -0,0 +1,9 @@
+import { verifyKey } from 'discord-interactions';
+export async function verifyAndParseInteraction(request) {
+    const valid = await verifyKey(request.body, request.signature, request.timestamp, request.publicKey);
+    if (!valid) {
+        throw new Error('[InteractionVerifier] invalid interaction signature');
+    }
+    const bodyText = typeof request.body === 'string' ? request.body : Buffer.from(request.body).toString('utf8');
+    return JSON.parse(bodyText);
+}

package/dist/core/interactions/__tests__/interaction-context.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/interactions/__tests__/interaction-context.test.js

@@ -0,0 +1,38 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { InteractionContext } from '../InteractionContext.js';
+import { DiscordRestClient } from '../../http/DiscordRestClient.js';
+function createRest() {
+    const calls = [];
+    const fetchImpl = (async (input) => {
+        calls.push(String(input));
+        return new Response(JSON.stringify({ ok: true }), { status: 200 });
+    });
+    return {
+        calls,
+        rest: new DiscordRestClient({ token: 'x', applicationId: 'app', fetchImplementation: fetchImpl }),
+    };
+}
+const interaction = { id: '1', application_id: 'a', type: 2, token: 'tok', version: 1 };
+test('reply/defer lifecycle', () => {
+    const { rest } = createRest();
+    const ctx = new InteractionContext({ interaction, rest });
+    const response = ctx.reply({ content: 'ok' });
+    assert.equal(response.type, 4);
+    assert.equal(ctx.hasResponded, true);
+});
+test('editReply and followUp call webhook endpoints', async () => {
+    const { rest, calls } = createRest();
+    const ctx = new InteractionContext({ interaction, rest });
+    await ctx.editReply({ content: 'edit' });
+    await ctx.followUp({ content: 'next' });
+    assert.equal(calls.length, 2);
+    assert.match(calls[0], /messages\/\@original/);
+});
+test('auto-ack diagnostics callback fires for slow handler', async () => {
+    let message = '';
+    const { rest } = createRest();
+    new InteractionContext({ interaction, rest, autoAck: { enabled: true, delayMs: 5 }, onDiagnostic: (m) => (message = m) });
+    await new Promise((resolve) => setTimeout(resolve, 20));
+    assert.match(message, /auto-ack triggered/);
+});

package/dist/index.d.ts

@@ -1,20 +1,15 @@
-/** 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 { 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";
@@ -29,3 +24,12 @@ export { MiniDatabase } from "./database/MiniDatabase.js";
 export { generateOAuthUrl, getOAuthTokens, refreshAccessToken, getDiscordUser, ensureValidToken, } from "./oauth/DiscordOAuth.js";
 export type { OAuthConfig, OAuthTokens, DiscordUser, } from "./oauth/DiscordOAuth.js";
 export { OAuthTokenStorage } from "./oauth/OAuthTokenStorage.js";
+export { DiscordRestClient } from "./core/http/DiscordRestClient.js";
+export type { DiscordRestClientOptions } from "./core/http/DiscordRestClient.js";
+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 type { APIRadioComponent, APIRadioOption } from "./types/radio.js";
+export { RADIO_COMPONENT_TYPE } from "./types/radio.js";
+export { ValidationError } from "./types/validation.js";

package/dist/index.js

@@ -1,5 +1,3 @@
-/** 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";
@@ -9,7 +7,7 @@ export { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction
 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";
@@ -20,3 +18,10 @@ export { MiniDatabaseBuilder } from "./database/MiniDatabaseBuilder.js";
 export { MiniDatabase } from "./database/MiniDatabase.js";
 export { generateOAuthUrl, getOAuthTokens, refreshAccessToken, getDiscordUser, ensureValidToken, } from "./oauth/DiscordOAuth.js";
 export { OAuthTokenStorage } from "./oauth/OAuthTokenStorage.js";
+// New v10 core modules
+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 { RADIO_COMPONENT_TYPE } from "./types/radio.js";
+export { ValidationError } from "./types/validation.js";

package/dist/router/InteractionRouter.d.ts

@@ -0,0 +1,12 @@
+import type { APIInteraction, APIInteractionResponse, APIMessageComponentInteraction, APIModalSubmitInteraction, APIChatInputApplicationCommandInteraction } from 'discord-api-types/v10';
+import { InteractionContext } from '../core/interactions/InteractionContext.js';
+export type RouterHandler<T extends APIInteraction> = (interaction: T, ctx: InteractionContext) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+export declare class InteractionRouter {
+    private readonly commandHandlers;
+    private readonly componentHandlers;
+    private readonly modalHandlers;
+    onCommand(name: string, handler: RouterHandler<APIChatInputApplicationCommandInteraction>): this;
+    onComponent(customId: string, handler: RouterHandler<APIMessageComponentInteraction>): this;
+    onModal(customId: string, handler: RouterHandler<APIModalSubmitInteraction>): this;
+    dispatch(interaction: APIInteraction, ctx: InteractionContext): Promise<APIInteractionResponse | void>;
+}

package/dist/router/InteractionRouter.js

@@ -0,0 +1,33 @@
+import { InteractionType } from 'discord-api-types/v10';
+export class InteractionRouter {
+    commandHandlers = new Map();
+    componentHandlers = new Map();
+    modalHandlers = new Map();
+    onCommand(name, handler) {
+        this.commandHandlers.set(name, handler);
+        return this;
+    }
+    onComponent(customId, handler) {
+        this.componentHandlers.set(customId, handler);
+        return this;
+    }
+    onModal(customId, handler) {
+        this.modalHandlers.set(customId, handler);
+        return this;
+    }
+    async dispatch(interaction, ctx) {
+        if (interaction.type === InteractionType.ApplicationCommand) {
+            const i = interaction;
+            return this.commandHandlers.get(i.data.name)?.(i, ctx);
+        }
+        if (interaction.type === InteractionType.MessageComponent) {
+            const i = interaction;
+            return this.componentHandlers.get(i.data.custom_id)?.(i, ctx);
+        }
+        if (interaction.type === InteractionType.ModalSubmit) {
+            const i = interaction;
+            return this.modalHandlers.get(i.data.custom_id)?.(i, ctx);
+        }
+        return undefined;
+    }
+}

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/discord.d.ts

@@ -0,0 +1,11 @@
+import type { APIInteraction, APIInteractionResponse, APIModalInteractionResponseCallbackData, APIMessageComponent, InteractionResponseType } from 'discord-api-types/v10';
+export type DiscordApiVersion = '10';
+export type JsonRecord = Record<string, unknown>;
+export type InteractionResponseLike = APIInteractionResponse | {
+    type: InteractionResponseType;
+    data?: JsonRecord;
+};
+export type ModalPayload = APIModalInteractionResponseCallbackData;
+export type ComponentPayload = APIMessageComponent;
+export type ParsedInteraction = APIInteraction;
+export type Snowflake = string;

package/dist/types/discord.js

@@ -0,0 +1 @@
+export {};

package/dist/types/radio.d.ts

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

package/dist/types/radio.js

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

package/dist/types/validation.d.ts

@@ -0,0 +1,8 @@
+export declare class ValidationError extends Error {
+    readonly builder: string;
+    readonly field: string;
+    constructor(builder: string, field: string, message: string);
+}
+export declare function assertStringLength(builder: string, field: string, value: string, min: number, max: number): void;
+export declare function assertRange(builder: string, field: string, value: number, min: number, max: number): void;
+export declare function assertDefined<T>(builder: string, field: string, value: T | null | undefined): T;

package/dist/types/validation.js

@@ -0,0 +1,26 @@
+export class ValidationError extends Error {
+    builder;
+    field;
+    constructor(builder, field, message) {
+        super(`[${builder}] ${field}: ${message}`);
+        this.builder = builder;
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+export function assertStringLength(builder, field, value, min, max) {
+    if (value.length < min || value.length > max) {
+        throw new ValidationError(builder, field, `expected length between ${min} and ${max}, got ${value.length}`);
+    }
+}
+export function assertRange(builder, field, value, min, max) {
+    if (!Number.isInteger(value) || value < min || value > max) {
+        throw new ValidationError(builder, field, `expected integer between ${min} and ${max}, got ${value}`);
+    }
+}
+export function assertDefined(builder, field, value) {
+    if (value === undefined || value === null) {
+        throw new ValidationError(builder, field, 'is required');
+    }
+    return value;
+}

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/package.json

@@ -1,55 +1,57 @@
 {
-	"name": "@minesa-org/mini-interaction",
-	"version": "0.3.14",
-	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
-	"type": "module",
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"files": [
-		"dist",
-		"README.md",
-		"LICENSE"
-	],
-	"scripts": {
-		"build": "tsc --project tsconfig.json",
-		"postbuild": "tsx scripts/postbuild.ts",
-		"typecheck": "tsc --noEmit",
-		"prepare": "npm run build",
-		"patch": "npm version patch",
-		"publish:npm": "npm publish",
-		"publish:gh": "npm publish --registry=https://npm.pkg.github.com"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/minesa-org/mini-interaction.git"
-	},
-	"keywords": [
-		"discord",
-		"interactions",
-		"http-interaction",
-		"vercel",
-		"typescript"
-	],
-	"author": "Minesa",
-	"license": "MIT",
-	"bugs": {
-		"url": "https://github.com/minesa-org/mini-interaction/issues"
-	},
-	"homepage": "https://github.com/minesa-org/mini-interaction#readme",
-	"dependencies": {
-		"@vercel/functions": "^1.6.0",
-		"discord-api-types": "^0.38.32",
-		"discord-interactions": "^4.4.0",
-		"dotenv": "^17.2.3",
-		"mongodb": "^7.0.0"
-	},
-	"devDependencies": {
-		"@types/node": "^24.10.0",
-		"ts-node": "^10.9.2",
-		"tsx": "^4.20.6",
-		"typescript": "^5.9.3"
-	}
+  "name": "@minesa-org/mini-interaction",
+  "version": "0.4.1",
+  "description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "postbuild": "tsx scripts/postbuild.ts",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "patch": "npm version patch",
+    "publish:npm": "npm publish",
+    "publish:gh": "npm publish --registry=https://npm.pkg.github.com",
+    "test": "tsx --test src/**/*.test.ts",
+    "lint:type": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/minesa-org/mini-interaction.git"
+  },
+  "keywords": [
+    "discord",
+    "interactions",
+    "http-interaction",
+    "vercel",
+    "typescript"
+  ],
+  "author": "Minesa",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/minesa-org/mini-interaction/issues"
+  },
+  "homepage": "https://github.com/minesa-org/mini-interaction#readme",
+  "dependencies": {
+    "@vercel/functions": "^1.6.0",
+    "discord-api-types": "^0.38.32",
+    "discord-interactions": "^4.4.0",
+    "dotenv": "^17.2.3",
+    "mongodb": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
 }