@futdevpro/nts-dynamo 1.15.98 → 1.15.99

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 (367) 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 +2803 -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/_models/control-models/endpoint-params.control-model.d.ts.map +1 -1
  27. package/build/_models/control-models/endpoint-params.control-model.js +8 -0
  28. package/build/_models/control-models/endpoint-params.control-model.js.map +1 -1
  29. package/eslint.config.js +3 -3
  30. package/nodemon.json +24 -24
  31. package/package.json +1 -1
  32. package/pnpm-workspace.yaml +5 -5
  33. package/scripts/run-coverage-tests.js +28 -28
  34. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  35. package/spec/support/helpers/ts-node-helper.js +93 -93
  36. package/spec/support/jasmine.coverage.json +24 -24
  37. package/spec/support/jasmine.json +24 -24
  38. package/src/_collections/archive.util.spec.ts +57 -57
  39. package/src/_collections/archive.util.ts +18 -18
  40. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  41. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  42. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  43. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  44. package/src/_collections/default-not-found-page.const.ts +22 -22
  45. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  46. package/src/_collections/default-socket-path.const.ts +2 -2
  47. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  48. package/src/_collections/get-environment-settings.util.ts +48 -48
  49. package/src/_collections/global-settings.const.ts +109 -109
  50. package/src/_collections/sample.env +21 -21
  51. package/src/_collections/star.controller.spec.ts +224 -224
  52. package/src/_collections/star.controller.ts +129 -129
  53. package/src/_enums/data-model-type.enum.ts +14 -14
  54. package/src/_enums/data-service-function.enum.ts +24 -24
  55. package/src/_enums/predefined-data-types.enum.ts +16 -16
  56. package/src/_enums/route-security.enum.ts +12 -12
  57. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  58. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  59. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  60. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  61. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  62. package/src/_models/control-models/app-params.control-model.ts +136 -136
  63. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  64. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  65. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -627
  66. package/src/_models/control-models/endpoint-params.control-model.ts +636 -627
  67. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  68. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  69. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  70. package/src/_models/control-models/system-control.control-model.ts +12 -12
  71. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  72. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  73. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  74. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  75. package/src/_models/interfaces/global-settings.interface.ts +259 -259
  76. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  77. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  78. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  79. package/src/_models/types/db-update.type.ts +100 -100
  80. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  81. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  82. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  83. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  84. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  85. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  87. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  90. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  91. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  92. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  93. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  94. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  95. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  96. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  97. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  98. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  99. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  100. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  101. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  102. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  103. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  104. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  105. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  106. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  107. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  108. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  109. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  111. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  112. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  119. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  120. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  121. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  122. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  123. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  124. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  125. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  126. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  127. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  128. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  129. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  130. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  131. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  132. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  133. package/src/_modules/ai/index.ts +23 -23
  134. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  135. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  136. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  137. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  138. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  139. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  140. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  141. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  142. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  143. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  144. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  145. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  146. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  147. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  148. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  149. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  150. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  151. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  152. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  153. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  154. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  155. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  156. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  157. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  158. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  159. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  160. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  161. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  162. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  163. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  164. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  165. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  166. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  167. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  168. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  169. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  170. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  171. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  172. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  173. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  174. package/src/_modules/custom-data/index.ts +9 -9
  175. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  176. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  177. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  178. package/src/_modules/data-readers/index.ts +11 -11
  179. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  180. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  181. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  182. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  183. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  184. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  185. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  186. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  187. package/src/_modules/defaults/index.ts +17 -17
  188. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  189. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  190. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  191. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  192. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  193. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  194. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  195. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  196. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  197. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  198. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  199. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  200. package/src/_modules/discord-assistant/index.ts +38 -38
  201. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  202. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  203. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  204. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  205. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  206. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  207. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  208. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  209. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  210. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  211. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  212. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  213. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  214. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  215. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  216. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  217. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  218. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  219. package/src/_modules/discord-bot/index.ts +36 -36
  220. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  221. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  222. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  223. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  224. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  225. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  226. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  227. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  228. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  229. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  230. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  231. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  232. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  233. package/src/_modules/local-vector-search/index.ts +16 -16
  234. package/src/_modules/logs/index.ts +11 -11
  235. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  236. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  237. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  238. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  239. package/src/_modules/mcp/index.ts +13 -13
  240. package/src/_modules/messaging/README.md +354 -354
  241. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  242. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  243. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  244. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  245. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  246. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  247. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  248. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  249. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  250. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  251. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  252. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  253. package/src/_modules/messaging/index.ts +30 -30
  254. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  255. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  256. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  257. package/src/_modules/mock/app-params.mock.ts +9 -9
  258. package/src/_modules/mock/app-server.mock.ts +188 -188
  259. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  260. package/src/_modules/mock/auth-service.mock.ts +28 -28
  261. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  262. package/src/_modules/mock/controller.mock.ts +16 -16
  263. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  264. package/src/_modules/mock/data-model.mock.ts +82 -82
  265. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  266. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  267. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  268. package/src/_modules/mock/email-service.mock.ts +20 -20
  269. package/src/_modules/mock/email-template.mock.html +14 -14
  270. package/src/_modules/mock/endpoint.mock.ts +91 -91
  271. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  272. package/src/_modules/mock/socket-client.mock.ts +45 -45
  273. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  274. package/src/_modules/mock/socket-server.mock.ts +46 -46
  275. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  276. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  277. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  278. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  279. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  280. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  281. package/src/_modules/oauth2/index.ts +17 -17
  282. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  283. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  284. package/src/_modules/scheduler/index.ts +8 -8
  285. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  286. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  287. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  288. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  289. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  290. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  291. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  292. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  293. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  294. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  295. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  296. package/src/_modules/scoped-config/index.ts +17 -17
  297. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  298. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  299. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  300. package/src/_modules/server/errors/errors.controller.ts +515 -515
  301. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  302. package/src/_modules/server/index.ts +30 -30
  303. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  304. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  305. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  306. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  307. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  308. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  309. package/src/_modules/server/server-status/server-status.controller.spec.ts +255 -255
  310. package/src/_modules/server/server-status/server-status.controller.ts +272 -272
  311. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  312. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  313. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  314. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  315. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  316. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  317. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  318. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  319. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  320. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  321. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  322. package/src/_modules/socket/app-extended.server.ts +630 -630
  323. package/src/_modules/socket/index.ts +42 -42
  324. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  325. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  326. package/src/_modules/test/index.ts +11 -11
  327. package/src/_modules/test/test.controller.spec.ts +72 -72
  328. package/src/_modules/test/test.controller.ts +115 -115
  329. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  330. package/src/_modules/usage/index.ts +15 -15
  331. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  332. package/src/_modules/usage/usage.controller.ts +126 -126
  333. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  334. package/src/_modules/usage/usage.data-service.ts +185 -185
  335. package/src/_services/base/api.service-base.spec.ts +125 -125
  336. package/src/_services/base/api.service-base.ts +74 -74
  337. package/src/_services/base/archive-data.service.spec.ts +209 -209
  338. package/src/_services/base/archive-data.service.ts +224 -224
  339. package/src/_services/base/data.service.spec.ts +729 -729
  340. package/src/_services/base/data.service.ts +2744 -2744
  341. package/src/_services/base/db.service.spec.ts +160 -160
  342. package/src/_services/base/db.service.ts +1592 -1592
  343. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  344. package/src/_services/base/singleton.service-base.ts +24 -24
  345. package/src/_services/base/singleton.service.spec.ts +114 -114
  346. package/src/_services/base/singleton.service.ts +38 -38
  347. package/src/_services/core/api.service.spec.ts +140 -140
  348. package/src/_services/core/auth.service.spec.ts +159 -159
  349. package/src/_services/core/auth.service.ts +174 -174
  350. package/src/_services/core/email.service.spec.ts +85 -85
  351. package/src/_services/core/email.service.ts +757 -757
  352. package/src/_services/core/global.service.spec.ts +292 -292
  353. package/src/_services/core/global.service.ts +487 -487
  354. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  355. package/src/_services/core/memory-guard.service.ts +481 -481
  356. package/src/_services/core/service-collection.service.spec.ts +46 -46
  357. package/src/_services/core/service-collection.service.ts +6 -6
  358. package/src/_services/route/controller.service.spec.ts +53 -53
  359. package/src/_services/route/controller.service.ts +148 -148
  360. package/src/_services/route/routing-module.service.spec.ts +98 -98
  361. package/src/_services/route/routing-module.service.ts +330 -330
  362. package/src/_services/server/app.server.ts +1941 -1941
  363. package/src/_services/shared.static-service.spec.ts +99 -99
  364. package/src/_services/shared.static-service.ts +78 -78
  365. package/src/index.ts +100 -100
  366. package/tsconfig.app.json +12 -12
  367. package/tsconfig.json +42 -42
@@ -1,259 +1,259 @@
1
- import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
2
- import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
3
- import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
4
- import { DyNTS_SocketSecurity } from '../../_modules/socket/_enums/socket-security.enum';
5
- import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
6
- import { DyNTS_Environment_Settings } from './environment-settings.interface';
7
-
8
- /**
9
- *
10
- *
11
- * @param logRequestsContent only will log if the specific logRequest is also true
12
- *
13
- * @param logEventContent only will log if the specific socket event is also set to log
14
- *
15
- */
16
- export interface DyNTS_Global_Settings {
17
-
18
- env_settings: DyNTS_Environment_Settings;
19
-
20
- /**
21
- * this will be used as the main baseUrl for the application,
22
- * this is not required, but we suggest to use at least a '/api' as base route
23
- */
24
- baseUrl: string;
25
- /**
26
- * this sets the default security for routes
27
- */
28
- defaultRouteSecurity: DyNTS_RouteSecurity;
29
- /**
30
- * this sets the default security for sockets
31
- */
32
- defaultSocketSecurity: DyNTS_SocketSecurity;
33
-
34
- /**
35
- * this is the name of the system, this will be used for the server status
36
- */
37
- systemName?: string;
38
-
39
- /**
40
- * this is the short code name of the system, this will be used for the logs and errors
41
- */
42
- systemShortCodeName?: string;
43
-
44
- /**
45
- * this is the version of the system, this will be used for the logs and errors
46
- */
47
- systemVersion: string;
48
-
49
- /**
50
- * this setting will set if the default route should be created
51
- */
52
- dontCreateDefaultRoute?: boolean;
53
-
54
- /**
55
- *
56
- */
57
- autoResolveEndpointCirculationErrors: boolean;
58
-
59
- /**
60
- * this setting will set the compact error response mode for the system
61
- */
62
- compactErrorResponse: boolean;
63
-
64
- /**
65
- * this is the default page size for pagination
66
- */
67
- defaultPageSize: number;
68
-
69
- /**
70
- * this is the number of items to archive in the list, this will be used to archive the list
71
- */
72
- archiveListAfter: number;
73
-
74
- /**
75
- * this is the environment of the system
76
- */
77
- /* environment: DyFM_EnvironmentFlag; */
78
-
79
- /**
80
- * this setting will set which logs will be shown
81
- */
82
- log_settings: DyNTS_GlobalLog_Settings;
83
-
84
- /**
85
- * this setting will set the research issues mode for the system
86
- */
87
- autoResearchIssues: boolean;
88
-
89
- /**
90
- * this setting will set the bot settings
91
- * (this will be set in the {@link DyNTS_Bot_Main_ControlService} constructor)
92
- *
93
- * {@link DyNTS_GlobalBot_Settings}
94
- * default settings: {@link DyNTS_Bot_Global_Settings}
95
- */
96
- bot_settings: any;
97
-
98
- /**
99
- * this setting will set the openai settings
100
- * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)
101
- *
102
- * {@link DyNTS_OpenAI_Settings}
103
- * default settings: {@link DyNTS_OAI_global_settings}
104
- */
105
- openAi_settings: any;
106
-
107
- /**
108
- * this setting will set the dias settings
109
- * (this will be set in the {@link DyNTS_OAI_LLM_ServiceBase} constructor, if not set already)
110
- * ({@link DyNTS_OAI_VectorDataService} is not using this, but its own settings)
111
- *
112
- * {@link DyNTS_DiAs_Global_Settings}
113
- * default settings: {@link DyNTS_DiAs_Global_Settings}
114
- */
115
- dias_settings: any;
116
-
117
- /**
118
- * this setting will set the assistant settings
119
- * (this will be set in the {@link DyNTS_Ass_ServiceBase} constructor)
120
- *
121
- * {@link DyNTS_Ass_Global_Settings}
122
- * default settings: {@link DyNTS_Ass_global_settings}
123
- */
124
- assistant_settings?: any;
125
-
126
- /**
127
- * Auth-service beállítások.
128
- *
129
- * Ha `optional: true`, a framework NEM követeli meg az egyedi Auth Service-t:
130
- * a {@link DyNTS_GlobalService.getAuthService} hiányzó service esetén `undefined`-ot
131
- * ad vissza a `"Unique Authentication Service missing!"` hiba DOBÁSA HELYETT, és
132
- * a startup-warn ('Authentication Service missing!') is elmarad. Public / no-auth
133
- * szervereknek (pl. nyílt RAG/MCP backend), ahol nincs saját auth-réteg.
134
- *
135
- * Default: `{ optional: false }` — az auth-service kötelező (visszafelé kompatibilis,
136
- * a régi viselkedés: hiányzó service → dobott hiba).
137
- */
138
- auth_settings?: {
139
- /**
140
- * Ha `true`, az Auth Service opcionális: `getAuthService()` NEM dob hiányzó
141
- * service esetén, hanem `undefined`-ot ad vissza (a hívók optional-chaining-gel
142
- * kezelik), és a startup 'Authentication Service missing!' warn is elmarad.
143
- * Default: `false`.
144
- */
145
- optional?: boolean;
146
- };
147
-
148
- /**
149
- * this setting will set the doc chunking settings
150
- */
151
- docChunking: {
152
- maxChunkSize: number;
153
- maxChunkCount: number;
154
- };
155
-
156
- /**
157
- * this setting will set the messaging settings
158
- * (this will be set in the {@link DyNTS_Msg_Main_ControlService} constructor)
159
- *
160
- * {@link DyNTS_Msg_Global_Settings}
161
- * default settings: {@link DyNTS_Msg_global_settings}
162
- */
163
- messaging_settings?: any;
164
-
165
- /**
166
- * BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-header middleware. Ha enabled
167
- * (default: true), a base App az open+secure Express-en a CORS-mount ELŐTT minden válaszra
168
- * ráteszi a biztonsági headereket (x-powered-by removal + X-Frame-Options + nosniff +
169
- * Referrer-Policy; HSTS auto-prod-gated; CSP opt-in). Lásd {@link DyNTS_SecurityHeaders_Settings}.
170
- */
171
- securityHeaders?: DyNTS_SecurityHeaders_Settings;
172
-
173
- /**
174
- * FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog ({@link DyNTS_MemoryGuard}).
175
- * Ha `enabled`, a base `App` startup automatikusan feltelepíti. Periodikusan figyeli a
176
- * heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve TARTÓS rekordot
177
- * hagy az error-sinkbe (Errors-rendszer + Discord) — mielőtt a fatal OOM megölné a
178
- * process-t. Default: enabled, 10s poll, warn 85% / crit 95%.
179
- */
180
- memoryGuard?: {
181
- /** Bekapcsolja a heap-watchdogot (a base App startup feltelepíti). Default: true. */
182
- enabled: boolean;
183
- /** Poll-intervallum ms-ben. Default: 10000. */
184
- pollIntervalMs?: number;
185
- /** Warning küszöb a heap-plafon %-ában. Default: 85. */
186
- heapWarningThreshold?: number;
187
- /** Critical küszöb a heap-plafon %-ában. Default: 95. */
188
- heapCriticalThreshold?: number;
189
- /** A warning küszöb ALATTI margó %-ban a 'recovered'-hez (hiszterézis). Default: 10. */
190
- recoveryMargin?: number;
191
- /** Megőrzött események max száma (ring-buffer). Default: 100. */
192
- maxHistoryCount?: number;
193
- /**
194
- * GC-hányad (GC-ben töltött idő / poll-ablak) küszöb a `warning`-hoz, a %-küszöb MELLETT. 0..1. Default: 0.40.
195
- * A „Ineffective mark-compacts near heap limit" OOM gyakran a heap-% kritikus küszöb ALATT üt be (a GC thrash-el,
196
- * `mutator utilization` lezuhan) — ezt a jelet a puszta % későn/sosem fogja. Ez a GC-jel a valódi OOM-precursor.
197
- */
198
- gcWarningFraction?: number;
199
- /** GC-hányad küszöb a `critical`-hoz (load-shed + graceful-exit zóna). 0..1. Default: 0.60. */
200
- gcCriticalFraction?: number;
201
- /**
202
- * Process-szintű crash-handler (`uncaughtException`) telepítése — a crash ELŐTT TELJES-RÉSZLETŰ error-entry
203
- * (message + stack + kód + issuer + memória-snapshot) az error-sinkbe, majd tiszta exit. Default: true.
204
- * (Az `unhandledRejection`-t a base App már rögzíti; ez az eddig néma `uncaughtException`-t fedi le.)
205
- */
206
- installCrashHandlers?: boolean;
207
- /**
208
- * Tartós `critical` (a megadott poll-számon át, GC-vel sem csökkenő) esetén TISZTA kilépés → a wrapper/
209
- * restart-policy PREDIKTÍVEN újraindít, a kriptikus fatal OOM (exit 134) helyett. Default: false
210
- * (konténer-restart-policy-ra bízva; standalone/`serve`-wrapper-es app opt-in-olja).
211
- */
212
- exitOnSustainedCritical?: boolean;
213
- /** Hány EGYMÁST KÖVETŐ `critical` poll után lépjen ki (`exitOnSustainedCritical`-hez). Default: 3. */
214
- sustainedCriticalPolls?: number;
215
- /** A graceful-exit kódja (a wrapper ezt látja restart-jelnek). Default: 137. */
216
- exitCode?: number;
217
- /**
218
- * **Boot-grace ms** az `exitOnSustainedCritical`-hez: a guard-install UTÁNI első ennyi ms-ben a sustained-critical
219
- * NEM lép ki (csak logol + load-shed). A nehéz-boot appok (nagy in-memory pool-hidratálás) ELEVE GC-thrash-elnek a
220
- * boot alatt → e nélkül a sustained-exit boot-loop-ot okozna. A grace UTÁN a tartós critical normálisan kilép (a
221
- * VALÓDI futásidejű OOM-ot kezeli). Default: 60000 (60s). 0 → nincs grace (azonnal élesedik).
222
- */
223
- bootGraceMs?: number;
224
- };
225
-
226
- /**
227
- * FR-258 / SR-4 — proactive collection-growth monitor (companion to {@link memoryGuard}). Samples
228
- * each registered collection's document count (scan-free `estimatedDocumentCount`) on a slow
229
- * cadence and raises a warning into the Errors-sink BEFORE an unbounded collection can be loaded
230
- * into heap and OOM. Observation only — never deletes (retention SR-1/SR-2 does the deleting).
231
- */
232
- collectionGrowthMonitor?: {
233
- /** Bekapcsolja a monitort (a base App startup feltelepíti). Default: true. */
234
- enabled: boolean;
235
- /** Poll-intervallum ms-ben. Default: 300000 (5 min). */
236
- pollIntervalMs?: number;
237
- /** Warning, ha egy collection doc-száma ezt meghaladja. Default: 250000. */
238
- sizeThresholdDocCount?: number;
239
- /** Warning, ha egy collection az előző poll óta ennél többel nőtt (%). Default: 50. */
240
- growthRateThresholdPct?: number;
241
- /** Re-alert cooldown collection-önként + alert-típusonként, ms (anti-flood). Default: 3600000 (1 h). */
242
- reAlertCooldownMs?: number;
243
- };
244
-
245
- /**
246
- * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK. Ha a környezet local/test ÉS a címzett(ek)
247
- * a teszt-cím-mintára matchelnek, a `DyNTS_EmailService.sendEmail` a küldést SMTP helyett a
248
- * `dynts_sent_test_mails` kollekcióba teríti (olvasás: `DyNTS_getSentMailRoutingModule`).
249
- * Prod/dev környezetben a sink HARD-gate-elt: `enabled: true` sem kapcsolja be (fail-closed).
250
- */
251
- testEmailSink?: {
252
- /** Kikapcsolás local/test-en (default: aktív local/test-en). Prod-on hatástalan. */
253
- enabled?: boolean;
254
- /** Cím-minta override (default: `DyNTS_testEmailPattern` = *@e2e.test.futdevpro.local). */
255
- pattern?: RegExp;
256
- /** A sink-elt emailek TTL-je órában (default: 24). */
257
- ttlHours?: number;
258
- };
259
- }
1
+ import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
2
+ import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
3
+ import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
4
+ import { DyNTS_SocketSecurity } from '../../_modules/socket/_enums/socket-security.enum';
5
+ import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
6
+ import { DyNTS_Environment_Settings } from './environment-settings.interface';
7
+
8
+ /**
9
+ *
10
+ *
11
+ * @param logRequestsContent only will log if the specific logRequest is also true
12
+ *
13
+ * @param logEventContent only will log if the specific socket event is also set to log
14
+ *
15
+ */
16
+ export interface DyNTS_Global_Settings {
17
+
18
+ env_settings: DyNTS_Environment_Settings;
19
+
20
+ /**
21
+ * this will be used as the main baseUrl for the application,
22
+ * this is not required, but we suggest to use at least a '/api' as base route
23
+ */
24
+ baseUrl: string;
25
+ /**
26
+ * this sets the default security for routes
27
+ */
28
+ defaultRouteSecurity: DyNTS_RouteSecurity;
29
+ /**
30
+ * this sets the default security for sockets
31
+ */
32
+ defaultSocketSecurity: DyNTS_SocketSecurity;
33
+
34
+ /**
35
+ * this is the name of the system, this will be used for the server status
36
+ */
37
+ systemName?: string;
38
+
39
+ /**
40
+ * this is the short code name of the system, this will be used for the logs and errors
41
+ */
42
+ systemShortCodeName?: string;
43
+
44
+ /**
45
+ * this is the version of the system, this will be used for the logs and errors
46
+ */
47
+ systemVersion: string;
48
+
49
+ /**
50
+ * this setting will set if the default route should be created
51
+ */
52
+ dontCreateDefaultRoute?: boolean;
53
+
54
+ /**
55
+ *
56
+ */
57
+ autoResolveEndpointCirculationErrors: boolean;
58
+
59
+ /**
60
+ * this setting will set the compact error response mode for the system
61
+ */
62
+ compactErrorResponse: boolean;
63
+
64
+ /**
65
+ * this is the default page size for pagination
66
+ */
67
+ defaultPageSize: number;
68
+
69
+ /**
70
+ * this is the number of items to archive in the list, this will be used to archive the list
71
+ */
72
+ archiveListAfter: number;
73
+
74
+ /**
75
+ * this is the environment of the system
76
+ */
77
+ /* environment: DyFM_EnvironmentFlag; */
78
+
79
+ /**
80
+ * this setting will set which logs will be shown
81
+ */
82
+ log_settings: DyNTS_GlobalLog_Settings;
83
+
84
+ /**
85
+ * this setting will set the research issues mode for the system
86
+ */
87
+ autoResearchIssues: boolean;
88
+
89
+ /**
90
+ * this setting will set the bot settings
91
+ * (this will be set in the {@link DyNTS_Bot_Main_ControlService} constructor)
92
+ *
93
+ * {@link DyNTS_GlobalBot_Settings}
94
+ * default settings: {@link DyNTS_Bot_Global_Settings}
95
+ */
96
+ bot_settings: any;
97
+
98
+ /**
99
+ * this setting will set the openai settings
100
+ * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)
101
+ *
102
+ * {@link DyNTS_OpenAI_Settings}
103
+ * default settings: {@link DyNTS_OAI_global_settings}
104
+ */
105
+ openAi_settings: any;
106
+
107
+ /**
108
+ * this setting will set the dias settings
109
+ * (this will be set in the {@link DyNTS_OAI_LLM_ServiceBase} constructor, if not set already)
110
+ * ({@link DyNTS_OAI_VectorDataService} is not using this, but its own settings)
111
+ *
112
+ * {@link DyNTS_DiAs_Global_Settings}
113
+ * default settings: {@link DyNTS_DiAs_Global_Settings}
114
+ */
115
+ dias_settings: any;
116
+
117
+ /**
118
+ * this setting will set the assistant settings
119
+ * (this will be set in the {@link DyNTS_Ass_ServiceBase} constructor)
120
+ *
121
+ * {@link DyNTS_Ass_Global_Settings}
122
+ * default settings: {@link DyNTS_Ass_global_settings}
123
+ */
124
+ assistant_settings?: any;
125
+
126
+ /**
127
+ * Auth-service beállítások.
128
+ *
129
+ * Ha `optional: true`, a framework NEM követeli meg az egyedi Auth Service-t:
130
+ * a {@link DyNTS_GlobalService.getAuthService} hiányzó service esetén `undefined`-ot
131
+ * ad vissza a `"Unique Authentication Service missing!"` hiba DOBÁSA HELYETT, és
132
+ * a startup-warn ('Authentication Service missing!') is elmarad. Public / no-auth
133
+ * szervereknek (pl. nyílt RAG/MCP backend), ahol nincs saját auth-réteg.
134
+ *
135
+ * Default: `{ optional: false }` — az auth-service kötelező (visszafelé kompatibilis,
136
+ * a régi viselkedés: hiányzó service → dobott hiba).
137
+ */
138
+ auth_settings?: {
139
+ /**
140
+ * Ha `true`, az Auth Service opcionális: `getAuthService()` NEM dob hiányzó
141
+ * service esetén, hanem `undefined`-ot ad vissza (a hívók optional-chaining-gel
142
+ * kezelik), és a startup 'Authentication Service missing!' warn is elmarad.
143
+ * Default: `false`.
144
+ */
145
+ optional?: boolean;
146
+ };
147
+
148
+ /**
149
+ * this setting will set the doc chunking settings
150
+ */
151
+ docChunking: {
152
+ maxChunkSize: number;
153
+ maxChunkCount: number;
154
+ };
155
+
156
+ /**
157
+ * this setting will set the messaging settings
158
+ * (this will be set in the {@link DyNTS_Msg_Main_ControlService} constructor)
159
+ *
160
+ * {@link DyNTS_Msg_Global_Settings}
161
+ * default settings: {@link DyNTS_Msg_global_settings}
162
+ */
163
+ messaging_settings?: any;
164
+
165
+ /**
166
+ * BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-header middleware. Ha enabled
167
+ * (default: true), a base App az open+secure Express-en a CORS-mount ELŐTT minden válaszra
168
+ * ráteszi a biztonsági headereket (x-powered-by removal + X-Frame-Options + nosniff +
169
+ * Referrer-Policy; HSTS auto-prod-gated; CSP opt-in). Lásd {@link DyNTS_SecurityHeaders_Settings}.
170
+ */
171
+ securityHeaders?: DyNTS_SecurityHeaders_Settings;
172
+
173
+ /**
174
+ * FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog ({@link DyNTS_MemoryGuard}).
175
+ * Ha `enabled`, a base `App` startup automatikusan feltelepíti. Periodikusan figyeli a
176
+ * heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve TARTÓS rekordot
177
+ * hagy az error-sinkbe (Errors-rendszer + Discord) — mielőtt a fatal OOM megölné a
178
+ * process-t. Default: enabled, 10s poll, warn 85% / crit 95%.
179
+ */
180
+ memoryGuard?: {
181
+ /** Bekapcsolja a heap-watchdogot (a base App startup feltelepíti). Default: true. */
182
+ enabled: boolean;
183
+ /** Poll-intervallum ms-ben. Default: 10000. */
184
+ pollIntervalMs?: number;
185
+ /** Warning küszöb a heap-plafon %-ában. Default: 85. */
186
+ heapWarningThreshold?: number;
187
+ /** Critical küszöb a heap-plafon %-ában. Default: 95. */
188
+ heapCriticalThreshold?: number;
189
+ /** A warning küszöb ALATTI margó %-ban a 'recovered'-hez (hiszterézis). Default: 10. */
190
+ recoveryMargin?: number;
191
+ /** Megőrzött események max száma (ring-buffer). Default: 100. */
192
+ maxHistoryCount?: number;
193
+ /**
194
+ * GC-hányad (GC-ben töltött idő / poll-ablak) küszöb a `warning`-hoz, a %-küszöb MELLETT. 0..1. Default: 0.40.
195
+ * A „Ineffective mark-compacts near heap limit" OOM gyakran a heap-% kritikus küszöb ALATT üt be (a GC thrash-el,
196
+ * `mutator utilization` lezuhan) — ezt a jelet a puszta % későn/sosem fogja. Ez a GC-jel a valódi OOM-precursor.
197
+ */
198
+ gcWarningFraction?: number;
199
+ /** GC-hányad küszöb a `critical`-hoz (load-shed + graceful-exit zóna). 0..1. Default: 0.60. */
200
+ gcCriticalFraction?: number;
201
+ /**
202
+ * Process-szintű crash-handler (`uncaughtException`) telepítése — a crash ELŐTT TELJES-RÉSZLETŰ error-entry
203
+ * (message + stack + kód + issuer + memória-snapshot) az error-sinkbe, majd tiszta exit. Default: true.
204
+ * (Az `unhandledRejection`-t a base App már rögzíti; ez az eddig néma `uncaughtException`-t fedi le.)
205
+ */
206
+ installCrashHandlers?: boolean;
207
+ /**
208
+ * Tartós `critical` (a megadott poll-számon át, GC-vel sem csökkenő) esetén TISZTA kilépés → a wrapper/
209
+ * restart-policy PREDIKTÍVEN újraindít, a kriptikus fatal OOM (exit 134) helyett. Default: false
210
+ * (konténer-restart-policy-ra bízva; standalone/`serve`-wrapper-es app opt-in-olja).
211
+ */
212
+ exitOnSustainedCritical?: boolean;
213
+ /** Hány EGYMÁST KÖVETŐ `critical` poll után lépjen ki (`exitOnSustainedCritical`-hez). Default: 3. */
214
+ sustainedCriticalPolls?: number;
215
+ /** A graceful-exit kódja (a wrapper ezt látja restart-jelnek). Default: 137. */
216
+ exitCode?: number;
217
+ /**
218
+ * **Boot-grace ms** az `exitOnSustainedCritical`-hez: a guard-install UTÁNI első ennyi ms-ben a sustained-critical
219
+ * NEM lép ki (csak logol + load-shed). A nehéz-boot appok (nagy in-memory pool-hidratálás) ELEVE GC-thrash-elnek a
220
+ * boot alatt → e nélkül a sustained-exit boot-loop-ot okozna. A grace UTÁN a tartós critical normálisan kilép (a
221
+ * VALÓDI futásidejű OOM-ot kezeli). Default: 60000 (60s). 0 → nincs grace (azonnal élesedik).
222
+ */
223
+ bootGraceMs?: number;
224
+ };
225
+
226
+ /**
227
+ * FR-258 / SR-4 — proactive collection-growth monitor (companion to {@link memoryGuard}). Samples
228
+ * each registered collection's document count (scan-free `estimatedDocumentCount`) on a slow
229
+ * cadence and raises a warning into the Errors-sink BEFORE an unbounded collection can be loaded
230
+ * into heap and OOM. Observation only — never deletes (retention SR-1/SR-2 does the deleting).
231
+ */
232
+ collectionGrowthMonitor?: {
233
+ /** Bekapcsolja a monitort (a base App startup feltelepíti). Default: true. */
234
+ enabled: boolean;
235
+ /** Poll-intervallum ms-ben. Default: 300000 (5 min). */
236
+ pollIntervalMs?: number;
237
+ /** Warning, ha egy collection doc-száma ezt meghaladja. Default: 250000. */
238
+ sizeThresholdDocCount?: number;
239
+ /** Warning, ha egy collection az előző poll óta ennél többel nőtt (%). Default: 50. */
240
+ growthRateThresholdPct?: number;
241
+ /** Re-alert cooldown collection-önként + alert-típusonként, ms (anti-flood). Default: 3600000 (1 h). */
242
+ reAlertCooldownMs?: number;
243
+ };
244
+
245
+ /**
246
+ * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK. Ha a környezet local/test ÉS a címzett(ek)
247
+ * a teszt-cím-mintára matchelnek, a `DyNTS_EmailService.sendEmail` a küldést SMTP helyett a
248
+ * `dynts_sent_test_mails` kollekcióba teríti (olvasás: `DyNTS_getSentMailRoutingModule`).
249
+ * Prod/dev környezetben a sink HARD-gate-elt: `enabled: true` sem kapcsolja be (fail-closed).
250
+ */
251
+ testEmailSink?: {
252
+ /** Kikapcsolás local/test-en (default: aktív local/test-en). Prod-on hatástalan. */
253
+ enabled?: boolean;
254
+ /** Cím-minta override (default: `DyNTS_testEmailPattern` = *@e2e.test.futdevpro.local). */
255
+ pattern?: RegExp;
256
+ /** A sink-elt emailek TTL-je órában (default: 24). */
257
+ ttlHours?: number;
258
+ };
259
+ }
@@ -1,21 +1,21 @@
1
- import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
2
- import { DyNTS_Controller } from '../../_services/route/controller.service';
3
-
4
-
5
- /**
6
- * This is a main route point handler, which collects a list of controllers for the API
7
- */
8
- export interface DyNTS_RoutingModule_Settings {
9
- /**
10
- * main route of the module
11
- */
12
- route: string;
13
- /**
14
- * the collection of controllers (sub-routes, with differentlogical parts, to different db elements)
15
- */
16
- controllers: DyNTS_Controller[];
17
- /**
18
- * securityOverride will be used to create different security for a single module without changing the default security (http/https/both)
19
- */
20
- securityOverride?: DyNTS_RouteSecurity;
21
- }
1
+ import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
2
+ import { DyNTS_Controller } from '../../_services/route/controller.service';
3
+
4
+
5
+ /**
6
+ * This is a main route point handler, which collects a list of controllers for the API
7
+ */
8
+ export interface DyNTS_RoutingModule_Settings {
9
+ /**
10
+ * main route of the module
11
+ */
12
+ route: string;
13
+ /**
14
+ * the collection of controllers (sub-routes, with differentlogical parts, to different db elements)
15
+ */
16
+ controllers: DyNTS_Controller[];
17
+ /**
18
+ * securityOverride will be used to create different security for a single module without changing the default security (http/https/both)
19
+ */
20
+ securityOverride?: DyNTS_RouteSecurity;
21
+ }
@@ -1,29 +1,29 @@
1
- import { DyNTS_StaticClient_Settings } from './static-client-settings.interface';
2
-
3
- describe('| DyNTS_StaticClient_Settings', () => {
4
- it('| should allow minimal settings with only root', () => {
5
- const s: DyNTS_StaticClient_Settings = { root: '/dist' };
6
- expect(s.root).toBe('/dist');
7
- expect(s.fallbackPath).toBeUndefined();
8
- });
9
-
10
- it('| should allow optional fallbackPath', () => {
11
- const s: DyNTS_StaticClient_Settings = {
12
- root: '/dist',
13
- fallbackPath: 'index.html',
14
- };
15
- expect(s.fallbackPath).toBe('index.html');
16
- });
17
-
18
- it('| should allow SPA cache options', () => {
19
- const s: DyNTS_StaticClient_Settings = {
20
- root: '/dist',
21
- assetCacheMaxAge: 31536000,
22
- assetCacheImmutable: true,
23
- fallbackCacheMaxAge: 0,
24
- };
25
- expect(s.assetCacheMaxAge).toBe(31536000);
26
- expect(s.assetCacheImmutable).toBe(true);
27
- expect(s.fallbackCacheMaxAge).toBe(0);
28
- });
29
- });
1
+ import { DyNTS_StaticClient_Settings } from './static-client-settings.interface';
2
+
3
+ describe('| DyNTS_StaticClient_Settings', () => {
4
+ it('| should allow minimal settings with only root', () => {
5
+ const s: DyNTS_StaticClient_Settings = { root: '/dist' };
6
+ expect(s.root).toBe('/dist');
7
+ expect(s.fallbackPath).toBeUndefined();
8
+ });
9
+
10
+ it('| should allow optional fallbackPath', () => {
11
+ const s: DyNTS_StaticClient_Settings = {
12
+ root: '/dist',
13
+ fallbackPath: 'index.html',
14
+ };
15
+ expect(s.fallbackPath).toBe('index.html');
16
+ });
17
+
18
+ it('| should allow SPA cache options', () => {
19
+ const s: DyNTS_StaticClient_Settings = {
20
+ root: '/dist',
21
+ assetCacheMaxAge: 31536000,
22
+ assetCacheImmutable: true,
23
+ fallbackCacheMaxAge: 0,
24
+ };
25
+ expect(s.assetCacheMaxAge).toBe(31536000);
26
+ expect(s.assetCacheImmutable).toBe(true);
27
+ expect(s.fallbackCacheMaxAge).toBe(0);
28
+ });
29
+ });