@futdevpro/nts-dynamo 1.15.71 → 1.15.73

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