@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.1

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 (326) hide show
  1. package/dist/admin/index.d.mts +377 -222
  2. package/dist/admin/index.d.ts +377 -222
  3. package/dist/admin/index.js +625 -206
  4. package/dist/admin/index.mjs +624 -206
  5. package/dist/backoffice/index.d.mts +24 -0
  6. package/dist/backoffice/index.d.ts +24 -0
  7. package/dist/index.d.mts +292 -4
  8. package/dist/index.d.ts +292 -4
  9. package/dist/index.js +1142 -630
  10. package/dist/index.mjs +1137 -617
  11. package/package.json +2 -1
  12. package/src/__mocks__/firstore.ts +10 -10
  13. package/src/admin/aggregation/README.md +79 -79
  14. package/src/admin/aggregation/appointment/README.md +151 -129
  15. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +2137 -2091
  16. package/src/admin/aggregation/appointment/index.ts +1 -1
  17. package/src/admin/aggregation/clinic/README.md +52 -52
  18. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +966 -966
  19. package/src/admin/aggregation/clinic/index.ts +1 -1
  20. package/src/admin/aggregation/forms/README.md +13 -13
  21. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  22. package/src/admin/aggregation/forms/index.ts +1 -1
  23. package/src/admin/aggregation/index.ts +8 -8
  24. package/src/admin/aggregation/patient/README.md +27 -27
  25. package/src/admin/aggregation/patient/index.ts +1 -1
  26. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  27. package/src/admin/aggregation/practitioner/README.md +42 -42
  28. package/src/admin/aggregation/practitioner/index.ts +1 -1
  29. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  30. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  31. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  32. package/src/admin/aggregation/procedure/README.md +43 -43
  33. package/src/admin/aggregation/procedure/index.ts +1 -1
  34. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  35. package/src/admin/aggregation/reviews/index.ts +1 -1
  36. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +689 -689
  37. package/src/admin/analytics/analytics.admin.service.ts +278 -278
  38. package/src/admin/analytics/index.ts +2 -2
  39. package/src/admin/booking/README.md +184 -125
  40. package/src/admin/booking/booking.admin.ts +1330 -1073
  41. package/src/admin/booking/booking.calculator.ts +850 -712
  42. package/src/admin/booking/booking.types.ts +76 -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 +62 -7
  46. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  47. package/src/admin/calendar/index.ts +2 -1
  48. package/src/admin/calendar/resource-calendar.admin.ts +198 -0
  49. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  50. package/src/admin/documentation-templates/index.ts +1 -1
  51. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  52. package/src/admin/free-consultation/index.ts +1 -1
  53. package/src/admin/index.ts +83 -83
  54. package/src/admin/logger/index.ts +78 -78
  55. package/src/admin/mailing/README.md +139 -139
  56. package/src/admin/mailing/appointment/appointment.mailing.service.ts +1253 -1253
  57. package/src/admin/mailing/appointment/index.ts +1 -1
  58. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  59. package/src/admin/mailing/base.mailing.service.ts +208 -208
  60. package/src/admin/mailing/clinicWelcome/clinicWelcome.mailing.ts +292 -292
  61. package/src/admin/mailing/clinicWelcome/index.ts +1 -1
  62. package/src/admin/mailing/clinicWelcome/templates/welcome.template.ts +225 -225
  63. package/src/admin/mailing/index.ts +5 -5
  64. package/src/admin/mailing/patientInvite/index.ts +2 -2
  65. package/src/admin/mailing/patientInvite/patientInvite.mailing.ts +415 -415
  66. package/src/admin/mailing/patientInvite/templates/invitation.template.ts +105 -105
  67. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  68. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  69. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  70. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  71. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  72. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  73. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  74. package/src/admin/notifications/index.ts +1 -1
  75. package/src/admin/notifications/notifications.admin.ts +818 -818
  76. package/src/admin/requirements/README.md +128 -128
  77. package/src/admin/requirements/index.ts +1 -1
  78. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  79. package/src/admin/users/index.ts +1 -1
  80. package/src/admin/users/user-profile.admin.ts +405 -405
  81. package/src/backoffice/constants/certification.constants.ts +13 -13
  82. package/src/backoffice/constants/index.ts +1 -1
  83. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  84. package/src/backoffice/errors/index.ts +1 -1
  85. package/src/backoffice/expo-safe/README.md +26 -26
  86. package/src/backoffice/expo-safe/index.ts +41 -41
  87. package/src/backoffice/index.ts +5 -5
  88. package/src/backoffice/services/FIXES_README.md +102 -102
  89. package/src/backoffice/services/README.md +57 -57
  90. package/src/backoffice/services/analytics.service.proposal.md +863 -863
  91. package/src/backoffice/services/analytics.service.summary.md +143 -143
  92. package/src/backoffice/services/brand.service.ts +260 -260
  93. package/src/backoffice/services/category.service.ts +384 -384
  94. package/src/backoffice/services/constants.service.ts +385 -385
  95. package/src/backoffice/services/documentation-template.service.ts +202 -202
  96. package/src/backoffice/services/index.ts +10 -10
  97. package/src/backoffice/services/migrate-products.ts +116 -116
  98. package/src/backoffice/services/product.service.ts +557 -557
  99. package/src/backoffice/services/requirement.service.ts +235 -235
  100. package/src/backoffice/services/subcategory.service.ts +461 -461
  101. package/src/backoffice/services/technology.service.ts +1153 -1153
  102. package/src/backoffice/types/README.md +12 -12
  103. package/src/backoffice/types/admin-constants.types.ts +69 -69
  104. package/src/backoffice/types/brand.types.ts +29 -29
  105. package/src/backoffice/types/category.types.ts +67 -67
  106. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  107. package/src/backoffice/types/index.ts +10 -10
  108. package/src/backoffice/types/procedure-product.types.ts +38 -38
  109. package/src/backoffice/types/product.types.ts +239 -239
  110. package/src/backoffice/types/requirement.types.ts +63 -63
  111. package/src/backoffice/types/static/README.md +18 -18
  112. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  113. package/src/backoffice/types/static/certification.types.ts +37 -37
  114. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  115. package/src/backoffice/types/static/index.ts +6 -6
  116. package/src/backoffice/types/static/pricing.types.ts +16 -16
  117. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  118. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  119. package/src/backoffice/types/subcategory.types.ts +34 -34
  120. package/src/backoffice/types/technology.types.ts +168 -168
  121. package/src/backoffice/validations/index.ts +1 -1
  122. package/src/backoffice/validations/schemas.ts +164 -164
  123. package/src/config/__mocks__/firebase.ts +99 -99
  124. package/src/config/firebase.ts +78 -78
  125. package/src/config/index.ts +17 -17
  126. package/src/config/tiers.config.ts +255 -229
  127. package/src/errors/auth.error.ts +6 -6
  128. package/src/errors/auth.errors.ts +211 -211
  129. package/src/errors/clinic.errors.ts +32 -32
  130. package/src/errors/firebase.errors.ts +47 -47
  131. package/src/errors/user.errors.ts +99 -99
  132. package/src/index.backup.ts +407 -407
  133. package/src/index.ts +6 -6
  134. package/src/locales/en.ts +31 -31
  135. package/src/recommender/admin/index.ts +1 -1
  136. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  137. package/src/recommender/front/index.ts +1 -1
  138. package/src/recommender/front/services/onboarding.service.ts +5 -5
  139. package/src/recommender/front/services/recommender.service.ts +3 -3
  140. package/src/recommender/index.ts +1 -1
  141. package/src/services/PATIENTAUTH.MD +197 -197
  142. package/src/services/README.md +106 -106
  143. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  144. package/src/services/__tests__/auth/auth.setup.ts +298 -298
  145. package/src/services/__tests__/auth.service.test.ts +310 -310
  146. package/src/services/__tests__/base.service.test.ts +36 -36
  147. package/src/services/__tests__/user.service.test.ts +530 -530
  148. package/src/services/analytics/ARCHITECTURE.md +199 -199
  149. package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
  150. package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
  151. package/src/services/analytics/QUICK_START.md +393 -393
  152. package/src/services/analytics/README.md +304 -304
  153. package/src/services/analytics/SUMMARY.md +141 -141
  154. package/src/services/analytics/TRENDS.md +380 -380
  155. package/src/services/analytics/USAGE_GUIDE.md +518 -518
  156. package/src/services/analytics/analytics-cloud.service.ts +222 -222
  157. package/src/services/analytics/analytics.service.ts +2148 -2148
  158. package/src/services/analytics/index.ts +4 -4
  159. package/src/services/analytics/review-analytics.service.ts +941 -941
  160. package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
  161. package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
  162. package/src/services/analytics/utils/grouping.utils.ts +434 -434
  163. package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
  164. package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
  165. package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
  166. package/src/services/appointment/README.md +17 -17
  167. package/src/services/appointment/appointment.service.ts +2943 -2941
  168. package/src/services/appointment/index.ts +1 -1
  169. package/src/services/appointment/utils/appointment.utils.ts +620 -620
  170. package/src/services/appointment/utils/extended-procedure.utils.ts +354 -354
  171. package/src/services/appointment/utils/form-initialization.utils.ts +516 -516
  172. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  173. package/src/services/appointment/utils/zone-management.utils.ts +468 -468
  174. package/src/services/appointment/utils/zone-photo.utils.ts +302 -302
  175. package/src/services/auth/auth.service.ts +1435 -1435
  176. package/src/services/auth/auth.v2.service.ts +961 -961
  177. package/src/services/auth/index.ts +7 -7
  178. package/src/services/auth/utils/error.utils.ts +90 -90
  179. package/src/services/auth/utils/firebase.utils.ts +49 -49
  180. package/src/services/auth/utils/index.ts +21 -21
  181. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  182. package/src/services/base.service.ts +41 -41
  183. package/src/services/calendar/calendar.service.ts +1077 -1077
  184. package/src/services/calendar/calendar.v2.service.ts +1693 -1693
  185. package/src/services/calendar/calendar.v3.service.ts +313 -313
  186. package/src/services/calendar/externalCalendar.service.ts +178 -178
  187. package/src/services/calendar/index.ts +5 -5
  188. package/src/services/calendar/synced-calendars.service.ts +743 -743
  189. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  190. package/src/services/calendar/utils/calendar-event.utils.ts +676 -676
  191. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  192. package/src/services/calendar/utils/docs.utils.ts +157 -157
  193. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  194. package/src/services/calendar/utils/index.ts +8 -8
  195. package/src/services/calendar/utils/patient.utils.ts +198 -198
  196. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  197. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  198. package/src/services/clinic/README.md +204 -204
  199. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +265 -265
  200. package/src/services/clinic/__tests__/clinic-group.service.test.ts +222 -222
  201. package/src/services/clinic/__tests__/clinic.service.test.ts +302 -302
  202. package/src/services/clinic/billing-transactions.service.ts +217 -217
  203. package/src/services/clinic/clinic-admin.service.ts +202 -202
  204. package/src/services/clinic/clinic-group.service.ts +310 -310
  205. package/src/services/clinic/clinic.service.ts +720 -720
  206. package/src/services/clinic/index.ts +5 -5
  207. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  208. package/src/services/clinic/utils/admin.utils.ts +551 -551
  209. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  210. package/src/services/clinic/utils/clinic.utils.ts +1023 -1023
  211. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  212. package/src/services/clinic/utils/filter.utils.ts +462 -462
  213. package/src/services/clinic/utils/index.ts +10 -10
  214. package/src/services/clinic/utils/photos.utils.ts +188 -188
  215. package/src/services/clinic/utils/search.utils.ts +83 -83
  216. package/src/services/clinic/utils/tag.utils.ts +124 -124
  217. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  218. package/src/services/documentation-templates/filled-document.service.ts +597 -597
  219. package/src/services/documentation-templates/index.ts +2 -2
  220. package/src/services/index.ts +16 -15
  221. package/src/services/media/index.ts +1 -1
  222. package/src/services/media/media.service.ts +418 -418
  223. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  224. package/src/services/notifications/index.ts +1 -1
  225. package/src/services/notifications/notification.service.ts +215 -215
  226. package/src/services/patient/README.md +48 -48
  227. package/src/services/patient/To-Do.md +43 -43
  228. package/src/services/patient/__tests__/patient.service.test.ts +286 -286
  229. package/src/services/patient/index.ts +2 -2
  230. package/src/services/patient/patient.service.ts +1021 -1021
  231. package/src/services/patient/patientRequirements.service.ts +309 -309
  232. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  233. package/src/services/patient/utils/body-assessment.utils.ts +159 -159
  234. package/src/services/patient/utils/clinic.utils.ts +159 -159
  235. package/src/services/patient/utils/docs.utils.ts +142 -142
  236. package/src/services/patient/utils/hair-scalp-assessment.utils.ts +158 -158
  237. package/src/services/patient/utils/index.ts +9 -9
  238. package/src/services/patient/utils/location.utils.ts +126 -126
  239. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  240. package/src/services/patient/utils/medical.utils.ts +458 -458
  241. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  242. package/src/services/patient/utils/pre-surgical-assessment.utils.ts +161 -161
  243. package/src/services/patient/utils/profile.utils.ts +510 -510
  244. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  245. package/src/services/patient/utils/skin-quality-assessment.utils.ts +160 -160
  246. package/src/services/patient/utils/token.utils.ts +211 -211
  247. package/src/services/practitioner/README.md +145 -145
  248. package/src/services/practitioner/index.ts +1 -1
  249. package/src/services/practitioner/practitioner.service.ts +2355 -2354
  250. package/src/services/procedure/README.md +163 -163
  251. package/src/services/procedure/index.ts +1 -1
  252. package/src/services/procedure/procedure.service.ts +2521 -2521
  253. package/src/services/resource/README.md +119 -0
  254. package/src/services/resource/index.ts +1 -0
  255. package/src/services/resource/resource.service.ts +555 -0
  256. package/src/services/reviews/index.ts +1 -1
  257. package/src/services/reviews/reviews.service.ts +745 -745
  258. package/src/services/tier-enforcement.ts +240 -240
  259. package/src/services/user/index.ts +1 -1
  260. package/src/services/user/user.service.ts +533 -533
  261. package/src/services/user/user.v2.service.ts +467 -467
  262. package/src/types/analytics/analytics.types.ts +597 -597
  263. package/src/types/analytics/grouped-analytics.types.ts +173 -173
  264. package/src/types/analytics/index.ts +4 -4
  265. package/src/types/analytics/stored-analytics.types.ts +137 -137
  266. package/src/types/appointment/index.ts +524 -517
  267. package/src/types/calendar/index.ts +261 -260
  268. package/src/types/calendar/synced-calendar.types.ts +66 -66
  269. package/src/types/clinic/index.ts +530 -529
  270. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  271. package/src/types/clinic/preferences.types.ts +159 -159
  272. package/src/types/clinic/rbac.types.ts +64 -63
  273. package/src/types/clinic/to-do +3 -3
  274. package/src/types/documentation-templates/index.ts +308 -308
  275. package/src/types/index.ts +50 -47
  276. package/src/types/notifications/README.md +77 -77
  277. package/src/types/notifications/index.ts +300 -300
  278. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  279. package/src/types/patient/allergies.ts +58 -58
  280. package/src/types/patient/body-assessment.types.ts +93 -93
  281. package/src/types/patient/hair-scalp-assessment.types.ts +98 -98
  282. package/src/types/patient/index.ts +279 -279
  283. package/src/types/patient/medical-info.types.ts +152 -152
  284. package/src/types/patient/patient-requirements.ts +92 -92
  285. package/src/types/patient/pre-surgical-assessment.types.ts +95 -95
  286. package/src/types/patient/skin-quality-assessment.types.ts +105 -105
  287. package/src/types/patient/token.types.ts +61 -61
  288. package/src/types/practitioner/index.ts +208 -208
  289. package/src/types/procedure/index.ts +189 -183
  290. package/src/types/profile/index.ts +39 -39
  291. package/src/types/resource/README.md +153 -0
  292. package/src/types/resource/index.ts +199 -0
  293. package/src/types/reviews/index.ts +132 -132
  294. package/src/types/tz-lookup.d.ts +4 -4
  295. package/src/types/user/index.ts +60 -60
  296. package/src/utils/TIMESTAMPS.md +176 -176
  297. package/src/utils/TimestampUtils.ts +241 -241
  298. package/src/utils/index.ts +1 -1
  299. package/src/validations/README.md +94 -0
  300. package/src/validations/appointment.schema.ts +589 -589
  301. package/src/validations/calendar.schema.ts +225 -225
  302. package/src/validations/clinic.schema.ts +494 -494
  303. package/src/validations/common.schema.ts +25 -25
  304. package/src/validations/documentation-templates/index.ts +1 -1
  305. package/src/validations/documentation-templates/template.schema.ts +220 -220
  306. package/src/validations/documentation-templates.schema.ts +10 -10
  307. package/src/validations/index.ts +21 -20
  308. package/src/validations/media.schema.ts +10 -10
  309. package/src/validations/notification.schema.ts +90 -90
  310. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  311. package/src/validations/patient/body-assessment.schema.ts +82 -82
  312. package/src/validations/patient/hair-scalp-assessment.schema.ts +70 -70
  313. package/src/validations/patient/medical-info.schema.ts +177 -177
  314. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  315. package/src/validations/patient/pre-surgical-assessment.schema.ts +78 -78
  316. package/src/validations/patient/skin-quality-assessment.schema.ts +70 -70
  317. package/src/validations/patient/token.schema.ts +29 -29
  318. package/src/validations/patient.schema.ts +217 -217
  319. package/src/validations/practitioner.schema.ts +224 -224
  320. package/src/validations/procedure-product.schema.ts +41 -41
  321. package/src/validations/procedure.schema.ts +136 -124
  322. package/src/validations/profile-info.schema.ts +41 -41
  323. package/src/validations/resource.schema.ts +57 -0
  324. package/src/validations/reviews.schema.ts +195 -195
  325. package/src/validations/schemas.ts +109 -109
  326. 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
+ }