@minesa-org/mini-interaction 0.0.1

package/dist/utils/MessageComponentInteraction.js

@@ -0,0 +1,60 @@
+import { InteractionResponseType, } from "discord-api-types/v10";
+import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
+/**
+ * Wraps a raw component interaction with helper methods mirroring Discord's expected responses.
+ *
+ * @param interaction - The raw interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export function createMessageComponentInteraction(interaction) {
+    let capturedResponse = null;
+    const captureResponse = (response) => {
+        capturedResponse = response;
+        return response;
+    };
+    const reply = (data) => {
+        const normalisedData = normaliseInteractionMessageData(data);
+        if (!normalisedData) {
+            throw new Error("[MiniInteraction] Component replies require response data to be provided.");
+        }
+        return captureResponse({
+            type: InteractionResponseType.ChannelMessageWithSource,
+            data: normalisedData,
+        });
+    };
+    const deferReply = (options) => {
+        const flags = normaliseMessageFlags(options?.flags);
+        const response = flags !== undefined
+            ? {
+                type: InteractionResponseType.DeferredChannelMessageWithSource,
+                data: { flags },
+            }
+            : {
+                type: InteractionResponseType.DeferredChannelMessageWithSource,
+            };
+        return captureResponse(response);
+    };
+    const update = (data) => {
+        const normalisedData = normaliseInteractionMessageData(data);
+        const response = normalisedData
+            ? {
+                type: InteractionResponseType.UpdateMessage,
+                data: normalisedData,
+            }
+            : {
+                type: InteractionResponseType.UpdateMessage,
+            };
+        return captureResponse(response);
+    };
+    const deferUpdate = () => captureResponse({
+        type: InteractionResponseType.DeferredMessageUpdate,
+    });
+    const getResponse = () => capturedResponse;
+    return Object.assign(interaction, {
+        reply,
+        deferReply,
+        update,
+        deferUpdate,
+        getResponse,
+    });
+}

package/dist/utils/constants.d.ts

@@ -0,0 +1,16 @@
+import "dotenv/config";
+/** Discord application's public key used for request signature verification. */
+declare const DISCORD_APP_PUBLIC_KEY: string;
+/** Discord application identifier used for REST requests. */
+declare const DISCORD_APPLICATION_ID: string;
+/** Bot token used when registering commands against Discord's API. */
+declare const DISCORD_BOT_TOKEN: string;
+/** Guild identifier used for guild-scoped command registration. */
+declare const DISCORD_GUILD_ID: string;
+/** Whether commands should be registered globally instead of per guild. */
+declare const DISCORD_GLOBAL: boolean;
+/** Local development port for the example interaction server. */
+declare const DISCORD_APP_PORT: string;
+/** Discord REST API base URL used for all network requests. */
+declare const DISCORD_BASE_URL = "https://discord.com/api/v10";
+export { DISCORD_APPLICATION_ID, DISCORD_APP_PORT, DISCORD_APP_PUBLIC_KEY, DISCORD_BASE_URL, DISCORD_BOT_TOKEN, DISCORD_GLOBAL, DISCORD_GUILD_ID, };

package/dist/utils/constants.js

@@ -0,0 +1,16 @@
+import "dotenv/config";
+/** Discord application's public key used for request signature verification. */
+const DISCORD_APP_PUBLIC_KEY = process.env.DISCORD_APP_PUBLIC_KEY;
+/** Discord application identifier used for REST requests. */
+const DISCORD_APPLICATION_ID = process.env.DISCORD_APPLICATION_ID;
+/** Bot token used when registering commands against Discord's API. */
+const DISCORD_BOT_TOKEN = process.env.DISCORD_BOT_TOKEN;
+/** Guild identifier used for guild-scoped command registration. */
+const DISCORD_GUILD_ID = process.env.DISCORD_GUILD_ID;
+/** Whether commands should be registered globally instead of per guild. */
+const DISCORD_GLOBAL = (process.env.DISCORD_GLOBAL ?? "false").toLowerCase() === "true";
+/** Local development port for the example interaction server. */
+const DISCORD_APP_PORT = process.env.DISCORD_PORT;
+/** Discord REST API base URL used for all network requests. */
+const DISCORD_BASE_URL = "https://discord.com/api/v10";
+export { DISCORD_APPLICATION_ID, DISCORD_APP_PORT, DISCORD_APP_PUBLIC_KEY, DISCORD_BASE_URL, DISCORD_BOT_TOKEN, DISCORD_GLOBAL, DISCORD_GUILD_ID, };

package/dist/utils/interactionMessageHelpers.d.ts

@@ -0,0 +1,30 @@
+import type { APIInteractionResponseCallbackData, MessageFlags } from "discord-api-types/v10";
+import type { InteractionFollowUpFlags, InteractionReplyFlags } from "../types/InteractionFlags.js";
+/** Union of helper flag enums and raw Discord message flags. */
+export type MessageFlagLike = MessageFlags | InteractionReplyFlags | InteractionFollowUpFlags;
+/** Message payload accepted by helper reply/edit functions. */
+export type InteractionMessageData = Omit<APIInteractionResponseCallbackData, "flags"> & {
+    flags?: MessageFlagLike;
+};
+/** Deferred response payload recognised by helper methods. */
+export type DeferredResponseData = {
+    flags: MessageFlagLike;
+};
+/** Options accepted when deferring a reply. */
+export type DeferReplyOptions = {
+    flags?: MessageFlagLike;
+};
+/**
+ * Normalises helper flag enums into the raw Discord `MessageFlags` bitfield.
+ *
+ * @param flags - A flag from helper enums or raw Discord flags.
+ * @returns The value coerced to a `MessageFlags` compatible bitfield.
+ */
+export declare function normaliseMessageFlags(flags: MessageFlagLike | undefined): MessageFlags | undefined;
+/**
+ * Ensures helper message payloads include correctly normalised message flags.
+ *
+ * @param data - The helper-supplied response payload.
+ * @returns A payload safe to send to Discord's API.
+ */
+export declare function normaliseInteractionMessageData(data?: InteractionMessageData): APIInteractionResponseCallbackData | undefined;

package/dist/utils/interactionMessageHelpers.js

@@ -0,0 +1,32 @@
+/**
+ * Normalises helper flag enums into the raw Discord `MessageFlags` bitfield.
+ *
+ * @param flags - A flag from helper enums or raw Discord flags.
+ * @returns The value coerced to a `MessageFlags` compatible bitfield.
+ */
+export function normaliseMessageFlags(flags) {
+    return flags === undefined ? undefined : flags;
+}
+/**
+ * Ensures helper message payloads include correctly normalised message flags.
+ *
+ * @param data - The helper-supplied response payload.
+ * @returns A payload safe to send to Discord's API.
+ */
+export function normaliseInteractionMessageData(data) {
+    if (!data) {
+        return undefined;
+    }
+    if (data.flags === undefined) {
+        return data;
+    }
+    const { flags, ...rest } = data;
+    const normalisedFlags = normaliseMessageFlags(flags);
+    if (normalisedFlags === flags) {
+        return data;
+    }
+    return {
+        ...rest,
+        flags: normalisedFlags,
+    };
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@minesa-org/mini-interaction",
+	"version": "0.0.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",
+		"typecheck": "tsc --noEmit",
+		"prepare": "npm run build",
+		"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": {
+		"discord-api-types": "^0.38.32",
+		"discord-interactions": "^4.4.0",
+		"dotenv": "^17.2.3"
+	},
+	"devDependencies": {
+		"@types/node": "^24.10.0",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.9.3"
+	}
+}