@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.0

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 (326) hide show
  1. package/dist/admin/index.d.mts +377 -222
  2. package/dist/admin/index.d.ts +377 -222
  3. package/dist/admin/index.js +625 -206
  4. package/dist/admin/index.mjs +624 -206
  5. package/dist/backoffice/index.d.mts +24 -0
  6. package/dist/backoffice/index.d.ts +24 -0
  7. package/dist/index.d.mts +292 -4
  8. package/dist/index.d.ts +292 -4
  9. package/dist/index.js +1142 -630
  10. package/dist/index.mjs +1137 -617
  11. package/package.json +2 -1
  12. package/src/__mocks__/firstore.ts +10 -10
  13. package/src/admin/aggregation/README.md +79 -79
  14. package/src/admin/aggregation/appointment/README.md +151 -129
  15. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +2137 -2091
  16. package/src/admin/aggregation/appointment/index.ts +1 -1
  17. package/src/admin/aggregation/clinic/README.md +52 -52
  18. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +966 -966
  19. package/src/admin/aggregation/clinic/index.ts +1 -1
  20. package/src/admin/aggregation/forms/README.md +13 -13
  21. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  22. package/src/admin/aggregation/forms/index.ts +1 -1
  23. package/src/admin/aggregation/index.ts +8 -8
  24. package/src/admin/aggregation/patient/README.md +27 -27
  25. package/src/admin/aggregation/patient/index.ts +1 -1
  26. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  27. package/src/admin/aggregation/practitioner/README.md +42 -42
  28. package/src/admin/aggregation/practitioner/index.ts +1 -1
  29. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  30. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  31. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  32. package/src/admin/aggregation/procedure/README.md +43 -43
  33. package/src/admin/aggregation/procedure/index.ts +1 -1
  34. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  35. package/src/admin/aggregation/reviews/index.ts +1 -1
  36. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +689 -689
  37. package/src/admin/analytics/analytics.admin.service.ts +278 -278
  38. package/src/admin/analytics/index.ts +2 -2
  39. package/src/admin/booking/README.md +184 -125
  40. package/src/admin/booking/booking.admin.ts +1330 -1073
  41. package/src/admin/booking/booking.calculator.ts +850 -712
  42. package/src/admin/booking/booking.types.ts +76 -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 +62 -7
  46. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  47. package/src/admin/calendar/index.ts +2 -1
  48. package/src/admin/calendar/resource-calendar.admin.ts +198 -0
  49. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  50. package/src/admin/documentation-templates/index.ts +1 -1
  51. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  52. package/src/admin/free-consultation/index.ts +1 -1
  53. package/src/admin/index.ts +83 -83
  54. package/src/admin/logger/index.ts +78 -78
  55. package/src/admin/mailing/README.md +139 -139
  56. package/src/admin/mailing/appointment/appointment.mailing.service.ts +1253 -1253
  57. package/src/admin/mailing/appointment/index.ts +1 -1
  58. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  59. package/src/admin/mailing/base.mailing.service.ts +208 -208
  60. package/src/admin/mailing/clinicWelcome/clinicWelcome.mailing.ts +292 -292
  61. package/src/admin/mailing/clinicWelcome/index.ts +1 -1
  62. package/src/admin/mailing/clinicWelcome/templates/welcome.template.ts +225 -225
  63. package/src/admin/mailing/index.ts +5 -5
  64. package/src/admin/mailing/patientInvite/index.ts +2 -2
  65. package/src/admin/mailing/patientInvite/patientInvite.mailing.ts +415 -415
  66. package/src/admin/mailing/patientInvite/templates/invitation.template.ts +105 -105
  67. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  68. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  69. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  70. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  71. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  72. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  73. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  74. package/src/admin/notifications/index.ts +1 -1
  75. package/src/admin/notifications/notifications.admin.ts +818 -818
  76. package/src/admin/requirements/README.md +128 -128
  77. package/src/admin/requirements/index.ts +1 -1
  78. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  79. package/src/admin/users/index.ts +1 -1
  80. package/src/admin/users/user-profile.admin.ts +405 -405
  81. package/src/backoffice/constants/certification.constants.ts +13 -13
  82. package/src/backoffice/constants/index.ts +1 -1
  83. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  84. package/src/backoffice/errors/index.ts +1 -1
  85. package/src/backoffice/expo-safe/README.md +26 -26
  86. package/src/backoffice/expo-safe/index.ts +41 -41
  87. package/src/backoffice/index.ts +5 -5
  88. package/src/backoffice/services/FIXES_README.md +102 -102
  89. package/src/backoffice/services/README.md +57 -57
  90. package/src/backoffice/services/analytics.service.proposal.md +863 -863
  91. package/src/backoffice/services/analytics.service.summary.md +143 -143
  92. package/src/backoffice/services/brand.service.ts +260 -260
  93. package/src/backoffice/services/category.service.ts +384 -384
  94. package/src/backoffice/services/constants.service.ts +385 -385
  95. package/src/backoffice/services/documentation-template.service.ts +202 -202
  96. package/src/backoffice/services/index.ts +10 -10
  97. package/src/backoffice/services/migrate-products.ts +116 -116
  98. package/src/backoffice/services/product.service.ts +557 -557
  99. package/src/backoffice/services/requirement.service.ts +235 -235
  100. package/src/backoffice/services/subcategory.service.ts +461 -461
  101. package/src/backoffice/services/technology.service.ts +1153 -1153
  102. package/src/backoffice/types/README.md +12 -12
  103. package/src/backoffice/types/admin-constants.types.ts +69 -69
  104. package/src/backoffice/types/brand.types.ts +29 -29
  105. package/src/backoffice/types/category.types.ts +67 -67
  106. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  107. package/src/backoffice/types/index.ts +10 -10
  108. package/src/backoffice/types/procedure-product.types.ts +38 -38
  109. package/src/backoffice/types/product.types.ts +239 -239
  110. package/src/backoffice/types/requirement.types.ts +63 -63
  111. package/src/backoffice/types/static/README.md +18 -18
  112. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  113. package/src/backoffice/types/static/certification.types.ts +37 -37
  114. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  115. package/src/backoffice/types/static/index.ts +6 -6
  116. package/src/backoffice/types/static/pricing.types.ts +16 -16
  117. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  118. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  119. package/src/backoffice/types/subcategory.types.ts +34 -34
  120. package/src/backoffice/types/technology.types.ts +168 -168
  121. package/src/backoffice/validations/index.ts +1 -1
  122. package/src/backoffice/validations/schemas.ts +164 -164
  123. package/src/config/__mocks__/firebase.ts +99 -99
  124. package/src/config/firebase.ts +78 -78
  125. package/src/config/index.ts +17 -17
  126. package/src/config/tiers.config.ts +255 -229
  127. package/src/errors/auth.error.ts +6 -6
  128. package/src/errors/auth.errors.ts +211 -211
  129. package/src/errors/clinic.errors.ts +32 -32
  130. package/src/errors/firebase.errors.ts +47 -47
  131. package/src/errors/user.errors.ts +99 -99
  132. package/src/index.backup.ts +407 -407
  133. package/src/index.ts +6 -6
  134. package/src/locales/en.ts +31 -31
  135. package/src/recommender/admin/index.ts +1 -1
  136. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  137. package/src/recommender/front/index.ts +1 -1
  138. package/src/recommender/front/services/onboarding.service.ts +5 -5
  139. package/src/recommender/front/services/recommender.service.ts +3 -3
  140. package/src/recommender/index.ts +1 -1
  141. package/src/services/PATIENTAUTH.MD +197 -197
  142. package/src/services/README.md +106 -106
  143. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  144. package/src/services/__tests__/auth/auth.setup.ts +298 -298
  145. package/src/services/__tests__/auth.service.test.ts +310 -310
  146. package/src/services/__tests__/base.service.test.ts +36 -36
  147. package/src/services/__tests__/user.service.test.ts +530 -530
  148. package/src/services/analytics/ARCHITECTURE.md +199 -199
  149. package/src/services/analytics/CLOUD_FUNCTIONS.md +225 -225
  150. package/src/services/analytics/GROUPED_ANALYTICS.md +501 -501
  151. package/src/services/analytics/QUICK_START.md +393 -393
  152. package/src/services/analytics/README.md +304 -304
  153. package/src/services/analytics/SUMMARY.md +141 -141
  154. package/src/services/analytics/TRENDS.md +380 -380
  155. package/src/services/analytics/USAGE_GUIDE.md +518 -518
  156. package/src/services/analytics/analytics-cloud.service.ts +222 -222
  157. package/src/services/analytics/analytics.service.ts +2148 -2148
  158. package/src/services/analytics/index.ts +4 -4
  159. package/src/services/analytics/review-analytics.service.ts +941 -941
  160. package/src/services/analytics/utils/appointment-filtering.utils.ts +138 -138
  161. package/src/services/analytics/utils/cost-calculation.utils.ts +182 -182
  162. package/src/services/analytics/utils/grouping.utils.ts +434 -434
  163. package/src/services/analytics/utils/stored-analytics.utils.ts +347 -347
  164. package/src/services/analytics/utils/time-calculation.utils.ts +186 -186
  165. package/src/services/analytics/utils/trend-calculation.utils.ts +200 -200
  166. package/src/services/appointment/README.md +17 -17
  167. package/src/services/appointment/appointment.service.ts +2943 -2941
  168. package/src/services/appointment/index.ts +1 -1
  169. package/src/services/appointment/utils/appointment.utils.ts +620 -620
  170. package/src/services/appointment/utils/extended-procedure.utils.ts +354 -354
  171. package/src/services/appointment/utils/form-initialization.utils.ts +516 -516
  172. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  173. package/src/services/appointment/utils/zone-management.utils.ts +468 -468
  174. package/src/services/appointment/utils/zone-photo.utils.ts +302 -302
  175. package/src/services/auth/auth.service.ts +1435 -1435
  176. package/src/services/auth/auth.v2.service.ts +961 -961
  177. package/src/services/auth/index.ts +7 -7
  178. package/src/services/auth/utils/error.utils.ts +90 -90
  179. package/src/services/auth/utils/firebase.utils.ts +49 -49
  180. package/src/services/auth/utils/index.ts +21 -21
  181. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  182. package/src/services/base.service.ts +41 -41
  183. package/src/services/calendar/calendar.service.ts +1077 -1077
  184. package/src/services/calendar/calendar.v2.service.ts +1693 -1693
  185. package/src/services/calendar/calendar.v3.service.ts +313 -313
  186. package/src/services/calendar/externalCalendar.service.ts +178 -178
  187. package/src/services/calendar/index.ts +5 -5
  188. package/src/services/calendar/synced-calendars.service.ts +743 -743
  189. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  190. package/src/services/calendar/utils/calendar-event.utils.ts +676 -676
  191. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  192. package/src/services/calendar/utils/docs.utils.ts +157 -157
  193. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  194. package/src/services/calendar/utils/index.ts +8 -8
  195. package/src/services/calendar/utils/patient.utils.ts +198 -198
  196. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  197. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  198. package/src/services/clinic/README.md +204 -204
  199. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +265 -265
  200. package/src/services/clinic/__tests__/clinic-group.service.test.ts +222 -222
  201. package/src/services/clinic/__tests__/clinic.service.test.ts +302 -302
  202. package/src/services/clinic/billing-transactions.service.ts +217 -217
  203. package/src/services/clinic/clinic-admin.service.ts +202 -202
  204. package/src/services/clinic/clinic-group.service.ts +310 -310
  205. package/src/services/clinic/clinic.service.ts +720 -720
  206. package/src/services/clinic/index.ts +5 -5
  207. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  208. package/src/services/clinic/utils/admin.utils.ts +551 -551
  209. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  210. package/src/services/clinic/utils/clinic.utils.ts +1023 -1023
  211. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  212. package/src/services/clinic/utils/filter.utils.ts +462 -462
  213. package/src/services/clinic/utils/index.ts +10 -10
  214. package/src/services/clinic/utils/photos.utils.ts +188 -188
  215. package/src/services/clinic/utils/search.utils.ts +83 -83
  216. package/src/services/clinic/utils/tag.utils.ts +124 -124
  217. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  218. package/src/services/documentation-templates/filled-document.service.ts +597 -597
  219. package/src/services/documentation-templates/index.ts +2 -2
  220. package/src/services/index.ts +16 -15
  221. package/src/services/media/index.ts +1 -1
  222. package/src/services/media/media.service.ts +418 -418
  223. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  224. package/src/services/notifications/index.ts +1 -1
  225. package/src/services/notifications/notification.service.ts +215 -215
  226. package/src/services/patient/README.md +48 -48
  227. package/src/services/patient/To-Do.md +43 -43
  228. package/src/services/patient/__tests__/patient.service.test.ts +286 -286
  229. package/src/services/patient/index.ts +2 -2
  230. package/src/services/patient/patient.service.ts +1021 -1021
  231. package/src/services/patient/patientRequirements.service.ts +309 -309
  232. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  233. package/src/services/patient/utils/body-assessment.utils.ts +159 -159
  234. package/src/services/patient/utils/clinic.utils.ts +159 -159
  235. package/src/services/patient/utils/docs.utils.ts +142 -142
  236. package/src/services/patient/utils/hair-scalp-assessment.utils.ts +158 -158
  237. package/src/services/patient/utils/index.ts +9 -9
  238. package/src/services/patient/utils/location.utils.ts +126 -126
  239. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  240. package/src/services/patient/utils/medical.utils.ts +458 -458
  241. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  242. package/src/services/patient/utils/pre-surgical-assessment.utils.ts +161 -161
  243. package/src/services/patient/utils/profile.utils.ts +510 -510
  244. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  245. package/src/services/patient/utils/skin-quality-assessment.utils.ts +160 -160
  246. package/src/services/patient/utils/token.utils.ts +211 -211
  247. package/src/services/practitioner/README.md +145 -145
  248. package/src/services/practitioner/index.ts +1 -1
  249. package/src/services/practitioner/practitioner.service.ts +2355 -2354
  250. package/src/services/procedure/README.md +163 -163
  251. package/src/services/procedure/index.ts +1 -1
  252. package/src/services/procedure/procedure.service.ts +2521 -2521
  253. package/src/services/resource/README.md +119 -0
  254. package/src/services/resource/index.ts +1 -0
  255. package/src/services/resource/resource.service.ts +555 -0
  256. package/src/services/reviews/index.ts +1 -1
  257. package/src/services/reviews/reviews.service.ts +745 -745
  258. package/src/services/tier-enforcement.ts +240 -240
  259. package/src/services/user/index.ts +1 -1
  260. package/src/services/user/user.service.ts +533 -533
  261. package/src/services/user/user.v2.service.ts +467 -467
  262. package/src/types/analytics/analytics.types.ts +597 -597
  263. package/src/types/analytics/grouped-analytics.types.ts +173 -173
  264. package/src/types/analytics/index.ts +4 -4
  265. package/src/types/analytics/stored-analytics.types.ts +137 -137
  266. package/src/types/appointment/index.ts +524 -517
  267. package/src/types/calendar/index.ts +261 -260
  268. package/src/types/calendar/synced-calendar.types.ts +66 -66
  269. package/src/types/clinic/index.ts +530 -529
  270. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  271. package/src/types/clinic/preferences.types.ts +159 -159
  272. package/src/types/clinic/rbac.types.ts +64 -63
  273. package/src/types/clinic/to-do +3 -3
  274. package/src/types/documentation-templates/index.ts +308 -308
  275. package/src/types/index.ts +50 -47
  276. package/src/types/notifications/README.md +77 -77
  277. package/src/types/notifications/index.ts +300 -300
  278. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  279. package/src/types/patient/allergies.ts +58 -58
  280. package/src/types/patient/body-assessment.types.ts +93 -93
  281. package/src/types/patient/hair-scalp-assessment.types.ts +98 -98
  282. package/src/types/patient/index.ts +279 -279
  283. package/src/types/patient/medical-info.types.ts +152 -152
  284. package/src/types/patient/patient-requirements.ts +92 -92
  285. package/src/types/patient/pre-surgical-assessment.types.ts +95 -95
  286. package/src/types/patient/skin-quality-assessment.types.ts +105 -105
  287. package/src/types/patient/token.types.ts +61 -61
  288. package/src/types/practitioner/index.ts +208 -208
  289. package/src/types/procedure/index.ts +189 -183
  290. package/src/types/profile/index.ts +39 -39
  291. package/src/types/resource/README.md +153 -0
  292. package/src/types/resource/index.ts +199 -0
  293. package/src/types/reviews/index.ts +132 -132
  294. package/src/types/tz-lookup.d.ts +4 -4
  295. package/src/types/user/index.ts +60 -60
  296. package/src/utils/TIMESTAMPS.md +176 -176
  297. package/src/utils/TimestampUtils.ts +241 -241
  298. package/src/utils/index.ts +1 -1
  299. package/src/validations/README.md +94 -0
  300. package/src/validations/appointment.schema.ts +589 -589
  301. package/src/validations/calendar.schema.ts +225 -225
  302. package/src/validations/clinic.schema.ts +494 -494
  303. package/src/validations/common.schema.ts +25 -25
  304. package/src/validations/documentation-templates/index.ts +1 -1
  305. package/src/validations/documentation-templates/template.schema.ts +220 -220
  306. package/src/validations/documentation-templates.schema.ts +10 -10
  307. package/src/validations/index.ts +21 -20
  308. package/src/validations/media.schema.ts +10 -10
  309. package/src/validations/notification.schema.ts +90 -90
  310. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  311. package/src/validations/patient/body-assessment.schema.ts +82 -82
  312. package/src/validations/patient/hair-scalp-assessment.schema.ts +70 -70
  313. package/src/validations/patient/medical-info.schema.ts +177 -177
  314. package/src/validations/patient/patient-requirements.schema.ts +84 -84
  315. package/src/validations/patient/pre-surgical-assessment.schema.ts +78 -78
  316. package/src/validations/patient/skin-quality-assessment.schema.ts +70 -70
  317. package/src/validations/patient/token.schema.ts +29 -29
  318. package/src/validations/patient.schema.ts +217 -217
  319. package/src/validations/practitioner.schema.ts +224 -224
  320. package/src/validations/procedure-product.schema.ts +41 -41
  321. package/src/validations/procedure.schema.ts +136 -124
  322. package/src/validations/profile-info.schema.ts +41 -41
  323. package/src/validations/resource.schema.ts +57 -0
  324. package/src/validations/reviews.schema.ts +195 -195
  325. package/src/validations/schemas.ts +109 -109
  326. package/src/validations/shared.schema.ts +78 -78
@@ -1,260 +1,260 @@
1
- import { getDoc, updateDoc, setDoc, serverTimestamp, Firestore } from 'firebase/firestore';
2
- import {
3
- PatientSensitiveInfo,
4
- CreatePatientSensitiveInfoData,
5
- UpdatePatientSensitiveInfoData,
6
- } from '../../../types/patient';
7
- import { UserRole } from '../../../types';
8
- import { createPatientSensitiveInfoSchema } from '../../../validations/patient.schema';
9
- import { z } from 'zod';
10
- import {
11
- getSensitiveInfoDocRef,
12
- initSensitiveInfoDocIfNotExists,
13
- getPatientDocRef,
14
- } from './docs.utils';
15
- import { MediaService, MediaAccessLevel, MediaResource } from '../../media/media.service';
16
- import { AuthError } from '../../../errors/auth.errors';
17
- import { getPractitionerProfileByUserRef } from './practitioner.utils';
18
- import { getClinicAdminByUserRef } from '../../clinic/utils/admin.utils';
19
-
20
- /**
21
- * Checks if the requester has permission to access/modify sensitive info.
22
- * Access is granted to the patient owner, or an associated practitioner/clinic admin.
23
- */
24
- const checkSensitiveAccessUtil = async (
25
- db: Firestore,
26
- patientId: string,
27
- requesterId: string,
28
- requesterRoles: UserRole[],
29
- ): Promise<void> => {
30
- const patientDoc = await getDoc(getPatientDocRef(db, patientId));
31
- if (!patientDoc.exists()) {
32
- throw new Error('Patient profile not found');
33
- }
34
- const patientData = patientDoc.data() as any; // Cast to any to access properties
35
-
36
- // 1. Patient is the owner
37
- if (patientData.userRef && patientData.userRef === requesterId) {
38
- return;
39
- }
40
-
41
- // 2. Requester is an associated practitioner
42
- if (requesterRoles.includes(UserRole.PRACTITIONER)) {
43
- const practitionerProfile = await getPractitionerProfileByUserRef(db, requesterId);
44
- if (practitionerProfile && patientData.doctorIds?.includes(practitionerProfile.id)) {
45
- return;
46
- }
47
- }
48
-
49
- // 3. Requester is an associated clinic admin
50
- if (requesterRoles.includes(UserRole.CLINIC_ADMIN)) {
51
- const adminProfile = await getClinicAdminByUserRef(db, requesterId);
52
- if (adminProfile && adminProfile.clinicsManaged) {
53
- const hasAccess = adminProfile.clinicsManaged.some(managedClinicId =>
54
- patientData.clinicIds?.includes(managedClinicId),
55
- );
56
- if (hasAccess) {
57
- return;
58
- }
59
- }
60
- }
61
-
62
- throw new AuthError(
63
- 'Unauthorized access to sensitive information.',
64
- 'AUTH/UNAUTHORIZED_ACCESS',
65
- 403,
66
- );
67
- };
68
-
69
- /**
70
- * Handles photoUrl upload for sensitive info (supports MediaResource)
71
- * @param photoUrl - MediaResource (File, Blob, or URL string)
72
- * @param patientId - ID of the patient
73
- * @param mediaService - MediaService instance
74
- * @returns URL string of the uploaded or existing photo
75
- */
76
- const handlePhotoUrlUpload = async (
77
- photoUrl: MediaResource | undefined | null,
78
- patientId: string,
79
- mediaService: MediaService,
80
- ): Promise<string | null> => {
81
- if (!photoUrl) {
82
- return null;
83
- }
84
-
85
- // If it's already a URL string, return it as is
86
- if (typeof photoUrl === 'string') {
87
- return photoUrl;
88
- }
89
-
90
- // If it's a File or Blob, upload it
91
- if (photoUrl instanceof File || photoUrl instanceof Blob) {
92
- const mediaMetadata = await mediaService.uploadMedia(
93
- photoUrl,
94
- patientId, // Using patientId as ownerId
95
- MediaAccessLevel.PRIVATE, // Sensitive info should be private
96
- 'patient_sensitive_photos',
97
- photoUrl instanceof File ? photoUrl.name : `sensitive_photo_${patientId}`,
98
- );
99
- return mediaMetadata.url;
100
- }
101
-
102
- return null;
103
- };
104
-
105
- // Funkcije za rad sa osetljivim informacijama
106
- export const createSensitiveInfoUtil = async (
107
- db: Firestore,
108
- data: CreatePatientSensitiveInfoData,
109
- requesterId: string,
110
- requesterRoles: UserRole[],
111
- mediaService?: MediaService,
112
- ): Promise<PatientSensitiveInfo> => {
113
- try {
114
- // Security check
115
- await checkSensitiveAccessUtil(db, data.patientId, requesterId, requesterRoles);
116
-
117
- const validatedData = createPatientSensitiveInfoSchema.parse(data);
118
-
119
- // Proveriti da li dokument već postoji
120
- const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, data.patientId));
121
- if (sensitiveDoc.exists()) {
122
- throw new Error('Sensitive information already exists for this patient');
123
- }
124
-
125
- // Process photoUrl if it's a MediaResource and mediaService is provided
126
- let processedPhotoUrl: string | null = null;
127
- if (validatedData.photoUrl && mediaService) {
128
- processedPhotoUrl = await handlePhotoUrlUpload(
129
- validatedData.photoUrl,
130
- data.patientId,
131
- mediaService,
132
- );
133
- } else if (typeof validatedData.photoUrl === 'string') {
134
- processedPhotoUrl = validatedData.photoUrl;
135
- }
136
-
137
- const sensitiveInfoData = {
138
- ...validatedData,
139
- photoUrl: processedPhotoUrl,
140
- createdAt: serverTimestamp(),
141
- updatedAt: serverTimestamp(),
142
- };
143
-
144
- await setDoc(getSensitiveInfoDocRef(db, data.patientId), sensitiveInfoData);
145
-
146
- const createdDoc = await getDoc(getSensitiveInfoDocRef(db, data.patientId));
147
- if (!createdDoc.exists()) {
148
- throw new Error('Failed to create sensitive information');
149
- }
150
-
151
- return createdDoc.data() as PatientSensitiveInfo;
152
- } catch (error) {
153
- if (error instanceof z.ZodError) {
154
- throw new Error('Invalid sensitive info data: ' + error.message);
155
- }
156
- throw error;
157
- }
158
- };
159
-
160
- export const getSensitiveInfoUtil = async (
161
- db: Firestore,
162
- patientId: string,
163
- requesterId: string,
164
- requesterRoles: UserRole[],
165
- ): Promise<PatientSensitiveInfo | null> => {
166
- // Security check
167
- await checkSensitiveAccessUtil(db, patientId, requesterId, requesterRoles);
168
-
169
- // Inicijalizacija dokumenta ako ne postoji
170
- await initSensitiveInfoDocIfNotExists(db, patientId, requesterId);
171
-
172
- const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
173
- return sensitiveDoc.exists() ? (sensitiveDoc.data() as PatientSensitiveInfo) : null;
174
- };
175
-
176
- export const updateSensitiveInfoUtil = async (
177
- db: Firestore,
178
- patientId: string,
179
- data: UpdatePatientSensitiveInfoData,
180
- requesterId: string,
181
- requesterRoles: UserRole[],
182
- mediaService?: MediaService,
183
- ): Promise<PatientSensitiveInfo> => {
184
- // Security check
185
- await checkSensitiveAccessUtil(db, patientId, requesterId, requesterRoles);
186
-
187
- // Inicijalizacija dokumenta ako ne postoji
188
- await initSensitiveInfoDocIfNotExists(db, patientId, requesterId);
189
-
190
- // Process photoUrl if it's a MediaResource and mediaService is provided
191
- let processedPhotoUrl: string | null | undefined = undefined;
192
- if (data.photoUrl !== undefined) {
193
- if (mediaService) {
194
- processedPhotoUrl = await handlePhotoUrlUpload(data.photoUrl, patientId, mediaService);
195
- } else if (typeof data.photoUrl === 'string' || data.photoUrl === null) {
196
- processedPhotoUrl = data.photoUrl;
197
- } else {
198
- // If photoUrl is a File/Blob but no mediaService provided, throw error
199
- throw new Error('MediaService required to process photo upload');
200
- }
201
- }
202
-
203
- const updateData = {
204
- ...data,
205
- photoUrl: processedPhotoUrl,
206
- updatedAt: serverTimestamp(),
207
- };
208
-
209
- await updateDoc(getSensitiveInfoDocRef(db, patientId), updateData);
210
-
211
- const updatedDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
212
- if (!updatedDoc.exists()) {
213
- throw new Error('Failed to retrieve updated sensitive information');
214
- }
215
-
216
- return updatedDoc.data() as PatientSensitiveInfo;
217
- };
218
-
219
- export const claimPatientSensitiveInfoUtil = async (
220
- db: Firestore,
221
- patientId: string,
222
- userId: string,
223
- ): Promise<PatientSensitiveInfo> => {
224
- const patientDoc = await getDoc(getPatientDocRef(db, patientId));
225
- if (!patientDoc.exists()) {
226
- throw new Error('Patient profile not found');
227
- }
228
-
229
- const patientData = patientDoc.data() as any;
230
-
231
- if (!patientData.isManual) {
232
- throw new Error('Only manually created patient profiles can be claimed');
233
- }
234
-
235
- if (patientData.userRef) {
236
- throw new Error('Patient profile has already been claimed');
237
- }
238
-
239
- const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
240
- if (!sensitiveDoc.exists()) {
241
- throw new Error('Patient sensitive information not found');
242
- }
243
-
244
- const sensitiveData = sensitiveDoc.data() as PatientSensitiveInfo;
245
- if (sensitiveData.userRef) {
246
- throw new Error('Patient sensitive information has already been claimed');
247
- }
248
-
249
- await updateDoc(getSensitiveInfoDocRef(db, patientId), {
250
- userRef: userId,
251
- updatedAt: serverTimestamp(),
252
- });
253
-
254
- const updatedDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
255
- if (!updatedDoc.exists()) {
256
- throw new Error('Failed to retrieve updated sensitive information');
257
- }
258
-
259
- return updatedDoc.data() as PatientSensitiveInfo;
260
- };
1
+ import { getDoc, updateDoc, setDoc, serverTimestamp, Firestore } from 'firebase/firestore';
2
+ import {
3
+ PatientSensitiveInfo,
4
+ CreatePatientSensitiveInfoData,
5
+ UpdatePatientSensitiveInfoData,
6
+ } from '../../../types/patient';
7
+ import { UserRole } from '../../../types';
8
+ import { createPatientSensitiveInfoSchema } from '../../../validations/patient.schema';
9
+ import { z } from 'zod';
10
+ import {
11
+ getSensitiveInfoDocRef,
12
+ initSensitiveInfoDocIfNotExists,
13
+ getPatientDocRef,
14
+ } from './docs.utils';
15
+ import { MediaService, MediaAccessLevel, MediaResource } from '../../media/media.service';
16
+ import { AuthError } from '../../../errors/auth.errors';
17
+ import { getPractitionerProfileByUserRef } from './practitioner.utils';
18
+ import { getClinicAdminByUserRef } from '../../clinic/utils/admin.utils';
19
+
20
+ /**
21
+ * Checks if the requester has permission to access/modify sensitive info.
22
+ * Access is granted to the patient owner, or an associated practitioner/clinic admin.
23
+ */
24
+ const checkSensitiveAccessUtil = async (
25
+ db: Firestore,
26
+ patientId: string,
27
+ requesterId: string,
28
+ requesterRoles: UserRole[],
29
+ ): Promise<void> => {
30
+ const patientDoc = await getDoc(getPatientDocRef(db, patientId));
31
+ if (!patientDoc.exists()) {
32
+ throw new Error('Patient profile not found');
33
+ }
34
+ const patientData = patientDoc.data() as any; // Cast to any to access properties
35
+
36
+ // 1. Patient is the owner
37
+ if (patientData.userRef && patientData.userRef === requesterId) {
38
+ return;
39
+ }
40
+
41
+ // 2. Requester is an associated practitioner
42
+ if (requesterRoles.includes(UserRole.PRACTITIONER)) {
43
+ const practitionerProfile = await getPractitionerProfileByUserRef(db, requesterId);
44
+ if (practitionerProfile && patientData.doctorIds?.includes(practitionerProfile.id)) {
45
+ return;
46
+ }
47
+ }
48
+
49
+ // 3. Requester is an associated clinic admin
50
+ if (requesterRoles.includes(UserRole.CLINIC_ADMIN)) {
51
+ const adminProfile = await getClinicAdminByUserRef(db, requesterId);
52
+ if (adminProfile && adminProfile.clinicsManaged) {
53
+ const hasAccess = adminProfile.clinicsManaged.some(managedClinicId =>
54
+ patientData.clinicIds?.includes(managedClinicId),
55
+ );
56
+ if (hasAccess) {
57
+ return;
58
+ }
59
+ }
60
+ }
61
+
62
+ throw new AuthError(
63
+ 'Unauthorized access to sensitive information.',
64
+ 'AUTH/UNAUTHORIZED_ACCESS',
65
+ 403,
66
+ );
67
+ };
68
+
69
+ /**
70
+ * Handles photoUrl upload for sensitive info (supports MediaResource)
71
+ * @param photoUrl - MediaResource (File, Blob, or URL string)
72
+ * @param patientId - ID of the patient
73
+ * @param mediaService - MediaService instance
74
+ * @returns URL string of the uploaded or existing photo
75
+ */
76
+ const handlePhotoUrlUpload = async (
77
+ photoUrl: MediaResource | undefined | null,
78
+ patientId: string,
79
+ mediaService: MediaService,
80
+ ): Promise<string | null> => {
81
+ if (!photoUrl) {
82
+ return null;
83
+ }
84
+
85
+ // If it's already a URL string, return it as is
86
+ if (typeof photoUrl === 'string') {
87
+ return photoUrl;
88
+ }
89
+
90
+ // If it's a File or Blob, upload it
91
+ if (photoUrl instanceof File || photoUrl instanceof Blob) {
92
+ const mediaMetadata = await mediaService.uploadMedia(
93
+ photoUrl,
94
+ patientId, // Using patientId as ownerId
95
+ MediaAccessLevel.PRIVATE, // Sensitive info should be private
96
+ 'patient_sensitive_photos',
97
+ photoUrl instanceof File ? photoUrl.name : `sensitive_photo_${patientId}`,
98
+ );
99
+ return mediaMetadata.url;
100
+ }
101
+
102
+ return null;
103
+ };
104
+
105
+ // Funkcije za rad sa osetljivim informacijama
106
+ export const createSensitiveInfoUtil = async (
107
+ db: Firestore,
108
+ data: CreatePatientSensitiveInfoData,
109
+ requesterId: string,
110
+ requesterRoles: UserRole[],
111
+ mediaService?: MediaService,
112
+ ): Promise<PatientSensitiveInfo> => {
113
+ try {
114
+ // Security check
115
+ await checkSensitiveAccessUtil(db, data.patientId, requesterId, requesterRoles);
116
+
117
+ const validatedData = createPatientSensitiveInfoSchema.parse(data);
118
+
119
+ // Proveriti da li dokument već postoji
120
+ const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, data.patientId));
121
+ if (sensitiveDoc.exists()) {
122
+ throw new Error('Sensitive information already exists for this patient');
123
+ }
124
+
125
+ // Process photoUrl if it's a MediaResource and mediaService is provided
126
+ let processedPhotoUrl: string | null = null;
127
+ if (validatedData.photoUrl && mediaService) {
128
+ processedPhotoUrl = await handlePhotoUrlUpload(
129
+ validatedData.photoUrl,
130
+ data.patientId,
131
+ mediaService,
132
+ );
133
+ } else if (typeof validatedData.photoUrl === 'string') {
134
+ processedPhotoUrl = validatedData.photoUrl;
135
+ }
136
+
137
+ const sensitiveInfoData = {
138
+ ...validatedData,
139
+ photoUrl: processedPhotoUrl,
140
+ createdAt: serverTimestamp(),
141
+ updatedAt: serverTimestamp(),
142
+ };
143
+
144
+ await setDoc(getSensitiveInfoDocRef(db, data.patientId), sensitiveInfoData);
145
+
146
+ const createdDoc = await getDoc(getSensitiveInfoDocRef(db, data.patientId));
147
+ if (!createdDoc.exists()) {
148
+ throw new Error('Failed to create sensitive information');
149
+ }
150
+
151
+ return createdDoc.data() as PatientSensitiveInfo;
152
+ } catch (error) {
153
+ if (error instanceof z.ZodError) {
154
+ throw new Error('Invalid sensitive info data: ' + error.message);
155
+ }
156
+ throw error;
157
+ }
158
+ };
159
+
160
+ export const getSensitiveInfoUtil = async (
161
+ db: Firestore,
162
+ patientId: string,
163
+ requesterId: string,
164
+ requesterRoles: UserRole[],
165
+ ): Promise<PatientSensitiveInfo | null> => {
166
+ // Security check
167
+ await checkSensitiveAccessUtil(db, patientId, requesterId, requesterRoles);
168
+
169
+ // Inicijalizacija dokumenta ako ne postoji
170
+ await initSensitiveInfoDocIfNotExists(db, patientId, requesterId);
171
+
172
+ const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
173
+ return sensitiveDoc.exists() ? (sensitiveDoc.data() as PatientSensitiveInfo) : null;
174
+ };
175
+
176
+ export const updateSensitiveInfoUtil = async (
177
+ db: Firestore,
178
+ patientId: string,
179
+ data: UpdatePatientSensitiveInfoData,
180
+ requesterId: string,
181
+ requesterRoles: UserRole[],
182
+ mediaService?: MediaService,
183
+ ): Promise<PatientSensitiveInfo> => {
184
+ // Security check
185
+ await checkSensitiveAccessUtil(db, patientId, requesterId, requesterRoles);
186
+
187
+ // Inicijalizacija dokumenta ako ne postoji
188
+ await initSensitiveInfoDocIfNotExists(db, patientId, requesterId);
189
+
190
+ // Process photoUrl if it's a MediaResource and mediaService is provided
191
+ let processedPhotoUrl: string | null | undefined = undefined;
192
+ if (data.photoUrl !== undefined) {
193
+ if (mediaService) {
194
+ processedPhotoUrl = await handlePhotoUrlUpload(data.photoUrl, patientId, mediaService);
195
+ } else if (typeof data.photoUrl === 'string' || data.photoUrl === null) {
196
+ processedPhotoUrl = data.photoUrl;
197
+ } else {
198
+ // If photoUrl is a File/Blob but no mediaService provided, throw error
199
+ throw new Error('MediaService required to process photo upload');
200
+ }
201
+ }
202
+
203
+ const updateData = {
204
+ ...data,
205
+ photoUrl: processedPhotoUrl,
206
+ updatedAt: serverTimestamp(),
207
+ };
208
+
209
+ await updateDoc(getSensitiveInfoDocRef(db, patientId), updateData);
210
+
211
+ const updatedDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
212
+ if (!updatedDoc.exists()) {
213
+ throw new Error('Failed to retrieve updated sensitive information');
214
+ }
215
+
216
+ return updatedDoc.data() as PatientSensitiveInfo;
217
+ };
218
+
219
+ export const claimPatientSensitiveInfoUtil = async (
220
+ db: Firestore,
221
+ patientId: string,
222
+ userId: string,
223
+ ): Promise<PatientSensitiveInfo> => {
224
+ const patientDoc = await getDoc(getPatientDocRef(db, patientId));
225
+ if (!patientDoc.exists()) {
226
+ throw new Error('Patient profile not found');
227
+ }
228
+
229
+ const patientData = patientDoc.data() as any;
230
+
231
+ if (!patientData.isManual) {
232
+ throw new Error('Only manually created patient profiles can be claimed');
233
+ }
234
+
235
+ if (patientData.userRef) {
236
+ throw new Error('Patient profile has already been claimed');
237
+ }
238
+
239
+ const sensitiveDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
240
+ if (!sensitiveDoc.exists()) {
241
+ throw new Error('Patient sensitive information not found');
242
+ }
243
+
244
+ const sensitiveData = sensitiveDoc.data() as PatientSensitiveInfo;
245
+ if (sensitiveData.userRef) {
246
+ throw new Error('Patient sensitive information has already been claimed');
247
+ }
248
+
249
+ await updateDoc(getSensitiveInfoDocRef(db, patientId), {
250
+ userRef: userId,
251
+ updatedAt: serverTimestamp(),
252
+ });
253
+
254
+ const updatedDoc = await getDoc(getSensitiveInfoDocRef(db, patientId));
255
+ if (!updatedDoc.exists()) {
256
+ throw new Error('Failed to retrieve updated sensitive information');
257
+ }
258
+
259
+ return updatedDoc.data() as PatientSensitiveInfo;
260
+ };