fix(types): Fix TypeScript build errors and improve API type safety across platformservice interfaces

ts/mail/services/classes.emailservice.ts

@@ -24,6 +24,107 @@ export interface IEmailConstructorOptions {
   loadTemplatesFromDir?: boolean;
 }
 
+/**
+ * Options for sending an email
+ * @see ISendEmailOptions in MtaConnector
+ */
+export type ISendEmailOptions = import('../delivery/classes.connector.mta.js').ISendEmailOptions;
+
+/**
+ * Template context data for email templates
+ * @see ITemplateContext in TemplateManager
+ */
+export type ITemplateContext = import('../core/classes.templatemanager.js').ITemplateContext;
+
+/**
+ * Validation options for email addresses
+ * Compatible with EmailValidator.validate options
+ */
+export interface IValidateEmailOptions {
+  /** Check MX records for the domain */
+  checkMx?: boolean;
+  /** Check if the domain is disposable (temporary email) */
+  checkDisposable?: boolean;
+  /** Check if the email is a role account (e.g., info@, support@) */
+  checkRole?: boolean;
+  /** Only check syntax without DNS lookups */
+  checkSyntaxOnly?: boolean;
+}
+
+/**
+ * Result of email validation
+ * @see IEmailValidationResult from EmailValidator
+ */
+export type IValidationResult = import('../core/classes.emailvalidator.js').IEmailValidationResult;
+
+/**
+ * Email service statistics
+ */
+export interface IEmailServiceStats {
+  /** Active email providers */
+  activeProviders: string[];
+  /** MTA statistics, if MTA is active */
+  mta?: {
+    /** Service start time */
+    startTime: Date;
+    /** Total emails received */
+    emailsReceived: number;
+    /** Total emails sent */
+    emailsSent: number;
+    /** Total emails that failed to send */
+    emailsFailed: number;
+    /** Active SMTP connections */
+    activeConnections: number;
+    /** Current email queue size */
+    queueSize: number;
+    /** Certificate information */
+    certificateInfo?: {
+      /** Domain for the certificate */
+      domain: string;
+      /** Certificate expiration date */
+      expiresAt: Date;
+      /** Days until certificate expires */
+      daysUntilExpiry: number;
+    };
+    /** IP warmup information */
+    warmupInfo?: {
+      /** Whether IP warmup is enabled */
+      enabled: boolean;
+      /** Number of active IPs */
+      activeIPs: number;
+      /** Number of IPs in warmup phase */
+      inWarmupPhase: number;
+      /** Number of IPs that completed warmup */
+      completedWarmup: number;
+    };
+    /** Reputation monitoring information */
+    reputationInfo?: {
+      /** Whether reputation monitoring is enabled */
+      enabled: boolean;
+      /** Number of domains being monitored */
+      monitoredDomains: number;
+      /** Average reputation score across domains */
+      averageScore: number;
+      /** Number of domains with reputation issues */
+      domainsWithIssues: number;
+    };
+    /** Rate limiting information */
+    rateLimiting?: {
+      /** Global rate limit statistics */
+      global: {
+        /** Current available tokens */
+        availableTokens: number;
+        /** Maximum tokens per period */
+        maxTokens: number;
+        /** Current consumption rate */
+        consumptionRate: number;
+        /** Number of rate limiting events */
+        rateLimitEvents: number;
+      };
+    };
+  };
+}
+
 /**
  * Email service with MTA support
  */
@@ -136,7 +237,7 @@ export class EmailService {
   public async sendEmail(
     email: plugins.smartmail.Smartmail<any>,
     to: string | string[],
-    options: any = {}
+    options: ISendEmailOptions = {}
   ): Promise<string> {
     // Determine which connector to use
     if (this.config.useMta && this.mtaConnector) {
@@ -156,8 +257,8 @@ export class EmailService {
   public async sendTemplateEmail(
     templateId: string,
     to: string | string[],
-    context: any = {},
-    options: any = {}
+    context: ITemplateContext = {},
+    options: ISendEmailOptions = {}
   ): Promise<string> {
     try {
       // Get email from template
@@ -183,28 +284,35 @@ export class EmailService {
    */
   public async validateEmail(
     email: string,
-    options: {
-      checkMx?: boolean;
-      checkDisposable?: boolean;
-      checkRole?: boolean;
-    } = {}
-  ): Promise<any> {
+    options: IValidateEmailOptions = {}
+  ): Promise<IValidationResult> {
     return this.emailValidator.validate(email, options);
   }
 
   /**
    * Get email service statistics
+   * @returns Service statistics in the format expected by the API
    */
-  public getStats() {
-    const stats: any = {
+  public getStats(): plugins.servezoneInterfaces.platformservice.mta.IReq_GetEMailStats['response'] {
+    // First generate detailed internal stats
+    const detailedStats: IEmailServiceStats = {
       activeProviders: []
     };
 
     if (this.config.useMta) {
-      stats.activeProviders.push('mta');
-      stats.mta = this.mtaService.getStats();
+      detailedStats.activeProviders.push('mta');
+      detailedStats.mta = this.mtaService.getStats();
     }
 
-    return stats;
+    // Convert detailed stats to the format expected by the API
+    const apiStats: plugins.servezoneInterfaces.platformservice.mta.IReq_GetEMailStats['response'] = {
+      totalEmailsSent: detailedStats.mta?.emailsSent || 0,
+      totalEmailsDelivered: detailedStats.mta?.emailsSent || 0, // Default to emails sent if we don't track delivery separately
+      totalEmailsBounced: detailedStats.mta?.emailsFailed || 0,
+      averageDeliveryTimeMs: 0, // We don't track this yet
+      lastUpdated: new Date().toISOString()
+    };
+
+    return apiStats;
   }
 }