@futdevpro/nts-dynamo 1.15.144 → 1.15.145

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