npm - @blackcode_sa/metaestetics-api - Versions diffs - 1.14.65 → 1.14.69 - Mend

@blackcode_sa/metaestetics-api 1.14.65 → 1.14.69

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/admin/index.d.mts +203 -19
package/dist/admin/index.d.ts +203 -19
package/dist/admin/index.js +436 -2
package/dist/admin/index.mjs +435 -2
package/package.json +1 -1
package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +19 -2
package/src/admin/index.ts +1 -1
package/src/admin/mailing/clinicWelcome/clinicWelcome.mailing.ts +292 -0
package/src/admin/mailing/clinicWelcome/index.ts +1 -0
package/src/admin/mailing/clinicWelcome/templates/welcome.template.ts +252 -0
package/src/admin/mailing/index.ts +1 -0

package/dist/admin/index.mjs CHANGED Viewed

@@ -3055,6 +3055,11 @@ var AppointmentMailingService = class extends BaseMailingService {
 };
 // src/admin/aggregation/appointment/appointment.aggregation.service.ts
+function sanitizeCancellationReason(reason) {
+  if (!reason) return void 0;
+  const isLikelyId = !reason.includes(" ") && /^[a-zA-Z0-9_-]+$/.test(reason) && reason.length > 15;
+  return isLikelyId ? void 0 : reason;
+}
 var AppointmentAggregationService = class {
   /**
    * Constructor for AppointmentAggregationService.
@@ -3336,7 +3341,7 @@ var AppointmentAggregationService = class {
               appointment: after,
               recipientProfile: after.patientInfo,
               recipientRole: "patient",
-              cancellationReason: after.cancellationReason
+              cancellationReason: sanitizeCancellationReason(after.cancellationReason)
             };
             await this.appointmentMailingService.sendAppointmentCancelledEmail(
               patientCancellationData
@@ -3350,7 +3355,7 @@ var AppointmentAggregationService = class {
               appointment: after,
               recipientProfile: after.practitionerInfo,
               recipientRole: "practitioner",
-              cancellationReason: after.cancellationReason
+              cancellationReason: sanitizeCancellationReason(after.cancellationReason)
             };
             await this.appointmentMailingService.sendAppointmentCancelledEmail(
               practitionerCancellationData
@@ -14012,6 +14017,433 @@ var PatientInviteMailingService = class extends BaseMailingService {
   }
 };
+// src/admin/mailing/clinicWelcome/templates/welcome.template.ts
+var 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>
+`;
+// src/admin/mailing/clinicWelcome/clinicWelcome.mailing.ts
+var ClinicWelcomeMailingService = class extends BaseMailingService {
+  /**
+   * Constructor for ClinicWelcomeMailingService
+   * @param firestore - Firestore instance provided by the caller
+   * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
+   */
+  constructor(firestore19, mailgunClient) {
+    super(firestore19, mailgunClient);
+    this.DEFAULT_DASHBOARD_URL = "https://clinic.metaesthetics.net/dashboard";
+    this.DEFAULT_SUPPORT_EMAIL = "support@metaesthetics.net";
+    this.DEFAULT_SUBJECT = "Welcome to MetaEsthetics - Your Clinic Registration is Complete";
+    this.DEFAULT_MAILGUN_DOMAIN = "mg.metaesthetics.net";
+  }
+  /**
+   * Sends a clinic welcome email
+   * @param data - The clinic welcome email data
+   * @returns Promise resolved when email is sent
+   */
+  async sendWelcomeEmail(data) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    try {
+      Logger.info(
+        "[ClinicWelcomeMailingService] Sending welcome email to",
+        data.admin.email
+      );
+      const registrationDate = (/* @__PURE__ */ new Date()).toLocaleDateString("en-US", {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric"
+      });
+      const dashboardUrl = ((_a = data.options) == null ? void 0 : _a.dashboardUrl) || this.DEFAULT_DASHBOARD_URL;
+      const supportEmail = ((_b = data.options) == null ? void 0 : _b.supportEmail) || this.DEFAULT_SUPPORT_EMAIL;
+      const subject = ((_c = data.options) == null ? void 0 : _c.customSubject) || this.DEFAULT_SUBJECT;
+      const fromAddress = ((_d = data.options) == null ? void 0 : _d.fromAddress) || `MetaEsthetics <no-reply@${((_e = data.options) == null ? void 0 : _e.mailgunDomain) || this.DEFAULT_MAILGUN_DOMAIN}>`;
+      const currentYear = (/* @__PURE__ */ new Date()).getFullYear().toString();
+      const templateVariables = {
+        adminName: data.admin.name,
+        adminEmail: data.admin.email,
+        clinicGroupName: data.clinicGroup.name,
+        registrationDate,
+        dashboardUrl,
+        supportEmail,
+        currentYear
+      };
+      Logger.info("[ClinicWelcomeMailingService] Template variables:", {
+        adminName: templateVariables.adminName,
+        adminEmail: templateVariables.adminEmail,
+        clinicGroupName: templateVariables.clinicGroupName,
+        dashboardUrl: templateVariables.dashboardUrl
+      });
+      const html = this.renderTemplate(clinicWelcomeTemplate, templateVariables);
+      const mailgunSendData = {
+        to: data.admin.email,
+        from: fromAddress,
+        subject,
+        html
+      };
+      const domainToSendFrom = ((_f = data.options) == null ? void 0 : _f.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
+      });
+      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
+      await this.logEmailAttempt(
+        {
+          to: data.admin.email,
+          subject,
+          templateName: "clinic_welcome"
+        },
+        true
+      );
+      return result;
+    } catch (error) {
+      Logger.error(
+        "[ClinicWelcomeMailingService] Error sending welcome email:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack
+        }
+      );
+      await this.logEmailAttempt(
+        {
+          to: data.admin.email,
+          subject: ((_g = data.options) == null ? void 0 : _g.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, mailgunConfig) {
+    try {
+      Logger.info(
+        "[ClinicWelcomeMailingService] Handling clinic group creation event for:",
+        clinicGroupData.id
+      );
+      if (!clinicGroupData || !clinicGroupData.id) {
+        throw new Error(
+          `Invalid clinic group data: Missing required properties.`
+        );
+      }
+      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`
+        );
+      }
+      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})`
+      );
+      if (!mailgunConfig.fromAddress) {
+        Logger.warn(
+          "[ClinicWelcomeMailingService] No fromAddress provided, using default"
+        );
+        mailgunConfig.fromAddress = `MetaEsthetics <no-reply@${this.DEFAULT_MAILGUN_DOMAIN}>`;
+      }
+      const emailData = {
+        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"
+      );
+      await this.sendWelcomeEmail(emailData);
+      Logger.info(
+        "[ClinicWelcomeMailingService] Welcome email sent successfully"
+      );
+    } catch (error) {
+      Logger.error(
+        "[ClinicWelcomeMailingService] Error handling clinic group creation event:",
+        {
+          errorMessage: error.message,
+          errorDetails: error.details,
+          errorStatus: error.status,
+          stack: error.stack,
+          clinicGroupId: clinicGroupData == null ? void 0 : clinicGroupData.id
+        }
+      );
+      throw error;
+    }
+  }
+};
 // src/admin/users/user-profile.admin.ts
 import * as admin18 from "firebase-admin";
 var UserProfileAdminService = class {
@@ -14313,6 +14745,7 @@ export {
   CLINIC_ANALYTICS_SUBCOLLECTION,
   CalendarAdminService,
   ClinicAggregationService,
+  ClinicWelcomeMailingService,
   DASHBOARD_ANALYTICS_SUBCOLLECTION,
   DocumentManagerAdminService,
   ExistingPractitionerInviteMailingService,

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@blackcode_sa/metaestetics-api",
   "private": false,
-  "version": "1.14.65",
+  "version": "1.14.69",
   "description": "Firebase authentication service with anonymous upgrade support",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/admin/aggregation/appointment/appointment.aggregation.service.ts CHANGED Viewed

@@ -41,6 +41,23 @@ import { NotificationType } from '../../../types/notifications';
 // Mailgun client will be injected via constructor
+/**
+ * Helper to sanitize cancellation reason - filters out ID-like strings
+ * that were mistakenly passed as reasons (e.g., clinicId)
+ */
+function sanitizeCancellationReason(reason: string | null | undefined): string | undefined {
+  if (!reason) return undefined;
+  // Detect if the reason looks like an ID rather than actual text
+  // IDs typically: no spaces, alphanumeric with dashes/underscores, length > 15
+  const isLikelyId =
+    !reason.includes(' ') &&
+    /^[a-zA-Z0-9_-]+$/.test(reason) &&
+    reason.length > 15;
+  return isLikelyId ? undefined : reason;
+}
 /**
  * Type for requirement with source procedure tracking
  */
@@ -408,7 +425,7 @@ export class AppointmentAggregationService {
               appointment: after,
               recipientProfile: after.patientInfo,
               recipientRole: 'patient' as const,
-              cancellationReason: after.cancellationReason,
+              cancellationReason: sanitizeCancellationReason(after.cancellationReason),
             };
             await this.appointmentMailingService.sendAppointmentCancelledEmail(
               patientCancellationData as any,
@@ -424,7 +441,7 @@ export class AppointmentAggregationService {
               appointment: after,
               recipientProfile: after.practitionerInfo,
               recipientRole: 'practitioner' as const,
-              cancellationReason: after.cancellationReason,
+              cancellationReason: sanitizeCancellationReason(after.cancellationReason),
             };
             await this.appointmentMailingService.sendAppointmentCancelledEmail(
               practitionerCancellationData as any,

package/src/admin/index.ts CHANGED Viewed

@@ -10,7 +10,7 @@ export type {
 } from '../types/notifications';
 export type { PatientProfile, PatientSensitiveInfo } from '../types/patient';
 export { PATIENTS_COLLECTION, PATIENT_SENSITIVE_INFO_COLLECTION } from '../types/patient';
-export type { Clinic, ClinicLocation } from '../types/clinic';
+export type { Clinic, ClinicLocation, ClinicGroup } from '../types/clinic';
 export type { ClinicInfo } from '../types/profile';
 export type { Practitioner, PractitionerToken } from '../types/practitioner';
 export type { PractitionerInvite } from '../types/clinic/practitioner-invite.types';