Overhaul prefix commands, config wizard, and logging UX

Add prefix command execution with usage validation and response coordinator fixes, expand config wizard with DM setup flow and channel/role selectors, unify ticket feedback logging, and adopt minimal log embeds across ticket and audit events. Improve notification embeds so titles stay in the title field while mentions render in descriptions.

Author: codebymitch

.env.example

@@ -19,7 +19,11 @@ PORT_RETRY_ATTEMPTS=5
 CORS_ORIGIN=*
 
 # PostgreSQL Configuration (Primary Database)
+# Railway: use the private POSTGRES_URL / DATABASE_URL variable (includes SSL).
+# Public proxy logs showing "invalid length of startup packet" or "SSL without ALPN"
+# are usually internet scanners — not your bot.
 POSTGRES_URL=postgresql://postgres:yourpassword@localhost:5432/titanbot
+POSTGRES_SSL=
 POSTGRES_HOST=localhost
 POSTGRES_PORT=5432
 POSTGRES_DB=titanbot

index.js

@@ -1,2 +1 @@
-import './src/app.js';
-
+import './src/app.js';

package-lock.json

@@ -17,7 +17,7 @@
   "dependencies": {
     "@discordjs/rest": "^2.6.1",
     "axios": "^1.15.2",
-    "discord.js": "^14.15.3",
+    "discord.js": "^14.26.4",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
     "node-cron": "^4.2.1",
@@ -26,7 +26,6 @@
     "winston-daily-rotate-file": "^5.0.0",
     "zod": "^3.25.76"
   },
-  "devDependencies": {},
   "engines": {
     "node": ">=18.0.0"
   }

package.json

@@ -147,4 +147,4 @@ run().catch((error) => {
     error: error.message
   });
   process.exit(1);
-});
+});

scripts/backup.js

@@ -74,7 +74,6 @@ const createTables = async (client) => {
       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS user_levels (
       id SERIAL PRIMARY KEY,
       user_id VARCHAR(255) NOT NULL,
@@ -86,7 +85,6 @@ const createTables = async (client) => {
       UNIQUE(user_id, guild_id)
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS user_economy (
       id SERIAL PRIMARY KEY,
       user_id VARCHAR(255) NOT NULL,
@@ -98,7 +96,6 @@ const createTables = async (client) => {
       UNIQUE(user_id, guild_id)
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS birthdays (
       id SERIAL PRIMARY KEY,
       user_id VARCHAR(255) NOT NULL,
@@ -110,7 +107,6 @@ const createTables = async (client) => {
       UNIQUE(user_id, guild_id)
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS tickets (
       id SERIAL PRIMARY KEY,
       ticket_id VARCHAR(255) UNIQUE NOT NULL,
@@ -124,7 +120,6 @@ const createTables = async (client) => {
       closed_at TIMESTAMP
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS giveaways (
       id SERIAL PRIMARY KEY,
       giveaway_id VARCHAR(255) UNIQUE NOT NULL,
@@ -139,7 +134,6 @@ const createTables = async (client) => {
       ends_at TIMESTAMP NOT NULL
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS giveaway_entries (
       id SERIAL PRIMARY KEY,
       giveaway_id INTEGER NOT NULL,
@@ -149,7 +143,6 @@ const createTables = async (client) => {
       FOREIGN KEY(giveaway_id) REFERENCES giveaways(id) ON DELETE CASCADE
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS reaction_roles (
       id SERIAL PRIMARY KEY,
       guild_id VARCHAR(255) NOT NULL,
@@ -162,7 +155,6 @@ const createTables = async (client) => {
       UNIQUE(message_id, emoji)
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS welcome_system (
       id SERIAL PRIMARY KEY,
       guild_id VARCHAR(255) UNIQUE NOT NULL,
@@ -173,7 +165,6 @@ const createTables = async (client) => {
       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS counters (
       id SERIAL PRIMARY KEY,
       guild_id VARCHAR(255) UNIQUE NOT NULL,
@@ -184,7 +175,6 @@ const createTables = async (client) => {
       updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
     )`,
 
-    
     `CREATE TABLE IF NOT EXISTS audit_logs (
       id SERIAL PRIMARY KEY,
       guild_id VARCHAR(255) NOT NULL,
@@ -286,7 +276,6 @@ const createTriggers = async (client) => {
         $$ LANGUAGE plpgsql;
       `);
 
-      
       await client.query(`
         DROP TRIGGER IF EXISTS ${name} ON ${table};
         CREATE TRIGGER ${name}
@@ -391,4 +380,4 @@ if (command === 'apply') {
 } else {
   logger.error(`Unknown command: ${command}. Use one of: apply, check, status`);
   process.exit(1);
-}
+}

scripts/migrate.js

@@ -205,4 +205,4 @@ run().catch((error) => {
     error: error.message
   });
   process.exit(1);
-});
+});

scripts/restore-drill.js

@@ -134,4 +134,4 @@ run().catch((error) => {
     error: error.message
   });
   process.exit(1);
-});
+});

scripts/restore.js

@@ -20,15 +20,14 @@ class TitanBot extends Client {
 
         GatewayIntentBits.Guilds,                        
         GatewayIntentBits.GuildMembers,                 
-        
-        
+
         GatewayIntentBits.GuildMessages,                
         GatewayIntentBits.GuildMessageReactions,        
         GatewayIntentBits.MessageContent,               
-        
+        GatewayIntentBits.DirectMessages,
+
         GatewayIntentBits.GuildVoiceStates,             
-        
-        
+
         GatewayIntentBits.GuildBans,                    
       ],
     });
@@ -52,7 +51,7 @@ class TitanBot extends Client {
       startupLog('Initializing database...');
       const dbInstance = await initializeDatabase();
       this.db = dbInstance.db;
-      
+
       // Check database status and report
       const dbStatus = this.db.getStatus();
       if (dbStatus.isDegraded) {
@@ -196,8 +195,8 @@ class TitanBot extends Client {
         hasStartedListening = true;
         this.webServer = server;
         startupLog(`✅ Web Server running on ${host}:${port}`);
-        startupLog(`Health endpoint: http://localhost:${port}/health`);
-        startupLog(`Ready endpoint: http://localhost:${port}/ready`);
+        startupLog(`Health endpoint: http://${host}:${port}/health`);
+        startupLog(`Ready endpoint: http://${host}:${port}/ready`);
       });
 
       server.on('error', (error) => {
@@ -258,6 +257,7 @@ class TitanBot extends Client {
           }
         }
 
+        // Save cleaned counters if any were orphaned
         // Save cleaned counters if any were orphaned
         if (orphanedCounters.length > 0) {
           await saveServerCounters(this, guildId, validCounters);
@@ -270,21 +270,23 @@ class TitanBot extends Client {
   }
 
   async loadHandlers() {
+    startupLog('Loading handlers...');
     const handlers = [
       { path: 'events', type: 'default', required: true },
       { path: 'interactions', type: 'default', required: true }
     ];
 
     for (const handler of handlers) {
       try {
+        startupLog(`Loading handler: ${handler.path}`);
         const module = await import(`./handlers/${handler.path}.js`);
-        const loaderFn = handler.type.startsWith('named:') 
-          ? module[handler.type.split(':')[1]] 
+        const loaderFn = handler.type.startsWith('named:')
+          ? module[handler.type.split(':')[1]]
           : module.default;
-        
+
         if (typeof loaderFn === 'function') {
           await loaderFn(this);
-          logger.info(`✅ Loaded ${handler.path}`);
+          startupLog(`✅ Loaded ${handler.path}`);
         } else {
           throw new Error(`Invalid loader export from ${handler.path}`);
         }
@@ -319,6 +321,7 @@ class TitanBot extends Client {
       cron.getTasks().forEach(task => task.stop());
       logger.info('✅ Cron jobs stopped');
 
+      // Close database connection
       // Close database connection
       if (this.db && this.db.db) {
         logger.info('Closing database connection...');
@@ -332,15 +335,13 @@ class TitanBot extends Client {
         }
       }
 
-      
       logger.info('Destroying Discord client...');
       if (this.isReady()) {
         try {
           this.destroy();
           logger.info('✅ Discord client destroyed');
         } catch (error) {
-          
-          
+
           logger.warn('Discord client destroy warning (non-critical):', error.message);
         }
       }
@@ -368,19 +369,25 @@ try {
     });
 
     process.on('unhandledRejection', (reason, promise) => {
+      const code = reason?.code;
+      if (code === 10062 || code === 40060 || code === 50027) {
+        logger.warn('Recoverable Discord interaction rejection:', reason?.message || reason);
+        return;
+      }
+
       logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
       bot.shutdown('UNHANDLED_REJECTION');
     });
   };
 
   setupShutdown();
-  bot.start();
+  bot.start().catch((error) => {
+    logger.error('Fatal error during bot startup:', error);
+    bot.shutdown('STARTUP_ERROR');
+  });
 } catch (error) {
   logger.error('Fatal error during bot startup:', error);
   process.exit(1);
 }
 
-export default TitanBot;
-
-
-
+export default TitanBot;

src/app.js

@@ -113,6 +113,4 @@ export default {
             });
         }
     }
-};
-
-
+};