feat(backend): add test email functionality and update support email address

Author: Lasim

.gitignore

@@ -68,6 +68,7 @@ services/backend/tests/e2e/test-data/*.db
 ._*.png
 ._*.webp
 ._*.jpg
+._*.pug
 ._*.yml
 ._*.yaml
 ._*.css

services/backend/src/email/emailService.ts

@@ -311,7 +311,7 @@ export class EmailService {
         userName: options.userName,
         userEmail: options.userEmail,
         loginUrl: options.loginUrl,
-        supportEmail: options.supportEmail || 'support@deploystack.com',
+        supportEmail: options.supportEmail || 'hello@deploystack.io',
       },
     }, logger);
   }
@@ -334,7 +334,7 @@ export class EmailService {
         userName: options.userName,
         resetUrl: options.resetUrl,
         expirationTime: options.expirationTime,
-        supportEmail: options.supportEmail || 'support@deploystack.com',
+        supportEmail: options.supportEmail || 'support@deploystack.io',
       },
     }, logger);
   }
@@ -387,8 +387,41 @@ export class EmailService {
         changeTime: options.changeTime,
         ipAddress: options.ipAddress,
         userAgent: options.userAgent,
-        loginUrl: options.loginUrl || 'https://app.deploystack.com/login',
-        supportEmail: options.supportEmail || '[email protected]',
+        loginUrl: options.loginUrl || 'https://cloud.deploystack.io/login',
+        supportEmail: options.supportEmail || '[email protected]',
+      },
+    }, logger);
+  }
+
+  /**
+   * Send a test email to verify SMTP configuration (type-safe helper)
+   */
+  static async sendTestEmail(options: {
+    to: string;
+    adminUser: string;
+    appUrl?: string;
+    supportEmail?: string;
+  }, logger: FastifyBaseLogger): Promise<EmailSendResult> {
+    const currentDateTime = new Date().toLocaleString('en-US', {
+      timeZone: 'UTC',
+      year: 'numeric',
+      month: 'long',
+      day: 'numeric',
+      hour: '2-digit',
+      minute: '2-digit',
+      second: '2-digit',
+      timeZoneName: 'short'
+    });
+
+    return this.sendEmail({
+      to: options.to,
+      subject: '✅ DeployStack Email Test - Configuration Successful',
+      template: 'test',
+      variables: {
+        testDateTime: currentDateTime,
+        adminUser: options.adminUser,
+        appUrl: options.appUrl || 'https://cloud.deploystack.io',
+        supportEmail: options.supportEmail || '[email protected]',
       },
     }, logger);
   }

services/backend/src/email/templates/test.pug

@@ -0,0 +1,45 @@
+//- test.pug
+//- @description Test email template for verifying SMTP configuration
+//- @variables testDateTime, adminUser, appUrl, supportEmail
+extends layouts/base.pug
+
+block content
+  .test-header
+    h1 ✅ Email Test Successful
+    
+  .test-content
+    p Hello!
+    
+    p This is a test email from your DeployStack installation. If you're reading this, your SMTP configuration is working correctly.
+    
+    .test-details
+      h3 Test Details:
+      ul
+        li
+          strong Test Time: 
+          | #{testDateTime}
+        li
+          strong Initiated by: 
+          | #{adminUser}
+        li
+          strong Application URL: 
+          a(href=appUrl)= appUrl
+    
+    .test-actions
+      p Your email system is ready to send:
+      ul
+        li Welcome emails for new users
+        li Password reset notifications
+        li System alerts and notifications
+        li Team invitations
+    
+    hr
+    
+    .footer-note
+      p
+        em This email was sent as part of SMTP configuration testing. No action is required.
+      
+      if supportEmail
+        p
+          | If you have questions, contact support at 
+          a(href=`mailto:${supportEmail}`)= supportEmail

services/backend/src/email/types.ts

@@ -130,13 +130,21 @@ export interface PasswordChangedEmailVariables {
   supportEmail?: string;
 }
 
+export interface TestEmailVariables {
+  testDateTime: string;
+  adminUser: string;
+  appUrl: string;
+  supportEmail?: string;
+}
+
 // Template registry for type safety
 export interface TemplateVariableMap {
   welcome: WelcomeEmailVariables;
   'password-reset': PasswordResetEmailVariables;
   notification: NotificationEmailVariables;
   'email-verification': EmailVerificationVariables;
   'password-changed': PasswordChangedEmailVariables;
+  test: TestEmailVariables;
 }
 
 export type TemplateNames = keyof TemplateVariableMap;

services/backend/src/permissions/index.ts

@@ -41,6 +41,7 @@ export const ROLE_DEFINITIONS = {
     'mcp.installations.create',
     'mcp.installations.edit',
     'mcp.installations.delete',
+    'email.test',
   ],
   global_user: [
     'profile.view',

services/backend/src/routes/admin/email/index.ts

@@ -0,0 +1,6 @@
+import { type FastifyInstance } from 'fastify';
+import testRoute from './test';
+
+export default async function adminEmailRoutes(fastify: FastifyInstance) {
+  await fastify.register(testRoute);
+}

services/backend/src/routes/admin/index.ts

@@ -0,0 +1,6 @@
+import { type FastifyInstance } from 'fastify';
+import emailRoutes from './email';
+
+export default async function adminRoutes(fastify: FastifyInstance) {
+  await fastify.register(emailRoutes, { prefix: '/admin/email' });
+}

services/backend/src/routes/index.ts

@@ -21,6 +21,8 @@ import healthRoute from './health'
 import mcpRoutes from './mcp'
 // Import OAuth2 routes
 import oauth2Routes from './oauth2'
+// Import admin routes
+import adminRoutes from './admin'
 
 // Response schema for the root health check endpoint
 const healthCheckResponseSchema = z.object({
@@ -58,6 +60,9 @@ export const registerRoutes = (server: FastifyInstance): void => {
 
     // Register OAuth2 routes
     await apiInstance.register(oauth2Routes);
+    
+    // Register admin routes
+    await apiInstance.register(adminRoutes);
   }, { prefix: '/api' });