npm - @blackcode_sa/metaestetics-api - Versions diffs - 1.12.58 → 1.12.61 - Mend

@blackcode_sa/metaestetics-api 1.12.58 → 1.12.61

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 (267) hide show

package/dist/admin/index.d.mts +36 -4
package/dist/admin/index.d.ts +36 -4
package/dist/admin/index.js +156 -28
package/dist/admin/index.mjs +156 -28
package/dist/index.d.mts +9 -1
package/dist/index.d.ts +9 -1
package/package.json +119 -119
package/src/__mocks__/firstore.ts +10 -10
package/src/admin/aggregation/README.md +79 -79
package/src/admin/aggregation/appointment/README.md +128 -128
package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1844 -1689
package/src/admin/aggregation/appointment/index.ts +1 -1
package/src/admin/aggregation/clinic/README.md +52 -52
package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +703 -703
package/src/admin/aggregation/clinic/index.ts +1 -1
package/src/admin/aggregation/forms/README.md +13 -13
package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
package/src/admin/aggregation/forms/index.ts +1 -1
package/src/admin/aggregation/index.ts +8 -8
package/src/admin/aggregation/patient/README.md +27 -27
package/src/admin/aggregation/patient/index.ts +1 -1
package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
package/src/admin/aggregation/practitioner/README.md +42 -42
package/src/admin/aggregation/practitioner/index.ts +1 -1
package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
package/src/admin/aggregation/procedure/README.md +43 -43
package/src/admin/aggregation/procedure/index.ts +1 -1
package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
package/src/admin/aggregation/reviews/index.ts +1 -1
package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +641 -641
package/src/admin/booking/README.md +125 -125
package/src/admin/booking/booking.admin.ts +1037 -1037
package/src/admin/booking/booking.calculator.ts +712 -699
package/src/admin/booking/booking.types.ts +59 -59
package/src/admin/booking/index.ts +3 -3
package/src/admin/booking/timezones-problem.md +185 -185
package/src/admin/calendar/README.md +7 -7
package/src/admin/calendar/calendar.admin.service.ts +345 -345
package/src/admin/calendar/index.ts +1 -1
package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
package/src/admin/documentation-templates/index.ts +1 -1
package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
package/src/admin/free-consultation/index.ts +1 -1
package/src/admin/index.ts +75 -75
package/src/admin/logger/index.ts +78 -78
package/src/admin/mailing/README.md +95 -95
package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
package/src/admin/mailing/appointment/index.ts +1 -1
package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
package/src/admin/mailing/base.mailing.service.ts +208 -208
package/src/admin/mailing/index.ts +3 -3
package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
package/src/admin/mailing/practitionerInvite/index.ts +2 -2
package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
package/src/admin/notifications/index.ts +1 -1
package/src/admin/notifications/notifications.admin.ts +710 -710
package/src/admin/requirements/README.md +128 -128
package/src/admin/requirements/index.ts +1 -1
package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
package/src/admin/users/index.ts +1 -1
package/src/admin/users/user-profile.admin.ts +405 -405
package/src/backoffice/constants/certification.constants.ts +13 -13
package/src/backoffice/constants/index.ts +1 -1
package/src/backoffice/errors/backoffice.errors.ts +181 -181
package/src/backoffice/errors/index.ts +1 -1
package/src/backoffice/expo-safe/README.md +26 -26
package/src/backoffice/expo-safe/index.ts +41 -41
package/src/backoffice/index.ts +5 -5
package/src/backoffice/services/FIXES_README.md +102 -102
package/src/backoffice/services/README.md +40 -40
package/src/backoffice/services/brand.service.ts +256 -256
package/src/backoffice/services/category.service.ts +318 -318
package/src/backoffice/services/constants.service.ts +385 -385
package/src/backoffice/services/documentation-template.service.ts +202 -202
package/src/backoffice/services/index.ts +8 -8
package/src/backoffice/services/migrate-products.ts +116 -116
package/src/backoffice/services/product.service.ts +553 -553
package/src/backoffice/services/requirement.service.ts +235 -235
package/src/backoffice/services/subcategory.service.ts +395 -395
package/src/backoffice/services/technology.service.ts +1070 -1070
package/src/backoffice/types/README.md +12 -12
package/src/backoffice/types/admin-constants.types.ts +69 -69
package/src/backoffice/types/brand.types.ts +29 -29
package/src/backoffice/types/category.types.ts +62 -62
package/src/backoffice/types/documentation-templates.types.ts +28 -28
package/src/backoffice/types/index.ts +10 -10
package/src/backoffice/types/procedure-product.types.ts +38 -38
package/src/backoffice/types/product.types.ts +240 -240
package/src/backoffice/types/requirement.types.ts +63 -63
package/src/backoffice/types/static/README.md +18 -18
package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
package/src/backoffice/types/static/certification.types.ts +37 -37
package/src/backoffice/types/static/contraindication.types.ts +19 -19
package/src/backoffice/types/static/index.ts +6 -6
package/src/backoffice/types/static/pricing.types.ts +16 -16
package/src/backoffice/types/static/procedure-family.types.ts +14 -14
package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
package/src/backoffice/types/subcategory.types.ts +34 -34
package/src/backoffice/types/technology.types.ts +161 -161
package/src/backoffice/validations/index.ts +1 -1
package/src/backoffice/validations/schemas.ts +163 -163
package/src/config/__mocks__/firebase.ts +99 -99
package/src/config/firebase.ts +78 -78
package/src/config/index.ts +9 -9
package/src/errors/auth.error.ts +6 -6
package/src/errors/auth.errors.ts +200 -200
package/src/errors/clinic.errors.ts +32 -32
package/src/errors/firebase.errors.ts +47 -47
package/src/errors/user.errors.ts +99 -99
package/src/index.backup.ts +407 -407
package/src/index.ts +6 -6
package/src/locales/en.ts +31 -31
package/src/recommender/admin/index.ts +1 -1
package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
package/src/recommender/front/index.ts +1 -1
package/src/recommender/front/services/onboarding.service.ts +5 -5
package/src/recommender/front/services/recommender.service.ts +3 -3
package/src/recommender/index.ts +1 -1
package/src/services/PATIENTAUTH.MD +197 -197
package/src/services/README.md +106 -106
package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
package/src/services/__tests__/auth/auth.setup.ts +293 -293
package/src/services/__tests__/auth.service.test.ts +346 -346
package/src/services/__tests__/base.service.test.ts +77 -77
package/src/services/__tests__/user.service.test.ts +528 -528
package/src/services/appointment/README.md +17 -17
package/src/services/appointment/appointment.service.ts +2082 -2082
package/src/services/appointment/index.ts +1 -1
package/src/services/appointment/utils/appointment.utils.ts +552 -552
package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
package/src/services/appointment/utils/zone-management.utils.ts +353 -353
package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
package/src/services/auth/auth.service.ts +989 -989
package/src/services/auth/auth.v2.service.ts +961 -961
package/src/services/auth/index.ts +7 -7
package/src/services/auth/utils/error.utils.ts +90 -90
package/src/services/auth/utils/firebase.utils.ts +49 -49
package/src/services/auth/utils/index.ts +21 -21
package/src/services/auth/utils/practitioner.utils.ts +125 -125
package/src/services/base.service.ts +41 -41
package/src/services/calendar/calendar.service.ts +1077 -1077
package/src/services/calendar/calendar.v2.service.ts +1683 -1683
package/src/services/calendar/calendar.v3.service.ts +313 -313
package/src/services/calendar/externalCalendar.service.ts +178 -178
package/src/services/calendar/index.ts +5 -5
package/src/services/calendar/synced-calendars.service.ts +743 -743
package/src/services/calendar/utils/appointment.utils.ts +265 -265
package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
package/src/services/calendar/utils/clinic.utils.ts +237 -237
package/src/services/calendar/utils/docs.utils.ts +157 -157
package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
package/src/services/calendar/utils/index.ts +8 -8
package/src/services/calendar/utils/patient.utils.ts +198 -198
package/src/services/calendar/utils/practitioner.utils.ts +221 -221
package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
package/src/services/clinic/README.md +204 -204
package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
package/src/services/clinic/billing-transactions.service.ts +217 -217
package/src/services/clinic/clinic-admin.service.ts +202 -202
package/src/services/clinic/clinic-group.service.ts +310 -310
package/src/services/clinic/clinic.service.ts +708 -708
package/src/services/clinic/index.ts +5 -5
package/src/services/clinic/practitioner-invite.service.ts +519 -519
package/src/services/clinic/utils/admin.utils.ts +551 -551
package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
package/src/services/clinic/utils/clinic.utils.ts +949 -949
package/src/services/clinic/utils/filter.utils.d.ts +23 -23
package/src/services/clinic/utils/filter.utils.ts +446 -446
package/src/services/clinic/utils/index.ts +11 -11
package/src/services/clinic/utils/photos.utils.ts +188 -188
package/src/services/clinic/utils/search.utils.ts +84 -84
package/src/services/clinic/utils/tag.utils.ts +124 -124
package/src/services/documentation-templates/documentation-template.service.ts +537 -537
package/src/services/documentation-templates/filled-document.service.ts +587 -587
package/src/services/documentation-templates/index.ts +2 -2
package/src/services/index.ts +13 -13
package/src/services/media/index.ts +1 -1
package/src/services/media/media.service.ts +418 -418
package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
package/src/services/notifications/index.ts +1 -1
package/src/services/notifications/notification.service.ts +215 -215
package/src/services/patient/README.md +48 -48
package/src/services/patient/To-Do.md +43 -43
package/src/services/patient/__tests__/patient.service.test.ts +294 -294
package/src/services/patient/index.ts +2 -2
package/src/services/patient/patient.service.ts +883 -883
package/src/services/patient/patientRequirements.service.ts +285 -285
package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
package/src/services/patient/utils/clinic.utils.ts +80 -80
package/src/services/patient/utils/docs.utils.ts +142 -142
package/src/services/patient/utils/index.ts +9 -9
package/src/services/patient/utils/location.utils.ts +126 -126
package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
package/src/services/patient/utils/medical.utils.ts +458 -458
package/src/services/patient/utils/practitioner.utils.ts +260 -260
package/src/services/patient/utils/profile.utils.ts +510 -510
package/src/services/patient/utils/sensitive.utils.ts +260 -260
package/src/services/patient/utils/token.utils.ts +211 -211
package/src/services/practitioner/README.md +145 -145
package/src/services/practitioner/index.ts +1 -1
package/src/services/practitioner/practitioner.service.ts +1742 -1742
package/src/services/procedure/README.md +163 -163
package/src/services/procedure/index.ts +1 -1
package/src/services/procedure/procedure.service.ts +1682 -1682
package/src/services/reviews/index.ts +1 -1
package/src/services/reviews/reviews.service.ts +636 -636
package/src/services/user/index.ts +1 -1
package/src/services/user/user.service.ts +489 -489
package/src/services/user/user.v2.service.ts +466 -466
package/src/types/appointment/index.ts +453 -453
package/src/types/calendar/index.ts +258 -258
package/src/types/calendar/synced-calendar.types.ts +66 -66
package/src/types/clinic/index.ts +489 -489
package/src/types/clinic/practitioner-invite.types.ts +91 -91
package/src/types/clinic/preferences.types.ts +159 -159
package/src/types/clinic/to-do +3 -3
package/src/types/documentation-templates/index.ts +308 -308
package/src/types/index.ts +44 -44
package/src/types/notifications/README.md +77 -77
package/src/types/notifications/index.ts +265 -265
package/src/types/patient/aesthetic-analysis.types.ts +66 -66
package/src/types/patient/allergies.ts +58 -58
package/src/types/patient/index.ts +273 -273
package/src/types/patient/medical-info.types.ts +152 -152
package/src/types/patient/patient-requirements.ts +92 -81
package/src/types/patient/token.types.ts +61 -61
package/src/types/practitioner/index.ts +206 -206
package/src/types/procedure/index.ts +181 -181
package/src/types/profile/index.ts +39 -39
package/src/types/reviews/index.ts +130 -130
package/src/types/tz-lookup.d.ts +4 -4
package/src/types/user/index.ts +38 -38
package/src/utils/TIMESTAMPS.md +176 -176
package/src/utils/TimestampUtils.ts +241 -241
package/src/utils/index.ts +1 -1
package/src/validations/appointment.schema.ts +574 -574
package/src/validations/calendar.schema.ts +225 -225
package/src/validations/clinic.schema.ts +493 -493
package/src/validations/common.schema.ts +25 -25
package/src/validations/documentation-templates/index.ts +1 -1
package/src/validations/documentation-templates/template.schema.ts +220 -220
package/src/validations/documentation-templates.schema.ts +10 -10
package/src/validations/index.ts +20 -20
package/src/validations/media.schema.ts +10 -10
package/src/validations/notification.schema.ts +90 -90
package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
package/src/validations/patient/medical-info.schema.ts +125 -125
package/src/validations/patient/patient-requirements.schema.ts +84 -75
package/src/validations/patient/token.schema.ts +29 -29
package/src/validations/patient.schema.ts +216 -216
package/src/validations/practitioner.schema.ts +222 -222
package/src/validations/procedure-product.schema.ts +41 -41
package/src/validations/procedure.schema.ts +124 -124
package/src/validations/profile-info.schema.ts +41 -41
package/src/validations/reviews.schema.ts +189 -189
package/src/validations/schemas.ts +104 -104
package/src/validations/shared.schema.ts +78 -78

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

@@ -1,732 +1,732 @@
-import * as admin from 'firebase-admin';
-import { DateTime } from 'luxon';
-import { BaseMailingService, NewMailgunClient } from '../base.mailing.service';
-import { Logger } from '../../logger';
-import { Appointment } from '../../../types/appointment';
-import { PatientProfile } from '../../../types/patient';
-import { Practitioner } from '../../../types/practitioner';
-import { Clinic } from '../../../types/clinic';
-import { UserRole } from '../../../types';
-import { PractitionerProfileInfo, PatientProfileInfo, ClinicInfo } from '../../../types/profile';
-// Simple string literals for placeholders, to be replaced by file loading later
-const patientAppointmentConfirmedTemplate = `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Appointment Confirmed</title>
-    <style>
-        body {
-            margin: 0;
-            padding: 0;
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
-            min-height: 100vh;
-        }
-        .email-container {
-            max-width: 600px;
-            margin: 0 auto;
-            background: #ffffff;
-            border-radius: 20px;
-            overflow: hidden;
-            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
-            margin-top: 40px;
-            margin-bottom: 40px;
-        }
-        .header {
-            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
-            padding: 40px 30px;
-            text-align: center;
-            color: white;
-        }
-        .header h1 {
-            margin: 0;
-            font-size: 28px;
-            font-weight: 300;
-            letter-spacing: 1px;
-        }
-        .header .subtitle {
-            margin: 10px 0 0 0;
-            font-size: 16px;
-            opacity: 0.9;
-            font-weight: 300;
-        }
-        .content {
-            padding: 40px 30px;
-        }
-        .greeting {
-            font-size: 18px;
-            color: #333;
-            margin-bottom: 25px;
-            font-weight: 400;
-        }
-        .appointment-card {
-            background: linear-gradient(135deg, #f8f6f5 0%, #f5f3f2 100%);
-            border-radius: 15px;
-            padding: 30px;
-            margin: 25px 0;
-            border-left: 5px solid #a48a76;
-        }
-        .appointment-title {
-            font-size: 20px;
-            color: #a48a76;
-            margin-bottom: 20px;
-            font-weight: 600;
-        }
-        .appointment-details {
-            display: grid;
-            gap: 15px;
-        }
-        .detail-row {
-            display: flex;
-            align-items: center;
-            padding: 8px 0;
-        }
-        .detail-label {
-            font-weight: 600;
-            color: #555;
-            min-width: 120px;
-            font-size: 14px;
-        }
-        .detail-value {
-            color: #333;
-            font-size: 16px;
-            font-weight: 500;
-        }
-        .procedure-name {
-            color: #67574A;
-            font-weight: 600;
-        }
-        .clinic-name {
-            color: #a48a76;
-            font-weight: 600;
-        }
-        .success-icon {
-            text-align: center;
-            margin: 20px 0;
-            font-size: 48px;
-        }
-        .footer {
-            background: #f8f9fa;
-            padding: 25px 30px;
-            text-align: center;
-            color: #666;
-            font-size: 14px;
-            border-top: 1px solid #eee;
-        }
-        .logo {
-            font-size: 24px;
-            font-weight: 700;
-            color: white;
-            margin-bottom: 5px;
-        }
-        .divider {
-            height: 2px;
-            background: linear-gradient(90deg, #a48a76, #67574A);
-            margin: 25px 0;
-            border-radius: 1px;
-        }
-        .thank-you {
-            background: linear-gradient(135deg, #f0ede8 0%, #ebe6e0 100%);
-            border-radius: 15px;
-            padding: 25px;
-            margin: 25px 0;
-            text-align: center;
-            border-left: 5px solid #4CAF50;
-        }
-    </style>
-</head>
-<body>
-    <div class="email-container">
-        <div class="header">
-            <div class="logo">MetaEstetics</div>
-            <h1>Appointment Confirmed</h1>
-            <div class="subtitle">Your Beauty Journey Awaits</div>
-        </div>
-        <div class="content">
-            <div class="success-icon">✨</div>
-            <div class="greeting">
-                Dear <strong>{{patientName}}</strong>,
-            </div>
-            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 25px;">
-                We're delighted to confirm your appointment! Your journey to enhanced beauty and confidence is just around the corner.
-            </p>
-            <div class="appointment-card">
-                <div class="appointment-title">📅 Your Appointment Details</div>
-                <div class="appointment-details">
-                    <div class="detail-row">
-                        <div class="detail-label">Procedure:</div>
-                        <div class="detail-value procedure-name">{{procedureName}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Date:</div>
-                        <div class="detail-value">{{appointmentDate}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Time:</div>
-                        <div class="detail-value">{{appointmentTime}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Practitioner:</div>
-                        <div class="detail-value">{{practitionerName}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Location:</div>
-                        <div class="detail-value clinic-name">{{clinicName}}</div>
-                    </div>
-                </div>
-            </div>
-            <div class="divider"></div>
-            <div class="thank-you">
-                <h3 style="margin: 0 0 10px 0; color: #4caf50; font-weight: 600;">Thank You for Choosing MetaEstetics!</h3>
-                <p style="margin: 0; color: #555; font-size: 14px;">
-                    We look forward to providing you with exceptional care and outstanding results.
-                </p>
-            </div>
-            <p style="color: #555; font-size: 14px; line-height: 1.6; margin-top: 25px;">
-                <strong>Important:</strong> Please arrive 15 minutes early for your appointment. If you need to reschedule or have any questions, please contact us as soon as possible.
-            </p>
-        </div>
-        <div class="footer">
-            <p style="margin: 0 0 10px 0;">
-                <strong>MetaEstetics</strong> - Premium Aesthetic Services
-            </p>
-            <p style="margin: 0; font-size: 12px; color: #999;">
-                This is an automated message. Please do not reply to this email.
-            </p>
-        </div>
-    </div>
-</body>
-</html>
-`;
-const clinicAppointmentRequestedTemplate = `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>New Appointment Request</title>
-    <style>
-        body {
-            margin: 0;
-            padding: 0;
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
-            min-height: 100vh;
-        }
-        .email-container {
-            max-width: 600px;
-            margin: 0 auto;
-            background: #ffffff;
-            border-radius: 20px;
-            overflow: hidden;
-            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
-            margin-top: 40px;
-            margin-bottom: 40px;
-        }
-        .header {
-            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
-            padding: 40px 30px;
-            text-align: center;
-            color: white;
-        }
-        .header h1 {
-            margin: 0;
-            font-size: 28px;
-            font-weight: 300;
-            letter-spacing: 1px;
-        }
-        .header .subtitle {
-            margin: 10px 0 0 0;
-            font-size: 16px;
-            opacity: 0.9;
-            font-weight: 300;
-        }
-        .content {
-            padding: 40px 30px;
-        }
-        .greeting {
-            font-size: 18px;
-            color: #333;
-            margin-bottom: 25px;
-            font-weight: 400;
-        }
-        .appointment-card {
-            background: linear-gradient(135deg, #f8f6f5 0%, #f5f3f2 100%);
-            border-radius: 15px;
-            padding: 30px;
-            margin: 25px 0;
-            border-left: 5px solid #a48a76;
-        }
-        .appointment-title {
-            font-size: 20px;
-            color: #a48a76;
-            margin-bottom: 20px;
-            font-weight: 600;
-        }
-        .appointment-details {
-            display: grid;
-            gap: 15px;
-        }
-        .detail-row {
-            display: flex;
-            align-items: center;
-            padding: 8px 0;
-        }
-        .detail-label {
-            font-weight: 600;
-            color: #555;
-            min-width: 120px;
-            font-size: 14px;
-        }
-        .detail-value {
-            color: #333;
-            font-size: 16px;
-            font-weight: 500;
-        }
-        .patient-name {
-            color: #a48a76;
-            font-weight: 600;
-        }
-        .procedure-name {
-            color: #67574A;
-            font-weight: 600;
-        }
-        .cta-section {
-            text-align: center;
-            margin: 35px 0;
-        }
-        .cta-button {
-            display: inline-block;
-            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
-            color: white;
-            text-decoration: none;
-            padding: 15px 35px;
-            border-radius: 50px;
-            font-weight: 600;
-            font-size: 16px;
-            letter-spacing: 0.5px;
-            transition: transform 0.3s ease;
-            box-shadow: 0 8px 25px rgba(164, 138, 118, 0.3);
-        }
-        .cta-button:hover {
-            transform: translateY(-2px);
-        }
-        .footer {
-            background: #f8f9fa;
-            padding: 25px 30px;
-            text-align: center;
-            color: #666;
-            font-size: 14px;
-            border-top: 1px solid #eee;
-        }
-        .logo {
-            font-size: 24px;
-            font-weight: 700;
-            color: white;
-            margin-bottom: 5px;
-        }
-        .divider {
-            height: 2px;
-            background: linear-gradient(90deg, #a48a76, #67574A);
-            margin: 25px 0;
-            border-radius: 1px;
-        }
-    </style>
-</head>
-<body>
-    <div class="email-container">
-        <div class="header">
-            <div class="logo">MetaEstetics</div>
-            <h1>New Appointment Request</h1>
-            <div class="subtitle">Requires Your Attention</div>
-        </div>
-        <div class="content">
-            <div class="greeting">
-                Dear <strong>{{clinicName}}</strong> Team,
-            </div>
-            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 25px;">
-                We hope this message finds you well. You have received a new appointment request that requires your review and confirmation.
-            </p>
-            <div class="appointment-card">
-                <div class="appointment-title">📅 Appointment Details</div>
-                <div class="appointment-details">
-                    <div class="detail-row">
-                        <div class="detail-label">Patient:</div>
-                        <div class="detail-value patient-name">{{patientName}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Procedure:</div>
-                        <div class="detail-value procedure-name">{{procedureName}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Date:</div>
-                        <div class="detail-value">{{appointmentDate}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Time:</div>
-                        <div class="detail-value">{{appointmentTime}}</div>
-                    </div>
-                    <div class="detail-row">
-                        <div class="detail-label">Practitioner:</div>
-                        <div class="detail-value">{{practitionerName}}</div>
-                    </div>
-                </div>
-            </div>
-            <div class="divider"></div>
-            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 30px;">
-                Please review this appointment request and confirm availability in your admin panel. The patient is waiting for your confirmation to finalize their booking.
-            </p>
-            <div class="cta-section">
-                <a href="#" class="cta-button">Review & Confirm Appointment</a>
-            </div>
-        </div>
-        <div class="footer">
-            <p style="margin: 0 0 10px 0;">
-                <strong>MetaEstetics</strong> - Premium Aesthetic Services
-            </p>
-            <p style="margin: 0; font-size: 12px; color: #999;">
-                This is an automated message. Please do not reply to this email.
-            </p>
-        </div>
-    </div>
-</body>
-</html>
-`;
-// --- Interface Definitions for Email Data ---
-export interface AppointmentEmailDataBase {
-  appointment: Appointment;
-  options?: {
-    customSubject?: string;
-    fromAddress?: string;
-    mailgunDomain?: string;
-  };
-}
-export interface AppointmentConfirmationEmailData extends AppointmentEmailDataBase {
-  recipientProfile: PatientProfileInfo | PractitionerProfileInfo;
-  recipientRole: 'patient' | 'practitioner';
-}
-export interface AppointmentRequestedEmailData extends AppointmentEmailDataBase {
-  clinicProfile: ClinicInfo;
-}
-export interface AppointmentCancellationEmailData extends AppointmentEmailDataBase {
-  recipientProfile: PatientProfileInfo | PractitionerProfileInfo;
-  recipientRole: 'patient' | 'practitioner';
-  cancellationReason?: string;
-}
-export interface AppointmentRescheduledProposalEmailData extends AppointmentEmailDataBase {
-  patientProfile: PatientProfileInfo;
-  previousStartTime: admin.firestore.Timestamp;
-  previousEndTime: admin.firestore.Timestamp;
-}
-export interface ReviewRequestEmailData extends AppointmentEmailDataBase {
-  patientProfile: PatientProfileInfo;
-  reviewLink: string;
-}
-export interface ReviewAddedEmailData extends AppointmentEmailDataBase {
-  recipientProfile: PractitionerProfileInfo | ClinicInfo;
-  recipientRole: 'practitioner' | 'clinic';
-  reviewerName: string;
-  reviewRating: number;
-  reviewComment?: string;
-}
-/**
- * Service for sending appointment-related emails.
- */
-export class AppointmentMailingService extends BaseMailingService {
-  private readonly DEFAULT_MAILGUN_DOMAIN = 'mg.metaesthetics.net';
-  constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient) {
-    super(firestore, mailgunClient);
-    Logger.info('[AppointmentMailingService] Initialized.');
-  }
-  /**
-   * Formats a Firestore Timestamp in the clinic's timezone
-   * @param timestamp - Firestore Timestamp (UTC)
-   * @param clinicTimezone - IANA timezone string (e.g., "Europe/Zurich")
-   * @param format - Format type: 'date', 'time', or 'datetime'
-   * @returns Formatted string in clinic's local timezone
-   */
-  private formatTimestampInClinicTimezone(
-    timestamp: admin.firestore.Timestamp,
-    clinicTimezone: string,
-    format: 'date' | 'time' | 'datetime' = 'datetime',
-  ): string {
-    try {
-      // Convert UTC timestamp to clinic's timezone
-      const dateTimeInClinicTz = DateTime.fromMillis(timestamp.toMillis(), {
-        zone: clinicTimezone,
-      });
-      // Format based on requested type
-      switch (format) {
-        case 'date':
-          // Format: "Monday, November 5, 2025"
-          return dateTimeInClinicTz.toLocaleString(DateTime.DATE_FULL);
-        case 'time':
-          // Format: "2:30 PM"
-          return dateTimeInClinicTz.toLocaleString(DateTime.TIME_SIMPLE);
-        case 'datetime':
-          // Format: "Monday, November 5, 2025 at 2:30 PM"
-          return dateTimeInClinicTz.toLocaleString(DateTime.DATETIME_FULL);
-        default:
-          return dateTimeInClinicTz.toLocaleString(DateTime.DATETIME_FULL);
-      }
-    } catch (error) {
-      Logger.error('[AppointmentMailingService] Error formatting timestamp in clinic timezone:', {
-        error: error instanceof Error ? error.message : String(error),
-        clinicTimezone,
-      });
-      // Fallback to UTC formatting if timezone conversion fails
-      return timestamp.toDate().toLocaleString();
-    }
-  }
-  /**
-   * Gets a user-friendly display name for a timezone
-   * @param timezone - IANA timezone string (e.g., "Europe/Zurich")
-   * @returns User-friendly timezone name (e.g., "Clinic Time - Europe/Zurich")
-   */
-  private getTimezoneDisplayName(timezone: string): string {
-    try {
-      // For common timezones, provide a more readable format
-      const timezoneMap: Record<string, string> = {
-        'Europe/Zurich': 'Clinic Time - Central European Time',
-        'Europe/London': 'Clinic Time - GMT/BST',
-        'America/New_York': 'Clinic Time - Eastern Time',
-        'America/Los_Angeles': 'Clinic Time - Pacific Time',
-        'Asia/Dubai': 'Clinic Time - Gulf Standard Time',
-        'Asia/Karachi': 'Clinic Time - Pakistan Standard Time',
-        'Asia/Kolkata': 'Clinic Time - India Standard Time',
-        'Australia/Sydney': 'Clinic Time - Australian Eastern Time',
-      };
-      // Return mapped name if available, otherwise use the IANA timezone
-      return timezoneMap[timezone] || `Clinic Time - ${timezone}`;
-    } catch (error) {
-      Logger.error('[AppointmentMailingService] Error getting timezone display name:', {
-        error: error instanceof Error ? error.message : String(error),
-        timezone,
-      });
-      return `Clinic Time - ${timezone}`;
-    }
-  }
-  async sendAppointmentConfirmedEmail(data: AppointmentConfirmationEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Preparing to send appointment confirmation email to ${data.recipientRole}: ${data.recipientProfile.id}`,
-    );
-    const recipientEmail = data.recipientProfile.email;
-    if (!recipientEmail) {
-      Logger.error('[AppointmentMailingService] Recipient email not found for confirmation.', {
-        recipientId: data.recipientProfile.id,
-        role: data.recipientRole,
-      });
-      throw new Error('Recipient email address is missing.');
-    }
-    // Get clinic timezone from appointment data, default to UTC if not available
-    const clinicTimezone = data.appointment.clinic_tz || 'UTC';
-    Logger.debug('[AppointmentMailingService] Formatting appointment time', {
-      clinicTimezone,
-      utcTime: data.appointment.appointmentStartTime.toDate().toISOString(),
-    });
-    // Format time with timezone label for clarity
-    const formattedTime = this.formatTimestampInClinicTimezone(
-      data.appointment.appointmentStartTime,
-      clinicTimezone,
-      'time',
-    );
-    const timezoneName = this.getTimezoneDisplayName(clinicTimezone);
-    const templateVariables = {
-      patientName: data.appointment.patientInfo.fullName,
-      procedureName: data.appointment.procedureInfo.name,
-      appointmentDate: this.formatTimestampInClinicTimezone(
-        data.appointment.appointmentStartTime,
-        clinicTimezone,
-        'date',
-      ),
-      appointmentTime: `${formattedTime} (${timezoneName})`,
-      practitionerName: data.appointment.practitionerInfo.name,
-      clinicName: data.appointment.clinicInfo.name,
-    };
-    const html = this.renderTemplate(patientAppointmentConfirmedTemplate, templateVariables);
-    const subject = data.options?.customSubject || 'Your Appointment is Confirmed!';
-    const fromAddress =
-      data.options?.fromAddress ||
-      `MetaEstetics <no-reply@${data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN}>`;
-    const domainToSendFrom = data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
-    const mailgunSendData = {
-      to: recipientEmail,
-      from: fromAddress,
-      subject,
-      html,
-    };
-    try {
-      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
-      await this.logEmailAttempt(
-        { to: recipientEmail, subject, templateName: 'appointment_confirmed' },
-        true,
-      );
-      return result;
-    } catch (error) {
-      await this.logEmailAttempt(
-        {
-          to: recipientEmail,
-          subject: data.options?.customSubject || 'Your Appointment is Confirmed!',
-          templateName: 'appointment_confirmed',
-        },
-        false,
-        error,
-      );
-      throw error;
-    }
-  }
-  async sendAppointmentRequestedEmailToClinic(data: AppointmentRequestedEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Preparing to send appointment requested email to clinic: ${data.clinicProfile.id}`,
-    );
-    const clinicEmail = data.clinicProfile.contactInfo?.email;
-    if (!clinicEmail) {
-      Logger.error(
-        '[AppointmentMailingService] Clinic contact email not found for request notification.',
-        { clinicId: data.clinicProfile.id },
-      );
-      throw new Error('Clinic contact email address is missing.');
-    }
-    // Get clinic timezone from appointment data, default to UTC if not available
-    const clinicTimezone = data.appointment.clinic_tz || 'UTC';
-    Logger.debug('[AppointmentMailingService] Formatting appointment time for clinic', {
-      clinicTimezone,
-      utcTime: data.appointment.appointmentStartTime.toDate().toISOString(),
-    });
-    // Format time with timezone label for clarity
-    const formattedTime = this.formatTimestampInClinicTimezone(
-      data.appointment.appointmentStartTime,
-      clinicTimezone,
-      'time',
-    );
-    const timezoneName = this.getTimezoneDisplayName(clinicTimezone);
-    const templateVariables = {
-      clinicName: data.clinicProfile.name,
-      patientName: data.appointment.patientInfo.fullName,
-      procedureName: data.appointment.procedureInfo.name,
-      appointmentDate: this.formatTimestampInClinicTimezone(
-        data.appointment.appointmentStartTime,
-        clinicTimezone,
-        'date',
-      ),
-      appointmentTime: `${formattedTime} (${timezoneName})`,
-      practitionerName: data.appointment.practitionerInfo.name,
-    };
-    const html = this.renderTemplate(clinicAppointmentRequestedTemplate, templateVariables);
-    const subject = data.options?.customSubject || 'New Appointment Request Received';
-    const fromAddress =
-      data.options?.fromAddress ||
-      `MetaEstetics <no-reply@${data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN}>`;
-    const domainToSendFrom = data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
-    const mailgunSendData = {
-      to: clinicEmail,
-      from: fromAddress,
-      subject,
-      html,
-    };
-    try {
-      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
-      await this.logEmailAttempt(
-        {
-          to: clinicEmail,
-          subject,
-          templateName: 'appointment_requested_clinic',
-        },
-        true,
-      );
-      return result;
-    } catch (error) {
-      await this.logEmailAttempt(
-        {
-          to: clinicEmail,
-          subject: data.options?.customSubject || 'New Appointment Request Received',
-          templateName: 'appointment_requested_clinic',
-        },
-        false,
-        error,
-      );
-      throw error;
-    }
-  }
-  async sendAppointmentCancelledEmail(data: AppointmentCancellationEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Placeholder for sendAppointmentCancelledEmail for ${data.recipientRole}: ${data.recipientProfile.id}`,
-    );
-    return Promise.resolve();
-  }
-  async sendAppointmentRescheduledProposalEmail(
-    data: AppointmentRescheduledProposalEmailData,
-  ): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Placeholder for sendAppointmentRescheduledProposalEmail to patient: ${data.patientProfile.id}`,
-    );
-    return Promise.resolve();
-  }
-  async sendReviewRequestEmail(data: ReviewRequestEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Placeholder for sendReviewRequestEmail to patient: ${data.patientProfile.id}`,
-    );
-    return Promise.resolve();
-  }
-  async sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Placeholder for sendReviewAddedEmail to ${data.recipientRole}: ${data.recipientProfile.id}`,
-    );
-    return Promise.resolve();
-  }
-}
+import * as admin from 'firebase-admin';
+import { DateTime } from 'luxon';
+import { BaseMailingService, NewMailgunClient } from '../base.mailing.service';
+import { Logger } from '../../logger';
+import { Appointment } from '../../../types/appointment';
+import { PatientProfile } from '../../../types/patient';
+import { Practitioner } from '../../../types/practitioner';
+import { Clinic } from '../../../types/clinic';
+import { UserRole } from '../../../types';
+import { PractitionerProfileInfo, PatientProfileInfo, ClinicInfo } from '../../../types/profile';
+// Simple string literals for placeholders, to be replaced by file loading later
+const patientAppointmentConfirmedTemplate = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Appointment Confirmed</title>
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
+            min-height: 100vh;
+        }
+        .email-container {
+            max-width: 600px;
+            margin: 0 auto;
+            background: #ffffff;
+            border-radius: 20px;
+            overflow: hidden;
+            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
+            margin-top: 40px;
+            margin-bottom: 40px;
+        }
+        .header {
+            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
+            padding: 40px 30px;
+            text-align: center;
+            color: white;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 28px;
+            font-weight: 300;
+            letter-spacing: 1px;
+        }
+        .header .subtitle {
+            margin: 10px 0 0 0;
+            font-size: 16px;
+            opacity: 0.9;
+            font-weight: 300;
+        }
+        .content {
+            padding: 40px 30px;
+        }
+        .greeting {
+            font-size: 18px;
+            color: #333;
+            margin-bottom: 25px;
+            font-weight: 400;
+        }
+        .appointment-card {
+            background: linear-gradient(135deg, #f8f6f5 0%, #f5f3f2 100%);
+            border-radius: 15px;
+            padding: 30px;
+            margin: 25px 0;
+            border-left: 5px solid #a48a76;
+        }
+        .appointment-title {
+            font-size: 20px;
+            color: #a48a76;
+            margin-bottom: 20px;
+            font-weight: 600;
+        }
+        .appointment-details {
+            display: grid;
+            gap: 15px;
+        }
+        .detail-row {
+            display: flex;
+            align-items: center;
+            padding: 8px 0;
+        }
+        .detail-label {
+            font-weight: 600;
+            color: #555;
+            min-width: 120px;
+            font-size: 14px;
+        }
+        .detail-value {
+            color: #333;
+            font-size: 16px;
+            font-weight: 500;
+        }
+        .procedure-name {
+            color: #67574A;
+            font-weight: 600;
+        }
+        .clinic-name {
+            color: #a48a76;
+            font-weight: 600;
+        }
+        .success-icon {
+            text-align: center;
+            margin: 20px 0;
+            font-size: 48px;
+        }
+        .footer {
+            background: #f8f9fa;
+            padding: 25px 30px;
+            text-align: center;
+            color: #666;
+            font-size: 14px;
+            border-top: 1px solid #eee;
+        }
+        .logo {
+            font-size: 24px;
+            font-weight: 700;
+            color: white;
+            margin-bottom: 5px;
+        }
+        .divider {
+            height: 2px;
+            background: linear-gradient(90deg, #a48a76, #67574A);
+            margin: 25px 0;
+            border-radius: 1px;
+        }
+        .thank-you {
+            background: linear-gradient(135deg, #f0ede8 0%, #ebe6e0 100%);
+            border-radius: 15px;
+            padding: 25px;
+            margin: 25px 0;
+            text-align: center;
+            border-left: 5px solid #4CAF50;
+        }
+    </style>
+</head>
+<body>
+    <div class="email-container">
+        <div class="header">
+            <div class="logo">MetaEstetics</div>
+            <h1>Appointment Confirmed</h1>
+            <div class="subtitle">Your Beauty Journey Awaits</div>
+        </div>
+        <div class="content">
+            <div class="success-icon">✨</div>
+            <div class="greeting">
+                Dear <strong>{{patientName}}</strong>,
+            </div>
+            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 25px;">
+                We're delighted to confirm your appointment! Your journey to enhanced beauty and confidence is just around the corner.
+            </p>
+            <div class="appointment-card">
+                <div class="appointment-title">📅 Your Appointment Details</div>
+                <div class="appointment-details">
+                    <div class="detail-row">
+                        <div class="detail-label">Procedure:</div>
+                        <div class="detail-value procedure-name">{{procedureName}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Date:</div>
+                        <div class="detail-value">{{appointmentDate}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Time:</div>
+                        <div class="detail-value">{{appointmentTime}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Practitioner:</div>
+                        <div class="detail-value">{{practitionerName}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Location:</div>
+                        <div class="detail-value clinic-name">{{clinicName}}</div>
+                    </div>
+                </div>
+            </div>
+            <div class="divider"></div>
+            <div class="thank-you">
+                <h3 style="margin: 0 0 10px 0; color: #4caf50; font-weight: 600;">Thank You for Choosing MetaEstetics!</h3>
+                <p style="margin: 0; color: #555; font-size: 14px;">
+                    We look forward to providing you with exceptional care and outstanding results.
+                </p>
+            </div>
+            <p style="color: #555; font-size: 14px; line-height: 1.6; margin-top: 25px;">
+                <strong>Important:</strong> Please arrive 15 minutes early for your appointment. If you need to reschedule or have any questions, please contact us as soon as possible.
+            </p>
+        </div>
+        <div class="footer">
+            <p style="margin: 0 0 10px 0;">
+                <strong>MetaEstetics</strong> - Premium Aesthetic Services
+            </p>
+            <p style="margin: 0; font-size: 12px; color: #999;">
+                This is an automated message. Please do not reply to this email.
+            </p>
+        </div>
+    </div>
+</body>
+</html>
+`;
+const clinicAppointmentRequestedTemplate = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>New Appointment Request</title>
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
+            min-height: 100vh;
+        }
+        .email-container {
+            max-width: 600px;
+            margin: 0 auto;
+            background: #ffffff;
+            border-radius: 20px;
+            overflow: hidden;
+            box-shadow: 0 20px 40px rgba(0, 0, 0, 0.1);
+            margin-top: 40px;
+            margin-bottom: 40px;
+        }
+        .header {
+            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
+            padding: 40px 30px;
+            text-align: center;
+            color: white;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 28px;
+            font-weight: 300;
+            letter-spacing: 1px;
+        }
+        .header .subtitle {
+            margin: 10px 0 0 0;
+            font-size: 16px;
+            opacity: 0.9;
+            font-weight: 300;
+        }
+        .content {
+            padding: 40px 30px;
+        }
+        .greeting {
+            font-size: 18px;
+            color: #333;
+            margin-bottom: 25px;
+            font-weight: 400;
+        }
+        .appointment-card {
+            background: linear-gradient(135deg, #f8f6f5 0%, #f5f3f2 100%);
+            border-radius: 15px;
+            padding: 30px;
+            margin: 25px 0;
+            border-left: 5px solid #a48a76;
+        }
+        .appointment-title {
+            font-size: 20px;
+            color: #a48a76;
+            margin-bottom: 20px;
+            font-weight: 600;
+        }
+        .appointment-details {
+            display: grid;
+            gap: 15px;
+        }
+        .detail-row {
+            display: flex;
+            align-items: center;
+            padding: 8px 0;
+        }
+        .detail-label {
+            font-weight: 600;
+            color: #555;
+            min-width: 120px;
+            font-size: 14px;
+        }
+        .detail-value {
+            color: #333;
+            font-size: 16px;
+            font-weight: 500;
+        }
+        .patient-name {
+            color: #a48a76;
+            font-weight: 600;
+        }
+        .procedure-name {
+            color: #67574A;
+            font-weight: 600;
+        }
+        .cta-section {
+            text-align: center;
+            margin: 35px 0;
+        }
+        .cta-button {
+            display: inline-block;
+            background: linear-gradient(135deg, #a48a76 0%, #67574A 100%);
+            color: white;
+            text-decoration: none;
+            padding: 15px 35px;
+            border-radius: 50px;
+            font-weight: 600;
+            font-size: 16px;
+            letter-spacing: 0.5px;
+            transition: transform 0.3s ease;
+            box-shadow: 0 8px 25px rgba(164, 138, 118, 0.3);
+        }
+        .cta-button:hover {
+            transform: translateY(-2px);
+        }
+        .footer {
+            background: #f8f9fa;
+            padding: 25px 30px;
+            text-align: center;
+            color: #666;
+            font-size: 14px;
+            border-top: 1px solid #eee;
+        }
+        .logo {
+            font-size: 24px;
+            font-weight: 700;
+            color: white;
+            margin-bottom: 5px;
+        }
+        .divider {
+            height: 2px;
+            background: linear-gradient(90deg, #a48a76, #67574A);
+            margin: 25px 0;
+            border-radius: 1px;
+        }
+    </style>
+</head>
+<body>
+    <div class="email-container">
+        <div class="header">
+            <div class="logo">MetaEstetics</div>
+            <h1>New Appointment Request</h1>
+            <div class="subtitle">Requires Your Attention</div>
+        </div>
+        <div class="content">
+            <div class="greeting">
+                Dear <strong>{{clinicName}}</strong> Team,
+            </div>
+            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 25px;">
+                We hope this message finds you well. You have received a new appointment request that requires your review and confirmation.
+            </p>
+            <div class="appointment-card">
+                <div class="appointment-title">📅 Appointment Details</div>
+                <div class="appointment-details">
+                    <div class="detail-row">
+                        <div class="detail-label">Patient:</div>
+                        <div class="detail-value patient-name">{{patientName}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Procedure:</div>
+                        <div class="detail-value procedure-name">{{procedureName}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Date:</div>
+                        <div class="detail-value">{{appointmentDate}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Time:</div>
+                        <div class="detail-value">{{appointmentTime}}</div>
+                    </div>
+                    <div class="detail-row">
+                        <div class="detail-label">Practitioner:</div>
+                        <div class="detail-value">{{practitionerName}}</div>
+                    </div>
+                </div>
+            </div>
+            <div class="divider"></div>
+            <p style="color: #555; font-size: 16px; line-height: 1.6; margin-bottom: 30px;">
+                Please review this appointment request and confirm availability in your admin panel. The patient is waiting for your confirmation to finalize their booking.
+            </p>
+            <div class="cta-section">
+                <a href="#" class="cta-button">Review & Confirm Appointment</a>
+            </div>
+        </div>
+        <div class="footer">
+            <p style="margin: 0 0 10px 0;">
+                <strong>MetaEstetics</strong> - Premium Aesthetic Services
+            </p>
+            <p style="margin: 0; font-size: 12px; color: #999;">
+                This is an automated message. Please do not reply to this email.
+            </p>
+        </div>
+    </div>
+</body>
+</html>
+`;
+// --- Interface Definitions for Email Data ---
+export interface AppointmentEmailDataBase {
+  appointment: Appointment;
+  options?: {
+    customSubject?: string;
+    fromAddress?: string;
+    mailgunDomain?: string;
+  };
+}
+export interface AppointmentConfirmationEmailData extends AppointmentEmailDataBase {
+  recipientProfile: PatientProfileInfo | PractitionerProfileInfo;
+  recipientRole: 'patient' | 'practitioner';
+}
+export interface AppointmentRequestedEmailData extends AppointmentEmailDataBase {
+  clinicProfile: ClinicInfo;
+}
+export interface AppointmentCancellationEmailData extends AppointmentEmailDataBase {
+  recipientProfile: PatientProfileInfo | PractitionerProfileInfo;
+  recipientRole: 'patient' | 'practitioner';
+  cancellationReason?: string;
+}
+export interface AppointmentRescheduledProposalEmailData extends AppointmentEmailDataBase {
+  patientProfile: PatientProfileInfo;
+  previousStartTime: admin.firestore.Timestamp;
+  previousEndTime: admin.firestore.Timestamp;
+}
+export interface ReviewRequestEmailData extends AppointmentEmailDataBase {
+  patientProfile: PatientProfileInfo;
+  reviewLink: string;
+}
+export interface ReviewAddedEmailData extends AppointmentEmailDataBase {
+  recipientProfile: PractitionerProfileInfo | ClinicInfo;
+  recipientRole: 'practitioner' | 'clinic';
+  reviewerName: string;
+  reviewRating: number;
+  reviewComment?: string;
+}
+/**
+ * Service for sending appointment-related emails.
+ */
+export class AppointmentMailingService extends BaseMailingService {
+  private readonly DEFAULT_MAILGUN_DOMAIN = 'mg.metaesthetics.net';
+  constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient) {
+    super(firestore, mailgunClient);
+    Logger.info('[AppointmentMailingService] Initialized.');
+  }
+  /**
+   * Formats a Firestore Timestamp in the clinic's timezone
+   * @param timestamp - Firestore Timestamp (UTC)
+   * @param clinicTimezone - IANA timezone string (e.g., "Europe/Zurich")
+   * @param format - Format type: 'date', 'time', or 'datetime'
+   * @returns Formatted string in clinic's local timezone
+   */
+  private formatTimestampInClinicTimezone(
+    timestamp: admin.firestore.Timestamp,
+    clinicTimezone: string,
+    format: 'date' | 'time' | 'datetime' = 'datetime',
+  ): string {
+    try {
+      // Convert UTC timestamp to clinic's timezone
+      const dateTimeInClinicTz = DateTime.fromMillis(timestamp.toMillis(), {
+        zone: clinicTimezone,
+      });
+      // Format based on requested type
+      switch (format) {
+        case 'date':
+          // Format: "Monday, November 5, 2025"
+          return dateTimeInClinicTz.toLocaleString(DateTime.DATE_FULL);
+        case 'time':
+          // Format: "2:30 PM"
+          return dateTimeInClinicTz.toLocaleString(DateTime.TIME_SIMPLE);
+        case 'datetime':
+          // Format: "Monday, November 5, 2025 at 2:30 PM"
+          return dateTimeInClinicTz.toLocaleString(DateTime.DATETIME_FULL);
+        default:
+          return dateTimeInClinicTz.toLocaleString(DateTime.DATETIME_FULL);
+      }
+    } catch (error) {
+      Logger.error('[AppointmentMailingService] Error formatting timestamp in clinic timezone:', {
+        error: error instanceof Error ? error.message : String(error),
+        clinicTimezone,
+      });
+      // Fallback to UTC formatting if timezone conversion fails
+      return timestamp.toDate().toLocaleString();
+    }
+  }
+  /**
+   * Gets a user-friendly display name for a timezone
+   * @param timezone - IANA timezone string (e.g., "Europe/Zurich")
+   * @returns User-friendly timezone name (e.g., "Clinic Time - Europe/Zurich")
+   */
+  private getTimezoneDisplayName(timezone: string): string {
+    try {
+      // For common timezones, provide a more readable format
+      const timezoneMap: Record<string, string> = {
+        'Europe/Zurich': 'Clinic Time - Central European Time',
+        'Europe/London': 'Clinic Time - GMT/BST',
+        'America/New_York': 'Clinic Time - Eastern Time',
+        'America/Los_Angeles': 'Clinic Time - Pacific Time',
+        'Asia/Dubai': 'Clinic Time - Gulf Standard Time',
+        'Asia/Karachi': 'Clinic Time - Pakistan Standard Time',
+        'Asia/Kolkata': 'Clinic Time - India Standard Time',
+        'Australia/Sydney': 'Clinic Time - Australian Eastern Time',
+      };
+      // Return mapped name if available, otherwise use the IANA timezone
+      return timezoneMap[timezone] || `Clinic Time - ${timezone}`;
+    } catch (error) {
+      Logger.error('[AppointmentMailingService] Error getting timezone display name:', {
+        error: error instanceof Error ? error.message : String(error),
+        timezone,
+      });
+      return `Clinic Time - ${timezone}`;
+    }
+  }
+  async sendAppointmentConfirmedEmail(data: AppointmentConfirmationEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Preparing to send appointment confirmation email to ${data.recipientRole}: ${data.recipientProfile.id}`,
+    );
+    const recipientEmail = data.recipientProfile.email;
+    if (!recipientEmail) {
+      Logger.error('[AppointmentMailingService] Recipient email not found for confirmation.', {
+        recipientId: data.recipientProfile.id,
+        role: data.recipientRole,
+      });
+      throw new Error('Recipient email address is missing.');
+    }
+    // Get clinic timezone from appointment data, default to UTC if not available
+    const clinicTimezone = data.appointment.clinic_tz || 'UTC';
+    Logger.debug('[AppointmentMailingService] Formatting appointment time', {
+      clinicTimezone,
+      utcTime: data.appointment.appointmentStartTime.toDate().toISOString(),
+    });
+    // Format time with timezone label for clarity
+    const formattedTime = this.formatTimestampInClinicTimezone(
+      data.appointment.appointmentStartTime,
+      clinicTimezone,
+      'time',
+    );
+    const timezoneName = this.getTimezoneDisplayName(clinicTimezone);
+    const templateVariables = {
+      patientName: data.appointment.patientInfo.fullName,
+      procedureName: data.appointment.procedureInfo.name,
+      appointmentDate: this.formatTimestampInClinicTimezone(
+        data.appointment.appointmentStartTime,
+        clinicTimezone,
+        'date',
+      ),
+      appointmentTime: `${formattedTime} (${timezoneName})`,
+      practitionerName: data.appointment.practitionerInfo.name,
+      clinicName: data.appointment.clinicInfo.name,
+    };
+    const html = this.renderTemplate(patientAppointmentConfirmedTemplate, templateVariables);
+    const subject = data.options?.customSubject || 'Your Appointment is Confirmed!';
+    const fromAddress =
+      data.options?.fromAddress ||
+      `MetaEstetics <no-reply@${data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN}>`;
+    const domainToSendFrom = data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
+    const mailgunSendData = {
+      to: recipientEmail,
+      from: fromAddress,
+      subject,
+      html,
+    };
+    try {
+      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
+      await this.logEmailAttempt(
+        { to: recipientEmail, subject, templateName: 'appointment_confirmed' },
+        true,
+      );
+      return result;
+    } catch (error) {
+      await this.logEmailAttempt(
+        {
+          to: recipientEmail,
+          subject: data.options?.customSubject || 'Your Appointment is Confirmed!',
+          templateName: 'appointment_confirmed',
+        },
+        false,
+        error,
+      );
+      throw error;
+    }
+  }
+  async sendAppointmentRequestedEmailToClinic(data: AppointmentRequestedEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Preparing to send appointment requested email to clinic: ${data.clinicProfile.id}`,
+    );
+    const clinicEmail = data.clinicProfile.contactInfo?.email;
+    if (!clinicEmail) {
+      Logger.error(
+        '[AppointmentMailingService] Clinic contact email not found for request notification.',
+        { clinicId: data.clinicProfile.id },
+      );
+      throw new Error('Clinic contact email address is missing.');
+    }
+    // Get clinic timezone from appointment data, default to UTC if not available
+    const clinicTimezone = data.appointment.clinic_tz || 'UTC';
+    Logger.debug('[AppointmentMailingService] Formatting appointment time for clinic', {
+      clinicTimezone,
+      utcTime: data.appointment.appointmentStartTime.toDate().toISOString(),
+    });
+    // Format time with timezone label for clarity
+    const formattedTime = this.formatTimestampInClinicTimezone(
+      data.appointment.appointmentStartTime,
+      clinicTimezone,
+      'time',
+    );
+    const timezoneName = this.getTimezoneDisplayName(clinicTimezone);
+    const templateVariables = {
+      clinicName: data.clinicProfile.name,
+      patientName: data.appointment.patientInfo.fullName,
+      procedureName: data.appointment.procedureInfo.name,
+      appointmentDate: this.formatTimestampInClinicTimezone(
+        data.appointment.appointmentStartTime,
+        clinicTimezone,
+        'date',
+      ),
+      appointmentTime: `${formattedTime} (${timezoneName})`,
+      practitionerName: data.appointment.practitionerInfo.name,
+    };
+    const html = this.renderTemplate(clinicAppointmentRequestedTemplate, templateVariables);
+    const subject = data.options?.customSubject || 'New Appointment Request Received';
+    const fromAddress =
+      data.options?.fromAddress ||
+      `MetaEstetics <no-reply@${data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN}>`;
+    const domainToSendFrom = data.options?.mailgunDomain || this.DEFAULT_MAILGUN_DOMAIN;
+    const mailgunSendData = {
+      to: clinicEmail,
+      from: fromAddress,
+      subject,
+      html,
+    };
+    try {
+      const result = await this.sendEmail(domainToSendFrom, mailgunSendData);
+      await this.logEmailAttempt(
+        {
+          to: clinicEmail,
+          subject,
+          templateName: 'appointment_requested_clinic',
+        },
+        true,
+      );
+      return result;
+    } catch (error) {
+      await this.logEmailAttempt(
+        {
+          to: clinicEmail,
+          subject: data.options?.customSubject || 'New Appointment Request Received',
+          templateName: 'appointment_requested_clinic',
+        },
+        false,
+        error,
+      );
+      throw error;
+    }
+  }
+  async sendAppointmentCancelledEmail(data: AppointmentCancellationEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Placeholder for sendAppointmentCancelledEmail for ${data.recipientRole}: ${data.recipientProfile.id}`,
+    );
+    return Promise.resolve();
+  }
+  async sendAppointmentRescheduledProposalEmail(
+    data: AppointmentRescheduledProposalEmailData,
+  ): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Placeholder for sendAppointmentRescheduledProposalEmail to patient: ${data.patientProfile.id}`,
+    );
+    return Promise.resolve();
+  }
+  async sendReviewRequestEmail(data: ReviewRequestEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Placeholder for sendReviewRequestEmail to patient: ${data.patientProfile.id}`,
+    );
+    return Promise.resolve();
+  }
+  async sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Placeholder for sendReviewAddedEmail to ${data.recipientRole}: ${data.recipientProfile.id}`,
+    );
+    return Promise.resolve();
+  }
+}