npm - @blackcode_sa/metaestetics-api - Versions diffs - 1.15.16 → 1.15.17-staging.0 - Mend

@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.0

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

package/dist/admin/index.d.mts +377 -222
package/dist/admin/index.d.ts +377 -222
package/dist/admin/index.js +625 -206
package/dist/admin/index.mjs +624 -206
package/dist/backoffice/index.d.mts +24 -0
package/dist/backoffice/index.d.ts +24 -0
package/dist/index.d.mts +292 -4
package/dist/index.d.ts +292 -4
package/dist/index.js +1142 -630
package/dist/index.mjs +1137 -617
package/package.json +2 -1
package/src/__mocks__/firstore.ts +10 -10
package/src/admin/aggregation/README.md +79 -79
package/src/admin/aggregation/appointment/README.md +151 -129
package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +2137 -2091
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 +966 -966
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 +689 -689
package/src/admin/analytics/analytics.admin.service.ts +278 -278
package/src/admin/analytics/index.ts +2 -2
package/src/admin/booking/README.md +184 -125
package/src/admin/booking/booking.admin.ts +1330 -1073
package/src/admin/booking/booking.calculator.ts +850 -712
package/src/admin/booking/booking.types.ts +76 -59
package/src/admin/booking/index.ts +3 -3
package/src/admin/booking/timezones-problem.md +185 -185
package/src/admin/calendar/README.md +62 -7
package/src/admin/calendar/calendar.admin.service.ts +345 -345
package/src/admin/calendar/index.ts +2 -1
package/src/admin/calendar/resource-calendar.admin.ts +198 -0
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 +83 -83
package/src/admin/logger/index.ts +78 -78
package/src/admin/mailing/README.md +139 -139
package/src/admin/mailing/appointment/appointment.mailing.service.ts +1253 -1253
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/clinicWelcome/clinicWelcome.mailing.ts +292 -292
package/src/admin/mailing/clinicWelcome/index.ts +1 -1
package/src/admin/mailing/clinicWelcome/templates/welcome.template.ts +225 -225
package/src/admin/mailing/index.ts +5 -5
package/src/admin/mailing/patientInvite/index.ts +2 -2
package/src/admin/mailing/patientInvite/patientInvite.mailing.ts +415 -415
package/src/admin/mailing/patientInvite/templates/invitation.template.ts +105 -105
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 +818 -818
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 +57 -57
package/src/backoffice/services/analytics.service.proposal.md +863 -863
package/src/backoffice/services/analytics.service.summary.md +143 -143
package/src/backoffice/services/brand.service.ts +260 -260
package/src/backoffice/services/category.service.ts +384 -384
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 +10 -10
package/src/backoffice/services/migrate-products.ts +116 -116
package/src/backoffice/services/product.service.ts +557 -557
package/src/backoffice/services/requirement.service.ts +235 -235
package/src/backoffice/services/subcategory.service.ts +461 -461
package/src/backoffice/services/technology.service.ts +1153 -1153
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 +67 -67
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 +239 -239
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 +168 -168
package/src/backoffice/validations/index.ts +1 -1
package/src/backoffice/validations/schemas.ts +164 -164
package/src/config/__mocks__/firebase.ts +99 -99
package/src/config/firebase.ts +78 -78
package/src/config/index.ts +17 -17
package/src/config/tiers.config.ts +255 -229
package/src/errors/auth.error.ts +6 -6
package/src/errors/auth.errors.ts +211 -211
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 +298 -298
package/src/services/__tests__/auth.service.test.ts +310 -310
package/src/services/__tests__/base.service.test.ts +36 -36
package/src/services/__tests__/user.service.test.ts +530 -530
package/src/services/analytics/ARCHITECTURE.md +199 -199
package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
package/src/services/analytics/QUICK_START.md +393 -393
package/src/services/analytics/README.md +304 -304
package/src/services/analytics/SUMMARY.md +141 -141
package/src/services/analytics/TRENDS.md +380 -380
package/src/services/analytics/USAGE_GUIDE.md +518 -518
package/src/services/analytics/analytics-cloud.service.ts +222 -222
package/src/services/analytics/analytics.service.ts +2148 -2148
package/src/services/analytics/index.ts +4 -4
package/src/services/analytics/review-analytics.service.ts +941 -941
package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
package/src/services/analytics/utils/grouping.utils.ts +434 -434
package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
package/src/services/appointment/README.md +17 -17
package/src/services/appointment/appointment.service.ts +2943 -2941
package/src/services/appointment/index.ts +1 -1
package/src/services/appointment/utils/appointment.utils.ts +620 -620
package/src/services/appointment/utils/extended-procedure.utils.ts +354 -354
package/src/services/appointment/utils/form-initialization.utils.ts +516 -516
package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
package/src/services/appointment/utils/zone-management.utils.ts +468 -468
package/src/services/appointment/utils/zone-photo.utils.ts +302 -302
package/src/services/auth/auth.service.ts +1435 -1435
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 +1693 -1693
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 +676 -676
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 +265 -265
package/src/services/clinic/__tests__/clinic-group.service.test.ts +222 -222
package/src/services/clinic/__tests__/clinic.service.test.ts +302 -302
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 +720 -720
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 +1023 -1023
package/src/services/clinic/utils/filter.utils.d.ts +23 -23
package/src/services/clinic/utils/filter.utils.ts +462 -462
package/src/services/clinic/utils/index.ts +10 -10
package/src/services/clinic/utils/photos.utils.ts +188 -188
package/src/services/clinic/utils/search.utils.ts +83 -83
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 +597 -597
package/src/services/documentation-templates/index.ts +2 -2
package/src/services/index.ts +16 -15
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 +286 -286
package/src/services/patient/index.ts +2 -2
package/src/services/patient/patient.service.ts +1021 -1021
package/src/services/patient/patientRequirements.service.ts +309 -309
package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
package/src/services/patient/utils/body-assessment.utils.ts +159 -159
package/src/services/patient/utils/clinic.utils.ts +159 -159
package/src/services/patient/utils/docs.utils.ts +142 -142
package/src/services/patient/utils/hair-scalp-assessment.utils.ts +158 -158
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/pre-surgical-assessment.utils.ts +161 -161
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/skin-quality-assessment.utils.ts +160 -160
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 +2355 -2354
package/src/services/procedure/README.md +163 -163
package/src/services/procedure/index.ts +1 -1
package/src/services/procedure/procedure.service.ts +2521 -2521
package/src/services/resource/README.md +119 -0
package/src/services/resource/index.ts +1 -0
package/src/services/resource/resource.service.ts +555 -0
package/src/services/reviews/index.ts +1 -1
package/src/services/reviews/reviews.service.ts +745 -745
package/src/services/tier-enforcement.ts +240 -240
package/src/services/user/index.ts +1 -1
package/src/services/user/user.service.ts +533 -533
package/src/services/user/user.v2.service.ts +467 -467
package/src/types/analytics/analytics.types.ts +597 -597
package/src/types/analytics/grouped-analytics.types.ts +173 -173
package/src/types/analytics/index.ts +4 -4
package/src/types/analytics/stored-analytics.types.ts +137 -137
package/src/types/appointment/index.ts +524 -517
package/src/types/calendar/index.ts +261 -260
package/src/types/calendar/synced-calendar.types.ts +66 -66
package/src/types/clinic/index.ts +530 -529
package/src/types/clinic/practitioner-invite.types.ts +91 -91
package/src/types/clinic/preferences.types.ts +159 -159
package/src/types/clinic/rbac.types.ts +64 -63
package/src/types/clinic/to-do +3 -3
package/src/types/documentation-templates/index.ts +308 -308
package/src/types/index.ts +50 -47
package/src/types/notifications/README.md +77 -77
package/src/types/notifications/index.ts +300 -300
package/src/types/patient/aesthetic-analysis.types.ts +66 -66
package/src/types/patient/allergies.ts +58 -58
package/src/types/patient/body-assessment.types.ts +93 -93
package/src/types/patient/hair-scalp-assessment.types.ts +98 -98
package/src/types/patient/index.ts +279 -279
package/src/types/patient/medical-info.types.ts +152 -152
package/src/types/patient/patient-requirements.ts +92 -92
package/src/types/patient/pre-surgical-assessment.types.ts +95 -95
package/src/types/patient/skin-quality-assessment.types.ts +105 -105
package/src/types/patient/token.types.ts +61 -61
package/src/types/practitioner/index.ts +208 -208
package/src/types/procedure/index.ts +189 -183
package/src/types/profile/index.ts +39 -39
package/src/types/resource/README.md +153 -0
package/src/types/resource/index.ts +199 -0
package/src/types/reviews/index.ts +132 -132
package/src/types/tz-lookup.d.ts +4 -4
package/src/types/user/index.ts +60 -60
package/src/utils/TIMESTAMPS.md +176 -176
package/src/utils/TimestampUtils.ts +241 -241
package/src/utils/index.ts +1 -1
package/src/validations/README.md +94 -0
package/src/validations/appointment.schema.ts +589 -589
package/src/validations/calendar.schema.ts +225 -225
package/src/validations/clinic.schema.ts +494 -494
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 +21 -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/body-assessment.schema.ts +82 -82
package/src/validations/patient/hair-scalp-assessment.schema.ts +70 -70
package/src/validations/patient/medical-info.schema.ts +177 -177
package/src/validations/patient/patient-requirements.schema.ts +84 -84
package/src/validations/patient/pre-surgical-assessment.schema.ts +78 -78
package/src/validations/patient/skin-quality-assessment.schema.ts +70 -70
package/src/validations/patient/token.schema.ts +29 -29
package/src/validations/patient.schema.ts +217 -217
package/src/validations/practitioner.schema.ts +224 -224
package/src/validations/procedure-product.schema.ts +41 -41
package/src/validations/procedure.schema.ts +136 -124
package/src/validations/profile-info.schema.ts +41 -41
package/src/validations/resource.schema.ts +57 -0
package/src/validations/reviews.schema.ts +195 -195
package/src/validations/schemas.ts +109 -109
package/src/validations/shared.schema.ts +78 -78

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

@@ -1,1253 +1,1253 @@
-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>
-    <!--[if mso]>
-    <noscript>
-        <xml>
-            <o:OfficeDocumentSettings>
-                <o:PixelsPerInch>96</o:PixelsPerInch>
-            </o:OfficeDocumentSettings>
-        </xml>
-    </noscript>
-    <![endif]-->
-</head>
-<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
-    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
-        <tr>
-            <td align="center" style="padding: 40px 20px;">
-                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
-                    <!-- Header -->
-                    <tr>
-                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Confirmed Banner -->
-                    <tr>
-                        <td style="padding: 0;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #00BB38;">
-                                <tr>
-                                    <td style="padding: 20px 48px;">
-                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Appointment Confirmed</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Main Content -->
-                    <tr>
-                        <td style="padding: 40px 48px;">
-                            <!-- Greeting -->
-                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
-                                Dear {{patientName}},
-                            </p>
-                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                Your appointment has been confirmed. We look forward to seeing you.
-                            </p>
-                            <!-- Appointment Details Card -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7; border-left: 3px solid #00BB38;">
-                                <tr>
-                                    <td style="padding: 24px;">
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
-                                        <p style="margin: 0 0 20px 0; font-size: 18px; color: #67574A; font-weight: 500; font-family: Georgia, 'Times New Roman', serif;">{{procedureName}}</p>
-                                        <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                            <tr>
-                                                <td style="padding-bottom: 16px;">
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Date & Time</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentDate}}</p>
-                                                    <p style="margin: 4px 0 0 0; font-size: 14px; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentTime}}</p>
-                                                </td>
-                                            </tr>
-                                            <tr>
-                                                <td style="padding-bottom: 16px;">
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
-                                                </td>
-                                            </tr>
-                                            <tr>
-                                                <td>
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Location</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicName}}</p>
-                                                    <p style="margin: 4px 0 0 0; font-size: 13px; color: #555555; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicAddress}}</p>
-                                                </td>
-                                            </tr>
-                                        </table>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Divider -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
-                                <tr>
-                                    <td style="height: 1px; background-color: #e8e4df;"></td>
-                                </tr>
-                            </table>
-                            <!-- Important Notice -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px;">
-                                <tr>
-                                    <td style="padding: 20px 24px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
-                                        <p style="margin: 0 0 8px 0; font-size: 13px; font-weight: 600; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Before Your Visit</p>
-                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                            Please arrive 15 minutes early. If you need to reschedule or cancel, contact us through the Metaesthetics app.
-                                        </p>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Thank You -->
-                            <p style="margin: 0; font-size: 14px; color: #868686; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                Thank you for choosing {{clinicName}}. We look forward to providing you with exceptional care.
-                            </p>
-                        </td>
-                    </tr>
-                    <!-- Footer -->
-                    <tr>
-                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
-                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
-                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                </table>
-            </td>
-        </tr>
-    </table>
-</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">Metaesthetics</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>Metaesthetics</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 appointmentCancelledTemplate = `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Appointment Cancelled</title>
-    <!--[if mso]>
-    <noscript>
-        <xml>
-            <o:OfficeDocumentSettings>
-                <o:PixelsPerInch>96</o:PixelsPerInch>
-            </o:OfficeDocumentSettings>
-        </xml>
-    </noscript>
-    <![endif]-->
-</head>
-<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
-    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
-        <tr>
-            <td align="center" style="padding: 40px 20px;">
-                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
-                    <!-- Header -->
-                    <tr>
-                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Cancellation Banner -->
-                    <tr>
-                        <td style="padding: 0;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #fa003f;">
-                                <tr>
-                                    <td style="padding: 20px 48px;">
-                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Appointment Cancelled</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Main Content -->
-                    <tr>
-                        <td style="padding: 40px 48px;">
-                            <!-- Greeting -->
-                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
-                                Dear {{recipientName}},
-                            </p>
-                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                We regret to inform you that your appointment has been cancelled. Please see the details below.
-                            </p>
-                            <!-- Cancelled By Info -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px;">
-                                <tr>
-                                    <td style="padding: 16px 20px; background-color: #fef2f2; border-left: 3px solid #fa003f;">
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Cancelled By</p>
-                                        <p style="margin: 0; font-size: 15px; color: #333333; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{cancelledByDisplay}}</p>
-                                    </td>
-                                </tr>
-                            </table>
-                            {{#if cancellationReason}}
-                            <!-- Cancellation Reason -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
-                                <tr>
-                                    <td style="padding: 20px 24px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
-                                        <p style="margin: 0 0 8px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Reason</p>
-                                        <p style="margin: 0; font-size: 15px; color: #555555; line-height: 1.6; font-style: italic; font-family: Georgia, 'Times New Roman', serif;">"{{cancellationReason}}"</p>
-                                    </td>
-                                </tr>
-                            </table>
-                            {{/if}}
-                            <!-- Cancelled Appointment Details -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #f5f5f5; border-left: 3px solid #cccccc;">
-                                <tr>
-                                    <td style="padding: 24px;">
-                                        <p style="margin: 0 0 16px 0; font-size: 12px; font-weight: 600; color: #999999; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Cancelled Appointment</p>
-                                        <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                            <tr>
-                                                <td style="padding-bottom: 12px;">
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{procedureName}}</p>
-                                                </td>
-                                            </tr>
-                                            <tr>
-                                                <td style="padding-bottom: 12px;">
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Date & Time</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentDate}} at {{appointmentTime}}</p>
-                                                </td>
-                                            </tr>
-                                            <tr>
-                                                <td style="padding-bottom: 12px;">
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
-                                                </td>
-                                            </tr>
-                                            <tr>
-                                                <td>
-                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Location</p>
-                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicName}}</p>
-                                                    <p style="margin: 4px 0 0 0; font-size: 13px; color: #999999; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicAddress}}</p>
-                                                </td>
-                                            </tr>
-                                        </table>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Divider -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
-                                <tr>
-                                    <td style="height: 1px; background-color: #e8e4df;"></td>
-                                </tr>
-                            </table>
-                            <!-- Rebook Section -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px; background-color: #f0faf4; border-left: 3px solid #00BB38;">
-                                <tr>
-                                    <td style="padding: 24px;">
-                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 600; color: #00BB38; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Book a New Appointment</p>
-                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                            We'd love to see you again. Open the Metaesthetics app to browse available times and book a new appointment.
-                                        </p>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Support Info -->
-                            <p style="margin: 0; font-size: 13px; color: #868686; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                If you have any questions about this cancellation, please contact {{clinicName}} through the Metaesthetics app.
-                            </p>
-                        </td>
-                    </tr>
-                    <!-- Footer -->
-                    <tr>
-                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
-                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
-                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                </table>
-            </td>
-        </tr>
-    </table>
-</body>
-</html>
-`;
-const appointmentRescheduledProposalTemplate = `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Appointment Reschedule Request</title>
-    <!--[if mso]>
-    <noscript>
-        <xml>
-            <o:OfficeDocumentSettings>
-                <o:PixelsPerInch>96</o:PixelsPerInch>
-            </o:OfficeDocumentSettings>
-        </xml>
-    </noscript>
-    <![endif]-->
-</head>
-<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
-    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
-        <tr>
-            <td align="center" style="padding: 40px 20px;">
-                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
-                    <!-- Header -->
-                    <tr>
-                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Action Required Banner -->
-                    <tr>
-                        <td style="padding: 0;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #a48a76;">
-                                <tr>
-                                    <td style="padding: 20px 48px;">
-                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Action Required</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                    <!-- Main Content -->
-                    <tr>
-                        <td style="padding: 40px 48px;">
-                            <!-- Greeting -->
-                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
-                                Dear {{patientName}},
-                            </p>
-                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                {{clinicName}} has proposed a new time for your upcoming appointment. Please review the details below and respond at your earliest convenience.
-                            </p>
-                            <!-- Appointment Info Card -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
-                                <tr>
-                                    <td style="padding: 24px;">
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
-                                        <p style="margin: 0 0 16px 0; font-size: 18px; color: #67574A; font-weight: 500; font-family: Georgia, 'Times New Roman', serif;">{{procedureName}}</p>
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
-                                        <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Time Comparison -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
-                                <!-- Original Time (Strikethrough) -->
-                                <tr>
-                                    <td style="padding: 20px 24px; background-color: #f5f5f5; border-left: 3px solid #cccccc;">
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #999999; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Original Appointment</p>
-                                        <p style="margin: 0; font-size: 16px; color: #999999; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; text-decoration: line-through;">{{previousDate}}</p>
-                                        <p style="margin: 4px 0 0 0; font-size: 14px; color: #999999; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; text-decoration: line-through;">{{previousTime}}</p>
-                                    </td>
-                                </tr>
-                                <!-- Spacer -->
-                                <tr>
-                                    <td style="height: 12px;"></td>
-                                </tr>
-                                <!-- New Proposed Time -->
-                                <tr>
-                                    <td style="padding: 24px; background-color: #f8f6f5; border-left: 3px solid #00BB38;">
-                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #00BB38; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Proposed New Time</p>
-                                        <p style="margin: 0; font-size: 18px; color: #333333; font-weight: 600; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{newDate}}</p>
-                                        <p style="margin: 4px 0 0 0; font-size: 15px; color: #67574A; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{newTime}}</p>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Divider -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
-                                <tr>
-                                    <td style="height: 1px; background-color: #e8e4df;"></td>
-                                </tr>
-                            </table>
-                            <!-- Response Instructions -->
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7;">
-                                <tr>
-                                    <td style="padding: 28px;">
-                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 600; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">How to Respond</p>
-                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                            Open the Metaesthetics app to accept or decline this reschedule request. Your appointment will remain pending until you respond.
-                                        </p>
-                                    </td>
-                                </tr>
-                            </table>
-                            <!-- Response Notice -->
-                            <p style="margin: 0; font-size: 13px; color: #868686; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
-                                Please respond at your earliest convenience so we can finalize your appointment. If you have questions, contact {{clinicName}} through the app.
-                            </p>
-                        </td>
-                    </tr>
-                    <!-- Footer -->
-                    <tr>
-                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
-                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
-                                <tr>
-                                    <td>
-                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
-                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
-                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
-                                    </td>
-                                </tr>
-                            </table>
-                        </td>
-                    </tr>
-                </table>
-            </td>
-        </tr>
-    </table>
-</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}`;
-    }
-  }
-  private formatClinicAddress(appointment: Appointment): string {
-    const loc = appointment.clinicInfo?.location;
-    if (!loc) return '';
-    const parts = [loc.address, loc.postalCode, loc.city, loc.country].filter(Boolean);
-    return parts.join(', ');
-  }
-  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,
-      clinicAddress: this.formatClinicAddress(data.appointment),
-    };
-    const html = this.renderTemplate(patientAppointmentConfirmedTemplate, templateVariables);
-    const subject = data.options?.customSubject || 'Your Appointment is Confirmed!';
-    const fromAddress =
-      data.options?.fromAddress ||
-      `Metaesthetics <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 ||
-      `Metaesthetics <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;
-    }
-  }
-  /**
-   * Gets a user-friendly display text for who cancelled the appointment
-   * @param cancelledBy - The entity that cancelled the appointment
-   * @param clinicName - The clinic name for context
-   * @returns User-friendly cancellation source text
-   */
-  private getCancelledByDisplayText(
-    cancelledBy: 'patient' | 'clinic' | 'practitioner' | 'system',
-    clinicName: string,
-  ): string {
-    switch (cancelledBy) {
-      case 'patient':
-        return 'Patient Request';
-      case 'clinic':
-        return `${clinicName} (Clinic)`;
-      case 'practitioner':
-        return 'Your Practitioner';
-      case 'system':
-        return 'System (Automatic)';
-      default:
-        return 'Unknown';
-    }
-  }
-  /**
-   * Sends an appointment cancellation email to the recipient
-   * @param data - Appointment cancellation email data
-   * @returns Promise with the sending result
-   */
-  async sendAppointmentCancelledEmail(data: AppointmentCancellationEmailData): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Preparing to send appointment cancellation email to ${data.recipientRole}: ${data.recipientProfile.id}`,
-    );
-    const recipientEmail = data.recipientProfile.email;
-    if (!recipientEmail) {
-      Logger.error('[AppointmentMailingService] Recipient email not found for cancellation.', {
-        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 for cancellation', {
-      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);
-    // Determine the cancelled by source from the appointment
-    const cancelledBy = data.appointment.canceledBy || 'system';
-    const cancelledByDisplay = this.getCancelledByDisplayText(
-      cancelledBy,
-      data.appointment.clinicInfo.name,
-    );
-    // Get recipient name based on role
-    const recipientName =
-      data.recipientRole === 'patient'
-        ? data.appointment.patientInfo.fullName
-        : data.appointment.practitionerInfo.name;
-    // Build template variables
-    const templateVariables: Record<string, string> = {
-      recipientName,
-      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,
-      clinicAddress: this.formatClinicAddress(data.appointment),
-      cancelledByDisplay,
-    };
-    // Handle cancellation reason - render with or without the reason block
-    const cancellationReason = data.cancellationReason || data.appointment.cancellationReason;
-    let html = appointmentCancelledTemplate;
-    if (cancellationReason) {
-      // Replace the conditional block with the reason content
-      templateVariables.cancellationReason = cancellationReason;
-      html = html.replace(
-        /\{\{#if cancellationReason\}\}([\s\S]*?)\{\{\/if\}\}/g,
-        '$1',
-      );
-    } else {
-      // Remove the conditional block entirely
-      html = html.replace(/\{\{#if cancellationReason\}\}[\s\S]*?\{\{\/if\}\}/g, '');
-    }
-    html = this.renderTemplate(html, templateVariables);
-    const subject =
-      data.options?.customSubject ||
-      `Appointment Cancelled: ${data.appointment.procedureInfo.name}`;
-    const fromAddress =
-      data.options?.fromAddress ||
-      `Metaesthetics <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_cancelled' },
-        true,
-      );
-      Logger.info(
-        `[AppointmentMailingService] Successfully sent cancellation email to ${recipientEmail}`,
-      );
-      return result;
-    } catch (error) {
-      await this.logEmailAttempt(
-        {
-          to: recipientEmail,
-          subject,
-          templateName: 'appointment_cancelled',
-        },
-        false,
-        error,
-      );
-      Logger.error(
-        `[AppointmentMailingService] Error sending cancellation email to ${recipientEmail}:`,
-        error,
-      );
-      throw error;
-    }
-  }
-  /**
-   * Sends a reschedule proposal email to the patient
-   * @param data - Appointment reschedule proposal email data
-   * @returns Promise with the sending result
-   */
-  async sendAppointmentRescheduledProposalEmail(
-    data: AppointmentRescheduledProposalEmailData,
-  ): Promise<any> {
-    Logger.info(
-      `[AppointmentMailingService] Preparing to send reschedule proposal email to patient: ${data.patientProfile.id}`,
-    );
-    const recipientEmail = data.patientProfile.email;
-    if (!recipientEmail) {
-      Logger.error('[AppointmentMailingService] Patient email not found for reschedule proposal.', {
-        patientId: data.patientProfile.id,
-      });
-      throw new Error('Patient 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 times for reschedule', {
-      clinicTimezone,
-      previousTime: data.previousStartTime.toDate().toISOString(),
-      newTime: data.appointment.appointmentStartTime.toDate().toISOString(),
-    });
-    // Format previous time
-    const previousFormattedTime = this.formatTimestampInClinicTimezone(
-      data.previousStartTime,
-      clinicTimezone,
-      'time',
-    );
-    const previousFormattedDate = this.formatTimestampInClinicTimezone(
-      data.previousStartTime,
-      clinicTimezone,
-      'date',
-    );
-    const previousTimezoneName = this.getTimezoneDisplayName(clinicTimezone);
-    // Format new proposed time
-    const newFormattedTime = this.formatTimestampInClinicTimezone(
-      data.appointment.appointmentStartTime,
-      clinicTimezone,
-      'time',
-    );
-    const newFormattedDate = this.formatTimestampInClinicTimezone(
-      data.appointment.appointmentStartTime,
-      clinicTimezone,
-      'date',
-    );
-    const newTimezoneName = this.getTimezoneDisplayName(clinicTimezone);
-    const templateVariables = {
-      patientName: data.appointment.patientInfo.fullName,
-      procedureName: data.appointment.procedureInfo.name,
-      practitionerName: data.appointment.practitionerInfo.name,
-      clinicName: data.appointment.clinicInfo.name,
-      clinicAddress: this.formatClinicAddress(data.appointment),
-      previousDate: previousFormattedDate,
-      previousTime: `${previousFormattedTime} (${previousTimezoneName})`,
-      newDate: newFormattedDate,
-      newTime: `${newFormattedTime} (${newTimezoneName})`,
-    };
-    const html = this.renderTemplate(appointmentRescheduledProposalTemplate, templateVariables);
-    const subject =
-      data.options?.customSubject ||
-      `Action Required: Reschedule Proposal for Your ${data.appointment.procedureInfo.name} Appointment`;
-    const fromAddress =
-      data.options?.fromAddress ||
-      `Metaesthetics <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_rescheduled_proposal' },
-        true,
-      );
-      Logger.info(
-        `[AppointmentMailingService] Successfully sent reschedule proposal email to ${recipientEmail}`,
-      );
-      return result;
-    } catch (error) {
-      await this.logEmailAttempt(
-        {
-          to: recipientEmail,
-          subject,
-          templateName: 'appointment_rescheduled_proposal',
-        },
-        false,
-        error,
-      );
-      Logger.error(
-        `[AppointmentMailingService] Error sending reschedule proposal email to ${recipientEmail}:`,
-        error,
-      );
-      throw error;
-    }
-  }
-  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>
+    <!--[if mso]>
+    <noscript>
+        <xml>
+            <o:OfficeDocumentSettings>
+                <o:PixelsPerInch>96</o:PixelsPerInch>
+            </o:OfficeDocumentSettings>
+        </xml>
+    </noscript>
+    <![endif]-->
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
+    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
+        <tr>
+            <td align="center" style="padding: 40px 20px;">
+                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
+                    <!-- Header -->
+                    <tr>
+                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Confirmed Banner -->
+                    <tr>
+                        <td style="padding: 0;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #00BB38;">
+                                <tr>
+                                    <td style="padding: 20px 48px;">
+                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Appointment Confirmed</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Main Content -->
+                    <tr>
+                        <td style="padding: 40px 48px;">
+                            <!-- Greeting -->
+                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
+                                Dear {{patientName}},
+                            </p>
+                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                Your appointment has been confirmed. We look forward to seeing you.
+                            </p>
+                            <!-- Appointment Details Card -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7; border-left: 3px solid #00BB38;">
+                                <tr>
+                                    <td style="padding: 24px;">
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
+                                        <p style="margin: 0 0 20px 0; font-size: 18px; color: #67574A; font-weight: 500; font-family: Georgia, 'Times New Roman', serif;">{{procedureName}}</p>
+                                        <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                            <tr>
+                                                <td style="padding-bottom: 16px;">
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Date & Time</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentDate}}</p>
+                                                    <p style="margin: 4px 0 0 0; font-size: 14px; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentTime}}</p>
+                                                </td>
+                                            </tr>
+                                            <tr>
+                                                <td style="padding-bottom: 16px;">
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
+                                                </td>
+                                            </tr>
+                                            <tr>
+                                                <td>
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #868686; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Location</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicName}}</p>
+                                                    <p style="margin: 4px 0 0 0; font-size: 13px; color: #555555; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicAddress}}</p>
+                                                </td>
+                                            </tr>
+                                        </table>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Divider -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
+                                <tr>
+                                    <td style="height: 1px; background-color: #e8e4df;"></td>
+                                </tr>
+                            </table>
+                            <!-- Important Notice -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px;">
+                                <tr>
+                                    <td style="padding: 20px 24px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
+                                        <p style="margin: 0 0 8px 0; font-size: 13px; font-weight: 600; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Before Your Visit</p>
+                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                            Please arrive 15 minutes early. If you need to reschedule or cancel, contact us through the Metaesthetics app.
+                                        </p>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Thank You -->
+                            <p style="margin: 0; font-size: 14px; color: #868686; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                Thank you for choosing {{clinicName}}. We look forward to providing you with exceptional care.
+                            </p>
+                        </td>
+                    </tr>
+                    <!-- Footer -->
+                    <tr>
+                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
+                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
+                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</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">Metaesthetics</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>Metaesthetics</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 appointmentCancelledTemplate = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Appointment Cancelled</title>
+    <!--[if mso]>
+    <noscript>
+        <xml>
+            <o:OfficeDocumentSettings>
+                <o:PixelsPerInch>96</o:PixelsPerInch>
+            </o:OfficeDocumentSettings>
+        </xml>
+    </noscript>
+    <![endif]-->
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
+    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
+        <tr>
+            <td align="center" style="padding: 40px 20px;">
+                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
+                    <!-- Header -->
+                    <tr>
+                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Cancellation Banner -->
+                    <tr>
+                        <td style="padding: 0;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #fa003f;">
+                                <tr>
+                                    <td style="padding: 20px 48px;">
+                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Appointment Cancelled</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Main Content -->
+                    <tr>
+                        <td style="padding: 40px 48px;">
+                            <!-- Greeting -->
+                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
+                                Dear {{recipientName}},
+                            </p>
+                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                We regret to inform you that your appointment has been cancelled. Please see the details below.
+                            </p>
+                            <!-- Cancelled By Info -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px;">
+                                <tr>
+                                    <td style="padding: 16px 20px; background-color: #fef2f2; border-left: 3px solid #fa003f;">
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Cancelled By</p>
+                                        <p style="margin: 0; font-size: 15px; color: #333333; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{cancelledByDisplay}}</p>
+                                    </td>
+                                </tr>
+                            </table>
+                            {{#if cancellationReason}}
+                            <!-- Cancellation Reason -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
+                                <tr>
+                                    <td style="padding: 20px 24px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
+                                        <p style="margin: 0 0 8px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Reason</p>
+                                        <p style="margin: 0; font-size: 15px; color: #555555; line-height: 1.6; font-style: italic; font-family: Georgia, 'Times New Roman', serif;">"{{cancellationReason}}"</p>
+                                    </td>
+                                </tr>
+                            </table>
+                            {{/if}}
+                            <!-- Cancelled Appointment Details -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #f5f5f5; border-left: 3px solid #cccccc;">
+                                <tr>
+                                    <td style="padding: 24px;">
+                                        <p style="margin: 0 0 16px 0; font-size: 12px; font-weight: 600; color: #999999; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Cancelled Appointment</p>
+                                        <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                            <tr>
+                                                <td style="padding-bottom: 12px;">
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{procedureName}}</p>
+                                                </td>
+                                            </tr>
+                                            <tr>
+                                                <td style="padding-bottom: 12px;">
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Date & Time</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{appointmentDate}} at {{appointmentTime}}</p>
+                                                </td>
+                                            </tr>
+                                            <tr>
+                                                <td style="padding-bottom: 12px;">
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
+                                                </td>
+                                            </tr>
+                                            <tr>
+                                                <td>
+                                                    <p style="margin: 0 0 2px 0; font-size: 11px; color: #999999; text-transform: uppercase; letter-spacing: 0.5px; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Location</p>
+                                                    <p style="margin: 0; font-size: 15px; color: #888888; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicName}}</p>
+                                                    <p style="margin: 4px 0 0 0; font-size: 13px; color: #999999; text-decoration: line-through; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{clinicAddress}}</p>
+                                                </td>
+                                            </tr>
+                                        </table>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Divider -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
+                                <tr>
+                                    <td style="height: 1px; background-color: #e8e4df;"></td>
+                                </tr>
+                            </table>
+                            <!-- Rebook Section -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 24px; background-color: #f0faf4; border-left: 3px solid #00BB38;">
+                                <tr>
+                                    <td style="padding: 24px;">
+                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 600; color: #00BB38; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Book a New Appointment</p>
+                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                            We'd love to see you again. Open the Metaesthetics app to browse available times and book a new appointment.
+                                        </p>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Support Info -->
+                            <p style="margin: 0; font-size: 13px; color: #868686; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                If you have any questions about this cancellation, please contact {{clinicName}} through the Metaesthetics app.
+                            </p>
+                        </td>
+                    </tr>
+                    <!-- Footer -->
+                    <tr>
+                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
+                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
+                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>
+`;
+const appointmentRescheduledProposalTemplate = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Appointment Reschedule Request</title>
+    <!--[if mso]>
+    <noscript>
+        <xml>
+            <o:OfficeDocumentSettings>
+                <o:PixelsPerInch>96</o:PixelsPerInch>
+            </o:OfficeDocumentSettings>
+        </xml>
+    </noscript>
+    <![endif]-->
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8f6f5; font-family: Georgia, 'Times New Roman', serif;">
+    <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #f8f6f5;">
+        <tr>
+            <td align="center" style="padding: 40px 20px;">
+                <table role="presentation" width="600" cellspacing="0" cellpadding="0" border="0" style="max-width: 600px; background-color: #ffffff; border-radius: 2px; box-shadow: 0 1px 3px rgba(103, 87, 74, 0.08);">
+                    <!-- Header -->
+                    <tr>
+                        <td style="padding: 48px 48px 32px 48px; border-bottom: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <h1 style="margin: 0; font-size: 24px; font-weight: 400; color: #67574A; letter-spacing: 2px; text-transform: uppercase; font-family: Georgia, 'Times New Roman', serif;">Metaesthetics</h1>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Action Required Banner -->
+                    <tr>
+                        <td style="padding: 0;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="background-color: #a48a76;">
+                                <tr>
+                                    <td style="padding: 20px 48px;">
+                                        <p style="margin: 0; font-size: 13px; font-weight: 600; color: #ffffff; letter-spacing: 1.5px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Action Required</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Main Content -->
+                    <tr>
+                        <td style="padding: 40px 48px;">
+                            <!-- Greeting -->
+                            <p style="margin: 0 0 24px 0; font-size: 17px; color: #333333; line-height: 1.6; font-family: Georgia, 'Times New Roman', serif;">
+                                Dear {{patientName}},
+                            </p>
+                            <p style="margin: 0 0 32px 0; font-size: 16px; color: #555555; line-height: 1.7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                {{clinicName}} has proposed a new time for your upcoming appointment. Please review the details below and respond at your earliest convenience.
+                            </p>
+                            <!-- Appointment Info Card -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7; border-left: 3px solid #a48a76;">
+                                <tr>
+                                    <td style="padding: 24px;">
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Procedure</p>
+                                        <p style="margin: 0 0 16px 0; font-size: 18px; color: #67574A; font-weight: 500; font-family: Georgia, 'Times New Roman', serif;">{{procedureName}}</p>
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #868686; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Practitioner</p>
+                                        <p style="margin: 0; font-size: 15px; color: #333333; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{practitionerName}}</p>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Time Comparison -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
+                                <!-- Original Time (Strikethrough) -->
+                                <tr>
+                                    <td style="padding: 20px 24px; background-color: #f5f5f5; border-left: 3px solid #cccccc;">
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #999999; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Original Appointment</p>
+                                        <p style="margin: 0; font-size: 16px; color: #999999; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; text-decoration: line-through;">{{previousDate}}</p>
+                                        <p style="margin: 4px 0 0 0; font-size: 14px; color: #999999; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; text-decoration: line-through;">{{previousTime}}</p>
+                                    </td>
+                                </tr>
+                                <!-- Spacer -->
+                                <tr>
+                                    <td style="height: 12px;"></td>
+                                </tr>
+                                <!-- New Proposed Time -->
+                                <tr>
+                                    <td style="padding: 24px; background-color: #f8f6f5; border-left: 3px solid #00BB38;">
+                                        <p style="margin: 0 0 4px 0; font-size: 11px; font-weight: 600; color: #00BB38; letter-spacing: 1px; text-transform: uppercase; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Proposed New Time</p>
+                                        <p style="margin: 0; font-size: 18px; color: #333333; font-weight: 600; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{newDate}}</p>
+                                        <p style="margin: 4px 0 0 0; font-size: 15px; color: #67574A; font-weight: 500; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">{{newTime}}</p>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Divider -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px;">
+                                <tr>
+                                    <td style="height: 1px; background-color: #e8e4df;"></td>
+                                </tr>
+                            </table>
+                            <!-- Response Instructions -->
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0" style="margin-bottom: 32px; background-color: #faf9f7;">
+                                <tr>
+                                    <td style="padding: 28px;">
+                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 600; color: #67574A; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">How to Respond</p>
+                                        <p style="margin: 0; font-size: 14px; color: #555555; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                            Open the Metaesthetics app to accept or decline this reschedule request. Your appointment will remain pending until you respond.
+                                        </p>
+                                    </td>
+                                </tr>
+                            </table>
+                            <!-- Response Notice -->
+                            <p style="margin: 0; font-size: 13px; color: #868686; line-height: 1.6; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">
+                                Please respond at your earliest convenience so we can finalize your appointment. If you have questions, contact {{clinicName}} through the app.
+                            </p>
+                        </td>
+                    </tr>
+                    <!-- Footer -->
+                    <tr>
+                        <td style="padding: 32px 48px; background-color: #faf9f7; border-top: 1px solid #f0ebe6;">
+                            <table role="presentation" width="100%" cellspacing="0" cellpadding="0" border="0">
+                                <tr>
+                                    <td>
+                                        <p style="margin: 0 0 8px 0; font-size: 14px; font-weight: 500; color: #67574A; font-family: Georgia, 'Times New Roman', serif;">{{clinicName}}</p>
+                                        <p style="margin: 0 0 16px 0; font-size: 13px; color: #868686; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">Premium Aesthetic Services</p>
+                                        <p style="margin: 0; font-size: 11px; color: #aaaaaa; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;">This is an automated message from Metaesthetics. Please do not reply directly to this email.</p>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</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}`;
+    }
+  }
+  private formatClinicAddress(appointment: Appointment): string {
+    const loc = appointment.clinicInfo?.location;
+    if (!loc) return '';
+    const parts = [loc.address, loc.postalCode, loc.city, loc.country].filter(Boolean);
+    return parts.join(', ');
+  }
+  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,
+      clinicAddress: this.formatClinicAddress(data.appointment),
+    };
+    const html = this.renderTemplate(patientAppointmentConfirmedTemplate, templateVariables);
+    const subject = data.options?.customSubject || 'Your Appointment is Confirmed!';
+    const fromAddress =
+      data.options?.fromAddress ||
+      `Metaesthetics <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 ||
+      `Metaesthetics <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;
+    }
+  }
+  /**
+   * Gets a user-friendly display text for who cancelled the appointment
+   * @param cancelledBy - The entity that cancelled the appointment
+   * @param clinicName - The clinic name for context
+   * @returns User-friendly cancellation source text
+   */
+  private getCancelledByDisplayText(
+    cancelledBy: 'patient' | 'clinic' | 'practitioner' | 'system',
+    clinicName: string,
+  ): string {
+    switch (cancelledBy) {
+      case 'patient':
+        return 'Patient Request';
+      case 'clinic':
+        return `${clinicName} (Clinic)`;
+      case 'practitioner':
+        return 'Your Practitioner';
+      case 'system':
+        return 'System (Automatic)';
+      default:
+        return 'Unknown';
+    }
+  }
+  /**
+   * Sends an appointment cancellation email to the recipient
+   * @param data - Appointment cancellation email data
+   * @returns Promise with the sending result
+   */
+  async sendAppointmentCancelledEmail(data: AppointmentCancellationEmailData): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Preparing to send appointment cancellation email to ${data.recipientRole}: ${data.recipientProfile.id}`,
+    );
+    const recipientEmail = data.recipientProfile.email;
+    if (!recipientEmail) {
+      Logger.error('[AppointmentMailingService] Recipient email not found for cancellation.', {
+        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 for cancellation', {
+      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);
+    // Determine the cancelled by source from the appointment
+    const cancelledBy = data.appointment.canceledBy || 'system';
+    const cancelledByDisplay = this.getCancelledByDisplayText(
+      cancelledBy,
+      data.appointment.clinicInfo.name,
+    );
+    // Get recipient name based on role
+    const recipientName =
+      data.recipientRole === 'patient'
+        ? data.appointment.patientInfo.fullName
+        : data.appointment.practitionerInfo.name;
+    // Build template variables
+    const templateVariables: Record<string, string> = {
+      recipientName,
+      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,
+      clinicAddress: this.formatClinicAddress(data.appointment),
+      cancelledByDisplay,
+    };
+    // Handle cancellation reason - render with or without the reason block
+    const cancellationReason = data.cancellationReason || data.appointment.cancellationReason;
+    let html = appointmentCancelledTemplate;
+    if (cancellationReason) {
+      // Replace the conditional block with the reason content
+      templateVariables.cancellationReason = cancellationReason;
+      html = html.replace(
+        /\{\{#if cancellationReason\}\}([\s\S]*?)\{\{\/if\}\}/g,
+        '$1',
+      );
+    } else {
+      // Remove the conditional block entirely
+      html = html.replace(/\{\{#if cancellationReason\}\}[\s\S]*?\{\{\/if\}\}/g, '');
+    }
+    html = this.renderTemplate(html, templateVariables);
+    const subject =
+      data.options?.customSubject ||
+      `Appointment Cancelled: ${data.appointment.procedureInfo.name}`;
+    const fromAddress =
+      data.options?.fromAddress ||
+      `Metaesthetics <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_cancelled' },
+        true,
+      );
+      Logger.info(
+        `[AppointmentMailingService] Successfully sent cancellation email to ${recipientEmail}`,
+      );
+      return result;
+    } catch (error) {
+      await this.logEmailAttempt(
+        {
+          to: recipientEmail,
+          subject,
+          templateName: 'appointment_cancelled',
+        },
+        false,
+        error,
+      );
+      Logger.error(
+        `[AppointmentMailingService] Error sending cancellation email to ${recipientEmail}:`,
+        error,
+      );
+      throw error;
+    }
+  }
+  /**
+   * Sends a reschedule proposal email to the patient
+   * @param data - Appointment reschedule proposal email data
+   * @returns Promise with the sending result
+   */
+  async sendAppointmentRescheduledProposalEmail(
+    data: AppointmentRescheduledProposalEmailData,
+  ): Promise<any> {
+    Logger.info(
+      `[AppointmentMailingService] Preparing to send reschedule proposal email to patient: ${data.patientProfile.id}`,
+    );
+    const recipientEmail = data.patientProfile.email;
+    if (!recipientEmail) {
+      Logger.error('[AppointmentMailingService] Patient email not found for reschedule proposal.', {
+        patientId: data.patientProfile.id,
+      });
+      throw new Error('Patient 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 times for reschedule', {
+      clinicTimezone,
+      previousTime: data.previousStartTime.toDate().toISOString(),
+      newTime: data.appointment.appointmentStartTime.toDate().toISOString(),
+    });
+    // Format previous time
+    const previousFormattedTime = this.formatTimestampInClinicTimezone(
+      data.previousStartTime,
+      clinicTimezone,
+      'time',
+    );
+    const previousFormattedDate = this.formatTimestampInClinicTimezone(
+      data.previousStartTime,
+      clinicTimezone,
+      'date',
+    );
+    const previousTimezoneName = this.getTimezoneDisplayName(clinicTimezone);
+    // Format new proposed time
+    const newFormattedTime = this.formatTimestampInClinicTimezone(
+      data.appointment.appointmentStartTime,
+      clinicTimezone,
+      'time',
+    );
+    const newFormattedDate = this.formatTimestampInClinicTimezone(
+      data.appointment.appointmentStartTime,
+      clinicTimezone,
+      'date',
+    );
+    const newTimezoneName = this.getTimezoneDisplayName(clinicTimezone);
+    const templateVariables = {
+      patientName: data.appointment.patientInfo.fullName,
+      procedureName: data.appointment.procedureInfo.name,
+      practitionerName: data.appointment.practitionerInfo.name,
+      clinicName: data.appointment.clinicInfo.name,
+      clinicAddress: this.formatClinicAddress(data.appointment),
+      previousDate: previousFormattedDate,
+      previousTime: `${previousFormattedTime} (${previousTimezoneName})`,
+      newDate: newFormattedDate,
+      newTime: `${newFormattedTime} (${newTimezoneName})`,
+    };
+    const html = this.renderTemplate(appointmentRescheduledProposalTemplate, templateVariables);
+    const subject =
+      data.options?.customSubject ||
+      `Action Required: Reschedule Proposal for Your ${data.appointment.procedureInfo.name} Appointment`;
+    const fromAddress =
+      data.options?.fromAddress ||
+      `Metaesthetics <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_rescheduled_proposal' },
+        true,
+      );
+      Logger.info(
+        `[AppointmentMailingService] Successfully sent reschedule proposal email to ${recipientEmail}`,
+      );
+      return result;
+    } catch (error) {
+      await this.logEmailAttempt(
+        {
+          to: recipientEmail,
+          subject,
+          templateName: 'appointment_rescheduled_proposal',
+        },
+        false,
+        error,
+      );
+      Logger.error(
+        `[AppointmentMailingService] Error sending reschedule proposal email to ${recipientEmail}:`,
+        error,
+      );
+      throw error;
+    }
+  }
+  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();
+  }
+}