@futdevpro/nts-dynamo 1.15.98 → 1.15.100

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