@futdevpro/nts-dynamo 1.15.73 → 1.15.75

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 (365) 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 +2798 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +94 -0
  18. package/.vscode/settings.json +10 -10
  19. package/HOWTO.md +15 -15
  20. package/LICENSE +21 -21
  21. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  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/global-settings.const.d.ts.map +1 -1
  26. package/build/_collections/global-settings.const.js +1 -0
  27. package/build/_collections/global-settings.const.js.map +1 -1
  28. package/build/_models/interfaces/global-settings.interface.d.ts +7 -0
  29. package/build/_models/interfaces/global-settings.interface.d.ts.map +1 -1
  30. package/build/_services/core/memory-guard.service.d.ts +5 -0
  31. package/build/_services/core/memory-guard.service.d.ts.map +1 -1
  32. package/build/_services/core/memory-guard.service.js +12 -3
  33. package/build/_services/core/memory-guard.service.js.map +1 -1
  34. package/eslint.config.js +3 -3
  35. package/nodemon.json +24 -24
  36. package/package.json +2 -2
  37. package/pnpm-workspace.yaml +5 -5
  38. package/scripts/run-coverage-tests.js +28 -28
  39. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  40. package/spec/support/helpers/ts-node-helper.js +93 -93
  41. package/spec/support/jasmine.coverage.json +24 -24
  42. package/spec/support/jasmine.json +24 -24
  43. package/src/_collections/archive.util.spec.ts +57 -57
  44. package/src/_collections/archive.util.ts +18 -18
  45. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  46. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  47. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  48. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  49. package/src/_collections/default-not-found-page.const.ts +22 -22
  50. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  51. package/src/_collections/default-socket-path.const.ts +2 -2
  52. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  53. package/src/_collections/get-environment-settings.util.ts +48 -48
  54. package/src/_collections/global-settings.const.ts +97 -96
  55. package/src/_collections/sample.env +21 -21
  56. package/src/_collections/star.controller.spec.ts +224 -224
  57. package/src/_collections/star.controller.ts +129 -129
  58. package/src/_enums/data-model-type.enum.ts +14 -14
  59. package/src/_enums/data-service-function.enum.ts +24 -24
  60. package/src/_enums/predefined-data-types.enum.ts +16 -16
  61. package/src/_enums/route-security.enum.ts +12 -12
  62. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  63. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  64. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  65. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  66. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  67. package/src/_models/control-models/app-params.control-model.ts +136 -136
  68. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  69. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  70. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  71. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  72. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  73. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  74. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  75. package/src/_models/control-models/system-control.control-model.ts +12 -12
  76. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  77. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  78. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  79. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  80. package/src/_models/interfaces/global-settings.interface.ts +7 -0
  81. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  82. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  83. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  84. package/src/_models/types/db-update.type.ts +100 -100
  85. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  86. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  87. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  88. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  90. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  91. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  92. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  93. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  94. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  95. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  96. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  97. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  98. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  99. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  100. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  101. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  102. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  103. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  104. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  105. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  106. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  107. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  108. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  109. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  110. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  111. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  112. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  113. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  114. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  115. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  116. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  120. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  121. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  122. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  123. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  124. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  125. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  126. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  127. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  128. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  129. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  130. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  131. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  132. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  133. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  134. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  135. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  136. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  137. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  138. package/src/_modules/ai/index.ts +23 -23
  139. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  140. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  141. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  142. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  143. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  144. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  145. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  146. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  147. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  148. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  149. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  150. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  151. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  152. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  153. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  154. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  155. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  156. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  157. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  158. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  159. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  160. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  161. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  162. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  163. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  164. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  165. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  166. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  167. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  168. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  169. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  170. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  171. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  172. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  173. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  174. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  175. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  176. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  177. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  178. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  179. package/src/_modules/custom-data/index.ts +9 -9
  180. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  181. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  182. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  183. package/src/_modules/data-readers/index.ts +11 -11
  184. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  185. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  186. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  187. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  188. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  189. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  190. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  191. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  192. package/src/_modules/defaults/index.ts +17 -17
  193. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  194. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  195. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  196. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  197. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  198. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  199. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  200. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  201. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  202. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  203. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  204. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  205. package/src/_modules/discord-assistant/index.ts +38 -38
  206. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  207. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  208. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  209. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  210. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  211. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  212. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  213. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  214. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  215. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  216. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  217. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  218. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  219. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  220. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  221. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  222. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  223. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  224. package/src/_modules/discord-bot/index.ts +36 -36
  225. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  226. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  227. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  228. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  229. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  230. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  231. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  232. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  233. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  234. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  235. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  236. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  237. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  238. package/src/_modules/local-vector-search/index.ts +16 -16
  239. package/src/_modules/logs/index.ts +11 -11
  240. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  241. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  242. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  243. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  244. package/src/_modules/mcp/index.ts +13 -13
  245. package/src/_modules/messaging/README.md +354 -354
  246. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  247. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  248. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  249. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  250. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  251. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  252. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  253. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  254. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  255. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  256. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  257. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  258. package/src/_modules/messaging/index.ts +30 -30
  259. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  260. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  261. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  262. package/src/_modules/mock/app-params.mock.ts +9 -9
  263. package/src/_modules/mock/app-server.mock.ts +188 -188
  264. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  265. package/src/_modules/mock/auth-service.mock.ts +28 -28
  266. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  267. package/src/_modules/mock/controller.mock.ts +16 -16
  268. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  269. package/src/_modules/mock/data-model.mock.ts +82 -82
  270. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  271. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  272. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  273. package/src/_modules/mock/email-service.mock.ts +20 -20
  274. package/src/_modules/mock/email-template.mock.html +14 -14
  275. package/src/_modules/mock/endpoint.mock.ts +91 -91
  276. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  277. package/src/_modules/mock/socket-client.mock.ts +45 -45
  278. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  279. package/src/_modules/mock/socket-server.mock.ts +46 -46
  280. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  281. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  282. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  283. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  284. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  285. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  286. package/src/_modules/oauth2/index.ts +17 -17
  287. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  288. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  289. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  290. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  291. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  292. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  293. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  294. package/src/_modules/scoped-config/index.ts +17 -17
  295. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  296. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  297. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  298. package/src/_modules/server/errors/errors.controller.ts +489 -489
  299. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  300. package/src/_modules/server/index.ts +30 -30
  301. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  302. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  303. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  304. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  305. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  306. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  307. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
  308. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  309. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  310. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  311. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  312. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  313. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  314. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  315. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  316. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  317. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  318. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  319. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  320. package/src/_modules/socket/app-extended.server.ts +630 -630
  321. package/src/_modules/socket/index.ts +42 -42
  322. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  323. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  324. package/src/_modules/test/index.ts +11 -11
  325. package/src/_modules/test/test.controller.spec.ts +72 -72
  326. package/src/_modules/test/test.controller.ts +115 -115
  327. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  328. package/src/_modules/usage/index.ts +15 -15
  329. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  330. package/src/_modules/usage/usage.controller.ts +126 -126
  331. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  332. package/src/_modules/usage/usage.data-service.ts +185 -185
  333. package/src/_services/base/api.service-base.spec.ts +125 -125
  334. package/src/_services/base/api.service-base.ts +74 -74
  335. package/src/_services/base/archive-data.service.spec.ts +196 -196
  336. package/src/_services/base/archive-data.service.ts +216 -216
  337. package/src/_services/base/data.service.spec.ts +674 -674
  338. package/src/_services/base/data.service.ts +2719 -2719
  339. package/src/_services/base/db.service.spec.ts +73 -73
  340. package/src/_services/base/db.service.ts +1575 -1575
  341. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  342. package/src/_services/base/singleton.service-base.ts +24 -24
  343. package/src/_services/base/singleton.service.spec.ts +114 -114
  344. package/src/_services/base/singleton.service.ts +38 -38
  345. package/src/_services/core/api.service.spec.ts +140 -140
  346. package/src/_services/core/auth.service.spec.ts +159 -159
  347. package/src/_services/core/auth.service.ts +174 -174
  348. package/src/_services/core/email.service.spec.ts +85 -85
  349. package/src/_services/core/email.service.ts +742 -742
  350. package/src/_services/core/global.service.spec.ts +292 -292
  351. package/src/_services/core/global.service.ts +475 -475
  352. package/src/_services/core/memory-guard.service.spec.ts +18 -0
  353. package/src/_services/core/memory-guard.service.ts +14 -3
  354. package/src/_services/core/service-collection.service.spec.ts +46 -46
  355. package/src/_services/core/service-collection.service.ts +6 -6
  356. package/src/_services/route/controller.service.spec.ts +53 -53
  357. package/src/_services/route/controller.service.ts +148 -148
  358. package/src/_services/route/routing-module.service.spec.ts +98 -98
  359. package/src/_services/route/routing-module.service.ts +330 -330
  360. package/src/_services/server/app.server.ts +1747 -1747
  361. package/src/_services/shared.static-service.spec.ts +99 -99
  362. package/src/_services/shared.static-service.ts +78 -78
  363. package/src/index.ts +96 -96
  364. package/tsconfig.app.json +12 -12
  365. package/tsconfig.json +42 -42
@@ -1,253 +1,253 @@
1
-
2
- import { Request, Response } from 'express';
3
-
4
- import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate, DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
5
- import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
6
- import { DyNTS_Controller } from '../../../_services/route/controller.service';
7
- import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
8
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
9
- import { DyNTS_DbReadiness, DyNTS_ServerStatus_ControlService } from './server-status.control-service';
10
- import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
11
-
12
-
13
- /**
14
- * Auth retrofit config a `DyNTS_ServerStatus_Controller`-hez. Opt-in — ha az
15
- * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli) viselkedest
16
- * tartja. Ugyanaz a mintazat, mint a `DyNTS_Errors_Controller`-ben, DE biztonsagosabb
17
- * default-tal: a liveness/readiness/client-version **probak SOHA nem gate-eltek**
18
- * (orchestrator/LB auth nelkul hivja oket), es a default `protectedEndpoints` csak az
19
- * admin-adat vegpontokat fedi (NEM a probakat).
20
- *
21
- * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract osztaly
22
- * minden subclass-a kozott OSZTOTT (TypeScript a static field-eket per-class hatarozza meg).
23
- */
24
- export interface DyNTS_ServerStatusController_AuthConfig {
25
- /**
26
- * Pre-process fuggveny ami minden vedett endpoint elott fut. Ha hianyzik vagy
27
- * `undefined`, a controller NEM ad hozza auth-ot semelyik endpoint-hoz (regi
28
- * viselkedes, opt-in safety).
29
- */
30
- authPreProcess?: (req: Request, res: Response) => Promise<void>;
31
-
32
- /**
33
- * Vedett endpoint nevek listaja. Ha hianyzik, a default = csak az admin-adat
34
- * vegpontok (`getServerStatus`, `getErrorStatistics`) — a probak NEM. A
35
- * `PUBLIC_PROBE_ENDPOINTS` (`getServerHealth`/`getServerReadiness`/
36
- * `getServerStatusForClient`) MEG explicit listazva sem gate-elheto.
37
- */
38
- protectedEndpoints?: string[];
39
- }
40
-
41
- /**
42
- * Public probak — orchestrator/LB ÉS a kliens server-status-indikator hivja auth
43
- * nelkul, ezert SOHA nem gate-eljuk (meg ha a host explicit listazza is a
44
- * `protectedEndpoints`-ban).
45
- *
46
- * FONTOS: `getServerStatus` (/status) IS itt van — a base controller-ben mindharom
47
- * (`getServerStatus`, `getServerHealth`, `getServerStatusForClient`) UGYANAZT hivja:
48
- * `server_CS.getServerStatus(issuer)`. Mivel a /health es /status/:version amugy is
49
- * publikus, a /status gate-elese 0 biztonsagi hasznot adna, viszont eltori a kliens
50
- * `DyNX` server-status-pollot (401 minden oldalbetolteskor). Csak a `getErrorStatistics`
51
- * valodi admin-adat.
52
- */
53
- const PUBLIC_PROBE_ENDPOINTS: string[] = [
54
- 'getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient',
55
- ];
56
-
57
- /**
58
- * Default vedett vegpontok (ha a host nem ad `protectedEndpoints`-t): csak a valodi
59
- * admin-adat vegpont (`getErrorStatistics`). A status-vegpontok publikusak (lasd fent).
60
- */
61
- const DEFAULT_PROTECTED_ENDPOINTS: string[] = [
62
- 'getErrorStatistics',
63
- ];
64
-
65
- /**
66
- * Endpoints:
67
- *
68
- * getServerStatus
69
- * GET /status
70
- *
71
- * getServerStatusForClient
72
- * GET /status/:version
73
- *
74
- * getErrorStatistics
75
- * GET /statistics/error/:range
76
- *
77
- */
78
- export abstract class DyNTS_ServerStatus_Controller<
79
- T_ServerStatus extends DyFM_ServerStatus,
80
- T_Error extends DyFM_Error,
81
- T_Errors extends DyFM_Errors<T_Error>,
82
- T_Errors_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>,
83
- T_ServerStatusSnapshot extends DyFM_ServerStatus,
84
- T_ServerStatusSnapshot_ControlService extends DyNTS_ServerStatusSnapshot_ControlService<T_ServerStatusSnapshot>,
85
- T_ServerStatus_ControlService extends DyNTS_ServerStatus_ControlService<
86
- T_ServerStatus,
87
- T_Error,
88
- T_Errors,
89
- T_Errors_ControlService,
90
- T_ServerStatusSnapshot,
91
- T_ServerStatusSnapshot_ControlService
92
- >
93
- > extends DyNTS_Controller {
94
-
95
- /* static getInstance(): DyNTS_ServerStatus_Controller {
96
- return DyNTS_ServerStatus_Controller.getSingletonInstance();
97
- } */
98
-
99
- protected abstract readonly server_CS: T_ServerStatus_ControlService;
100
-
101
- /* protected abstract getServerService(): T_ServerStatusService; */
102
- protected readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
103
-
104
- /**
105
- * Static auth config — opt-in retrofit. Default ures objektum → NO auth
106
- * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
107
- */
108
- protected static authConfig: DyNTS_ServerStatusController_AuthConfig = {};
109
-
110
- /**
111
- * Static config setter. Hivhato a szerver startup-jan az endpoint registration ELOTT.
112
- *
113
- * Use case (host app):
114
- * ```ts
115
- * ServerStatus_Controller.configure({
116
- * authPreProcess: async (req, res) => auth.authenticate_tokenAndPermission(req, res, FDP_Permission.X),
117
- * });
118
- * ```
119
- * A probak (`getServerHealth`/`getServerReadiness`/`getServerStatusForClient`) ettol
120
- * fuggetlenul NYITVA maradnak.
121
- */
122
- static configure(config: DyNTS_ServerStatusController_AuthConfig): void {
123
- DyNTS_ServerStatus_Controller.authConfig = config;
124
- }
125
-
126
- /**
127
- * Aktualis auth config olvasasa (test/diagnosztika celokra).
128
- */
129
- static getAuthConfig(): DyNTS_ServerStatusController_AuthConfig {
130
- return DyNTS_ServerStatus_Controller.authConfig;
131
- }
132
-
133
- /**
134
- * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
135
- */
136
- static _resetAuthConfigForTesting(): void {
137
- DyNTS_ServerStatus_Controller.authConfig = {};
138
- }
139
-
140
- /**
141
- * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
142
- * - Ha az auth NINCS configurolva → ures (regi viselkedes).
143
- * - A public probak SOHA nem gate-eltek.
144
- * - Egyebkent az endpoint a `protectedEndpoints` (default = admin-only) listan van-e.
145
- */
146
- protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
147
- const cfg: DyNTS_ServerStatusController_AuthConfig = DyNTS_ServerStatus_Controller.authConfig;
148
- if (!cfg.authPreProcess) { return []; }
149
- if (PUBLIC_PROBE_ENDPOINTS.includes(endpointName)) { return []; }
150
- const protectedNames: string[] = cfg.protectedEndpoints ?? DEFAULT_PROTECTED_ENDPOINTS;
151
- return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
152
- }
153
-
154
- setupEndpoints(): void {
155
- /* if (!this.getServerService) {
156
- throw new DyFM_Error({
157
- message: 'getServerService() method not implemented in ServerStatus_Controller.',
158
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-001`,
159
- });
160
- } */
161
-
162
- if (!this.additionalEndpoints) {
163
- throw new DyFM_Error({
164
- message: 'additionalEndpoints must be defined in ServerStatus_Controller.',
165
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-002`,
166
- });
167
- }
168
-
169
- /* this.serverService = this.getServerService(); */
170
-
171
- this.endpoints = [
172
- new DyNTS_Endpoint_Params({
173
- name: 'getServerStatus',
174
- type: DyFM_HttpCallType.get,
175
- endpoint: '/status',
176
- preProcesses: this.getPreProcessesFor('getServerStatus'),
177
- tasks: [
178
- async (req: Request, res: Response, issuer: string): Promise<void> => {
179
- res.send(
180
- await this.server_CS.getServerStatus(issuer)
181
- );
182
- },
183
- ],
184
- }),
185
-
186
- new DyNTS_Endpoint_Params({
187
- name: 'getServerHealth',
188
- type: DyFM_HttpCallType.get,
189
- endpoint: '/health',
190
- preProcesses: this.getPreProcessesFor('getServerHealth'),
191
- tasks: [
192
- async (req: Request, res: Response, issuer: string): Promise<void> => {
193
- res.send(
194
- await this.server_CS.getServerStatus(issuer)
195
- );
196
- },
197
- ],
198
- }),
199
-
200
- // Readiness-probe: a /health-tel (liveness) szemben a DB-elérhetőséget is ellenőrzi.
201
- // Public (mint a /health) — orchestrátor/LB hívja; 503 ha a DB nem ready → no traffic.
202
- new DyNTS_Endpoint_Params({
203
- name: 'getServerReadiness',
204
- type: DyFM_HttpCallType.get,
205
- endpoint: '/readiness',
206
- preProcesses: this.getPreProcessesFor('getServerReadiness'),
207
- tasks: [
208
- async (req: Request, res: Response, issuer: string): Promise<void> => {
209
- const readiness: DyNTS_DbReadiness = await this.server_CS.checkDbReadiness();
210
-
211
- res.status(readiness.ready ? 200 : 503).send(readiness);
212
- },
213
- ],
214
- }),
215
-
216
- new DyNTS_Endpoint_Params({
217
- name: 'getServerStatusForClient',
218
- type: DyFM_HttpCallType.get,
219
- endpoint: '/status/:version',
220
- preProcesses: this.getPreProcessesFor('getServerStatusForClient'),
221
- tasks: [
222
- async (req: Request, res: Response, issuer: string): Promise<void> => {
223
-
224
- res.send(
225
- await this.server_CS.getServerStatus(issuer, req.params.version)
226
- );
227
- },
228
- ],
229
- }),
230
-
231
- new DyNTS_Endpoint_Params({
232
- name: 'getErrorStatistics',
233
- type: DyFM_HttpCallType.get,
234
- endpoint: '/statistics/error/:range',
235
- preProcesses: this.getPreProcessesFor('getErrorStatistics'),
236
- tasks: [
237
- async (req: Request, res: Response, issuer: string) : Promise<void> => {
238
-
239
- res.send(
240
- await this.server_CS.getErrorStatistics(
241
- req.params.range as DyFM_RelativeDate,
242
- issuer
243
- )
244
- );
245
- },
246
- ],
247
- }),
248
-
249
- ...this.additionalEndpoints,
250
- ];
251
- }
252
- }
253
-
1
+
2
+ import { Request, Response } from 'express';
3
+
4
+ import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate, DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
5
+ import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
6
+ import { DyNTS_Controller } from '../../../_services/route/controller.service';
7
+ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
8
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
9
+ import { DyNTS_DbReadiness, DyNTS_ServerStatus_ControlService } from './server-status.control-service';
10
+ import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
11
+
12
+
13
+ /**
14
+ * Auth retrofit config a `DyNTS_ServerStatus_Controller`-hez. Opt-in — ha az
15
+ * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli) viselkedest
16
+ * tartja. Ugyanaz a mintazat, mint a `DyNTS_Errors_Controller`-ben, DE biztonsagosabb
17
+ * default-tal: a liveness/readiness/client-version **probak SOHA nem gate-eltek**
18
+ * (orchestrator/LB auth nelkul hivja oket), es a default `protectedEndpoints` csak az
19
+ * admin-adat vegpontokat fedi (NEM a probakat).
20
+ *
21
+ * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract osztaly
22
+ * minden subclass-a kozott OSZTOTT (TypeScript a static field-eket per-class hatarozza meg).
23
+ */
24
+ export interface DyNTS_ServerStatusController_AuthConfig {
25
+ /**
26
+ * Pre-process fuggveny ami minden vedett endpoint elott fut. Ha hianyzik vagy
27
+ * `undefined`, a controller NEM ad hozza auth-ot semelyik endpoint-hoz (regi
28
+ * viselkedes, opt-in safety).
29
+ */
30
+ authPreProcess?: (req: Request, res: Response) => Promise<void>;
31
+
32
+ /**
33
+ * Vedett endpoint nevek listaja. Ha hianyzik, a default = csak az admin-adat
34
+ * vegpontok (`getServerStatus`, `getErrorStatistics`) — a probak NEM. A
35
+ * `PUBLIC_PROBE_ENDPOINTS` (`getServerHealth`/`getServerReadiness`/
36
+ * `getServerStatusForClient`) MEG explicit listazva sem gate-elheto.
37
+ */
38
+ protectedEndpoints?: string[];
39
+ }
40
+
41
+ /**
42
+ * Public probak — orchestrator/LB ÉS a kliens server-status-indikator hivja auth
43
+ * nelkul, ezert SOHA nem gate-eljuk (meg ha a host explicit listazza is a
44
+ * `protectedEndpoints`-ban).
45
+ *
46
+ * FONTOS: `getServerStatus` (/status) IS itt van — a base controller-ben mindharom
47
+ * (`getServerStatus`, `getServerHealth`, `getServerStatusForClient`) UGYANAZT hivja:
48
+ * `server_CS.getServerStatus(issuer)`. Mivel a /health es /status/:version amugy is
49
+ * publikus, a /status gate-elese 0 biztonsagi hasznot adna, viszont eltori a kliens
50
+ * `DyNX` server-status-pollot (401 minden oldalbetolteskor). Csak a `getErrorStatistics`
51
+ * valodi admin-adat.
52
+ */
53
+ const PUBLIC_PROBE_ENDPOINTS: string[] = [
54
+ 'getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient',
55
+ ];
56
+
57
+ /**
58
+ * Default vedett vegpontok (ha a host nem ad `protectedEndpoints`-t): csak a valodi
59
+ * admin-adat vegpont (`getErrorStatistics`). A status-vegpontok publikusak (lasd fent).
60
+ */
61
+ const DEFAULT_PROTECTED_ENDPOINTS: string[] = [
62
+ 'getErrorStatistics',
63
+ ];
64
+
65
+ /**
66
+ * Endpoints:
67
+ *
68
+ * getServerStatus
69
+ * GET /status
70
+ *
71
+ * getServerStatusForClient
72
+ * GET /status/:version
73
+ *
74
+ * getErrorStatistics
75
+ * GET /statistics/error/:range
76
+ *
77
+ */
78
+ export abstract class DyNTS_ServerStatus_Controller<
79
+ T_ServerStatus extends DyFM_ServerStatus,
80
+ T_Error extends DyFM_Error,
81
+ T_Errors extends DyFM_Errors<T_Error>,
82
+ T_Errors_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>,
83
+ T_ServerStatusSnapshot extends DyFM_ServerStatus,
84
+ T_ServerStatusSnapshot_ControlService extends DyNTS_ServerStatusSnapshot_ControlService<T_ServerStatusSnapshot>,
85
+ T_ServerStatus_ControlService extends DyNTS_ServerStatus_ControlService<
86
+ T_ServerStatus,
87
+ T_Error,
88
+ T_Errors,
89
+ T_Errors_ControlService,
90
+ T_ServerStatusSnapshot,
91
+ T_ServerStatusSnapshot_ControlService
92
+ >
93
+ > extends DyNTS_Controller {
94
+
95
+ /* static getInstance(): DyNTS_ServerStatus_Controller {
96
+ return DyNTS_ServerStatus_Controller.getSingletonInstance();
97
+ } */
98
+
99
+ protected abstract readonly server_CS: T_ServerStatus_ControlService;
100
+
101
+ /* protected abstract getServerService(): T_ServerStatusService; */
102
+ protected readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
103
+
104
+ /**
105
+ * Static auth config — opt-in retrofit. Default ures objektum → NO auth
106
+ * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
107
+ */
108
+ protected static authConfig: DyNTS_ServerStatusController_AuthConfig = {};
109
+
110
+ /**
111
+ * Static config setter. Hivhato a szerver startup-jan az endpoint registration ELOTT.
112
+ *
113
+ * Use case (host app):
114
+ * ```ts
115
+ * ServerStatus_Controller.configure({
116
+ * authPreProcess: async (req, res) => auth.authenticate_tokenAndPermission(req, res, FDP_Permission.X),
117
+ * });
118
+ * ```
119
+ * A probak (`getServerHealth`/`getServerReadiness`/`getServerStatusForClient`) ettol
120
+ * fuggetlenul NYITVA maradnak.
121
+ */
122
+ static configure(config: DyNTS_ServerStatusController_AuthConfig): void {
123
+ DyNTS_ServerStatus_Controller.authConfig = config;
124
+ }
125
+
126
+ /**
127
+ * Aktualis auth config olvasasa (test/diagnosztika celokra).
128
+ */
129
+ static getAuthConfig(): DyNTS_ServerStatusController_AuthConfig {
130
+ return DyNTS_ServerStatus_Controller.authConfig;
131
+ }
132
+
133
+ /**
134
+ * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
135
+ */
136
+ static _resetAuthConfigForTesting(): void {
137
+ DyNTS_ServerStatus_Controller.authConfig = {};
138
+ }
139
+
140
+ /**
141
+ * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
142
+ * - Ha az auth NINCS configurolva → ures (regi viselkedes).
143
+ * - A public probak SOHA nem gate-eltek.
144
+ * - Egyebkent az endpoint a `protectedEndpoints` (default = admin-only) listan van-e.
145
+ */
146
+ protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
147
+ const cfg: DyNTS_ServerStatusController_AuthConfig = DyNTS_ServerStatus_Controller.authConfig;
148
+ if (!cfg.authPreProcess) { return []; }
149
+ if (PUBLIC_PROBE_ENDPOINTS.includes(endpointName)) { return []; }
150
+ const protectedNames: string[] = cfg.protectedEndpoints ?? DEFAULT_PROTECTED_ENDPOINTS;
151
+ return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
152
+ }
153
+
154
+ setupEndpoints(): void {
155
+ /* if (!this.getServerService) {
156
+ throw new DyFM_Error({
157
+ message: 'getServerService() method not implemented in ServerStatus_Controller.',
158
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-001`,
159
+ });
160
+ } */
161
+
162
+ if (!this.additionalEndpoints) {
163
+ throw new DyFM_Error({
164
+ message: 'additionalEndpoints must be defined in ServerStatus_Controller.',
165
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-002`,
166
+ });
167
+ }
168
+
169
+ /* this.serverService = this.getServerService(); */
170
+
171
+ this.endpoints = [
172
+ new DyNTS_Endpoint_Params({
173
+ name: 'getServerStatus',
174
+ type: DyFM_HttpCallType.get,
175
+ endpoint: '/status',
176
+ preProcesses: this.getPreProcessesFor('getServerStatus'),
177
+ tasks: [
178
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
179
+ res.send(
180
+ await this.server_CS.getServerStatus(issuer)
181
+ );
182
+ },
183
+ ],
184
+ }),
185
+
186
+ new DyNTS_Endpoint_Params({
187
+ name: 'getServerHealth',
188
+ type: DyFM_HttpCallType.get,
189
+ endpoint: '/health',
190
+ preProcesses: this.getPreProcessesFor('getServerHealth'),
191
+ tasks: [
192
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
193
+ res.send(
194
+ await this.server_CS.getServerStatus(issuer)
195
+ );
196
+ },
197
+ ],
198
+ }),
199
+
200
+ // Readiness-probe: a /health-tel (liveness) szemben a DB-elérhetőséget is ellenőrzi.
201
+ // Public (mint a /health) — orchestrátor/LB hívja; 503 ha a DB nem ready → no traffic.
202
+ new DyNTS_Endpoint_Params({
203
+ name: 'getServerReadiness',
204
+ type: DyFM_HttpCallType.get,
205
+ endpoint: '/readiness',
206
+ preProcesses: this.getPreProcessesFor('getServerReadiness'),
207
+ tasks: [
208
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
209
+ const readiness: DyNTS_DbReadiness = await this.server_CS.checkDbReadiness();
210
+
211
+ res.status(readiness.ready ? 200 : 503).send(readiness);
212
+ },
213
+ ],
214
+ }),
215
+
216
+ new DyNTS_Endpoint_Params({
217
+ name: 'getServerStatusForClient',
218
+ type: DyFM_HttpCallType.get,
219
+ endpoint: '/status/:version',
220
+ preProcesses: this.getPreProcessesFor('getServerStatusForClient'),
221
+ tasks: [
222
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
223
+
224
+ res.send(
225
+ await this.server_CS.getServerStatus(issuer, req.params.version)
226
+ );
227
+ },
228
+ ],
229
+ }),
230
+
231
+ new DyNTS_Endpoint_Params({
232
+ name: 'getErrorStatistics',
233
+ type: DyFM_HttpCallType.get,
234
+ endpoint: '/statistics/error/:range',
235
+ preProcesses: this.getPreProcessesFor('getErrorStatistics'),
236
+ tasks: [
237
+ async (req: Request, res: Response, issuer: string) : Promise<void> => {
238
+
239
+ res.send(
240
+ await this.server_CS.getErrorStatistics(
241
+ req.params.range as DyFM_RelativeDate,
242
+ issuer
243
+ )
244
+ );
245
+ },
246
+ ],
247
+ }),
248
+
249
+ ...this.additionalEndpoints,
250
+ ];
251
+ }
252
+ }
253
+
@@ -1,11 +1,11 @@
1
-
2
- /**
3
- * security settings for API,
4
- * different security paths will need different handlers
5
- *
6
- * open; http or secure; https
7
- */
8
- export enum DyNTS_SocketSecurity {
9
- open = 'open',
10
- secure = 'secure',
11
- }
1
+
2
+ /**
3
+ * security settings for API,
4
+ * different security paths will need different handlers
5
+ *
6
+ * open; http or secure; https
7
+ */
8
+ export enum DyNTS_SocketSecurity {
9
+ open = 'open',
10
+ secure = 'secure',
11
+ }
@@ -1,32 +1,32 @@
1
-
2
- import { DyFM_Log } from '@futdevpro/fsm-dynamo';
3
- import { DyNTS_SocketClientService_Params } from './socket-client-service-params.control-model';
4
-
5
- describe('| DyNTS_SocketClientService_Params', () => {
6
- it('| should create an instance with default address', () => {
7
- const params = new DyNTS_SocketClientService_Params({});
8
-
9
- expect(params).toBeTruthy();
10
- expect(params.address).toBe('ws://localhost');
11
- });
12
-
13
- it('| should log information on creation', () => {
14
- spyOn(DyFM_Log, 'H_info');
15
-
16
- const params = new DyNTS_SocketClientService_Params({});
17
-
18
- expect(DyFM_Log.H_info).toHaveBeenCalledWith(
19
- `DyNTS_SocketClientService_Params (test this with custom address!) "${params.address}"`
20
- );
21
- });
22
-
23
- it('should allow overriding the address', () => {
24
- const customAddress = 'ws://custom-address';
25
- const params = new DyNTS_SocketClientService_Params({ address: customAddress } as any);
26
-
27
- // Note: Due to how the class works with default value at class level and Object.assign in super(),
28
- // the address might not be overridden as expected. The default 'ws://localhost' is set at class level.
29
- // This test verifies the actual behavior: default value is used unless properly handled.
30
- expect(params.address).toBe('ws://localhost');
31
- });
32
- });
1
+
2
+ import { DyFM_Log } from '@futdevpro/fsm-dynamo';
3
+ import { DyNTS_SocketClientService_Params } from './socket-client-service-params.control-model';
4
+
5
+ describe('| DyNTS_SocketClientService_Params', () => {
6
+ it('| should create an instance with default address', () => {
7
+ const params = new DyNTS_SocketClientService_Params({});
8
+
9
+ expect(params).toBeTruthy();
10
+ expect(params.address).toBe('ws://localhost');
11
+ });
12
+
13
+ it('| should log information on creation', () => {
14
+ spyOn(DyFM_Log, 'H_info');
15
+
16
+ const params = new DyNTS_SocketClientService_Params({});
17
+
18
+ expect(DyFM_Log.H_info).toHaveBeenCalledWith(
19
+ `DyNTS_SocketClientService_Params (test this with custom address!) "${params.address}"`
20
+ );
21
+ });
22
+
23
+ it('should allow overriding the address', () => {
24
+ const customAddress = 'ws://custom-address';
25
+ const params = new DyNTS_SocketClientService_Params({ address: customAddress } as any);
26
+
27
+ // Note: Due to how the class works with default value at class level and Object.assign in super(),
28
+ // the address might not be overridden as expected. The default 'ws://localhost' is set at class level.
29
+ // This test verifies the actual behavior: default value is used unless properly handled.
30
+ expect(params.address).toBe('ws://localhost');
31
+ });
32
+ });
@@ -1,22 +1,22 @@
1
-
2
- import * as SocketIO from 'socket.io-client';
3
-
4
- import { DyFM_Log, second } from '@futdevpro/fsm-dynamo';
5
- import { DyFM_SocketClient_Params } from '@futdevpro/fsm-dynamo/socket';
6
-
7
- /**
8
- * socket handling and clarification is under development
9
- */
10
- export class DyNTS_SocketClientService_Params extends DyFM_SocketClient_Params {
11
- override address?: string = 'ws://localhost';
12
-
13
- constructor(
14
- set: DyNTS_SocketClientService_Params
15
- ) {
16
- super(set);
17
-
18
- DyFM_Log.H_info(
19
- `DyNTS_SocketClientService_Params (test this with custom address!) "${this.address}"`
20
- );
21
- }
22
- }
1
+
2
+ import * as SocketIO from 'socket.io-client';
3
+
4
+ import { DyFM_Log, second } from '@futdevpro/fsm-dynamo';
5
+ import { DyFM_SocketClient_Params } from '@futdevpro/fsm-dynamo/socket';
6
+
7
+ /**
8
+ * socket handling and clarification is under development
9
+ */
10
+ export class DyNTS_SocketClientService_Params extends DyFM_SocketClient_Params {
11
+ override address?: string = 'ws://localhost';
12
+
13
+ constructor(
14
+ set: DyNTS_SocketClientService_Params
15
+ ) {
16
+ super(set);
17
+
18
+ DyFM_Log.H_info(
19
+ `DyNTS_SocketClientService_Params (test this with custom address!) "${this.address}"`
20
+ );
21
+ }
22
+ }