@blackcode_sa/metaestetics-api 1.12.62 → 1.12.64

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