@blackcode_sa/metaestetics-api 1.12.65 → 1.12.67

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 +2 -0
  2. package/dist/admin/index.d.ts +2 -0
  3. package/dist/admin/index.js +45 -4
  4. package/dist/admin/index.mjs +45 -4
  5. package/dist/backoffice/index.d.mts +33 -0
  6. package/dist/backoffice/index.d.ts +33 -0
  7. package/dist/backoffice/index.js +63 -0
  8. package/dist/backoffice/index.mjs +63 -0
  9. package/dist/index.d.mts +35 -0
  10. package/dist/index.d.ts +35 -0
  11. package/dist/index.js +116 -11
  12. package/dist/index.mjs +116 -11
  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 +689 -641
  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 +341 -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 +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 +417 -395
  92. package/src/backoffice/services/technology.service.ts +1104 -1083
  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 -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 +168 -163
  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 +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 -2505
  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 +1715 -1715
  221. package/src/services/reviews/index.ts +1 -1
  222. package/src/services/reviews/reviews.service.ts +683 -636
  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 +480 -480
  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 -275
  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 +132 -130
  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 -217
  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 +195 -189
  272. package/src/validations/schemas.ts +104 -104
  273. package/src/validations/shared.schema.ts +78 -78
@@ -1,237 +1,237 @@
1
- import {
2
- Firestore,
3
- collection,
4
- doc,
5
- getDoc,
6
- getDocs,
7
- setDoc,
8
- updateDoc,
9
- deleteDoc,
10
- query,
11
- where,
12
- orderBy,
13
- Timestamp,
14
- serverTimestamp,
15
- QueryConstraint,
16
- } from "firebase/firestore";
17
- import {
18
- CalendarEvent,
19
- CalendarEventStatus,
20
- CalendarEventType,
21
- CreateCalendarEventData,
22
- UpdateCalendarEventData,
23
- CALENDAR_COLLECTION,
24
- } from "../../../types/calendar";
25
- import { getClinicCalendarEventDocRef } from "./docs.utils";
26
- import { CLINIC_GROUPS_COLLECTION } from "../../../types/clinic";
27
-
28
- /**
29
- * Creates a calendar event for a clinic
30
- * @param db - Firestore instance
31
- * @param clinicId - ID of the clinic
32
- * @param eventData - Calendar event data
33
- * @param generateId - Function to generate a unique ID
34
- * @returns Created calendar event
35
- */
36
- export async function createClinicCalendarEventUtil(
37
- db: Firestore,
38
- clinicId: string,
39
- eventData: Omit<CreateCalendarEventData, "id" | "createdAt" | "updatedAt">,
40
- generateId: () => string
41
- ): Promise<CalendarEvent> {
42
- // TODO: Add validation for event data
43
- // - Check if clinic exists
44
- // - Validate event time (start < end)
45
- // - Check for overlapping events
46
- // - Validate required fields
47
-
48
- const eventId = generateId();
49
- const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
50
-
51
- const newEvent: CreateCalendarEventData = {
52
- id: eventId,
53
- ...eventData,
54
- createdAt: serverTimestamp(),
55
- updatedAt: serverTimestamp(),
56
- };
57
-
58
- await setDoc(eventRef, newEvent);
59
-
60
- // Convert server timestamp to Timestamp for return value
61
- return {
62
- ...newEvent,
63
- createdAt: Timestamp.now(),
64
- updatedAt: Timestamp.now(),
65
- } as CalendarEvent;
66
- }
67
-
68
- /**
69
- * Gets a calendar event for a clinic
70
- * @param db - Firestore instance
71
- * @param clinicId - ID of the clinic
72
- * @param eventId - ID of the event
73
- * @returns Calendar event or null if not found
74
- */
75
- export async function getClinicCalendarEventUtil(
76
- db: Firestore,
77
- clinicId: string,
78
- eventId: string
79
- ): Promise<CalendarEvent | null> {
80
- const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
81
- const eventDoc = await getDoc(eventRef);
82
-
83
- if (!eventDoc.exists()) {
84
- return null;
85
- }
86
-
87
- return eventDoc.data() as CalendarEvent;
88
- }
89
-
90
- /**
91
- * Gets calendar events for a clinic within a date range
92
- * @param db - Firestore instance
93
- * @param clinicId - ID of the clinic
94
- * @param startDate - Start date of the range
95
- * @param endDate - End date of the range
96
- * @param additionalConstraints - Additional query constraints
97
- * @returns Array of calendar events
98
- */
99
- export async function getClinicCalendarEventsUtil(
100
- db: Firestore,
101
- clinicId: string,
102
- startDate: Date,
103
- endDate: Date,
104
- additionalConstraints: QueryConstraint[] = []
105
- ): Promise<CalendarEvent[]> {
106
- const startTimestamp = Timestamp.fromDate(startDate);
107
- const endTimestamp = Timestamp.fromDate(endDate);
108
-
109
- const eventsRef = collection(
110
- db,
111
- `${CALENDAR_COLLECTION}`,
112
- clinicId,
113
- `${CALENDAR_COLLECTION}`
114
- );
115
-
116
- const constraints: QueryConstraint[] = [
117
- where("eventTime.start", ">=", startTimestamp),
118
- where("eventTime.end", "<=", endTimestamp),
119
- orderBy("eventTime.start", "asc"),
120
- ...additionalConstraints,
121
- ];
122
-
123
- const q = query(eventsRef, ...constraints);
124
-
125
- const querySnapshot = await getDocs(q);
126
- return querySnapshot.docs.map((doc) => doc.data() as CalendarEvent);
127
- }
128
-
129
- /**
130
- * Gets pending appointments for a clinic
131
- * @param db - Firestore instance
132
- * @param clinicId - ID of the clinic
133
- * @returns Array of pending calendar events
134
- */
135
- export async function getPendingClinicAppointmentsUtil(
136
- db: Firestore,
137
- clinicId: string
138
- ): Promise<CalendarEvent[]> {
139
- const now = new Date();
140
- const oneYearFromNow = new Date();
141
- oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1);
142
-
143
- return getClinicCalendarEventsUtil(db, clinicId, now, oneYearFromNow, [
144
- where("status", "==", CalendarEventStatus.PENDING),
145
- where("eventType", "==", CalendarEventType.APPOINTMENT),
146
- ]);
147
- }
148
-
149
- /**
150
- * Updates a calendar event for a clinic
151
- * @param db - Firestore instance
152
- * @param clinicId - ID of the clinic
153
- * @param eventId - ID of the event
154
- * @param updateData - Data to update
155
- * @returns Updated calendar event
156
- */
157
- export async function updateClinicCalendarEventUtil(
158
- db: Firestore,
159
- clinicId: string,
160
- eventId: string,
161
- updateData: Omit<UpdateCalendarEventData, "updatedAt">
162
- ): Promise<CalendarEvent> {
163
- // TODO: Add validation for update data
164
- // - Check if event exists
165
- // - Validate event time (start < end)
166
- // - Check for overlapping events
167
-
168
- const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
169
-
170
- const updates: UpdateCalendarEventData = {
171
- ...updateData,
172
- updatedAt: serverTimestamp(),
173
- };
174
-
175
- await updateDoc(eventRef, updates as any);
176
-
177
- // Get the updated document
178
- const updatedDoc = await getDoc(eventRef);
179
-
180
- if (!updatedDoc.exists()) {
181
- throw new Error("Event not found after update");
182
- }
183
-
184
- return updatedDoc.data() as CalendarEvent;
185
- }
186
-
187
- /**
188
- * Deletes a calendar event for a clinic
189
- * @param db - Firestore instance
190
- * @param clinicId - ID of the clinic
191
- * @param eventId - ID of the event
192
- */
193
- export async function deleteClinicCalendarEventUtil(
194
- db: Firestore,
195
- clinicId: string,
196
- eventId: string
197
- ): Promise<void> {
198
- const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
199
- await deleteDoc(eventRef);
200
- }
201
-
202
- /**
203
- * Checks if a clinic group has automatic appointment confirmation enabled
204
- * @param db - Firestore instance
205
- * @param clinicId - ID of the clinic
206
- * @returns Boolean indicating if automatic confirmation is enabled
207
- */
208
- export async function checkAutoConfirmAppointmentsUtil(
209
- db: Firestore,
210
- clinicId: string
211
- ): Promise<boolean> {
212
- // First, get the clinic to find its clinic group
213
- const clinicDoc = await getDoc(doc(db, `clinics/${clinicId}`));
214
-
215
- if (!clinicDoc.exists()) {
216
- throw new Error(`Clinic with ID ${clinicId} not found`);
217
- }
218
-
219
- const clinicData = clinicDoc.data();
220
- const clinicGroupId = clinicData.clinicGroupId;
221
-
222
- if (!clinicGroupId) {
223
- return false; // Default to false if no clinic group is associated
224
- }
225
-
226
- // Get the clinic group settings
227
- const clinicGroupDoc = await getDoc(
228
- doc(db, `${CLINIC_GROUPS_COLLECTION}/${clinicGroupId}`)
229
- );
230
-
231
- if (!clinicGroupDoc.exists()) {
232
- return false; // Default to false if clinic group doesn't exist
233
- }
234
-
235
- const clinicGroupData = clinicGroupDoc.data();
236
- return !!clinicGroupData.autoConfirmAppointments; // Convert to boolean
237
- }
1
+ import {
2
+ Firestore,
3
+ collection,
4
+ doc,
5
+ getDoc,
6
+ getDocs,
7
+ setDoc,
8
+ updateDoc,
9
+ deleteDoc,
10
+ query,
11
+ where,
12
+ orderBy,
13
+ Timestamp,
14
+ serverTimestamp,
15
+ QueryConstraint,
16
+ } from "firebase/firestore";
17
+ import {
18
+ CalendarEvent,
19
+ CalendarEventStatus,
20
+ CalendarEventType,
21
+ CreateCalendarEventData,
22
+ UpdateCalendarEventData,
23
+ CALENDAR_COLLECTION,
24
+ } from "../../../types/calendar";
25
+ import { getClinicCalendarEventDocRef } from "./docs.utils";
26
+ import { CLINIC_GROUPS_COLLECTION } from "../../../types/clinic";
27
+
28
+ /**
29
+ * Creates a calendar event for a clinic
30
+ * @param db - Firestore instance
31
+ * @param clinicId - ID of the clinic
32
+ * @param eventData - Calendar event data
33
+ * @param generateId - Function to generate a unique ID
34
+ * @returns Created calendar event
35
+ */
36
+ export async function createClinicCalendarEventUtil(
37
+ db: Firestore,
38
+ clinicId: string,
39
+ eventData: Omit<CreateCalendarEventData, "id" | "createdAt" | "updatedAt">,
40
+ generateId: () => string
41
+ ): Promise<CalendarEvent> {
42
+ // TODO: Add validation for event data
43
+ // - Check if clinic exists
44
+ // - Validate event time (start < end)
45
+ // - Check for overlapping events
46
+ // - Validate required fields
47
+
48
+ const eventId = generateId();
49
+ const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
50
+
51
+ const newEvent: CreateCalendarEventData = {
52
+ id: eventId,
53
+ ...eventData,
54
+ createdAt: serverTimestamp(),
55
+ updatedAt: serverTimestamp(),
56
+ };
57
+
58
+ await setDoc(eventRef, newEvent);
59
+
60
+ // Convert server timestamp to Timestamp for return value
61
+ return {
62
+ ...newEvent,
63
+ createdAt: Timestamp.now(),
64
+ updatedAt: Timestamp.now(),
65
+ } as CalendarEvent;
66
+ }
67
+
68
+ /**
69
+ * Gets a calendar event for a clinic
70
+ * @param db - Firestore instance
71
+ * @param clinicId - ID of the clinic
72
+ * @param eventId - ID of the event
73
+ * @returns Calendar event or null if not found
74
+ */
75
+ export async function getClinicCalendarEventUtil(
76
+ db: Firestore,
77
+ clinicId: string,
78
+ eventId: string
79
+ ): Promise<CalendarEvent | null> {
80
+ const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
81
+ const eventDoc = await getDoc(eventRef);
82
+
83
+ if (!eventDoc.exists()) {
84
+ return null;
85
+ }
86
+
87
+ return eventDoc.data() as CalendarEvent;
88
+ }
89
+
90
+ /**
91
+ * Gets calendar events for a clinic within a date range
92
+ * @param db - Firestore instance
93
+ * @param clinicId - ID of the clinic
94
+ * @param startDate - Start date of the range
95
+ * @param endDate - End date of the range
96
+ * @param additionalConstraints - Additional query constraints
97
+ * @returns Array of calendar events
98
+ */
99
+ export async function getClinicCalendarEventsUtil(
100
+ db: Firestore,
101
+ clinicId: string,
102
+ startDate: Date,
103
+ endDate: Date,
104
+ additionalConstraints: QueryConstraint[] = []
105
+ ): Promise<CalendarEvent[]> {
106
+ const startTimestamp = Timestamp.fromDate(startDate);
107
+ const endTimestamp = Timestamp.fromDate(endDate);
108
+
109
+ const eventsRef = collection(
110
+ db,
111
+ `${CALENDAR_COLLECTION}`,
112
+ clinicId,
113
+ `${CALENDAR_COLLECTION}`
114
+ );
115
+
116
+ const constraints: QueryConstraint[] = [
117
+ where("eventTime.start", ">=", startTimestamp),
118
+ where("eventTime.end", "<=", endTimestamp),
119
+ orderBy("eventTime.start", "asc"),
120
+ ...additionalConstraints,
121
+ ];
122
+
123
+ const q = query(eventsRef, ...constraints);
124
+
125
+ const querySnapshot = await getDocs(q);
126
+ return querySnapshot.docs.map((doc) => doc.data() as CalendarEvent);
127
+ }
128
+
129
+ /**
130
+ * Gets pending appointments for a clinic
131
+ * @param db - Firestore instance
132
+ * @param clinicId - ID of the clinic
133
+ * @returns Array of pending calendar events
134
+ */
135
+ export async function getPendingClinicAppointmentsUtil(
136
+ db: Firestore,
137
+ clinicId: string
138
+ ): Promise<CalendarEvent[]> {
139
+ const now = new Date();
140
+ const oneYearFromNow = new Date();
141
+ oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1);
142
+
143
+ return getClinicCalendarEventsUtil(db, clinicId, now, oneYearFromNow, [
144
+ where("status", "==", CalendarEventStatus.PENDING),
145
+ where("eventType", "==", CalendarEventType.APPOINTMENT),
146
+ ]);
147
+ }
148
+
149
+ /**
150
+ * Updates a calendar event for a clinic
151
+ * @param db - Firestore instance
152
+ * @param clinicId - ID of the clinic
153
+ * @param eventId - ID of the event
154
+ * @param updateData - Data to update
155
+ * @returns Updated calendar event
156
+ */
157
+ export async function updateClinicCalendarEventUtil(
158
+ db: Firestore,
159
+ clinicId: string,
160
+ eventId: string,
161
+ updateData: Omit<UpdateCalendarEventData, "updatedAt">
162
+ ): Promise<CalendarEvent> {
163
+ // TODO: Add validation for update data
164
+ // - Check if event exists
165
+ // - Validate event time (start < end)
166
+ // - Check for overlapping events
167
+
168
+ const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
169
+
170
+ const updates: UpdateCalendarEventData = {
171
+ ...updateData,
172
+ updatedAt: serverTimestamp(),
173
+ };
174
+
175
+ await updateDoc(eventRef, updates as any);
176
+
177
+ // Get the updated document
178
+ const updatedDoc = await getDoc(eventRef);
179
+
180
+ if (!updatedDoc.exists()) {
181
+ throw new Error("Event not found after update");
182
+ }
183
+
184
+ return updatedDoc.data() as CalendarEvent;
185
+ }
186
+
187
+ /**
188
+ * Deletes a calendar event for a clinic
189
+ * @param db - Firestore instance
190
+ * @param clinicId - ID of the clinic
191
+ * @param eventId - ID of the event
192
+ */
193
+ export async function deleteClinicCalendarEventUtil(
194
+ db: Firestore,
195
+ clinicId: string,
196
+ eventId: string
197
+ ): Promise<void> {
198
+ const eventRef = getClinicCalendarEventDocRef(db, clinicId, eventId);
199
+ await deleteDoc(eventRef);
200
+ }
201
+
202
+ /**
203
+ * Checks if a clinic group has automatic appointment confirmation enabled
204
+ * @param db - Firestore instance
205
+ * @param clinicId - ID of the clinic
206
+ * @returns Boolean indicating if automatic confirmation is enabled
207
+ */
208
+ export async function checkAutoConfirmAppointmentsUtil(
209
+ db: Firestore,
210
+ clinicId: string
211
+ ): Promise<boolean> {
212
+ // First, get the clinic to find its clinic group
213
+ const clinicDoc = await getDoc(doc(db, `clinics/${clinicId}`));
214
+
215
+ if (!clinicDoc.exists()) {
216
+ throw new Error(`Clinic with ID ${clinicId} not found`);
217
+ }
218
+
219
+ const clinicData = clinicDoc.data();
220
+ const clinicGroupId = clinicData.clinicGroupId;
221
+
222
+ if (!clinicGroupId) {
223
+ return false; // Default to false if no clinic group is associated
224
+ }
225
+
226
+ // Get the clinic group settings
227
+ const clinicGroupDoc = await getDoc(
228
+ doc(db, `${CLINIC_GROUPS_COLLECTION}/${clinicGroupId}`)
229
+ );
230
+
231
+ if (!clinicGroupDoc.exists()) {
232
+ return false; // Default to false if clinic group doesn't exist
233
+ }
234
+
235
+ const clinicGroupData = clinicGroupDoc.data();
236
+ return !!clinicGroupData.autoConfirmAppointments; // Convert to boolean
237
+ }