@futdevpro/nts-dynamo 1.15.71 → 1.15.73

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