@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

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