@blackcode_sa/metaestetics-api 1.13.5 → 1.13.6

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 (291) 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/package.json +121 -121
  6. package/src/__mocks__/firstore.ts +10 -10
  7. package/src/admin/aggregation/README.md +79 -79
  8. package/src/admin/aggregation/appointment/README.md +128 -128
  9. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1984 -1984
  10. package/src/admin/aggregation/appointment/index.ts +1 -1
  11. package/src/admin/aggregation/clinic/README.md +52 -52
  12. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +966 -703
  13. package/src/admin/aggregation/clinic/index.ts +1 -1
  14. package/src/admin/aggregation/forms/README.md +13 -13
  15. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  16. package/src/admin/aggregation/forms/index.ts +1 -1
  17. package/src/admin/aggregation/index.ts +8 -8
  18. package/src/admin/aggregation/patient/README.md +27 -27
  19. package/src/admin/aggregation/patient/index.ts +1 -1
  20. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  21. package/src/admin/aggregation/practitioner/README.md +42 -42
  22. package/src/admin/aggregation/practitioner/index.ts +1 -1
  23. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  24. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  25. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  26. package/src/admin/aggregation/procedure/README.md +43 -43
  27. package/src/admin/aggregation/procedure/index.ts +1 -1
  28. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  29. package/src/admin/aggregation/reviews/index.ts +1 -1
  30. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +689 -689
  31. package/src/admin/analytics/analytics.admin.service.ts +278 -278
  32. package/src/admin/analytics/index.ts +2 -2
  33. package/src/admin/booking/README.md +125 -125
  34. package/src/admin/booking/booking.admin.ts +1037 -1037
  35. package/src/admin/booking/booking.calculator.ts +712 -712
  36. package/src/admin/booking/booking.types.ts +59 -59
  37. package/src/admin/booking/index.ts +3 -3
  38. package/src/admin/booking/timezones-problem.md +185 -185
  39. package/src/admin/calendar/README.md +7 -7
  40. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  41. package/src/admin/calendar/index.ts +1 -1
  42. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  43. package/src/admin/documentation-templates/index.ts +1 -1
  44. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  45. package/src/admin/free-consultation/index.ts +1 -1
  46. package/src/admin/index.ts +81 -81
  47. package/src/admin/logger/index.ts +78 -78
  48. package/src/admin/mailing/README.md +95 -95
  49. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  50. package/src/admin/mailing/appointment/index.ts +1 -1
  51. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  52. package/src/admin/mailing/base.mailing.service.ts +208 -208
  53. package/src/admin/mailing/index.ts +3 -3
  54. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  55. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  56. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  57. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  58. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  59. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  60. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  61. package/src/admin/notifications/index.ts +1 -1
  62. package/src/admin/notifications/notifications.admin.ts +710 -710
  63. package/src/admin/requirements/README.md +128 -128
  64. package/src/admin/requirements/index.ts +1 -1
  65. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  66. package/src/admin/users/index.ts +1 -1
  67. package/src/admin/users/user-profile.admin.ts +405 -405
  68. package/src/backoffice/constants/certification.constants.ts +13 -13
  69. package/src/backoffice/constants/index.ts +1 -1
  70. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  71. package/src/backoffice/errors/index.ts +1 -1
  72. package/src/backoffice/expo-safe/README.md +26 -26
  73. package/src/backoffice/expo-safe/index.ts +41 -41
  74. package/src/backoffice/index.ts +5 -5
  75. package/src/backoffice/services/FIXES_README.md +102 -102
  76. package/src/backoffice/services/README.md +57 -57
  77. package/src/backoffice/services/analytics.service.proposal.md +863 -863
  78. package/src/backoffice/services/analytics.service.summary.md +143 -143
  79. package/src/backoffice/services/brand.service.ts +256 -256
  80. package/src/backoffice/services/category.service.ts +384 -384
  81. package/src/backoffice/services/constants.service.ts +385 -385
  82. package/src/backoffice/services/documentation-template.service.ts +202 -202
  83. package/src/backoffice/services/index.ts +10 -10
  84. package/src/backoffice/services/migrate-products.ts +116 -116
  85. package/src/backoffice/services/product.service.ts +553 -553
  86. package/src/backoffice/services/requirement.service.ts +235 -235
  87. package/src/backoffice/services/subcategory.service.ts +461 -461
  88. package/src/backoffice/services/technology.service.ts +1151 -1151
  89. package/src/backoffice/types/README.md +12 -12
  90. package/src/backoffice/types/admin-constants.types.ts +69 -69
  91. package/src/backoffice/types/brand.types.ts +29 -29
  92. package/src/backoffice/types/category.types.ts +67 -67
  93. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  94. package/src/backoffice/types/index.ts +10 -10
  95. package/src/backoffice/types/procedure-product.types.ts +38 -38
  96. package/src/backoffice/types/product.types.ts +240 -240
  97. package/src/backoffice/types/requirement.types.ts +63 -63
  98. package/src/backoffice/types/static/README.md +18 -18
  99. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  100. package/src/backoffice/types/static/certification.types.ts +37 -37
  101. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  102. package/src/backoffice/types/static/index.ts +6 -6
  103. package/src/backoffice/types/static/pricing.types.ts +16 -16
  104. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  105. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  106. package/src/backoffice/types/subcategory.types.ts +34 -34
  107. package/src/backoffice/types/technology.types.ts +168 -168
  108. package/src/backoffice/validations/index.ts +1 -1
  109. package/src/backoffice/validations/schemas.ts +164 -164
  110. package/src/config/__mocks__/firebase.ts +99 -99
  111. package/src/config/firebase.ts +78 -78
  112. package/src/config/index.ts +9 -9
  113. package/src/errors/auth.error.ts +6 -6
  114. package/src/errors/auth.errors.ts +200 -200
  115. package/src/errors/clinic.errors.ts +32 -32
  116. package/src/errors/firebase.errors.ts +47 -47
  117. package/src/errors/user.errors.ts +99 -99
  118. package/src/index.backup.ts +407 -407
  119. package/src/index.ts +6 -6
  120. package/src/locales/en.ts +31 -31
  121. package/src/recommender/admin/index.ts +1 -1
  122. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  123. package/src/recommender/front/index.ts +1 -1
  124. package/src/recommender/front/services/onboarding.service.ts +5 -5
  125. package/src/recommender/front/services/recommender.service.ts +3 -3
  126. package/src/recommender/index.ts +1 -1
  127. package/src/services/PATIENTAUTH.MD +197 -197
  128. package/src/services/README.md +106 -106
  129. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  130. package/src/services/__tests__/auth/auth.setup.ts +293 -293
  131. package/src/services/__tests__/auth.service.test.ts +346 -346
  132. package/src/services/__tests__/base.service.test.ts +77 -77
  133. package/src/services/__tests__/user.service.test.ts +528 -528
  134. package/src/services/analytics/ARCHITECTURE.md +199 -199
  135. package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
  136. package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
  137. package/src/services/analytics/QUICK_START.md +393 -393
  138. package/src/services/analytics/README.md +304 -304
  139. package/src/services/analytics/SUMMARY.md +141 -141
  140. package/src/services/analytics/TRENDS.md +380 -380
  141. package/src/services/analytics/USAGE_GUIDE.md +518 -518
  142. package/src/services/analytics/analytics-cloud.service.ts +222 -222
  143. package/src/services/analytics/analytics.service.ts +2142 -2142
  144. package/src/services/analytics/index.ts +4 -4
  145. package/src/services/analytics/review-analytics.service.ts +941 -941
  146. package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
  147. package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
  148. package/src/services/analytics/utils/grouping.utils.ts +434 -434
  149. package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
  150. package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
  151. package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
  152. package/src/services/appointment/README.md +17 -17
  153. package/src/services/appointment/appointment.service.ts +2558 -2558
  154. package/src/services/appointment/index.ts +1 -1
  155. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  156. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  157. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  158. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  159. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  160. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  161. package/src/services/auth/auth.service.ts +989 -989
  162. package/src/services/auth/auth.v2.service.ts +961 -961
  163. package/src/services/auth/index.ts +7 -7
  164. package/src/services/auth/utils/error.utils.ts +90 -90
  165. package/src/services/auth/utils/firebase.utils.ts +49 -49
  166. package/src/services/auth/utils/index.ts +21 -21
  167. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  168. package/src/services/base.service.ts +41 -41
  169. package/src/services/calendar/calendar.service.ts +1077 -1077
  170. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  171. package/src/services/calendar/calendar.v3.service.ts +313 -313
  172. package/src/services/calendar/externalCalendar.service.ts +178 -178
  173. package/src/services/calendar/index.ts +5 -5
  174. package/src/services/calendar/synced-calendars.service.ts +743 -743
  175. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  176. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  177. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  178. package/src/services/calendar/utils/docs.utils.ts +157 -157
  179. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  180. package/src/services/calendar/utils/index.ts +8 -8
  181. package/src/services/calendar/utils/patient.utils.ts +198 -198
  182. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  183. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  184. package/src/services/clinic/README.md +204 -204
  185. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  186. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  187. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  188. package/src/services/clinic/billing-transactions.service.ts +217 -217
  189. package/src/services/clinic/clinic-admin.service.ts +202 -202
  190. package/src/services/clinic/clinic-group.service.ts +310 -310
  191. package/src/services/clinic/clinic.service.ts +708 -708
  192. package/src/services/clinic/index.ts +5 -5
  193. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  194. package/src/services/clinic/utils/admin.utils.ts +551 -551
  195. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  196. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  197. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  198. package/src/services/clinic/utils/filter.utils.ts +446 -446
  199. package/src/services/clinic/utils/index.ts +11 -11
  200. package/src/services/clinic/utils/photos.utils.ts +188 -188
  201. package/src/services/clinic/utils/search.utils.ts +84 -84
  202. package/src/services/clinic/utils/tag.utils.ts +124 -124
  203. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  204. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  205. package/src/services/documentation-templates/index.ts +2 -2
  206. package/src/services/index.ts +14 -14
  207. package/src/services/media/index.ts +1 -1
  208. package/src/services/media/media.service.ts +418 -418
  209. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  210. package/src/services/notifications/index.ts +1 -1
  211. package/src/services/notifications/notification.service.ts +215 -215
  212. package/src/services/patient/README.md +48 -48
  213. package/src/services/patient/To-Do.md +43 -43
  214. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  215. package/src/services/patient/index.ts +2 -2
  216. package/src/services/patient/patient.service.ts +883 -883
  217. package/src/services/patient/patientRequirements.service.ts +285 -285
  218. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  219. package/src/services/patient/utils/clinic.utils.ts +80 -80
  220. package/src/services/patient/utils/docs.utils.ts +142 -142
  221. package/src/services/patient/utils/index.ts +9 -9
  222. package/src/services/patient/utils/location.utils.ts +126 -126
  223. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  224. package/src/services/patient/utils/medical.utils.ts +458 -458
  225. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  226. package/src/services/patient/utils/profile.utils.ts +510 -510
  227. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  228. package/src/services/patient/utils/token.utils.ts +211 -211
  229. package/src/services/practitioner/README.md +145 -145
  230. package/src/services/practitioner/index.ts +1 -1
  231. package/src/services/practitioner/practitioner.service.ts +1742 -1742
  232. package/src/services/procedure/README.md +163 -163
  233. package/src/services/procedure/index.ts +1 -1
  234. package/src/services/procedure/procedure.service.ts +2200 -2200
  235. package/src/services/reviews/index.ts +1 -1
  236. package/src/services/reviews/reviews.service.ts +734 -734
  237. package/src/services/user/index.ts +1 -1
  238. package/src/services/user/user.service.ts +489 -489
  239. package/src/services/user/user.v2.service.ts +466 -466
  240. package/src/types/analytics/analytics.types.ts +597 -597
  241. package/src/types/analytics/grouped-analytics.types.ts +173 -173
  242. package/src/types/analytics/index.ts +4 -4
  243. package/src/types/analytics/stored-analytics.types.ts +137 -137
  244. package/src/types/appointment/index.ts +480 -480
  245. package/src/types/calendar/index.ts +258 -258
  246. package/src/types/calendar/synced-calendar.types.ts +66 -66
  247. package/src/types/clinic/index.ts +498 -498
  248. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  249. package/src/types/clinic/preferences.types.ts +159 -159
  250. package/src/types/clinic/to-do +3 -3
  251. package/src/types/documentation-templates/index.ts +308 -308
  252. package/src/types/index.ts +47 -47
  253. package/src/types/notifications/README.md +77 -77
  254. package/src/types/notifications/index.ts +286 -286
  255. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  256. package/src/types/patient/allergies.ts +58 -58
  257. package/src/types/patient/index.ts +275 -275
  258. package/src/types/patient/medical-info.types.ts +152 -152
  259. package/src/types/patient/patient-requirements.ts +92 -92
  260. package/src/types/patient/token.types.ts +61 -61
  261. package/src/types/practitioner/index.ts +206 -206
  262. package/src/types/procedure/index.ts +181 -181
  263. package/src/types/profile/index.ts +39 -39
  264. package/src/types/reviews/index.ts +132 -132
  265. package/src/types/tz-lookup.d.ts +4 -4
  266. package/src/types/user/index.ts +38 -38
  267. package/src/utils/TIMESTAMPS.md +176 -176
  268. package/src/utils/TimestampUtils.ts +241 -241
  269. package/src/utils/index.ts +1 -1
  270. package/src/validations/appointment.schema.ts +574 -574
  271. package/src/validations/calendar.schema.ts +225 -225
  272. package/src/validations/clinic.schema.ts +494 -494
  273. package/src/validations/common.schema.ts +25 -25
  274. package/src/validations/documentation-templates/index.ts +1 -1
  275. package/src/validations/documentation-templates/template.schema.ts +220 -220
  276. package/src/validations/documentation-templates.schema.ts +10 -10
  277. package/src/validations/index.ts +20 -20
  278. package/src/validations/media.schema.ts +10 -10
  279. package/src/validations/notification.schema.ts +90 -90
  280. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  281. package/src/validations/patient/medical-info.schema.ts +125 -125
  282. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  283. package/src/validations/patient/token.schema.ts +29 -29
  284. package/src/validations/patient.schema.ts +217 -217
  285. package/src/validations/practitioner.schema.ts +222 -222
  286. package/src/validations/procedure-product.schema.ts +41 -41
  287. package/src/validations/procedure.schema.ts +124 -124
  288. package/src/validations/profile-info.schema.ts +41 -41
  289. package/src/validations/reviews.schema.ts +195 -195
  290. package/src/validations/schemas.ts +104 -104
  291. package/src/validations/shared.schema.ts +78 -78
@@ -1,322 +1,322 @@
1
- import * as admin from 'firebase-admin';
2
- import {
3
- FilledDocument,
4
- FilledDocumentStatus,
5
- USER_FORMS_SUBCOLLECTION,
6
- DOCTOR_FORMS_SUBCOLLECTION,
7
- } from '../../../types/documentation-templates';
8
- import { Appointment, LinkedFormInfo, APPOINTMENTS_COLLECTION } from '../../../types/appointment';
9
- import { Logger } from '../../logger';
10
- import { Timestamp } from 'firebase/firestore';
11
-
12
- /**
13
- * @class FilledFormsAggregationService
14
- * @description Handles aggregation tasks related to filled forms data updates.
15
- * Updates appointment documents with LinkedFormInfo when forms are created, updated, or deleted.
16
- */
17
- export class FilledFormsAggregationService {
18
- private db: admin.firestore.Firestore;
19
-
20
- /**
21
- * Constructor for FilledFormsAggregationService.
22
- * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
23
- */
24
- constructor(firestore?: admin.firestore.Firestore) {
25
- this.db = firestore || admin.firestore();
26
- Logger.info('[FilledFormsAggregationService] Initialized');
27
- }
28
-
29
- /**
30
- * Handles side effects when a filled form is created or updated.
31
- * This function would typically be called by a Firestore onCreate or onUpdate trigger.
32
- * @param filledDocument The filled document that was created or updated.
33
- * @returns {Promise<void>}
34
- */
35
- async handleFilledFormCreateOrUpdate(filledDocument: FilledDocument): Promise<void> {
36
- Logger.info(
37
- `[FilledFormsAggregationService] Handling CREATE/UPDATE for filled form: ${filledDocument.id}, appointment: ${filledDocument.appointmentId}`,
38
- );
39
-
40
- try {
41
- // 1. Get the appointment document
42
- const appointmentRef = this.db
43
- .collection(APPOINTMENTS_COLLECTION)
44
- .doc(filledDocument.appointmentId);
45
-
46
- const appointmentDoc = await appointmentRef.get();
47
- if (!appointmentDoc.exists) {
48
- Logger.error(
49
- `[FilledFormsAggregationService] Appointment ${filledDocument.appointmentId} not found.`,
50
- );
51
- return;
52
- }
53
-
54
- // Fetch the document template to get the title, with fallbacks.
55
- let templateData: admin.firestore.DocumentData | undefined;
56
- const templateRef = this.db
57
- .collection('documentation-templates')
58
- .doc(filledDocument.templateId);
59
- const templateDoc = await templateRef.get();
60
-
61
- if (templateDoc.exists) {
62
- const currentTemplateData = templateDoc.data();
63
- if (currentTemplateData && currentTemplateData.version === filledDocument.templateVersion) {
64
- // The requested version is the latest one.
65
- templateData = currentTemplateData;
66
- } else {
67
- // The requested version is an older one, look in the 'versions' subcollection.
68
- const versionRef = templateRef
69
- .collection('versions')
70
- .doc(filledDocument.templateVersion.toString());
71
- const versionDoc = await versionRef.get();
72
-
73
- if (versionDoc.exists) {
74
- templateData = versionDoc.data();
75
- } else {
76
- // Fallback 1: If the specific version is not found, use the latest version as a fallback.
77
- Logger.warn(
78
- `[FilledFormsAggregationService] Template version ${filledDocument.templateVersion} not found for template ${filledDocument.templateId}. Falling back to the latest version.`,
79
- );
80
- templateData = currentTemplateData;
81
- }
82
- }
83
- } else {
84
- // This case should be rare if data is consistent, but we handle it.
85
- Logger.error(
86
- `[FilledFormsAggregationService] Document template ${filledDocument.templateId} not found. Cannot retrieve title.`,
87
- );
88
- // templateData remains undefined, will trigger the final fallback for the title.
89
- }
90
-
91
- const appointment = appointmentDoc.data() as Appointment;
92
-
93
- // 2. Prepare the LinkedFormInfo object
94
- const formSubcollection = filledDocument.isUserForm
95
- ? USER_FORMS_SUBCOLLECTION
96
- : DOCTOR_FORMS_SUBCOLLECTION;
97
-
98
- const linkedFormInfo: LinkedFormInfo = {
99
- formId: filledDocument.id,
100
- templateId: filledDocument.templateId,
101
- templateVersion: filledDocument.templateVersion,
102
- title: templateData?.title || (filledDocument.isUserForm ? 'User Form' : 'Doctor Form'),
103
- isUserForm: filledDocument.isUserForm,
104
- isRequired: filledDocument.isRequired,
105
- status: filledDocument.status,
106
- path: `${APPOINTMENTS_COLLECTION}/${filledDocument.appointmentId}/${formSubcollection}/${filledDocument.id}`,
107
- };
108
-
109
- // Add timestamps if available
110
- if (filledDocument.updatedAt) {
111
- // Convert to admin.firestore.Timestamp to ensure compatibility
112
- linkedFormInfo.submittedAt = admin.firestore.Timestamp.fromMillis(
113
- filledDocument.updatedAt,
114
- ) as unknown as Timestamp;
115
- }
116
-
117
- if (
118
- filledDocument.status === FilledDocumentStatus.COMPLETED ||
119
- filledDocument.status === FilledDocumentStatus.SIGNED
120
- ) {
121
- linkedFormInfo.completedAt = admin.firestore.Timestamp.fromMillis(
122
- filledDocument.updatedAt,
123
- ) as unknown as Timestamp;
124
- }
125
-
126
- // 3. Handle linkedForms array - use direct array manipulation to avoid arrayRemove issues
127
- let updateData: any = {};
128
- let updatedLinkedForms: LinkedFormInfo[] = [];
129
-
130
- if (appointment.linkedForms && appointment.linkedForms.length > 0) {
131
- // Filter out any existing entries for this form ID to prevent duplicates
132
- updatedLinkedForms = appointment.linkedForms.filter(
133
- form => form.formId !== filledDocument.id,
134
- );
135
- }
136
-
137
- // Add the new/updated form info
138
- updatedLinkedForms.push(linkedFormInfo);
139
-
140
- // Prepare the update data
141
- updateData = {
142
- linkedForms: updatedLinkedForms,
143
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
144
- };
145
-
146
- // 4. Handle linkedFormIds array
147
- let updatedLinkedFormIds: string[] = appointment.linkedFormIds || [];
148
- if (!updatedLinkedFormIds.includes(filledDocument.id)) {
149
- updatedLinkedFormIds.push(filledDocument.id);
150
- updateData.linkedFormIds = updatedLinkedFormIds;
151
- }
152
-
153
- // 5. Handle pendingUserFormsIds for required user forms
154
- if (
155
- filledDocument.isUserForm &&
156
- filledDocument.isRequired &&
157
- (filledDocument.status === FilledDocumentStatus.COMPLETED ||
158
- filledDocument.status === FilledDocumentStatus.SIGNED)
159
- ) {
160
- // Check if the form ID is in pendingUserFormsIds
161
- if (
162
- appointment.pendingUserFormsIds &&
163
- appointment.pendingUserFormsIds.includes(filledDocument.id)
164
- ) {
165
- // Remove the form ID from pendingUserFormsIds
166
- updateData.pendingUserFormsIds = admin.firestore.FieldValue.arrayRemove(
167
- filledDocument.id,
168
- );
169
- Logger.info(
170
- `[FilledFormsAggregationService] Removing form ${filledDocument.id} from pendingUserFormsIds`,
171
- );
172
- }
173
- }
174
-
175
- // 6. Update the appointment
176
- await appointmentRef.update(updateData);
177
- Logger.info(
178
- `[FilledFormsAggregationService] Successfully updated appointment ${filledDocument.appointmentId} with form info for ${filledDocument.id}`,
179
- );
180
- } catch (error) {
181
- Logger.error(
182
- `[FilledFormsAggregationService] Error updating appointment for filled form ${filledDocument.id}:`,
183
- error,
184
- );
185
- throw error;
186
- }
187
- }
188
-
189
- /**
190
- * Handles side effects when a filled form is deleted.
191
- * This function would typically be called by a Firestore onDelete trigger.
192
- * @param filledDocument The filled document that was deleted.
193
- * @returns {Promise<void>}
194
- */
195
- async handleFilledFormDelete(filledDocument: FilledDocument): Promise<void> {
196
- Logger.info(
197
- `[FilledFormsAggregationService] Handling DELETE for filled form: ${filledDocument.id}, appointment: ${filledDocument.appointmentId}`,
198
- );
199
-
200
- try {
201
- // 1. Get the appointment document
202
- const appointmentRef = this.db
203
- .collection(APPOINTMENTS_COLLECTION)
204
- .doc(filledDocument.appointmentId);
205
-
206
- const appointmentDoc = await appointmentRef.get();
207
- if (!appointmentDoc.exists) {
208
- Logger.error(
209
- `[FilledFormsAggregationService] Appointment ${filledDocument.appointmentId} not found.`,
210
- );
211
- return;
212
- }
213
-
214
- const appointment = appointmentDoc.data() as Appointment;
215
-
216
- // 2. Prepare the update data
217
- let updateData: any = {};
218
-
219
- // 3. Remove the form from linkedForms if it exists
220
- if (appointment.linkedForms && appointment.linkedForms.length > 0) {
221
- const formToRemove = appointment.linkedForms.find(
222
- form => form.formId === filledDocument.id,
223
- );
224
-
225
- if (formToRemove) {
226
- updateData.linkedForms = admin.firestore.FieldValue.arrayRemove(formToRemove);
227
- }
228
- }
229
-
230
- // 4. Remove the form ID from linkedFormIds
231
- if (appointment.linkedFormIds && appointment.linkedFormIds.includes(filledDocument.id)) {
232
- updateData.linkedFormIds = admin.firestore.FieldValue.arrayRemove(filledDocument.id);
233
- }
234
-
235
- // 5. For required user forms, handle pendingUserFormsIds
236
- if (filledDocument.isUserForm && filledDocument.isRequired) {
237
- if (
238
- filledDocument.status !== FilledDocumentStatus.COMPLETED &&
239
- filledDocument.status !== FilledDocumentStatus.SIGNED
240
- ) {
241
- // If the form was not completed or signed, ensure it's added back to pending
242
- if (
243
- !appointment.pendingUserFormsIds ||
244
- !appointment.pendingUserFormsIds.includes(filledDocument.id)
245
- ) {
246
- updateData.pendingUserFormsIds = appointment.pendingUserFormsIds
247
- ? admin.firestore.FieldValue.arrayUnion(filledDocument.id)
248
- : [filledDocument.id];
249
- }
250
- }
251
- }
252
-
253
- // 6. Only update if there's something to update
254
- if (Object.keys(updateData).length > 0) {
255
- updateData.updatedAt = admin.firestore.FieldValue.serverTimestamp();
256
- await appointmentRef.update(updateData);
257
- Logger.info(
258
- `[FilledFormsAggregationService] Successfully updated appointment ${filledDocument.appointmentId} after form deletion`,
259
- );
260
- } else {
261
- Logger.info(
262
- `[FilledFormsAggregationService] No updates needed for appointment ${filledDocument.appointmentId}`,
263
- );
264
- }
265
- } catch (error) {
266
- Logger.error(
267
- `[FilledFormsAggregationService] Error updating appointment after form deletion for ${filledDocument.id}:`,
268
- error,
269
- );
270
- throw error;
271
- }
272
- }
273
-
274
- /**
275
- * Updates the appointment's pendingUserFormsIds for a new required user form.
276
- * This should be called when a required user form is first created.
277
- * @param filledDocument The newly created filled document.
278
- * @returns {Promise<void>}
279
- */
280
- async handleRequiredUserFormCreate(filledDocument: FilledDocument): Promise<void> {
281
- if (!filledDocument.isUserForm || !filledDocument.isRequired) {
282
- return; // Only process required user forms
283
- }
284
-
285
- Logger.info(
286
- `[FilledFormsAggregationService] Handling new required user form creation: ${filledDocument.id}`,
287
- );
288
-
289
- try {
290
- const appointmentRef = this.db
291
- .collection(APPOINTMENTS_COLLECTION)
292
- .doc(filledDocument.appointmentId);
293
-
294
- // Skip adding to pendingUserFormsIds if already completed/signed
295
- if (
296
- filledDocument.status === FilledDocumentStatus.COMPLETED ||
297
- filledDocument.status === FilledDocumentStatus.SIGNED
298
- ) {
299
- Logger.info(
300
- `[FilledFormsAggregationService] Form ${filledDocument.id} is already completed/signed, not adding to pendingUserFormsIds`,
301
- );
302
- return;
303
- }
304
-
305
- // Add to pendingUserFormsIds
306
- await appointmentRef.update({
307
- pendingUserFormsIds: admin.firestore.FieldValue.arrayUnion(filledDocument.id),
308
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
309
- });
310
-
311
- Logger.info(
312
- `[FilledFormsAggregationService] Successfully added form ${filledDocument.id} to pendingUserFormsIds for appointment ${filledDocument.appointmentId}`,
313
- );
314
- } catch (error) {
315
- Logger.error(
316
- `[FilledFormsAggregationService] Error handling required user form creation for ${filledDocument.id}:`,
317
- error,
318
- );
319
- throw error;
320
- }
321
- }
322
- }
1
+ import * as admin from 'firebase-admin';
2
+ import {
3
+ FilledDocument,
4
+ FilledDocumentStatus,
5
+ USER_FORMS_SUBCOLLECTION,
6
+ DOCTOR_FORMS_SUBCOLLECTION,
7
+ } from '../../../types/documentation-templates';
8
+ import { Appointment, LinkedFormInfo, APPOINTMENTS_COLLECTION } from '../../../types/appointment';
9
+ import { Logger } from '../../logger';
10
+ import { Timestamp } from 'firebase/firestore';
11
+
12
+ /**
13
+ * @class FilledFormsAggregationService
14
+ * @description Handles aggregation tasks related to filled forms data updates.
15
+ * Updates appointment documents with LinkedFormInfo when forms are created, updated, or deleted.
16
+ */
17
+ export class FilledFormsAggregationService {
18
+ private db: admin.firestore.Firestore;
19
+
20
+ /**
21
+ * Constructor for FilledFormsAggregationService.
22
+ * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
23
+ */
24
+ constructor(firestore?: admin.firestore.Firestore) {
25
+ this.db = firestore || admin.firestore();
26
+ Logger.info('[FilledFormsAggregationService] Initialized');
27
+ }
28
+
29
+ /**
30
+ * Handles side effects when a filled form is created or updated.
31
+ * This function would typically be called by a Firestore onCreate or onUpdate trigger.
32
+ * @param filledDocument The filled document that was created or updated.
33
+ * @returns {Promise<void>}
34
+ */
35
+ async handleFilledFormCreateOrUpdate(filledDocument: FilledDocument): Promise<void> {
36
+ Logger.info(
37
+ `[FilledFormsAggregationService] Handling CREATE/UPDATE for filled form: ${filledDocument.id}, appointment: ${filledDocument.appointmentId}`,
38
+ );
39
+
40
+ try {
41
+ // 1. Get the appointment document
42
+ const appointmentRef = this.db
43
+ .collection(APPOINTMENTS_COLLECTION)
44
+ .doc(filledDocument.appointmentId);
45
+
46
+ const appointmentDoc = await appointmentRef.get();
47
+ if (!appointmentDoc.exists) {
48
+ Logger.error(
49
+ `[FilledFormsAggregationService] Appointment ${filledDocument.appointmentId} not found.`,
50
+ );
51
+ return;
52
+ }
53
+
54
+ // Fetch the document template to get the title, with fallbacks.
55
+ let templateData: admin.firestore.DocumentData | undefined;
56
+ const templateRef = this.db
57
+ .collection('documentation-templates')
58
+ .doc(filledDocument.templateId);
59
+ const templateDoc = await templateRef.get();
60
+
61
+ if (templateDoc.exists) {
62
+ const currentTemplateData = templateDoc.data();
63
+ if (currentTemplateData && currentTemplateData.version === filledDocument.templateVersion) {
64
+ // The requested version is the latest one.
65
+ templateData = currentTemplateData;
66
+ } else {
67
+ // The requested version is an older one, look in the 'versions' subcollection.
68
+ const versionRef = templateRef
69
+ .collection('versions')
70
+ .doc(filledDocument.templateVersion.toString());
71
+ const versionDoc = await versionRef.get();
72
+
73
+ if (versionDoc.exists) {
74
+ templateData = versionDoc.data();
75
+ } else {
76
+ // Fallback 1: If the specific version is not found, use the latest version as a fallback.
77
+ Logger.warn(
78
+ `[FilledFormsAggregationService] Template version ${filledDocument.templateVersion} not found for template ${filledDocument.templateId}. Falling back to the latest version.`,
79
+ );
80
+ templateData = currentTemplateData;
81
+ }
82
+ }
83
+ } else {
84
+ // This case should be rare if data is consistent, but we handle it.
85
+ Logger.error(
86
+ `[FilledFormsAggregationService] Document template ${filledDocument.templateId} not found. Cannot retrieve title.`,
87
+ );
88
+ // templateData remains undefined, will trigger the final fallback for the title.
89
+ }
90
+
91
+ const appointment = appointmentDoc.data() as Appointment;
92
+
93
+ // 2. Prepare the LinkedFormInfo object
94
+ const formSubcollection = filledDocument.isUserForm
95
+ ? USER_FORMS_SUBCOLLECTION
96
+ : DOCTOR_FORMS_SUBCOLLECTION;
97
+
98
+ const linkedFormInfo: LinkedFormInfo = {
99
+ formId: filledDocument.id,
100
+ templateId: filledDocument.templateId,
101
+ templateVersion: filledDocument.templateVersion,
102
+ title: templateData?.title || (filledDocument.isUserForm ? 'User Form' : 'Doctor Form'),
103
+ isUserForm: filledDocument.isUserForm,
104
+ isRequired: filledDocument.isRequired,
105
+ status: filledDocument.status,
106
+ path: `${APPOINTMENTS_COLLECTION}/${filledDocument.appointmentId}/${formSubcollection}/${filledDocument.id}`,
107
+ };
108
+
109
+ // Add timestamps if available
110
+ if (filledDocument.updatedAt) {
111
+ // Convert to admin.firestore.Timestamp to ensure compatibility
112
+ linkedFormInfo.submittedAt = admin.firestore.Timestamp.fromMillis(
113
+ filledDocument.updatedAt,
114
+ ) as unknown as Timestamp;
115
+ }
116
+
117
+ if (
118
+ filledDocument.status === FilledDocumentStatus.COMPLETED ||
119
+ filledDocument.status === FilledDocumentStatus.SIGNED
120
+ ) {
121
+ linkedFormInfo.completedAt = admin.firestore.Timestamp.fromMillis(
122
+ filledDocument.updatedAt,
123
+ ) as unknown as Timestamp;
124
+ }
125
+
126
+ // 3. Handle linkedForms array - use direct array manipulation to avoid arrayRemove issues
127
+ let updateData: any = {};
128
+ let updatedLinkedForms: LinkedFormInfo[] = [];
129
+
130
+ if (appointment.linkedForms && appointment.linkedForms.length > 0) {
131
+ // Filter out any existing entries for this form ID to prevent duplicates
132
+ updatedLinkedForms = appointment.linkedForms.filter(
133
+ form => form.formId !== filledDocument.id,
134
+ );
135
+ }
136
+
137
+ // Add the new/updated form info
138
+ updatedLinkedForms.push(linkedFormInfo);
139
+
140
+ // Prepare the update data
141
+ updateData = {
142
+ linkedForms: updatedLinkedForms,
143
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
144
+ };
145
+
146
+ // 4. Handle linkedFormIds array
147
+ let updatedLinkedFormIds: string[] = appointment.linkedFormIds || [];
148
+ if (!updatedLinkedFormIds.includes(filledDocument.id)) {
149
+ updatedLinkedFormIds.push(filledDocument.id);
150
+ updateData.linkedFormIds = updatedLinkedFormIds;
151
+ }
152
+
153
+ // 5. Handle pendingUserFormsIds for required user forms
154
+ if (
155
+ filledDocument.isUserForm &&
156
+ filledDocument.isRequired &&
157
+ (filledDocument.status === FilledDocumentStatus.COMPLETED ||
158
+ filledDocument.status === FilledDocumentStatus.SIGNED)
159
+ ) {
160
+ // Check if the form ID is in pendingUserFormsIds
161
+ if (
162
+ appointment.pendingUserFormsIds &&
163
+ appointment.pendingUserFormsIds.includes(filledDocument.id)
164
+ ) {
165
+ // Remove the form ID from pendingUserFormsIds
166
+ updateData.pendingUserFormsIds = admin.firestore.FieldValue.arrayRemove(
167
+ filledDocument.id,
168
+ );
169
+ Logger.info(
170
+ `[FilledFormsAggregationService] Removing form ${filledDocument.id} from pendingUserFormsIds`,
171
+ );
172
+ }
173
+ }
174
+
175
+ // 6. Update the appointment
176
+ await appointmentRef.update(updateData);
177
+ Logger.info(
178
+ `[FilledFormsAggregationService] Successfully updated appointment ${filledDocument.appointmentId} with form info for ${filledDocument.id}`,
179
+ );
180
+ } catch (error) {
181
+ Logger.error(
182
+ `[FilledFormsAggregationService] Error updating appointment for filled form ${filledDocument.id}:`,
183
+ error,
184
+ );
185
+ throw error;
186
+ }
187
+ }
188
+
189
+ /**
190
+ * Handles side effects when a filled form is deleted.
191
+ * This function would typically be called by a Firestore onDelete trigger.
192
+ * @param filledDocument The filled document that was deleted.
193
+ * @returns {Promise<void>}
194
+ */
195
+ async handleFilledFormDelete(filledDocument: FilledDocument): Promise<void> {
196
+ Logger.info(
197
+ `[FilledFormsAggregationService] Handling DELETE for filled form: ${filledDocument.id}, appointment: ${filledDocument.appointmentId}`,
198
+ );
199
+
200
+ try {
201
+ // 1. Get the appointment document
202
+ const appointmentRef = this.db
203
+ .collection(APPOINTMENTS_COLLECTION)
204
+ .doc(filledDocument.appointmentId);
205
+
206
+ const appointmentDoc = await appointmentRef.get();
207
+ if (!appointmentDoc.exists) {
208
+ Logger.error(
209
+ `[FilledFormsAggregationService] Appointment ${filledDocument.appointmentId} not found.`,
210
+ );
211
+ return;
212
+ }
213
+
214
+ const appointment = appointmentDoc.data() as Appointment;
215
+
216
+ // 2. Prepare the update data
217
+ let updateData: any = {};
218
+
219
+ // 3. Remove the form from linkedForms if it exists
220
+ if (appointment.linkedForms && appointment.linkedForms.length > 0) {
221
+ const formToRemove = appointment.linkedForms.find(
222
+ form => form.formId === filledDocument.id,
223
+ );
224
+
225
+ if (formToRemove) {
226
+ updateData.linkedForms = admin.firestore.FieldValue.arrayRemove(formToRemove);
227
+ }
228
+ }
229
+
230
+ // 4. Remove the form ID from linkedFormIds
231
+ if (appointment.linkedFormIds && appointment.linkedFormIds.includes(filledDocument.id)) {
232
+ updateData.linkedFormIds = admin.firestore.FieldValue.arrayRemove(filledDocument.id);
233
+ }
234
+
235
+ // 5. For required user forms, handle pendingUserFormsIds
236
+ if (filledDocument.isUserForm && filledDocument.isRequired) {
237
+ if (
238
+ filledDocument.status !== FilledDocumentStatus.COMPLETED &&
239
+ filledDocument.status !== FilledDocumentStatus.SIGNED
240
+ ) {
241
+ // If the form was not completed or signed, ensure it's added back to pending
242
+ if (
243
+ !appointment.pendingUserFormsIds ||
244
+ !appointment.pendingUserFormsIds.includes(filledDocument.id)
245
+ ) {
246
+ updateData.pendingUserFormsIds = appointment.pendingUserFormsIds
247
+ ? admin.firestore.FieldValue.arrayUnion(filledDocument.id)
248
+ : [filledDocument.id];
249
+ }
250
+ }
251
+ }
252
+
253
+ // 6. Only update if there's something to update
254
+ if (Object.keys(updateData).length > 0) {
255
+ updateData.updatedAt = admin.firestore.FieldValue.serverTimestamp();
256
+ await appointmentRef.update(updateData);
257
+ Logger.info(
258
+ `[FilledFormsAggregationService] Successfully updated appointment ${filledDocument.appointmentId} after form deletion`,
259
+ );
260
+ } else {
261
+ Logger.info(
262
+ `[FilledFormsAggregationService] No updates needed for appointment ${filledDocument.appointmentId}`,
263
+ );
264
+ }
265
+ } catch (error) {
266
+ Logger.error(
267
+ `[FilledFormsAggregationService] Error updating appointment after form deletion for ${filledDocument.id}:`,
268
+ error,
269
+ );
270
+ throw error;
271
+ }
272
+ }
273
+
274
+ /**
275
+ * Updates the appointment's pendingUserFormsIds for a new required user form.
276
+ * This should be called when a required user form is first created.
277
+ * @param filledDocument The newly created filled document.
278
+ * @returns {Promise<void>}
279
+ */
280
+ async handleRequiredUserFormCreate(filledDocument: FilledDocument): Promise<void> {
281
+ if (!filledDocument.isUserForm || !filledDocument.isRequired) {
282
+ return; // Only process required user forms
283
+ }
284
+
285
+ Logger.info(
286
+ `[FilledFormsAggregationService] Handling new required user form creation: ${filledDocument.id}`,
287
+ );
288
+
289
+ try {
290
+ const appointmentRef = this.db
291
+ .collection(APPOINTMENTS_COLLECTION)
292
+ .doc(filledDocument.appointmentId);
293
+
294
+ // Skip adding to pendingUserFormsIds if already completed/signed
295
+ if (
296
+ filledDocument.status === FilledDocumentStatus.COMPLETED ||
297
+ filledDocument.status === FilledDocumentStatus.SIGNED
298
+ ) {
299
+ Logger.info(
300
+ `[FilledFormsAggregationService] Form ${filledDocument.id} is already completed/signed, not adding to pendingUserFormsIds`,
301
+ );
302
+ return;
303
+ }
304
+
305
+ // Add to pendingUserFormsIds
306
+ await appointmentRef.update({
307
+ pendingUserFormsIds: admin.firestore.FieldValue.arrayUnion(filledDocument.id),
308
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
309
+ });
310
+
311
+ Logger.info(
312
+ `[FilledFormsAggregationService] Successfully added form ${filledDocument.id} to pendingUserFormsIds for appointment ${filledDocument.appointmentId}`,
313
+ );
314
+ } catch (error) {
315
+ Logger.error(
316
+ `[FilledFormsAggregationService] Error handling required user form creation for ${filledDocument.id}:`,
317
+ error,
318
+ );
319
+ throw error;
320
+ }
321
+ }
322
+ }
@@ -1 +1 @@
1
- export * from "./filled-forms.aggregation.service";
1
+ export * from "./filled-forms.aggregation.service";
@@ -1,8 +1,8 @@
1
- export * from "./appointment";
2
- export * from "./clinic";
3
- export * from "./forms";
4
- export * from "./patient";
5
- export * from "./practitioner";
6
- export * from "./practitioner-invite";
7
- export * from "./procedure";
8
- export * from "./reviews";
1
+ export * from "./appointment";
2
+ export * from "./clinic";
3
+ export * from "./forms";
4
+ export * from "./patient";
5
+ export * from "./practitioner";
6
+ export * from "./practitioner-invite";
7
+ export * from "./procedure";
8
+ export * from "./reviews";