@futdevpro/nts-dynamo 1.15.102 → 1.15.104

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