@futdevpro/nts-dynamo 1.15.38 → 1.15.40

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 (338) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/logs/cicd-pipeline/output.log +2567 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +319 -0
  18. package/.github/workflows/main.yml +432 -432
  19. package/.vscode/settings.json +10 -10
  20. package/HOWTO.md +15 -15
  21. package/LICENSE +21 -21
  22. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  23. package/_specifications/BACKLOG.md +92 -92
  24. package/_specifications/TODO.md +15 -15
  25. package/_specifications/agent.md +138 -138
  26. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts +6 -0
  27. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts.map +1 -1
  28. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js +25 -7
  29. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js.map +1 -1
  30. package/build/_modules/ai/_services/ai-llm.service-base.d.ts.map +1 -1
  31. package/build/_modules/ai/_services/ai-llm.service-base.js +7 -0
  32. package/build/_modules/ai/_services/ai-llm.service-base.js.map +1 -1
  33. package/build/_modules/server/errors/errors.control-service.d.ts +1 -0
  34. package/build/_modules/server/errors/errors.control-service.d.ts.map +1 -1
  35. package/build/_modules/server/errors/errors.control-service.js.map +1 -1
  36. package/build/_modules/server/errors/errors.controller.d.ts.map +1 -1
  37. package/build/_modules/server/errors/errors.controller.js +19 -1
  38. package/build/_modules/server/errors/errors.controller.js.map +1 -1
  39. package/build/_modules/server/errors/errors.data-service.d.ts +7 -0
  40. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  41. package/build/_modules/server/errors/errors.data-service.js +31 -0
  42. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  43. package/eslint.config.js +3 -3
  44. package/nodemon.json +24 -24
  45. package/package.json +2 -2
  46. package/pnpm-workspace.yaml +8 -7
  47. package/scripts/run-coverage-tests.js +28 -28
  48. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  49. package/spec/support/helpers/ts-node-helper.js +93 -93
  50. package/spec/support/jasmine.coverage.json +24 -24
  51. package/spec/support/jasmine.json +24 -24
  52. package/src/_collections/archive.util.spec.ts +57 -57
  53. package/src/_collections/archive.util.ts +18 -18
  54. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  55. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  56. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  57. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  58. package/src/_collections/default-not-found-page.const.ts +22 -22
  59. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  60. package/src/_collections/default-socket-path.const.ts +2 -2
  61. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  62. package/src/_collections/get-environment-settings.util.ts +48 -48
  63. package/src/_collections/sample.env +21 -21
  64. package/src/_collections/star.controller.spec.ts +224 -224
  65. package/src/_collections/star.controller.ts +129 -129
  66. package/src/_enums/data-model-type.enum.ts +14 -14
  67. package/src/_enums/data-service-function.enum.ts +24 -24
  68. package/src/_enums/predefined-data-types.enum.ts +16 -16
  69. package/src/_enums/route-security.enum.ts +12 -12
  70. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  71. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  72. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  73. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  74. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  75. package/src/_models/control-models/app-params.control-model.ts +136 -136
  76. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  77. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  78. package/src/_models/control-models/endpoint-params.control-model.spec.ts +578 -578
  79. package/src/_models/control-models/endpoint-params.control-model.ts +526 -526
  80. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  81. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  82. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  83. package/src/_models/control-models/system-control.control-model.ts +12 -12
  84. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  85. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  86. package/src/_models/interfaces/global-log-settings.interface.ts +144 -144
  87. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  88. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  89. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  90. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  91. package/src/_models/types/db-update.type.ts +100 -100
  92. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  93. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  94. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  95. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  96. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  97. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  98. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  99. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  100. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  101. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  102. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  103. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  104. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  105. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  106. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  107. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  108. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  109. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  110. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  111. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  112. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  113. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  114. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  115. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  116. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  117. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  118. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  119. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  120. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  121. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  122. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  123. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  124. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  125. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -106
  126. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1011
  127. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  128. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  129. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  130. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  131. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  132. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  133. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -510
  134. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  135. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  136. package/src/_modules/ai/index.ts +13 -13
  137. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  138. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  139. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  140. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  141. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  142. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  143. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  144. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  145. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  146. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  147. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  148. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  149. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  150. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  151. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  152. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  153. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  154. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  155. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  156. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  157. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  158. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  159. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  160. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  161. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  162. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  163. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  164. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  165. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  166. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  167. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  168. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  169. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  170. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  171. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  172. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  173. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  174. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  175. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  176. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  177. package/src/_modules/custom-data/index.ts +9 -9
  178. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  179. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  180. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  181. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  182. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  183. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  184. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  185. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  186. package/src/_modules/defaults/index.ts +17 -17
  187. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  188. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  189. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  190. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  191. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  192. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  193. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  194. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  195. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  196. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  197. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  198. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  199. package/src/_modules/discord-assistant/index.ts +38 -38
  200. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  201. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  202. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  203. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  204. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  205. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  206. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  207. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  208. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  209. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  210. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  211. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  212. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  213. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  214. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  215. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  216. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  217. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  218. package/src/_modules/discord-bot/index.ts +36 -36
  219. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  220. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  221. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  222. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  223. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  224. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  225. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  226. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  227. package/src/_modules/local-vector-search/index.ts +11 -11
  228. package/src/_modules/messaging/README.md +354 -354
  229. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  230. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  231. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  232. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  233. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  234. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  235. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  236. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  237. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  238. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  239. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  240. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  241. package/src/_modules/messaging/index.ts +30 -30
  242. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  243. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  244. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  245. package/src/_modules/mock/app-params.mock.ts +9 -9
  246. package/src/_modules/mock/app-server.mock.ts +188 -188
  247. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  248. package/src/_modules/mock/auth-service.mock.ts +28 -28
  249. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  250. package/src/_modules/mock/controller.mock.ts +16 -16
  251. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  252. package/src/_modules/mock/data-model.mock.ts +82 -82
  253. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  254. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  255. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  256. package/src/_modules/mock/email-service.mock.ts +20 -20
  257. package/src/_modules/mock/email-template.mock.html +14 -14
  258. package/src/_modules/mock/endpoint.mock.ts +91 -91
  259. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  260. package/src/_modules/mock/socket-client.mock.ts +45 -45
  261. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  262. package/src/_modules/mock/socket-server.mock.ts +46 -46
  263. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  264. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  265. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  266. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  267. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  268. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  269. package/src/_modules/oauth2/index.ts +17 -17
  270. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -234
  271. package/src/_modules/server/errors/errors.control-service.ts +85 -77
  272. package/src/_modules/server/errors/errors.controller.spec.ts +241 -238
  273. package/src/_modules/server/errors/errors.controller.ts +431 -402
  274. package/src/_modules/server/errors/errors.data-service.spec.ts +355 -355
  275. package/src/_modules/server/errors/errors.data-service.ts +48 -6
  276. package/src/_modules/server/index.ts +30 -30
  277. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  278. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  279. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  280. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  281. package/src/_modules/server/server-status/server-status.control-service.spec.ts +524 -520
  282. package/src/_modules/server/server-status/server-status.control-service.ts +336 -336
  283. package/src/_modules/server/server-status/server-status.controller.spec.ts +162 -159
  284. package/src/_modules/server/server-status/server-status.controller.ts +131 -131
  285. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  286. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  287. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  288. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  289. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  290. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  291. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  292. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  293. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  294. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  295. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  296. package/src/_modules/socket/app-extended.server.ts +630 -630
  297. package/src/_modules/socket/index.ts +42 -42
  298. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  299. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  300. package/src/_modules/test/index.ts +11 -11
  301. package/src/_modules/test/test.controller.spec.ts +72 -72
  302. package/src/_modules/test/test.controller.ts +115 -115
  303. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  304. package/src/_modules/usage/index.ts +15 -15
  305. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  306. package/src/_modules/usage/usage.controller.ts +126 -126
  307. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  308. package/src/_modules/usage/usage.data-service.ts +185 -185
  309. package/src/_services/base/api.service-base.spec.ts +125 -125
  310. package/src/_services/base/api.service-base.ts +74 -74
  311. package/src/_services/base/archive-data.service.spec.ts +196 -196
  312. package/src/_services/base/archive-data.service.ts +216 -216
  313. package/src/_services/base/data.service.spec.ts +674 -674
  314. package/src/_services/base/data.service.ts +2719 -2719
  315. package/src/_services/base/db.service.spec.ts +73 -73
  316. package/src/_services/base/db.service.ts +1575 -1575
  317. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  318. package/src/_services/base/singleton.service-base.ts +24 -24
  319. package/src/_services/base/singleton.service.spec.ts +114 -114
  320. package/src/_services/base/singleton.service.ts +38 -38
  321. package/src/_services/core/api.service.spec.ts +140 -140
  322. package/src/_services/core/auth.service.spec.ts +159 -159
  323. package/src/_services/core/auth.service.ts +174 -174
  324. package/src/_services/core/email.service.spec.ts +85 -85
  325. package/src/_services/core/email.service.ts +742 -742
  326. package/src/_services/core/global.service.spec.ts +275 -275
  327. package/src/_services/core/global.service.ts +461 -461
  328. package/src/_services/core/service-collection.service.spec.ts +46 -46
  329. package/src/_services/core/service-collection.service.ts +6 -6
  330. package/src/_services/route/controller.service.spec.ts +53 -53
  331. package/src/_services/route/controller.service.ts +148 -148
  332. package/src/_services/route/routing-module.service.spec.ts +98 -98
  333. package/src/_services/route/routing-module.service.ts +330 -330
  334. package/src/_services/shared.static-service.spec.ts +99 -99
  335. package/src/_services/shared.static-service.ts +78 -78
  336. package/src/index.ts +95 -95
  337. package/tsconfig.app.json +12 -12
  338. package/tsconfig.json +42 -42
@@ -1,402 +1,431 @@
1
-
2
- import { Request, Response } from 'express';
3
-
4
- import { DyFM_Array, DyFM_Error, DyFM_HttpCallType, DyFM_Errors, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
5
- import { DyNTS_Controller } from '../../../_services/route/controller.service';
6
- import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
7
- import { DyNTS_Errors_ControlService } from './errors.control-service';
8
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
9
-
10
-
11
- /**
12
- * Auth retrofit config a `DyNTS_Errors_Controller`-hez. Opt-in — ha az
13
- * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli)
14
- * viselkedest tartja.
15
- *
16
- * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract
17
- * osztaly minden subclass-a kozott OSZTOTT. Ha tobb subclass-od van kulonbozo
18
- * policy-val, hivd a `configure()`-t a megfelelo subclasson — TypeScript a
19
- * static field-eket per-class hatarozza meg.
20
- */
21
- export interface DyNTS_ErrorsController_AuthConfig {
22
- /**
23
- * Pre-process fuggveny ami minden vedett endpoint elott fut. Tipikusan:
24
- * `DyNTS_AdminApiKey_AuthService.getInstance().verify`.
25
- *
26
- * Ha hianyzik vagy `undefined`, a controller NEM ad hozza auth-ot semelyik
27
- * endpoint-hoz (regi viselkedes, opt-in safety).
28
- */
29
- authPreProcess?: (req: Request, res: Response) => Promise<void>;
30
-
31
- /**
32
- * Vedett endpoint nevek listaja. Ha hianyzik, az osszes 8 endpoint vedett
33
- * (`authPreProcess` jelenleteben).
34
- *
35
- * Endpoint nevek: 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
36
- * 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors'.
37
- */
38
- protectedEndpoints?: string[];
39
- }
40
-
41
-
42
- /**
43
- * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
44
- * default-jat es a config validacio-t segiti.
45
- */
46
- const ALL_ENDPOINT_NAMES: string[] = [
47
- 'logError', 'newError',
48
- 'markErrorDone', 'markAllErrorDone',
49
- 'recordFixAttempt',
50
- 'getErrors', 'getErrorsPaged', 'getLastErrors',
51
- 'searchErrors',
52
- ];
53
-
54
- /**
55
- * Endpoints:
56
- *
57
- * logError
58
- * POST /error/log
59
- *
60
- * markErrorDone
61
- * GET /error/mark-done/:errorId
62
- *
63
- * markAllErrorDone
64
- * GET /error/mark-all-done
65
- *
66
- * getErrors
67
- * GET /error/get-range/:range
68
- *
69
- * getErrorsPaged
70
- * GET /error/get-paged/:range/:pageSize/:pageIndex
71
- *
72
- * getLastErrors
73
- * GET /error/get-last-paged/:range/:pageSize/:pageIndex
74
- *
75
- *
76
- */
77
- // Documentation:
78
- // Local: [MD](./errors.md)
79
- //
80
- export abstract class DyNTS_Errors_Controller<
81
- T_Error extends DyFM_Error,
82
- T_Errors extends DyFM_Errors<T_Error>,
83
- T_Error_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>
84
- > extends DyNTS_Controller {
85
-
86
- /* static getInstance(): DyNTS_Error_Controller {
87
- return DyNTS_Error_Controller.getSingletonInstance();
88
- } */
89
-
90
- /* protected abstract errorDataService: DyNTS_Error_DataService<T_Error>; */
91
- protected abstract getError_ControlService(
92
- set: { data?: T_Error, issuer: string }
93
- ): T_Error_ControlService;
94
- protected readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
95
-
96
- /**
97
- * Static auth config — opt-in retrofit. Default ures objektum → NO auth
98
- * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
99
- */
100
- protected static authConfig: DyNTS_ErrorsController_AuthConfig = {};
101
-
102
- /**
103
- * Static config setter. Hivhato barmikor a szerver startup-jan az endpoint
104
- * registration ELOTT.
105
- *
106
- * Use case (host app):
107
- * ```ts
108
- * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
109
- * DyNTS_Errors_Controller.configure({ authPreProcess: adminAuth.verify });
110
- * // vagy fine-grained:
111
- * DyNTS_Errors_Controller.configure({
112
- * authPreProcess: adminAuth.verify,
113
- * protectedEndpoints: ['markAllErrorDone', 'logError'],
114
- * });
115
- * ```
116
- */
117
- static configure(config: DyNTS_ErrorsController_AuthConfig): void {
118
- DyNTS_Errors_Controller.authConfig = config;
119
- }
120
-
121
- /**
122
- * Aktualis auth config olvasasa (test/diagnosztika celokra).
123
- */
124
- static getAuthConfig(): DyNTS_ErrorsController_AuthConfig {
125
- return DyNTS_Errors_Controller.authConfig;
126
- }
127
-
128
- /**
129
- * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
130
- */
131
- static _resetAuthConfigForTesting(): void {
132
- DyNTS_Errors_Controller.authConfig = {};
133
- }
134
-
135
- /**
136
- * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
137
- * Ha az auth NINCS configurolva (default) vagy az endpoint nincs a
138
- * `protectedEndpoints` listan, ures array-t ad vissza.
139
- */
140
- protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
141
- const cfg: DyNTS_ErrorsController_AuthConfig = DyNTS_Errors_Controller.authConfig;
142
- if (!cfg.authPreProcess) { return []; }
143
- const protectedNames: string[] = cfg.protectedEndpoints ?? ALL_ENDPOINT_NAMES;
144
- return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
145
- }
146
-
147
- setupEndpoints(): void {
148
- /* if (!this.getErrorDataService) {
149
- throw new DyFM_Error({
150
- message: 'getUserDataService() method not implemented in Error_Controller.',
151
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-001`,
152
- });
153
- } */
154
-
155
- if (!this.additionalEndpoints) {
156
- throw new DyFM_Error({
157
- message: 'additionalEndpoints must be defined in Error_Controller.',
158
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-002`,
159
- });
160
- }
161
-
162
- this.endpoints = [
163
- new DyNTS_Endpoint_Params({
164
- name: 'logError',
165
- type: DyFM_HttpCallType.post,
166
- endpoint: '/error/log',
167
- preProcesses: this.getPreProcessesFor('logError'),
168
- tasks: [
169
- async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
170
- const error_CS: T_Error_ControlService = this.getError_ControlService({
171
- issuer,
172
- });
173
-
174
- await error_CS.recordError(req.body, issuer);
175
-
176
- res.send({
177
- result: 'error logged',
178
- });
179
- },
180
- ],
181
- }),
182
- new DyNTS_Endpoint_Params({
183
- name: 'newError',
184
- type: DyFM_HttpCallType.post,
185
- endpoint: '/error/new',
186
- preProcesses: this.getPreProcessesFor('newError'),
187
- tasks: [
188
- async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
189
- const error_CS: T_Error_ControlService = this.getError_ControlService({
190
- issuer,
191
- });
192
-
193
- await error_CS.recordError(req.body, issuer);
194
-
195
- res.send({
196
- result: 'error logged',
197
- });
198
- },
199
- ],
200
- }),
201
-
202
- new DyNTS_Endpoint_Params({
203
- name: 'markErrorDone',
204
- type: DyFM_HttpCallType.get,
205
- endpoint: '/error/mark-done/:errorId',
206
- preProcesses: this.getPreProcessesFor('markErrorDone'),
207
- tasks: [
208
- async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
209
- const error_CS: T_Error_ControlService = this.getError_ControlService({
210
- issuer,
211
- });
212
-
213
- await error_CS.deleteError(req.params.errorId, issuer, true);
214
-
215
- res.send({
216
- result: 'error deleted',
217
- });
218
- },
219
- ],
220
- }),
221
-
222
- new DyNTS_Endpoint_Params({
223
- name: 'markAllErrorDone',
224
- type: DyFM_HttpCallType.get,
225
- endpoint: '/error/mark-all-done',
226
- preProcesses: this.getPreProcessesFor('markAllErrorDone'),
227
- tasks: [
228
- async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
229
- const error_CS: T_Error_ControlService = this.getError_ControlService({
230
- issuer,
231
- });
232
-
233
- await error_CS.deleteAllErrors(issuer, true);
234
-
235
- res.send({
236
- result: 'all error deleted',
237
- });
238
- },
239
- ],
240
- }),
241
-
242
- new DyNTS_Endpoint_Params({
243
- name: 'recordFixAttempt',
244
- type: DyFM_HttpCallType.post,
245
- endpoint: '/error/:errorId/fix-attempt',
246
- preProcesses: this.getPreProcessesFor('recordFixAttempt'),
247
- tasks: [
248
- async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
249
- const errorId: string = req.params.errorId;
250
- const version: string = req.body?.version;
251
- const hypothesis: string = req.body?.hypothesis;
252
-
253
- if (!errorId || !version || !hypothesis) {
254
- res.status(400).send({
255
- error: 'missing required field(s): errorId / version / hypothesis',
256
- });
257
- return;
258
- }
259
-
260
- const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
261
- const attempt = await error_CS.recordFixAttempt(errorId, version, hypothesis, issuer);
262
-
263
- res.send({
264
- result: 'fix attempt recorded',
265
- attempt,
266
- });
267
- },
268
- ],
269
- }),
270
-
271
- /* new DyNTS_Endpoint_Params({
272
- name: 'markErrorDone',
273
- type: DyFM_HttpCallType.get,
274
- endpoint: '/mark-error-done/:errorId',
275
- tasks: [
276
- async (req: Request, res: Response, issuer?: string): Promise<void> => {
277
- const errorDataService: DyNTS_Error_DataService<Error_T> = this.getErrorDataService({
278
- data: { _id: req.params.errorId },
279
- issuer: issuer,
280
- });
281
-
282
- await errorDataService.deleteData();
283
-
284
- res.send({
285
- result: 'error deleted',
286
- });
287
- },
288
- ],
289
- }), */
290
-
291
- new DyNTS_Endpoint_Params({
292
- name: 'getErrors',
293
- type: DyFM_HttpCallType.get,
294
- endpoint: '/error/get-range/:range',
295
- preProcesses: this.getPreProcessesFor('getErrors'),
296
- tasks: [
297
- async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
298
- const error_CS: T_Error_ControlService = this.getError_ControlService({
299
- issuer,
300
- });
301
-
302
- res.send(
303
- await error_CS.getErrorsInRange(
304
- req.params.range as DyFM_RelativeDate,
305
- issuer
306
- )
307
- );
308
- },
309
- ],
310
- }),
311
-
312
- new DyNTS_Endpoint_Params({
313
- name: 'getErrorsPaged',
314
- type: DyFM_HttpCallType.get,
315
- endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
316
- preProcesses: this.getPreProcessesFor('getErrorsPaged'),
317
- tasks: [
318
- async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
319
- const error_CS: T_Error_ControlService = this.getError_ControlService({
320
- issuer,
321
- });
322
-
323
- let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
324
- let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
325
-
326
- // TODO: temporary fix for too big error list loads
327
- if (30 < pageSize) {
328
- pageSize = 30;
329
- pageIndex = 0;
330
- }
331
-
332
- res.send(
333
- await error_CS.getErrorsPaged(
334
- req.params.range as DyFM_RelativeDate,
335
- pageSize,
336
- pageIndex,
337
- issuer
338
- )
339
- );
340
- },
341
- ],
342
- }),
343
-
344
- new DyNTS_Endpoint_Params({
345
- name: 'getLastErrors',
346
- type: DyFM_HttpCallType.get,
347
- endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
348
- preProcesses: this.getPreProcessesFor('getLastErrors'),
349
- tasks: [
350
- async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
351
- const error_CS: T_Error_ControlService = this.getError_ControlService({
352
- issuer,
353
- });
354
-
355
- let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
356
- let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
357
-
358
- // TODO: temporary fix for too big error list loads
359
- if (30 < pageSize) {
360
- pageSize = 30;
361
- pageIndex = 0;
362
- }
363
-
364
- res.send(
365
- await error_CS.getLastErrors(
366
- req.params.range as DyFM_RelativeDate,
367
- pageSize,
368
- pageIndex,
369
- issuer
370
- )
371
- );
372
- },
373
- ],
374
- }),
375
-
376
- new DyNTS_Endpoint_Params({
377
- name: 'searchErrors',
378
- type: DyFM_HttpCallType.get,
379
- endpoint: '/error/search',
380
- preProcesses: this.getPreProcessesFor('searchErrors'),
381
- tasks: [
382
- async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
383
- const error_CS: T_Error_ControlService = this.getError_ControlService({
384
- issuer,
385
- });
386
-
387
- res.send(
388
- await error_CS.searchErrors(req.body, issuer)
389
- );
390
- },
391
- ],
392
- }),
393
-
394
- ...this.additionalEndpoints,
395
- ];
396
- }
397
- }
398
-
399
-
400
-
401
-
402
-
1
+
2
+ import { Request, Response } from 'express';
3
+
4
+ import { DyFM_Array, DyFM_Error, DyFM_HttpCallType, DyFM_Errors, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
5
+ import { DyNTS_Controller } from '../../../_services/route/controller.service';
6
+ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
7
+ import { DyNTS_Errors_ControlService } from './errors.control-service';
8
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
9
+
10
+
11
+ /**
12
+ * Auth retrofit config a `DyNTS_Errors_Controller`-hez. Opt-in — ha az
13
+ * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli)
14
+ * viselkedest tartja.
15
+ *
16
+ * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract
17
+ * osztaly minden subclass-a kozott OSZTOTT. Ha tobb subclass-od van kulonbozo
18
+ * policy-val, hivd a `configure()`-t a megfelelo subclasson — TypeScript a
19
+ * static field-eket per-class hatarozza meg.
20
+ */
21
+ export interface DyNTS_ErrorsController_AuthConfig {
22
+ /**
23
+ * Pre-process fuggveny ami minden vedett endpoint elott fut. Tipikusan:
24
+ * `DyNTS_AdminApiKey_AuthService.getInstance().verify`.
25
+ *
26
+ * Ha hianyzik vagy `undefined`, a controller NEM ad hozza auth-ot semelyik
27
+ * endpoint-hoz (regi viselkedes, opt-in safety).
28
+ */
29
+ authPreProcess?: (req: Request, res: Response) => Promise<void>;
30
+
31
+ /**
32
+ * Vedett endpoint nevek listaja. Ha hianyzik, az osszes 8 endpoint vedett
33
+ * (`authPreProcess` jelenleteben).
34
+ *
35
+ * Endpoint nevek: 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
36
+ * 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors'.
37
+ */
38
+ protectedEndpoints?: string[];
39
+ }
40
+
41
+
42
+ /**
43
+ * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
44
+ * default-jat es a config validacio-t segiti.
45
+ */
46
+ const ALL_ENDPOINT_NAMES: string[] = [
47
+ 'logError', 'newError',
48
+ 'markErrorDone', 'markAllErrorDone',
49
+ 'recordFixAttempt',
50
+ 'getErrors', 'getErrorsPaged', 'getErrorsByCategoryPaged', 'getLastErrors',
51
+ 'searchErrors',
52
+ ];
53
+
54
+ /**
55
+ * Endpoints:
56
+ *
57
+ * logError
58
+ * POST /error/log
59
+ *
60
+ * markErrorDone
61
+ * GET /error/mark-done/:errorId
62
+ *
63
+ * markAllErrorDone
64
+ * GET /error/mark-all-done
65
+ *
66
+ * getErrors
67
+ * GET /error/get-range/:range
68
+ *
69
+ * getErrorsPaged
70
+ * GET /error/get-paged/:range/:pageSize/:pageIndex
71
+ *
72
+ * getLastErrors
73
+ * GET /error/get-last-paged/:range/:pageSize/:pageIndex
74
+ *
75
+ *
76
+ */
77
+ // Documentation:
78
+ // Local: [MD](./errors.md)
79
+ //
80
+ export abstract class DyNTS_Errors_Controller<
81
+ T_Error extends DyFM_Error,
82
+ T_Errors extends DyFM_Errors<T_Error>,
83
+ T_Error_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>
84
+ > extends DyNTS_Controller {
85
+
86
+ /* static getInstance(): DyNTS_Error_Controller {
87
+ return DyNTS_Error_Controller.getSingletonInstance();
88
+ } */
89
+
90
+ /* protected abstract errorDataService: DyNTS_Error_DataService<T_Error>; */
91
+ protected abstract getError_ControlService(
92
+ set: { data?: T_Error, issuer: string }
93
+ ): T_Error_ControlService;
94
+ protected readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
95
+
96
+ /**
97
+ * Static auth config — opt-in retrofit. Default ures objektum → NO auth
98
+ * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
99
+ */
100
+ protected static authConfig: DyNTS_ErrorsController_AuthConfig = {};
101
+
102
+ /**
103
+ * Static config setter. Hivhato barmikor a szerver startup-jan az endpoint
104
+ * registration ELOTT.
105
+ *
106
+ * Use case (host app):
107
+ * ```ts
108
+ * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
109
+ * DyNTS_Errors_Controller.configure({ authPreProcess: adminAuth.verify });
110
+ * // vagy fine-grained:
111
+ * DyNTS_Errors_Controller.configure({
112
+ * authPreProcess: adminAuth.verify,
113
+ * protectedEndpoints: ['markAllErrorDone', 'logError'],
114
+ * });
115
+ * ```
116
+ */
117
+ static configure(config: DyNTS_ErrorsController_AuthConfig): void {
118
+ DyNTS_Errors_Controller.authConfig = config;
119
+ }
120
+
121
+ /**
122
+ * Aktualis auth config olvasasa (test/diagnosztika celokra).
123
+ */
124
+ static getAuthConfig(): DyNTS_ErrorsController_AuthConfig {
125
+ return DyNTS_Errors_Controller.authConfig;
126
+ }
127
+
128
+ /**
129
+ * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
130
+ */
131
+ static _resetAuthConfigForTesting(): void {
132
+ DyNTS_Errors_Controller.authConfig = {};
133
+ }
134
+
135
+ /**
136
+ * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
137
+ * Ha az auth NINCS configurolva (default) vagy az endpoint nincs a
138
+ * `protectedEndpoints` listan, ures array-t ad vissza.
139
+ */
140
+ protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
141
+ const cfg: DyNTS_ErrorsController_AuthConfig = DyNTS_Errors_Controller.authConfig;
142
+ if (!cfg.authPreProcess) { return []; }
143
+ const protectedNames: string[] = cfg.protectedEndpoints ?? ALL_ENDPOINT_NAMES;
144
+ return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
145
+ }
146
+
147
+ setupEndpoints(): void {
148
+ /* if (!this.getErrorDataService) {
149
+ throw new DyFM_Error({
150
+ message: 'getUserDataService() method not implemented in Error_Controller.',
151
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-001`,
152
+ });
153
+ } */
154
+
155
+ if (!this.additionalEndpoints) {
156
+ throw new DyFM_Error({
157
+ message: 'additionalEndpoints must be defined in Error_Controller.',
158
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-002`,
159
+ });
160
+ }
161
+
162
+ this.endpoints = [
163
+ new DyNTS_Endpoint_Params({
164
+ name: 'logError',
165
+ type: DyFM_HttpCallType.post,
166
+ endpoint: '/error/log',
167
+ preProcesses: this.getPreProcessesFor('logError'),
168
+ tasks: [
169
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
170
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
171
+ issuer,
172
+ });
173
+
174
+ await error_CS.recordError(req.body, issuer);
175
+
176
+ res.send({
177
+ result: 'error logged',
178
+ });
179
+ },
180
+ ],
181
+ }),
182
+ new DyNTS_Endpoint_Params({
183
+ name: 'newError',
184
+ type: DyFM_HttpCallType.post,
185
+ endpoint: '/error/new',
186
+ preProcesses: this.getPreProcessesFor('newError'),
187
+ tasks: [
188
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
189
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
190
+ issuer,
191
+ });
192
+
193
+ await error_CS.recordError(req.body, issuer);
194
+
195
+ res.send({
196
+ result: 'error logged',
197
+ });
198
+ },
199
+ ],
200
+ }),
201
+
202
+ new DyNTS_Endpoint_Params({
203
+ name: 'markErrorDone',
204
+ type: DyFM_HttpCallType.get,
205
+ endpoint: '/error/mark-done/:errorId',
206
+ preProcesses: this.getPreProcessesFor('markErrorDone'),
207
+ tasks: [
208
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
209
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
210
+ issuer,
211
+ });
212
+
213
+ await error_CS.deleteError(req.params.errorId, issuer, true);
214
+
215
+ res.send({
216
+ result: 'error deleted',
217
+ });
218
+ },
219
+ ],
220
+ }),
221
+
222
+ new DyNTS_Endpoint_Params({
223
+ name: 'markAllErrorDone',
224
+ type: DyFM_HttpCallType.get,
225
+ endpoint: '/error/mark-all-done',
226
+ preProcesses: this.getPreProcessesFor('markAllErrorDone'),
227
+ tasks: [
228
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
229
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
230
+ issuer,
231
+ });
232
+
233
+ await error_CS.deleteAllErrors(issuer, true);
234
+
235
+ res.send({
236
+ result: 'all error deleted',
237
+ });
238
+ },
239
+ ],
240
+ }),
241
+
242
+ new DyNTS_Endpoint_Params({
243
+ name: 'recordFixAttempt',
244
+ type: DyFM_HttpCallType.post,
245
+ endpoint: '/error/:errorId/fix-attempt',
246
+ preProcesses: this.getPreProcessesFor('recordFixAttempt'),
247
+ tasks: [
248
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
249
+ const errorId: string = req.params.errorId;
250
+ const version: string = req.body?.version;
251
+ const hypothesis: string = req.body?.hypothesis;
252
+
253
+ if (!errorId || !version || !hypothesis) {
254
+ res.status(400).send({
255
+ error: 'missing required field(s): errorId / version / hypothesis',
256
+ });
257
+ return;
258
+ }
259
+
260
+ const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
261
+ const attempt = await error_CS.recordFixAttempt(errorId, version, hypothesis, issuer);
262
+
263
+ res.send({
264
+ result: 'fix attempt recorded',
265
+ attempt,
266
+ });
267
+ },
268
+ ],
269
+ }),
270
+
271
+ /* new DyNTS_Endpoint_Params({
272
+ name: 'markErrorDone',
273
+ type: DyFM_HttpCallType.get,
274
+ endpoint: '/mark-error-done/:errorId',
275
+ tasks: [
276
+ async (req: Request, res: Response, issuer?: string): Promise<void> => {
277
+ const errorDataService: DyNTS_Error_DataService<Error_T> = this.getErrorDataService({
278
+ data: { _id: req.params.errorId },
279
+ issuer: issuer,
280
+ });
281
+
282
+ await errorDataService.deleteData();
283
+
284
+ res.send({
285
+ result: 'error deleted',
286
+ });
287
+ },
288
+ ],
289
+ }), */
290
+
291
+ new DyNTS_Endpoint_Params({
292
+ name: 'getErrors',
293
+ type: DyFM_HttpCallType.get,
294
+ endpoint: '/error/get-range/:range',
295
+ preProcesses: this.getPreProcessesFor('getErrors'),
296
+ tasks: [
297
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
298
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
299
+ issuer,
300
+ });
301
+
302
+ res.send(
303
+ await error_CS.getErrorsInRange(
304
+ req.params.range as DyFM_RelativeDate,
305
+ issuer
306
+ )
307
+ );
308
+ },
309
+ ],
310
+ }),
311
+
312
+ new DyNTS_Endpoint_Params({
313
+ name: 'getErrorsPaged',
314
+ type: DyFM_HttpCallType.get,
315
+ endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
316
+ preProcesses: this.getPreProcessesFor('getErrorsPaged'),
317
+ tasks: [
318
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
319
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
320
+ issuer,
321
+ });
322
+
323
+ let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
324
+ let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
325
+
326
+ // TODO: temporary fix for too big error list loads
327
+ if (30 < pageSize) {
328
+ pageSize = 30;
329
+ pageIndex = 0;
330
+ }
331
+
332
+ res.send(
333
+ await error_CS.getErrorsPaged(
334
+ req.params.range as DyFM_RelativeDate,
335
+ pageSize,
336
+ pageIndex,
337
+ issuer
338
+ )
339
+ );
340
+ },
341
+ ],
342
+ }),
343
+
344
+ new DyNTS_Endpoint_Params({
345
+ name: 'getErrorsByCategoryPaged',
346
+ type: DyFM_HttpCallType.get,
347
+ endpoint: '/error/get-by-category/:category/:range/:pageSize/:pageIndex',
348
+ preProcesses: this.getPreProcessesFor('getErrorsByCategoryPaged'),
349
+ tasks: [
350
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
351
+ const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
352
+
353
+ let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
354
+ let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
355
+ if (30 < pageSize) {
356
+ pageSize = 30;
357
+ pageIndex = 0;
358
+ }
359
+
360
+ res.send(
361
+ await error_CS.getErrorsByCategoryPaged(
362
+ req.params.category,
363
+ req.params.range as DyFM_RelativeDate,
364
+ pageSize,
365
+ pageIndex,
366
+ issuer
367
+ )
368
+ );
369
+ },
370
+ ],
371
+ }),
372
+
373
+ new DyNTS_Endpoint_Params({
374
+ name: 'getLastErrors',
375
+ type: DyFM_HttpCallType.get,
376
+ endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
377
+ preProcesses: this.getPreProcessesFor('getLastErrors'),
378
+ tasks: [
379
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
380
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
381
+ issuer,
382
+ });
383
+
384
+ let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
385
+ let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
386
+
387
+ // TODO: temporary fix for too big error list loads
388
+ if (30 < pageSize) {
389
+ pageSize = 30;
390
+ pageIndex = 0;
391
+ }
392
+
393
+ res.send(
394
+ await error_CS.getLastErrors(
395
+ req.params.range as DyFM_RelativeDate,
396
+ pageSize,
397
+ pageIndex,
398
+ issuer
399
+ )
400
+ );
401
+ },
402
+ ],
403
+ }),
404
+
405
+ new DyNTS_Endpoint_Params({
406
+ name: 'searchErrors',
407
+ type: DyFM_HttpCallType.get,
408
+ endpoint: '/error/search',
409
+ preProcesses: this.getPreProcessesFor('searchErrors'),
410
+ tasks: [
411
+ async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
412
+ const error_CS: T_Error_ControlService = this.getError_ControlService({
413
+ issuer,
414
+ });
415
+
416
+ res.send(
417
+ await error_CS.searchErrors(req.body, issuer)
418
+ );
419
+ },
420
+ ],
421
+ }),
422
+
423
+ ...this.additionalEndpoints,
424
+ ];
425
+ }
426
+ }
427
+
428
+
429
+
430
+
431
+