@futdevpro/nts-dynamo 1.15.127 → 1.15.128

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (384) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/logs/cicd-pipeline/output.log +2864 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.dynamo/pipeline.cicd.config.json +3 -1
  19. package/.vscode/settings.json +10 -10
  20. package/HOWTO.md +15 -15
  21. package/LICENSE +21 -21
  22. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  23. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  24. package/_specifications/BACKLOG.md +92 -92
  25. package/_specifications/TODO.md +15 -15
  26. package/_specifications/agent.md +138 -138
  27. package/build/_models/control-models/endpoint-params.control-model.d.ts.map +1 -1
  28. package/build/_models/control-models/endpoint-params.control-model.js +9 -0
  29. package/build/_models/control-models/endpoint-params.control-model.js.map +1 -1
  30. package/build/_services/core/event-loop-diag.service.d.ts +6 -0
  31. package/build/_services/core/event-loop-diag.service.d.ts.map +1 -1
  32. package/build/_services/core/event-loop-diag.service.js +19 -1
  33. package/build/_services/core/event-loop-diag.service.js.map +1 -1
  34. package/build/_services/core/request-hunter.service.d.ts +74 -0
  35. package/build/_services/core/request-hunter.service.d.ts.map +1 -0
  36. package/build/_services/core/request-hunter.service.js +123 -0
  37. package/build/_services/core/request-hunter.service.js.map +1 -0
  38. package/build/index.d.ts +1 -0
  39. package/build/index.d.ts.map +1 -1
  40. package/build/index.js +1 -0
  41. package/build/index.js.map +1 -1
  42. package/eslint.config.js +3 -3
  43. package/nodemon.json +24 -24
  44. package/package.json +2 -2
  45. package/pnpm-workspace.yaml +5 -5
  46. package/scripts/run-coverage-tests.js +28 -28
  47. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  48. package/spec/support/helpers/ts-node-helper.js +93 -93
  49. package/spec/support/jasmine.coverage.json +24 -24
  50. package/spec/support/jasmine.json +24 -24
  51. package/src/_collections/archive.util.spec.ts +57 -57
  52. package/src/_collections/archive.util.ts +18 -18
  53. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  54. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  55. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  56. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  57. package/src/_collections/default-not-found-page.const.ts +22 -22
  58. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  59. package/src/_collections/default-socket-path.const.ts +2 -2
  60. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  61. package/src/_collections/get-environment-settings.util.ts +48 -48
  62. package/src/_collections/global-settings.const.ts +126 -126
  63. package/src/_collections/sample.env +21 -21
  64. package/src/_collections/signed-url.util.spec.ts +198 -198
  65. package/src/_collections/signed-url.util.ts +170 -170
  66. package/src/_collections/star.controller.spec.ts +224 -224
  67. package/src/_collections/star.controller.ts +129 -129
  68. package/src/_enums/data-model-type.enum.ts +14 -14
  69. package/src/_enums/data-service-function.enum.ts +24 -24
  70. package/src/_enums/predefined-data-types.enum.ts +16 -16
  71. package/src/_enums/route-security.enum.ts +12 -12
  72. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  73. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  74. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  75. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  76. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  77. package/src/_models/control-models/app-params.control-model.ts +136 -136
  78. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  79. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  80. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  81. package/src/_models/control-models/endpoint-params.control-model.ts +664 -656
  82. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  83. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  84. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  85. package/src/_models/control-models/system-control.control-model.ts +12 -12
  86. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  87. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  88. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  89. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  90. package/src/_models/interfaces/global-settings.interface.ts +286 -286
  91. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  92. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  93. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  94. package/src/_models/types/db-update.type.ts +100 -100
  95. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  96. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  97. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  98. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  99. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  100. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  101. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  102. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  103. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  104. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  105. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  106. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  107. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  108. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  109. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  110. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  111. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  112. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  113. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  114. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  115. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  116. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  117. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  118. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  119. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  120. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  121. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  122. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  123. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  124. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  125. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  126. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  127. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  128. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  129. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  130. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  131. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  132. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  133. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  134. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  135. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  136. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  137. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  138. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  139. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  140. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  141. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  142. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  143. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  144. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  145. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  146. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  147. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  148. package/src/_modules/ai/index.ts +33 -33
  149. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  150. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  151. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  152. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  153. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  154. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  155. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  156. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  157. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  158. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  159. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  160. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  161. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  162. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  163. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  164. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  165. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  166. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  167. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  168. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  169. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  170. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  171. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  172. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  173. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  174. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  175. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  176. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  177. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  178. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  179. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  180. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  181. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  182. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  183. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  184. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  185. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  186. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  187. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  188. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  189. package/src/_modules/custom-data/index.ts +9 -9
  190. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  191. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  192. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  193. package/src/_modules/data-readers/index.ts +11 -11
  194. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  195. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  196. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  197. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  198. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  199. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  200. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  201. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  202. package/src/_modules/defaults/index.ts +17 -17
  203. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  204. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  205. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  206. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  207. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  208. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  209. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  210. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  211. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  212. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  213. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  214. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  215. package/src/_modules/discord-assistant/index.ts +38 -38
  216. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  217. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  218. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  219. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  220. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  221. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  222. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  223. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  224. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  225. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  226. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  227. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  228. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  229. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  230. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  231. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  232. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  233. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  234. package/src/_modules/discord-bot/index.ts +36 -36
  235. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  236. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  237. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  238. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  239. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  240. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  241. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  242. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  243. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  244. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  245. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  246. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  247. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  248. package/src/_modules/local-vector-search/index.ts +16 -16
  249. package/src/_modules/logs/index.ts +11 -11
  250. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  251. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  252. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  253. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  254. package/src/_modules/mcp/index.ts +13 -13
  255. package/src/_modules/messaging/README.md +354 -354
  256. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  257. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  258. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  259. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  260. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  261. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  262. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  263. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  264. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  265. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  266. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  267. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  268. package/src/_modules/messaging/index.ts +30 -30
  269. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  270. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  271. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  272. package/src/_modules/mock/app-params.mock.ts +9 -9
  273. package/src/_modules/mock/app-server.mock.ts +188 -188
  274. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  275. package/src/_modules/mock/auth-service.mock.ts +28 -28
  276. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  277. package/src/_modules/mock/controller.mock.ts +16 -16
  278. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  279. package/src/_modules/mock/data-model.mock.ts +82 -82
  280. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  281. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  282. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  283. package/src/_modules/mock/email-service.mock.ts +20 -20
  284. package/src/_modules/mock/email-template.mock.html +14 -14
  285. package/src/_modules/mock/endpoint.mock.ts +91 -91
  286. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  287. package/src/_modules/mock/socket-client.mock.ts +45 -45
  288. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  289. package/src/_modules/mock/socket-server.mock.ts +46 -46
  290. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  291. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  292. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  293. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  294. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  295. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  296. package/src/_modules/oauth2/index.ts +17 -17
  297. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  298. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  299. package/src/_modules/scheduler/index.ts +8 -8
  300. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  301. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  302. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  303. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  304. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  305. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  306. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  307. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  308. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  309. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  310. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  311. package/src/_modules/scoped-config/index.ts +17 -17
  312. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  313. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  314. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  315. package/src/_modules/server/errors/errors.controller.ts +515 -515
  316. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  317. package/src/_modules/server/index.ts +30 -30
  318. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  319. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  320. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  321. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  322. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  323. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  324. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  325. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  326. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  327. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  328. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  329. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  330. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  331. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  332. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  333. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  334. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  335. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  336. package/src/_modules/socket/app-extended.server.ts +648 -648
  337. package/src/_modules/socket/index.ts +42 -42
  338. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  339. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  340. package/src/_modules/test/index.ts +11 -11
  341. package/src/_modules/test/test.controller.spec.ts +72 -72
  342. package/src/_modules/test/test.controller.ts +115 -115
  343. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  344. package/src/_modules/usage/index.ts +15 -15
  345. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  346. package/src/_modules/usage/usage.controller.ts +126 -126
  347. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  348. package/src/_modules/usage/usage.data-service.ts +185 -185
  349. package/src/_services/base/api.service-base.spec.ts +125 -125
  350. package/src/_services/base/api.service-base.ts +74 -74
  351. package/src/_services/base/archive-data.service.spec.ts +209 -209
  352. package/src/_services/base/archive-data.service.ts +223 -223
  353. package/src/_services/base/data.service.spec.ts +729 -729
  354. package/src/_services/base/data.service.ts +2758 -2758
  355. package/src/_services/base/db.service.spec.ts +160 -160
  356. package/src/_services/base/db.service.ts +1698 -1698
  357. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  358. package/src/_services/base/singleton.service-base.ts +24 -24
  359. package/src/_services/base/singleton.service.spec.ts +114 -114
  360. package/src/_services/base/singleton.service.ts +38 -38
  361. package/src/_services/core/api.service.spec.ts +140 -140
  362. package/src/_services/core/auth.service.spec.ts +159 -159
  363. package/src/_services/core/auth.service.ts +174 -174
  364. package/src/_services/core/email.service.spec.ts +85 -85
  365. package/src/_services/core/email.service.ts +757 -757
  366. package/src/_services/core/event-loop-diag.service.ts +23 -1
  367. package/src/_services/core/global.service.spec.ts +292 -292
  368. package/src/_services/core/global.service.ts +487 -487
  369. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  370. package/src/_services/core/memory-guard.service.ts +481 -481
  371. package/src/_services/core/request-hunter.service.spec.ts +124 -0
  372. package/src/_services/core/request-hunter.service.ts +157 -0
  373. package/src/_services/core/service-collection.service.spec.ts +46 -46
  374. package/src/_services/core/service-collection.service.ts +6 -6
  375. package/src/_services/route/controller.service.spec.ts +53 -53
  376. package/src/_services/route/controller.service.ts +148 -148
  377. package/src/_services/route/routing-module.service.spec.ts +98 -98
  378. package/src/_services/route/routing-module.service.ts +330 -330
  379. package/src/_services/server/app.server.ts +1985 -1985
  380. package/src/_services/shared.static-service.spec.ts +99 -99
  381. package/src/_services/shared.static-service.ts +78 -78
  382. package/src/index.ts +113 -112
  383. package/tsconfig.app.json +12 -12
  384. package/tsconfig.json +42 -42
@@ -1,245 +1,245 @@
1
- import { DyNTS_global_settings } from '../../_collections/global-settings.const';
2
- import { DyNTS_GlobalService } from './global.service';
3
- import { DyNTS_MemoryGuard } from './memory-guard.service';
4
-
5
- /**
6
- * FR-193 — a bedrock heap-watchdog spec-je. A `poll()`-t KÖZVETLENÜL hívjuk (nem
7
- * az intervallumra várunk), mockolt heap-plafonnal + `process.memoryUsage`-dzsel,
8
- * így determinisztikusan teszteljük a hiszterézis-állapotgépet + a tartós rögzítést.
9
- */
10
-
11
- const MB: number = 1024 * 1024;
12
-
13
- /**
14
- * A privát `getHeapLimitBytes` + `process.memoryUsage` mockolása adott heap-%-hoz.
15
- * Visszaadja a memoryUsage-spy-t, hogy a hívó később átállíthassa (recovery-teszt).
16
- * `process as any`: a `MemoryUsageFn` típus egy `.rss()` submetódust is hordoz, amit
17
- * egy egyszerű return-value mock nem elégít ki — a cast kikerüli ezt a teszt-zajt.
18
- */
19
- const mockHeap = (guard: DyNTS_MemoryGuard, limitMb: number, usedMb: number): jasmine.Spy => {
20
- spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(limitMb * MB);
21
- return spyOn(process as any, 'memoryUsage').and.returnValue({
22
- heapUsed: usedMb * MB,
23
- heapTotal: usedMb * MB,
24
- rss: (usedMb + 100) * MB,
25
- external: 10 * MB,
26
- arrayBuffers: 0,
27
- } as NodeJS.MemoryUsage);
28
- };
29
-
30
- /** Egy poll-ciklus kézi kiváltása. */
31
- const poll = (guard: DyNTS_MemoryGuard): void => { (guard as any).poll(); };
32
-
33
- describe('| DyNTS_MemoryGuard (FR-193)', (): void => {
34
-
35
- let guard: DyNTS_MemoryGuard;
36
- let sinkSpy: jasmine.Spy;
37
- let originalSink: typeof DyNTS_GlobalService.globalErrorHandler;
38
- let originalSettings: typeof DyNTS_global_settings.memoryGuard;
39
-
40
- beforeEach((): void => {
41
- guard = DyNTS_MemoryGuard.getInstance();
42
- guard._teardownForTesting();
43
-
44
- originalSettings = DyNTS_global_settings.memoryGuard;
45
- DyNTS_global_settings.memoryGuard = {
46
- enabled: true,
47
- pollIntervalMs: 999999, // ne tüzeljen az intervallum a teszt alatt
48
- heapWarningThreshold: 85,
49
- heapCriticalThreshold: 95,
50
- recoveryMargin: 10,
51
- maxHistoryCount: 100,
52
- gcWarningFraction: 0.40,
53
- gcCriticalFraction: 0.60,
54
- // A tesztek NE regisztráljanak process-szintű crash-handlert / ne lépjenek ki (a jasmine-harness védelme).
55
- installCrashHandlers: false,
56
- exitOnSustainedCritical: false,
57
- };
58
-
59
- originalSink = DyNTS_GlobalService.globalErrorHandler;
60
- sinkSpy = jasmine.createSpy('globalErrorHandler');
61
- (DyNTS_GlobalService as any).globalErrorHandler = sinkSpy;
62
- });
63
-
64
- afterEach((): void => {
65
- guard._teardownForTesting();
66
- (DyNTS_GlobalService as any).globalErrorHandler = originalSink;
67
- DyNTS_global_settings.memoryGuard = originalSettings;
68
- });
69
-
70
- it('| install() idempotens — második hívás no-op', (): void => {
71
- guard.install();
72
- expect(guard.isInstalled()).toBe(true);
73
- guard.install(); // nem dob, nem indít új timert
74
- expect(guard.isInstalled()).toBe(true);
75
- });
76
-
77
- it('| install() SOHA nem dob, akkor sem ha a settings hiányos', (): void => {
78
- DyNTS_global_settings.memoryGuard = undefined as any;
79
- expect((): void => guard.install()).not.toThrow();
80
- expect(guard.isInstalled()).toBe(true);
81
- });
82
-
83
- it('| warning küszöb alatt NINCS esemény', (): void => {
84
- guard.install();
85
- mockHeap(guard, 1000, 800); // 80% < 85
86
- poll(guard);
87
- expect(guard.getHistory().length).toBe(0);
88
- expect(sinkSpy).not.toHaveBeenCalled();
89
- });
90
-
91
- it('| warning küszöb átlépése → 1 warning esemény + tartós error-sink (level warning)', (): void => {
92
- guard.install();
93
- mockHeap(guard, 1000, 880); // 88% ∈ [85, 95)
94
- poll(guard);
95
-
96
- const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
97
- expect(hist.length).toBe(1);
98
- expect(hist[0].level).toBe('warning');
99
- expect(hist[0].heapPct).toBe(88);
100
- expect(sinkSpy).toHaveBeenCalledTimes(1);
101
- expect(guard.getStatus().state).toBe('warning');
102
- });
103
-
104
- it('| warning-sávban maradva NINCS re-emit (hiszterézis)', (): void => {
105
- guard.install();
106
- mockHeap(guard, 1000, 880); // 88% → warning
107
- poll(guard);
108
- poll(guard); // még mindig 88% (ugyanaz a mock) → nincs új esemény
109
- expect(guard.getHistory().length).toBe(1);
110
- });
111
-
112
- it('| critical küszöb átlépése → critical esemény + onCritical hook', (): void => {
113
- const onCritical: jasmine.Spy = jasmine.createSpy('onCritical');
114
- guard.install({ onCritical: onCritical });
115
- mockHeap(guard, 1000, 970); // 97% ≥ 95
116
- poll(guard);
117
-
118
- const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
119
- expect(hist[hist.length - 1].level).toBe('critical');
120
- expect(onCritical).toHaveBeenCalledTimes(1);
121
- expect(guard.getStatus().state).toBe('critical');
122
- });
123
-
124
- it('| helyreállás: a warning-margó alá esve → recovered esemény (sink NÉLKÜL)', (): void => {
125
- guard.install();
126
-
127
- const muSpy: jasmine.Spy = mockHeap(guard, 1000, 880); // 88% → warning
128
- poll(guard);
129
- sinkSpy.calls.reset();
130
- muSpy.and.returnValue({
131
- heapUsed: 700 * MB, heapTotal: 700 * MB, rss: 800 * MB, external: 10 * MB, arrayBuffers: 0,
132
- } as NodeJS.MemoryUsage); // 70% ≤ 85 - 10
133
- poll(guard);
134
-
135
- const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
136
- expect(hist[hist.length - 1].level).toBe('recovered');
137
- expect(guard.getStatus().state).toBe('normal');
138
- expect(sinkSpy).not.toHaveBeenCalled(); // recovered NEM ír az error-sinkbe
139
- });
140
-
141
- it('| history ring-buffer a maxHistoryCount-ra van kapva', (): void => {
142
- DyNTS_global_settings.memoryGuard!.maxHistoryCount = 3;
143
- guard.install();
144
- spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(1000 * MB);
145
- const high: NodeJS.MemoryUsage =
146
- { heapUsed: 880 * MB, heapTotal: 880 * MB, rss: 980 * MB, external: 0, arrayBuffers: 0 } as NodeJS.MemoryUsage;
147
- const low: NodeJS.MemoryUsage =
148
- { heapUsed: 700 * MB, heapTotal: 700 * MB, rss: 800 * MB, external: 0, arrayBuffers: 0 } as NodeJS.MemoryUsage;
149
- let tick: number = 0;
150
- // warning ↔ recovered oszcilláció: páros tick=high (warning), páratlan=low (recovered)
151
- spyOn(process as any, 'memoryUsage').and.callFake((): NodeJS.MemoryUsage => (tick++ % 2 === 0 ? high : low));
152
- for (let k: number = 0; k < 8; k++) { poll(guard); } // 8 állapot-váltás, csak 3 marad
153
- expect(guard.getHistory().length).toBe(3);
154
- });
155
-
156
- it('| poll() SOHA nem dob (heap limit 0 → no-op)', (): void => {
157
- guard.install();
158
- spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(0);
159
- expect((): void => poll(guard)).not.toThrow();
160
- expect(guard.getHistory().length).toBe(0);
161
- });
162
-
163
- it('| getStatus a csúcsokat is követi', (): void => {
164
- guard.install();
165
- mockHeap(guard, 1000, 920); // 92%
166
- poll(guard);
167
- expect(guard.getStatus().peakHeapPct).toBe(92);
168
- expect(guard.getStatus().peakRssMb).toBeGreaterThan(0);
169
- });
170
-
171
- // --- GC-thrash precursor (a %-küszöb ALATT is OOM-jel) ---
172
-
173
- it('| GC-thrash kritikus, bár a heap-% csak 70% (a %-küszöb ALATT) — trigger=gc', (): void => {
174
- guard.install();
175
- mockHeap(guard, 1000, 700); // 70% < warn 85
176
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.65); // GC 65% ≥ crit 60%
177
- poll(guard);
178
- const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
179
- expect(hist[hist.length - 1].level).toBe('critical');
180
- expect(hist[hist.length - 1].trigger).toBe('gc');
181
- expect(sinkSpy).toHaveBeenCalledTimes(1);
182
- });
183
-
184
- it('| közepes GC (40–60%) alacsony heap-nél → warning (trigger=gc)', (): void => {
185
- guard.install();
186
- mockHeap(guard, 1000, 700); // 70%
187
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.45);
188
- poll(guard);
189
- expect(guard.getHistory()[0].level).toBe('warning');
190
- expect(guard.getHistory()[0].trigger).toBe('gc');
191
- });
192
-
193
- // --- pressure() / shouldShedLoad() — a fogyasztói load-shed gate ---
194
-
195
- it('| pressure() a heap-% + GC közül a rosszabb szintet adja; shouldShedLoad critical-nál true', (): void => {
196
- guard.install();
197
- mockHeap(guard, 1000, 970); // 97% ≥ crit
198
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
199
- const p = guard.pressure();
200
- expect(p.level).toBe('critical');
201
- expect(p.heapPct).toBe(97);
202
- expect(guard.shouldShedLoad()).toBe(true);
203
- });
204
-
205
- it('| shouldShedLoad false, ha ok-szint (alacsony heap + alacsony GC)', (): void => {
206
- guard.install();
207
- mockHeap(guard, 1000, 500); // 50%
208
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.10);
209
- expect(guard.pressure().level).toBe('ok');
210
- expect(guard.shouldShedLoad()).toBe(false);
211
- });
212
-
213
- // --- graceful-exit: tartós critical → exit (a wrapper újraindít) ---
214
-
215
- it('| exitOnSustainedCritical: N egymás utáni critical poll → gracefulExit (process.exit)', (): void => {
216
- DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
217
- DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
218
- DyNTS_global_settings.memoryGuard!.bootGraceMs = 0; // nincs grace → azonnal élesedik
219
- const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
220
- guard.install();
221
- mockHeap(guard, 1000, 970); // 97% critical
222
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
223
- poll(guard); poll(guard);
224
- expect(exitSpy).not.toHaveBeenCalled(); // 2 critical < 3
225
- poll(guard);
226
- expect(exitSpy).toHaveBeenCalledTimes(1); // a 3. critical → exit
227
- });
228
-
229
- it('| BOOT-GRACE: a grace alatt a sustained-critical NEM lép ki; a grace után IGEN', (): void => {
230
- DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
231
- DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
232
- DyNTS_global_settings.memoryGuard!.bootGraceMs = 60000; // 60s grace
233
- const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
234
- guard.install();
235
- mockHeap(guard, 1000, 970); // 97% critical
236
- spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
237
- // A grace ALATT (installedAt épp most): hiába N+ critical poll, NINCS exit.
238
- poll(guard); poll(guard); poll(guard); poll(guard);
239
- expect(exitSpy).not.toHaveBeenCalled();
240
- // A grace UTÁN (installedAt 61s-cel ezelőttre állítva): a következő critical poll már kilép.
241
- (guard as any).installedAt = Date.now() - 61000;
242
- poll(guard);
243
- expect(exitSpy).toHaveBeenCalledTimes(1);
244
- });
245
- });
1
+ import { DyNTS_global_settings } from '../../_collections/global-settings.const';
2
+ import { DyNTS_GlobalService } from './global.service';
3
+ import { DyNTS_MemoryGuard } from './memory-guard.service';
4
+
5
+ /**
6
+ * FR-193 — a bedrock heap-watchdog spec-je. A `poll()`-t KÖZVETLENÜL hívjuk (nem
7
+ * az intervallumra várunk), mockolt heap-plafonnal + `process.memoryUsage`-dzsel,
8
+ * így determinisztikusan teszteljük a hiszterézis-állapotgépet + a tartós rögzítést.
9
+ */
10
+
11
+ const MB: number = 1024 * 1024;
12
+
13
+ /**
14
+ * A privát `getHeapLimitBytes` + `process.memoryUsage` mockolása adott heap-%-hoz.
15
+ * Visszaadja a memoryUsage-spy-t, hogy a hívó később átállíthassa (recovery-teszt).
16
+ * `process as any`: a `MemoryUsageFn` típus egy `.rss()` submetódust is hordoz, amit
17
+ * egy egyszerű return-value mock nem elégít ki — a cast kikerüli ezt a teszt-zajt.
18
+ */
19
+ const mockHeap = (guard: DyNTS_MemoryGuard, limitMb: number, usedMb: number): jasmine.Spy => {
20
+ spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(limitMb * MB);
21
+ return spyOn(process as any, 'memoryUsage').and.returnValue({
22
+ heapUsed: usedMb * MB,
23
+ heapTotal: usedMb * MB,
24
+ rss: (usedMb + 100) * MB,
25
+ external: 10 * MB,
26
+ arrayBuffers: 0,
27
+ } as NodeJS.MemoryUsage);
28
+ };
29
+
30
+ /** Egy poll-ciklus kézi kiváltása. */
31
+ const poll = (guard: DyNTS_MemoryGuard): void => { (guard as any).poll(); };
32
+
33
+ describe('| DyNTS_MemoryGuard (FR-193)', (): void => {
34
+
35
+ let guard: DyNTS_MemoryGuard;
36
+ let sinkSpy: jasmine.Spy;
37
+ let originalSink: typeof DyNTS_GlobalService.globalErrorHandler;
38
+ let originalSettings: typeof DyNTS_global_settings.memoryGuard;
39
+
40
+ beforeEach((): void => {
41
+ guard = DyNTS_MemoryGuard.getInstance();
42
+ guard._teardownForTesting();
43
+
44
+ originalSettings = DyNTS_global_settings.memoryGuard;
45
+ DyNTS_global_settings.memoryGuard = {
46
+ enabled: true,
47
+ pollIntervalMs: 999999, // ne tüzeljen az intervallum a teszt alatt
48
+ heapWarningThreshold: 85,
49
+ heapCriticalThreshold: 95,
50
+ recoveryMargin: 10,
51
+ maxHistoryCount: 100,
52
+ gcWarningFraction: 0.40,
53
+ gcCriticalFraction: 0.60,
54
+ // A tesztek NE regisztráljanak process-szintű crash-handlert / ne lépjenek ki (a jasmine-harness védelme).
55
+ installCrashHandlers: false,
56
+ exitOnSustainedCritical: false,
57
+ };
58
+
59
+ originalSink = DyNTS_GlobalService.globalErrorHandler;
60
+ sinkSpy = jasmine.createSpy('globalErrorHandler');
61
+ (DyNTS_GlobalService as any).globalErrorHandler = sinkSpy;
62
+ });
63
+
64
+ afterEach((): void => {
65
+ guard._teardownForTesting();
66
+ (DyNTS_GlobalService as any).globalErrorHandler = originalSink;
67
+ DyNTS_global_settings.memoryGuard = originalSettings;
68
+ });
69
+
70
+ it('| install() idempotens — második hívás no-op', (): void => {
71
+ guard.install();
72
+ expect(guard.isInstalled()).toBe(true);
73
+ guard.install(); // nem dob, nem indít új timert
74
+ expect(guard.isInstalled()).toBe(true);
75
+ });
76
+
77
+ it('| install() SOHA nem dob, akkor sem ha a settings hiányos', (): void => {
78
+ DyNTS_global_settings.memoryGuard = undefined as any;
79
+ expect((): void => guard.install()).not.toThrow();
80
+ expect(guard.isInstalled()).toBe(true);
81
+ });
82
+
83
+ it('| warning küszöb alatt NINCS esemény', (): void => {
84
+ guard.install();
85
+ mockHeap(guard, 1000, 800); // 80% < 85
86
+ poll(guard);
87
+ expect(guard.getHistory().length).toBe(0);
88
+ expect(sinkSpy).not.toHaveBeenCalled();
89
+ });
90
+
91
+ it('| warning küszöb átlépése → 1 warning esemény + tartós error-sink (level warning)', (): void => {
92
+ guard.install();
93
+ mockHeap(guard, 1000, 880); // 88% ∈ [85, 95)
94
+ poll(guard);
95
+
96
+ const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
97
+ expect(hist.length).toBe(1);
98
+ expect(hist[0].level).toBe('warning');
99
+ expect(hist[0].heapPct).toBe(88);
100
+ expect(sinkSpy).toHaveBeenCalledTimes(1);
101
+ expect(guard.getStatus().state).toBe('warning');
102
+ });
103
+
104
+ it('| warning-sávban maradva NINCS re-emit (hiszterézis)', (): void => {
105
+ guard.install();
106
+ mockHeap(guard, 1000, 880); // 88% → warning
107
+ poll(guard);
108
+ poll(guard); // még mindig 88% (ugyanaz a mock) → nincs új esemény
109
+ expect(guard.getHistory().length).toBe(1);
110
+ });
111
+
112
+ it('| critical küszöb átlépése → critical esemény + onCritical hook', (): void => {
113
+ const onCritical: jasmine.Spy = jasmine.createSpy('onCritical');
114
+ guard.install({ onCritical: onCritical });
115
+ mockHeap(guard, 1000, 970); // 97% ≥ 95
116
+ poll(guard);
117
+
118
+ const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
119
+ expect(hist[hist.length - 1].level).toBe('critical');
120
+ expect(onCritical).toHaveBeenCalledTimes(1);
121
+ expect(guard.getStatus().state).toBe('critical');
122
+ });
123
+
124
+ it('| helyreállás: a warning-margó alá esve → recovered esemény (sink NÉLKÜL)', (): void => {
125
+ guard.install();
126
+
127
+ const muSpy: jasmine.Spy = mockHeap(guard, 1000, 880); // 88% → warning
128
+ poll(guard);
129
+ sinkSpy.calls.reset();
130
+ muSpy.and.returnValue({
131
+ heapUsed: 700 * MB, heapTotal: 700 * MB, rss: 800 * MB, external: 10 * MB, arrayBuffers: 0,
132
+ } as NodeJS.MemoryUsage); // 70% ≤ 85 - 10
133
+ poll(guard);
134
+
135
+ const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
136
+ expect(hist[hist.length - 1].level).toBe('recovered');
137
+ expect(guard.getStatus().state).toBe('normal');
138
+ expect(sinkSpy).not.toHaveBeenCalled(); // recovered NEM ír az error-sinkbe
139
+ });
140
+
141
+ it('| history ring-buffer a maxHistoryCount-ra van kapva', (): void => {
142
+ DyNTS_global_settings.memoryGuard!.maxHistoryCount = 3;
143
+ guard.install();
144
+ spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(1000 * MB);
145
+ const high: NodeJS.MemoryUsage =
146
+ { heapUsed: 880 * MB, heapTotal: 880 * MB, rss: 980 * MB, external: 0, arrayBuffers: 0 } as NodeJS.MemoryUsage;
147
+ const low: NodeJS.MemoryUsage =
148
+ { heapUsed: 700 * MB, heapTotal: 700 * MB, rss: 800 * MB, external: 0, arrayBuffers: 0 } as NodeJS.MemoryUsage;
149
+ let tick: number = 0;
150
+ // warning ↔ recovered oszcilláció: páros tick=high (warning), páratlan=low (recovered)
151
+ spyOn(process as any, 'memoryUsage').and.callFake((): NodeJS.MemoryUsage => (tick++ % 2 === 0 ? high : low));
152
+ for (let k: number = 0; k < 8; k++) { poll(guard); } // 8 állapot-váltás, csak 3 marad
153
+ expect(guard.getHistory().length).toBe(3);
154
+ });
155
+
156
+ it('| poll() SOHA nem dob (heap limit 0 → no-op)', (): void => {
157
+ guard.install();
158
+ spyOn(guard as any, 'getHeapLimitBytes').and.returnValue(0);
159
+ expect((): void => poll(guard)).not.toThrow();
160
+ expect(guard.getHistory().length).toBe(0);
161
+ });
162
+
163
+ it('| getStatus a csúcsokat is követi', (): void => {
164
+ guard.install();
165
+ mockHeap(guard, 1000, 920); // 92%
166
+ poll(guard);
167
+ expect(guard.getStatus().peakHeapPct).toBe(92);
168
+ expect(guard.getStatus().peakRssMb).toBeGreaterThan(0);
169
+ });
170
+
171
+ // --- GC-thrash precursor (a %-küszöb ALATT is OOM-jel) ---
172
+
173
+ it('| GC-thrash kritikus, bár a heap-% csak 70% (a %-küszöb ALATT) — trigger=gc', (): void => {
174
+ guard.install();
175
+ mockHeap(guard, 1000, 700); // 70% < warn 85
176
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.65); // GC 65% ≥ crit 60%
177
+ poll(guard);
178
+ const hist: ReturnType<typeof guard.getHistory> = guard.getHistory();
179
+ expect(hist[hist.length - 1].level).toBe('critical');
180
+ expect(hist[hist.length - 1].trigger).toBe('gc');
181
+ expect(sinkSpy).toHaveBeenCalledTimes(1);
182
+ });
183
+
184
+ it('| közepes GC (40–60%) alacsony heap-nél → warning (trigger=gc)', (): void => {
185
+ guard.install();
186
+ mockHeap(guard, 1000, 700); // 70%
187
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.45);
188
+ poll(guard);
189
+ expect(guard.getHistory()[0].level).toBe('warning');
190
+ expect(guard.getHistory()[0].trigger).toBe('gc');
191
+ });
192
+
193
+ // --- pressure() / shouldShedLoad() — a fogyasztói load-shed gate ---
194
+
195
+ it('| pressure() a heap-% + GC közül a rosszabb szintet adja; shouldShedLoad critical-nál true', (): void => {
196
+ guard.install();
197
+ mockHeap(guard, 1000, 970); // 97% ≥ crit
198
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
199
+ const p = guard.pressure();
200
+ expect(p.level).toBe('critical');
201
+ expect(p.heapPct).toBe(97);
202
+ expect(guard.shouldShedLoad()).toBe(true);
203
+ });
204
+
205
+ it('| shouldShedLoad false, ha ok-szint (alacsony heap + alacsony GC)', (): void => {
206
+ guard.install();
207
+ mockHeap(guard, 1000, 500); // 50%
208
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.10);
209
+ expect(guard.pressure().level).toBe('ok');
210
+ expect(guard.shouldShedLoad()).toBe(false);
211
+ });
212
+
213
+ // --- graceful-exit: tartós critical → exit (a wrapper újraindít) ---
214
+
215
+ it('| exitOnSustainedCritical: N egymás utáni critical poll → gracefulExit (process.exit)', (): void => {
216
+ DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
217
+ DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
218
+ DyNTS_global_settings.memoryGuard!.bootGraceMs = 0; // nincs grace → azonnal élesedik
219
+ const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
220
+ guard.install();
221
+ mockHeap(guard, 1000, 970); // 97% critical
222
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
223
+ poll(guard); poll(guard);
224
+ expect(exitSpy).not.toHaveBeenCalled(); // 2 critical < 3
225
+ poll(guard);
226
+ expect(exitSpy).toHaveBeenCalledTimes(1); // a 3. critical → exit
227
+ });
228
+
229
+ it('| BOOT-GRACE: a grace alatt a sustained-critical NEM lép ki; a grace után IGEN', (): void => {
230
+ DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
231
+ DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
232
+ DyNTS_global_settings.memoryGuard!.bootGraceMs = 60000; // 60s grace
233
+ const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
234
+ guard.install();
235
+ mockHeap(guard, 1000, 970); // 97% critical
236
+ spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
237
+ // A grace ALATT (installedAt épp most): hiába N+ critical poll, NINCS exit.
238
+ poll(guard); poll(guard); poll(guard); poll(guard);
239
+ expect(exitSpy).not.toHaveBeenCalled();
240
+ // A grace UTÁN (installedAt 61s-cel ezelőttre állítva): a következő critical poll már kilép.
241
+ (guard as any).installedAt = Date.now() - 61000;
242
+ poll(guard);
243
+ expect(exitSpy).toHaveBeenCalledTimes(1);
244
+ });
245
+ });