@futdevpro/nts-dynamo 1.15.127 → 1.15.128

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 (384) 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 +2864 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.dynamo/pipeline.cicd.config.json +3 -1
  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/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  24. package/_specifications/BACKLOG.md +92 -92
  25. package/_specifications/TODO.md +15 -15
  26. package/_specifications/agent.md +138 -138
  27. package/build/_models/control-models/endpoint-params.control-model.d.ts.map +1 -1
  28. package/build/_models/control-models/endpoint-params.control-model.js +9 -0
  29. package/build/_models/control-models/endpoint-params.control-model.js.map +1 -1
  30. package/build/_services/core/event-loop-diag.service.d.ts +6 -0
  31. package/build/_services/core/event-loop-diag.service.d.ts.map +1 -1
  32. package/build/_services/core/event-loop-diag.service.js +19 -1
  33. package/build/_services/core/event-loop-diag.service.js.map +1 -1
  34. package/build/_services/core/request-hunter.service.d.ts +74 -0
  35. package/build/_services/core/request-hunter.service.d.ts.map +1 -0
  36. package/build/_services/core/request-hunter.service.js +123 -0
  37. package/build/_services/core/request-hunter.service.js.map +1 -0
  38. package/build/index.d.ts +1 -0
  39. package/build/index.d.ts.map +1 -1
  40. package/build/index.js +1 -0
  41. package/build/index.js.map +1 -1
  42. package/eslint.config.js +3 -3
  43. package/nodemon.json +24 -24
  44. package/package.json +2 -2
  45. package/pnpm-workspace.yaml +5 -5
  46. package/scripts/run-coverage-tests.js +28 -28
  47. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  48. package/spec/support/helpers/ts-node-helper.js +93 -93
  49. package/spec/support/jasmine.coverage.json +24 -24
  50. package/spec/support/jasmine.json +24 -24
  51. package/src/_collections/archive.util.spec.ts +57 -57
  52. package/src/_collections/archive.util.ts +18 -18
  53. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  54. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  55. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  56. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  57. package/src/_collections/default-not-found-page.const.ts +22 -22
  58. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  59. package/src/_collections/default-socket-path.const.ts +2 -2
  60. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  61. package/src/_collections/get-environment-settings.util.ts +48 -48
  62. package/src/_collections/global-settings.const.ts +126 -126
  63. package/src/_collections/sample.env +21 -21
  64. package/src/_collections/signed-url.util.spec.ts +198 -198
  65. package/src/_collections/signed-url.util.ts +170 -170
  66. package/src/_collections/star.controller.spec.ts +224 -224
  67. package/src/_collections/star.controller.ts +129 -129
  68. package/src/_enums/data-model-type.enum.ts +14 -14
  69. package/src/_enums/data-service-function.enum.ts +24 -24
  70. package/src/_enums/predefined-data-types.enum.ts +16 -16
  71. package/src/_enums/route-security.enum.ts +12 -12
  72. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  73. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  74. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  75. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  76. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  77. package/src/_models/control-models/app-params.control-model.ts +136 -136
  78. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  79. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  80. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  81. package/src/_models/control-models/endpoint-params.control-model.ts +664 -656
  82. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  83. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  84. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  85. package/src/_models/control-models/system-control.control-model.ts +12 -12
  86. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  87. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  88. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  89. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  90. package/src/_models/interfaces/global-settings.interface.ts +286 -286
  91. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  92. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  93. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  94. package/src/_models/types/db-update.type.ts +100 -100
  95. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  96. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  97. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  98. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  99. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  100. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  101. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  102. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  103. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  104. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  105. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  106. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  107. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  108. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  109. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  110. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  111. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  112. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  113. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  114. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  115. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  116. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  117. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  118. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  119. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  120. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  121. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  122. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  123. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  124. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  125. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  126. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  127. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  128. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  129. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  130. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  131. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  132. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  133. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  134. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  135. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  136. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  137. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  138. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  139. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  140. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  141. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  142. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  143. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  144. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  145. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  146. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  147. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  148. package/src/_modules/ai/index.ts +33 -33
  149. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  150. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  151. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  152. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  153. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  154. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  155. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  156. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  157. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  158. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  159. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  160. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  161. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  162. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  163. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  164. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  165. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  166. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  167. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  168. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  169. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  170. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  171. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  172. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  173. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  174. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  175. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  176. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  177. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  178. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  179. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  180. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  181. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  182. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  183. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  184. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  185. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  186. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  187. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  188. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  189. package/src/_modules/custom-data/index.ts +9 -9
  190. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  191. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  192. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  193. package/src/_modules/data-readers/index.ts +11 -11
  194. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  195. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  196. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  197. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  198. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  199. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  200. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  201. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  202. package/src/_modules/defaults/index.ts +17 -17
  203. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  204. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  205. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  206. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  207. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  208. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  209. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  210. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  211. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  212. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  213. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  214. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  215. package/src/_modules/discord-assistant/index.ts +38 -38
  216. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  217. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  218. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  219. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  220. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  221. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  222. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  223. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  224. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  225. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  226. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  227. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  228. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  229. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  230. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  231. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  232. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  233. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  234. package/src/_modules/discord-bot/index.ts +36 -36
  235. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  236. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  237. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  238. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  239. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  240. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  241. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  242. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  243. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  244. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  245. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  246. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  247. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  248. package/src/_modules/local-vector-search/index.ts +16 -16
  249. package/src/_modules/logs/index.ts +11 -11
  250. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  251. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  252. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  253. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  254. package/src/_modules/mcp/index.ts +13 -13
  255. package/src/_modules/messaging/README.md +354 -354
  256. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  257. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  258. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  259. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  260. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  261. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  262. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  263. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  264. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  265. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  266. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  267. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  268. package/src/_modules/messaging/index.ts +30 -30
  269. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  270. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  271. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  272. package/src/_modules/mock/app-params.mock.ts +9 -9
  273. package/src/_modules/mock/app-server.mock.ts +188 -188
  274. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  275. package/src/_modules/mock/auth-service.mock.ts +28 -28
  276. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  277. package/src/_modules/mock/controller.mock.ts +16 -16
  278. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  279. package/src/_modules/mock/data-model.mock.ts +82 -82
  280. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  281. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  282. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  283. package/src/_modules/mock/email-service.mock.ts +20 -20
  284. package/src/_modules/mock/email-template.mock.html +14 -14
  285. package/src/_modules/mock/endpoint.mock.ts +91 -91
  286. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  287. package/src/_modules/mock/socket-client.mock.ts +45 -45
  288. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  289. package/src/_modules/mock/socket-server.mock.ts +46 -46
  290. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  291. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  292. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  293. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  294. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  295. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  296. package/src/_modules/oauth2/index.ts +17 -17
  297. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  298. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  299. package/src/_modules/scheduler/index.ts +8 -8
  300. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  301. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  302. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  303. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  304. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  305. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  306. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  307. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  308. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  309. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  310. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  311. package/src/_modules/scoped-config/index.ts +17 -17
  312. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  313. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  314. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  315. package/src/_modules/server/errors/errors.controller.ts +515 -515
  316. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  317. package/src/_modules/server/index.ts +30 -30
  318. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  319. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  320. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  321. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  322. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  323. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  324. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  325. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  326. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  327. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  328. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  329. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  330. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  331. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  332. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  333. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  334. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  335. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  336. package/src/_modules/socket/app-extended.server.ts +648 -648
  337. package/src/_modules/socket/index.ts +42 -42
  338. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  339. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  340. package/src/_modules/test/index.ts +11 -11
  341. package/src/_modules/test/test.controller.spec.ts +72 -72
  342. package/src/_modules/test/test.controller.ts +115 -115
  343. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  344. package/src/_modules/usage/index.ts +15 -15
  345. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  346. package/src/_modules/usage/usage.controller.ts +126 -126
  347. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  348. package/src/_modules/usage/usage.data-service.ts +185 -185
  349. package/src/_services/base/api.service-base.spec.ts +125 -125
  350. package/src/_services/base/api.service-base.ts +74 -74
  351. package/src/_services/base/archive-data.service.spec.ts +209 -209
  352. package/src/_services/base/archive-data.service.ts +223 -223
  353. package/src/_services/base/data.service.spec.ts +729 -729
  354. package/src/_services/base/data.service.ts +2758 -2758
  355. package/src/_services/base/db.service.spec.ts +160 -160
  356. package/src/_services/base/db.service.ts +1698 -1698
  357. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  358. package/src/_services/base/singleton.service-base.ts +24 -24
  359. package/src/_services/base/singleton.service.spec.ts +114 -114
  360. package/src/_services/base/singleton.service.ts +38 -38
  361. package/src/_services/core/api.service.spec.ts +140 -140
  362. package/src/_services/core/auth.service.spec.ts +159 -159
  363. package/src/_services/core/auth.service.ts +174 -174
  364. package/src/_services/core/email.service.spec.ts +85 -85
  365. package/src/_services/core/email.service.ts +757 -757
  366. package/src/_services/core/event-loop-diag.service.ts +23 -1
  367. package/src/_services/core/global.service.spec.ts +292 -292
  368. package/src/_services/core/global.service.ts +487 -487
  369. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  370. package/src/_services/core/memory-guard.service.ts +481 -481
  371. package/src/_services/core/request-hunter.service.spec.ts +124 -0
  372. package/src/_services/core/request-hunter.service.ts +157 -0
  373. package/src/_services/core/service-collection.service.spec.ts +46 -46
  374. package/src/_services/core/service-collection.service.ts +6 -6
  375. package/src/_services/route/controller.service.spec.ts +53 -53
  376. package/src/_services/route/controller.service.ts +148 -148
  377. package/src/_services/route/routing-module.service.spec.ts +98 -98
  378. package/src/_services/route/routing-module.service.ts +330 -330
  379. package/src/_services/server/app.server.ts +1985 -1985
  380. package/src/_services/shared.static-service.spec.ts +99 -99
  381. package/src/_services/shared.static-service.ts +78 -78
  382. package/src/index.ts +113 -112
  383. package/tsconfig.app.json +12 -12
  384. package/tsconfig.json +42 -42
@@ -1,268 +1,268 @@
1
-
2
- import { DyNTS_Errors_Controller } from './errors.controller';
3
- import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
- import { DyNTS_Errors_ControlService } from './errors.control-service';
5
- import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
6
-
7
- class TestError extends DyFM_Error {
8
- testProperty?: string;
9
- }
10
-
11
- class TestErrors extends DyFM_Errors<TestError> {
12
- testProperty?: string;
13
- }
14
-
15
- class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
16
- async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
17
- async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
18
- checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
19
- getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
20
- async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
21
- async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
22
- async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
23
- async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
24
- return { at: new Date(), by: issuer, version, hypothesis };
25
- }
26
- async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
27
- return { items: [], total: 0, pageIndex, pageSize };
28
- }
29
-
30
- async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
31
- return;
32
- }
33
-
34
- async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
35
- return { items: [], total: 0, pageIndex, pageSize };
36
- }
37
- async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
38
- async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
39
- async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
40
- async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
41
- }
42
-
43
- class TestErrorsController extends DyNTS_Errors_Controller<TestError, TestErrors, TestErrorsControlService> {
44
- protected getError_ControlService(set: { data?: TestError, issuer: string }): TestErrorsControlService {
45
- return new TestErrorsControlService();
46
- }
47
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
48
- }
49
-
50
- describe('| DyNTS_Errors_Controller', () => {
51
- let controller: TestErrorsController;
52
-
53
- beforeEach(() => {
54
- controller = new (TestErrorsController as any)();
55
- });
56
-
57
- describe('| setupEndpoints', () => {
58
- it('| should setup all error endpoints', () => {
59
- controller.setupEndpoints();
60
-
61
- expect(controller.endpoints).toBeDefined();
62
- expect(controller.endpoints.length).toBeGreaterThanOrEqual(6);
63
- });
64
-
65
- it('| should setup logError endpoint', () => {
66
- controller.setupEndpoints();
67
-
68
- const logErrorEndpoint = controller.endpoints.find(ep => ep.name === 'logError');
69
- expect(logErrorEndpoint).toBeDefined();
70
- expect(logErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
71
- expect(logErrorEndpoint?.endpoint).toBe('/error/log');
72
- expect((logErrorEndpoint as any)?.tasks).toBeDefined();
73
- expect((logErrorEndpoint as any)?.tasks?.length).toBe(1);
74
- });
75
-
76
- it('| should setup newError endpoint', () => {
77
- controller.setupEndpoints();
78
-
79
- const newErrorEndpoint = controller.endpoints.find(ep => ep.name === 'newError');
80
- expect(newErrorEndpoint).toBeDefined();
81
- expect(newErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
82
- expect(newErrorEndpoint?.endpoint).toBe('/error/new');
83
- expect((newErrorEndpoint as any)?.tasks).toBeDefined();
84
- expect((newErrorEndpoint as any)?.tasks?.length).toBe(1);
85
- });
86
-
87
- it('| should setup markErrorDone endpoint', () => {
88
- controller.setupEndpoints();
89
-
90
- const markErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markErrorDone');
91
- expect(markErrorDoneEndpoint).toBeDefined();
92
- expect(markErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
93
- expect(markErrorDoneEndpoint?.endpoint).toBe('/error/mark-done/:errorId');
94
- expect((markErrorDoneEndpoint as any)?.tasks).toBeDefined();
95
- expect((markErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
96
- });
97
-
98
- it('| should setup markAllErrorDone endpoint', () => {
99
- controller.setupEndpoints();
100
-
101
- const markAllErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markAllErrorDone');
102
- expect(markAllErrorDoneEndpoint).toBeDefined();
103
- expect(markAllErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
104
- expect(markAllErrorDoneEndpoint?.endpoint).toBe('/error/mark-all-done');
105
- expect((markAllErrorDoneEndpoint as any)?.tasks).toBeDefined();
106
- expect((markAllErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
107
- });
108
-
109
- it('| should setup getErrors endpoint', () => {
110
- controller.setupEndpoints();
111
-
112
- const getErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrors');
113
- expect(getErrorsEndpoint).toBeDefined();
114
- expect(getErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
115
- expect(getErrorsEndpoint?.endpoint).toBe('/error/get-range/:range');
116
- expect((getErrorsEndpoint as any)?.tasks).toBeDefined();
117
- expect((getErrorsEndpoint as any)?.tasks?.length).toBe(1);
118
- });
119
-
120
- it('| should setup getErrorsPaged endpoint', () => {
121
- controller.setupEndpoints();
122
-
123
- const getErrorsPagedEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorsPaged');
124
- expect(getErrorsPagedEndpoint).toBeDefined();
125
- expect(getErrorsPagedEndpoint?.type).toBe(DyFM_HttpCallType.get);
126
- expect(getErrorsPagedEndpoint?.endpoint).toBe('/error/get-paged/:range/:pageSize/:pageIndex');
127
- expect((getErrorsPagedEndpoint as any)?.tasks).toBeDefined();
128
- expect((getErrorsPagedEndpoint as any)?.tasks?.length).toBe(1);
129
- });
130
-
131
- it('| should setup getLastErrors endpoint', () => {
132
- controller.setupEndpoints();
133
-
134
- const getLastErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getLastErrors');
135
- expect(getLastErrorsEndpoint).toBeDefined();
136
- expect(getLastErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
137
- expect(getLastErrorsEndpoint?.endpoint).toBe('/error/get-last-paged/:range/:pageSize/:pageIndex');
138
- expect((getLastErrorsEndpoint as any)?.tasks).toBeDefined();
139
- expect((getLastErrorsEndpoint as any)?.tasks?.length).toBe(1);
140
- });
141
-
142
- it('| should setup searchErrors endpoint', () => {
143
- controller.setupEndpoints();
144
-
145
- const searchErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'searchErrors');
146
- expect(searchErrorsEndpoint).toBeDefined();
147
- expect(searchErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
148
- expect(searchErrorsEndpoint?.endpoint).toBe('/error/search');
149
- expect((searchErrorsEndpoint as any)?.tasks).toBeDefined();
150
- expect((searchErrorsEndpoint as any)?.tasks?.length).toBe(1);
151
- });
152
-
153
- it('| should include additionalEndpoints', () => {
154
- const additionalEndpoint = new DyNTS_Endpoint_Params({
155
- name: 'customEndpoint',
156
- type: DyFM_HttpCallType.get,
157
- endpoint: '/error/custom',
158
- tasks: [],
159
- });
160
- (controller as any).additionalEndpoints.push(additionalEndpoint);
161
-
162
- controller.setupEndpoints();
163
-
164
- const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
165
- expect(customEndpoint).toBeDefined();
166
- });
167
-
168
- it('| should throw error when additionalEndpoints is not defined', () => {
169
- const controllerWithoutEndpoints = new (class extends TestErrorsController {
170
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
171
- } as any)();
172
-
173
- expect(() => {
174
- controllerWithoutEndpoints.setupEndpoints();
175
- }).toThrow();
176
- });
177
- });
178
-
179
- describe('| opt-in admin auth retrofit (BL-20260420-004)', (): void => {
180
- afterEach((): void => {
181
- DyNTS_Errors_Controller._resetAuthConfigForTesting();
182
- });
183
-
184
- // FR-263 — a guard mostantol REQUEST-IDOBEN fut (lazy wrapper); igy MINDEN endpoint-on pontosan
185
- // 1 preProcess (a wrapper) van, a tenyleges guard-logikat a wrapper MEGHIVASAVAL teszteljuk.
186
- const lazyWrapperOf = (c: any, name: string): ((req: any, res: any) => Promise<void>) | undefined => {
187
- const ep: any = c.endpoints.find((e: any) => e.name === name);
188
- return ep?.preProcesses?.[0];
189
- };
190
- const mockReqRes = (): { req: any; res: any } => ({ req: {} as any, res: { headersSent: false } as any });
191
-
192
- it('| default (no config): a lazy wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
193
- controller.setupEndpoints();
194
- for (const name of ['logError', 'getErrors', 'searchErrors']) {
195
- const w = lazyWrapperOf(controller, name);
196
- expect(w).withContext(`${name} wrapper`).toBeDefined();
197
- const { req, res } = mockReqRes();
198
- await w!(req, res); // nincs config → no-op, nem dob, nem blokkol
199
- }
200
- });
201
-
202
- it('| configure({ authPreProcess }) → egy keres MINDEN built-in endpoint-on meghivja a guardot', async (): Promise<void> => {
203
- let calls: number = 0;
204
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
205
- const c = new (TestErrorsController as any)();
206
- c.setupEndpoints();
207
- const builtIn: string[] = [
208
- 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
209
- 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors',
210
- ];
211
- for (const name of builtIn) {
212
- const w = lazyWrapperOf(c, name);
213
- expect(w).withContext(`endpoint ${name} missing`).toBeDefined();
214
- const { req, res } = mockReqRes();
215
- await w!(req, res);
216
- }
217
- expect(calls).toBe(builtIn.length);
218
- });
219
-
220
- it('| configure({ protectedEndpoints: subset }) → a guard CSAK a listazott endpoint-okon fut', async (): Promise<void> => {
221
- let calls: number = 0;
222
- DyNTS_Errors_Controller.configure({
223
- authPreProcess: async (): Promise<void> => { calls++; },
224
- protectedEndpoints: ['markAllErrorDone', 'logError'],
225
- });
226
- const c = new (TestErrorsController as any)();
227
- c.setupEndpoints();
228
- for (const name of ['markAllErrorDone', 'logError']) {
229
- const { req, res } = mockReqRes();
230
- await lazyWrapperOf(c, name)!(req, res);
231
- }
232
- expect(calls).withContext('protected → guard runs').toBe(2);
233
- calls = 0;
234
- const { req, res } = mockReqRes();
235
- await lazyWrapperOf(c, 'getErrors')!(req, res);
236
- expect(calls).withContext('non-protected getErrors → guard does NOT run').toBe(0);
237
- });
238
-
239
- it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot (a fix lenyege)', async (): Promise<void> => {
240
- // A framework korai singleton-konstrukcioja: az endpoints config NELKUL epul fel...
241
- const c = new (TestErrorsController as any)();
242
- c.setupEndpoints();
243
- // ...es a configure() KESOBB fut (ez volt a fals-200 info-disclosure bug). A lazy wrapper
244
- // request-idoben olvassa a configot → a guard MEGIS lefut. Ez az FR-263 regresszio-guard.
245
- let calls: number = 0;
246
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
247
- const { req, res } = mockReqRes();
248
- await lazyWrapperOf(c, 'getErrors')!(req, res);
249
- expect(calls).withContext('guard must run despite configure() AFTER setupEndpoints').toBe(1);
250
- });
251
-
252
- it('| getAuthConfig() returns the active config', (): void => {
253
- const fakeAuth = async (): Promise<void> => { /* noop */ };
254
- DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: ['logError'] });
255
- const cfg = DyNTS_Errors_Controller.getAuthConfig();
256
- expect(cfg.authPreProcess).toBe(fakeAuth);
257
- expect(cfg.protectedEndpoints).toEqual(['logError']);
258
- });
259
-
260
- it('| _resetAuthConfigForTesting() clears the config', (): void => {
261
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
262
- DyNTS_Errors_Controller._resetAuthConfigForTesting();
263
- const cfg = DyNTS_Errors_Controller.getAuthConfig();
264
- expect(cfg.authPreProcess).toBeUndefined();
265
- });
266
- });
267
- });
268
-
1
+
2
+ import { DyNTS_Errors_Controller } from './errors.controller';
3
+ import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
+ import { DyNTS_Errors_ControlService } from './errors.control-service';
5
+ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
6
+
7
+ class TestError extends DyFM_Error {
8
+ testProperty?: string;
9
+ }
10
+
11
+ class TestErrors extends DyFM_Errors<TestError> {
12
+ testProperty?: string;
13
+ }
14
+
15
+ class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
16
+ async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
17
+ async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
18
+ checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
19
+ getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
20
+ async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
21
+ async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
22
+ async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
23
+ async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
24
+ return { at: new Date(), by: issuer, version, hypothesis };
25
+ }
26
+ async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
27
+ return { items: [], total: 0, pageIndex, pageSize };
28
+ }
29
+
30
+ async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
31
+ return;
32
+ }
33
+
34
+ async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
35
+ return { items: [], total: 0, pageIndex, pageSize };
36
+ }
37
+ async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
38
+ async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
39
+ async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
40
+ async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
41
+ }
42
+
43
+ class TestErrorsController extends DyNTS_Errors_Controller<TestError, TestErrors, TestErrorsControlService> {
44
+ protected getError_ControlService(set: { data?: TestError, issuer: string }): TestErrorsControlService {
45
+ return new TestErrorsControlService();
46
+ }
47
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
48
+ }
49
+
50
+ describe('| DyNTS_Errors_Controller', () => {
51
+ let controller: TestErrorsController;
52
+
53
+ beforeEach(() => {
54
+ controller = new (TestErrorsController as any)();
55
+ });
56
+
57
+ describe('| setupEndpoints', () => {
58
+ it('| should setup all error endpoints', () => {
59
+ controller.setupEndpoints();
60
+
61
+ expect(controller.endpoints).toBeDefined();
62
+ expect(controller.endpoints.length).toBeGreaterThanOrEqual(6);
63
+ });
64
+
65
+ it('| should setup logError endpoint', () => {
66
+ controller.setupEndpoints();
67
+
68
+ const logErrorEndpoint = controller.endpoints.find(ep => ep.name === 'logError');
69
+ expect(logErrorEndpoint).toBeDefined();
70
+ expect(logErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
71
+ expect(logErrorEndpoint?.endpoint).toBe('/error/log');
72
+ expect((logErrorEndpoint as any)?.tasks).toBeDefined();
73
+ expect((logErrorEndpoint as any)?.tasks?.length).toBe(1);
74
+ });
75
+
76
+ it('| should setup newError endpoint', () => {
77
+ controller.setupEndpoints();
78
+
79
+ const newErrorEndpoint = controller.endpoints.find(ep => ep.name === 'newError');
80
+ expect(newErrorEndpoint).toBeDefined();
81
+ expect(newErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
82
+ expect(newErrorEndpoint?.endpoint).toBe('/error/new');
83
+ expect((newErrorEndpoint as any)?.tasks).toBeDefined();
84
+ expect((newErrorEndpoint as any)?.tasks?.length).toBe(1);
85
+ });
86
+
87
+ it('| should setup markErrorDone endpoint', () => {
88
+ controller.setupEndpoints();
89
+
90
+ const markErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markErrorDone');
91
+ expect(markErrorDoneEndpoint).toBeDefined();
92
+ expect(markErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
93
+ expect(markErrorDoneEndpoint?.endpoint).toBe('/error/mark-done/:errorId');
94
+ expect((markErrorDoneEndpoint as any)?.tasks).toBeDefined();
95
+ expect((markErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
96
+ });
97
+
98
+ it('| should setup markAllErrorDone endpoint', () => {
99
+ controller.setupEndpoints();
100
+
101
+ const markAllErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markAllErrorDone');
102
+ expect(markAllErrorDoneEndpoint).toBeDefined();
103
+ expect(markAllErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
104
+ expect(markAllErrorDoneEndpoint?.endpoint).toBe('/error/mark-all-done');
105
+ expect((markAllErrorDoneEndpoint as any)?.tasks).toBeDefined();
106
+ expect((markAllErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
107
+ });
108
+
109
+ it('| should setup getErrors endpoint', () => {
110
+ controller.setupEndpoints();
111
+
112
+ const getErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrors');
113
+ expect(getErrorsEndpoint).toBeDefined();
114
+ expect(getErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
115
+ expect(getErrorsEndpoint?.endpoint).toBe('/error/get-range/:range');
116
+ expect((getErrorsEndpoint as any)?.tasks).toBeDefined();
117
+ expect((getErrorsEndpoint as any)?.tasks?.length).toBe(1);
118
+ });
119
+
120
+ it('| should setup getErrorsPaged endpoint', () => {
121
+ controller.setupEndpoints();
122
+
123
+ const getErrorsPagedEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorsPaged');
124
+ expect(getErrorsPagedEndpoint).toBeDefined();
125
+ expect(getErrorsPagedEndpoint?.type).toBe(DyFM_HttpCallType.get);
126
+ expect(getErrorsPagedEndpoint?.endpoint).toBe('/error/get-paged/:range/:pageSize/:pageIndex');
127
+ expect((getErrorsPagedEndpoint as any)?.tasks).toBeDefined();
128
+ expect((getErrorsPagedEndpoint as any)?.tasks?.length).toBe(1);
129
+ });
130
+
131
+ it('| should setup getLastErrors endpoint', () => {
132
+ controller.setupEndpoints();
133
+
134
+ const getLastErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getLastErrors');
135
+ expect(getLastErrorsEndpoint).toBeDefined();
136
+ expect(getLastErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
137
+ expect(getLastErrorsEndpoint?.endpoint).toBe('/error/get-last-paged/:range/:pageSize/:pageIndex');
138
+ expect((getLastErrorsEndpoint as any)?.tasks).toBeDefined();
139
+ expect((getLastErrorsEndpoint as any)?.tasks?.length).toBe(1);
140
+ });
141
+
142
+ it('| should setup searchErrors endpoint', () => {
143
+ controller.setupEndpoints();
144
+
145
+ const searchErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'searchErrors');
146
+ expect(searchErrorsEndpoint).toBeDefined();
147
+ expect(searchErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
148
+ expect(searchErrorsEndpoint?.endpoint).toBe('/error/search');
149
+ expect((searchErrorsEndpoint as any)?.tasks).toBeDefined();
150
+ expect((searchErrorsEndpoint as any)?.tasks?.length).toBe(1);
151
+ });
152
+
153
+ it('| should include additionalEndpoints', () => {
154
+ const additionalEndpoint = new DyNTS_Endpoint_Params({
155
+ name: 'customEndpoint',
156
+ type: DyFM_HttpCallType.get,
157
+ endpoint: '/error/custom',
158
+ tasks: [],
159
+ });
160
+ (controller as any).additionalEndpoints.push(additionalEndpoint);
161
+
162
+ controller.setupEndpoints();
163
+
164
+ const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
165
+ expect(customEndpoint).toBeDefined();
166
+ });
167
+
168
+ it('| should throw error when additionalEndpoints is not defined', () => {
169
+ const controllerWithoutEndpoints = new (class extends TestErrorsController {
170
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
171
+ } as any)();
172
+
173
+ expect(() => {
174
+ controllerWithoutEndpoints.setupEndpoints();
175
+ }).toThrow();
176
+ });
177
+ });
178
+
179
+ describe('| opt-in admin auth retrofit (BL-20260420-004)', (): void => {
180
+ afterEach((): void => {
181
+ DyNTS_Errors_Controller._resetAuthConfigForTesting();
182
+ });
183
+
184
+ // FR-263 — a guard mostantol REQUEST-IDOBEN fut (lazy wrapper); igy MINDEN endpoint-on pontosan
185
+ // 1 preProcess (a wrapper) van, a tenyleges guard-logikat a wrapper MEGHIVASAVAL teszteljuk.
186
+ const lazyWrapperOf = (c: any, name: string): ((req: any, res: any) => Promise<void>) | undefined => {
187
+ const ep: any = c.endpoints.find((e: any) => e.name === name);
188
+ return ep?.preProcesses?.[0];
189
+ };
190
+ const mockReqRes = (): { req: any; res: any } => ({ req: {} as any, res: { headersSent: false } as any });
191
+
192
+ it('| default (no config): a lazy wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
193
+ controller.setupEndpoints();
194
+ for (const name of ['logError', 'getErrors', 'searchErrors']) {
195
+ const w = lazyWrapperOf(controller, name);
196
+ expect(w).withContext(`${name} wrapper`).toBeDefined();
197
+ const { req, res } = mockReqRes();
198
+ await w!(req, res); // nincs config → no-op, nem dob, nem blokkol
199
+ }
200
+ });
201
+
202
+ it('| configure({ authPreProcess }) → egy keres MINDEN built-in endpoint-on meghivja a guardot', async (): Promise<void> => {
203
+ let calls: number = 0;
204
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
205
+ const c = new (TestErrorsController as any)();
206
+ c.setupEndpoints();
207
+ const builtIn: string[] = [
208
+ 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
209
+ 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors',
210
+ ];
211
+ for (const name of builtIn) {
212
+ const w = lazyWrapperOf(c, name);
213
+ expect(w).withContext(`endpoint ${name} missing`).toBeDefined();
214
+ const { req, res } = mockReqRes();
215
+ await w!(req, res);
216
+ }
217
+ expect(calls).toBe(builtIn.length);
218
+ });
219
+
220
+ it('| configure({ protectedEndpoints: subset }) → a guard CSAK a listazott endpoint-okon fut', async (): Promise<void> => {
221
+ let calls: number = 0;
222
+ DyNTS_Errors_Controller.configure({
223
+ authPreProcess: async (): Promise<void> => { calls++; },
224
+ protectedEndpoints: ['markAllErrorDone', 'logError'],
225
+ });
226
+ const c = new (TestErrorsController as any)();
227
+ c.setupEndpoints();
228
+ for (const name of ['markAllErrorDone', 'logError']) {
229
+ const { req, res } = mockReqRes();
230
+ await lazyWrapperOf(c, name)!(req, res);
231
+ }
232
+ expect(calls).withContext('protected → guard runs').toBe(2);
233
+ calls = 0;
234
+ const { req, res } = mockReqRes();
235
+ await lazyWrapperOf(c, 'getErrors')!(req, res);
236
+ expect(calls).withContext('non-protected getErrors → guard does NOT run').toBe(0);
237
+ });
238
+
239
+ it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot (a fix lenyege)', async (): Promise<void> => {
240
+ // A framework korai singleton-konstrukcioja: az endpoints config NELKUL epul fel...
241
+ const c = new (TestErrorsController as any)();
242
+ c.setupEndpoints();
243
+ // ...es a configure() KESOBB fut (ez volt a fals-200 info-disclosure bug). A lazy wrapper
244
+ // request-idoben olvassa a configot → a guard MEGIS lefut. Ez az FR-263 regresszio-guard.
245
+ let calls: number = 0;
246
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
247
+ const { req, res } = mockReqRes();
248
+ await lazyWrapperOf(c, 'getErrors')!(req, res);
249
+ expect(calls).withContext('guard must run despite configure() AFTER setupEndpoints').toBe(1);
250
+ });
251
+
252
+ it('| getAuthConfig() returns the active config', (): void => {
253
+ const fakeAuth = async (): Promise<void> => { /* noop */ };
254
+ DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: ['logError'] });
255
+ const cfg = DyNTS_Errors_Controller.getAuthConfig();
256
+ expect(cfg.authPreProcess).toBe(fakeAuth);
257
+ expect(cfg.protectedEndpoints).toEqual(['logError']);
258
+ });
259
+
260
+ it('| _resetAuthConfigForTesting() clears the config', (): void => {
261
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
262
+ DyNTS_Errors_Controller._resetAuthConfigForTesting();
263
+ const cfg = DyNTS_Errors_Controller.getAuthConfig();
264
+ expect(cfg.authPreProcess).toBeUndefined();
265
+ });
266
+ });
267
+ });
268
+