@futdevpro/nts-dynamo 1.15.83 → 1.15.85

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