@minesa-org/mini-interaction 0.3.13 → 0.4.0

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

@@ -29,3 +29,14 @@ 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 { 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 { ValidationError } from "./types/validation.js";

package/dist/index.js

@@ -20,3 +20,11 @@ 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 { LegacyMiniInteractionAdapter } from "./compat/LegacyMiniInteractionAdapter.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/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/package.json

@@ -1,55 +1,57 @@
 {
-	"name": "@minesa-org/mini-interaction",
-	"version": "0.3.13",
-	"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.0",
+  "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"
+  }
 }