@futdevpro/nts-dynamo 1.15.144 → 1.15.145

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 (369) 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 +3034 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.vscode/settings.json +10 -10
  19. package/HOWTO.md +15 -15
  20. package/LICENSE +21 -21
  21. package/__documentations/2026-08-18-artifact-compiler.md +3 -1
  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/_services/core/collection-growth-monitor.service.d.ts +1 -1
  28. package/build/_services/core/collection-growth-monitor.service.d.ts.map +1 -1
  29. package/build/_services/core/collection-growth-monitor.service.js +24 -5
  30. package/build/_services/core/collection-growth-monitor.service.js.map +1 -1
  31. package/eslint.config.js +3 -3
  32. package/nodemon.json +24 -24
  33. package/package.json +1 -1
  34. package/pnpm-workspace.yaml +2 -2
  35. package/scripts/run-coverage-tests.js +28 -28
  36. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  37. package/spec/support/helpers/ts-node-helper.js +93 -93
  38. package/spec/support/jasmine.coverage.json +24 -24
  39. package/spec/support/jasmine.json +24 -24
  40. package/src/_collections/archive.util.spec.ts +57 -57
  41. package/src/_collections/archive.util.ts +18 -18
  42. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  43. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  44. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  45. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  46. package/src/_collections/default-not-found-page.const.ts +22 -22
  47. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  48. package/src/_collections/default-socket-path.const.ts +2 -2
  49. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  50. package/src/_collections/get-environment-settings.util.ts +48 -48
  51. package/src/_collections/global-settings.const.ts +126 -126
  52. package/src/_collections/sample.env +21 -21
  53. package/src/_collections/signed-url.util.spec.ts +198 -198
  54. package/src/_collections/signed-url.util.ts +170 -170
  55. package/src/_collections/star.controller.spec.ts +224 -224
  56. package/src/_collections/star.controller.ts +129 -129
  57. package/src/_enums/data-model-type.enum.ts +14 -14
  58. package/src/_enums/data-service-function.enum.ts +24 -24
  59. package/src/_enums/predefined-data-types.enum.ts +16 -16
  60. package/src/_enums/route-security.enum.ts +12 -12
  61. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  62. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  63. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  64. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  65. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  66. package/src/_models/control-models/app-params.control-model.ts +136 -136
  67. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  68. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  69. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  70. package/src/_models/control-models/endpoint-params.control-model.ts +664 -664
  71. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  72. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  73. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  74. package/src/_models/control-models/system-control.control-model.ts +12 -12
  75. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  76. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  77. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  78. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  79. package/src/_models/interfaces/global-settings.interface.ts +294 -294
  80. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  81. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  82. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  83. package/src/_models/types/db-update.type.ts +100 -100
  84. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  85. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  86. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  87. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  88. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  89. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  90. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  91. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  92. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  93. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  94. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  95. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  96. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  97. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  98. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  99. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  100. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  101. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  102. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  103. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  104. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  105. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  106. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  107. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  108. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  109. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  110. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  111. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  112. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  113. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  114. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  115. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  116. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  117. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  120. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  121. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  122. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  123. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  124. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  125. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  126. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  127. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  128. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  129. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  130. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  131. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  132. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  133. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  134. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  135. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  136. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  137. package/src/_modules/ai/index.ts +33 -33
  138. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  139. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  140. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  141. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  142. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  143. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  144. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  145. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  146. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  147. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  148. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  149. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  150. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  151. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  152. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  153. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  154. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  155. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  156. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  157. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  158. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  159. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  160. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  161. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  162. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  163. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  164. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  165. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  166. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  167. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  168. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  169. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  170. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  171. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  172. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  173. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  174. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  175. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  176. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  177. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  178. package/src/_modules/custom-data/index.ts +9 -9
  179. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  180. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  181. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  182. package/src/_modules/data-readers/index.ts +11 -11
  183. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  184. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  185. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  186. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  187. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  188. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  189. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  190. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  191. package/src/_modules/defaults/index.ts +17 -17
  192. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  193. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  194. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  195. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  196. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  197. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  198. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  199. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  200. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  201. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  202. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  203. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  204. package/src/_modules/discord-assistant/index.ts +38 -38
  205. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  206. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  207. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  208. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  209. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  210. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  211. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  212. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  213. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  214. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  215. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  216. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  217. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  218. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  219. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  220. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  221. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  222. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  223. package/src/_modules/discord-bot/index.ts +36 -36
  224. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  225. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  226. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  227. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  228. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  229. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  230. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  231. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  232. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  233. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  234. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  235. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  236. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  237. package/src/_modules/local-vector-search/index.ts +16 -16
  238. package/src/_modules/logs/index.ts +11 -11
  239. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  240. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  241. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  242. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  243. package/src/_modules/mcp/index.ts +13 -13
  244. package/src/_modules/messaging/README.md +354 -354
  245. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  246. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  247. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  248. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  249. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  250. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  251. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  252. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  253. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  254. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  255. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  256. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  257. package/src/_modules/messaging/index.ts +30 -30
  258. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  259. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  260. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  261. package/src/_modules/mock/app-params.mock.ts +9 -9
  262. package/src/_modules/mock/app-server.mock.ts +188 -188
  263. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  264. package/src/_modules/mock/auth-service.mock.ts +28 -28
  265. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  266. package/src/_modules/mock/controller.mock.ts +16 -16
  267. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  268. package/src/_modules/mock/data-model.mock.ts +82 -82
  269. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  270. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  271. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  272. package/src/_modules/mock/email-service.mock.ts +20 -20
  273. package/src/_modules/mock/email-template.mock.html +14 -14
  274. package/src/_modules/mock/endpoint.mock.ts +91 -91
  275. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  276. package/src/_modules/mock/socket-client.mock.ts +45 -45
  277. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  278. package/src/_modules/mock/socket-server.mock.ts +46 -46
  279. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  280. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  281. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  282. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  283. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  284. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  285. package/src/_modules/oauth2/index.ts +17 -17
  286. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  287. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  288. package/src/_modules/scheduler/index.ts +8 -8
  289. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  290. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  291. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  292. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  293. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  294. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  295. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  296. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  297. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  298. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  299. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  300. package/src/_modules/scoped-config/index.ts +17 -17
  301. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  302. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  303. package/src/_modules/server/errors/errors.controller.ts +559 -559
  304. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  305. package/src/_modules/server/index.ts +30 -30
  306. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  307. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  308. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  309. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  310. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  311. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  312. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  313. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  314. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  315. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  316. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  317. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +158 -158
  318. package/src/_modules/socket/_models/socket-presence.control-model.ts +209 -209
  319. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  320. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  321. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  322. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  323. package/src/_modules/socket/app-extended.server.ts +648 -648
  324. package/src/_modules/socket/index.ts +42 -42
  325. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  326. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  327. package/src/_modules/test/index.ts +11 -11
  328. package/src/_modules/test/test.controller.spec.ts +72 -72
  329. package/src/_modules/test/test.controller.ts +115 -115
  330. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  331. package/src/_modules/usage/index.ts +15 -15
  332. package/src/_modules/usage/usage.controller.spec.ts +106 -106
  333. package/src/_modules/usage/usage.controller.ts +140 -140
  334. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  335. package/src/_modules/usage/usage.data-service.ts +185 -185
  336. package/src/_services/base/api.service-base.spec.ts +125 -125
  337. package/src/_services/base/api.service-base.ts +74 -74
  338. package/src/_services/base/archive-data.service.spec.ts +209 -209
  339. package/src/_services/base/archive-data.service.ts +223 -223
  340. package/src/_services/base/data.service.spec.ts +784 -784
  341. package/src/_services/base/data.service.ts +2792 -2792
  342. package/src/_services/base/db.service.spec.ts +160 -160
  343. package/src/_services/base/db.service.ts +1698 -1698
  344. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  345. package/src/_services/base/singleton.service-base.ts +24 -24
  346. package/src/_services/base/singleton.service.spec.ts +114 -114
  347. package/src/_services/base/singleton.service.ts +38 -38
  348. package/src/_services/core/api.service.spec.ts +140 -140
  349. package/src/_services/core/auth.service.spec.ts +159 -159
  350. package/src/_services/core/auth.service.ts +174 -174
  351. package/src/_services/core/collection-growth-monitor.service.spec.ts +53 -1
  352. package/src/_services/core/collection-growth-monitor.service.ts +29 -6
  353. package/src/_services/core/email.service.spec.ts +85 -85
  354. package/src/_services/core/email.service.ts +757 -757
  355. package/src/_services/core/global.service.spec.ts +292 -292
  356. package/src/_services/core/global.service.ts +487 -487
  357. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  358. package/src/_services/core/memory-guard.service.ts +481 -481
  359. package/src/_services/core/service-collection.service.spec.ts +46 -46
  360. package/src/_services/core/service-collection.service.ts +6 -6
  361. package/src/_services/route/controller.service.spec.ts +53 -53
  362. package/src/_services/route/controller.service.ts +148 -148
  363. package/src/_services/route/routing-module.service.spec.ts +98 -98
  364. package/src/_services/route/routing-module.service.ts +330 -330
  365. package/src/_services/server/app.server.ts +2012 -2012
  366. package/src/_services/shared.static-service.spec.ts +99 -99
  367. package/src/_services/shared.static-service.ts +78 -78
  368. package/tsconfig.app.json +12 -12
  369. 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
+