@blackcode_sa/metaestetics-api 1.13.5 → 1.13.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (291) hide show
  1. package/dist/admin/index.d.mts +20 -1
  2. package/dist/admin/index.d.ts +20 -1
  3. package/dist/admin/index.js +217 -1
  4. package/dist/admin/index.mjs +217 -1
  5. package/package.json +121 -121
  6. package/src/__mocks__/firstore.ts +10 -10
  7. package/src/admin/aggregation/README.md +79 -79
  8. package/src/admin/aggregation/appointment/README.md +128 -128
  9. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1984 -1984
  10. package/src/admin/aggregation/appointment/index.ts +1 -1
  11. package/src/admin/aggregation/clinic/README.md +52 -52
  12. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +966 -703
  13. package/src/admin/aggregation/clinic/index.ts +1 -1
  14. package/src/admin/aggregation/forms/README.md +13 -13
  15. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  16. package/src/admin/aggregation/forms/index.ts +1 -1
  17. package/src/admin/aggregation/index.ts +8 -8
  18. package/src/admin/aggregation/patient/README.md +27 -27
  19. package/src/admin/aggregation/patient/index.ts +1 -1
  20. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  21. package/src/admin/aggregation/practitioner/README.md +42 -42
  22. package/src/admin/aggregation/practitioner/index.ts +1 -1
  23. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  24. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  25. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  26. package/src/admin/aggregation/procedure/README.md +43 -43
  27. package/src/admin/aggregation/procedure/index.ts +1 -1
  28. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  29. package/src/admin/aggregation/reviews/index.ts +1 -1
  30. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +689 -689
  31. package/src/admin/analytics/analytics.admin.service.ts +278 -278
  32. package/src/admin/analytics/index.ts +2 -2
  33. package/src/admin/booking/README.md +125 -125
  34. package/src/admin/booking/booking.admin.ts +1037 -1037
  35. package/src/admin/booking/booking.calculator.ts +712 -712
  36. package/src/admin/booking/booking.types.ts +59 -59
  37. package/src/admin/booking/index.ts +3 -3
  38. package/src/admin/booking/timezones-problem.md +185 -185
  39. package/src/admin/calendar/README.md +7 -7
  40. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  41. package/src/admin/calendar/index.ts +1 -1
  42. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  43. package/src/admin/documentation-templates/index.ts +1 -1
  44. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  45. package/src/admin/free-consultation/index.ts +1 -1
  46. package/src/admin/index.ts +81 -81
  47. package/src/admin/logger/index.ts +78 -78
  48. package/src/admin/mailing/README.md +95 -95
  49. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  50. package/src/admin/mailing/appointment/index.ts +1 -1
  51. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  52. package/src/admin/mailing/base.mailing.service.ts +208 -208
  53. package/src/admin/mailing/index.ts +3 -3
  54. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  55. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  56. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  57. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  58. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  59. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  60. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  61. package/src/admin/notifications/index.ts +1 -1
  62. package/src/admin/notifications/notifications.admin.ts +710 -710
  63. package/src/admin/requirements/README.md +128 -128
  64. package/src/admin/requirements/index.ts +1 -1
  65. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  66. package/src/admin/users/index.ts +1 -1
  67. package/src/admin/users/user-profile.admin.ts +405 -405
  68. package/src/backoffice/constants/certification.constants.ts +13 -13
  69. package/src/backoffice/constants/index.ts +1 -1
  70. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  71. package/src/backoffice/errors/index.ts +1 -1
  72. package/src/backoffice/expo-safe/README.md +26 -26
  73. package/src/backoffice/expo-safe/index.ts +41 -41
  74. package/src/backoffice/index.ts +5 -5
  75. package/src/backoffice/services/FIXES_README.md +102 -102
  76. package/src/backoffice/services/README.md +57 -57
  77. package/src/backoffice/services/analytics.service.proposal.md +863 -863
  78. package/src/backoffice/services/analytics.service.summary.md +143 -143
  79. package/src/backoffice/services/brand.service.ts +256 -256
  80. package/src/backoffice/services/category.service.ts +384 -384
  81. package/src/backoffice/services/constants.service.ts +385 -385
  82. package/src/backoffice/services/documentation-template.service.ts +202 -202
  83. package/src/backoffice/services/index.ts +10 -10
  84. package/src/backoffice/services/migrate-products.ts +116 -116
  85. package/src/backoffice/services/product.service.ts +553 -553
  86. package/src/backoffice/services/requirement.service.ts +235 -235
  87. package/src/backoffice/services/subcategory.service.ts +461 -461
  88. package/src/backoffice/services/technology.service.ts +1151 -1151
  89. package/src/backoffice/types/README.md +12 -12
  90. package/src/backoffice/types/admin-constants.types.ts +69 -69
  91. package/src/backoffice/types/brand.types.ts +29 -29
  92. package/src/backoffice/types/category.types.ts +67 -67
  93. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  94. package/src/backoffice/types/index.ts +10 -10
  95. package/src/backoffice/types/procedure-product.types.ts +38 -38
  96. package/src/backoffice/types/product.types.ts +240 -240
  97. package/src/backoffice/types/requirement.types.ts +63 -63
  98. package/src/backoffice/types/static/README.md +18 -18
  99. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  100. package/src/backoffice/types/static/certification.types.ts +37 -37
  101. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  102. package/src/backoffice/types/static/index.ts +6 -6
  103. package/src/backoffice/types/static/pricing.types.ts +16 -16
  104. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  105. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  106. package/src/backoffice/types/subcategory.types.ts +34 -34
  107. package/src/backoffice/types/technology.types.ts +168 -168
  108. package/src/backoffice/validations/index.ts +1 -1
  109. package/src/backoffice/validations/schemas.ts +164 -164
  110. package/src/config/__mocks__/firebase.ts +99 -99
  111. package/src/config/firebase.ts +78 -78
  112. package/src/config/index.ts +9 -9
  113. package/src/errors/auth.error.ts +6 -6
  114. package/src/errors/auth.errors.ts +200 -200
  115. package/src/errors/clinic.errors.ts +32 -32
  116. package/src/errors/firebase.errors.ts +47 -47
  117. package/src/errors/user.errors.ts +99 -99
  118. package/src/index.backup.ts +407 -407
  119. package/src/index.ts +6 -6
  120. package/src/locales/en.ts +31 -31
  121. package/src/recommender/admin/index.ts +1 -1
  122. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  123. package/src/recommender/front/index.ts +1 -1
  124. package/src/recommender/front/services/onboarding.service.ts +5 -5
  125. package/src/recommender/front/services/recommender.service.ts +3 -3
  126. package/src/recommender/index.ts +1 -1
  127. package/src/services/PATIENTAUTH.MD +197 -197
  128. package/src/services/README.md +106 -106
  129. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  130. package/src/services/__tests__/auth/auth.setup.ts +293 -293
  131. package/src/services/__tests__/auth.service.test.ts +346 -346
  132. package/src/services/__tests__/base.service.test.ts +77 -77
  133. package/src/services/__tests__/user.service.test.ts +528 -528
  134. package/src/services/analytics/ARCHITECTURE.md +199 -199
  135. package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
  136. package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
  137. package/src/services/analytics/QUICK_START.md +393 -393
  138. package/src/services/analytics/README.md +304 -304
  139. package/src/services/analytics/SUMMARY.md +141 -141
  140. package/src/services/analytics/TRENDS.md +380 -380
  141. package/src/services/analytics/USAGE_GUIDE.md +518 -518
  142. package/src/services/analytics/analytics-cloud.service.ts +222 -222
  143. package/src/services/analytics/analytics.service.ts +2142 -2142
  144. package/src/services/analytics/index.ts +4 -4
  145. package/src/services/analytics/review-analytics.service.ts +941 -941
  146. package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
  147. package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
  148. package/src/services/analytics/utils/grouping.utils.ts +434 -434
  149. package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
  150. package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
  151. package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
  152. package/src/services/appointment/README.md +17 -17
  153. package/src/services/appointment/appointment.service.ts +2558 -2558
  154. package/src/services/appointment/index.ts +1 -1
  155. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  156. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  157. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  158. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  159. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  160. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  161. package/src/services/auth/auth.service.ts +989 -989
  162. package/src/services/auth/auth.v2.service.ts +961 -961
  163. package/src/services/auth/index.ts +7 -7
  164. package/src/services/auth/utils/error.utils.ts +90 -90
  165. package/src/services/auth/utils/firebase.utils.ts +49 -49
  166. package/src/services/auth/utils/index.ts +21 -21
  167. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  168. package/src/services/base.service.ts +41 -41
  169. package/src/services/calendar/calendar.service.ts +1077 -1077
  170. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  171. package/src/services/calendar/calendar.v3.service.ts +313 -313
  172. package/src/services/calendar/externalCalendar.service.ts +178 -178
  173. package/src/services/calendar/index.ts +5 -5
  174. package/src/services/calendar/synced-calendars.service.ts +743 -743
  175. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  176. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  177. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  178. package/src/services/calendar/utils/docs.utils.ts +157 -157
  179. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  180. package/src/services/calendar/utils/index.ts +8 -8
  181. package/src/services/calendar/utils/patient.utils.ts +198 -198
  182. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  183. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  184. package/src/services/clinic/README.md +204 -204
  185. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  186. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  187. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  188. package/src/services/clinic/billing-transactions.service.ts +217 -217
  189. package/src/services/clinic/clinic-admin.service.ts +202 -202
  190. package/src/services/clinic/clinic-group.service.ts +310 -310
  191. package/src/services/clinic/clinic.service.ts +708 -708
  192. package/src/services/clinic/index.ts +5 -5
  193. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  194. package/src/services/clinic/utils/admin.utils.ts +551 -551
  195. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  196. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  197. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  198. package/src/services/clinic/utils/filter.utils.ts +446 -446
  199. package/src/services/clinic/utils/index.ts +11 -11
  200. package/src/services/clinic/utils/photos.utils.ts +188 -188
  201. package/src/services/clinic/utils/search.utils.ts +84 -84
  202. package/src/services/clinic/utils/tag.utils.ts +124 -124
  203. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  204. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  205. package/src/services/documentation-templates/index.ts +2 -2
  206. package/src/services/index.ts +14 -14
  207. package/src/services/media/index.ts +1 -1
  208. package/src/services/media/media.service.ts +418 -418
  209. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  210. package/src/services/notifications/index.ts +1 -1
  211. package/src/services/notifications/notification.service.ts +215 -215
  212. package/src/services/patient/README.md +48 -48
  213. package/src/services/patient/To-Do.md +43 -43
  214. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  215. package/src/services/patient/index.ts +2 -2
  216. package/src/services/patient/patient.service.ts +883 -883
  217. package/src/services/patient/patientRequirements.service.ts +285 -285
  218. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  219. package/src/services/patient/utils/clinic.utils.ts +80 -80
  220. package/src/services/patient/utils/docs.utils.ts +142 -142
  221. package/src/services/patient/utils/index.ts +9 -9
  222. package/src/services/patient/utils/location.utils.ts +126 -126
  223. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  224. package/src/services/patient/utils/medical.utils.ts +458 -458
  225. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  226. package/src/services/patient/utils/profile.utils.ts +510 -510
  227. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  228. package/src/services/patient/utils/token.utils.ts +211 -211
  229. package/src/services/practitioner/README.md +145 -145
  230. package/src/services/practitioner/index.ts +1 -1
  231. package/src/services/practitioner/practitioner.service.ts +1742 -1742
  232. package/src/services/procedure/README.md +163 -163
  233. package/src/services/procedure/index.ts +1 -1
  234. package/src/services/procedure/procedure.service.ts +2200 -2200
  235. package/src/services/reviews/index.ts +1 -1
  236. package/src/services/reviews/reviews.service.ts +734 -734
  237. package/src/services/user/index.ts +1 -1
  238. package/src/services/user/user.service.ts +489 -489
  239. package/src/services/user/user.v2.service.ts +466 -466
  240. package/src/types/analytics/analytics.types.ts +597 -597
  241. package/src/types/analytics/grouped-analytics.types.ts +173 -173
  242. package/src/types/analytics/index.ts +4 -4
  243. package/src/types/analytics/stored-analytics.types.ts +137 -137
  244. package/src/types/appointment/index.ts +480 -480
  245. package/src/types/calendar/index.ts +258 -258
  246. package/src/types/calendar/synced-calendar.types.ts +66 -66
  247. package/src/types/clinic/index.ts +498 -498
  248. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  249. package/src/types/clinic/preferences.types.ts +159 -159
  250. package/src/types/clinic/to-do +3 -3
  251. package/src/types/documentation-templates/index.ts +308 -308
  252. package/src/types/index.ts +47 -47
  253. package/src/types/notifications/README.md +77 -77
  254. package/src/types/notifications/index.ts +286 -286
  255. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  256. package/src/types/patient/allergies.ts +58 -58
  257. package/src/types/patient/index.ts +275 -275
  258. package/src/types/patient/medical-info.types.ts +152 -152
  259. package/src/types/patient/patient-requirements.ts +92 -92
  260. package/src/types/patient/token.types.ts +61 -61
  261. package/src/types/practitioner/index.ts +206 -206
  262. package/src/types/procedure/index.ts +181 -181
  263. package/src/types/profile/index.ts +39 -39
  264. package/src/types/reviews/index.ts +132 -132
  265. package/src/types/tz-lookup.d.ts +4 -4
  266. package/src/types/user/index.ts +38 -38
  267. package/src/utils/TIMESTAMPS.md +176 -176
  268. package/src/utils/TimestampUtils.ts +241 -241
  269. package/src/utils/index.ts +1 -1
  270. package/src/validations/appointment.schema.ts +574 -574
  271. package/src/validations/calendar.schema.ts +225 -225
  272. package/src/validations/clinic.schema.ts +494 -494
  273. package/src/validations/common.schema.ts +25 -25
  274. package/src/validations/documentation-templates/index.ts +1 -1
  275. package/src/validations/documentation-templates/template.schema.ts +220 -220
  276. package/src/validations/documentation-templates.schema.ts +10 -10
  277. package/src/validations/index.ts +20 -20
  278. package/src/validations/media.schema.ts +10 -10
  279. package/src/validations/notification.schema.ts +90 -90
  280. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  281. package/src/validations/patient/medical-info.schema.ts +125 -125
  282. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  283. package/src/validations/patient/token.schema.ts +29 -29
  284. package/src/validations/patient.schema.ts +217 -217
  285. package/src/validations/practitioner.schema.ts +222 -222
  286. package/src/validations/procedure-product.schema.ts +41 -41
  287. package/src/validations/procedure.schema.ts +124 -124
  288. package/src/validations/profile-info.schema.ts +41 -41
  289. package/src/validations/reviews.schema.ts +195 -195
  290. package/src/validations/schemas.ts +104 -104
  291. package/src/validations/shared.schema.ts +78 -78
@@ -1,314 +1,314 @@
1
- import { Firestore, updateDoc, serverTimestamp, doc, getDoc } from 'firebase/firestore';
2
- import {
3
- Appointment,
4
- ExtendedProcedureInfo,
5
- AppointmentProductMetadata,
6
- APPOINTMENTS_COLLECTION,
7
- } from '../../../types/appointment';
8
- import { getAppointmentOrThrow, initializeMetadata } from './zone-management.utils';
9
- import { PROCEDURES_COLLECTION } from '../../../types/procedure';
10
- import {
11
- initializeFormsForExtendedProcedure,
12
- removeFormsForExtendedProcedure,
13
- } from './form-initialization.utils';
14
-
15
- /**
16
- * Aggregates products from a procedure into appointmentProducts
17
- * @param db Firestore instance
18
- * @param procedureId Procedure ID to fetch
19
- * @param existingProducts Current appointment products
20
- * @returns Updated appointment products array
21
- */
22
- async function aggregateProductsFromProcedure(
23
- db: Firestore,
24
- procedureId: string,
25
- existingProducts: AppointmentProductMetadata[],
26
- ): Promise<AppointmentProductMetadata[]> {
27
- const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
28
- const procedureSnap = await getDoc(procedureRef);
29
-
30
- if (!procedureSnap.exists()) {
31
- throw new Error(`Procedure with ID ${procedureId} not found`);
32
- }
33
-
34
- const procedureData = procedureSnap.data();
35
-
36
- // Get procedure products from productsMetadata array
37
- const productsMetadata = procedureData.productsMetadata || [];
38
-
39
- // Map procedure products to AppointmentProductMetadata
40
- // Filter out any entries without products (safety check for product-free procedures like consultations)
41
- const newProducts: AppointmentProductMetadata[] = productsMetadata
42
- .filter((pp: any) => pp && pp.product)
43
- .map((pp: any) => {
44
- // Each item in productsMetadata is a ProcedureProduct with embedded Product
45
- const product = pp.product;
46
-
47
- return {
48
- productId: product.id,
49
- productName: product.name,
50
- brandId: product.brandId,
51
- brandName: product.brandName,
52
- procedureId: procedureId,
53
- price: pp.price, // Price from ProcedureProduct
54
- currency: pp.currency, // Currency from ProcedureProduct
55
- unitOfMeasurement: pp.pricingMeasure, // PricingMeasure from ProcedureProduct
56
- };
57
- });
58
-
59
- // Merge with existing products, avoiding duplicates
60
- const productMap = new Map<string, AppointmentProductMetadata>();
61
-
62
- // Add existing products
63
- existingProducts.forEach(p => {
64
- const key = `${p.productId}-${p.procedureId}`;
65
- productMap.set(key, p);
66
- });
67
-
68
- // Add new products
69
- newProducts.forEach(p => {
70
- const key = `${p.productId}-${p.procedureId}`;
71
- if (!productMap.has(key)) {
72
- productMap.set(key, p);
73
- }
74
- });
75
-
76
- return Array.from(productMap.values());
77
- }
78
-
79
- /**
80
- * Creates ExtendedProcedureInfo from procedure document
81
- * @param db Firestore instance
82
- * @param procedureId Procedure ID
83
- * @returns Extended procedure info
84
- */
85
- async function createExtendedProcedureInfo(
86
- db: Firestore,
87
- procedureId: string,
88
- ): Promise<ExtendedProcedureInfo> {
89
- const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
90
- const procedureSnap = await getDoc(procedureRef);
91
-
92
- if (!procedureSnap.exists()) {
93
- throw new Error(`Procedure with ID ${procedureId} not found`);
94
- }
95
-
96
- const data = procedureSnap.data();
97
-
98
- return {
99
- procedureId: procedureId,
100
- procedureName: data.name,
101
- procedureFamily: data.family, // Use embedded family object
102
- procedureCategoryId: data.category.id, // Access embedded category
103
- procedureCategoryName: data.category.name, // Access embedded category
104
- procedureSubCategoryId: data.subcategory.id, // Access embedded subcategory
105
- procedureSubCategoryName: data.subcategory.name, // Access embedded subcategory
106
- procedureTechnologyId: data.technology.id, // Access embedded technology
107
- procedureTechnologyName: data.technology.name, // Access embedded technology
108
- procedureProducts: (data.productsMetadata || [])
109
- .filter((pp: any) => pp && pp.product) // Safety check for product-free procedures
110
- .map((pp: any) => ({
111
- productId: pp.product.id, // Access embedded product
112
- productName: pp.product.name, // Access embedded product
113
- brandId: pp.product.brandId, // Access embedded product
114
- brandName: pp.product.brandName, // Access embedded product
115
- })),
116
- };
117
- }
118
-
119
- /**
120
- * Adds an extended procedure to an appointment
121
- * Automatically aggregates products into appointmentProducts
122
- * @param db Firestore instance
123
- * @param appointmentId Appointment ID
124
- * @param procedureId Procedure ID to add
125
- * @returns Updated appointment
126
- */
127
- export async function addExtendedProcedureUtil(
128
- db: Firestore,
129
- appointmentId: string,
130
- procedureId: string,
131
- ): Promise<Appointment> {
132
- const appointment = await getAppointmentOrThrow(db, appointmentId);
133
- const metadata = initializeMetadata(appointment);
134
-
135
- // Check if procedure is already added
136
- const existingProcedure = metadata.extendedProcedures?.find(p => p.procedureId === procedureId);
137
- if (existingProcedure) {
138
- throw new Error(`Procedure ${procedureId} is already added to this appointment`);
139
- }
140
-
141
- // Create extended procedure info
142
- const extendedProcedureInfo = await createExtendedProcedureInfo(db, procedureId);
143
-
144
- // Get procedure data for forms and products
145
- const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
146
- const procedureSnap = await getDoc(procedureRef);
147
-
148
- if (!procedureSnap.exists()) {
149
- throw new Error(`Procedure with ID ${procedureId} not found`);
150
- }
151
-
152
- const procedureData = procedureSnap.data();
153
-
154
- // Aggregate products
155
- const updatedProducts = await aggregateProductsFromProcedure(
156
- db,
157
- procedureId,
158
- metadata.appointmentProducts || [],
159
- );
160
-
161
- // Initialize forms for extended procedure
162
- let updatedLinkedFormIds = appointment.linkedFormIds || [];
163
- let updatedLinkedForms = appointment.linkedForms || [];
164
- let updatedPendingUserFormsIds = appointment.pendingUserFormsIds || [];
165
-
166
- if (procedureData.documentationTemplates && procedureData.documentationTemplates.length > 0) {
167
- const formInitResult = await initializeFormsForExtendedProcedure(
168
- db,
169
- appointmentId,
170
- procedureId,
171
- procedureData.documentationTemplates,
172
- appointment.patientId,
173
- appointment.practitionerId,
174
- appointment.clinicBranchId,
175
- );
176
-
177
- // Merge form IDs and info
178
- updatedLinkedFormIds = [...updatedLinkedFormIds, ...formInitResult.allLinkedFormIds];
179
- updatedLinkedForms = [...updatedLinkedForms, ...formInitResult.initializedFormsInfo];
180
- updatedPendingUserFormsIds = [
181
- ...updatedPendingUserFormsIds,
182
- ...formInitResult.pendingUserFormsIds,
183
- ];
184
- }
185
-
186
- // Add extended procedure
187
- const extendedProcedures = [...(metadata.extendedProcedures || []), extendedProcedureInfo];
188
-
189
- // Update appointment
190
- const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
191
- await updateDoc(appointmentRef, {
192
- 'metadata.extendedProcedures': extendedProcedures,
193
- 'metadata.appointmentProducts': updatedProducts,
194
- linkedFormIds: updatedLinkedFormIds,
195
- linkedForms: updatedLinkedForms,
196
- pendingUserFormsIds: updatedPendingUserFormsIds,
197
- updatedAt: serverTimestamp(),
198
- });
199
-
200
- return getAppointmentOrThrow(db, appointmentId);
201
- }
202
-
203
- /**
204
- * Removes an extended procedure from an appointment
205
- * Also removes:
206
- * - Associated products from appointmentProducts
207
- * - Associated products from zonesData (all zones)
208
- * - Associated forms
209
- * @param db Firestore instance
210
- * @param appointmentId Appointment ID
211
- * @param procedureId Procedure ID to remove
212
- * @returns Updated appointment
213
- */
214
- export async function removeExtendedProcedureUtil(
215
- db: Firestore,
216
- appointmentId: string,
217
- procedureId: string,
218
- ): Promise<Appointment> {
219
- const appointment = await getAppointmentOrThrow(db, appointmentId);
220
- const metadata = initializeMetadata(appointment);
221
-
222
- if (!metadata.extendedProcedures || metadata.extendedProcedures.length === 0) {
223
- throw new Error('No extended procedures found for this appointment');
224
- }
225
-
226
- // Find and remove the procedure
227
- const procedureIndex = metadata.extendedProcedures.findIndex(p => p.procedureId === procedureId);
228
- if (procedureIndex === -1) {
229
- throw new Error(`Extended procedure ${procedureId} not found in this appointment`);
230
- }
231
-
232
- // Remove procedure
233
- metadata.extendedProcedures.splice(procedureIndex, 1);
234
-
235
- // Remove products associated with this procedure from appointmentProducts
236
- const updatedProducts = (metadata.appointmentProducts || []).filter(
237
- p => p.procedureId !== procedureId,
238
- );
239
-
240
- // Remove products from zonesData that belong to this procedure
241
- const updatedZonesData = { ...(metadata.zonesData || {}) };
242
- let productsRemovedFromZones = 0;
243
-
244
- Object.keys(updatedZonesData).forEach(zoneId => {
245
- const originalLength = updatedZonesData[zoneId].length;
246
- updatedZonesData[zoneId] = updatedZonesData[zoneId].filter(item => {
247
- // Keep notes and items that don't belong to this procedure
248
- if (item.type === 'note') return true;
249
- if (item.type === 'item' && item.belongingProcedureId !== procedureId) return true;
250
- return false;
251
- });
252
- productsRemovedFromZones += originalLength - updatedZonesData[zoneId].length;
253
- });
254
-
255
- console.log(
256
- `🗑️ [removeExtendedProcedure] Removed ${productsRemovedFromZones} products from zones for procedure ${procedureId}`,
257
- );
258
-
259
- // Remove forms associated with this procedure
260
- const removedFormIds = await removeFormsForExtendedProcedure(db, appointmentId, procedureId);
261
-
262
- // Update appointment form arrays
263
- const updatedLinkedFormIds = (appointment.linkedFormIds || []).filter(
264
- formId => !removedFormIds.includes(formId),
265
- );
266
- const updatedLinkedForms = (appointment.linkedForms || []).filter(
267
- form => !removedFormIds.includes(form.formId),
268
- );
269
- const updatedPendingUserFormsIds = (appointment.pendingUserFormsIds || []).filter(
270
- formId => !removedFormIds.includes(formId),
271
- );
272
-
273
- // Update appointment
274
- const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
275
- await updateDoc(appointmentRef, {
276
- 'metadata.extendedProcedures': metadata.extendedProcedures,
277
- 'metadata.appointmentProducts': updatedProducts,
278
- 'metadata.zonesData': updatedZonesData,
279
- linkedFormIds: updatedLinkedFormIds,
280
- linkedForms: updatedLinkedForms,
281
- pendingUserFormsIds: updatedPendingUserFormsIds,
282
- updatedAt: serverTimestamp(),
283
- });
284
-
285
- return getAppointmentOrThrow(db, appointmentId);
286
- }
287
-
288
- /**
289
- * Gets all extended procedures for an appointment
290
- * @param db Firestore instance
291
- * @param appointmentId Appointment ID
292
- * @returns Array of extended procedures
293
- */
294
- export async function getExtendedProceduresUtil(
295
- db: Firestore,
296
- appointmentId: string,
297
- ): Promise<ExtendedProcedureInfo[]> {
298
- const appointment = await getAppointmentOrThrow(db, appointmentId);
299
- return appointment.metadata?.extendedProcedures || [];
300
- }
301
-
302
- /**
303
- * Gets all aggregated products for an appointment
304
- * @param db Firestore instance
305
- * @param appointmentId Appointment ID
306
- * @returns Array of appointment products
307
- */
308
- export async function getAppointmentProductsUtil(
309
- db: Firestore,
310
- appointmentId: string,
311
- ): Promise<AppointmentProductMetadata[]> {
312
- const appointment = await getAppointmentOrThrow(db, appointmentId);
313
- return appointment.metadata?.appointmentProducts || [];
314
- }
1
+ import { Firestore, updateDoc, serverTimestamp, doc, getDoc } from 'firebase/firestore';
2
+ import {
3
+ Appointment,
4
+ ExtendedProcedureInfo,
5
+ AppointmentProductMetadata,
6
+ APPOINTMENTS_COLLECTION,
7
+ } from '../../../types/appointment';
8
+ import { getAppointmentOrThrow, initializeMetadata } from './zone-management.utils';
9
+ import { PROCEDURES_COLLECTION } from '../../../types/procedure';
10
+ import {
11
+ initializeFormsForExtendedProcedure,
12
+ removeFormsForExtendedProcedure,
13
+ } from './form-initialization.utils';
14
+
15
+ /**
16
+ * Aggregates products from a procedure into appointmentProducts
17
+ * @param db Firestore instance
18
+ * @param procedureId Procedure ID to fetch
19
+ * @param existingProducts Current appointment products
20
+ * @returns Updated appointment products array
21
+ */
22
+ async function aggregateProductsFromProcedure(
23
+ db: Firestore,
24
+ procedureId: string,
25
+ existingProducts: AppointmentProductMetadata[],
26
+ ): Promise<AppointmentProductMetadata[]> {
27
+ const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
28
+ const procedureSnap = await getDoc(procedureRef);
29
+
30
+ if (!procedureSnap.exists()) {
31
+ throw new Error(`Procedure with ID ${procedureId} not found`);
32
+ }
33
+
34
+ const procedureData = procedureSnap.data();
35
+
36
+ // Get procedure products from productsMetadata array
37
+ const productsMetadata = procedureData.productsMetadata || [];
38
+
39
+ // Map procedure products to AppointmentProductMetadata
40
+ // Filter out any entries without products (safety check for product-free procedures like consultations)
41
+ const newProducts: AppointmentProductMetadata[] = productsMetadata
42
+ .filter((pp: any) => pp && pp.product)
43
+ .map((pp: any) => {
44
+ // Each item in productsMetadata is a ProcedureProduct with embedded Product
45
+ const product = pp.product;
46
+
47
+ return {
48
+ productId: product.id,
49
+ productName: product.name,
50
+ brandId: product.brandId,
51
+ brandName: product.brandName,
52
+ procedureId: procedureId,
53
+ price: pp.price, // Price from ProcedureProduct
54
+ currency: pp.currency, // Currency from ProcedureProduct
55
+ unitOfMeasurement: pp.pricingMeasure, // PricingMeasure from ProcedureProduct
56
+ };
57
+ });
58
+
59
+ // Merge with existing products, avoiding duplicates
60
+ const productMap = new Map<string, AppointmentProductMetadata>();
61
+
62
+ // Add existing products
63
+ existingProducts.forEach(p => {
64
+ const key = `${p.productId}-${p.procedureId}`;
65
+ productMap.set(key, p);
66
+ });
67
+
68
+ // Add new products
69
+ newProducts.forEach(p => {
70
+ const key = `${p.productId}-${p.procedureId}`;
71
+ if (!productMap.has(key)) {
72
+ productMap.set(key, p);
73
+ }
74
+ });
75
+
76
+ return Array.from(productMap.values());
77
+ }
78
+
79
+ /**
80
+ * Creates ExtendedProcedureInfo from procedure document
81
+ * @param db Firestore instance
82
+ * @param procedureId Procedure ID
83
+ * @returns Extended procedure info
84
+ */
85
+ async function createExtendedProcedureInfo(
86
+ db: Firestore,
87
+ procedureId: string,
88
+ ): Promise<ExtendedProcedureInfo> {
89
+ const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
90
+ const procedureSnap = await getDoc(procedureRef);
91
+
92
+ if (!procedureSnap.exists()) {
93
+ throw new Error(`Procedure with ID ${procedureId} not found`);
94
+ }
95
+
96
+ const data = procedureSnap.data();
97
+
98
+ return {
99
+ procedureId: procedureId,
100
+ procedureName: data.name,
101
+ procedureFamily: data.family, // Use embedded family object
102
+ procedureCategoryId: data.category.id, // Access embedded category
103
+ procedureCategoryName: data.category.name, // Access embedded category
104
+ procedureSubCategoryId: data.subcategory.id, // Access embedded subcategory
105
+ procedureSubCategoryName: data.subcategory.name, // Access embedded subcategory
106
+ procedureTechnologyId: data.technology.id, // Access embedded technology
107
+ procedureTechnologyName: data.technology.name, // Access embedded technology
108
+ procedureProducts: (data.productsMetadata || [])
109
+ .filter((pp: any) => pp && pp.product) // Safety check for product-free procedures
110
+ .map((pp: any) => ({
111
+ productId: pp.product.id, // Access embedded product
112
+ productName: pp.product.name, // Access embedded product
113
+ brandId: pp.product.brandId, // Access embedded product
114
+ brandName: pp.product.brandName, // Access embedded product
115
+ })),
116
+ };
117
+ }
118
+
119
+ /**
120
+ * Adds an extended procedure to an appointment
121
+ * Automatically aggregates products into appointmentProducts
122
+ * @param db Firestore instance
123
+ * @param appointmentId Appointment ID
124
+ * @param procedureId Procedure ID to add
125
+ * @returns Updated appointment
126
+ */
127
+ export async function addExtendedProcedureUtil(
128
+ db: Firestore,
129
+ appointmentId: string,
130
+ procedureId: string,
131
+ ): Promise<Appointment> {
132
+ const appointment = await getAppointmentOrThrow(db, appointmentId);
133
+ const metadata = initializeMetadata(appointment);
134
+
135
+ // Check if procedure is already added
136
+ const existingProcedure = metadata.extendedProcedures?.find(p => p.procedureId === procedureId);
137
+ if (existingProcedure) {
138
+ throw new Error(`Procedure ${procedureId} is already added to this appointment`);
139
+ }
140
+
141
+ // Create extended procedure info
142
+ const extendedProcedureInfo = await createExtendedProcedureInfo(db, procedureId);
143
+
144
+ // Get procedure data for forms and products
145
+ const procedureRef = doc(db, PROCEDURES_COLLECTION, procedureId);
146
+ const procedureSnap = await getDoc(procedureRef);
147
+
148
+ if (!procedureSnap.exists()) {
149
+ throw new Error(`Procedure with ID ${procedureId} not found`);
150
+ }
151
+
152
+ const procedureData = procedureSnap.data();
153
+
154
+ // Aggregate products
155
+ const updatedProducts = await aggregateProductsFromProcedure(
156
+ db,
157
+ procedureId,
158
+ metadata.appointmentProducts || [],
159
+ );
160
+
161
+ // Initialize forms for extended procedure
162
+ let updatedLinkedFormIds = appointment.linkedFormIds || [];
163
+ let updatedLinkedForms = appointment.linkedForms || [];
164
+ let updatedPendingUserFormsIds = appointment.pendingUserFormsIds || [];
165
+
166
+ if (procedureData.documentationTemplates && procedureData.documentationTemplates.length > 0) {
167
+ const formInitResult = await initializeFormsForExtendedProcedure(
168
+ db,
169
+ appointmentId,
170
+ procedureId,
171
+ procedureData.documentationTemplates,
172
+ appointment.patientId,
173
+ appointment.practitionerId,
174
+ appointment.clinicBranchId,
175
+ );
176
+
177
+ // Merge form IDs and info
178
+ updatedLinkedFormIds = [...updatedLinkedFormIds, ...formInitResult.allLinkedFormIds];
179
+ updatedLinkedForms = [...updatedLinkedForms, ...formInitResult.initializedFormsInfo];
180
+ updatedPendingUserFormsIds = [
181
+ ...updatedPendingUserFormsIds,
182
+ ...formInitResult.pendingUserFormsIds,
183
+ ];
184
+ }
185
+
186
+ // Add extended procedure
187
+ const extendedProcedures = [...(metadata.extendedProcedures || []), extendedProcedureInfo];
188
+
189
+ // Update appointment
190
+ const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
191
+ await updateDoc(appointmentRef, {
192
+ 'metadata.extendedProcedures': extendedProcedures,
193
+ 'metadata.appointmentProducts': updatedProducts,
194
+ linkedFormIds: updatedLinkedFormIds,
195
+ linkedForms: updatedLinkedForms,
196
+ pendingUserFormsIds: updatedPendingUserFormsIds,
197
+ updatedAt: serverTimestamp(),
198
+ });
199
+
200
+ return getAppointmentOrThrow(db, appointmentId);
201
+ }
202
+
203
+ /**
204
+ * Removes an extended procedure from an appointment
205
+ * Also removes:
206
+ * - Associated products from appointmentProducts
207
+ * - Associated products from zonesData (all zones)
208
+ * - Associated forms
209
+ * @param db Firestore instance
210
+ * @param appointmentId Appointment ID
211
+ * @param procedureId Procedure ID to remove
212
+ * @returns Updated appointment
213
+ */
214
+ export async function removeExtendedProcedureUtil(
215
+ db: Firestore,
216
+ appointmentId: string,
217
+ procedureId: string,
218
+ ): Promise<Appointment> {
219
+ const appointment = await getAppointmentOrThrow(db, appointmentId);
220
+ const metadata = initializeMetadata(appointment);
221
+
222
+ if (!metadata.extendedProcedures || metadata.extendedProcedures.length === 0) {
223
+ throw new Error('No extended procedures found for this appointment');
224
+ }
225
+
226
+ // Find and remove the procedure
227
+ const procedureIndex = metadata.extendedProcedures.findIndex(p => p.procedureId === procedureId);
228
+ if (procedureIndex === -1) {
229
+ throw new Error(`Extended procedure ${procedureId} not found in this appointment`);
230
+ }
231
+
232
+ // Remove procedure
233
+ metadata.extendedProcedures.splice(procedureIndex, 1);
234
+
235
+ // Remove products associated with this procedure from appointmentProducts
236
+ const updatedProducts = (metadata.appointmentProducts || []).filter(
237
+ p => p.procedureId !== procedureId,
238
+ );
239
+
240
+ // Remove products from zonesData that belong to this procedure
241
+ const updatedZonesData = { ...(metadata.zonesData || {}) };
242
+ let productsRemovedFromZones = 0;
243
+
244
+ Object.keys(updatedZonesData).forEach(zoneId => {
245
+ const originalLength = updatedZonesData[zoneId].length;
246
+ updatedZonesData[zoneId] = updatedZonesData[zoneId].filter(item => {
247
+ // Keep notes and items that don't belong to this procedure
248
+ if (item.type === 'note') return true;
249
+ if (item.type === 'item' && item.belongingProcedureId !== procedureId) return true;
250
+ return false;
251
+ });
252
+ productsRemovedFromZones += originalLength - updatedZonesData[zoneId].length;
253
+ });
254
+
255
+ console.log(
256
+ `🗑️ [removeExtendedProcedure] Removed ${productsRemovedFromZones} products from zones for procedure ${procedureId}`,
257
+ );
258
+
259
+ // Remove forms associated with this procedure
260
+ const removedFormIds = await removeFormsForExtendedProcedure(db, appointmentId, procedureId);
261
+
262
+ // Update appointment form arrays
263
+ const updatedLinkedFormIds = (appointment.linkedFormIds || []).filter(
264
+ formId => !removedFormIds.includes(formId),
265
+ );
266
+ const updatedLinkedForms = (appointment.linkedForms || []).filter(
267
+ form => !removedFormIds.includes(form.formId),
268
+ );
269
+ const updatedPendingUserFormsIds = (appointment.pendingUserFormsIds || []).filter(
270
+ formId => !removedFormIds.includes(formId),
271
+ );
272
+
273
+ // Update appointment
274
+ const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
275
+ await updateDoc(appointmentRef, {
276
+ 'metadata.extendedProcedures': metadata.extendedProcedures,
277
+ 'metadata.appointmentProducts': updatedProducts,
278
+ 'metadata.zonesData': updatedZonesData,
279
+ linkedFormIds: updatedLinkedFormIds,
280
+ linkedForms: updatedLinkedForms,
281
+ pendingUserFormsIds: updatedPendingUserFormsIds,
282
+ updatedAt: serverTimestamp(),
283
+ });
284
+
285
+ return getAppointmentOrThrow(db, appointmentId);
286
+ }
287
+
288
+ /**
289
+ * Gets all extended procedures for an appointment
290
+ * @param db Firestore instance
291
+ * @param appointmentId Appointment ID
292
+ * @returns Array of extended procedures
293
+ */
294
+ export async function getExtendedProceduresUtil(
295
+ db: Firestore,
296
+ appointmentId: string,
297
+ ): Promise<ExtendedProcedureInfo[]> {
298
+ const appointment = await getAppointmentOrThrow(db, appointmentId);
299
+ return appointment.metadata?.extendedProcedures || [];
300
+ }
301
+
302
+ /**
303
+ * Gets all aggregated products for an appointment
304
+ * @param db Firestore instance
305
+ * @param appointmentId Appointment ID
306
+ * @returns Array of appointment products
307
+ */
308
+ export async function getAppointmentProductsUtil(
309
+ db: Firestore,
310
+ appointmentId: string,
311
+ ): Promise<AppointmentProductMetadata[]> {
312
+ const appointment = await getAppointmentOrThrow(db, appointmentId);
313
+ return appointment.metadata?.appointmentProducts || [];
314
+ }