@blackcode_sa/metaestetics-api 1.14.63 → 1.14.69

package/dist/admin/index.d.mts

@@ -852,6 +852,41 @@ interface ProcedureSummaryInfo {
     practitionerName: string;
 }
 
+/**
+ * Enum for practice types
+ */
+declare enum PracticeType {
+    GENERAL_PRACTICE = "general_practice",
+    DENTAL = "dental",
+    DERMATOLOGY = "dermatology",
+    CARDIOLOGY = "cardiology",
+    ORTHOPEDICS = "orthopedics",
+    GYNECOLOGY = "gynecology",
+    PEDIATRICS = "pediatrics",
+    OPHTHALMOLOGY = "ophthalmology",
+    NEUROLOGY = "neurology",
+    PSYCHIATRY = "psychiatry",
+    UROLOGY = "urology",
+    ONCOLOGY = "oncology",
+    ENDOCRINOLOGY = "endocrinology",
+    GASTROENTEROLOGY = "gastroenterology",
+    PULMONOLOGY = "pulmonology",
+    RHEUMATOLOGY = "rheumatology",
+    PHYSICAL_THERAPY = "physical_therapy",
+    NUTRITION = "nutrition",
+    ALTERNATIVE_MEDICINE = "alternative_medicine",
+    OTHER = "other"
+}
+/**
+ * Enum for languages
+ */
+declare enum Language {
+    ENGLISH = "english",
+    GERMAN = "german",
+    ITALIAN = "italian",
+    FRENCH = "french",
+    SPANISH = "spanish"
+}
 /**
  * Enum for all possible clinic tags
  */
@@ -1058,6 +1093,53 @@ interface WorkingHours {
         breaks?: Break[];
     } | null;
 }
+/**
+ * Interface for contact person
+ */
+interface ContactPerson {
+    firstName: string;
+    lastName: string;
+    title?: string | null;
+    email: string;
+    phoneNumber?: string | null;
+}
+/**
+ * Enum for admin token status
+ */
+declare enum AdminTokenStatus {
+    ACTIVE = "active",
+    USED = "used",
+    EXPIRED = "expired"
+}
+/**
+ * Interface for admin token
+ */
+interface AdminToken {
+    id: string;
+    token: string;
+    email?: string | null;
+    status: AdminTokenStatus;
+    usedByUserRef?: string;
+    createdAt: Timestamp;
+    expiresAt: Timestamp;
+}
+/**
+ * Interface for admin information
+ */
+interface AdminInfo {
+    id: string;
+    name: string;
+    email: string;
+}
+/**
+ * Enum for subscription models
+ */
+declare enum SubscriptionModel {
+    NO_SUBSCRIPTION = "no_subscription",
+    BASIC = "basic",
+    PREMIUM = "premium",
+    ENTERPRISE = "enterprise"
+}
 /**
  * Enum for subscription status
  */
@@ -1140,6 +1222,38 @@ interface CreateBillingTransactionData {
     planDetails: PlanDetails;
     metadata?: Record<string, any>;
 }
+/**
+ * Interface for clinic group
+ */
+interface ClinicGroup {
+    id: string;
+    name: string;
+    description?: string;
+    hqLocation: ClinicLocation;
+    contactInfo: ClinicContactInfo;
+    contactPerson: ContactPerson;
+    clinics: string[];
+    clinicsInfo: ClinicInfo[];
+    admins: string[];
+    adminsInfo: AdminInfo[];
+    adminTokens: AdminToken[];
+    ownerId: string | null;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    isActive: boolean;
+    logo?: MediaResource | null;
+    practiceType?: PracticeType;
+    languages?: Language[];
+    subscriptionModel: SubscriptionModel;
+    billing?: BillingInfo;
+    calendarSyncEnabled?: boolean;
+    autoConfirmAppointments?: boolean;
+    businessIdentificationNumber?: string | null;
+    onboarding?: {
+        completed?: boolean;
+        step?: number;
+    };
+}
 /**
  * Interface for doctor information
  */
@@ -3174,11 +3288,11 @@ type Notification = PreRequirementNotification | PostRequirementNotification | R
  * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
  * or provides clearer typing if it is.
  */
-interface NewMailgunMessagesAPI$3 {
+interface NewMailgunMessagesAPI$4 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$3 {
-    messages: NewMailgunMessagesAPI$3;
+interface NewMailgunClient$4 {
+    messages: NewMailgunMessagesAPI$4;
 }
 /**
  * Base mailing service class that provides common functionality for all mailing services
@@ -3186,13 +3300,13 @@ interface NewMailgunClient$3 {
  */
 declare class BaseMailingService {
     protected db: FirebaseFirestore.Firestore;
-    protected mailgunClient: NewMailgunClient$3;
+    protected mailgunClient: NewMailgunClient$4;
     /**
      * Constructor for BaseMailingService
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$3);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$4);
     /**
      * Sends an email using the new Mailgun client API.
      * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
@@ -3221,11 +3335,11 @@ declare class BaseMailingService {
     protected renderTemplate(template: string, variables: Record<string, string>): string;
 }
 
-interface NewMailgunMessagesAPI$2 {
+interface NewMailgunMessagesAPI$3 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$2 {
-    messages: NewMailgunMessagesAPI$2;
+interface NewMailgunClient$3 {
+    messages: NewMailgunMessagesAPI$3;
 }
 /**
  * Interface for the data required to send a practitioner invitation email
@@ -3271,7 +3385,7 @@ declare class PractitionerInviteMailingService extends BaseMailingService {
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$3);
     /**
      * Sends a practitioner invitation email
      * @param data The practitioner invitation data
@@ -3294,11 +3408,11 @@ declare class PractitionerInviteMailingService extends BaseMailingService {
     }): Promise<void>;
 }
 
-interface NewMailgunMessagesAPI$1 {
+interface NewMailgunMessagesAPI$2 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$1 {
-    messages: NewMailgunMessagesAPI$1;
+interface NewMailgunClient$2 {
+    messages: NewMailgunMessagesAPI$2;
 }
 /**
  * Interface for sending practitioner invitation email data
@@ -3384,7 +3498,7 @@ declare class ExistingPractitionerInviteMailingService extends BaseMailingServic
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
     /**
      * Sends an invitation email to an existing practitioner
      * @param data The invitation email data
@@ -4558,11 +4672,11 @@ declare class Logger {
 /**
  * Minimal interface for the mailgun.js client if not importing full types
  */
-interface NewMailgunMessagesAPI {
+interface NewMailgunMessagesAPI$1 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient {
-    messages: NewMailgunMessagesAPI;
+interface NewMailgunClient$1 {
+    messages: NewMailgunMessagesAPI$1;
 }
 /**
  * Interface for the data required to send a patient invitation email
@@ -4609,7 +4723,7 @@ declare class PatientInviteMailingService extends BaseMailingService {
      * @param firestore - Firestore instance provided by the caller
      * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
     /**
      * Sends a patient invitation email
      * @param data - The patient invitation data
@@ -4671,7 +4785,7 @@ interface ReviewAddedEmailData extends AppointmentEmailDataBase {
  */
 declare class AppointmentMailingService extends BaseMailingService {
     private readonly DEFAULT_MAILGUN_DOMAIN;
-    constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient$3);
+    constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient$4);
     /**
      * Formats a Firestore Timestamp in the clinic's timezone
      * @param timestamp - Firestore Timestamp (UTC)
@@ -4711,6 +4825,76 @@ declare class AppointmentMailingService extends BaseMailingService {
     sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any>;
 }
 
+/**
+ * Minimal interface for the mailgun.js client
+ */
+interface NewMailgunMessagesAPI {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+    messages: NewMailgunMessagesAPI;
+}
+/**
+ * Interface for clinic welcome email data
+ */
+interface ClinicWelcomeEmailData {
+    /** Admin information */
+    admin: {
+        name: string;
+        email: string;
+    };
+    /** Clinic group information */
+    clinicGroup: {
+        id: string;
+        name: string;
+    };
+    /** Config options */
+    options?: {
+        dashboardUrl?: string;
+        supportEmail?: string;
+        customSubject?: string;
+        fromAddress?: string;
+        mailgunDomain?: string;
+    };
+}
+/**
+ * Service for sending clinic welcome/confirmation emails
+ * Sent to clinic admins after successful signup
+ */
+declare class ClinicWelcomeMailingService extends BaseMailingService {
+    private readonly DEFAULT_DASHBOARD_URL;
+    private readonly DEFAULT_SUPPORT_EMAIL;
+    private readonly DEFAULT_SUBJECT;
+    private readonly DEFAULT_MAILGUN_DOMAIN;
+    /**
+     * Constructor for ClinicWelcomeMailingService
+     * @param firestore - Firestore instance provided by the caller
+     * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
+     */
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
+    /**
+     * Sends a clinic welcome email
+     * @param data - The clinic welcome email data
+     * @returns Promise resolved when email is sent
+     */
+    sendWelcomeEmail(data: ClinicWelcomeEmailData): Promise<any>;
+    /**
+     * Handles the clinic group creation event from Cloud Functions.
+     * Fetches necessary data and sends the welcome email to the admin.
+     * @param clinicGroupData - The clinic group data including id
+     * @param mailgunConfig - Mailgun configuration (from, domain)
+     * @returns Promise resolved when the email is sent
+     */
+    handleClinicGroupCreationEvent(clinicGroupData: ClinicGroup & {
+        id: string;
+    }, mailgunConfig: {
+        fromAddress: string;
+        domain: string;
+        dashboardUrl?: string;
+        supportEmail?: string;
+    }): Promise<void>;
+}
+
 declare class NotificationsAdmin {
     private expo;
     private db;
@@ -4874,4 +5058,4 @@ declare class UserProfileAdminService {
     initializePractitionerRole(userId: string): Promise<User>;
 }
 
-export { ANALYTICS_COLLECTION, AnalyticsAdminService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AppointmentTrend, type AvailableSlot, BaseMailingService, type BaseMetrics, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CalendarAdminService, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicAnalytics, type ClinicComparisonMetrics, type ClinicInfo, type ClinicLocation, type CostPerPatientMetrics, type CreateBillingTransactionData, DASHBOARD_ANALYTICS_SUBCOLLECTION, type DashboardAnalytics, type DoctorInfo, DocumentManagerAdminService, type DurationTrend, type EntityType, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, INVITE_TOKENS_COLLECTION, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NewMailgunClient$3 as NewMailgunClient, type NoShowMetrics, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type PatientProfile as Patient, PatientAggregationService, type PatientAnalytics, PatientInstructionStatus, type PatientInviteEmailData, PatientInviteMailingService, type PatientLifetimeValueMetrics, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientRetentionMetrics, type PatientSensitiveInfo, type PatientToken, PatientTokenStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerAnalytics, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureAnalytics, type ProcedurePopularity, type ProcedureProfitability, type ProcedureSummaryInfo, type ProductRevenueMetrics, type ProductUsageByProcedure, type ProductUsageMetrics, REVENUE_ANALYTICS_SUBCOLLECTION, type ReadStoredAnalyticsOptions, type RequirementSourceProcedure, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAddedEmailData, type ReviewMetrics, type ReviewRequestEmailData, type ReviewTrend, ReviewsAggregationService, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, SubscriptionStatus, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type TimeEfficiencyMetrics, type TimeInterval, type TrendPeriod, UserProfileAdminService, UserRole, freeConsultationInfrastructure };
+export { ANALYTICS_COLLECTION, AnalyticsAdminService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AppointmentTrend, type AvailableSlot, BaseMailingService, type BaseMetrics, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CalendarAdminService, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicAnalytics, type ClinicComparisonMetrics, type ClinicGroup, type ClinicInfo, type ClinicLocation, type ClinicWelcomeEmailData, ClinicWelcomeMailingService, type CostPerPatientMetrics, type CreateBillingTransactionData, DASHBOARD_ANALYTICS_SUBCOLLECTION, type DashboardAnalytics, type DoctorInfo, DocumentManagerAdminService, type DurationTrend, type EntityType, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, INVITE_TOKENS_COLLECTION, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NewMailgunClient$4 as NewMailgunClient, type NoShowMetrics, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type PatientProfile as Patient, PatientAggregationService, type PatientAnalytics, PatientInstructionStatus, type PatientInviteEmailData, PatientInviteMailingService, type PatientLifetimeValueMetrics, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientRetentionMetrics, type PatientSensitiveInfo, type PatientToken, PatientTokenStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerAnalytics, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureAnalytics, type ProcedurePopularity, type ProcedureProfitability, type ProcedureSummaryInfo, type ProductRevenueMetrics, type ProductUsageByProcedure, type ProductUsageMetrics, REVENUE_ANALYTICS_SUBCOLLECTION, type ReadStoredAnalyticsOptions, type RequirementSourceProcedure, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAddedEmailData, type ReviewMetrics, type ReviewRequestEmailData, type ReviewTrend, ReviewsAggregationService, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, SubscriptionStatus, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type TimeEfficiencyMetrics, type TimeInterval, type TrendPeriod, UserProfileAdminService, UserRole, freeConsultationInfrastructure };

package/dist/admin/index.d.ts

@@ -852,6 +852,41 @@ interface ProcedureSummaryInfo {
     practitionerName: string;
 }
 
+/**
+ * Enum for practice types
+ */
+declare enum PracticeType {
+    GENERAL_PRACTICE = "general_practice",
+    DENTAL = "dental",
+    DERMATOLOGY = "dermatology",
+    CARDIOLOGY = "cardiology",
+    ORTHOPEDICS = "orthopedics",
+    GYNECOLOGY = "gynecology",
+    PEDIATRICS = "pediatrics",
+    OPHTHALMOLOGY = "ophthalmology",
+    NEUROLOGY = "neurology",
+    PSYCHIATRY = "psychiatry",
+    UROLOGY = "urology",
+    ONCOLOGY = "oncology",
+    ENDOCRINOLOGY = "endocrinology",
+    GASTROENTEROLOGY = "gastroenterology",
+    PULMONOLOGY = "pulmonology",
+    RHEUMATOLOGY = "rheumatology",
+    PHYSICAL_THERAPY = "physical_therapy",
+    NUTRITION = "nutrition",
+    ALTERNATIVE_MEDICINE = "alternative_medicine",
+    OTHER = "other"
+}
+/**
+ * Enum for languages
+ */
+declare enum Language {
+    ENGLISH = "english",
+    GERMAN = "german",
+    ITALIAN = "italian",
+    FRENCH = "french",
+    SPANISH = "spanish"
+}
 /**
  * Enum for all possible clinic tags
  */
@@ -1058,6 +1093,53 @@ interface WorkingHours {
         breaks?: Break[];
     } | null;
 }
+/**
+ * Interface for contact person
+ */
+interface ContactPerson {
+    firstName: string;
+    lastName: string;
+    title?: string | null;
+    email: string;
+    phoneNumber?: string | null;
+}
+/**
+ * Enum for admin token status
+ */
+declare enum AdminTokenStatus {
+    ACTIVE = "active",
+    USED = "used",
+    EXPIRED = "expired"
+}
+/**
+ * Interface for admin token
+ */
+interface AdminToken {
+    id: string;
+    token: string;
+    email?: string | null;
+    status: AdminTokenStatus;
+    usedByUserRef?: string;
+    createdAt: Timestamp;
+    expiresAt: Timestamp;
+}
+/**
+ * Interface for admin information
+ */
+interface AdminInfo {
+    id: string;
+    name: string;
+    email: string;
+}
+/**
+ * Enum for subscription models
+ */
+declare enum SubscriptionModel {
+    NO_SUBSCRIPTION = "no_subscription",
+    BASIC = "basic",
+    PREMIUM = "premium",
+    ENTERPRISE = "enterprise"
+}
 /**
  * Enum for subscription status
  */
@@ -1140,6 +1222,38 @@ interface CreateBillingTransactionData {
     planDetails: PlanDetails;
     metadata?: Record<string, any>;
 }
+/**
+ * Interface for clinic group
+ */
+interface ClinicGroup {
+    id: string;
+    name: string;
+    description?: string;
+    hqLocation: ClinicLocation;
+    contactInfo: ClinicContactInfo;
+    contactPerson: ContactPerson;
+    clinics: string[];
+    clinicsInfo: ClinicInfo[];
+    admins: string[];
+    adminsInfo: AdminInfo[];
+    adminTokens: AdminToken[];
+    ownerId: string | null;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    isActive: boolean;
+    logo?: MediaResource | null;
+    practiceType?: PracticeType;
+    languages?: Language[];
+    subscriptionModel: SubscriptionModel;
+    billing?: BillingInfo;
+    calendarSyncEnabled?: boolean;
+    autoConfirmAppointments?: boolean;
+    businessIdentificationNumber?: string | null;
+    onboarding?: {
+        completed?: boolean;
+        step?: number;
+    };
+}
 /**
  * Interface for doctor information
  */
@@ -3174,11 +3288,11 @@ type Notification = PreRequirementNotification | PostRequirementNotification | R
  * This helps avoid a direct dependency on mailgun.js in the API package if not desired,
  * or provides clearer typing if it is.
  */
-interface NewMailgunMessagesAPI$3 {
+interface NewMailgunMessagesAPI$4 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$3 {
-    messages: NewMailgunMessagesAPI$3;
+interface NewMailgunClient$4 {
+    messages: NewMailgunMessagesAPI$4;
 }
 /**
  * Base mailing service class that provides common functionality for all mailing services
@@ -3186,13 +3300,13 @@ interface NewMailgunClient$3 {
  */
 declare class BaseMailingService {
     protected db: FirebaseFirestore.Firestore;
-    protected mailgunClient: NewMailgunClient$3;
+    protected mailgunClient: NewMailgunClient$4;
     /**
      * Constructor for BaseMailingService
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$3);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$4);
     /**
      * Sends an email using the new Mailgun client API.
      * @param domain The Mailgun domain to send from (e.g., mg.metaesthetics.net)
@@ -3221,11 +3335,11 @@ declare class BaseMailingService {
     protected renderTemplate(template: string, variables: Record<string, string>): string;
 }
 
-interface NewMailgunMessagesAPI$2 {
+interface NewMailgunMessagesAPI$3 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$2 {
-    messages: NewMailgunMessagesAPI$2;
+interface NewMailgunClient$3 {
+    messages: NewMailgunMessagesAPI$3;
 }
 /**
  * Interface for the data required to send a practitioner invitation email
@@ -3271,7 +3385,7 @@ declare class PractitionerInviteMailingService extends BaseMailingService {
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$3);
     /**
      * Sends a practitioner invitation email
      * @param data The practitioner invitation data
@@ -3294,11 +3408,11 @@ declare class PractitionerInviteMailingService extends BaseMailingService {
     }): Promise<void>;
 }
 
-interface NewMailgunMessagesAPI$1 {
+interface NewMailgunMessagesAPI$2 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient$1 {
-    messages: NewMailgunMessagesAPI$1;
+interface NewMailgunClient$2 {
+    messages: NewMailgunMessagesAPI$2;
 }
 /**
  * Interface for sending practitioner invitation email data
@@ -3384,7 +3498,7 @@ declare class ExistingPractitionerInviteMailingService extends BaseMailingServic
      * @param firestore Firestore instance provided by the caller
      * @param mailgunClient Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$2);
     /**
      * Sends an invitation email to an existing practitioner
      * @param data The invitation email data
@@ -4558,11 +4672,11 @@ declare class Logger {
 /**
  * Minimal interface for the mailgun.js client if not importing full types
  */
-interface NewMailgunMessagesAPI {
+interface NewMailgunMessagesAPI$1 {
     create(domain: string, data: any): Promise<any>;
 }
-interface NewMailgunClient {
-    messages: NewMailgunMessagesAPI;
+interface NewMailgunClient$1 {
+    messages: NewMailgunMessagesAPI$1;
 }
 /**
  * Interface for the data required to send a patient invitation email
@@ -4609,7 +4723,7 @@ declare class PatientInviteMailingService extends BaseMailingService {
      * @param firestore - Firestore instance provided by the caller
      * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
      */
-    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient$1);
     /**
      * Sends a patient invitation email
      * @param data - The patient invitation data
@@ -4671,7 +4785,7 @@ interface ReviewAddedEmailData extends AppointmentEmailDataBase {
  */
 declare class AppointmentMailingService extends BaseMailingService {
     private readonly DEFAULT_MAILGUN_DOMAIN;
-    constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient$3);
+    constructor(firestore: admin.firestore.Firestore, mailgunClient: NewMailgunClient$4);
     /**
      * Formats a Firestore Timestamp in the clinic's timezone
      * @param timestamp - Firestore Timestamp (UTC)
@@ -4711,6 +4825,76 @@ declare class AppointmentMailingService extends BaseMailingService {
     sendReviewAddedEmail(data: ReviewAddedEmailData): Promise<any>;
 }
 
+/**
+ * Minimal interface for the mailgun.js client
+ */
+interface NewMailgunMessagesAPI {
+    create(domain: string, data: any): Promise<any>;
+}
+interface NewMailgunClient {
+    messages: NewMailgunMessagesAPI;
+}
+/**
+ * Interface for clinic welcome email data
+ */
+interface ClinicWelcomeEmailData {
+    /** Admin information */
+    admin: {
+        name: string;
+        email: string;
+    };
+    /** Clinic group information */
+    clinicGroup: {
+        id: string;
+        name: string;
+    };
+    /** Config options */
+    options?: {
+        dashboardUrl?: string;
+        supportEmail?: string;
+        customSubject?: string;
+        fromAddress?: string;
+        mailgunDomain?: string;
+    };
+}
+/**
+ * Service for sending clinic welcome/confirmation emails
+ * Sent to clinic admins after successful signup
+ */
+declare class ClinicWelcomeMailingService extends BaseMailingService {
+    private readonly DEFAULT_DASHBOARD_URL;
+    private readonly DEFAULT_SUPPORT_EMAIL;
+    private readonly DEFAULT_SUBJECT;
+    private readonly DEFAULT_MAILGUN_DOMAIN;
+    /**
+     * Constructor for ClinicWelcomeMailingService
+     * @param firestore - Firestore instance provided by the caller
+     * @param mailgunClient - Mailgun client instance (mailgun.js v10+) provided by the caller
+     */
+    constructor(firestore: FirebaseFirestore.Firestore, mailgunClient: NewMailgunClient);
+    /**
+     * Sends a clinic welcome email
+     * @param data - The clinic welcome email data
+     * @returns Promise resolved when email is sent
+     */
+    sendWelcomeEmail(data: ClinicWelcomeEmailData): Promise<any>;
+    /**
+     * Handles the clinic group creation event from Cloud Functions.
+     * Fetches necessary data and sends the welcome email to the admin.
+     * @param clinicGroupData - The clinic group data including id
+     * @param mailgunConfig - Mailgun configuration (from, domain)
+     * @returns Promise resolved when the email is sent
+     */
+    handleClinicGroupCreationEvent(clinicGroupData: ClinicGroup & {
+        id: string;
+    }, mailgunConfig: {
+        fromAddress: string;
+        domain: string;
+        dashboardUrl?: string;
+        supportEmail?: string;
+    }): Promise<void>;
+}
+
 declare class NotificationsAdmin {
     private expo;
     private db;
@@ -4874,4 +5058,4 @@ declare class UserProfileAdminService {
     initializePractitionerRole(userId: string): Promise<User>;
 }
 
-export { ANALYTICS_COLLECTION, AnalyticsAdminService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AppointmentTrend, type AvailableSlot, BaseMailingService, type BaseMetrics, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CalendarAdminService, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicAnalytics, type ClinicComparisonMetrics, type ClinicInfo, type ClinicLocation, type CostPerPatientMetrics, type CreateBillingTransactionData, DASHBOARD_ANALYTICS_SUBCOLLECTION, type DashboardAnalytics, type DoctorInfo, DocumentManagerAdminService, type DurationTrend, type EntityType, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, INVITE_TOKENS_COLLECTION, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NewMailgunClient$3 as NewMailgunClient, type NoShowMetrics, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type PatientProfile as Patient, PatientAggregationService, type PatientAnalytics, PatientInstructionStatus, type PatientInviteEmailData, PatientInviteMailingService, type PatientLifetimeValueMetrics, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientRetentionMetrics, type PatientSensitiveInfo, type PatientToken, PatientTokenStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerAnalytics, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureAnalytics, type ProcedurePopularity, type ProcedureProfitability, type ProcedureSummaryInfo, type ProductRevenueMetrics, type ProductUsageByProcedure, type ProductUsageMetrics, REVENUE_ANALYTICS_SUBCOLLECTION, type ReadStoredAnalyticsOptions, type RequirementSourceProcedure, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAddedEmailData, type ReviewMetrics, type ReviewRequestEmailData, type ReviewTrend, ReviewsAggregationService, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, SubscriptionStatus, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type TimeEfficiencyMetrics, type TimeInterval, type TrendPeriod, UserProfileAdminService, UserRole, freeConsultationInfrastructure };
+export { ANALYTICS_COLLECTION, AnalyticsAdminService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, type Appointment, AppointmentAggregationService, type AppointmentCancellationEmailData, type AppointmentConfirmationEmailData, type AppointmentEmailDataBase, AppointmentMailingService, type AppointmentReminderNotification, type AppointmentRequestedEmailData, type AppointmentRescheduledProposalEmailData, AppointmentStatus, type AppointmentTrend, type AvailableSlot, BaseMailingService, type BaseMetrics, type BaseNotification, type BillingInfo, type BillingTransaction, BillingTransactionType, BookingAdmin, BookingAvailabilityCalculator, type BookingAvailabilityRequest, type BookingAvailabilityResponse, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CalendarAdminService, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Clinic, type ClinicAdminNotificationData, ClinicAggregationService, type ClinicAnalytics, type ClinicComparisonMetrics, type ClinicGroup, type ClinicInfo, type ClinicLocation, type ClinicWelcomeEmailData, ClinicWelcomeMailingService, type CostPerPatientMetrics, type CreateBillingTransactionData, DASHBOARD_ANALYTICS_SUBCOLLECTION, type DashboardAnalytics, type DoctorInfo, DocumentManagerAdminService, type DurationTrend, type EntityType, type ExistingPractitionerInviteEmailData, ExistingPractitionerInviteMailingService, type FilledDocument, FilledFormsAggregationService, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, INVITE_TOKENS_COLLECTION, type InitializeAppointmentFormsResult, Logger, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NewMailgunClient$4 as NewMailgunClient, type NoShowMetrics, type Notification, NotificationStatus, NotificationType, NotificationsAdmin, type OrchestrateAppointmentCreationData, PATIENTS_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type PatientProfile as Patient, PatientAggregationService, type PatientAnalytics, PatientInstructionStatus, type PatientInviteEmailData, PatientInviteMailingService, type PatientLifetimeValueMetrics, type PatientProfile, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, PatientRequirementsAdminService, type PatientRetentionMetrics, type PatientSensitiveInfo, type PatientToken, PatientTokenStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, type Practitioner, PractitionerAggregationService, type PractitionerAnalytics, type PractitionerInvite, PractitionerInviteAggregationService, type PractitionerInviteEmailData, PractitionerInviteMailingService, PractitionerInviteStatus, type PractitionerToken, PractitionerTokenStatus, type PreRequirementNotification, type Procedure, ProcedureAggregationService, type ProcedureAnalytics, type ProcedurePopularity, type ProcedureProfitability, type ProcedureSummaryInfo, type ProductRevenueMetrics, type ProductUsageByProcedure, type ProductUsageMetrics, REVENUE_ANALYTICS_SUBCOLLECTION, type ReadStoredAnalyticsOptions, type RequirementSourceProcedure, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAddedEmailData, type ReviewMetrics, type ReviewRequestEmailData, type ReviewTrend, ReviewsAggregationService, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, SubscriptionStatus, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type TimeEfficiencyMetrics, type TimeInterval, type TrendPeriod, UserProfileAdminService, UserRole, freeConsultationInfrastructure };