@futdevpro/nts-dynamo 1.15.104 → 1.15.107

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