@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,276 +1,276 @@
1
-
2
- import { DyNTS_ServerStatus_Controller } from './server-status.controller';
3
- import { DyFM_ServerStatus, DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
- import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
5
- import { DyNTS_ServerStatus_ControlService } from './server-status.control-service';
6
- import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
7
- import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
8
-
9
- class TestServerStatus extends DyFM_ServerStatus {
10
- testProperty?: string;
11
- }
12
-
13
- class TestError extends DyFM_Error {
14
- testProperty?: string;
15
- }
16
-
17
- class TestErrors extends DyFM_Errors<TestError> {
18
- testProperty?: string;
19
- }
20
-
21
- class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
22
- async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
23
- async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
24
- checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
25
- getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
26
- async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
27
- async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
28
- async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
29
- async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
30
- return { at: new Date(), by: issuer, version, hypothesis };
31
- }
32
- async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
33
- return { items: [], total: 0, pageIndex, pageSize };
34
- }
35
-
36
- async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
37
- return;
38
- }
39
-
40
- async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
41
- return { items: [], total: 0, pageIndex, pageSize };
42
- }
43
- async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
44
- async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
45
- async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
46
- async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
47
- }
48
-
49
- class TestServerStatusSnapshotControlService extends DyNTS_ServerStatusSnapshot_ControlService<TestServerStatus> {
50
- async saveSnapshot(snapshot: TestServerStatus, issuer: string): Promise<TestServerStatus> {
51
- return snapshot;
52
- }
53
- }
54
-
55
- class TestServerStatusControlService extends DyNTS_ServerStatus_ControlService<
56
- TestServerStatus,
57
- TestError,
58
- TestErrors,
59
- TestErrorsControlService,
60
- TestServerStatus,
61
- TestServerStatusSnapshotControlService
62
- > {
63
- protected getErrorControlService?(set?: { data?: TestErrors, issuer?: string }): TestErrorsControlService {
64
- return new TestErrorsControlService();
65
- }
66
- protected getServerStatusSnapshotControlService?(set?: { data?: TestServerStatus, issuer?: string }): TestServerStatusSnapshotControlService {
67
- return new TestServerStatusSnapshotControlService();
68
- }
69
- protected requiredServerConnections: any[] = [];
70
- }
71
-
72
- class TestServerStatusController extends DyNTS_ServerStatus_Controller<
73
- TestServerStatus,
74
- TestError,
75
- TestErrors,
76
- TestErrorsControlService,
77
- TestServerStatus,
78
- TestServerStatusSnapshotControlService,
79
- TestServerStatusControlService
80
- > {
81
- protected readonly server_CS: TestServerStatusControlService = (TestServerStatusControlService as any).getInstance ? (TestServerStatusControlService as any).getInstance() : new (TestServerStatusControlService as any)();
82
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
83
- }
84
-
85
- describe('| DyNTS_ServerStatus_Controller', () => {
86
- let controller: TestServerStatusController;
87
-
88
- beforeEach(() => {
89
- controller = new (TestServerStatusController as any)();
90
- });
91
-
92
- describe('| setupEndpoints', () => {
93
- it('| should setup all server status endpoints', () => {
94
- controller.setupEndpoints();
95
-
96
- expect(controller.endpoints).toBeDefined();
97
- expect(controller.endpoints.length).toBeGreaterThanOrEqual(4);
98
- });
99
-
100
- it('| should setup getServerStatus endpoint', () => {
101
- controller.setupEndpoints();
102
-
103
- const getServerStatusEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatus');
104
- expect(getServerStatusEndpoint).toBeDefined();
105
- expect(getServerStatusEndpoint?.type).toBe(DyFM_HttpCallType.get);
106
- expect(getServerStatusEndpoint?.endpoint).toBe('/status');
107
- expect((getServerStatusEndpoint as any)?.tasks).toBeDefined();
108
- expect((getServerStatusEndpoint as any)?.tasks?.length).toBe(1);
109
- });
110
-
111
- it('| should setup getServerHealth endpoint', () => {
112
- controller.setupEndpoints();
113
-
114
- const getServerHealthEndpoint = controller.endpoints.find(ep => ep.name === 'getServerHealth');
115
- expect(getServerHealthEndpoint).toBeDefined();
116
- expect(getServerHealthEndpoint?.type).toBe(DyFM_HttpCallType.get);
117
- expect(getServerHealthEndpoint?.endpoint).toBe('/health');
118
- expect((getServerHealthEndpoint as any)?.tasks).toBeDefined();
119
- expect((getServerHealthEndpoint as any)?.tasks?.length).toBe(1);
120
- });
121
-
122
- it('| should setup getServerStatusForClient endpoint', () => {
123
- controller.setupEndpoints();
124
-
125
- const getServerStatusForClientEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatusForClient');
126
- expect(getServerStatusForClientEndpoint).toBeDefined();
127
- expect(getServerStatusForClientEndpoint?.type).toBe(DyFM_HttpCallType.get);
128
- expect(getServerStatusForClientEndpoint?.endpoint).toBe('/status/:version');
129
- expect((getServerStatusForClientEndpoint as any)?.tasks).toBeDefined();
130
- expect((getServerStatusForClientEndpoint as any)?.tasks?.length).toBe(1);
131
- });
132
-
133
- it('| should setup getErrorStatistics endpoint', () => {
134
- controller.setupEndpoints();
135
-
136
- const getErrorStatisticsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorStatistics');
137
- expect(getErrorStatisticsEndpoint).toBeDefined();
138
- expect(getErrorStatisticsEndpoint?.type).toBe(DyFM_HttpCallType.get);
139
- expect(getErrorStatisticsEndpoint?.endpoint).toBe('/statistics/error/:range');
140
- expect((getErrorStatisticsEndpoint as any)?.tasks).toBeDefined();
141
- expect((getErrorStatisticsEndpoint as any)?.tasks?.length).toBe(1);
142
- });
143
-
144
- it('| should include additionalEndpoints', () => {
145
- const additionalEndpoint = new DyNTS_Endpoint_Params({
146
- name: 'customEndpoint',
147
- type: DyFM_HttpCallType.get,
148
- endpoint: '/status/custom',
149
- tasks: [],
150
- });
151
- (controller as any).additionalEndpoints.push(additionalEndpoint);
152
-
153
- controller.setupEndpoints();
154
-
155
- const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
156
- expect(customEndpoint).toBeDefined();
157
- });
158
-
159
- it('| should throw error when additionalEndpoints is not defined', () => {
160
- const controllerWithoutEndpoints = new (class extends TestServerStatusController {
161
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
162
- } as any)();
163
-
164
- expect(() => {
165
- controllerWithoutEndpoints.setupEndpoints();
166
- }).toThrow();
167
- });
168
- });
169
-
170
- describe('| opt-in admin auth retrofit', (): void => {
171
- afterEach((): void => {
172
- DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
173
- });
174
-
175
- // FR-263 — a guard request-idoben fut (lazy wrapper). "Gated-e egy endpoint" = a wrapper
176
- // meghivasa lefuttatja-e a configured authPreProcess-t. A counter-t a teszt-spy lepteti.
177
- let guardCalls: number = 0;
178
- const spyAuth = async (): Promise<void> => { guardCalls++; };
179
- const runGuard = async (c: any, name: string): Promise<void> => {
180
- const ep: any = c.endpoints.find((e: any) => e.name === name);
181
- await ep?.preProcesses?.[0]?.({} as any, { headersSent: false } as any);
182
- };
183
- beforeEach((): void => { guardCalls = 0; });
184
-
185
- it('| default (no config): a wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
186
- controller.setupEndpoints();
187
- for (const ep of controller.endpoints) {
188
- await (ep as any).preProcesses?.[0]?.({} as any, { headersSent: false } as any); // no-op, nem dob
189
- }
190
- expect(guardCalls).toBe(0);
191
- });
192
-
193
- it('| configure({ authPreProcess }) → CSAK getErrorStatistics-en fut a guard, a status-vegpontokon NEM', async (): Promise<void> => {
194
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth });
195
- const c: any = new (TestServerStatusController as any)();
196
- c.setupEndpoints();
197
- await runGuard(c, 'getErrorStatistics');
198
- expect(guardCalls).withContext('admin-adat → gated').toBe(1);
199
- guardCalls = 0;
200
- for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
201
- await runGuard(c, name);
202
- }
203
- expect(guardCalls).withContext('status-probak SOHA nem gated').toBe(0);
204
- });
205
-
206
- it('| a status-vegpontokat explicit protectedEndpoints-lista SEM gate-eli (PUBLIC_PROBE kizart)', async (): Promise<void> => {
207
- DyNTS_ServerStatus_Controller.configure({
208
- authPreProcess: spyAuth,
209
- protectedEndpoints: [ 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient', 'getServerStatus', 'getErrorStatistics' ],
210
- });
211
- const c: any = new (TestServerStatusController as any)();
212
- c.setupEndpoints();
213
- for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
214
- await runGuard(c, name);
215
- }
216
- expect(guardCalls).withContext('status-probak kizartak meg explicit listan is').toBe(0);
217
- await runGuard(c, 'getErrorStatistics');
218
- expect(guardCalls).withContext('getErrorStatistics gated').toBe(1);
219
- });
220
-
221
- it('| protectedEndpoints subset → getErrorStatistics gated, getServerStatus NEM', async (): Promise<void> => {
222
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
223
- const c: any = new (TestServerStatusController as any)();
224
- c.setupEndpoints();
225
- await runGuard(c, 'getErrorStatistics');
226
- expect(guardCalls).toBe(1);
227
- guardCalls = 0;
228
- await runGuard(c, 'getServerStatus');
229
- expect(guardCalls).toBe(0);
230
- });
231
-
232
- it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot', async (): Promise<void> => {
233
- const c: any = new (TestServerStatusController as any)();
234
- c.setupEndpoints(); // config NELKUL (korai framework-konstrukcio szimulacioja)
235
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // configure UTANA
236
- await runGuard(c, 'getErrorStatistics');
237
- expect(guardCalls).withContext('guard runs despite configure() AFTER setupEndpoints').toBe(1);
238
- });
239
-
240
- // 2026-07-22 — a `/diag` EGYIK listaban sem szerepelt (sem publikus-proba, sem default-vedett),
241
- // ezert MINDEN FDP-szolgaltatason NYITOTT volt: elesben 200 + event-loop lag-history, aktiv
242
- // handle-ok, memoria-nyomas, uptime. Nem szandek volt, hanem kimaradas. Ez a teszt rogziti, hogy
243
- // explicit lista NELKUL a diag VEDETT — es hogy a publikus probak ettol valtozatlanul nyitva vannak.
244
- it('| getServerDiag is protected BY DEFAULT, while the public probes stay open', async (): Promise<void> => {
245
- const c: any = new (TestServerStatusController as any)(); // ccap-review-disable-line no-any-type
246
- c.setupEndpoints();
247
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // NINCS explicit lista → default
248
-
249
- await runGuard(c, 'getServerDiag');
250
- expect(guardCalls).withContext('a /diag guard-olt a default listaval').toBe(1);
251
-
252
- guardCalls = 0;
253
- await runGuard(c, 'getServerHealth');
254
- expect(guardCalls).withContext('a publikus proba NEM gate-elt').toBe(0);
255
-
256
- guardCalls = 0;
257
- await runGuard(c, 'getServerReadiness');
258
- expect(guardCalls).withContext('a readiness-proba NEM gate-elt').toBe(0);
259
- });
260
-
261
- it('| getAuthConfig() returns the active config', (): void => {
262
- const fakeAuth = async (): Promise<void> => { /* noop */ };
263
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
264
- const cfg = DyNTS_ServerStatus_Controller.getAuthConfig();
265
- expect(cfg.authPreProcess).toBe(fakeAuth);
266
- expect(cfg.protectedEndpoints).toEqual([ 'getErrorStatistics' ]);
267
- });
268
-
269
- it('| _resetAuthConfigForTesting() clears the config', (): void => {
270
- DyNTS_ServerStatus_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
271
- DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
272
- expect(DyNTS_ServerStatus_Controller.getAuthConfig().authPreProcess).toBeUndefined();
273
- });
274
- });
275
- });
276
-
1
+
2
+ import { DyNTS_ServerStatus_Controller } from './server-status.controller';
3
+ import { DyFM_ServerStatus, DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
+ import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
5
+ import { DyNTS_ServerStatus_ControlService } from './server-status.control-service';
6
+ import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
7
+ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
8
+
9
+ class TestServerStatus extends DyFM_ServerStatus {
10
+ testProperty?: string;
11
+ }
12
+
13
+ class TestError extends DyFM_Error {
14
+ testProperty?: string;
15
+ }
16
+
17
+ class TestErrors extends DyFM_Errors<TestError> {
18
+ testProperty?: string;
19
+ }
20
+
21
+ class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
22
+ async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
23
+ async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
24
+ checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
25
+ getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
26
+ async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
27
+ async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
28
+ async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
29
+ async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
30
+ return { at: new Date(), by: issuer, version, hypothesis };
31
+ }
32
+ async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
33
+ return { items: [], total: 0, pageIndex, pageSize };
34
+ }
35
+
36
+ async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
37
+ return;
38
+ }
39
+
40
+ async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
41
+ return { items: [], total: 0, pageIndex, pageSize };
42
+ }
43
+ async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
44
+ async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
45
+ async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
46
+ async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
47
+ }
48
+
49
+ class TestServerStatusSnapshotControlService extends DyNTS_ServerStatusSnapshot_ControlService<TestServerStatus> {
50
+ async saveSnapshot(snapshot: TestServerStatus, issuer: string): Promise<TestServerStatus> {
51
+ return snapshot;
52
+ }
53
+ }
54
+
55
+ class TestServerStatusControlService extends DyNTS_ServerStatus_ControlService<
56
+ TestServerStatus,
57
+ TestError,
58
+ TestErrors,
59
+ TestErrorsControlService,
60
+ TestServerStatus,
61
+ TestServerStatusSnapshotControlService
62
+ > {
63
+ protected getErrorControlService?(set?: { data?: TestErrors, issuer?: string }): TestErrorsControlService {
64
+ return new TestErrorsControlService();
65
+ }
66
+ protected getServerStatusSnapshotControlService?(set?: { data?: TestServerStatus, issuer?: string }): TestServerStatusSnapshotControlService {
67
+ return new TestServerStatusSnapshotControlService();
68
+ }
69
+ protected requiredServerConnections: any[] = [];
70
+ }
71
+
72
+ class TestServerStatusController extends DyNTS_ServerStatus_Controller<
73
+ TestServerStatus,
74
+ TestError,
75
+ TestErrors,
76
+ TestErrorsControlService,
77
+ TestServerStatus,
78
+ TestServerStatusSnapshotControlService,
79
+ TestServerStatusControlService
80
+ > {
81
+ protected readonly server_CS: TestServerStatusControlService = (TestServerStatusControlService as any).getInstance ? (TestServerStatusControlService as any).getInstance() : new (TestServerStatusControlService as any)();
82
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
83
+ }
84
+
85
+ describe('| DyNTS_ServerStatus_Controller', () => {
86
+ let controller: TestServerStatusController;
87
+
88
+ beforeEach(() => {
89
+ controller = new (TestServerStatusController as any)();
90
+ });
91
+
92
+ describe('| setupEndpoints', () => {
93
+ it('| should setup all server status endpoints', () => {
94
+ controller.setupEndpoints();
95
+
96
+ expect(controller.endpoints).toBeDefined();
97
+ expect(controller.endpoints.length).toBeGreaterThanOrEqual(4);
98
+ });
99
+
100
+ it('| should setup getServerStatus endpoint', () => {
101
+ controller.setupEndpoints();
102
+
103
+ const getServerStatusEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatus');
104
+ expect(getServerStatusEndpoint).toBeDefined();
105
+ expect(getServerStatusEndpoint?.type).toBe(DyFM_HttpCallType.get);
106
+ expect(getServerStatusEndpoint?.endpoint).toBe('/status');
107
+ expect((getServerStatusEndpoint as any)?.tasks).toBeDefined();
108
+ expect((getServerStatusEndpoint as any)?.tasks?.length).toBe(1);
109
+ });
110
+
111
+ it('| should setup getServerHealth endpoint', () => {
112
+ controller.setupEndpoints();
113
+
114
+ const getServerHealthEndpoint = controller.endpoints.find(ep => ep.name === 'getServerHealth');
115
+ expect(getServerHealthEndpoint).toBeDefined();
116
+ expect(getServerHealthEndpoint?.type).toBe(DyFM_HttpCallType.get);
117
+ expect(getServerHealthEndpoint?.endpoint).toBe('/health');
118
+ expect((getServerHealthEndpoint as any)?.tasks).toBeDefined();
119
+ expect((getServerHealthEndpoint as any)?.tasks?.length).toBe(1);
120
+ });
121
+
122
+ it('| should setup getServerStatusForClient endpoint', () => {
123
+ controller.setupEndpoints();
124
+
125
+ const getServerStatusForClientEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatusForClient');
126
+ expect(getServerStatusForClientEndpoint).toBeDefined();
127
+ expect(getServerStatusForClientEndpoint?.type).toBe(DyFM_HttpCallType.get);
128
+ expect(getServerStatusForClientEndpoint?.endpoint).toBe('/status/:version');
129
+ expect((getServerStatusForClientEndpoint as any)?.tasks).toBeDefined();
130
+ expect((getServerStatusForClientEndpoint as any)?.tasks?.length).toBe(1);
131
+ });
132
+
133
+ it('| should setup getErrorStatistics endpoint', () => {
134
+ controller.setupEndpoints();
135
+
136
+ const getErrorStatisticsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorStatistics');
137
+ expect(getErrorStatisticsEndpoint).toBeDefined();
138
+ expect(getErrorStatisticsEndpoint?.type).toBe(DyFM_HttpCallType.get);
139
+ expect(getErrorStatisticsEndpoint?.endpoint).toBe('/statistics/error/:range');
140
+ expect((getErrorStatisticsEndpoint as any)?.tasks).toBeDefined();
141
+ expect((getErrorStatisticsEndpoint as any)?.tasks?.length).toBe(1);
142
+ });
143
+
144
+ it('| should include additionalEndpoints', () => {
145
+ const additionalEndpoint = new DyNTS_Endpoint_Params({
146
+ name: 'customEndpoint',
147
+ type: DyFM_HttpCallType.get,
148
+ endpoint: '/status/custom',
149
+ tasks: [],
150
+ });
151
+ (controller as any).additionalEndpoints.push(additionalEndpoint);
152
+
153
+ controller.setupEndpoints();
154
+
155
+ const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
156
+ expect(customEndpoint).toBeDefined();
157
+ });
158
+
159
+ it('| should throw error when additionalEndpoints is not defined', () => {
160
+ const controllerWithoutEndpoints = new (class extends TestServerStatusController {
161
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
162
+ } as any)();
163
+
164
+ expect(() => {
165
+ controllerWithoutEndpoints.setupEndpoints();
166
+ }).toThrow();
167
+ });
168
+ });
169
+
170
+ describe('| opt-in admin auth retrofit', (): void => {
171
+ afterEach((): void => {
172
+ DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
173
+ });
174
+
175
+ // FR-263 — a guard request-idoben fut (lazy wrapper). "Gated-e egy endpoint" = a wrapper
176
+ // meghivasa lefuttatja-e a configured authPreProcess-t. A counter-t a teszt-spy lepteti.
177
+ let guardCalls: number = 0;
178
+ const spyAuth = async (): Promise<void> => { guardCalls++; };
179
+ const runGuard = async (c: any, name: string): Promise<void> => {
180
+ const ep: any = c.endpoints.find((e: any) => e.name === name);
181
+ await ep?.preProcesses?.[0]?.({} as any, { headersSent: false } as any);
182
+ };
183
+ beforeEach((): void => { guardCalls = 0; });
184
+
185
+ it('| default (no config): a wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
186
+ controller.setupEndpoints();
187
+ for (const ep of controller.endpoints) {
188
+ await (ep as any).preProcesses?.[0]?.({} as any, { headersSent: false } as any); // no-op, nem dob
189
+ }
190
+ expect(guardCalls).toBe(0);
191
+ });
192
+
193
+ it('| configure({ authPreProcess }) → CSAK getErrorStatistics-en fut a guard, a status-vegpontokon NEM', async (): Promise<void> => {
194
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth });
195
+ const c: any = new (TestServerStatusController as any)();
196
+ c.setupEndpoints();
197
+ await runGuard(c, 'getErrorStatistics');
198
+ expect(guardCalls).withContext('admin-adat → gated').toBe(1);
199
+ guardCalls = 0;
200
+ for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
201
+ await runGuard(c, name);
202
+ }
203
+ expect(guardCalls).withContext('status-probak SOHA nem gated').toBe(0);
204
+ });
205
+
206
+ it('| a status-vegpontokat explicit protectedEndpoints-lista SEM gate-eli (PUBLIC_PROBE kizart)', async (): Promise<void> => {
207
+ DyNTS_ServerStatus_Controller.configure({
208
+ authPreProcess: spyAuth,
209
+ protectedEndpoints: [ 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient', 'getServerStatus', 'getErrorStatistics' ],
210
+ });
211
+ const c: any = new (TestServerStatusController as any)();
212
+ c.setupEndpoints();
213
+ for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
214
+ await runGuard(c, name);
215
+ }
216
+ expect(guardCalls).withContext('status-probak kizartak meg explicit listan is').toBe(0);
217
+ await runGuard(c, 'getErrorStatistics');
218
+ expect(guardCalls).withContext('getErrorStatistics gated').toBe(1);
219
+ });
220
+
221
+ it('| protectedEndpoints subset → getErrorStatistics gated, getServerStatus NEM', async (): Promise<void> => {
222
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
223
+ const c: any = new (TestServerStatusController as any)();
224
+ c.setupEndpoints();
225
+ await runGuard(c, 'getErrorStatistics');
226
+ expect(guardCalls).toBe(1);
227
+ guardCalls = 0;
228
+ await runGuard(c, 'getServerStatus');
229
+ expect(guardCalls).toBe(0);
230
+ });
231
+
232
+ it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot', async (): Promise<void> => {
233
+ const c: any = new (TestServerStatusController as any)();
234
+ c.setupEndpoints(); // config NELKUL (korai framework-konstrukcio szimulacioja)
235
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // configure UTANA
236
+ await runGuard(c, 'getErrorStatistics');
237
+ expect(guardCalls).withContext('guard runs despite configure() AFTER setupEndpoints').toBe(1);
238
+ });
239
+
240
+ // 2026-07-22 — a `/diag` EGYIK listaban sem szerepelt (sem publikus-proba, sem default-vedett),
241
+ // ezert MINDEN FDP-szolgaltatason NYITOTT volt: elesben 200 + event-loop lag-history, aktiv
242
+ // handle-ok, memoria-nyomas, uptime. Nem szandek volt, hanem kimaradas. Ez a teszt rogziti, hogy
243
+ // explicit lista NELKUL a diag VEDETT — es hogy a publikus probak ettol valtozatlanul nyitva vannak.
244
+ it('| getServerDiag is protected BY DEFAULT, while the public probes stay open', async (): Promise<void> => {
245
+ const c: any = new (TestServerStatusController as any)(); // ccap-review-disable-line no-any-type
246
+ c.setupEndpoints();
247
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // NINCS explicit lista → default
248
+
249
+ await runGuard(c, 'getServerDiag');
250
+ expect(guardCalls).withContext('a /diag guard-olt a default listaval').toBe(1);
251
+
252
+ guardCalls = 0;
253
+ await runGuard(c, 'getServerHealth');
254
+ expect(guardCalls).withContext('a publikus proba NEM gate-elt').toBe(0);
255
+
256
+ guardCalls = 0;
257
+ await runGuard(c, 'getServerReadiness');
258
+ expect(guardCalls).withContext('a readiness-proba NEM gate-elt').toBe(0);
259
+ });
260
+
261
+ it('| getAuthConfig() returns the active config', (): void => {
262
+ const fakeAuth = async (): Promise<void> => { /* noop */ };
263
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
264
+ const cfg = DyNTS_ServerStatus_Controller.getAuthConfig();
265
+ expect(cfg.authPreProcess).toBe(fakeAuth);
266
+ expect(cfg.protectedEndpoints).toEqual([ 'getErrorStatistics' ]);
267
+ });
268
+
269
+ it('| _resetAuthConfigForTesting() clears the config', (): void => {
270
+ DyNTS_ServerStatus_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
271
+ DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
272
+ expect(DyNTS_ServerStatus_Controller.getAuthConfig().authPreProcess).toBeUndefined();
273
+ });
274
+ });
275
+ });
276
+