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

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 {
2
- collection,
3
- query,
4
- where,
5
- getDocs,
6
- Firestore,
7
- limit,
8
- startAfter,
9
- doc,
10
- getDoc,
11
- QueryConstraint,
12
- } from "firebase/firestore";
13
- import {
14
- PatientProfile,
15
- PatientSensitiveInfo,
16
- PatientProfileForDoctor,
17
- PATIENTS_COLLECTION,
18
- } from "../../../types/patient";
19
- import { getSensitiveInfoDocRef } from "./docs.utils";
20
- import {
21
- Practitioner,
22
- PRACTITIONERS_COLLECTION,
23
- } from "../../../types/practitioner";
24
-
25
- /**
26
- * Retrieves all patients associated with a specific practitioner with pagination support.
27
- *
28
- * @param {Firestore} db - Firestore instance
29
- * @param {string} practitionerId - ID of the practitioner whose patients to retrieve
30
- * @param {Object} options - Optional parameters for pagination
31
- * @param {number} options.limit - Maximum number of profiles to return
32
- * @param {string} options.startAfter - The ID of the document to start after (for pagination)
33
- * @returns {Promise<PatientProfile[]>} A promise resolving to an array of patient profiles
34
- */
35
- export const getPatientsByPractitionerUtil = async (
36
- db: Firestore,
37
- practitionerId: string,
38
- options?: { limit?: number; startAfter?: string }
39
- ): Promise<PatientProfile[]> => {
40
- try {
41
- console.log(
42
- `[getPatientsByPractitionerUtil] Fetching patients for practitioner ID: ${practitionerId} with options:`,
43
- options
44
- );
45
-
46
- const patientsCollection = collection(db, PATIENTS_COLLECTION);
47
- const constraints: QueryConstraint[] = [
48
- where("doctorIds", "array-contains", practitionerId),
49
- ];
50
-
51
- let q = query(patientsCollection, ...constraints);
52
-
53
- // Apply pagination if needed
54
- if (options?.limit) {
55
- q = query(q, limit(options.limit));
56
- }
57
-
58
- // If startAfter is provided, get that document and use it for pagination
59
- if (options?.startAfter) {
60
- const startAfterDoc = await getDoc(
61
- doc(db, PATIENTS_COLLECTION, options.startAfter)
62
- );
63
- if (startAfterDoc.exists()) {
64
- q = query(q, startAfter(startAfterDoc));
65
- }
66
- }
67
-
68
- const patientsSnapshot = await getDocs(q);
69
-
70
- const patients: PatientProfile[] = [];
71
- patientsSnapshot.forEach((doc) => {
72
- patients.push(doc.data() as PatientProfile);
73
- });
74
-
75
- console.log(
76
- `[getPatientsByPractitionerUtil] Found ${patients.length} patients for practitioner ID: ${practitionerId}`
77
- );
78
- return patients;
79
- } catch (error) {
80
- console.error(
81
- `[getPatientsByPractitionerUtil] Error fetching patients for practitioner:`,
82
- error
83
- );
84
- throw new Error(
85
- `Failed to retrieve patients for practitioner: ${
86
- error instanceof Error ? error.message : String(error)
87
- }`
88
- );
89
- }
90
- };
91
-
92
- /**
93
- * Retrieves all patients associated with a specific practitioner with their sensitive information.
94
- *
95
- * @param {Firestore} db - Firestore instance
96
- * @param {string} practitionerId - ID of the practitioner whose patients to retrieve
97
- * @param {Object} options - Optional parameters for pagination
98
- * @param {number} options.limit - Maximum number of profiles to return
99
- * @param {string} options.startAfter - The ID of the document to start after (for pagination)
100
- * @returns {Promise<PatientProfileForDoctor[]>} A promise resolving to an array of patient profiles with sensitive info
101
- */
102
- export const getPatientsByPractitionerWithDetailsUtil = async (
103
- db: Firestore,
104
- practitionerId: string,
105
- options?: { limit?: number; startAfter?: string }
106
- ): Promise<PatientProfileForDoctor[]> => {
107
- try {
108
- console.log(
109
- `[getPatientsByPractitionerWithDetailsUtil] Fetching detailed patient profiles for practitioner ID: ${practitionerId} with options:`,
110
- options
111
- );
112
-
113
- // First, get all patient profiles for this practitioner
114
- const patientProfiles = await getPatientsByPractitionerUtil(
115
- db,
116
- practitionerId,
117
- options
118
- );
119
-
120
- // Then, fetch sensitive info for each patient
121
- const patientProfilesWithDetails: PatientProfileForDoctor[] =
122
- await Promise.all(
123
- patientProfiles.map(async (profile) => {
124
- try {
125
- const sensitiveInfoDoc = await getDoc(
126
- getSensitiveInfoDocRef(db, profile.id)
127
- );
128
- const sensitiveInfo = sensitiveInfoDoc.exists()
129
- ? (sensitiveInfoDoc.data() as PatientSensitiveInfo)
130
- : undefined;
131
-
132
- return {
133
- patientProfile: profile,
134
- patientSensitiveInfo: sensitiveInfo,
135
- };
136
- } catch (error) {
137
- console.error(
138
- `[getPatientsByPractitionerWithDetailsUtil] Error fetching sensitive info for patient ${profile.id}:`,
139
- error
140
- );
141
- // Return profile without sensitive info in case of error
142
- return { patientProfile: profile };
143
- }
144
- })
145
- );
146
-
147
- console.log(
148
- `[getPatientsByPractitionerWithDetailsUtil] Found ${patientProfilesWithDetails.length} detailed patient profiles for practitioner ID: ${practitionerId}`
149
- );
150
- return patientProfilesWithDetails;
151
- } catch (error) {
152
- console.error(
153
- `[getPatientsByPractitionerWithDetailsUtil] Error fetching detailed patient profiles:`,
154
- error
155
- );
156
- throw new Error(
157
- `Failed to retrieve detailed patient profiles: ${
158
- error instanceof Error ? error.message : String(error)
159
- }`
160
- );
161
- }
162
- };
163
-
164
- /**
165
- * Retrieves a practitioner profile by ID
166
- *
167
- * @param {Firestore} db - Firestore instance
168
- * @param {string} practitionerId - ID of the practitioner to retrieve
169
- * @returns {Promise<Practitioner | null>} A promise resolving to the practitioner profile or null if not found
170
- */
171
- export const getPractitionerProfile = async (
172
- db: Firestore,
173
- practitionerId: string
174
- ): Promise<Practitioner | null> => {
175
- try {
176
- console.log(
177
- `[getPractitionerProfile] Fetching practitioner with ID: ${practitionerId}`
178
- );
179
-
180
- const practitionerRef = doc(db, PRACTITIONERS_COLLECTION, practitionerId);
181
- const practitionerSnapshot = await getDoc(practitionerRef);
182
-
183
- if (!practitionerSnapshot.exists()) {
184
- console.log(
185
- `[getPractitionerProfile] Practitioner with ID ${practitionerId} not found`
186
- );
187
- return null;
188
- }
189
-
190
- const practitioner = practitionerSnapshot.data() as Practitioner;
191
- console.log(
192
- `[getPractitionerProfile] Successfully retrieved practitioner: ${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`
193
- );
194
-
195
- return practitioner;
196
- } catch (error) {
197
- console.error(
198
- `[getPractitionerProfile] Error fetching practitioner:`,
199
- error
200
- );
201
- throw new Error(
202
- `Failed to retrieve practitioner: ${
203
- error instanceof Error ? error.message : String(error)
204
- }`
205
- );
206
- }
207
- };
208
-
209
- /**
210
- * Retrieves a practitioner profile by user reference ID
211
- *
212
- * @param {Firestore} db - Firestore instance
213
- * @param {string} userRef - Firebase Auth user ID reference
214
- * @returns {Promise<Practitioner | null>} A promise resolving to the practitioner profile or null if not found
215
- */
216
- export const getPractitionerProfileByUserRef = async (
217
- db: Firestore,
218
- userRef: string
219
- ): Promise<Practitioner | null> => {
220
- try {
221
- console.log(
222
- `[getPractitionerProfileByUserRef] Fetching practitioner with userRef: ${userRef}`
223
- );
224
-
225
- const practitionersCollection = collection(db, PRACTITIONERS_COLLECTION);
226
- const q = query(
227
- practitionersCollection,
228
- where("userRef", "==", userRef),
229
- limit(1)
230
- );
231
-
232
- const querySnapshot = await getDocs(q);
233
-
234
- if (querySnapshot.empty) {
235
- console.log(
236
- `[getPractitionerProfileByUserRef] No practitioner found with userRef: ${userRef}`
237
- );
238
- return null;
239
- }
240
-
241
- const practitionerDoc = querySnapshot.docs[0];
242
- const practitioner = practitionerDoc.data() as Practitioner;
243
-
244
- console.log(
245
- `[getPractitionerProfileByUserRef] Successfully retrieved practitioner: ${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`
246
- );
247
-
248
- return practitioner;
249
- } catch (error) {
250
- console.error(
251
- `[getPractitionerProfileByUserRef] Error fetching practitioner:`,
252
- error
253
- );
254
- throw new Error(
255
- `Failed to retrieve practitioner by userRef: ${
256
- error instanceof Error ? error.message : String(error)
257
- }`
258
- );
259
- }
260
- };
1
+ import {
2
+ collection,
3
+ query,
4
+ where,
5
+ getDocs,
6
+ Firestore,
7
+ limit,
8
+ startAfter,
9
+ doc,
10
+ getDoc,
11
+ QueryConstraint,
12
+ } from "firebase/firestore";
13
+ import {
14
+ PatientProfile,
15
+ PatientSensitiveInfo,
16
+ PatientProfileForDoctor,
17
+ PATIENTS_COLLECTION,
18
+ } from "../../../types/patient";
19
+ import { getSensitiveInfoDocRef } from "./docs.utils";
20
+ import {
21
+ Practitioner,
22
+ PRACTITIONERS_COLLECTION,
23
+ } from "../../../types/practitioner";
24
+
25
+ /**
26
+ * Retrieves all patients associated with a specific practitioner with pagination support.
27
+ *
28
+ * @param {Firestore} db - Firestore instance
29
+ * @param {string} practitionerId - ID of the practitioner whose patients to retrieve
30
+ * @param {Object} options - Optional parameters for pagination
31
+ * @param {number} options.limit - Maximum number of profiles to return
32
+ * @param {string} options.startAfter - The ID of the document to start after (for pagination)
33
+ * @returns {Promise<PatientProfile[]>} A promise resolving to an array of patient profiles
34
+ */
35
+ export const getPatientsByPractitionerUtil = async (
36
+ db: Firestore,
37
+ practitionerId: string,
38
+ options?: { limit?: number; startAfter?: string }
39
+ ): Promise<PatientProfile[]> => {
40
+ try {
41
+ console.log(
42
+ `[getPatientsByPractitionerUtil] Fetching patients for practitioner ID: ${practitionerId} with options:`,
43
+ options
44
+ );
45
+
46
+ const patientsCollection = collection(db, PATIENTS_COLLECTION);
47
+ const constraints: QueryConstraint[] = [
48
+ where("doctorIds", "array-contains", practitionerId),
49
+ ];
50
+
51
+ let q = query(patientsCollection, ...constraints);
52
+
53
+ // Apply pagination if needed
54
+ if (options?.limit) {
55
+ q = query(q, limit(options.limit));
56
+ }
57
+
58
+ // If startAfter is provided, get that document and use it for pagination
59
+ if (options?.startAfter) {
60
+ const startAfterDoc = await getDoc(
61
+ doc(db, PATIENTS_COLLECTION, options.startAfter)
62
+ );
63
+ if (startAfterDoc.exists()) {
64
+ q = query(q, startAfter(startAfterDoc));
65
+ }
66
+ }
67
+
68
+ const patientsSnapshot = await getDocs(q);
69
+
70
+ const patients: PatientProfile[] = [];
71
+ patientsSnapshot.forEach((doc) => {
72
+ patients.push(doc.data() as PatientProfile);
73
+ });
74
+
75
+ console.log(
76
+ `[getPatientsByPractitionerUtil] Found ${patients.length} patients for practitioner ID: ${practitionerId}`
77
+ );
78
+ return patients;
79
+ } catch (error) {
80
+ console.error(
81
+ `[getPatientsByPractitionerUtil] Error fetching patients for practitioner:`,
82
+ error
83
+ );
84
+ throw new Error(
85
+ `Failed to retrieve patients for practitioner: ${
86
+ error instanceof Error ? error.message : String(error)
87
+ }`
88
+ );
89
+ }
90
+ };
91
+
92
+ /**
93
+ * Retrieves all patients associated with a specific practitioner with their sensitive information.
94
+ *
95
+ * @param {Firestore} db - Firestore instance
96
+ * @param {string} practitionerId - ID of the practitioner whose patients to retrieve
97
+ * @param {Object} options - Optional parameters for pagination
98
+ * @param {number} options.limit - Maximum number of profiles to return
99
+ * @param {string} options.startAfter - The ID of the document to start after (for pagination)
100
+ * @returns {Promise<PatientProfileForDoctor[]>} A promise resolving to an array of patient profiles with sensitive info
101
+ */
102
+ export const getPatientsByPractitionerWithDetailsUtil = async (
103
+ db: Firestore,
104
+ practitionerId: string,
105
+ options?: { limit?: number; startAfter?: string }
106
+ ): Promise<PatientProfileForDoctor[]> => {
107
+ try {
108
+ console.log(
109
+ `[getPatientsByPractitionerWithDetailsUtil] Fetching detailed patient profiles for practitioner ID: ${practitionerId} with options:`,
110
+ options
111
+ );
112
+
113
+ // First, get all patient profiles for this practitioner
114
+ const patientProfiles = await getPatientsByPractitionerUtil(
115
+ db,
116
+ practitionerId,
117
+ options
118
+ );
119
+
120
+ // Then, fetch sensitive info for each patient
121
+ const patientProfilesWithDetails: PatientProfileForDoctor[] =
122
+ await Promise.all(
123
+ patientProfiles.map(async (profile) => {
124
+ try {
125
+ const sensitiveInfoDoc = await getDoc(
126
+ getSensitiveInfoDocRef(db, profile.id)
127
+ );
128
+ const sensitiveInfo = sensitiveInfoDoc.exists()
129
+ ? (sensitiveInfoDoc.data() as PatientSensitiveInfo)
130
+ : undefined;
131
+
132
+ return {
133
+ patientProfile: profile,
134
+ patientSensitiveInfo: sensitiveInfo,
135
+ };
136
+ } catch (error) {
137
+ console.error(
138
+ `[getPatientsByPractitionerWithDetailsUtil] Error fetching sensitive info for patient ${profile.id}:`,
139
+ error
140
+ );
141
+ // Return profile without sensitive info in case of error
142
+ return { patientProfile: profile };
143
+ }
144
+ })
145
+ );
146
+
147
+ console.log(
148
+ `[getPatientsByPractitionerWithDetailsUtil] Found ${patientProfilesWithDetails.length} detailed patient profiles for practitioner ID: ${practitionerId}`
149
+ );
150
+ return patientProfilesWithDetails;
151
+ } catch (error) {
152
+ console.error(
153
+ `[getPatientsByPractitionerWithDetailsUtil] Error fetching detailed patient profiles:`,
154
+ error
155
+ );
156
+ throw new Error(
157
+ `Failed to retrieve detailed patient profiles: ${
158
+ error instanceof Error ? error.message : String(error)
159
+ }`
160
+ );
161
+ }
162
+ };
163
+
164
+ /**
165
+ * Retrieves a practitioner profile by ID
166
+ *
167
+ * @param {Firestore} db - Firestore instance
168
+ * @param {string} practitionerId - ID of the practitioner to retrieve
169
+ * @returns {Promise<Practitioner | null>} A promise resolving to the practitioner profile or null if not found
170
+ */
171
+ export const getPractitionerProfile = async (
172
+ db: Firestore,
173
+ practitionerId: string
174
+ ): Promise<Practitioner | null> => {
175
+ try {
176
+ console.log(
177
+ `[getPractitionerProfile] Fetching practitioner with ID: ${practitionerId}`
178
+ );
179
+
180
+ const practitionerRef = doc(db, PRACTITIONERS_COLLECTION, practitionerId);
181
+ const practitionerSnapshot = await getDoc(practitionerRef);
182
+
183
+ if (!practitionerSnapshot.exists()) {
184
+ console.log(
185
+ `[getPractitionerProfile] Practitioner with ID ${practitionerId} not found`
186
+ );
187
+ return null;
188
+ }
189
+
190
+ const practitioner = practitionerSnapshot.data() as Practitioner;
191
+ console.log(
192
+ `[getPractitionerProfile] Successfully retrieved practitioner: ${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`
193
+ );
194
+
195
+ return practitioner;
196
+ } catch (error) {
197
+ console.error(
198
+ `[getPractitionerProfile] Error fetching practitioner:`,
199
+ error
200
+ );
201
+ throw new Error(
202
+ `Failed to retrieve practitioner: ${
203
+ error instanceof Error ? error.message : String(error)
204
+ }`
205
+ );
206
+ }
207
+ };
208
+
209
+ /**
210
+ * Retrieves a practitioner profile by user reference ID
211
+ *
212
+ * @param {Firestore} db - Firestore instance
213
+ * @param {string} userRef - Firebase Auth user ID reference
214
+ * @returns {Promise<Practitioner | null>} A promise resolving to the practitioner profile or null if not found
215
+ */
216
+ export const getPractitionerProfileByUserRef = async (
217
+ db: Firestore,
218
+ userRef: string
219
+ ): Promise<Practitioner | null> => {
220
+ try {
221
+ console.log(
222
+ `[getPractitionerProfileByUserRef] Fetching practitioner with userRef: ${userRef}`
223
+ );
224
+
225
+ const practitionersCollection = collection(db, PRACTITIONERS_COLLECTION);
226
+ const q = query(
227
+ practitionersCollection,
228
+ where("userRef", "==", userRef),
229
+ limit(1)
230
+ );
231
+
232
+ const querySnapshot = await getDocs(q);
233
+
234
+ if (querySnapshot.empty) {
235
+ console.log(
236
+ `[getPractitionerProfileByUserRef] No practitioner found with userRef: ${userRef}`
237
+ );
238
+ return null;
239
+ }
240
+
241
+ const practitionerDoc = querySnapshot.docs[0];
242
+ const practitioner = practitionerDoc.data() as Practitioner;
243
+
244
+ console.log(
245
+ `[getPractitionerProfileByUserRef] Successfully retrieved practitioner: ${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`
246
+ );
247
+
248
+ return practitioner;
249
+ } catch (error) {
250
+ console.error(
251
+ `[getPractitionerProfileByUserRef] Error fetching practitioner:`,
252
+ error
253
+ );
254
+ throw new Error(
255
+ `Failed to retrieve practitioner by userRef: ${
256
+ error instanceof Error ? error.message : String(error)
257
+ }`
258
+ );
259
+ }
260
+ };