@blackcode_sa/metaestetics-api 1.14.41 → 1.14.43

package/dist/admin/index.d.mts

@@ -8,6 +8,18 @@ declare enum UserRole {
     APP_ADMIN = "app_admin",
     CLINIC_ADMIN = "clinic_admin"
 }
+/**
+ * Enum for acquisition source - how the user found out about the app
+ */
+declare enum AcquisitionSource {
+    FRIEND_FAMILY = "friend_family",
+    ONLINE_SEARCH = "online_search",
+    SOCIAL_MEDIA_AD = "social_media_ad",
+    TRADITIONAL_AD = "traditional_ad",
+    BLOG_ARTICLE = "blog_article",
+    HEALTHCARE_PROVIDER = "healthcare_provider",
+    OTHER = "other"
+}
 interface User {
     uid: string;
     email: string | null;
@@ -19,6 +31,12 @@ interface User {
     patientProfile?: string;
     practitionerProfile?: string;
     adminProfile?: string;
+    /** How the user found out about the app (marketing attribution) */
+    acquisitionSource?: AcquisitionSource | null;
+    /** Custom text when acquisitionSource is 'other' */
+    acquisitionSourceOther?: string | null;
+    /** Timestamp when acquisition source was collected */
+    acquisitionSourceTimestamp?: Timestamp | null;
 }
 
 /**

package/dist/admin/index.d.ts

@@ -8,6 +8,18 @@ declare enum UserRole {
     APP_ADMIN = "app_admin",
     CLINIC_ADMIN = "clinic_admin"
 }
+/**
+ * Enum for acquisition source - how the user found out about the app
+ */
+declare enum AcquisitionSource {
+    FRIEND_FAMILY = "friend_family",
+    ONLINE_SEARCH = "online_search",
+    SOCIAL_MEDIA_AD = "social_media_ad",
+    TRADITIONAL_AD = "traditional_ad",
+    BLOG_ARTICLE = "blog_article",
+    HEALTHCARE_PROVIDER = "healthcare_provider",
+    OTHER = "other"
+}
 interface User {
     uid: string;
     email: string | null;
@@ -19,6 +31,12 @@ interface User {
     patientProfile?: string;
     practitionerProfile?: string;
     adminProfile?: string;
+    /** How the user found out about the app (marketing attribution) */
+    acquisitionSource?: AcquisitionSource | null;
+    /** Custom text when acquisitionSource is 'other' */
+    acquisitionSourceOther?: string | null;
+    /** Timestamp when acquisition source was collected */
+    acquisitionSourceTimestamp?: Timestamp | null;
 }
 
 /**

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Firestore, FieldValue, DocumentData, QueryDocumentSnapshot, Timestamp, DocumentSnapshot } from 'firebase/firestore';
+import { Firestore, Timestamp, FieldValue, DocumentData, QueryDocumentSnapshot, DocumentSnapshot } from 'firebase/firestore';
 import { Auth, User as User$1 } from 'firebase/auth';
 import { FirebaseApp } from 'firebase/app';
 import { FirebaseStorage } from 'firebase/storage';
@@ -1122,6 +1122,18 @@ declare enum UserRole {
     APP_ADMIN = "app_admin",
     CLINIC_ADMIN = "clinic_admin"
 }
+/**
+ * Enum for acquisition source - how the user found out about the app
+ */
+declare enum AcquisitionSource {
+    FRIEND_FAMILY = "friend_family",
+    ONLINE_SEARCH = "online_search",
+    SOCIAL_MEDIA_AD = "social_media_ad",
+    TRADITIONAL_AD = "traditional_ad",
+    BLOG_ARTICLE = "blog_article",
+    HEALTHCARE_PROVIDER = "healthcare_provider",
+    OTHER = "other"
+}
 interface User {
     uid: string;
     email: string | null;
@@ -1133,6 +1145,12 @@ interface User {
     patientProfile?: string;
     practitionerProfile?: string;
     adminProfile?: string;
+    /** How the user found out about the app (marketing attribution) */
+    acquisitionSource?: AcquisitionSource | null;
+    /** Custom text when acquisitionSource is 'other' */
+    acquisitionSourceOther?: string | null;
+    /** Timestamp when acquisition source was collected */
+    acquisitionSourceTimestamp?: Timestamp | null;
 }
 interface CreateUserData {
     uid: string;
@@ -1142,6 +1160,9 @@ interface CreateUserData {
     createdAt: FieldValue;
     updatedAt: FieldValue;
     lastLoginAt: FieldValue;
+    acquisitionSource?: AcquisitionSource | null;
+    acquisitionSourceOther?: string | null;
+    acquisitionSourceTimestamp?: FieldValue | Timestamp | null;
 }
 declare const USERS_COLLECTION = "users";
 type FirebaseUser = User$1;
@@ -8324,6 +8345,15 @@ declare class UserService extends BaseService {
      * Uklanja rolu korisniku i briše odgovarajući profil
      */
     removeRoleAndProfile(uid: string, role: UserRole): Promise<void>;
+    /**
+     * Updates the acquisition source information for a user
+     * @param uid - User ID
+     * @param data - Acquisition source data
+     */
+    updateAcquisitionSource(uid: string, data: {
+        acquisitionSource: AcquisitionSource | null;
+        acquisitionSourceOther?: string | null;
+    }): Promise<void>;
     deleteUser(uid: string): Promise<void>;
 }
 
@@ -9212,4 +9242,4 @@ declare const getFirebaseApp: () => Promise<FirebaseApp>;
 declare const getFirebaseStorage: () => Promise<FirebaseStorage>;
 declare const getFirebaseFunctions: () => Promise<Functions>;
 
-export { AESTHETIC_ANALYSIS_COLLECTION, ANALYTICS_COLLECTION, APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type AestheticAnalysisStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, AnalyticsCloudService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, AnalyticsService, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentProductMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AppointmentTrend, type AssessmentScales, AuthService, type BaseDocumentElement, type BaseMetrics, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, type Break, CALENDAR_COLLECTION, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicAnalytics, type ClinicBranchSetupData, type ClinicComparisonMetrics, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFindingDetail, type ClinicalFindings, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CostPerPatientMetrics, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DASHBOARD_ANALYTICS_SUBCOLLECTION, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DashboardAnalytics, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DurationTrend, type DynamicTextElement, DynamicVariable, type EmergencyContact, type EntityType, EnvironmentalAllergySubtype, type ExtendedProcedureInfo, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NextStepsRecommendation, type NoShowMetrics, type Notification, NotificationService, NotificationStatus, NotificationType, type OverallReviewAverages, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type ParagraphElement, type PatientAnalytics, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLifetimeValueMetrics, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientRetentionMetrics, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerAnalytics, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureAnalytics, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedurePopularity, type ProcedureProduct, type ProcedureProfitability, type ProcedureRecommendationNotification, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, type ProductRevenueMetrics, ProductService, type ProductUsageByProcedure, type ProductUsageMetrics, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVENUE_ANALYTICS_SUBCOLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type ReadStoredAnalyticsOptions, type RecommendedProcedure, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, type RequirementSourceProcedure, RequirementType, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAnalyticsMetrics, ReviewAnalyticsService, type ReviewDetail, type ReviewMetrics, type ReviewRequestNotification, ReviewService, type ReviewTrend, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeEfficiencyMetrics, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, type TrendPeriod, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZoneItemData, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };
+export { AESTHETIC_ANALYSIS_COLLECTION, ANALYTICS_COLLECTION, APPOINTMENTS_COLLECTION, AcquisitionSource, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type AestheticAnalysisStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, AnalyticsCloudService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, AnalyticsService, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentProductMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AppointmentTrend, type AssessmentScales, AuthService, type BaseDocumentElement, type BaseMetrics, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, type Break, CALENDAR_COLLECTION, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicAnalytics, type ClinicBranchSetupData, type ClinicComparisonMetrics, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFindingDetail, type ClinicalFindings, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CostPerPatientMetrics, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DASHBOARD_ANALYTICS_SUBCOLLECTION, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DashboardAnalytics, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DurationTrend, type DynamicTextElement, DynamicVariable, type EmergencyContact, type EntityType, EnvironmentalAllergySubtype, type ExtendedProcedureInfo, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NextStepsRecommendation, type NoShowMetrics, type Notification, NotificationService, NotificationStatus, NotificationType, type OverallReviewAverages, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type ParagraphElement, type PatientAnalytics, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLifetimeValueMetrics, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientRetentionMetrics, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerAnalytics, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureAnalytics, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedurePopularity, type ProcedureProduct, type ProcedureProfitability, type ProcedureRecommendationNotification, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, type ProductRevenueMetrics, ProductService, type ProductUsageByProcedure, type ProductUsageMetrics, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVENUE_ANALYTICS_SUBCOLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type ReadStoredAnalyticsOptions, type RecommendedProcedure, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, type RequirementSourceProcedure, RequirementType, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAnalyticsMetrics, ReviewAnalyticsService, type ReviewDetail, type ReviewMetrics, type ReviewRequestNotification, ReviewService, type ReviewTrend, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeEfficiencyMetrics, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, type TrendPeriod, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZoneItemData, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Firestore, FieldValue, DocumentData, QueryDocumentSnapshot, Timestamp, DocumentSnapshot } from 'firebase/firestore';
+import { Firestore, Timestamp, FieldValue, DocumentData, QueryDocumentSnapshot, DocumentSnapshot } from 'firebase/firestore';
 import { Auth, User as User$1 } from 'firebase/auth';
 import { FirebaseApp } from 'firebase/app';
 import { FirebaseStorage } from 'firebase/storage';
@@ -1122,6 +1122,18 @@ declare enum UserRole {
     APP_ADMIN = "app_admin",
     CLINIC_ADMIN = "clinic_admin"
 }
+/**
+ * Enum for acquisition source - how the user found out about the app
+ */
+declare enum AcquisitionSource {
+    FRIEND_FAMILY = "friend_family",
+    ONLINE_SEARCH = "online_search",
+    SOCIAL_MEDIA_AD = "social_media_ad",
+    TRADITIONAL_AD = "traditional_ad",
+    BLOG_ARTICLE = "blog_article",
+    HEALTHCARE_PROVIDER = "healthcare_provider",
+    OTHER = "other"
+}
 interface User {
     uid: string;
     email: string | null;
@@ -1133,6 +1145,12 @@ interface User {
     patientProfile?: string;
     practitionerProfile?: string;
     adminProfile?: string;
+    /** How the user found out about the app (marketing attribution) */
+    acquisitionSource?: AcquisitionSource | null;
+    /** Custom text when acquisitionSource is 'other' */
+    acquisitionSourceOther?: string | null;
+    /** Timestamp when acquisition source was collected */
+    acquisitionSourceTimestamp?: Timestamp | null;
 }
 interface CreateUserData {
     uid: string;
@@ -1142,6 +1160,9 @@ interface CreateUserData {
     createdAt: FieldValue;
     updatedAt: FieldValue;
     lastLoginAt: FieldValue;
+    acquisitionSource?: AcquisitionSource | null;
+    acquisitionSourceOther?: string | null;
+    acquisitionSourceTimestamp?: FieldValue | Timestamp | null;
 }
 declare const USERS_COLLECTION = "users";
 type FirebaseUser = User$1;
@@ -8324,6 +8345,15 @@ declare class UserService extends BaseService {
      * Uklanja rolu korisniku i briše odgovarajući profil
      */
     removeRoleAndProfile(uid: string, role: UserRole): Promise<void>;
+    /**
+     * Updates the acquisition source information for a user
+     * @param uid - User ID
+     * @param data - Acquisition source data
+     */
+    updateAcquisitionSource(uid: string, data: {
+        acquisitionSource: AcquisitionSource | null;
+        acquisitionSourceOther?: string | null;
+    }): Promise<void>;
     deleteUser(uid: string): Promise<void>;
 }
 
@@ -9212,4 +9242,4 @@ declare const getFirebaseApp: () => Promise<FirebaseApp>;
 declare const getFirebaseStorage: () => Promise<FirebaseStorage>;
 declare const getFirebaseFunctions: () => Promise<Functions>;
 
-export { AESTHETIC_ANALYSIS_COLLECTION, ANALYTICS_COLLECTION, APPOINTMENTS_COLLECTION, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type AestheticAnalysisStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, AnalyticsCloudService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, AnalyticsService, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentProductMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AppointmentTrend, type AssessmentScales, AuthService, type BaseDocumentElement, type BaseMetrics, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, type Break, CALENDAR_COLLECTION, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicAnalytics, type ClinicBranchSetupData, type ClinicComparisonMetrics, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFindingDetail, type ClinicalFindings, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CostPerPatientMetrics, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DASHBOARD_ANALYTICS_SUBCOLLECTION, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DashboardAnalytics, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DurationTrend, type DynamicTextElement, DynamicVariable, type EmergencyContact, type EntityType, EnvironmentalAllergySubtype, type ExtendedProcedureInfo, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NextStepsRecommendation, type NoShowMetrics, type Notification, NotificationService, NotificationStatus, NotificationType, type OverallReviewAverages, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type ParagraphElement, type PatientAnalytics, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLifetimeValueMetrics, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientRetentionMetrics, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerAnalytics, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureAnalytics, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedurePopularity, type ProcedureProduct, type ProcedureProfitability, type ProcedureRecommendationNotification, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, type ProductRevenueMetrics, ProductService, type ProductUsageByProcedure, type ProductUsageMetrics, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVENUE_ANALYTICS_SUBCOLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type ReadStoredAnalyticsOptions, type RecommendedProcedure, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, type RequirementSourceProcedure, RequirementType, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAnalyticsMetrics, ReviewAnalyticsService, type ReviewDetail, type ReviewMetrics, type ReviewRequestNotification, ReviewService, type ReviewTrend, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeEfficiencyMetrics, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, type TrendPeriod, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZoneItemData, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };
+export { AESTHETIC_ANALYSIS_COLLECTION, ANALYTICS_COLLECTION, APPOINTMENTS_COLLECTION, AcquisitionSource, type AddAllergyData, type AddBlockingConditionData, type AddContraindicationData, type AddMedicationData, type AddressData, type AdminInfo, type AdminToken, AdminTokenStatus, type AestheticAnalysis, type AestheticAnalysisStatus, type Allergy, type AllergySubtype, AllergyType, type AllergyTypeWithSubtype, AnalyticsCloudService, type AnalyticsDateRange, type AnalyticsFilters, type AnalyticsMetadata, type AnalyticsPeriod, AnalyticsService, type Appointment, type AppointmentCancelledNotification, type AppointmentMediaItem, type AppointmentMetadata, type AppointmentProductMetadata, type AppointmentReminderNotification, type AppointmentRescheduledProposalNotification, AppointmentService, AppointmentStatus, type AppointmentStatusChangeNotification, type AppointmentTrend, type AssessmentScales, AuthService, type BaseDocumentElement, type BaseMetrics, type BaseNotification, BaseService, type BeforeAfterPerZone, type BillingInfo, type BillingPerZone, type BillingTransaction, BillingTransactionType, BillingTransactionsService, type BinaryChoiceElement, BlockingCondition, type Brand, BrandService, type Break, CALENDAR_COLLECTION, CANCELLATION_ANALYTICS_SUBCOLLECTION, CLINICS_COLLECTION, CLINIC_ADMINS_COLLECTION, CLINIC_ANALYTICS_SUBCOLLECTION, CLINIC_GROUPS_COLLECTION, type CalendarEvent, CalendarEventStatus, type CalendarEventTime, CalendarEventType, CalendarServiceV2, CalendarServiceV3, CalendarSyncStatus, type CancellationMetrics, type CancellationRateTrend, type CancellationReasonStats, type Category, CategoryService, CertificationLevel, CertificationSpecialty, type Clinic, type ClinicAdmin, ClinicAdminService, type ClinicAdminSignupData, type ClinicAnalytics, type ClinicBranchSetupData, type ClinicComparisonMetrics, type ClinicContactInfo, type ClinicGroup, ClinicGroupService, type ClinicGroupSetupData, type ClinicInfo, type ClinicLocation, ClinicPhotoTag, type ClinicReview, type ClinicReviewInfo, ClinicService, ClinicTag, type ClinicTags, type ClinicalFindingDetail, type ClinicalFindings, ConstantsService, type ContactPerson, Contraindication, type ContraindicationDynamic, CosmeticAllergySubtype, type CostPerPatientMetrics, type CreateAdminTokenData, type CreateAestheticAnalysisData, type CreateAppointmentData, type CreateAppointmentHttpData, type CreateAppointmentParams, type CreateBillingTransactionData, type CreateBlockingEventParams, type CreateCalendarEventData, type CreateClinicAdminData, type CreateClinicData, type CreateClinicGroupData, type CreateDefaultClinicGroupData, type CreateDocumentTemplateData, type CreateDraftPractitionerData, type CreateManualPatientData, type CreatePatientLocationInfoData, type CreatePatientMedicalInfoData, type CreatePatientProfileData, type CreatePatientSensitiveInfoData, type CreatePatientTokenData, type CreatePractitionerData, type CreatePractitionerInviteData, type CreatePractitionerTokenData, type CreateProcedureData, type CreateSyncedCalendarData, type CreateUserData, Currency, DASHBOARD_ANALYTICS_SUBCOLLECTION, DEFAULT_MEDICAL_INFO, DOCTOR_FORMS_SUBCOLLECTION, DOCUMENTATION_TEMPLATES_COLLECTION, type DashboardAnalytics, type DatePickerElement, type DateRange, type DigitalSignatureElement, type DoctorInfo, type DocumentElement, DocumentElementType, type DocumentTemplate, DocumentationTemplateService, type DurationTrend, type DynamicTextElement, DynamicVariable, type EmergencyContact, type EntityType, EnvironmentalAllergySubtype, type ExtendedProcedureInfo, ExternalCalendarService, FILLED_DOCUMENTS_COLLECTION, type FileUploadElement, type FilledDocument, type FilledDocumentFileValue, FilledDocumentService, FilledDocumentStatus, type FinalBilling, type FirebaseUser, FoodAllergySubtype, type FormReminderNotification, type FormSubmissionConfirmationNotification, type GamificationInfo, Gender, type GeneralMessageNotification, type GroupedAnalyticsBase, type GroupedPatientBehaviorMetrics, type GroupedPatientRetentionMetrics, type GroupedPractitionerPerformanceMetrics, type GroupedProcedurePerformanceMetrics, type GroupedProductUsageMetrics, type GroupedRevenueMetrics, type GroupedTimeEfficiencyMetrics, type GroupingPeriod, type HeadingElement, HeadingLevel, INVITE_TOKENS_COLLECTION, Language, type LinkedFormInfo, type ListElement, ListType, type LocationData, MEDIA_METADATA_COLLECTION, MediaAccessLevel, type MediaMetadata, type MediaResource, MediaService, MediaType, MedicationAllergySubtype, type MultipleChoiceElement, NOTIFICATIONS_COLLECTION, NO_SHOW_ANALYTICS_SUBCOLLECTION, type NextStepsRecommendation, type NoShowMetrics, type Notification, NotificationService, NotificationStatus, NotificationType, type OverallReviewAverages, PATIENTS_COLLECTION, PATIENT_APPOINTMENTS_COLLECTION, PATIENT_LOCATION_INFO_COLLECTION, PATIENT_MEDICAL_HISTORY_COLLECTION, PATIENT_MEDICAL_INFO_COLLECTION, PATIENT_REQUIREMENTS_SUBCOLLECTION_NAME, PATIENT_SENSITIVE_INFO_COLLECTION, PRACTITIONERS_COLLECTION, PRACTITIONER_ANALYTICS_SUBCOLLECTION, PRACTITIONER_INVITES_COLLECTION, PROCEDURES_COLLECTION, PROCEDURE_ANALYTICS_SUBCOLLECTION, type ParagraphElement, type PatientAnalytics, type PatientClinic, type PatientDoctor, type PatientGoals, PatientInstructionStatus, type PatientLifetimeValueMetrics, type PatientLocationInfo, type PatientMedicalInfo, type PatientProfile, type PatientProfileComplete, type PatientProfileForDoctor, type PatientProfileInfo, type PatientRequirementInstance, type PatientRequirementInstruction, PatientRequirementOverallStatus, type PatientRequirementsFilters, PatientRequirementsService, type PatientRetentionMetrics, type PatientReviewInfo, type PatientSensitiveInfo, PatientService, type PatientToken, PatientTokenStatus, type PaymentConfirmationNotification, PaymentStatus, type PaymentStatusBreakdown, type PlanDetails, type PostRequirementNotification, PracticeType, type Practitioner, type PractitionerAnalytics, type PractitionerBasicInfo, type PractitionerCertification, type PractitionerClinicProcedures, type PractitionerClinicWorkingHours, type PractitionerInvite, type PractitionerInviteFilters, PractitionerInviteService, PractitionerInviteStatus, type PractitionerProfileInfo, type PractitionerReview, type PractitionerReviewInfo, PractitionerService, PractitionerStatus, type PractitionerToken, PractitionerTokenStatus, type PractitionerWorkingHours, type PreRequirementNotification, PricingMeasure, type Procedure, type ProcedureAnalytics, type ProcedureCategorization, type ProcedureExtendedInfo, ProcedureFamily, type ProcedureInfo, type ProcedurePopularity, type ProcedureProduct, type ProcedureProfitability, type ProcedureRecommendationNotification, type ProcedureReview, type ProcedureReviewInfo, ProcedureService, type ProcedureSummaryInfo, type Product, type ProductRevenueMetrics, ProductService, type ProductUsageByProcedure, type ProductUsageMetrics, type ProposedWorkingHours, REGISTER_TOKENS_COLLECTION, REVENUE_ANALYTICS_SUBCOLLECTION, REVIEWS_COLLECTION, type RatingScaleElement, type ReadStoredAnalyticsOptions, type RecommendedProcedure, type RequesterInfo, type Requirement, type RequirementInstructionDueNotification, type RequirementSourceProcedure, RequirementType, type RevenueMetrics, type RevenueTrend, type Review, type ReviewAnalyticsMetrics, ReviewAnalyticsService, type ReviewDetail, type ReviewMetrics, type ReviewRequestNotification, ReviewService, type ReviewTrend, SYNCED_CALENDARS_COLLECTION, type SearchAppointmentsParams, type SearchCalendarEventsParams, SearchLocationEnum, type SearchPatientsParams, type SignatureElement, type SingleChoiceElement, type StoredCancellationMetrics, type StoredClinicAnalytics, type StoredDashboardAnalytics, type StoredNoShowMetrics, type StoredPractitionerAnalytics, type StoredProcedureAnalytics, type StoredRevenueMetrics, type StoredTimeEfficiencyMetrics, type StripeTransactionData, type Subcategory, SubcategoryService, SubscriptionModel, SubscriptionStatus, type SyncedCalendar, type SyncedCalendarEvent, SyncedCalendarProvider, SyncedCalendarsService, TIME_EFFICIENCY_ANALYTICS_SUBCOLLECTION, type Technology, type TechnologyDocumentationTemplate, TechnologyService, type TextInputElement, type TimeEfficiencyMetrics, type TimeSlot, TimeUnit, TreatmentBenefit, type TreatmentBenefitDynamic, type TrendPeriod, USERS_COLLECTION, USER_FORMS_SUBCOLLECTION, type UpdateAestheticAnalysisData, type UpdateAllergyData, type UpdateAppointmentData, type UpdateAppointmentParams, type UpdateBlockingConditionData, type UpdateBlockingEventParams, type UpdateCalendarEventData, type UpdateClinicAdminData, type UpdateClinicData, type UpdateClinicGroupData, type UpdateContraindicationData, type UpdateDocumentTemplateData, type UpdateMedicationData, type UpdatePatientLocationInfoData, type UpdatePatientMedicalInfoData, type UpdatePatientProfileData, type UpdatePatientSensitiveInfoData, type UpdatePractitionerData, type UpdatePractitionerInviteData, type UpdateProcedureData, type UpdateSyncedCalendarData, type UpdateVitalStatsData, type User, UserRole, UserService, type VitalStats, type WorkingHours, type ZoneItemData, type ZonePhotoUploadData, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstance, getFirebaseStorage, initializeFirebase };

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   AESTHETIC_ANALYSIS_COLLECTION: () => AESTHETIC_ANALYSIS_COLLECTION,
   ANALYTICS_COLLECTION: () => ANALYTICS_COLLECTION,
   APPOINTMENTS_COLLECTION: () => APPOINTMENTS_COLLECTION,
+  AcquisitionSource: () => AcquisitionSource,
   AdminTokenStatus: () => AdminTokenStatus,
   AllergyType: () => AllergyType,
   AnalyticsCloudService: () => AnalyticsCloudService,
@@ -7231,6 +7232,16 @@ var UserRole = /* @__PURE__ */ ((UserRole2) => {
   UserRole2["CLINIC_ADMIN"] = "clinic_admin";
   return UserRole2;
 })(UserRole || {});
+var AcquisitionSource = /* @__PURE__ */ ((AcquisitionSource2) => {
+  AcquisitionSource2["FRIEND_FAMILY"] = "friend_family";
+  AcquisitionSource2["ONLINE_SEARCH"] = "online_search";
+  AcquisitionSource2["SOCIAL_MEDIA_AD"] = "social_media_ad";
+  AcquisitionSource2["TRADITIONAL_AD"] = "traditional_ad";
+  AcquisitionSource2["BLOG_ARTICLE"] = "blog_article";
+  AcquisitionSource2["HEALTHCARE_PROVIDER"] = "healthcare_provider";
+  AcquisitionSource2["OTHER"] = "other";
+  return AcquisitionSource2;
+})(AcquisitionSource || {});
 var USERS_COLLECTION = "users";
 
 // src/types/calendar/synced-calendar.types.ts
@@ -7366,6 +7377,7 @@ var passwordSchema = import_zod4.z.string().min(8, "Password must be at least 8
 );
 var userRoleSchema = import_zod4.z.nativeEnum(UserRole);
 var userRolesSchema = import_zod4.z.array(userRoleSchema).min(1, "User must have at least one role").max(3, "User cannot have more than 3 roles");
+var acquisitionSourceSchema = import_zod4.z.nativeEnum(AcquisitionSource);
 var clinicAdminOptionsSchema = import_zod4.z.object({
   isGroupOwner: import_zod4.z.boolean(),
   groupToken: import_zod4.z.string().optional(),
@@ -7397,7 +7409,10 @@ var userSchema = import_zod4.z.object({
   lastLoginAt: import_zod4.z.any(),
   patientProfile: import_zod4.z.string().optional(),
   practitionerProfile: import_zod4.z.string().optional(),
-  adminProfile: import_zod4.z.string().optional()
+  adminProfile: import_zod4.z.string().optional(),
+  acquisitionSource: acquisitionSourceSchema.nullable().optional(),
+  acquisitionSourceOther: import_zod4.z.string().max(200).nullable().optional(),
+  acquisitionSourceTimestamp: import_zod4.z.any().nullable().optional()
 });
 
 // src/errors/auth.errors.ts
@@ -13274,6 +13289,29 @@ var UserService = class extends BaseService {
       updatedAt: (0, import_firestore33.serverTimestamp)()
     });
   }
+  /**
+   * Updates the acquisition source information for a user
+   * @param uid - User ID
+   * @param data - Acquisition source data
+   */
+  async updateAcquisitionSource(uid, data) {
+    const userRef = (0, import_firestore33.doc)(this.db, USERS_COLLECTION, uid);
+    const userDoc = await (0, import_firestore33.getDoc)(userRef);
+    if (!userDoc.exists()) {
+      throw USER_ERRORS.NOT_FOUND;
+    }
+    const updateData = {
+      acquisitionSource: data.acquisitionSource,
+      acquisitionSourceTimestamp: import_firestore33.Timestamp.now(),
+      updatedAt: (0, import_firestore33.serverTimestamp)()
+    };
+    if (data.acquisitionSource === "other" /* OTHER */) {
+      updateData.acquisitionSourceOther = data.acquisitionSourceOther || null;
+    } else {
+      updateData.acquisitionSourceOther = null;
+    }
+    await (0, import_firestore33.updateDoc)(userRef, updateData);
+  }
   // Delete operations
   async deleteUser(uid) {
     const userRef = (0, import_firestore33.doc)(this.db, USERS_COLLECTION, uid);
@@ -25846,6 +25884,7 @@ var RequirementType = /* @__PURE__ */ ((RequirementType2) => {
   AESTHETIC_ANALYSIS_COLLECTION,
   ANALYTICS_COLLECTION,
   APPOINTMENTS_COLLECTION,
+  AcquisitionSource,
   AdminTokenStatus,
   AllergyType,
   AnalyticsCloudService,

package/dist/index.mjs

@@ -7137,6 +7137,16 @@ var UserRole = /* @__PURE__ */ ((UserRole2) => {
   UserRole2["CLINIC_ADMIN"] = "clinic_admin";
   return UserRole2;
 })(UserRole || {});
+var AcquisitionSource = /* @__PURE__ */ ((AcquisitionSource2) => {
+  AcquisitionSource2["FRIEND_FAMILY"] = "friend_family";
+  AcquisitionSource2["ONLINE_SEARCH"] = "online_search";
+  AcquisitionSource2["SOCIAL_MEDIA_AD"] = "social_media_ad";
+  AcquisitionSource2["TRADITIONAL_AD"] = "traditional_ad";
+  AcquisitionSource2["BLOG_ARTICLE"] = "blog_article";
+  AcquisitionSource2["HEALTHCARE_PROVIDER"] = "healthcare_provider";
+  AcquisitionSource2["OTHER"] = "other";
+  return AcquisitionSource2;
+})(AcquisitionSource || {});
 var USERS_COLLECTION = "users";
 
 // src/types/calendar/synced-calendar.types.ts
@@ -7272,6 +7282,7 @@ var passwordSchema = z4.string().min(8, "Password must be at least 8 characters"
 );
 var userRoleSchema = z4.nativeEnum(UserRole);
 var userRolesSchema = z4.array(userRoleSchema).min(1, "User must have at least one role").max(3, "User cannot have more than 3 roles");
+var acquisitionSourceSchema = z4.nativeEnum(AcquisitionSource);
 var clinicAdminOptionsSchema = z4.object({
   isGroupOwner: z4.boolean(),
   groupToken: z4.string().optional(),
@@ -7303,7 +7314,10 @@ var userSchema = z4.object({
   lastLoginAt: z4.any(),
   patientProfile: z4.string().optional(),
   practitionerProfile: z4.string().optional(),
-  adminProfile: z4.string().optional()
+  adminProfile: z4.string().optional(),
+  acquisitionSource: acquisitionSourceSchema.nullable().optional(),
+  acquisitionSourceOther: z4.string().max(200).nullable().optional(),
+  acquisitionSourceTimestamp: z4.any().nullable().optional()
 });
 
 // src/errors/auth.errors.ts
@@ -13297,6 +13311,29 @@ var UserService = class extends BaseService {
       updatedAt: serverTimestamp18()
     });
   }
+  /**
+   * Updates the acquisition source information for a user
+   * @param uid - User ID
+   * @param data - Acquisition source data
+   */
+  async updateAcquisitionSource(uid, data) {
+    const userRef = doc21(this.db, USERS_COLLECTION, uid);
+    const userDoc = await getDoc23(userRef);
+    if (!userDoc.exists()) {
+      throw USER_ERRORS.NOT_FOUND;
+    }
+    const updateData = {
+      acquisitionSource: data.acquisitionSource,
+      acquisitionSourceTimestamp: Timestamp18.now(),
+      updatedAt: serverTimestamp18()
+    };
+    if (data.acquisitionSource === "other" /* OTHER */) {
+      updateData.acquisitionSourceOther = data.acquisitionSourceOther || null;
+    } else {
+      updateData.acquisitionSourceOther = null;
+    }
+    await updateDoc17(userRef, updateData);
+  }
   // Delete operations
   async deleteUser(uid) {
     const userRef = doc21(this.db, USERS_COLLECTION, uid);
@@ -26169,6 +26206,7 @@ export {
   AESTHETIC_ANALYSIS_COLLECTION,
   ANALYTICS_COLLECTION,
   APPOINTMENTS_COLLECTION,
+  AcquisitionSource,
   AdminTokenStatus,
   AllergyType,
   AnalyticsCloudService,

package/package.json

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

package/src/services/user/user.service.ts

@@ -13,7 +13,7 @@ import {
   serverTimestamp,
 } from 'firebase/firestore';
 import { initializeFirebase } from '../../config/firebase';
-import { User, UserRole, USERS_COLLECTION, CreateUserData } from '../../types';
+import { User, UserRole, USERS_COLLECTION, CreateUserData, AcquisitionSource } from '../../types';
 import { userSchema } from '../../validations/schemas';
 import { AuthError } from '../../errors/auth.errors';
 import { USER_ERRORS } from '../../errors/user.errors';
@@ -453,6 +453,47 @@ export class UserService extends BaseService {
     });
   }
 
+  /**
+   * Updates the acquisition source information for a user
+   * @param uid - User ID
+   * @param data - Acquisition source data
+   */
+  async updateAcquisitionSource(
+    uid: string,
+    data: {
+      acquisitionSource: AcquisitionSource | null;
+      acquisitionSourceOther?: string | null;
+    }
+  ): Promise<void> {
+    const userRef = doc(this.db, USERS_COLLECTION, uid);
+    const userDoc = await getDoc(userRef);
+
+    if (!userDoc.exists()) {
+      throw USER_ERRORS.NOT_FOUND;
+    }
+
+    const updateData: {
+      acquisitionSource: AcquisitionSource | null;
+      acquisitionSourceOther?: string | null;
+      acquisitionSourceTimestamp: Timestamp;
+      updatedAt: ReturnType<typeof serverTimestamp>;
+    } = {
+      acquisitionSource: data.acquisitionSource,
+      acquisitionSourceTimestamp: Timestamp.now(),
+      updatedAt: serverTimestamp(),
+    };
+
+    // Only include acquisitionSourceOther if acquisitionSource is 'other'
+    if (data.acquisitionSource === AcquisitionSource.OTHER) {
+      updateData.acquisitionSourceOther = data.acquisitionSourceOther || null;
+    } else {
+      // Clear acquisitionSourceOther if not 'other'
+      updateData.acquisitionSourceOther = null;
+    }
+
+    await updateDoc(userRef, updateData);
+  }
+
   // Delete operations
   async deleteUser(uid: string): Promise<void> {
     const userRef = doc(this.db, USERS_COLLECTION, uid);

package/src/types/user/index.ts

@@ -9,6 +9,19 @@ export enum UserRole {
   CLINIC_ADMIN = "clinic_admin",
 }
 
+/**
+ * Enum for acquisition source - how the user found out about the app
+ */
+export enum AcquisitionSource {
+  FRIEND_FAMILY = "friend_family",
+  ONLINE_SEARCH = "online_search",
+  SOCIAL_MEDIA_AD = "social_media_ad",
+  TRADITIONAL_AD = "traditional_ad",
+  BLOG_ARTICLE = "blog_article",
+  HEALTHCARE_PROVIDER = "healthcare_provider",
+  OTHER = "other",
+}
+
 export interface User {
   uid: string;
   email: string | null;
@@ -20,6 +33,12 @@ export interface User {
   patientProfile?: string;
   practitionerProfile?: string;
   adminProfile?: string;
+  /** How the user found out about the app (marketing attribution) */
+  acquisitionSource?: AcquisitionSource | null;
+  /** Custom text when acquisitionSource is 'other' */
+  acquisitionSourceOther?: string | null;
+  /** Timestamp when acquisition source was collected */
+  acquisitionSourceTimestamp?: Timestamp | null;
 }
 
 export interface CreateUserData {
@@ -30,6 +49,9 @@ export interface CreateUserData {
   createdAt: FieldValue;
   updatedAt: FieldValue;
   lastLoginAt: FieldValue;
+  acquisitionSource?: AcquisitionSource | null;
+  acquisitionSourceOther?: string | null;
+  acquisitionSourceTimestamp?: FieldValue | Timestamp | null;
 }
 
 export const USERS_COLLECTION = "users";

package/src/validations/schemas.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { UserRole } from "../types";
+import { UserRole, AcquisitionSource } from "../types";
 import { Timestamp, FieldValue } from "firebase/firestore";
 
 export const emailSchema = z
@@ -24,6 +24,8 @@ export const userRolesSchema = z
   .min(1, "User must have at least one role")
   .max(3, "User cannot have more than 3 roles");
 
+export const acquisitionSourceSchema = z.nativeEnum(AcquisitionSource);
+
 // export const timestampSchema = z.custom<Timestamp | FieldValue | Date>(
 //   (data) => {
 //     // If it's a serverTimestamp (FieldValue), it's valid
@@ -96,6 +98,9 @@ export const userSchema = z.object({
   patientProfile: z.string().optional(),
   practitionerProfile: z.string().optional(),
   adminProfile: z.string().optional(),
+  acquisitionSource: acquisitionSourceSchema.nullable().optional(),
+  acquisitionSourceOther: z.string().max(200).nullable().optional(),
+  acquisitionSourceTimestamp: z.any().nullable().optional(),
 });
 
 export type ValidationSchema = z.infer<typeof userSchema>;