@blackcode_sa/metaestetics-api 1.14.63 → 1.14.69

package/src/admin/mailing/clinicWelcome/clinicWelcome.mailing.ts

@@ -0,0 +1,292 @@
+import { BaseMailingService } from "../base.mailing.service";
+import { clinicWelcomeTemplate } from "./templates/welcome.template";
+import { Logger } from "../../logger";
+import { ClinicGroup, CLINIC_GROUPS_COLLECTION } from "../../../types/clinic";
+
+/**
+ * Minimal interface for the mailgun.js client
+ */
+interface NewMailgunMessagesAPI {
+  create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+  messages: NewMailgunMessagesAPI;
+}
+
+/**
+ * Interface for clinic welcome email data
+ */
+export interface ClinicWelcomeEmailData {
+  /** Admin information */
+  admin: {
+    name: string;
+    email: string;
+  };
+
+  /** Clinic group information */
+  clinicGroup: {
+    id: string;
+    name: string;
+  };
+
+  /** Config options */
+  options?: {
+    dashboardUrl?: string;
+    supportEmail?: string;
+    customSubject?: string;
+    fromAddress?: string;
+    mailgunDomain?: string;
+  };
+}
+
+/**
+ * Service for sending clinic welcome/confirmation emails
+ * Sent to clinic admins after successful signup
+ */
+export class ClinicWelcomeMailingService extends BaseMailingService {
+  private readonly DEFAULT_DASHBOARD_URL =
+    "https://clinic.metaesthetics.net/dashboard";
+  private readonly DEFAULT_SUPPORT_EMAIL = "support@metaesthetics.net";
+  private readonly DEFAULT_SUBJECT =
+    "Welcome to MetaEsthetics - Your Clinic Registration is Complete";
+  private readonly DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
+
+  /**
+   * Constructor for ClinicWelcomeMailingService
+   * @param firestore - Firestore instance provided by the caller
+   * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
+   */
+  constructor(
+    firestore: FirebaseFirestore.Firestore,
+    mailgunClient: NewMailgunClient
+  ) {
+    super(firestore, mailgunClient);
+  }
+
+  /**
+   * Sends a clinic welcome email
+   * @param data - The clinic welcome email data
+   * @returns Promise resolved when email is sent
+   */
+  async sendWelcomeEmail(data: ClinicWelcomeEmailData): Promise<any> {
+    try {
+      Logger.info(
+        "[ClinicWelcomeMailingService] Sending welcome email to",
+        data.admin.email
+      );
+
+      // Get current date for registration date
+      const registrationDate = new Date().toLocaleDateString("en-US", {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+      });
+
+      // Dashboard URL
+      const dashboardUrl =
+        data.options?.dashboardUrl || this.DEFAULT_DASHBOARD_URL;
+
+      // Support email
+      const supportEmail =
+        data.options?.supportEmail || this.DEFAULT_SUPPORT_EMAIL;
+
+      // Subject line
+      const subject = data.options?.customSubject || this.DEFAULT_SUBJECT;
+
+      // Determine 'from' address
+      const fromAddress =
+        data.options?.fromAddress ||
+        `MetaEsthetics <no-reply@${
+          data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN
+        }>`;
+
+      // Current year for copyright
+      const currentYear = new Date().getFullYear().toString();
+
+      // Prepare template variables
+      const templateVariables = {
+        adminName: data.admin.name,
+        adminEmail: data.admin.email,
+        clinicGroupName: data.clinicGroup.name,
+        registrationDate,
+        dashboardUrl,
+        supportEmail,
+        currentYear,
+      };
+
+      // Debug log for template variables
+      Logger.info("[ClinicWelcomeMailingService] Template variables:", {
+        adminName: templateVariables.adminName,
+        adminEmail: templateVariables.adminEmail,
+        clinicGroupName: templateVariables.clinicGroupName,
+        dashboardUrl: templateVariables.dashboardUrl,
+      });
+
+      // Render HTML email
+      const html = this.renderTemplate(clinicWelcomeTemplate, templateVariables);
+
+      // Data for the sendEmail method
+      const mailgunSendData = {
+        to: data.admin.email,
+        from: fromAddress,
+        subject,
+        html,
+      };
+
+      // Determine the domain to use for sending
+      const domainToSendFrom =
+        data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
+
+      Logger.info("[ClinicWelcomeMailingService] Sending email with data:", {
+        domain: domainToSendFrom,
+        to: mailgunSendData.to,
+        from: mailgunSendData.from,
+        subject: mailgunSendData.subject,
+        hasHtml: !!mailgunSendData.html,
+      });
+
+      // Call the sendEmail method from BaseMailingService
+      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
+
+      // Log success
+      await this.logEmailAttempt(
+        {
+          to: data.admin.email,
+          subject,
+          templateName: "clinic_welcome",
+        },
+        true
+      );
+
+      return result;
+    } catch (error: any) {
+      Logger.error(
+        "[ClinicWelcomeMailingService] Error sending welcome email:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack,
+        }
+      );
+
+      // Log failure
+      await this.logEmailAttempt(
+        {
+          to: data.admin.email,
+          subject: data.options?.customSubject || this.DEFAULT_SUBJECT,
+          templateName: "clinic_welcome",
+        },
+        false,
+        error
+      );
+
+      throw error;
+    }
+  }
+
+  /**
+   * Handles the clinic group creation event from Cloud Functions.
+   * Fetches necessary data and sends the welcome email to the admin.
+   * @param clinicGroupData - The clinic group data including id
+   * @param mailgunConfig - Mailgun configuration (from, domain)
+   * @returns Promise resolved when the email is sent
+   */
+  async handleClinicGroupCreationEvent(
+    clinicGroupData: ClinicGroup & { id: string },
+    mailgunConfig: {
+      fromAddress: string;
+      domain: string;
+      dashboardUrl?: string;
+      supportEmail?: string;
+    }
+  ): Promise<void> {
+    try {
+      Logger.info(
+        "[ClinicWelcomeMailingService] Handling clinic group creation event for:",
+        clinicGroupData.id
+      );
+
+      // Validate clinic group data
+      if (!clinicGroupData || !clinicGroupData.id) {
+        throw new Error(
+          `Invalid clinic group data: Missing required properties.`
+        );
+      }
+
+      // Validate contact person
+      if (!clinicGroupData.contactPerson) {
+        throw new Error(
+          `Clinic group ${clinicGroupData.id} is missing contactPerson`
+        );
+      }
+
+      if (!clinicGroupData.contactPerson.email) {
+        throw new Error(
+          `Clinic group ${clinicGroupData.id} is missing admin email`
+        );
+      }
+
+      // Get admin name from contact person
+      const adminName = `${clinicGroupData.contactPerson.firstName || ""} ${
+        clinicGroupData.contactPerson.lastName || ""
+      }`.trim() || "Clinic Admin";
+
+      const adminEmail = clinicGroupData.contactPerson.email;
+
+      Logger.info(
+        `[ClinicWelcomeMailingService] Sending welcome email to admin: ${adminName} (${adminEmail})`
+      );
+
+      // Validate fromAddress
+      if (!mailgunConfig.fromAddress) {
+        Logger.warn(
+          "[ClinicWelcomeMailingService] No fromAddress provided, using default"
+        );
+        mailgunConfig.fromAddress = `MetaEsthetics <no-reply@${this.DEFAULT_MAILGUN_DOMAIN}>`;
+      }
+
+      // Prepare email data
+      const emailData: ClinicWelcomeEmailData = {
+        admin: {
+          name: adminName,
+          email: adminEmail,
+        },
+        clinicGroup: {
+          id: clinicGroupData.id,
+          name: clinicGroupData.name || "Your Clinic",
+        },
+        options: {
+          fromAddress: mailgunConfig.fromAddress,
+          mailgunDomain: mailgunConfig.domain,
+          dashboardUrl: mailgunConfig.dashboardUrl,
+          supportEmail: mailgunConfig.supportEmail,
+        },
+      };
+
+      Logger.info(
+        "[ClinicWelcomeMailingService] Email data prepared, sending welcome email"
+      );
+
+      // Send the welcome email
+      await this.sendWelcomeEmail(emailData);
+
+      Logger.info(
+        "[ClinicWelcomeMailingService] Welcome email sent successfully"
+      );
+    } catch (error: any) {
+      Logger.error(
+        "[ClinicWelcomeMailingService] Error handling clinic group creation event:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack,
+          clinicGroupId: clinicGroupData?.id,
+        }
+      );
+      throw error;
+    }
+  }
+}

package/src/admin/mailing/clinicWelcome/index.ts

@@ -0,0 +1 @@
+export * from "./clinicWelcome.mailing";

package/src/admin/mailing/clinicWelcome/templates/welcome.template.ts

@@ -0,0 +1,252 @@
+/**
+ * HTML email template for clinic welcome/confirmation email
+ * Sent to clinic admins after successful signup
+ */
+export const clinicWelcomeTemplate = `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Welcome to MetaEsthetics</title>
+  <style>
+    body {
+      font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+      line-height: 1.6;
+      color: #333;
+      margin: 0;
+      padding: 0;
+      background-color: #f5f5f5;
+    }
+    .container {
+      max-width: 600px;
+      margin: 0 auto;
+      padding: 20px;
+    }
+    .header {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      padding: 40px 20px;
+      text-align: center;
+      border-radius: 8px 8px 0 0;
+    }
+    .header h1 {
+      color: white;
+      margin: 0;
+      font-size: 28px;
+      font-weight: 600;
+    }
+    .header p {
+      color: rgba(255, 255, 255, 0.9);
+      margin: 10px 0 0 0;
+      font-size: 16px;
+    }
+    .content {
+      padding: 40px 30px;
+      background-color: #ffffff;
+    }
+    .greeting {
+      font-size: 18px;
+      color: #333;
+      margin-bottom: 20px;
+    }
+    .message {
+      font-size: 16px;
+      color: #555;
+      margin-bottom: 25px;
+    }
+    .highlight-box {
+      background: linear-gradient(135deg, #f6f9fc 0%, #eef2f7 100%);
+      border-left: 4px solid #667eea;
+      padding: 20px;
+      margin: 25px 0;
+      border-radius: 0 8px 8px 0;
+    }
+    .highlight-box h3 {
+      margin: 0 0 10px 0;
+      color: #333;
+      font-size: 16px;
+    }
+    .highlight-box p {
+      margin: 0;
+      color: #555;
+    }
+    .next-steps {
+      margin: 30px 0;
+    }
+    .next-steps h3 {
+      color: #333;
+      font-size: 18px;
+      margin-bottom: 15px;
+    }
+    .step {
+      display: flex;
+      align-items: flex-start;
+      margin-bottom: 15px;
+    }
+    .step-number {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      width: 28px;
+      height: 28px;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-weight: 600;
+      font-size: 14px;
+      margin-right: 12px;
+      flex-shrink: 0;
+    }
+    .step-content {
+      flex: 1;
+      padding-top: 3px;
+    }
+    .step-title {
+      font-weight: 600;
+      color: #333;
+      margin-bottom: 3px;
+    }
+    .step-description {
+      color: #666;
+      font-size: 14px;
+    }
+    .button-container {
+      text-align: center;
+      margin: 35px 0;
+    }
+    .button {
+      display: inline-block;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      text-decoration: none;
+      padding: 14px 32px;
+      border-radius: 6px;
+      font-weight: 600;
+      font-size: 16px;
+      transition: transform 0.2s;
+    }
+    .button:hover {
+      transform: translateY(-2px);
+    }
+    .support-box {
+      background-color: #f8f9fa;
+      padding: 20px;
+      border-radius: 8px;
+      margin-top: 30px;
+      text-align: center;
+    }
+    .support-box p {
+      margin: 0 0 10px 0;
+      color: #555;
+    }
+    .support-box a {
+      color: #667eea;
+      text-decoration: none;
+      font-weight: 500;
+    }
+    .footer {
+      padding: 30px;
+      text-align: center;
+      background-color: #f8f9fa;
+      border-radius: 0 0 8px 8px;
+    }
+    .footer p {
+      margin: 5px 0;
+      font-size: 13px;
+      color: #888;
+    }
+    .footer a {
+      color: #667eea;
+      text-decoration: none;
+    }
+    .social-links {
+      margin: 15px 0;
+    }
+    .social-links a {
+      display: inline-block;
+      margin: 0 8px;
+      color: #888;
+      text-decoration: none;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>Welcome to MetaEsthetics!</h1>
+      <p>Your clinic registration is complete</p>
+    </div>
+    <div class="content">
+      <p class="greeting">Hello {{adminName}},</p>
+
+      <p class="message">
+        Thank you for registering <strong>{{clinicGroupName}}</strong> with MetaEsthetics.
+        Your account has been successfully created and you're now ready to start managing
+        your aesthetic practice with our comprehensive platform.
+      </p>
+
+      <div class="highlight-box">
+        <h3>Account Details</h3>
+        <p><strong>Clinic Group:</strong> {{clinicGroupName}}</p>
+        <p><strong>Admin Email:</strong> {{adminEmail}}</p>
+        <p><strong>Registration Date:</strong> {{registrationDate}}</p>
+      </div>
+
+      <div class="next-steps">
+        <h3>Get Started with MetaEsthetics</h3>
+
+        <div class="step">
+          <div class="step-number">1</div>
+          <div class="step-content">
+            <div class="step-title">Complete Your Profile</div>
+            <div class="step-description">Add your clinic details, working hours, and upload photos to attract patients.</div>
+          </div>
+        </div>
+
+        <div class="step">
+          <div class="step-number">2</div>
+          <div class="step-content">
+            <div class="step-title">Add Your Team</div>
+            <div class="step-description">Invite practitioners and staff members to join your clinic.</div>
+          </div>
+        </div>
+
+        <div class="step">
+          <div class="step-number">3</div>
+          <div class="step-content">
+            <div class="step-title">Set Up Services</div>
+            <div class="step-description">Configure your procedures, pricing, and availability for bookings.</div>
+          </div>
+        </div>
+
+        <div class="step">
+          <div class="step-number">4</div>
+          <div class="step-content">
+            <div class="step-title">Start Accepting Patients</div>
+            <div class="step-description">Begin managing appointments and growing your practice.</div>
+          </div>
+        </div>
+      </div>
+
+      <div class="button-container">
+        <a href="{{dashboardUrl}}" class="button">Go to Dashboard</a>
+      </div>
+
+      <div class="support-box">
+        <p>Need help getting started?</p>
+        <p>Contact our support team at <a href="mailto:{{supportEmail}}">{{supportEmail}}</a></p>
+      </div>
+    </div>
+    <div class="footer">
+      <p>This is an automated message from MetaEsthetics.</p>
+      <p>&copy; {{currentYear}} MetaEsthetics. All rights reserved.</p>
+      <div class="social-links">
+        <a href="https://metaesthetics.net">Website</a> |
+        <a href="https://metaesthetics.net/privacy">Privacy Policy</a> |
+        <a href="https://metaesthetics.net/terms">Terms of Service</a>
+      </div>
+    </div>
+  </div>
+</body>
+</html>
+`;

package/src/admin/mailing/index.ts

@@ -2,3 +2,4 @@ export * from "./base.mailing.service";
 export * from "./practitionerInvite";
 export * from "./patientInvite";
 export * from "./appointment";
+export * from "./clinicWelcome";

package/src/services/appointment/appointment.service.ts

@@ -680,11 +680,23 @@ export class AppointmentService extends BaseService {
 
   /**
    * Cancels an appointment by an Admin/Clinic.
+   * @param appointmentId - The appointment ID to cancel
+   * @param reasonOrClinicId - Either a cancellation reason string, or clinicId (legacy parameter - will be ignored)
    */
-  async cancelAppointmentAdmin(appointmentId: string, reason: string): Promise<Appointment> {
+  async cancelAppointmentAdmin(appointmentId: string, reasonOrClinicId?: string): Promise<Appointment> {
     console.log(`[APPOINTMENT_SERVICE] Admin canceling appointment: ${appointmentId}`);
+
+    // Detect if the second parameter looks like an ID rather than a reason
+    // IDs typically have no spaces and contain alphanumeric/dash/underscore patterns
+    const isLikelyId = reasonOrClinicId &&
+      !reasonOrClinicId.includes(' ') &&
+      /^[a-zA-Z0-9_-]+$/.test(reasonOrClinicId) &&
+      reasonOrClinicId.length > 15;
+
+    const cancellationReason = isLikelyId ? undefined : (reasonOrClinicId || undefined);
+
     return this.updateAppointmentStatus(appointmentId, AppointmentStatus.CANCELED_CLINIC, {
-      cancellationReason: reason,
+      cancellationReason,
       canceledBy: 'clinic',
     });
   }