@blackcode_sa/metaestetics-api 1.12.62 → 1.12.63

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (273) hide show
  1. package/dist/admin/index.d.mts +4 -2
  2. package/dist/admin/index.d.ts +4 -2
  3. package/dist/admin/index.js +4 -45
  4. package/dist/admin/index.mjs +4 -45
  5. package/dist/backoffice/index.d.mts +9 -0
  6. package/dist/backoffice/index.d.ts +9 -0
  7. package/dist/backoffice/index.js +11 -0
  8. package/dist/backoffice/index.mjs +11 -0
  9. package/dist/index.d.mts +99 -3
  10. package/dist/index.d.ts +99 -3
  11. package/dist/index.js +545 -281
  12. package/dist/index.mjs +867 -603
  13. package/package.json +119 -119
  14. package/src/__mocks__/firstore.ts +10 -10
  15. package/src/admin/aggregation/README.md +79 -79
  16. package/src/admin/aggregation/appointment/README.md +128 -128
  17. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1844 -1844
  18. package/src/admin/aggregation/appointment/index.ts +1 -1
  19. package/src/admin/aggregation/clinic/README.md +52 -52
  20. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +703 -703
  21. package/src/admin/aggregation/clinic/index.ts +1 -1
  22. package/src/admin/aggregation/forms/README.md +13 -13
  23. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  24. package/src/admin/aggregation/forms/index.ts +1 -1
  25. package/src/admin/aggregation/index.ts +8 -8
  26. package/src/admin/aggregation/patient/README.md +27 -27
  27. package/src/admin/aggregation/patient/index.ts +1 -1
  28. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  29. package/src/admin/aggregation/practitioner/README.md +42 -42
  30. package/src/admin/aggregation/practitioner/index.ts +1 -1
  31. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  32. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  33. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  34. package/src/admin/aggregation/procedure/README.md +43 -43
  35. package/src/admin/aggregation/procedure/index.ts +1 -1
  36. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  37. package/src/admin/aggregation/reviews/index.ts +1 -1
  38. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +641 -689
  39. package/src/admin/booking/README.md +125 -125
  40. package/src/admin/booking/booking.admin.ts +1037 -1037
  41. package/src/admin/booking/booking.calculator.ts +712 -712
  42. package/src/admin/booking/booking.types.ts +59 -59
  43. package/src/admin/booking/index.ts +3 -3
  44. package/src/admin/booking/timezones-problem.md +185 -185
  45. package/src/admin/calendar/README.md +7 -7
  46. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  47. package/src/admin/calendar/index.ts +1 -1
  48. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  49. package/src/admin/documentation-templates/index.ts +1 -1
  50. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  51. package/src/admin/free-consultation/index.ts +1 -1
  52. package/src/admin/index.ts +75 -75
  53. package/src/admin/logger/index.ts +78 -78
  54. package/src/admin/mailing/README.md +95 -95
  55. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  56. package/src/admin/mailing/appointment/index.ts +1 -1
  57. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  58. package/src/admin/mailing/base.mailing.service.ts +208 -208
  59. package/src/admin/mailing/index.ts +3 -3
  60. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  61. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  62. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  63. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  64. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  65. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  66. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  67. package/src/admin/notifications/index.ts +1 -1
  68. package/src/admin/notifications/notifications.admin.ts +710 -710
  69. package/src/admin/requirements/README.md +128 -128
  70. package/src/admin/requirements/index.ts +1 -1
  71. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  72. package/src/admin/users/index.ts +1 -1
  73. package/src/admin/users/user-profile.admin.ts +405 -405
  74. package/src/backoffice/constants/certification.constants.ts +13 -13
  75. package/src/backoffice/constants/index.ts +1 -1
  76. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  77. package/src/backoffice/errors/index.ts +1 -1
  78. package/src/backoffice/expo-safe/README.md +26 -26
  79. package/src/backoffice/expo-safe/index.ts +41 -41
  80. package/src/backoffice/index.ts +5 -5
  81. package/src/backoffice/services/FIXES_README.md +102 -102
  82. package/src/backoffice/services/README.md +40 -40
  83. package/src/backoffice/services/brand.service.ts +256 -256
  84. package/src/backoffice/services/category.service.ts +318 -318
  85. package/src/backoffice/services/constants.service.ts +385 -385
  86. package/src/backoffice/services/documentation-template.service.ts +202 -202
  87. package/src/backoffice/services/index.ts +8 -8
  88. package/src/backoffice/services/migrate-products.ts +116 -116
  89. package/src/backoffice/services/product.service.ts +553 -553
  90. package/src/backoffice/services/requirement.service.ts +235 -235
  91. package/src/backoffice/services/subcategory.service.ts +395 -395
  92. package/src/backoffice/services/technology.service.ts +1083 -1070
  93. package/src/backoffice/types/README.md +12 -12
  94. package/src/backoffice/types/admin-constants.types.ts +69 -69
  95. package/src/backoffice/types/brand.types.ts +29 -29
  96. package/src/backoffice/types/category.types.ts +62 -62
  97. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  98. package/src/backoffice/types/index.ts +10 -10
  99. package/src/backoffice/types/procedure-product.types.ts +38 -38
  100. package/src/backoffice/types/product.types.ts +240 -240
  101. package/src/backoffice/types/requirement.types.ts +63 -63
  102. package/src/backoffice/types/static/README.md +18 -18
  103. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  104. package/src/backoffice/types/static/certification.types.ts +37 -37
  105. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  106. package/src/backoffice/types/static/index.ts +6 -6
  107. package/src/backoffice/types/static/pricing.types.ts +16 -16
  108. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  109. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  110. package/src/backoffice/types/subcategory.types.ts +34 -34
  111. package/src/backoffice/types/technology.types.ts +163 -161
  112. package/src/backoffice/validations/index.ts +1 -1
  113. package/src/backoffice/validations/schemas.ts +164 -163
  114. package/src/config/__mocks__/firebase.ts +99 -99
  115. package/src/config/firebase.ts +78 -78
  116. package/src/config/index.ts +9 -9
  117. package/src/errors/auth.error.ts +6 -6
  118. package/src/errors/auth.errors.ts +200 -200
  119. package/src/errors/clinic.errors.ts +32 -32
  120. package/src/errors/firebase.errors.ts +47 -47
  121. package/src/errors/user.errors.ts +99 -99
  122. package/src/index.backup.ts +407 -407
  123. package/src/index.ts +6 -6
  124. package/src/locales/en.ts +31 -31
  125. package/src/recommender/admin/index.ts +1 -1
  126. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  127. package/src/recommender/front/index.ts +1 -1
  128. package/src/recommender/front/services/onboarding.service.ts +5 -5
  129. package/src/recommender/front/services/recommender.service.ts +3 -3
  130. package/src/recommender/index.ts +1 -1
  131. package/src/services/PATIENTAUTH.MD +197 -197
  132. package/src/services/README.md +106 -106
  133. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  134. package/src/services/__tests__/auth/auth.setup.ts +293 -293
  135. package/src/services/__tests__/auth.service.test.ts +346 -346
  136. package/src/services/__tests__/base.service.test.ts +77 -77
  137. package/src/services/__tests__/user.service.test.ts +528 -528
  138. package/src/services/appointment/README.md +17 -17
  139. package/src/services/appointment/appointment.service.ts +2505 -2082
  140. package/src/services/appointment/index.ts +1 -1
  141. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  142. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  143. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  144. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  145. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  146. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  147. package/src/services/auth/auth.service.ts +989 -989
  148. package/src/services/auth/auth.v2.service.ts +961 -961
  149. package/src/services/auth/index.ts +7 -7
  150. package/src/services/auth/utils/error.utils.ts +90 -90
  151. package/src/services/auth/utils/firebase.utils.ts +49 -49
  152. package/src/services/auth/utils/index.ts +21 -21
  153. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  154. package/src/services/base.service.ts +41 -41
  155. package/src/services/calendar/calendar.service.ts +1077 -1077
  156. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  157. package/src/services/calendar/calendar.v3.service.ts +313 -313
  158. package/src/services/calendar/externalCalendar.service.ts +178 -178
  159. package/src/services/calendar/index.ts +5 -5
  160. package/src/services/calendar/synced-calendars.service.ts +743 -743
  161. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  162. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  163. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  164. package/src/services/calendar/utils/docs.utils.ts +157 -157
  165. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  166. package/src/services/calendar/utils/index.ts +8 -8
  167. package/src/services/calendar/utils/patient.utils.ts +198 -198
  168. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  169. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  170. package/src/services/clinic/README.md +204 -204
  171. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  172. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  173. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  174. package/src/services/clinic/billing-transactions.service.ts +217 -217
  175. package/src/services/clinic/clinic-admin.service.ts +202 -202
  176. package/src/services/clinic/clinic-group.service.ts +310 -310
  177. package/src/services/clinic/clinic.service.ts +708 -708
  178. package/src/services/clinic/index.ts +5 -5
  179. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  180. package/src/services/clinic/utils/admin.utils.ts +551 -551
  181. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  182. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  183. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  184. package/src/services/clinic/utils/filter.utils.ts +446 -446
  185. package/src/services/clinic/utils/index.ts +11 -11
  186. package/src/services/clinic/utils/photos.utils.ts +188 -188
  187. package/src/services/clinic/utils/search.utils.ts +84 -84
  188. package/src/services/clinic/utils/tag.utils.ts +124 -124
  189. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  190. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  191. package/src/services/documentation-templates/index.ts +2 -2
  192. package/src/services/index.ts +13 -13
  193. package/src/services/media/index.ts +1 -1
  194. package/src/services/media/media.service.ts +418 -418
  195. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  196. package/src/services/notifications/index.ts +1 -1
  197. package/src/services/notifications/notification.service.ts +215 -215
  198. package/src/services/patient/README.md +48 -48
  199. package/src/services/patient/To-Do.md +43 -43
  200. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  201. package/src/services/patient/index.ts +2 -2
  202. package/src/services/patient/patient.service.ts +883 -883
  203. package/src/services/patient/patientRequirements.service.ts +285 -285
  204. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  205. package/src/services/patient/utils/clinic.utils.ts +80 -80
  206. package/src/services/patient/utils/docs.utils.ts +142 -142
  207. package/src/services/patient/utils/index.ts +9 -9
  208. package/src/services/patient/utils/location.utils.ts +126 -126
  209. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  210. package/src/services/patient/utils/medical.utils.ts +458 -458
  211. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  212. package/src/services/patient/utils/profile.utils.ts +510 -510
  213. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  214. package/src/services/patient/utils/token.utils.ts +211 -211
  215. package/src/services/practitioner/README.md +145 -145
  216. package/src/services/practitioner/index.ts +1 -1
  217. package/src/services/practitioner/practitioner.service.ts +1742 -1742
  218. package/src/services/procedure/README.md +163 -163
  219. package/src/services/procedure/index.ts +1 -1
  220. package/src/services/procedure/procedure.service.ts +1682 -1682
  221. package/src/services/reviews/index.ts +1 -1
  222. package/src/services/reviews/reviews.service.ts +636 -683
  223. package/src/services/user/index.ts +1 -1
  224. package/src/services/user/user.service.ts +489 -489
  225. package/src/services/user/user.v2.service.ts +466 -466
  226. package/src/types/appointment/index.ts +481 -453
  227. package/src/types/calendar/index.ts +258 -258
  228. package/src/types/calendar/synced-calendar.types.ts +66 -66
  229. package/src/types/clinic/index.ts +489 -489
  230. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  231. package/src/types/clinic/preferences.types.ts +159 -159
  232. package/src/types/clinic/to-do +3 -3
  233. package/src/types/documentation-templates/index.ts +308 -308
  234. package/src/types/index.ts +44 -44
  235. package/src/types/notifications/README.md +77 -77
  236. package/src/types/notifications/index.ts +265 -265
  237. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  238. package/src/types/patient/allergies.ts +58 -58
  239. package/src/types/patient/index.ts +275 -273
  240. package/src/types/patient/medical-info.types.ts +152 -152
  241. package/src/types/patient/patient-requirements.ts +92 -92
  242. package/src/types/patient/token.types.ts +61 -61
  243. package/src/types/practitioner/index.ts +206 -206
  244. package/src/types/procedure/index.ts +181 -181
  245. package/src/types/profile/index.ts +39 -39
  246. package/src/types/reviews/index.ts +130 -132
  247. package/src/types/tz-lookup.d.ts +4 -4
  248. package/src/types/user/index.ts +38 -38
  249. package/src/utils/TIMESTAMPS.md +176 -176
  250. package/src/utils/TimestampUtils.ts +241 -241
  251. package/src/utils/index.ts +1 -1
  252. package/src/validations/appointment.schema.ts +574 -574
  253. package/src/validations/calendar.schema.ts +225 -225
  254. package/src/validations/clinic.schema.ts +493 -493
  255. package/src/validations/common.schema.ts +25 -25
  256. package/src/validations/documentation-templates/index.ts +1 -1
  257. package/src/validations/documentation-templates/template.schema.ts +220 -220
  258. package/src/validations/documentation-templates.schema.ts +10 -10
  259. package/src/validations/index.ts +20 -20
  260. package/src/validations/media.schema.ts +10 -10
  261. package/src/validations/notification.schema.ts +90 -90
  262. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  263. package/src/validations/patient/medical-info.schema.ts +125 -125
  264. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  265. package/src/validations/patient/token.schema.ts +29 -29
  266. package/src/validations/patient.schema.ts +217 -216
  267. package/src/validations/practitioner.schema.ts +222 -222
  268. package/src/validations/procedure-product.schema.ts +41 -41
  269. package/src/validations/procedure.schema.ts +124 -124
  270. package/src/validations/profile-info.schema.ts +41 -41
  271. package/src/validations/reviews.schema.ts +189 -195
  272. package/src/validations/schemas.ts +104 -104
  273. package/src/validations/shared.schema.ts +78 -78
@@ -1,265 +1,265 @@
1
- import { Firestore, Timestamp } from 'firebase/firestore';
2
- import {
3
- CalendarEvent,
4
- CalendarEventStatus,
5
- CalendarEventTime,
6
- CalendarEventType,
7
- CalendarSyncStatus,
8
- CreateCalendarEventData,
9
- UpdateCalendarEventData,
10
- } from '../../../types/calendar';
11
- import {
12
- createClinicCalendarEventUtil,
13
- updateClinicCalendarEventUtil,
14
- deleteClinicCalendarEventUtil,
15
- checkAutoConfirmAppointmentsUtil,
16
- } from './clinic.utils';
17
- import {
18
- createPatientCalendarEventUtil,
19
- updatePatientCalendarEventUtil,
20
- deletePatientCalendarEventUtil,
21
- } from './patient.utils';
22
- import {
23
- createPractitionerCalendarEventUtil,
24
- updatePractitionerCalendarEventUtil,
25
- deletePractitionerCalendarEventUtil,
26
- } from './practitioner.utils';
27
-
28
- /**
29
- * Creates an appointment across all relevant calendars (practitioner, patient, clinic)
30
- * @param db - Firestore instance
31
- * @param clinicId - ID of the clinic
32
- * @param practitionerId - ID of the practitioner
33
- * @param patientId - ID of the patient
34
- * @param eventData - Calendar event data
35
- * @param generateId - Function to generate a unique ID
36
- * @returns Created calendar event
37
- */
38
- export async function createAppointmentUtil(
39
- db: Firestore,
40
- clinicId: string,
41
- practitionerId: string,
42
- patientId: string,
43
- eventData: Omit<
44
- CreateCalendarEventData,
45
- | 'id'
46
- | 'createdAt'
47
- | 'updatedAt'
48
- | 'clinicBranchId'
49
- | 'practitionerProfileId'
50
- | 'patientProfileId'
51
- >,
52
- generateId: () => string,
53
- ): Promise<CalendarEvent> {
54
- // TODO: Add validation for appointment data
55
- // - Check if all entities exist
56
- // - Validate event time (start < end)
57
- // - Check for overlapping events
58
- // - Validate required fields
59
-
60
- // Generate a single ID to be used across all calendars
61
- const eventId = generateId();
62
-
63
- // Check if the clinic has auto-confirm appointments enabled
64
- const autoConfirm = await checkAutoConfirmAppointmentsUtil(db, clinicId);
65
-
66
- // Set the initial status based on auto-confirm setting
67
- const initialStatus = autoConfirm ? CalendarEventStatus.CONFIRMED : CalendarEventStatus.PENDING;
68
-
69
- // Prepare the event data with all required IDs
70
- const appointmentData: Omit<CreateCalendarEventData, 'id' | 'createdAt' | 'updatedAt'> = {
71
- ...eventData,
72
- clinicBranchId: clinicId,
73
- practitionerProfileId: practitionerId,
74
- patientProfileId: patientId,
75
- eventType: CalendarEventType.APPOINTMENT,
76
- status: eventData.status || initialStatus,
77
- };
78
-
79
- // Create the event in all three calendars
80
- const clinicPromise = createClinicCalendarEventUtil(
81
- db,
82
- clinicId,
83
- appointmentData,
84
- () => eventId, // Use the same ID for all calendars
85
- );
86
-
87
- const practitionerPromise = createPractitionerCalendarEventUtil(
88
- db,
89
- practitionerId,
90
- appointmentData,
91
- () => eventId, // Use the same ID for all calendars
92
- );
93
-
94
- const patientPromise = createPatientCalendarEventUtil(
95
- db,
96
- patientId,
97
- appointmentData,
98
- () => eventId, // Use the same ID for all calendars
99
- );
100
-
101
- // Wait for all operations to complete
102
- const [clinicEvent] = await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
103
-
104
- // Return the event from the clinic calendar
105
- return clinicEvent;
106
- }
107
-
108
- /**
109
- * Updates an appointment across all relevant calendars (practitioner, patient, clinic)
110
- * @param db - Firestore instance
111
- * @param clinicId - ID of the clinic
112
- * @param practitionerId - ID of the practitioner
113
- * @param patientId - ID of the patient
114
- * @param eventId - ID of the event
115
- * @param updateData - Data to update
116
- * @returns Updated calendar event
117
- */
118
- export async function updateAppointmentUtil(
119
- db: Firestore,
120
- clinicId: string,
121
- practitionerId: string,
122
- patientId: string,
123
- eventId: string,
124
- updateData: Omit<UpdateCalendarEventData, 'updatedAt'>,
125
- ): Promise<CalendarEvent> {
126
- // TODO: Add validation for update data
127
- // - Check if event exists in all calendars
128
- // - Validate event time (start < end)
129
- // - Check for overlapping events
130
-
131
- // Update the event in all three calendars
132
- const clinicPromise = updateClinicCalendarEventUtil(db, clinicId, eventId, updateData);
133
-
134
- const practitionerPromise = updatePractitionerCalendarEventUtil(
135
- db,
136
- practitionerId,
137
- eventId,
138
- updateData,
139
- );
140
-
141
- const patientPromise = updatePatientCalendarEventUtil(db, patientId, eventId, updateData);
142
-
143
- // Wait for all operations to complete
144
- const [clinicEvent] = await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
145
-
146
- // Return the event from the clinic calendar
147
- return clinicEvent;
148
- }
149
-
150
- /**
151
- * Deletes an appointment across all relevant calendars (practitioner, patient, clinic)
152
- * @param db - Firestore instance
153
- * @param clinicId - ID of the clinic
154
- * @param practitionerId - ID of the practitioner
155
- * @param patientId - ID of the patient
156
- * @param eventId - ID of the event
157
- */
158
- export async function deleteAppointmentUtil(
159
- db: Firestore,
160
- clinicId: string,
161
- practitionerId: string,
162
- patientId: string,
163
- eventId: string,
164
- ): Promise<void> {
165
- // Delete the event from all three calendars
166
- const clinicPromise = deleteClinicCalendarEventUtil(db, clinicId, eventId);
167
-
168
- const practitionerPromise = deletePractitionerCalendarEventUtil(db, practitionerId, eventId);
169
-
170
- const patientPromise = deletePatientCalendarEventUtil(db, patientId, eventId);
171
-
172
- // Wait for all operations to complete
173
- await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
174
- }
175
-
176
- /**
177
- * Confirms an appointment
178
- * @param db - Firestore instance
179
- * @param clinicId - ID of the clinic
180
- * @param practitionerId - ID of the practitioner
181
- * @param patientId - ID of the patient
182
- * @param eventId - ID of the event
183
- * @returns Confirmed calendar event
184
- */
185
- export async function confirmAppointmentUtil(
186
- db: Firestore,
187
- clinicId: string,
188
- practitionerId: string,
189
- patientId: string,
190
- eventId: string,
191
- ): Promise<CalendarEvent> {
192
- return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
193
- status: CalendarEventStatus.CONFIRMED,
194
- });
195
- }
196
-
197
- /**
198
- * Rejects an appointment
199
- * @param db - Firestore instance
200
- * @param clinicId - ID of the clinic
201
- * @param practitionerId - ID of the practitioner
202
- * @param patientId - ID of the patient
203
- * @param eventId - ID of the event
204
- * @returns Rejected calendar event
205
- */
206
- export async function rejectAppointmentUtil(
207
- db: Firestore,
208
- clinicId: string,
209
- practitionerId: string,
210
- patientId: string,
211
- eventId: string,
212
- ): Promise<CalendarEvent> {
213
- return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
214
- status: CalendarEventStatus.REJECTED,
215
- });
216
- }
217
-
218
- /**
219
- * Cancels an appointment
220
- * @param db - Firestore instance
221
- * @param clinicId - ID of the clinic
222
- * @param practitionerId - ID of the practitioner
223
- * @param patientId - ID of the patient
224
- * @param eventId - ID of the event
225
- * @returns Canceled calendar event
226
- */
227
- export async function cancelAppointmentUtil(
228
- db: Firestore,
229
- clinicId: string,
230
- practitionerId: string,
231
- patientId: string,
232
- eventId: string,
233
- ): Promise<CalendarEvent> {
234
- return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
235
- status: CalendarEventStatus.CANCELED,
236
- });
237
- }
238
-
239
- /**
240
- * Reschedules an appointment
241
- * @param db - Firestore instance
242
- * @param clinicId - ID of the clinic
243
- * @param practitionerId - ID of the practitioner
244
- * @param patientId - ID of the patient
245
- * @param eventId - ID of the event
246
- * @param newEventTime - New event time
247
- * @returns Rescheduled calendar event
248
- */
249
- export async function rescheduleAppointmentUtil(
250
- db: Firestore,
251
- clinicId: string,
252
- practitionerId: string,
253
- patientId: string,
254
- eventId: string,
255
- newEventTime: CalendarEventTime,
256
- ): Promise<CalendarEvent> {
257
- // TODO: Add validation for new event time
258
- // - Validate event time (start < end)
259
- // - Check for overlapping events
260
-
261
- return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
262
- status: CalendarEventStatus.RESCHEDULED,
263
- eventTime: newEventTime,
264
- });
265
- }
1
+ import { Firestore, Timestamp } from 'firebase/firestore';
2
+ import {
3
+ CalendarEvent,
4
+ CalendarEventStatus,
5
+ CalendarEventTime,
6
+ CalendarEventType,
7
+ CalendarSyncStatus,
8
+ CreateCalendarEventData,
9
+ UpdateCalendarEventData,
10
+ } from '../../../types/calendar';
11
+ import {
12
+ createClinicCalendarEventUtil,
13
+ updateClinicCalendarEventUtil,
14
+ deleteClinicCalendarEventUtil,
15
+ checkAutoConfirmAppointmentsUtil,
16
+ } from './clinic.utils';
17
+ import {
18
+ createPatientCalendarEventUtil,
19
+ updatePatientCalendarEventUtil,
20
+ deletePatientCalendarEventUtil,
21
+ } from './patient.utils';
22
+ import {
23
+ createPractitionerCalendarEventUtil,
24
+ updatePractitionerCalendarEventUtil,
25
+ deletePractitionerCalendarEventUtil,
26
+ } from './practitioner.utils';
27
+
28
+ /**
29
+ * Creates an appointment across all relevant calendars (practitioner, patient, clinic)
30
+ * @param db - Firestore instance
31
+ * @param clinicId - ID of the clinic
32
+ * @param practitionerId - ID of the practitioner
33
+ * @param patientId - ID of the patient
34
+ * @param eventData - Calendar event data
35
+ * @param generateId - Function to generate a unique ID
36
+ * @returns Created calendar event
37
+ */
38
+ export async function createAppointmentUtil(
39
+ db: Firestore,
40
+ clinicId: string,
41
+ practitionerId: string,
42
+ patientId: string,
43
+ eventData: Omit<
44
+ CreateCalendarEventData,
45
+ | 'id'
46
+ | 'createdAt'
47
+ | 'updatedAt'
48
+ | 'clinicBranchId'
49
+ | 'practitionerProfileId'
50
+ | 'patientProfileId'
51
+ >,
52
+ generateId: () => string,
53
+ ): Promise<CalendarEvent> {
54
+ // TODO: Add validation for appointment data
55
+ // - Check if all entities exist
56
+ // - Validate event time (start < end)
57
+ // - Check for overlapping events
58
+ // - Validate required fields
59
+
60
+ // Generate a single ID to be used across all calendars
61
+ const eventId = generateId();
62
+
63
+ // Check if the clinic has auto-confirm appointments enabled
64
+ const autoConfirm = await checkAutoConfirmAppointmentsUtil(db, clinicId);
65
+
66
+ // Set the initial status based on auto-confirm setting
67
+ const initialStatus = autoConfirm ? CalendarEventStatus.CONFIRMED : CalendarEventStatus.PENDING;
68
+
69
+ // Prepare the event data with all required IDs
70
+ const appointmentData: Omit<CreateCalendarEventData, 'id' | 'createdAt' | 'updatedAt'> = {
71
+ ...eventData,
72
+ clinicBranchId: clinicId,
73
+ practitionerProfileId: practitionerId,
74
+ patientProfileId: patientId,
75
+ eventType: CalendarEventType.APPOINTMENT,
76
+ status: eventData.status || initialStatus,
77
+ };
78
+
79
+ // Create the event in all three calendars
80
+ const clinicPromise = createClinicCalendarEventUtil(
81
+ db,
82
+ clinicId,
83
+ appointmentData,
84
+ () => eventId, // Use the same ID for all calendars
85
+ );
86
+
87
+ const practitionerPromise = createPractitionerCalendarEventUtil(
88
+ db,
89
+ practitionerId,
90
+ appointmentData,
91
+ () => eventId, // Use the same ID for all calendars
92
+ );
93
+
94
+ const patientPromise = createPatientCalendarEventUtil(
95
+ db,
96
+ patientId,
97
+ appointmentData,
98
+ () => eventId, // Use the same ID for all calendars
99
+ );
100
+
101
+ // Wait for all operations to complete
102
+ const [clinicEvent] = await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
103
+
104
+ // Return the event from the clinic calendar
105
+ return clinicEvent;
106
+ }
107
+
108
+ /**
109
+ * Updates an appointment across all relevant calendars (practitioner, patient, clinic)
110
+ * @param db - Firestore instance
111
+ * @param clinicId - ID of the clinic
112
+ * @param practitionerId - ID of the practitioner
113
+ * @param patientId - ID of the patient
114
+ * @param eventId - ID of the event
115
+ * @param updateData - Data to update
116
+ * @returns Updated calendar event
117
+ */
118
+ export async function updateAppointmentUtil(
119
+ db: Firestore,
120
+ clinicId: string,
121
+ practitionerId: string,
122
+ patientId: string,
123
+ eventId: string,
124
+ updateData: Omit<UpdateCalendarEventData, 'updatedAt'>,
125
+ ): Promise<CalendarEvent> {
126
+ // TODO: Add validation for update data
127
+ // - Check if event exists in all calendars
128
+ // - Validate event time (start < end)
129
+ // - Check for overlapping events
130
+
131
+ // Update the event in all three calendars
132
+ const clinicPromise = updateClinicCalendarEventUtil(db, clinicId, eventId, updateData);
133
+
134
+ const practitionerPromise = updatePractitionerCalendarEventUtil(
135
+ db,
136
+ practitionerId,
137
+ eventId,
138
+ updateData,
139
+ );
140
+
141
+ const patientPromise = updatePatientCalendarEventUtil(db, patientId, eventId, updateData);
142
+
143
+ // Wait for all operations to complete
144
+ const [clinicEvent] = await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
145
+
146
+ // Return the event from the clinic calendar
147
+ return clinicEvent;
148
+ }
149
+
150
+ /**
151
+ * Deletes an appointment across all relevant calendars (practitioner, patient, clinic)
152
+ * @param db - Firestore instance
153
+ * @param clinicId - ID of the clinic
154
+ * @param practitionerId - ID of the practitioner
155
+ * @param patientId - ID of the patient
156
+ * @param eventId - ID of the event
157
+ */
158
+ export async function deleteAppointmentUtil(
159
+ db: Firestore,
160
+ clinicId: string,
161
+ practitionerId: string,
162
+ patientId: string,
163
+ eventId: string,
164
+ ): Promise<void> {
165
+ // Delete the event from all three calendars
166
+ const clinicPromise = deleteClinicCalendarEventUtil(db, clinicId, eventId);
167
+
168
+ const practitionerPromise = deletePractitionerCalendarEventUtil(db, practitionerId, eventId);
169
+
170
+ const patientPromise = deletePatientCalendarEventUtil(db, patientId, eventId);
171
+
172
+ // Wait for all operations to complete
173
+ await Promise.all([clinicPromise, practitionerPromise, patientPromise]);
174
+ }
175
+
176
+ /**
177
+ * Confirms an appointment
178
+ * @param db - Firestore instance
179
+ * @param clinicId - ID of the clinic
180
+ * @param practitionerId - ID of the practitioner
181
+ * @param patientId - ID of the patient
182
+ * @param eventId - ID of the event
183
+ * @returns Confirmed calendar event
184
+ */
185
+ export async function confirmAppointmentUtil(
186
+ db: Firestore,
187
+ clinicId: string,
188
+ practitionerId: string,
189
+ patientId: string,
190
+ eventId: string,
191
+ ): Promise<CalendarEvent> {
192
+ return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
193
+ status: CalendarEventStatus.CONFIRMED,
194
+ });
195
+ }
196
+
197
+ /**
198
+ * Rejects an appointment
199
+ * @param db - Firestore instance
200
+ * @param clinicId - ID of the clinic
201
+ * @param practitionerId - ID of the practitioner
202
+ * @param patientId - ID of the patient
203
+ * @param eventId - ID of the event
204
+ * @returns Rejected calendar event
205
+ */
206
+ export async function rejectAppointmentUtil(
207
+ db: Firestore,
208
+ clinicId: string,
209
+ practitionerId: string,
210
+ patientId: string,
211
+ eventId: string,
212
+ ): Promise<CalendarEvent> {
213
+ return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
214
+ status: CalendarEventStatus.REJECTED,
215
+ });
216
+ }
217
+
218
+ /**
219
+ * Cancels an appointment
220
+ * @param db - Firestore instance
221
+ * @param clinicId - ID of the clinic
222
+ * @param practitionerId - ID of the practitioner
223
+ * @param patientId - ID of the patient
224
+ * @param eventId - ID of the event
225
+ * @returns Canceled calendar event
226
+ */
227
+ export async function cancelAppointmentUtil(
228
+ db: Firestore,
229
+ clinicId: string,
230
+ practitionerId: string,
231
+ patientId: string,
232
+ eventId: string,
233
+ ): Promise<CalendarEvent> {
234
+ return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
235
+ status: CalendarEventStatus.CANCELED,
236
+ });
237
+ }
238
+
239
+ /**
240
+ * Reschedules an appointment
241
+ * @param db - Firestore instance
242
+ * @param clinicId - ID of the clinic
243
+ * @param practitionerId - ID of the practitioner
244
+ * @param patientId - ID of the patient
245
+ * @param eventId - ID of the event
246
+ * @param newEventTime - New event time
247
+ * @returns Rescheduled calendar event
248
+ */
249
+ export async function rescheduleAppointmentUtil(
250
+ db: Firestore,
251
+ clinicId: string,
252
+ practitionerId: string,
253
+ patientId: string,
254
+ eventId: string,
255
+ newEventTime: CalendarEventTime,
256
+ ): Promise<CalendarEvent> {
257
+ // TODO: Add validation for new event time
258
+ // - Validate event time (start < end)
259
+ // - Check for overlapping events
260
+
261
+ return updateAppointmentUtil(db, clinicId, practitionerId, patientId, eventId, {
262
+ status: CalendarEventStatus.RESCHEDULED,
263
+ eventTime: newEventTime,
264
+ });
265
+ }