@futdevpro/nts-dynamo 1.15.74 → 1.15.75
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.
- package/.c8rc.json +26 -26
- package/.copilot/patterns.json +7 -7
- package/.cursor/rules/__assistant_guide.mdc +30 -30
- package/.cursor/rules/_ag_backend-structure.mdc +85 -85
- package/.cursor/rules/_ag_backend.mdc +16 -16
- package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
- package/.cursor/rules/_ag_frontend.mdc +39 -39
- package/.cursor/rules/_ag_import-rules.mdc +44 -44
- package/.cursor/rules/_ag_naming.mdc +115 -115
- package/.cursor/rules/_ag_should-be.mdc +6 -6
- package/.cursor/rules/ai_development_guide.md +60 -60
- package/.cursor/rules/cursor-rules.md +160 -160
- package/.cursor/rules/default-command.mdc +464 -464
- package/.cursor/rules/error_code_pattern.md +39 -39
- package/.cursor/rules/saved rule mcp server use.md +15 -15
- package/.dynamo/logs/cicd-pipeline/output.log +2798 -0
- package/.dynamo/logs/cicd-pipeline/status.json +94 -0
- package/.vscode/settings.json +10 -10
- package/HOWTO.md +15 -15
- package/LICENSE +21 -21
- package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
- package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
- package/_specifications/BACKLOG.md +92 -92
- package/_specifications/TODO.md +15 -15
- package/_specifications/agent.md +138 -138
- package/eslint.config.js +3 -3
- package/nodemon.json +24 -24
- package/package.json +2 -2
- package/pnpm-workspace.yaml +5 -5
- package/scripts/run-coverage-tests.js +28 -28
- package/spec/support/helpers/spec-reporter-loader.js +359 -359
- package/spec/support/helpers/ts-node-helper.js +93 -93
- package/spec/support/jasmine.coverage.json +24 -24
- package/spec/support/jasmine.json +24 -24
- package/src/_collections/archive.util.spec.ts +57 -57
- package/src/_collections/archive.util.ts +18 -18
- package/src/_collections/atlas-default-db-options.const.ts +9 -9
- package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
- package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
- package/src/_collections/default-not-found-page.const.spec.ts +19 -19
- package/src/_collections/default-not-found-page.const.ts +22 -22
- package/src/_collections/default-socket-path.const.spec.ts +12 -12
- package/src/_collections/default-socket-path.const.ts +2 -2
- package/src/_collections/get-environment-settings.util.spec.ts +210 -210
- package/src/_collections/get-environment-settings.util.ts +48 -48
- package/src/_collections/global-settings.const.ts +97 -97
- package/src/_collections/sample.env +21 -21
- package/src/_collections/star.controller.spec.ts +224 -224
- package/src/_collections/star.controller.ts +129 -129
- package/src/_enums/data-model-type.enum.ts +14 -14
- package/src/_enums/data-service-function.enum.ts +24 -24
- package/src/_enums/predefined-data-types.enum.ts +16 -16
- package/src/_enums/route-security.enum.ts +12 -12
- package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
- package/src/_models/control-models/api-call-params.control-model.ts +142 -142
- package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
- package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
- package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
- package/src/_models/control-models/app-params.control-model.ts +136 -136
- package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
- package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
- package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
- package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
- package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
- package/src/_models/control-models/http-settings.control-model.ts +37 -37
- package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
- package/src/_models/control-models/system-control.control-model.ts +12 -12
- package/src/_models/interfaces/certification-settings.interface.ts +7 -7
- package/src/_models/interfaces/environment-settings.interface.ts +59 -59
- package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
- package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
- package/src/_models/interfaces/global-settings.interface.ts +216 -216
- package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
- package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
- package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
- package/src/_models/types/db-update.type.ts +100 -100
- package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
- package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
- package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
- package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
- package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
- package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
- package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
- package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
- package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
- package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
- package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
- package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
- package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
- package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
- package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
- package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
- package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
- package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
- package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
- package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
- package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
- package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
- package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
- package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
- package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
- package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
- package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
- package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
- package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
- package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
- package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
- package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
- package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
- package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
- package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
- package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
- package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
- package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
- package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
- package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
- package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
- package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
- package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
- package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
- package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
- package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
- package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
- package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
- package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
- package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
- package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
- package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
- package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
- package/src/_modules/ai/index.ts +23 -23
- package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
- package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
- package/src/_modules/assistant/_collections/ass.util.ts +50 -50
- package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
- package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
- package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
- package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
- package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
- package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
- package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
- package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
- package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
- package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
- package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
- package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
- package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
- package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
- package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
- package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
- package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
- package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
- package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
- package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
- package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
- package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
- package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
- package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
- package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
- package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
- package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
- package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
- package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
- package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
- package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
- package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
- package/src/_modules/custom-data/custom-data.controller.ts +67 -67
- package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
- package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
- package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
- package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
- package/src/_modules/custom-data/index.ts +9 -9
- package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
- package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
- package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
- package/src/_modules/data-readers/index.ts +11 -11
- package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
- package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
- package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
- package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
- package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
- package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
- package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
- package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
- package/src/_modules/defaults/index.ts +17 -17
- package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
- package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
- package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
- package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
- package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
- package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
- package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
- package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
- package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
- package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
- package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
- package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
- package/src/_modules/discord-assistant/index.ts +38 -38
- package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
- package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
- package/src/_modules/discord-assistant-voiced/index.ts +36 -36
- package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
- package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
- package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
- package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
- package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
- package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
- package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
- package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
- package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
- package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
- package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
- package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
- package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
- package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
- package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
- package/src/_modules/discord-bot/index.ts +36 -36
- package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
- package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
- package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
- package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
- package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
- package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
- package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
- package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
- package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
- package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
- package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
- package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
- package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
- package/src/_modules/local-vector-search/index.ts +16 -16
- package/src/_modules/logs/index.ts +11 -11
- package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
- package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
- package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
- package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
- package/src/_modules/mcp/index.ts +13 -13
- package/src/_modules/messaging/README.md +354 -354
- package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
- package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
- package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
- package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
- package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
- package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
- package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
- package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
- package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
- package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
- package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
- package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
- package/src/_modules/messaging/index.ts +30 -30
- package/src/_modules/mock/app-extended-server.mock.ts +201 -201
- package/src/_modules/mock/app-integration-test.mock.ts +51 -51
- package/src/_modules/mock/app-params.mock.spec.ts +21 -21
- package/src/_modules/mock/app-params.mock.ts +9 -9
- package/src/_modules/mock/app-server.mock.ts +188 -188
- package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
- package/src/_modules/mock/auth-service.mock.ts +28 -28
- package/src/_modules/mock/controller.mock.spec.ts +26 -26
- package/src/_modules/mock/controller.mock.ts +16 -16
- package/src/_modules/mock/data-model.mock.spec.ts +111 -111
- package/src/_modules/mock/data-model.mock.ts +82 -82
- package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
- package/src/_modules/mock/email-service-collection.mock.ts +15 -15
- package/src/_modules/mock/email-service.mock.spec.ts +17 -17
- package/src/_modules/mock/email-service.mock.ts +20 -20
- package/src/_modules/mock/email-template.mock.html +14 -14
- package/src/_modules/mock/endpoint.mock.ts +91 -91
- package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
- package/src/_modules/mock/socket-client.mock.ts +45 -45
- package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
- package/src/_modules/mock/socket-server.mock.ts +46 -46
- package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
- package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
- package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
- package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
- package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
- package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
- package/src/_modules/oauth2/index.ts +17 -17
- package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
- package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
- package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
- package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
- package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
- package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
- package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
- package/src/_modules/scoped-config/index.ts +17 -17
- package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
- package/src/_modules/server/errors/errors.control-service.ts +100 -100
- package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
- package/src/_modules/server/errors/errors.controller.ts +489 -489
- package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
- package/src/_modules/server/index.ts +30 -30
- package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
- package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
- package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
- package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
- package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
- package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
- package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
- package/src/_modules/server/server-status/server-status.controller.ts +253 -253
- package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
- package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
- package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
- package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
- package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
- package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
- package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
- package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
- package/src/_modules/socket/_services/socket-client.service.ts +260 -260
- package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
- package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
- package/src/_modules/socket/app-extended.server.ts +630 -630
- package/src/_modules/socket/index.ts +42 -42
- package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
- package/src/_modules/test/get-test-routing-module.util.ts +23 -23
- package/src/_modules/test/index.ts +11 -11
- package/src/_modules/test/test.controller.spec.ts +72 -72
- package/src/_modules/test/test.controller.ts +115 -115
- package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
- package/src/_modules/usage/index.ts +15 -15
- package/src/_modules/usage/usage.controller.spec.ts +81 -81
- package/src/_modules/usage/usage.controller.ts +126 -126
- package/src/_modules/usage/usage.data-service.spec.ts +332 -332
- package/src/_modules/usage/usage.data-service.ts +185 -185
- package/src/_services/base/api.service-base.spec.ts +125 -125
- package/src/_services/base/api.service-base.ts +74 -74
- package/src/_services/base/archive-data.service.spec.ts +196 -196
- package/src/_services/base/archive-data.service.ts +216 -216
- package/src/_services/base/data.service.spec.ts +674 -674
- package/src/_services/base/data.service.ts +2719 -2719
- package/src/_services/base/db.service.spec.ts +73 -73
- package/src/_services/base/db.service.ts +1575 -1575
- package/src/_services/base/singleton.service-base.spec.ts +28 -28
- package/src/_services/base/singleton.service-base.ts +24 -24
- package/src/_services/base/singleton.service.spec.ts +114 -114
- package/src/_services/base/singleton.service.ts +38 -38
- package/src/_services/core/api.service.spec.ts +140 -140
- package/src/_services/core/auth.service.spec.ts +159 -159
- package/src/_services/core/auth.service.ts +174 -174
- package/src/_services/core/email.service.spec.ts +85 -85
- package/src/_services/core/email.service.ts +742 -742
- package/src/_services/core/global.service.spec.ts +292 -292
- package/src/_services/core/global.service.ts +475 -475
- package/src/_services/core/memory-guard.service.spec.ts +245 -245
- package/src/_services/core/memory-guard.service.ts +481 -481
- package/src/_services/core/service-collection.service.spec.ts +46 -46
- package/src/_services/core/service-collection.service.ts +6 -6
- package/src/_services/route/controller.service.spec.ts +53 -53
- package/src/_services/route/controller.service.ts +148 -148
- package/src/_services/route/routing-module.service.spec.ts +98 -98
- package/src/_services/route/routing-module.service.ts +330 -330
- package/src/_services/server/app.server.ts +1747 -1747
- package/src/_services/shared.static-service.spec.ts +99 -99
- package/src/_services/shared.static-service.ts +78 -78
- package/src/index.ts +96 -96
- package/tsconfig.app.json +12 -12
- 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
|
+
});
|