@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

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 (295) hide show
  1. package/dist/admin/index.d.mts +20 -1
  2. package/dist/admin/index.d.ts +20 -1
  3. package/dist/admin/index.js +217 -1
  4. package/dist/admin/index.mjs +217 -1
  5. package/dist/index.d.mts +26 -3
  6. package/dist/index.d.ts +26 -3
  7. package/dist/index.js +168 -6
  8. package/dist/index.mjs +168 -6
  9. package/package.json +121 -121
  10. package/src/__mocks__/firstore.ts +10 -10
  11. package/src/admin/aggregation/README.md +79 -79
  12. package/src/admin/aggregation/appointment/README.md +128 -128
  13. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1984 -1984
  14. package/src/admin/aggregation/appointment/index.ts +1 -1
  15. package/src/admin/aggregation/clinic/README.md +52 -52
  16. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +966 -703
  17. package/src/admin/aggregation/clinic/index.ts +1 -1
  18. package/src/admin/aggregation/forms/README.md +13 -13
  19. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  20. package/src/admin/aggregation/forms/index.ts +1 -1
  21. package/src/admin/aggregation/index.ts +8 -8
  22. package/src/admin/aggregation/patient/README.md +27 -27
  23. package/src/admin/aggregation/patient/index.ts +1 -1
  24. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  25. package/src/admin/aggregation/practitioner/README.md +42 -42
  26. package/src/admin/aggregation/practitioner/index.ts +1 -1
  27. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  28. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  29. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  30. package/src/admin/aggregation/procedure/README.md +43 -43
  31. package/src/admin/aggregation/procedure/index.ts +1 -1
  32. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  33. package/src/admin/aggregation/reviews/index.ts +1 -1
  34. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +689 -689
  35. package/src/admin/analytics/analytics.admin.service.ts +278 -278
  36. package/src/admin/analytics/index.ts +2 -2
  37. package/src/admin/booking/README.md +125 -125
  38. package/src/admin/booking/booking.admin.ts +1037 -1037
  39. package/src/admin/booking/booking.calculator.ts +712 -712
  40. package/src/admin/booking/booking.types.ts +59 -59
  41. package/src/admin/booking/index.ts +3 -3
  42. package/src/admin/booking/timezones-problem.md +185 -185
  43. package/src/admin/calendar/README.md +7 -7
  44. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  45. package/src/admin/calendar/index.ts +1 -1
  46. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  47. package/src/admin/documentation-templates/index.ts +1 -1
  48. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  49. package/src/admin/free-consultation/index.ts +1 -1
  50. package/src/admin/index.ts +81 -81
  51. package/src/admin/logger/index.ts +78 -78
  52. package/src/admin/mailing/README.md +95 -95
  53. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  54. package/src/admin/mailing/appointment/index.ts +1 -1
  55. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  56. package/src/admin/mailing/base.mailing.service.ts +208 -208
  57. package/src/admin/mailing/index.ts +3 -3
  58. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  59. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  60. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  61. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  62. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  63. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  64. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  65. package/src/admin/notifications/index.ts +1 -1
  66. package/src/admin/notifications/notifications.admin.ts +710 -710
  67. package/src/admin/requirements/README.md +128 -128
  68. package/src/admin/requirements/index.ts +1 -1
  69. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  70. package/src/admin/users/index.ts +1 -1
  71. package/src/admin/users/user-profile.admin.ts +405 -405
  72. package/src/backoffice/constants/certification.constants.ts +13 -13
  73. package/src/backoffice/constants/index.ts +1 -1
  74. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  75. package/src/backoffice/errors/index.ts +1 -1
  76. package/src/backoffice/expo-safe/README.md +26 -26
  77. package/src/backoffice/expo-safe/index.ts +41 -41
  78. package/src/backoffice/index.ts +5 -5
  79. package/src/backoffice/services/FIXES_README.md +102 -102
  80. package/src/backoffice/services/README.md +57 -57
  81. package/src/backoffice/services/analytics.service.proposal.md +863 -863
  82. package/src/backoffice/services/analytics.service.summary.md +143 -143
  83. package/src/backoffice/services/brand.service.ts +256 -256
  84. package/src/backoffice/services/category.service.ts +384 -384
  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 +10 -10
  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 +461 -461
  92. package/src/backoffice/services/technology.service.ts +1151 -1151
  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 +67 -67
  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 +168 -168
  112. package/src/backoffice/validations/index.ts +1 -1
  113. package/src/backoffice/validations/schemas.ts +164 -164
  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 +211 -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/analytics/ARCHITECTURE.md +199 -199
  139. package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
  140. package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
  141. package/src/services/analytics/QUICK_START.md +393 -393
  142. package/src/services/analytics/README.md +304 -304
  143. package/src/services/analytics/SUMMARY.md +141 -141
  144. package/src/services/analytics/TRENDS.md +380 -380
  145. package/src/services/analytics/USAGE_GUIDE.md +518 -518
  146. package/src/services/analytics/analytics-cloud.service.ts +222 -222
  147. package/src/services/analytics/analytics.service.ts +2142 -2142
  148. package/src/services/analytics/index.ts +4 -4
  149. package/src/services/analytics/review-analytics.service.ts +941 -941
  150. package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
  151. package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
  152. package/src/services/analytics/utils/grouping.utils.ts +434 -434
  153. package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
  154. package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
  155. package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
  156. package/src/services/appointment/README.md +17 -17
  157. package/src/services/appointment/appointment.service.ts +2558 -2558
  158. package/src/services/appointment/index.ts +1 -1
  159. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  160. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  161. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  162. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  163. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  164. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  165. package/src/services/auth/auth.service.ts +1043 -989
  166. package/src/services/auth/auth.v2.service.ts +961 -961
  167. package/src/services/auth/index.ts +7 -7
  168. package/src/services/auth/utils/error.utils.ts +90 -90
  169. package/src/services/auth/utils/firebase.utils.ts +49 -49
  170. package/src/services/auth/utils/index.ts +21 -21
  171. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  172. package/src/services/base.service.ts +41 -41
  173. package/src/services/calendar/calendar.service.ts +1077 -1077
  174. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  175. package/src/services/calendar/calendar.v3.service.ts +313 -313
  176. package/src/services/calendar/externalCalendar.service.ts +178 -178
  177. package/src/services/calendar/index.ts +5 -5
  178. package/src/services/calendar/synced-calendars.service.ts +743 -743
  179. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  180. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  181. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  182. package/src/services/calendar/utils/docs.utils.ts +157 -157
  183. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  184. package/src/services/calendar/utils/index.ts +8 -8
  185. package/src/services/calendar/utils/patient.utils.ts +198 -198
  186. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  187. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  188. package/src/services/clinic/README.md +204 -204
  189. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  190. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  191. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  192. package/src/services/clinic/billing-transactions.service.ts +217 -217
  193. package/src/services/clinic/clinic-admin.service.ts +202 -202
  194. package/src/services/clinic/clinic-group.service.ts +310 -310
  195. package/src/services/clinic/clinic.service.ts +708 -708
  196. package/src/services/clinic/index.ts +5 -5
  197. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  198. package/src/services/clinic/utils/admin.utils.ts +551 -551
  199. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  200. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  201. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  202. package/src/services/clinic/utils/filter.utils.ts +446 -446
  203. package/src/services/clinic/utils/index.ts +11 -11
  204. package/src/services/clinic/utils/photos.utils.ts +188 -188
  205. package/src/services/clinic/utils/search.utils.ts +84 -84
  206. package/src/services/clinic/utils/tag.utils.ts +124 -124
  207. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  208. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  209. package/src/services/documentation-templates/index.ts +2 -2
  210. package/src/services/index.ts +14 -14
  211. package/src/services/media/index.ts +1 -1
  212. package/src/services/media/media.service.ts +418 -418
  213. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  214. package/src/services/notifications/index.ts +1 -1
  215. package/src/services/notifications/notification.service.ts +215 -215
  216. package/src/services/patient/README.md +48 -48
  217. package/src/services/patient/To-Do.md +43 -43
  218. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  219. package/src/services/patient/index.ts +2 -2
  220. package/src/services/patient/patient.service.ts +883 -883
  221. package/src/services/patient/patientRequirements.service.ts +285 -285
  222. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  223. package/src/services/patient/utils/clinic.utils.ts +80 -80
  224. package/src/services/patient/utils/docs.utils.ts +142 -142
  225. package/src/services/patient/utils/index.ts +9 -9
  226. package/src/services/patient/utils/location.utils.ts +126 -126
  227. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  228. package/src/services/patient/utils/medical.utils.ts +458 -458
  229. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  230. package/src/services/patient/utils/profile.utils.ts +510 -510
  231. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  232. package/src/services/patient/utils/token.utils.ts +211 -211
  233. package/src/services/practitioner/README.md +145 -145
  234. package/src/services/practitioner/index.ts +1 -1
  235. package/src/services/practitioner/practitioner.service.ts +1799 -1742
  236. package/src/services/procedure/README.md +163 -163
  237. package/src/services/procedure/index.ts +1 -1
  238. package/src/services/procedure/procedure.service.ts +2307 -2200
  239. package/src/services/reviews/index.ts +1 -1
  240. package/src/services/reviews/reviews.service.ts +734 -734
  241. package/src/services/user/index.ts +1 -1
  242. package/src/services/user/user.service.ts +489 -489
  243. package/src/services/user/user.v2.service.ts +466 -466
  244. package/src/types/analytics/analytics.types.ts +597 -597
  245. package/src/types/analytics/grouped-analytics.types.ts +173 -173
  246. package/src/types/analytics/index.ts +4 -4
  247. package/src/types/analytics/stored-analytics.types.ts +137 -137
  248. package/src/types/appointment/index.ts +480 -480
  249. package/src/types/calendar/index.ts +258 -258
  250. package/src/types/calendar/synced-calendar.types.ts +66 -66
  251. package/src/types/clinic/index.ts +498 -498
  252. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  253. package/src/types/clinic/preferences.types.ts +159 -159
  254. package/src/types/clinic/to-do +3 -3
  255. package/src/types/documentation-templates/index.ts +308 -308
  256. package/src/types/index.ts +47 -47
  257. package/src/types/notifications/README.md +77 -77
  258. package/src/types/notifications/index.ts +286 -286
  259. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  260. package/src/types/patient/allergies.ts +58 -58
  261. package/src/types/patient/index.ts +275 -275
  262. package/src/types/patient/medical-info.types.ts +152 -152
  263. package/src/types/patient/patient-requirements.ts +92 -92
  264. package/src/types/patient/token.types.ts +61 -61
  265. package/src/types/practitioner/index.ts +206 -206
  266. package/src/types/procedure/index.ts +181 -181
  267. package/src/types/profile/index.ts +39 -39
  268. package/src/types/reviews/index.ts +132 -132
  269. package/src/types/tz-lookup.d.ts +4 -4
  270. package/src/types/user/index.ts +38 -38
  271. package/src/utils/TIMESTAMPS.md +176 -176
  272. package/src/utils/TimestampUtils.ts +241 -241
  273. package/src/utils/index.ts +1 -1
  274. package/src/validations/appointment.schema.ts +574 -574
  275. package/src/validations/calendar.schema.ts +225 -225
  276. package/src/validations/clinic.schema.ts +494 -494
  277. package/src/validations/common.schema.ts +25 -25
  278. package/src/validations/documentation-templates/index.ts +1 -1
  279. package/src/validations/documentation-templates/template.schema.ts +220 -220
  280. package/src/validations/documentation-templates.schema.ts +10 -10
  281. package/src/validations/index.ts +20 -20
  282. package/src/validations/media.schema.ts +10 -10
  283. package/src/validations/notification.schema.ts +90 -90
  284. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  285. package/src/validations/patient/medical-info.schema.ts +125 -125
  286. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  287. package/src/validations/patient/token.schema.ts +29 -29
  288. package/src/validations/patient.schema.ts +217 -217
  289. package/src/validations/practitioner.schema.ts +222 -222
  290. package/src/validations/procedure-product.schema.ts +41 -41
  291. package/src/validations/procedure.schema.ts +124 -124
  292. package/src/validations/profile-info.schema.ts +41 -41
  293. package/src/validations/reviews.schema.ts +195 -195
  294. package/src/validations/schemas.ts +104 -104
  295. 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
+ }