@blackcode_sa/metaestetics-api 1.12.61 → 1.12.62

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 (269) hide show
  1. package/dist/admin/index.d.mts +2 -0
  2. package/dist/admin/index.d.ts +2 -0
  3. package/dist/admin/index.js +45 -4
  4. package/dist/admin/index.mjs +45 -4
  5. package/dist/index.d.mts +2 -0
  6. package/dist/index.d.ts +2 -0
  7. package/dist/index.js +53 -11
  8. package/dist/index.mjs +53 -11
  9. package/package.json +119 -119
  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 +1844 -1844
  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 +703 -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 -641
  35. package/src/admin/booking/README.md +125 -125
  36. package/src/admin/booking/booking.admin.ts +1037 -1037
  37. package/src/admin/booking/booking.calculator.ts +712 -712
  38. package/src/admin/booking/booking.types.ts +59 -59
  39. package/src/admin/booking/index.ts +3 -3
  40. package/src/admin/booking/timezones-problem.md +185 -185
  41. package/src/admin/calendar/README.md +7 -7
  42. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  43. package/src/admin/calendar/index.ts +1 -1
  44. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  45. package/src/admin/documentation-templates/index.ts +1 -1
  46. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  47. package/src/admin/free-consultation/index.ts +1 -1
  48. package/src/admin/index.ts +75 -75
  49. package/src/admin/logger/index.ts +78 -78
  50. package/src/admin/mailing/README.md +95 -95
  51. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  52. package/src/admin/mailing/appointment/index.ts +1 -1
  53. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  54. package/src/admin/mailing/base.mailing.service.ts +208 -208
  55. package/src/admin/mailing/index.ts +3 -3
  56. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  57. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  58. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  59. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  60. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  61. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  62. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  63. package/src/admin/notifications/index.ts +1 -1
  64. package/src/admin/notifications/notifications.admin.ts +710 -710
  65. package/src/admin/requirements/README.md +128 -128
  66. package/src/admin/requirements/index.ts +1 -1
  67. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  68. package/src/admin/users/index.ts +1 -1
  69. package/src/admin/users/user-profile.admin.ts +405 -405
  70. package/src/backoffice/constants/certification.constants.ts +13 -13
  71. package/src/backoffice/constants/index.ts +1 -1
  72. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  73. package/src/backoffice/errors/index.ts +1 -1
  74. package/src/backoffice/expo-safe/README.md +26 -26
  75. package/src/backoffice/expo-safe/index.ts +41 -41
  76. package/src/backoffice/index.ts +5 -5
  77. package/src/backoffice/services/FIXES_README.md +102 -102
  78. package/src/backoffice/services/README.md +40 -40
  79. package/src/backoffice/services/brand.service.ts +256 -256
  80. package/src/backoffice/services/category.service.ts +318 -318
  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 +8 -8
  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 +395 -395
  88. package/src/backoffice/services/technology.service.ts +1070 -1070
  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 +62 -62
  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 +161 -161
  108. package/src/backoffice/validations/index.ts +1 -1
  109. package/src/backoffice/validations/schemas.ts +163 -163
  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/appointment/README.md +17 -17
  135. package/src/services/appointment/appointment.service.ts +2082 -2082
  136. package/src/services/appointment/index.ts +1 -1
  137. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  138. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  139. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  140. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  141. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  142. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  143. package/src/services/auth/auth.service.ts +989 -989
  144. package/src/services/auth/auth.v2.service.ts +961 -961
  145. package/src/services/auth/index.ts +7 -7
  146. package/src/services/auth/utils/error.utils.ts +90 -90
  147. package/src/services/auth/utils/firebase.utils.ts +49 -49
  148. package/src/services/auth/utils/index.ts +21 -21
  149. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  150. package/src/services/base.service.ts +41 -41
  151. package/src/services/calendar/calendar.service.ts +1077 -1077
  152. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  153. package/src/services/calendar/calendar.v3.service.ts +313 -313
  154. package/src/services/calendar/externalCalendar.service.ts +178 -178
  155. package/src/services/calendar/index.ts +5 -5
  156. package/src/services/calendar/synced-calendars.service.ts +743 -743
  157. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  158. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  159. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  160. package/src/services/calendar/utils/docs.utils.ts +157 -157
  161. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  162. package/src/services/calendar/utils/index.ts +8 -8
  163. package/src/services/calendar/utils/patient.utils.ts +198 -198
  164. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  165. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  166. package/src/services/clinic/README.md +204 -204
  167. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  168. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  169. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  170. package/src/services/clinic/billing-transactions.service.ts +217 -217
  171. package/src/services/clinic/clinic-admin.service.ts +202 -202
  172. package/src/services/clinic/clinic-group.service.ts +310 -310
  173. package/src/services/clinic/clinic.service.ts +708 -708
  174. package/src/services/clinic/index.ts +5 -5
  175. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  176. package/src/services/clinic/utils/admin.utils.ts +551 -551
  177. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  178. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  179. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  180. package/src/services/clinic/utils/filter.utils.ts +446 -446
  181. package/src/services/clinic/utils/index.ts +11 -11
  182. package/src/services/clinic/utils/photos.utils.ts +188 -188
  183. package/src/services/clinic/utils/search.utils.ts +84 -84
  184. package/src/services/clinic/utils/tag.utils.ts +124 -124
  185. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  186. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  187. package/src/services/documentation-templates/index.ts +2 -2
  188. package/src/services/index.ts +13 -13
  189. package/src/services/media/index.ts +1 -1
  190. package/src/services/media/media.service.ts +418 -418
  191. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  192. package/src/services/notifications/index.ts +1 -1
  193. package/src/services/notifications/notification.service.ts +215 -215
  194. package/src/services/patient/README.md +48 -48
  195. package/src/services/patient/To-Do.md +43 -43
  196. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  197. package/src/services/patient/index.ts +2 -2
  198. package/src/services/patient/patient.service.ts +883 -883
  199. package/src/services/patient/patientRequirements.service.ts +285 -285
  200. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  201. package/src/services/patient/utils/clinic.utils.ts +80 -80
  202. package/src/services/patient/utils/docs.utils.ts +142 -142
  203. package/src/services/patient/utils/index.ts +9 -9
  204. package/src/services/patient/utils/location.utils.ts +126 -126
  205. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  206. package/src/services/patient/utils/medical.utils.ts +458 -458
  207. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  208. package/src/services/patient/utils/profile.utils.ts +510 -510
  209. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  210. package/src/services/patient/utils/token.utils.ts +211 -211
  211. package/src/services/practitioner/README.md +145 -145
  212. package/src/services/practitioner/index.ts +1 -1
  213. package/src/services/practitioner/practitioner.service.ts +1742 -1742
  214. package/src/services/procedure/README.md +163 -163
  215. package/src/services/procedure/index.ts +1 -1
  216. package/src/services/procedure/procedure.service.ts +1682 -1682
  217. package/src/services/reviews/index.ts +1 -1
  218. package/src/services/reviews/reviews.service.ts +683 -636
  219. package/src/services/user/index.ts +1 -1
  220. package/src/services/user/user.service.ts +489 -489
  221. package/src/services/user/user.v2.service.ts +466 -466
  222. package/src/types/appointment/index.ts +453 -453
  223. package/src/types/calendar/index.ts +258 -258
  224. package/src/types/calendar/synced-calendar.types.ts +66 -66
  225. package/src/types/clinic/index.ts +489 -489
  226. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  227. package/src/types/clinic/preferences.types.ts +159 -159
  228. package/src/types/clinic/to-do +3 -3
  229. package/src/types/documentation-templates/index.ts +308 -308
  230. package/src/types/index.ts +44 -44
  231. package/src/types/notifications/README.md +77 -77
  232. package/src/types/notifications/index.ts +265 -265
  233. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  234. package/src/types/patient/allergies.ts +58 -58
  235. package/src/types/patient/index.ts +273 -273
  236. package/src/types/patient/medical-info.types.ts +152 -152
  237. package/src/types/patient/patient-requirements.ts +92 -92
  238. package/src/types/patient/token.types.ts +61 -61
  239. package/src/types/practitioner/index.ts +206 -206
  240. package/src/types/procedure/index.ts +181 -181
  241. package/src/types/profile/index.ts +39 -39
  242. package/src/types/reviews/index.ts +132 -130
  243. package/src/types/tz-lookup.d.ts +4 -4
  244. package/src/types/user/index.ts +38 -38
  245. package/src/utils/TIMESTAMPS.md +176 -176
  246. package/src/utils/TimestampUtils.ts +241 -241
  247. package/src/utils/index.ts +1 -1
  248. package/src/validations/appointment.schema.ts +574 -574
  249. package/src/validations/calendar.schema.ts +225 -225
  250. package/src/validations/clinic.schema.ts +493 -493
  251. package/src/validations/common.schema.ts +25 -25
  252. package/src/validations/documentation-templates/index.ts +1 -1
  253. package/src/validations/documentation-templates/template.schema.ts +220 -220
  254. package/src/validations/documentation-templates.schema.ts +10 -10
  255. package/src/validations/index.ts +20 -20
  256. package/src/validations/media.schema.ts +10 -10
  257. package/src/validations/notification.schema.ts +90 -90
  258. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  259. package/src/validations/patient/medical-info.schema.ts +125 -125
  260. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  261. package/src/validations/patient/token.schema.ts +29 -29
  262. package/src/validations/patient.schema.ts +216 -216
  263. package/src/validations/practitioner.schema.ts +222 -222
  264. package/src/validations/procedure-product.schema.ts +41 -41
  265. package/src/validations/procedure.schema.ts +124 -124
  266. package/src/validations/profile-info.schema.ts +41 -41
  267. package/src/validations/reviews.schema.ts +195 -189
  268. package/src/validations/schemas.ts +104 -104
  269. 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";