@futdevpro/nts-dynamo 1.15.98 → 1.15.100

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