The source code of the helper bot for the SupportMail support server.

If you want to use this code, you can do so by forking this repository and modifying the code to fit your needs.

• Node.js (version 20 or higher)
• pnpm package manager
• MongoDB database
• Discord Bot Token from the Discord Developer Portal

git clone https://github.com/your-username/sm-helper.git
cd sm-helper

pnpm install

Create environment files in the root directory, based on the .env.example file:

• .env.dev: For development environment variables
• .env.production: For production environment variables

• Invite your bot to your Discord server with the necessary permissions
• Set up the required channels and roles according to your server structure
• Customize configuration values in the source code as needed

Development mode:

pnpm dev

Production mode:

pnpm start

Building only:

pnpm build

The bot requires the following Discord permissions:

• Send Messages
• Use Slash Commands
• Manage Messages
• Manage Threads
• Add Reactions
• Read Message History
• Embed Links
• Attach Files
• Mention Everyone
• Use External Emojis

The bot uses MongoDB to store data. Make sure your MongoDB instance is running and accessible via the MONGODB_URI in your environment file. The bot will automatically create the necessary collections and indexes on startup.

• Automatic Post Tracking: Creates database entries for new support posts in the forum
• Auto-tagging: Automatically applies "unanswered" tags to new posts and switches to "unsolved" when responses are received
• Post Lifecycle Management: Tracks post activity, sends reminders after 24 hours of inactivity, and auto-closes posts after another 24 hours
• Question Closure Suggestions: Automatically suggests using the solve command when users express gratitude or indicate their question is answered

• Solve/Unsolve Posts: Mark support questions as solved or reopen them
• Developer Review: Flag posts for developer attention with optional priority levels
• Priority Setting: Set priority levels (low, medium, high, urgent) for support posts
• Helpful User Recognition: Select users who helped solve problems for commendation tracking

• Interactive Request Creation: Modal-based feature request submission with categorization
• Status Management: Track and update request status (pending, accepted, denied, duplicate, implemented)
• Thread Management: Automatic thread creation and status-based naming
• Rate Limiting: One request per hour per user to prevent spam

• Create Incidents: Create new incidents with status tracking and optional BetterStack integration
• Update Incidents: Add status updates to existing incidents
• Multi-platform Sync: Optional integration with BetterStack for status page synchronization
• Automated Messaging: Formatted incident reports with duration tracking and affected services

• Stats Tracking: Track user contributions including bugs reported, support posts created, and commendations received
• Bug Hunter System: Automatic role assignment for users who report multiple bugs (threshold: 5 bugs)
• Vote Tracking: Bot voting system with automatic role management and cleanup

• Invite Generation: Advanced invite creation with customizable parameters (duration, uses, temporary access)
• Auto-publishing: Automatic message crossposting in designated announcement channels
• Sticky Message Management: Automated sticky message updates for feature request channels
• Flag Emoji Removal: Automatic removal of flag emojis from reactions in specified channels

• Support Post Lifecycle: Automated reminders and post closure for inactive support threads
• Vote Synchronization: Regular cleanup of expired voting roles and database entries
• Activity Tracking: Continuous monitoring of user activity and post status updates

• Ping Command: Basic bot responsiveness testing with latency metrics
• Auto-join Threads: Bot automatically joins new support threads for monitoring
• Message Pinning: Automatically pins the starter message in new support posts
• Username Tracking: Maintains up-to-date user information in the database

1. Anyone can copy, modify and distribute this code.
2. You have to include the license and copyright notice with each and every distribution.
3. You can use this software privately.
4. You can use this software for commercial purposes.
5. If you dare build your business solely from this code, you risk open-sourcing the whole code base.
6. If you modify it, you have to indicate changes made to the code.
7. Any modifications of this code base MUST be distributed with the same license, GPLv3.
8. This software is provided without warranty.
9. The software author or license can not be held liable for any damages inflicted by the software.

More information on about the LICENSE can be found here

• Add a way to input ends_at on /incident create field for maintenance