feat: add visual reaction indicators for command status

- Add emoji reactions (⏳, ✅, ❌) to show real-time processing status of commands and file uploads.
- Add COMMAND_REACTION_ENABLED and related .env variables to customize or disable reactions.
- Enhance UX by ensuring users know their webhook is actively processing.
- Update documentation and .env.example with new logic and configuration.

Author: nextgearslab

.env.example

@@ -2,21 +2,20 @@ DISCORD_TOKEN=your_discord_bot_token_here
 
 # Shared secret sent in webhook headers for auth (you validate this in your automation tool)
 DASHCORD_SHARED_SECRET=my_super_secret_string
-DASHCORD_DEBUG=1
-
-# Prefix
-COMMAND_PREFIX=!
 
 # Timezone metadata
 TIMEZONE=America/New_York
 
+# Chat Commands
+COMMAND_PREFIX=!
 DISPLAY_UNKNOWN_COMMAND_ERROR=true
 DISPLAY_UNKNOWN_COMMAND_ERROR_SILENT_CHANNELS=123456789,987654321
 
-VERIFY_TLS=false
-DEBUG_WEBHOOK=1
-PYTHONUNBUFFERED=1
-
+# Visual reaction feedback for commands and file uploads
+COMMAND_REACTION_ENABLED=true
+COMMAND_REACTION_PENDING=⏳
+COMMAND_REACTION_SUCCESS=✅
+COMMAND_REACTION_FAIL=❌
 
 # panel behavior
 PANEL_REPOST_ON_STARTUP=true
@@ -34,4 +33,12 @@ PANEL_PERSIST_DEFAULT=true
 PANEL_PERSIST_INTERVAL_SECONDS=120
 PANEL_PERSIST_CLEANUP_OLD_ACTIVE=true
 
-HTTP_TIMEOUT_SECONDS=120
+# Webhook Connectivity & API Troubleshooting
+DASHCORD_DEBUG=false
+DEBUG_WEBHOOK=false
+VERIFY_TLS=false
+HTTP_TIMEOUT_SECONDS=120
+
+# Docker / Console Output
+# Set to 1 to ensure logs appear immediately in docker logs
+PYTHONUNBUFFERED=1

README.md

@@ -44,7 +44,8 @@ While platforms like n8n and Node-RED have native Discord nodes, they are often
 - **🎭 Dynamic Body Templating:** Inject Discord metadata (like `{{discord.user_display}}` or `{{discord.channel_id}}`) directly into the JSON payload sent to your webhook, molding the data to fit your API perfectly.
 - **🔒 Security Built-In:** Restrict specific commands to specific Discord channels or user IDs. Secures outbound requests with a custom `X-DashCord-Token` header.
 - **💬 Native Discord Replies:** Your webhook can respond with JSON containing plain text or rich Discord Embeds, and the bot will cleanly post it back to the channel.
-
+- **👁️ Visual Status Indicators:** Real-time emoji reactions (⏳, ✅, ❌) let users know exactly when a command is processing, succeeded, or failed without needing extra text replies.
+- 
 ---
 
 ## 🚀 Quick Start (Docker)
@@ -323,7 +324,11 @@ DashCord is highly customizable. You can fine-tune exactly how the bot, your web
 - `DISPLAY_UNKNOWN_COMMAND_ERROR_SILENT_CHANNELS`: A comma-separated list of channel IDs where the bot will never post an "Unknown command" error. Use this if you have other bots in the same channel so DashCord doesn't interrupt their commands (Default: empty).
 - `DASHCORD_DEBUG`: Enables verbose internal debug logging in the console (Default: `false`).
 - `ROUTES_PATH`: The file path to your routing configuration (Default: `routes.json` in the bot's root directory).
-
+- `COMMAND_REACTION_ENABLED`: Automatically add emoji reactions to user messages to show command status (pending, success, fail) (Default: `true`).
+- `COMMAND_REACTION_PENDING`: The emoji to show while a command or file upload is being processed by your webhook (Default: `⏳`).
+- `COMMAND_REACTION_SUCCESS`: The emoji to show when a command succeeds (Default: `✅`).
+- `COMMAND_REACTION_FAIL`: The emoji to show when a command or webhook fails (Default: `❌`).
+  
 #### 🌐 Webhook & API Settings
 - `DASHCORD_SHARED_SECRET`: A secret string sent as the `X-DashCord-Token` HTTP header to secure your webhooks from unauthorized requests.
 - `HTTP_TIMEOUT_SECONDS`: How long the bot waits for your webhook to respond before throwing a timeout error (Default: `20`).

bot.py

@@ -25,7 +25,7 @@ def get_env_bool(key: str, default: str = "false") -> bool:
     """Helper to parse boolean environment variables."""
     return os.getenv(key, default).strip().lower() in ("1", "true", "yes", "y", "on")
 
-DASHCORD_DEBUG = get_env_bool("DASHCORD_DEBUG", "0")
+DASHCORD_DEBUG = get_env_bool("DASHCORD_DEBUG", "false") 
 
 log = logging.getLogger("dashcord")
 log.setLevel(logging.DEBUG if DASHCORD_DEBUG else logging.INFO)
@@ -55,12 +55,21 @@ def _dbg(msg: str, *args):
 ROUTES_PATH = os.getenv("ROUTES_PATH", os.path.join(BASE_DIR, "routes.json"))
 
 VERIFY_TLS = get_env_bool("VERIFY_TLS", "true")
-DEBUG_WEBHOOK = get_env_bool("DEBUG_WEBHOOK", "0")
+DEBUG_WEBHOOK = get_env_bool("DEBUG_WEBHOOK", "false")
 DISPLAY_UNKNOWN_COMMAND_ERROR = get_env_bool("DISPLAY_UNKNOWN_COMMAND_ERROR", "true")
 
 DISPLAY_UNKNOWN_COMMAND_ERROR_SILENT_CHANNELS = set(
     cid.strip() for cid in os.getenv("DISPLAY_UNKNOWN_COMMAND_ERROR_SILENT_CHANNELS", "").split(",") if cid.strip()
 )
+
+# ----------------------------
+# REACTION OPTIONS (.env)
+# ----------------------------
+COMMAND_REACTION_ENABLED = get_env_bool("COMMAND_REACTION_ENABLED", "true")
+COMMAND_REACTION_PENDING = os.getenv("COMMAND_REACTION_PENDING", "⏳")
+COMMAND_REACTION_SUCCESS = os.getenv("COMMAND_REACTION_SUCCESS", "✅")
+COMMAND_REACTION_FAIL    = os.getenv("COMMAND_REACTION_FAIL", "❌")
+
 # ----------------------------
 # PANEL OPTIONS (.env)
 # ----------------------------
@@ -112,6 +121,22 @@ def _dbg(msg: str, *args):
 # HELPERS
 # ----------------------------
 
+async def _add_reaction_safe(message: discord.Message, emoji: str) -> None:
+    if not COMMAND_REACTION_ENABLED:
+        return
+    try:
+        await message.add_reaction(emoji)
+    except Exception as e:
+        _dbg("Could not add reaction %s to message %s: %s", emoji, message.id, e)
+
+async def _remove_reaction_safe(message: discord.Message, emoji: str) -> None:
+    if not COMMAND_REACTION_ENABLED or not bot.user:
+        return
+    try:
+        await message.remove_reaction(emoji, bot.user)
+    except Exception as e:
+        _dbg("Could not remove reaction %s from message %s: %s", emoji, message.id, e)
+
 def _message_time_utc(message: discord.Message) -> datetime:
     # created_at is UTC-aware in discord.py
     if getattr(message, "created_at", None):
@@ -181,6 +206,7 @@ async def _fanout_attachments_to_command(message: discord.Message, command: str,
         await message.reply(f"❌ No matching attachment found. Expected: {want}. Got: {got}")
         return
 
+    await _add_reaction_safe(message, COMMAND_REACTION_PENDING)
 
     ok = 0
     bad = 0
@@ -234,6 +260,12 @@ async def _fanout_attachments_to_command(message: discord.Message, command: str,
     total = len(atts)
     has_errors = (bad > 0)
 
+    await _remove_reaction_safe(message, COMMAND_REACTION_PENDING)
+    if has_errors:
+        await _add_reaction_safe(message, COMMAND_REACTION_FAIL)
+    elif ok > 0:
+        await _add_reaction_safe(message, COMMAND_REACTION_SUCCESS)
+
     # Decide whether to reply at all
     should_reply = (
         (mode == "always") or
@@ -1140,11 +1172,23 @@ async def on_message(message: discord.Message):
 
     log.info(f"⚡ User '{message.author.display_name}' triggered command '{command}' in channel {message.channel.id}")
 
+    await _add_reaction_safe(message, COMMAND_REACTION_PENDING)
+
     try:
         data = await post_to_webhook_async(command, payload)
+        
+        await _remove_reaction_safe(message, COMMAND_REACTION_PENDING)
+        if data is not None:
+            await _add_reaction_safe(message, COMMAND_REACTION_SUCCESS)
+        else:
+            await _add_reaction_safe(message, COMMAND_REACTION_FAIL)
+        # ------------------------------
+            
         await send_reply(message.channel, data)
     except Exception as e:
         log.error(f"⚠️ Exception triggering command '{command}': {e}", exc_info=True)
+        await _remove_reaction_safe(message, COMMAND_REACTION_PENDING)
+        await _add_reaction_safe(message, COMMAND_REACTION_FAIL)
         await message.reply(f"⚠️ Trigger failed: {type(e).__name__}: {e}")