@helyx/bot 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.3 - 2026-07-23
+
+- Acknowledge slow interactions safely, edit deferred responses, support
+  module-owned public message updates and log bounded interaction identifiers
+  when handling fails.
+
 ## 0.1.2 - 2026-07-23
 
 - Identify the included Helyx Source Available Licence as `HSAL 1.0` and align public core dependencies.

package/dist/interactions.d.ts

@@ -19,6 +19,7 @@ export declare function sendToChannel(client: Client, channelId: string, respons
     messageId: string;
 }>;
 export declare function deleteChannelMessage(client: Client, channelId: string, messageId: string): Promise<void>;
+export declare function editChannelMessage(client: Client, channelId: string, messageId: string, response: MessageResponse): Promise<void>;
 export declare function normalizeDiscordPermission(permission: string): string;
 export declare function toReplyOptions(response: MessageResponse): InteractionReplyOptions;
 export declare function toUpdateOptions(response: MessageResponse): InteractionUpdateOptions;

package/dist/interactions.js

@@ -102,9 +102,17 @@ export function installInteractions(client, modules, registration, logger, servi
             }
             else if (interaction.isButton()) {
                 const button = buttons.get(interaction.customId);
+                const context = button
+                    ? createContext(interaction, services)
+                    : undefined;
+                if (context &&
+                    button?.contribution.acknowledgement === "deferred-ephemeral") {
+                    await context.deferReply?.(true);
+                }
                 if (button &&
+                    context &&
                     (await authorizeComponent(interaction, button.moduleId, services))) {
-                    await button.contribution.execute(createContext(interaction, services));
+                    await button.contribution.execute(context);
                 }
             }
             else if (interaction.isModalSubmit()) {
@@ -125,7 +133,11 @@ export function installInteractions(client, modules, registration, logger, servi
             }
         }
         catch (error) {
-            logger.error({ event: "interaction.failed", error: safeError(error) }, "Module interaction failed");
+            logger.error({
+                event: "interaction.failed",
+                ...interactionLogContext(interaction),
+                error: safeError(error),
+            }, "Module interaction failed");
             await sendFailure(interaction);
         }
     }
@@ -241,7 +253,14 @@ function createContext(interaction, services) {
         ...(interaction.channelId ? { channelId: interaction.channelId } : {}),
         ...(interaction.isButton() ? { messageId: interaction.message.id } : {}),
         services,
-        reply: async (response) => interaction.reply(toReplyOptions(response)).then(() => undefined),
+        deferReply: async (ephemeral = false) => {
+            if (interaction.deferred || interaction.replied)
+                return;
+            await interaction.deferReply({
+                ...(ephemeral ? { flags: MessageFlags.Ephemeral } : {}),
+            });
+        },
+        reply: (response) => replyToInteraction(interaction, response),
         ...(interaction.isMessageComponent()
             ? {
                 updateResponse: async (response) => interaction.update(toUpdateOptions(response)).then(() => undefined),
@@ -250,6 +269,7 @@ function createContext(interaction, services) {
         showModal: async (modal) => interaction.showModal(toModal(modal)).then(() => undefined),
         sendToChannel: (channelId, response) => sendToChannel(interaction.client, channelId, response),
         deleteChannelMessage: (channelId, messageId) => deleteChannelMessage(interaction.client, channelId, messageId),
+        editChannelMessage: (channelId, messageId, response) => editChannelMessage(interaction.client, channelId, messageId, response),
         addChannelMessageReaction: (channelId, messageId, emojiIdentifier) => addChannelMessageReaction(interaction.client, channelId, messageId, emojiIdentifier),
     };
 }
@@ -292,7 +312,14 @@ function createModalContext(interaction, services) {
         ...(interaction.guildId ? { serverId: interaction.guildId } : {}),
         ...(interaction.channelId ? { channelId: interaction.channelId } : {}),
         services,
-        reply: async (response) => interaction.reply(toReplyOptions(response)).then(() => undefined),
+        deferReply: async (ephemeral = false) => {
+            if (interaction.deferred || interaction.replied)
+                return;
+            await interaction.deferReply({
+                ...(ephemeral ? { flags: MessageFlags.Ephemeral } : {}),
+            });
+        },
+        reply: (response) => replyToInteraction(interaction, response),
         ...(updateResponse ? { updateResponse } : {}),
         getField: (customId) => interaction.fields.getTextInputValue(customId),
         getStringSelectValues: (customId) => interaction.fields.getStringSelectValues(customId),
@@ -315,6 +342,7 @@ function createModalContext(interaction, services) {
         ],
         sendToChannel: (channelId, response) => sendToChannel(interaction.client, channelId, response),
         deleteChannelMessage: (channelId, messageId) => deleteChannelMessage(interaction.client, channelId, messageId),
+        editChannelMessage: (channelId, messageId, response) => editChannelMessage(interaction.client, channelId, messageId, response),
         addChannelMessageReaction: (channelId, messageId, emojiIdentifier) => addChannelMessageReaction(interaction.client, channelId, messageId, emojiIdentifier),
     };
 }
@@ -339,6 +367,21 @@ export async function deleteChannelMessage(client, channelId, messageId) {
     }
     await channel.messages.delete(messageId);
 }
+export async function editChannelMessage(client, channelId, messageId, response) {
+    const channel = await client.channels.fetch(channelId);
+    if (!channel?.isTextBased()) {
+        throw new Error("Configured channel cannot contain messages");
+    }
+    const message = await channel.messages.fetch(messageId);
+    await message.edit(toUpdateOptions(response));
+}
+async function replyToInteraction(interaction, response) {
+    if (interaction.deferred || interaction.replied) {
+        await interaction.editReply(toUpdateOptions(response));
+        return;
+    }
+    await interaction.reply(toReplyOptions(response));
+}
 async function addChannelMessageReaction(client, channelId, messageId, emojiIdentifier) {
     const channel = await client.channels.fetch(channelId);
     if (!channel?.isTextBased()) {
@@ -354,12 +397,16 @@ async function authorizeComponent(interaction, moduleId, services) {
     if (await installations.isModuleEnabled(interaction.guildId, moduleId)) {
         return true;
     }
-    await interaction.reply({
-        content: "This module is disabled in this server. Ask a server administrator to enable it with `/helyx` or in the Helyx dashboard.",
-        flags: MessageFlags.Ephemeral,
-    });
+    await replyEphemeralText(interaction, "This module is disabled in this server. Ask a server administrator to enable it with `/helyx` or in the Helyx dashboard.");
     return false;
 }
+async function replyEphemeralText(interaction, content) {
+    if (interaction.deferred || interaction.replied) {
+        await interaction.editReply({ content });
+        return;
+    }
+    await interaction.reply({ content, flags: MessageFlags.Ephemeral });
+}
 async function authorizeCommand(interaction, moduleId, commandId, rateLimit, services) {
     if (!interaction.guildId)
         return true;
@@ -650,17 +697,41 @@ export function toModal(definition) {
     return modal;
 }
 async function sendFailure(interaction) {
-    if (!interaction.isRepliable() || interaction.replied || interaction.deferred)
+    if (!interaction.isRepliable())
+        return;
+    const message = "Something went wrong while handling that interaction.";
+    if (interaction.replied || interaction.deferred) {
+        await interaction.editReply({ content: message }).catch(() => undefined);
         return;
+    }
     await interaction
-        .reply({
-        content: "Something went wrong while handling that interaction.",
-        flags: MessageFlags.Ephemeral,
-    })
+        .reply({ content: message, flags: MessageFlags.Ephemeral })
         .catch(() => undefined);
 }
 function safeError(error) {
     const value = error instanceof Error ? error : new Error(String(error));
-    return { name: value.name, message: value.message };
+    return {
+        name: value.name,
+        message: value.message,
+        ...("code" in value &&
+            (typeof value.code === "string" || typeof value.code === "number")
+            ? { code: value.code }
+            : {}),
+    };
+}
+function interactionLogContext(interaction) {
+    return {
+        interactionId: interaction.id,
+        interactionType: interaction.type,
+        ...(interaction.guildId ? { guildId: interaction.guildId } : {}),
+        ...(interaction.isChatInputCommand()
+            ? {
+                commandName: interaction.commandName,
+                subcommandName: interaction.options.getSubcommand(false) ?? undefined,
+            }
+            : "customId" in interaction && typeof interaction.customId === "string"
+                ? { customId: interaction.customId }
+                : {}),
+    };
 }
 //# sourceMappingURL=interactions.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/bot",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Production Discord runtime for the modular Helyx platform.",
   "keywords": [
     "helyx",
@@ -49,12 +49,12 @@
   },
   "dependencies": {
     "@helyx/config": "0.1.2",
-    "@helyx/core": "0.1.1",
+    "@helyx/core": "0.1.2",
     "@helyx/database": "0.1.1",
-    "@helyx/framework": "0.1.1",
+    "@helyx/framework": "0.1.2",
     "@helyx/module-manifest": "0.1.1",
-    "@helyx/platform": "0.1.1",
-    "@helyx/sdk": "0.2.1",
+    "@helyx/platform": "0.1.2",
+    "@helyx/sdk": "0.2.2",
     "discord.js": "14.27.0",
     "fastify": "5.10.0",
     "pino": "10.3.1",