rez_core 4.0.136 → 4.0.138

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 (438) hide show
  1. package/.prettierrc +3 -3
  2. package/README.md +99 -99
  3. package/dist/config/config.module.js +2 -2
  4. package/dist/config/config.module.js.map +1 -1
  5. package/dist/config/database.config.d.ts +1 -1
  6. package/dist/config/database.config.js +12 -15
  7. package/dist/config/database.config.js.map +1 -1
  8. package/dist/module/auth/guards/role.guard.js +3 -3
  9. package/dist/module/auth/services/auth.service.js +3 -3
  10. package/dist/module/auth/services/auth.service.js.map +1 -1
  11. package/dist/module/enterprise/entity/organization.entity.js +1 -1
  12. package/dist/module/filter/repository/saved-filter.repository.js +4 -4
  13. package/dist/module/filter/service/filter-evaluator.service.js +2 -2
  14. package/dist/module/filter/service/filter.service.js +22 -22
  15. package/dist/module/integration/entity/integration-config.entity.js +6 -6
  16. package/dist/module/integration/entity/integration-config.entity.js.map +1 -1
  17. package/dist/module/integration/entity/integration-entity-mapper.entity.js +1 -1
  18. package/dist/module/integration/entity/integration-entity-mapper.entity.js.map +1 -1
  19. package/dist/module/integration/entity/integration-source.entity.js +4 -4
  20. package/dist/module/integration/entity/integration-source.entity.js.map +1 -1
  21. package/dist/module/integration/entity/user-integration.entity.js +4 -4
  22. package/dist/module/integration/entity/user-integration.entity.js.map +1 -1
  23. package/dist/module/integration/examples/usage.example.js +9 -9
  24. package/dist/module/integration/service/integration.service.js +1 -1
  25. package/dist/module/integration/service/wrapper.service.d.ts +3 -1
  26. package/dist/module/integration/service/wrapper.service.js +64 -61
  27. package/dist/module/integration/service/wrapper.service.js.map +1 -1
  28. package/dist/module/listmaster/entity/list-master-items.entity.js +3 -3
  29. package/dist/module/listmaster/entity/list-master-items.entity.js.map +1 -1
  30. package/dist/module/listmaster/entity/list-master.entity.js +4 -4
  31. package/dist/module/listmaster/entity/list-master.entity.js.map +1 -1
  32. package/dist/module/listmaster/service/list-master-item.service.js +2 -2
  33. package/dist/module/mapper/entity/field-mapper.entity.js +6 -6
  34. package/dist/module/mapper/entity/field-mapper.entity.js.map +1 -1
  35. package/dist/module/mapper/service/field-mapper.service.js +6 -6
  36. package/dist/module/mapper/service/field-mapper.service.js.map +1 -1
  37. package/dist/module/mapper/service/mapper.service.js +2 -2
  38. package/dist/module/meta/entity/entity-master.entity.js +1 -1
  39. package/dist/module/meta/entity/entity-master.entity.js.map +1 -1
  40. package/dist/module/meta/entity/view-master.entity.js +1 -1
  41. package/dist/module/meta/entity/view-master.entity.js.map +1 -1
  42. package/dist/module/meta/service/attribute-master.service.js +1 -1
  43. package/dist/module/meta/service/attribute-master.service.js.map +1 -1
  44. package/dist/module/meta/service/entity-dynamic.service.js +9 -9
  45. package/dist/module/meta/service/entity-list.service.js +3 -3
  46. package/dist/module/meta/service/entity-master.service.js +3 -3
  47. package/dist/module/meta/service/entity-relation.service.js +11 -11
  48. package/dist/module/meta/service/entity-service-impl.service.js +3 -3
  49. package/dist/module/meta/service/resolver.service.js +5 -5
  50. package/dist/module/meta/service/resolver.service.js.map +1 -1
  51. package/dist/module/module/repository/menu.repository.js +13 -13
  52. package/dist/module/module/repository/menu.repository.js.map +1 -1
  53. package/dist/module/notification/entity/otp.entity.js +1 -1
  54. package/dist/module/notification/entity/otp.entity.js.map +1 -1
  55. package/dist/module/notification/service/notification.service.js +9 -9
  56. package/dist/module/user/controller/login.controller.js +18 -18
  57. package/dist/module/user/entity/user-role-mapping.entity.js +1 -1
  58. package/dist/module/user/entity/user-role-mapping.entity.js.map +1 -1
  59. package/dist/module/user/service/role.service.js +4 -4
  60. package/dist/module/user/service/user-session.service.js +2 -2
  61. package/dist/module/workflow/entity/action-data.entity.js +1 -1
  62. package/dist/module/workflow/entity/action-data.entity.js.map +1 -1
  63. package/dist/module/workflow/entity/action.entity.js +1 -1
  64. package/dist/module/workflow/entity/action.entity.js.map +1 -1
  65. package/dist/module/workflow/entity/comm-template.entity.js +1 -1
  66. package/dist/module/workflow/entity/comm-template.entity.js.map +1 -1
  67. package/dist/module/workflow/repository/action.repository.js +20 -20
  68. package/dist/module/workflow/repository/comm-template.repository.js +6 -6
  69. package/dist/module/workflow/repository/form-master.repository.js +2 -2
  70. package/dist/module/workflow/repository/stage-group.repository.js +23 -23
  71. package/dist/module/workflow/repository/stage-movement.repository.js +15 -15
  72. package/dist/module/workflow/repository/stage.repository.js +8 -8
  73. package/dist/module/workflow/repository/task.repository.d.ts +3 -1
  74. package/dist/module/workflow/repository/task.repository.js +8 -3
  75. package/dist/module/workflow/repository/task.repository.js.map +1 -1
  76. package/dist/module/workflow/service/action-template-mapping.service.js +22 -22
  77. package/dist/module/workflow/service/action.service.js +7 -7
  78. package/dist/module/workflow/service/entity-modification.service.js +6 -6
  79. package/dist/module/workflow/service/stage-group.service.js +2 -2
  80. package/dist/module/workflow/service/stage.service.js +2 -2
  81. package/dist/module/workflow/service/task.service.js +36 -41
  82. package/dist/module/workflow/service/task.service.js.map +1 -1
  83. package/dist/module/workflow/service/workflow-list-master.service.js +15 -15
  84. package/dist/module/workflow/service/workflow-meta.service.js +49 -47
  85. package/dist/module/workflow/service/workflow-meta.service.js.map +1 -1
  86. package/dist/module/workflow/service/workflow.service.js +2 -2
  87. package/dist/tsconfig.build.tsbuildinfo +1 -1
  88. package/dist/utils/service/loggingUtil.service.d.ts +9 -2
  89. package/dist/utils/service/loggingUtil.service.js +65 -14
  90. package/dist/utils/service/loggingUtil.service.js.map +1 -1
  91. package/dist/utils/service/reflection-helper.service.js +2 -2
  92. package/dist/utils/utils.module.js +2 -0
  93. package/dist/utils/utils.module.js.map +1 -1
  94. package/docs/modules/event-driven-integration-design.md +91 -91
  95. package/docs/modules/integration.md +250 -250
  96. package/eslint.config.mjs +34 -34
  97. package/nest-cli.json +14 -14
  98. package/package.json +119 -120
  99. package/src/app.controller.ts +12 -12
  100. package/src/app.module.ts +52 -52
  101. package/src/app.service.ts +8 -8
  102. package/src/config/config.module.ts +18 -17
  103. package/src/config/database.config.ts +23 -47
  104. package/src/constant/global.constant.ts +67 -67
  105. package/src/core.module.ts +81 -81
  106. package/src/decorators/roles.decorator.ts +7 -7
  107. package/src/dtos/response.dto.ts +6 -6
  108. package/src/dtos/response.ts +5 -5
  109. package/src/index.ts +1 -1
  110. package/src/module/auth/auth.module.ts +49 -49
  111. package/src/module/auth/controller/auth.controller.ts +28 -28
  112. package/src/module/auth/guards/google-auth.guard.ts +9 -9
  113. package/src/module/auth/guards/jwt.guard.ts +22 -22
  114. package/src/module/auth/guards/role.guard.ts +68 -68
  115. package/src/module/auth/services/auth.service.ts +50 -50
  116. package/src/module/auth/services/jwt.service.ts +11 -11
  117. package/src/module/auth/strategies/google.strategy.ts +54 -54
  118. package/src/module/auth/strategies/jwt.strategy.ts +58 -58
  119. package/src/module/auth/strategies/local.strategy.ts +13 -13
  120. package/src/module/dashboard/controller/dashboard.controller.ts +36 -36
  121. package/src/module/dashboard/dashboard.module.ts +21 -21
  122. package/src/module/dashboard/entity/dashboard_page_data.entity.ts +27 -27
  123. package/src/module/dashboard/entity/widget_master.entity.ts +18 -18
  124. package/src/module/dashboard/repository/dashboard.repository.ts +42 -42
  125. package/src/module/dashboard/service/dashboard.service.ts +73 -73
  126. package/src/module/dev/dev.module.ts +12 -12
  127. package/src/module/dev/service/dev.service.ts +7 -7
  128. package/src/module/enterprise/controller/organization.controller.ts +36 -36
  129. package/src/module/enterprise/enterprise.module.ts +30 -30
  130. package/src/module/enterprise/entity/enterprise.entity.ts +37 -37
  131. package/src/module/enterprise/entity/organization-app-mapping.entity.ts +13 -13
  132. package/src/module/enterprise/entity/organization.entity.ts +92 -92
  133. package/src/module/enterprise/repository/enterprise.repository.ts +31 -31
  134. package/src/module/enterprise/repository/organization.repository.ts +26 -26
  135. package/src/module/enterprise/repository/school.repository.ts +278 -278
  136. package/src/module/enterprise/service/brand.service.ts +5 -5
  137. package/src/module/enterprise/service/enterprise.service.ts +16 -16
  138. package/src/module/enterprise/service/organization-app-mapping.service.ts +4 -4
  139. package/src/module/enterprise/service/organization.service.ts +145 -145
  140. package/src/module/filter/controller/filter.controller.ts +84 -84
  141. package/src/module/filter/dto/filter-request.dto.ts +38 -38
  142. package/src/module/filter/entity/saved-filter-detail.entity.ts +41 -41
  143. package/src/module/filter/entity/saved-filter-master.entity.ts +23 -23
  144. package/src/module/filter/filter.module.ts +31 -31
  145. package/src/module/filter/repository/saved-filter.repository.ts +168 -168
  146. package/src/module/filter/service/filter-evaluator.service.ts +86 -86
  147. package/src/module/filter/service/filter.service.ts +1005 -1005
  148. package/src/module/filter/service/saved-filter.service.ts +170 -170
  149. package/src/module/ics/controller/ics.controller.ts +21 -21
  150. package/src/module/ics/dto/ics.dto.ts +55 -55
  151. package/src/module/ics/ics.module.ts +13 -13
  152. package/src/module/ics/service/ics.service.ts +57 -57
  153. package/src/module/integration/controller/calender-event.controller.ts +31 -31
  154. package/src/module/integration/controller/integration.controller.ts +662 -662
  155. package/src/module/integration/controller/wrapper.controller.ts +37 -37
  156. package/src/module/integration/dto/create-config.dto.ts +526 -526
  157. package/src/module/integration/entity/integration-config.entity.ts +112 -112
  158. package/src/module/integration/entity/integration-entity-mapper.entity.ts +14 -14
  159. package/src/module/integration/entity/integration-source.entity.ts +17 -17
  160. package/src/module/integration/entity/user-integration.entity.ts +71 -71
  161. package/src/module/integration/examples/usage.example.ts +338 -338
  162. package/src/module/integration/factories/base.factory.ts +7 -7
  163. package/src/module/integration/factories/email.factory.ts +49 -49
  164. package/src/module/integration/factories/integration.factory.ts +121 -121
  165. package/src/module/integration/factories/sms.factory.ts +51 -51
  166. package/src/module/integration/factories/telephone.factory.ts +41 -41
  167. package/src/module/integration/factories/whatsapp.factory.ts +56 -56
  168. package/src/module/integration/integration.module.ts +110 -110
  169. package/src/module/integration/service/calendar-event.service.ts +118 -118
  170. package/src/module/integration/service/integration-entity-mapper.service.ts +17 -17
  171. package/src/module/integration/service/integration-queue.service.ts +229 -229
  172. package/src/module/integration/service/integration.service.ts +2633 -2633
  173. package/src/module/integration/service/oauth.service.ts +224 -224
  174. package/src/module/integration/service/wrapper.service.ts +700 -493
  175. package/src/module/integration/strategies/email/gmail-api.strategy.ts +280 -280
  176. package/src/module/integration/strategies/email/outlook-api.strategy.ts +44 -44
  177. package/src/module/integration/strategies/email/outlook.strategy.ts +64 -64
  178. package/src/module/integration/strategies/email/sendgrid-api.strategy.ts +260 -260
  179. package/src/module/integration/strategies/integration.strategy.ts +97 -97
  180. package/src/module/integration/strategies/sms/gupshup-sms.strategy.ts +146 -146
  181. package/src/module/integration/strategies/sms/msg91-sms.strategy.ts +164 -164
  182. package/src/module/integration/strategies/sms/tubelight-sms.strategy.ts +163 -163
  183. package/src/module/integration/strategies/telephone/ozonetel-voice.strategy.ts +238 -238
  184. package/src/module/integration/strategies/telephone/tubelight-voice.strategy.ts +210 -210
  185. package/src/module/integration/strategies/whatsapp/gupshup-whatsapp.strategy.ts +359 -359
  186. package/src/module/integration/strategies/whatsapp/tubelight-whatsapp.strategy.ts +372 -372
  187. package/src/module/integration/strategies/whatsapp/whatsapp-cloud.strategy.ts +403 -403
  188. package/src/module/integration/strategies/whatsapp/whatsapp.strategy.ts +57 -57
  189. package/src/module/layout/controller/layout.controller.ts +47 -47
  190. package/src/module/layout/entity/header-items.entity.ts +28 -28
  191. package/src/module/layout/entity/header-section.entity.ts +19 -19
  192. package/src/module/layout/layout.module.ts +21 -21
  193. package/src/module/layout/repository/header-items.repository.ts +18 -18
  194. package/src/module/layout/repository/header-section.repository.ts +22 -22
  195. package/src/module/layout/service/header-section.service.ts +25 -25
  196. package/src/module/layout_preference/controller/layout_preference.controller.ts +73 -73
  197. package/src/module/layout_preference/entity/layout_preference.entity.ts +28 -28
  198. package/src/module/layout_preference/layout_preference.module.ts +22 -22
  199. package/src/module/layout_preference/repository/layout_preference.repository.ts +65 -65
  200. package/src/module/layout_preference/service/layout_preference.service.ts +191 -191
  201. package/src/module/lead/controller/lead.controller.ts +30 -30
  202. package/src/module/lead/lead.module.ts +14 -14
  203. package/src/module/lead/repository/lead.repository.ts +41 -41
  204. package/src/module/lead/service/lead.service.ts +54 -54
  205. package/src/module/listmaster/controller/list-master.controller.ts +230 -230
  206. package/src/module/listmaster/entity/list-master-items.entity.ts +43 -43
  207. package/src/module/listmaster/entity/list-master.entity.ts +33 -33
  208. package/src/module/listmaster/listmaster.module.ts +46 -46
  209. package/src/module/listmaster/repository/list-master-items.repository.ts +169 -169
  210. package/src/module/listmaster/repository/list-master.repository.ts +46 -46
  211. package/src/module/listmaster/service/list-master-engine.ts +19 -19
  212. package/src/module/listmaster/service/list-master-extension.interface.ts +4 -4
  213. package/src/module/listmaster/service/list-master-item.service.ts +292 -292
  214. package/src/module/listmaster/service/list-master-registry.ts +15 -15
  215. package/src/module/listmaster/service/list-master.service.ts +535 -535
  216. package/src/module/mapper/controller/field-mapper.controller.ts +76 -76
  217. package/src/module/mapper/controller/mapper.controller.ts +20 -20
  218. package/src/module/mapper/dto/field-mapper.dto.ts +14 -14
  219. package/src/module/mapper/entity/field-lovs.entity.ts +19 -19
  220. package/src/module/mapper/entity/field-mapper.entity.ts +53 -53
  221. package/src/module/mapper/entity/mapper.entity.ts +16 -16
  222. package/src/module/mapper/mapper.module.ts +34 -34
  223. package/src/module/mapper/repository/field-lovs.repository.ts +35 -35
  224. package/src/module/mapper/repository/field-mapper.repository.ts +42 -42
  225. package/src/module/mapper/repository/mapper.repository.ts +15 -15
  226. package/src/module/mapper/service/field-mapper.service.ts +271 -266
  227. package/src/module/mapper/service/mapper.service.ts +79 -79
  228. package/src/module/master/controller/master.controller.ts +74 -74
  229. package/src/module/master/service/master.service.ts +483 -483
  230. package/src/module/meta/controller/app-master.controller.ts +38 -38
  231. package/src/module/meta/controller/attribute-master.controller.ts +66 -66
  232. package/src/module/meta/controller/entity-dynamic.controller.ts +125 -125
  233. package/src/module/meta/controller/entity-master.controller.ts +28 -28
  234. package/src/module/meta/controller/entity-relation.controller.ts +36 -36
  235. package/src/module/meta/controller/entity.controller.ts +392 -392
  236. package/src/module/meta/controller/entity.public.controller.ts +75 -75
  237. package/src/module/meta/controller/media.controller.ts +107 -107
  238. package/src/module/meta/controller/meta.controller.ts +96 -96
  239. package/src/module/meta/controller/view-master.controller.ts +86 -86
  240. package/src/module/meta/dto/entity-list-data.dto.ts +6 -6
  241. package/src/module/meta/dto/entity-tab.dto.ts +4 -4
  242. package/src/module/meta/dto/entity-table.dto.ts +9 -9
  243. package/src/module/meta/entity/app-master.entity.ts +34 -34
  244. package/src/module/meta/entity/attribute-master.entity.ts +89 -89
  245. package/src/module/meta/entity/base-entity.entity.ts +75 -75
  246. package/src/module/meta/entity/entity-master.entity.ts +85 -85
  247. package/src/module/meta/entity/entity-relation-data.entity.ts +29 -29
  248. package/src/module/meta/entity/entity-relation.entity.ts +23 -23
  249. package/src/module/meta/entity/entity-table-column.entity.ts +61 -61
  250. package/src/module/meta/entity/entity-table.entity.ts +50 -50
  251. package/src/module/meta/entity/media-data.entity.ts +32 -32
  252. package/src/module/meta/entity/preference.entity.ts +62 -62
  253. package/src/module/meta/entity/view-master.entity.ts +41 -41
  254. package/src/module/meta/entity.module.ts +158 -158
  255. package/src/module/meta/repository/app-master.repository.ts +20 -20
  256. package/src/module/meta/repository/attribute-master.repository.ts +118 -118
  257. package/src/module/meta/repository/entity-master.repository.ts +69 -69
  258. package/src/module/meta/repository/entity-table-column.repository.ts +39 -39
  259. package/src/module/meta/repository/entity-table.repository.ts +53 -53
  260. package/src/module/meta/repository/media-data.repository.ts +50 -50
  261. package/src/module/meta/repository/preference.repository.ts +20 -20
  262. package/src/module/meta/repository/user-app-mapping.repository.ts +28 -28
  263. package/src/module/meta/repository/view-master.repository.ts +42 -42
  264. package/src/module/meta/service/app-master.service.ts +37 -37
  265. package/src/module/meta/service/attribute-master.service.ts +126 -126
  266. package/src/module/meta/service/common.service.ts +9 -9
  267. package/src/module/meta/service/entity-dynamic.service.ts +819 -819
  268. package/src/module/meta/service/entity-list.service.ts +205 -205
  269. package/src/module/meta/service/entity-master.service.ts +169 -169
  270. package/src/module/meta/service/entity-realation-data.service.ts +9 -9
  271. package/src/module/meta/service/entity-relation.service.ts +69 -69
  272. package/src/module/meta/service/entity-service-impl.service.ts +525 -525
  273. package/src/module/meta/service/entity-table-column.service.ts +39 -39
  274. package/src/module/meta/service/entity-table.service.ts +150 -150
  275. package/src/module/meta/service/entity-validation.service.ts +187 -187
  276. package/src/module/meta/service/entity.service.ts +67 -67
  277. package/src/module/meta/service/field-group.service.ts +103 -103
  278. package/src/module/meta/service/media-data.service.ts +507 -507
  279. package/src/module/meta/service/populate-meta.service.ts +193 -193
  280. package/src/module/meta/service/preference.service.ts +16 -16
  281. package/src/module/meta/service/resolver.service.ts +267 -267
  282. package/src/module/meta/service/section-master.service.ts +104 -104
  283. package/src/module/meta/service/update-form-json.service.ts +22 -22
  284. package/src/module/meta/service/user-app-mapping.service.ts +17 -17
  285. package/src/module/meta/service/view-master.service.ts +127 -127
  286. package/src/module/microservice-client/microservice-clients.module.ts +13 -13
  287. package/src/module/microservice-client/service/microservice-client-factory.ts +37 -37
  288. package/src/module/microservice-client/service/microservice-clients.ts +4 -4
  289. package/src/module/module/controller/menu.controller.ts +15 -15
  290. package/src/module/module/controller/module-access.controller.ts +134 -134
  291. package/src/module/module/entity/menu.entity.ts +43 -43
  292. package/src/module/module/entity/module-access.entity.ts +25 -25
  293. package/src/module/module/entity/module-action.entity.ts +17 -17
  294. package/src/module/module/entity/module.entity.ts +52 -52
  295. package/src/module/module/module.module.ts +42 -42
  296. package/src/module/module/repository/menu.repository.ts +184 -184
  297. package/src/module/module/repository/module-access.repository.ts +344 -344
  298. package/src/module/module/service/menu.service.ts +82 -82
  299. package/src/module/module/service/module-access.service.ts +209 -209
  300. package/src/module/notification/controller/notification.controller.ts +58 -58
  301. package/src/module/notification/controller/otp.controller.ts +117 -117
  302. package/src/module/notification/entity/notification.entity.ts +26 -26
  303. package/src/module/notification/entity/otp.entity.ts +28 -28
  304. package/src/module/notification/firebase-admin.config.ts +22 -22
  305. package/src/module/notification/notification.module.ts +69 -69
  306. package/src/module/notification/repository/otp.repository.ts +27 -27
  307. package/src/module/notification/service/email.service.ts +127 -127
  308. package/src/module/notification/service/notification.service.ts +163 -163
  309. package/src/module/notification/service/otp.service.ts +132 -132
  310. package/src/module/third-party-module/entity/third-party-api-registry.entity.ts +52 -52
  311. package/src/module/third-party-module/repository/third-party-api-registry.repository.ts +20 -20
  312. package/src/module/third-party-module/service/api-registry.service.ts +13 -13
  313. package/src/module/third-party-module/third-party.module.ts +12 -12
  314. package/src/module/user/controller/login.controller.ts +197 -197
  315. package/src/module/user/controller/user.controller.ts +40 -40
  316. package/src/module/user/dto/create-user.dto.ts +62 -62
  317. package/src/module/user/dto/update-user.dto.ts +4 -4
  318. package/src/module/user/entity/role.entity.ts +33 -33
  319. package/src/module/user/entity/user-role-mapping.entity.ts +38 -38
  320. package/src/module/user/entity/user-session.entity.ts +73 -73
  321. package/src/module/user/entity/user.entity.ts +59 -59
  322. package/src/module/user/repository/role.repository.ts +96 -96
  323. package/src/module/user/repository/user-role-mapping.repository.ts +126 -126
  324. package/src/module/user/repository/user.repository.ts +50 -50
  325. package/src/module/user/repository/userSession.repository.ts +33 -33
  326. package/src/module/user/service/login.service.ts +304 -304
  327. package/src/module/user/service/role.service.ts +189 -189
  328. package/src/module/user/service/user-role-mapping.service.ts +98 -98
  329. package/src/module/user/service/user-session.service.ts +168 -168
  330. package/src/module/user/service/user.service.ts +365 -365
  331. package/src/module/user/user.module.ts +65 -65
  332. package/src/module/workflow/controller/action-category.controller.ts +54 -54
  333. package/src/module/workflow/controller/action-resource-mapping.controller.ts +23 -23
  334. package/src/module/workflow/controller/action-template-mapping.controller.ts +35 -35
  335. package/src/module/workflow/controller/action.controller.ts +111 -111
  336. package/src/module/workflow/controller/activity-log.controller.ts +55 -55
  337. package/src/module/workflow/controller/comm-template.controller.ts +43 -43
  338. package/src/module/workflow/controller/entity-modification.controller.ts +35 -35
  339. package/src/module/workflow/controller/form-master.controller.ts +43 -43
  340. package/src/module/workflow/controller/stage-group.controller.ts +48 -48
  341. package/src/module/workflow/controller/stage.controller.ts +50 -50
  342. package/src/module/workflow/controller/task.controller.ts +77 -77
  343. package/src/module/workflow/controller/workflow-list-master.controller.ts +44 -44
  344. package/src/module/workflow/controller/workflow-meta.controller.ts +80 -80
  345. package/src/module/workflow/controller/workflow.controller.ts +67 -67
  346. package/src/module/workflow/entity/action-category.entity.ts +38 -38
  347. package/src/module/workflow/entity/action-data.entity.ts +55 -55
  348. package/src/module/workflow/entity/action-resources-mapping.entity.ts +29 -29
  349. package/src/module/workflow/entity/action-template-mapping.entity.ts +17 -17
  350. package/src/module/workflow/entity/action.entity.ts +50 -50
  351. package/src/module/workflow/entity/activity-log.entity.ts +43 -43
  352. package/src/module/workflow/entity/comm-template.entity.ts +43 -43
  353. package/src/module/workflow/entity/entity-modification.entity.ts +38 -38
  354. package/src/module/workflow/entity/form.entity.ts +25 -25
  355. package/src/module/workflow/entity/stage-action-mapping.entity.ts +17 -17
  356. package/src/module/workflow/entity/stage-group.entity.ts +23 -23
  357. package/src/module/workflow/entity/stage-movement-data.entity.ts +38 -38
  358. package/src/module/workflow/entity/stage.entity.ts +20 -20
  359. package/src/module/workflow/entity/task-data.entity.ts +88 -88
  360. package/src/module/workflow/entity/template-attach-mapper.entity.ts +30 -30
  361. package/src/module/workflow/entity/workflow-data.entity.ts +11 -11
  362. package/src/module/workflow/entity/workflow-level-mapping.entity.ts +18 -18
  363. package/src/module/workflow/entity/workflow.entity.ts +20 -20
  364. package/src/module/workflow/repository/action-category.repository.ts +79 -79
  365. package/src/module/workflow/repository/action-data.repository.ts +333 -333
  366. package/src/module/workflow/repository/action.repository.ts +323 -323
  367. package/src/module/workflow/repository/activity-log.repository.ts +148 -148
  368. package/src/module/workflow/repository/comm-template.repository.ts +149 -149
  369. package/src/module/workflow/repository/form-master.repository.ts +59 -59
  370. package/src/module/workflow/repository/stage-group.repository.ts +176 -176
  371. package/src/module/workflow/repository/stage-movement.repository.ts +244 -244
  372. package/src/module/workflow/repository/stage.repository.ts +172 -172
  373. package/src/module/workflow/repository/task.repository.ts +134 -127
  374. package/src/module/workflow/repository/workflow.repository.ts +42 -42
  375. package/src/module/workflow/service/action-category.service.ts +33 -33
  376. package/src/module/workflow/service/action-data.service.ts +62 -62
  377. package/src/module/workflow/service/action-resources-mapping.service.ts +10 -10
  378. package/src/module/workflow/service/action-template-mapping.service.ts +106 -106
  379. package/src/module/workflow/service/action.service.ts +279 -279
  380. package/src/module/workflow/service/activity-log.service.ts +107 -107
  381. package/src/module/workflow/service/comm-template.service.ts +180 -180
  382. package/src/module/workflow/service/entity-modification.service.ts +67 -67
  383. package/src/module/workflow/service/form-master.service.ts +35 -35
  384. package/src/module/workflow/service/populate-workflow.service.ts +303 -303
  385. package/src/module/workflow/service/stage-action-mapping.service.ts +5 -5
  386. package/src/module/workflow/service/stage-group.service.ts +319 -319
  387. package/src/module/workflow/service/stage.service.ts +199 -199
  388. package/src/module/workflow/service/task.service.ts +547 -560
  389. package/src/module/workflow/service/workflow-list-master.service.ts +60 -60
  390. package/src/module/workflow/service/workflow-meta.service.ts +654 -640
  391. package/src/module/workflow/service/workflow.service.ts +205 -205
  392. package/src/module/workflow/workflow.module.ts +176 -176
  393. package/src/module/workflow-automation/controller/workflow-automation.controller.ts +21 -21
  394. package/src/module/workflow-automation/entity/workflow-automation-action.entity.ts +26 -26
  395. package/src/module/workflow-automation/entity/workflow-automation.entity.ts +35 -35
  396. package/src/module/workflow-automation/interface/action.decorator.ts +7 -7
  397. package/src/module/workflow-automation/interface/action.interface.ts +5 -5
  398. package/src/module/workflow-automation/service/action-registery.service.ts +35 -35
  399. package/src/module/workflow-automation/service/workflow-automation-engine.service.ts +214 -214
  400. package/src/module/workflow-automation/service/workflow-automation.service.ts +347 -347
  401. package/src/module/workflow-automation/workflow-automation.module.ts +34 -34
  402. package/src/resources/dev.properties.yaml +30 -31
  403. package/src/resources/local.properties.yaml +27 -27
  404. package/src/resources/properties.module.ts +12 -12
  405. package/src/resources/properties.yaml.ts +11 -11
  406. package/src/resources/uat.properties.yaml +31 -31
  407. package/src/table.config.ts +126 -126
  408. package/src/utils/dto/excel-data.dto.ts +14 -14
  409. package/src/utils/dto/excelsheet-data.dto.ts +5 -5
  410. package/src/utils/service/base64util.service.ts +18 -18
  411. package/src/utils/service/clockIDGenUtil.service.ts +21 -21
  412. package/src/utils/service/codeGenerator.service.ts +22 -22
  413. package/src/utils/service/dateUtil.service.ts +17 -17
  414. package/src/utils/service/encryptUtil.service.ts +97 -97
  415. package/src/utils/service/excel-helper.service.ts +72 -72
  416. package/src/utils/service/excelUtil.service.ts +15 -15
  417. package/src/utils/service/file-util.service.ts +11 -11
  418. package/src/utils/service/json-util.service.ts +23 -23
  419. package/src/utils/service/loggingUtil.service.ts +88 -34
  420. package/src/utils/service/reflection-helper.service.ts +62 -62
  421. package/src/utils/service/wbsCodeGen.service.ts +8 -8
  422. package/src/utils/utils.module.ts +27 -25
  423. package/tsconfig.build.json +4 -4
  424. package/tsconfig.json +24 -24
  425. package/.claude/settings.local.json +0 -26
  426. package/.idea/250218_nodejs_core.iml +0 -9
  427. package/.idea/codeStyles/Project.xml +0 -59
  428. package/.idea/codeStyles/codeStyleConfig.xml +0 -5
  429. package/.idea/copilot.data.migration.agent.xml +0 -6
  430. package/.idea/copilot.data.migration.ask.xml +0 -6
  431. package/.idea/copilot.data.migration.ask2agent.xml +0 -6
  432. package/.idea/copilot.data.migration.edit.xml +0 -6
  433. package/.idea/inspectionProfiles/Project_Default.xml +0 -6
  434. package/.idea/misc.xml +0 -6
  435. package/.idea/modules.xml +0 -8
  436. package/.idea/prettier.xml +0 -6
  437. package/.idea/vcs.xml +0 -6
  438. package/server.log +0 -850
@@ -1,4 +1,11 @@
1
+ import { ConfigService } from '@nestjs/config';
1
2
  export declare class LoggingService {
2
- constructor();
3
- log(level: string, serviceName: string, methodName: string, message: string, parameters?: unknown[], debuginfo?: unknown[]): Promise<void>;
3
+ private readonly configService;
4
+ private readonly logger;
5
+ private readonly graylogUrl;
6
+ private readonly environment;
7
+ constructor(configService: ConfigService);
8
+ log(level: string, serviceName: string, methodName: string, message: string, parameters?: unknown[], debugInfo?: unknown[]): Promise<void>;
9
+ private sendToGraylog;
10
+ private mapLogLevel;
4
11
  }
@@ -8,29 +8,80 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
8
8
  var __metadata = (this && this.__metadata) || function (k, v) {
9
9
  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
10
  };
11
+ var LoggingService_1;
11
12
  Object.defineProperty(exports, "__esModule", { value: true });
12
13
  exports.LoggingService = void 0;
13
14
  const common_1 = require("@nestjs/common");
14
- let LoggingService = class LoggingService {
15
- constructor() { }
16
- async log(level, serviceName, methodName, message, parameters, debuginfo) {
17
- const levelInfo = level.toLowerCase().trim();
18
- const logger = new common_1.Logger(serviceName);
19
- const logMessage = `${methodName} : ${message} : Parameters :${JSON.stringify(parameters)}: Debug Info: ${JSON.stringify(debuginfo)}`;
20
- if (levelInfo === 'debug' || levelInfo === 'info') {
21
- logger.debug(logMessage);
15
+ const config_1 = require("@nestjs/config");
16
+ const axios_1 = require("axios");
17
+ let LoggingService = LoggingService_1 = class LoggingService {
18
+ constructor(configService) {
19
+ this.configService = configService;
20
+ this.logger = new common_1.Logger(LoggingService_1.name);
21
+ this.graylogUrl =
22
+ this.configService.get('GRAYLOG_URL') ||
23
+ 'http://localhost:12201/gelf';
24
+ this.environment = this.configService.get('PROFILE') || 'dev';
25
+ }
26
+ async log(level, serviceName, methodName, message, parameters, debugInfo) {
27
+ const logLevel = level.toLowerCase().trim();
28
+ const logMessage = `${serviceName}.${methodName}: ${message} | Params: ${JSON.stringify(parameters)} | Debug: ${JSON.stringify(debugInfo)}`;
29
+ switch (logLevel) {
30
+ case 'debug':
31
+ case 'info':
32
+ this.logger.debug(logMessage);
33
+ break;
34
+ case 'warn':
35
+ this.logger.warn(logMessage);
36
+ break;
37
+ case 'error':
38
+ this.logger.error(logMessage);
39
+ break;
40
+ default:
41
+ this.logger.log(logMessage);
22
42
  }
23
- else if (levelInfo === 'error') {
24
- logger.error(logMessage);
43
+ this.sendToGraylog({
44
+ version: '1.1',
45
+ host: serviceName || 'nestjs-app',
46
+ short_message: message,
47
+ full_message: logMessage,
48
+ level: this.mapLogLevel(logLevel),
49
+ _service: serviceName,
50
+ _method: methodName,
51
+ _parameters: parameters,
52
+ _debug: debugInfo,
53
+ _environment: this.environment,
54
+ timestamp: Date.now() / 1000,
55
+ });
56
+ }
57
+ async sendToGraylog(payload) {
58
+ try {
59
+ await axios_1.default.post(this.graylogUrl, payload, {
60
+ headers: { 'Content-Type': 'application/json' },
61
+ timeout: 2000,
62
+ });
25
63
  }
26
- else {
27
- logger.log(logMessage);
64
+ catch (err) {
65
+ this.logger.warn(`Graylog send failed: ${err.message}`);
28
66
  }
29
67
  }
68
+ mapLogLevel(level) {
69
+ const mapping = {
70
+ emerg: 0,
71
+ alert: 1,
72
+ crit: 2,
73
+ error: 3,
74
+ warn: 4,
75
+ notice: 5,
76
+ info: 6,
77
+ debug: 7,
78
+ };
79
+ return mapping[level] ?? 6;
80
+ }
30
81
  };
31
82
  exports.LoggingService = LoggingService;
32
- exports.LoggingService = LoggingService = __decorate([
83
+ exports.LoggingService = LoggingService = LoggingService_1 = __decorate([
33
84
  (0, common_1.Injectable)(),
34
- __metadata("design:paramtypes", [])
85
+ __metadata("design:paramtypes", [config_1.ConfigService])
35
86
  ], LoggingService);
36
87
  //# sourceMappingURL=loggingUtil.service.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"loggingUtil.service.js","sourceRoot":"","sources":["../../../src/utils/service/loggingUtil.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAoD;AAG7C,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,gBAAe,CAAC;IAEhB,KAAK,CAAC,GAAG,CACP,KAAa,EACb,WAAmB,EACnB,UAAkB,EAClB,OAAe,EACf,UAAsB,EACtB,SAAqB;QAErB,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,WAAW,CAAC,CAAC;QAGvC,MAAM,UAAU,GAAG,GAAG,UAAU,MAAM,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAC3E,UAAU,CACX,iBAAiB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAE9C,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YAEN,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IAGH,CAAC;CACF,CAAA;AA9BY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;;GACA,cAAc,CA8B1B"}
1
+ {"version":3,"file":"loggingUtil.service.js","sourceRoot":"","sources":["../../../src/utils/service/loggingUtil.service.ts"],"names":[],"mappings":"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"}
@@ -51,8 +51,8 @@ let ReflectionHelper = class ReflectionHelper {
51
51
  }
52
52
  }
53
53
  async getEntityData(id, tableName) {
54
- const entityList = await this.dataSource.query(`SELECT *
55
- FROM ${tableName}
54
+ const entityList = await this.dataSource.query(`SELECT *
55
+ FROM ${tableName}
56
56
  WHERE id = ?`, [id]);
57
57
  return entityList.length > 0 ? entityList[0] : null;
58
58
  }
@@ -13,12 +13,14 @@ const reflection_helper_service_1 = require("./service/reflection-helper.service
13
13
  const excelUtil_service_1 = require("./service/excelUtil.service");
14
14
  const clockIDGenUtil_service_1 = require("./service/clockIDGenUtil.service");
15
15
  const wbsCodeGen_service_1 = require("./service/wbsCodeGen.service");
16
+ const config_1 = require("@nestjs/config");
16
17
  let UtilsModule = class UtilsModule {
17
18
  };
18
19
  exports.UtilsModule = UtilsModule;
19
20
  exports.UtilsModule = UtilsModule = __decorate([
20
21
  (0, common_1.Global)(),
21
22
  (0, common_1.Module)({
23
+ imports: [config_1.ConfigModule],
22
24
  providers: [
23
25
  loggingUtil_service_1.LoggingService,
24
26
  reflection_helper_service_1.ReflectionHelper,
@@ -1 +1 @@
1
- {"version":3,"file":"utils.module.js","sourceRoot":"","sources":["../../src/utils/utils.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,uEAA+D;AAC/D,mFAAuE;AACvE,mEAAwD;AACxD,6EAAqE;AACrE,qEAAiE;AAmB1D,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IAjBvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE;YACT,oCAAc;YACd,4CAAgB;YAChB,6BAAS;YACT,0CAAiB;YACjB,sCAAiB;SAClB;QACD,OAAO,EAAE;YACP,oCAAc;YACd,4CAAgB;YAChB,6BAAS;YACT,0CAAiB;YACjB,sCAAiB;SAClB;KACF,CAAC;GACW,WAAW,CAAG"}
1
+ {"version":3,"file":"utils.module.js","sourceRoot":"","sources":["../../src/utils/utils.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,uEAA+D;AAC/D,mFAAuE;AACvE,mEAAwD;AACxD,6EAAqE;AACrE,qEAAiE;AACjE,2CAA8C;AAoBvC,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IAlBvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,CAAC;QACvB,SAAS,EAAE;YACT,oCAAc;YACd,4CAAgB;YAChB,6BAAS;YACT,0CAAiB;YACjB,sCAAiB;SAClB;QACD,OAAO,EAAE;YACP,oCAAc;YACd,4CAAgB;YAChB,6BAAS;YACT,0CAAiB;YACjB,sCAAiB;SAClB;KACF,CAAC;GACW,WAAW,CAAG"}
@@ -1,92 +1,92 @@
1
- # Event-Driven Integration Module Design (NestJS)
2
-
3
- ## 1. Goal
4
- Introduce **Event-Driven Architecture (EDA)** into the integration module to:
5
- - Decouple producers (e.g., order service, user service) from message delivery logic.
6
- - Support asynchronous message processing, retries, and multi-level fallback.
7
- - Allow smooth transition from in-memory events to external brokers like Kafka or RabbitMQ.
8
-
9
- ---
10
-
11
- ## 2. Current State
12
- - **Database Tables**:
13
- - `frm_integration_config` (stores provider configuration JSON and level mapping)
14
- - **Factory Pattern**:
15
- - Uses `IntegrationFactory` to select strategies (e.g., Gmail API, Twilio SMS, WhatsApp Cloud).
16
- - **Service Layer**:
17
- - Provides methods for sending messages (generic and type-specific).
18
- - Currently invoked directly by producers.
19
- - **Fallback Hierarchy**:
20
- - Resolution order: user → team → project → department → organization.
21
-
22
- ### Limitation
23
- - Tight coupling between producers and `IntegrationService`.
24
- - Direct synchronous calls, no retry or async pipeline.
25
- - Fallback handled procedurally inside service.
26
-
27
- ---
28
-
29
- ## 3. Event-Driven Proposal
30
-
31
- ### Core Events
32
- - **IntegrationRequestedEvent** → emitted whenever any module requests integration.
33
- - **IntegrationSuccessEvent** → emitted when delivery succeeds.
34
- - **IntegrationFailedEvent** → emitted when delivery fails.
35
- - **FallbackRequestedEvent** → emitted when a level-specific config fails, triggering retry with the next fallback level.
36
-
37
- ### Event Flow
38
- 1. A producer (e.g., order service) emits a `IntegrationRequestedEvent`.
39
- 2. The integration module listens for this event.
40
- 3. Delivery attempt is made using the factory and service layer.
41
- 4. Depending on outcome:
42
- - Success → emit `IntegrationSuccessEvent`.
43
- - Failure → emit `IntegrationFailedEvent`.
44
- 5. If failure is due to invalid or unavailable provider, emit `FallbackRequestedEvent` and retry at the next level in hierarchy.
45
- 6. Outcome events (`success`/`failed`) can be consumed by analytics, logging, monitoring, or retry queues.
46
-
47
- ---
48
-
49
- ## 4. Components
50
-
51
- ### Event Producers
52
- - Any module in the system (order, billing, onboarding, etc.) can raise integration requests without depending on the integration module.
53
-
54
- ### Event Handlers
55
- - Dedicated handlers inside the integration module react to request events, coordinate with the factory and service layer, and trigger outcome events.
56
-
57
- ### Subscribers
58
- - Separate subscribers for success/failure events handle logging, retries, notifications, and analytics.
59
-
60
- ---
61
-
62
- ## 5. Multi-Level Fallback
63
- - Instead of handling fallback inside the service, use chained events.
64
- - When one provider fails, emit a `FallbackRequestedEvent` with the next priority level.
65
- - A fallback handler retries delivery using the new configuration.
66
- - This continues until a provider succeeds or the lowest-level configuration (organization) fails.
67
-
68
- ---
69
-
70
- ## 6. Module Wiring
71
- - Use NestJS `EventEmitterModule` or `@nestjs/cqrs` for in-memory event handling.
72
- - Define event classes and handlers within the integration module.
73
- - Export the integration module to make it available across the application.
74
- - Future enhancement: swap in-memory event emitter with Kafka, RabbitMQ, or Redis for distributed systems.
75
-
76
- ---
77
-
78
- ## 7. Benefits
79
- - **Loose coupling**: Producers only emit events, no dependency on the integration module.
80
- - **Resilience**: Fallback and retries managed via events rather than procedural logic.
81
- - **Scalability**: Easy to extend with new providers or migrate to distributed event brokers.
82
- - **Observability**: Success and failure events provide clear audit trails.
83
- - **Future-proof**: In-memory implementation today, external broker tomorrow without major refactor.
84
-
85
- ---
86
-
87
- ## 8. Next Steps
88
- 1. Define event classes and event bus integration.
89
- 2. Implement core handlers for request, success, failure, and fallback.
90
- 3. Add subscribers for logging and monitoring.
91
- 4. Extend fallback logic into event-driven retry mechanism.
1
+ # Event-Driven Integration Module Design (NestJS)
2
+
3
+ ## 1. Goal
4
+ Introduce **Event-Driven Architecture (EDA)** into the integration module to:
5
+ - Decouple producers (e.g., order service, user service) from message delivery logic.
6
+ - Support asynchronous message processing, retries, and multi-level fallback.
7
+ - Allow smooth transition from in-memory events to external brokers like Kafka or RabbitMQ.
8
+
9
+ ---
10
+
11
+ ## 2. Current State
12
+ - **Database Tables**:
13
+ - `frm_integration_config` (stores provider configuration JSON and level mapping)
14
+ - **Factory Pattern**:
15
+ - Uses `IntegrationFactory` to select strategies (e.g., Gmail API, Twilio SMS, WhatsApp Cloud).
16
+ - **Service Layer**:
17
+ - Provides methods for sending messages (generic and type-specific).
18
+ - Currently invoked directly by producers.
19
+ - **Fallback Hierarchy**:
20
+ - Resolution order: user → team → project → department → organization.
21
+
22
+ ### Limitation
23
+ - Tight coupling between producers and `IntegrationService`.
24
+ - Direct synchronous calls, no retry or async pipeline.
25
+ - Fallback handled procedurally inside service.
26
+
27
+ ---
28
+
29
+ ## 3. Event-Driven Proposal
30
+
31
+ ### Core Events
32
+ - **IntegrationRequestedEvent** → emitted whenever any module requests integration.
33
+ - **IntegrationSuccessEvent** → emitted when delivery succeeds.
34
+ - **IntegrationFailedEvent** → emitted when delivery fails.
35
+ - **FallbackRequestedEvent** → emitted when a level-specific config fails, triggering retry with the next fallback level.
36
+
37
+ ### Event Flow
38
+ 1. A producer (e.g., order service) emits a `IntegrationRequestedEvent`.
39
+ 2. The integration module listens for this event.
40
+ 3. Delivery attempt is made using the factory and service layer.
41
+ 4. Depending on outcome:
42
+ - Success → emit `IntegrationSuccessEvent`.
43
+ - Failure → emit `IntegrationFailedEvent`.
44
+ 5. If failure is due to invalid or unavailable provider, emit `FallbackRequestedEvent` and retry at the next level in hierarchy.
45
+ 6. Outcome events (`success`/`failed`) can be consumed by analytics, logging, monitoring, or retry queues.
46
+
47
+ ---
48
+
49
+ ## 4. Components
50
+
51
+ ### Event Producers
52
+ - Any module in the system (order, billing, onboarding, etc.) can raise integration requests without depending on the integration module.
53
+
54
+ ### Event Handlers
55
+ - Dedicated handlers inside the integration module react to request events, coordinate with the factory and service layer, and trigger outcome events.
56
+
57
+ ### Subscribers
58
+ - Separate subscribers for success/failure events handle logging, retries, notifications, and analytics.
59
+
60
+ ---
61
+
62
+ ## 5. Multi-Level Fallback
63
+ - Instead of handling fallback inside the service, use chained events.
64
+ - When one provider fails, emit a `FallbackRequestedEvent` with the next priority level.
65
+ - A fallback handler retries delivery using the new configuration.
66
+ - This continues until a provider succeeds or the lowest-level configuration (organization) fails.
67
+
68
+ ---
69
+
70
+ ## 6. Module Wiring
71
+ - Use NestJS `EventEmitterModule` or `@nestjs/cqrs` for in-memory event handling.
72
+ - Define event classes and handlers within the integration module.
73
+ - Export the integration module to make it available across the application.
74
+ - Future enhancement: swap in-memory event emitter with Kafka, RabbitMQ, or Redis for distributed systems.
75
+
76
+ ---
77
+
78
+ ## 7. Benefits
79
+ - **Loose coupling**: Producers only emit events, no dependency on the integration module.
80
+ - **Resilience**: Fallback and retries managed via events rather than procedural logic.
81
+ - **Scalability**: Easy to extend with new providers or migrate to distributed event brokers.
82
+ - **Observability**: Success and failure events provide clear audit trails.
83
+ - **Future-proof**: In-memory implementation today, external broker tomorrow without major refactor.
84
+
85
+ ---
86
+
87
+ ## 8. Next Steps
88
+ 1. Define event classes and event bus integration.
89
+ 2. Implement core handlers for request, success, failure, and fallback.
90
+ 3. Add subscribers for logging and monitoring.
91
+ 4. Extend fallback logic into event-driven retry mechanism.
92
92
  5. Plan for integration with Kafka/RabbitMQ for production scalability.