@futdevpro/nts-dynamo 1.15.74 → 1.15.78

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 (366) 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 +2783 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +94 -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/_services/core/global.service.d.ts +7 -0
  27. package/build/_services/core/global.service.d.ts.map +1 -1
  28. package/build/_services/core/global.service.js +10 -0
  29. package/build/_services/core/global.service.js.map +1 -1
  30. package/build/_services/server/app.server.d.ts +45 -0
  31. package/build/_services/server/app.server.d.ts.map +1 -1
  32. package/build/_services/server/app.server.js +85 -173
  33. package/build/_services/server/app.server.js.map +1 -1
  34. package/eslint.config.js +3 -3
  35. package/nodemon.json +24 -24
  36. package/package.json +2 -2
  37. package/pnpm-workspace.yaml +5 -5
  38. package/scripts/run-coverage-tests.js +28 -28
  39. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  40. package/spec/support/helpers/ts-node-helper.js +93 -93
  41. package/spec/support/jasmine.coverage.json +24 -24
  42. package/spec/support/jasmine.json +24 -24
  43. package/src/_collections/archive.util.spec.ts +57 -57
  44. package/src/_collections/archive.util.ts +18 -18
  45. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  46. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  47. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  48. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  49. package/src/_collections/default-not-found-page.const.ts +22 -22
  50. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  51. package/src/_collections/default-socket-path.const.ts +2 -2
  52. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  53. package/src/_collections/get-environment-settings.util.ts +48 -48
  54. package/src/_collections/global-settings.const.ts +97 -97
  55. package/src/_collections/sample.env +21 -21
  56. package/src/_collections/star.controller.spec.ts +224 -224
  57. package/src/_collections/star.controller.ts +129 -129
  58. package/src/_enums/data-model-type.enum.ts +14 -14
  59. package/src/_enums/data-service-function.enum.ts +24 -24
  60. package/src/_enums/predefined-data-types.enum.ts +16 -16
  61. package/src/_enums/route-security.enum.ts +12 -12
  62. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  63. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  64. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  65. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  66. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  67. package/src/_models/control-models/app-params.control-model.ts +136 -136
  68. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  69. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  70. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  71. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  72. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  73. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  74. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  75. package/src/_models/control-models/system-control.control-model.ts +12 -12
  76. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  77. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  78. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  79. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  80. package/src/_models/interfaces/global-settings.interface.ts +216 -216
  81. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  82. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  83. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  84. package/src/_models/types/db-update.type.ts +100 -100
  85. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  86. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  87. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  88. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  90. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  91. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  92. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  93. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  94. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  95. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  96. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  97. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  98. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  99. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  100. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  101. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  102. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  103. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  104. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  105. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  106. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  107. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  108. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  109. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  110. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  111. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  112. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  113. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  114. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  115. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  116. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  120. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  121. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  122. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  123. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  124. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  125. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  126. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  127. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  128. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  129. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  130. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  131. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  132. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  133. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  134. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  135. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  136. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  137. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  138. package/src/_modules/ai/index.ts +23 -23
  139. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  140. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  141. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  142. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  143. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  144. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  145. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  146. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  147. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  148. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  149. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  150. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  151. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  152. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  153. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  154. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  155. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  156. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  157. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  158. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  159. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  160. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  161. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  162. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  163. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  164. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  165. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  166. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  167. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  168. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  169. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  170. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  171. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  172. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  173. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  174. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  175. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  176. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  177. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  178. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  179. package/src/_modules/custom-data/index.ts +9 -9
  180. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  181. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  182. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  183. package/src/_modules/data-readers/index.ts +11 -11
  184. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  185. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  186. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  187. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  188. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  189. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  190. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  191. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  192. package/src/_modules/defaults/index.ts +17 -17
  193. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  194. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  195. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  196. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  197. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  198. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  199. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  200. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  201. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  202. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  203. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  204. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  205. package/src/_modules/discord-assistant/index.ts +38 -38
  206. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  207. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  208. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  209. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  210. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  211. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  212. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  213. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  214. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  215. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  216. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  217. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  218. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  219. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  220. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  221. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  222. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  223. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  224. package/src/_modules/discord-bot/index.ts +36 -36
  225. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  226. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  227. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  228. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  229. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  230. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  231. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  232. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  233. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  234. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  235. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  236. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  237. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  238. package/src/_modules/local-vector-search/index.ts +16 -16
  239. package/src/_modules/logs/index.ts +11 -11
  240. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  241. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  242. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  243. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  244. package/src/_modules/mcp/index.ts +13 -13
  245. package/src/_modules/messaging/README.md +354 -354
  246. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  247. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  248. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  249. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  250. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  251. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  252. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  253. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  254. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  255. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  256. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  257. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  258. package/src/_modules/messaging/index.ts +30 -30
  259. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  260. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  261. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  262. package/src/_modules/mock/app-params.mock.ts +9 -9
  263. package/src/_modules/mock/app-server.mock.ts +188 -188
  264. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  265. package/src/_modules/mock/auth-service.mock.ts +28 -28
  266. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  267. package/src/_modules/mock/controller.mock.ts +16 -16
  268. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  269. package/src/_modules/mock/data-model.mock.ts +82 -82
  270. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  271. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  272. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  273. package/src/_modules/mock/email-service.mock.ts +20 -20
  274. package/src/_modules/mock/email-template.mock.html +14 -14
  275. package/src/_modules/mock/endpoint.mock.ts +91 -91
  276. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  277. package/src/_modules/mock/socket-client.mock.ts +45 -45
  278. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  279. package/src/_modules/mock/socket-server.mock.ts +46 -46
  280. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  281. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  282. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  283. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  284. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  285. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  286. package/src/_modules/oauth2/index.ts +17 -17
  287. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  288. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  289. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  290. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  291. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  292. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  293. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  294. package/src/_modules/scoped-config/index.ts +17 -17
  295. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  296. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  297. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  298. package/src/_modules/server/errors/errors.controller.ts +489 -489
  299. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  300. package/src/_modules/server/index.ts +30 -30
  301. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  302. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  303. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  304. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  305. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  306. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  307. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
  308. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  309. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  310. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  311. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  312. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  313. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  314. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  315. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  316. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  317. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  318. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  319. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  320. package/src/_modules/socket/app-extended.server.ts +630 -630
  321. package/src/_modules/socket/index.ts +42 -42
  322. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  323. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  324. package/src/_modules/test/index.ts +11 -11
  325. package/src/_modules/test/test.controller.spec.ts +72 -72
  326. package/src/_modules/test/test.controller.ts +115 -115
  327. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  328. package/src/_modules/usage/index.ts +15 -15
  329. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  330. package/src/_modules/usage/usage.controller.ts +126 -126
  331. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  332. package/src/_modules/usage/usage.data-service.ts +185 -185
  333. package/src/_services/base/api.service-base.spec.ts +125 -125
  334. package/src/_services/base/api.service-base.ts +74 -74
  335. package/src/_services/base/archive-data.service.spec.ts +196 -196
  336. package/src/_services/base/archive-data.service.ts +216 -216
  337. package/src/_services/base/data.service.spec.ts +674 -674
  338. package/src/_services/base/data.service.ts +2719 -2719
  339. package/src/_services/base/db.service.spec.ts +73 -73
  340. package/src/_services/base/db.service.ts +1575 -1575
  341. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  342. package/src/_services/base/singleton.service-base.ts +24 -24
  343. package/src/_services/base/singleton.service.spec.ts +114 -114
  344. package/src/_services/base/singleton.service.ts +38 -38
  345. package/src/_services/core/api.service.spec.ts +140 -140
  346. package/src/_services/core/auth.service.spec.ts +159 -159
  347. package/src/_services/core/auth.service.ts +174 -174
  348. package/src/_services/core/email.service.spec.ts +85 -85
  349. package/src/_services/core/email.service.ts +742 -742
  350. package/src/_services/core/global.service.spec.ts +292 -292
  351. package/src/_services/core/global.service.ts +487 -475
  352. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  353. package/src/_services/core/memory-guard.service.ts +481 -481
  354. package/src/_services/core/service-collection.service.spec.ts +46 -46
  355. package/src/_services/core/service-collection.service.ts +6 -6
  356. package/src/_services/route/controller.service.spec.ts +53 -53
  357. package/src/_services/route/controller.service.ts +148 -148
  358. package/src/_services/route/routing-module.service.spec.ts +98 -98
  359. package/src/_services/route/routing-module.service.ts +330 -330
  360. package/src/_services/server/app.server-retention.spec.ts +106 -0
  361. package/src/_services/server/app.server.ts +1869 -1747
  362. package/src/_services/shared.static-service.spec.ts +99 -99
  363. package/src/_services/shared.static-service.ts +78 -78
  364. package/src/index.ts +96 -96
  365. package/tsconfig.app.json +12 -12
  366. package/tsconfig.json +42 -42
@@ -1,312 +1,312 @@
1
-
2
- import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
3
-
4
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
5
- import { DyNTS_GlobalService } from '../../../_services/core/global.service';
6
- import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
7
- import { DyNTS_ScopedConfig } from '../_models/data-models/dynts-scoped-config.data-model';
8
- import {
9
- DyNTS_ScopedConfigResolvedValue
10
- } from '../_models/interfaces/dynts-scoped-config.interface';
11
- import { DyNTS_ScopedConfig_DataService } from './dynts-scoped-config.data-service';
12
- import { DyNTS_ScopedConfig_ControlService } from './dynts-scoped-config.control-service';
13
-
14
- /**
15
- * BFR-AM-004 — a generikus scoped-config precedencia-engine spec-jei.
16
- *
17
- * A `DyNTS_ScopedConfig_ControlService` minden DB-művelet előtt lazy `new DyNTS_ScopedConfig_DataService`-t
18
- * készít (eager DB-resolve a base-ctor-ban — memory: dynts_dataservice_eager_resolve), ezért a teszt:
19
- * (1) stub-olja a `DyNTS_GlobalService.getDBService`-t (hogy a base-ctor ne dobjon),
20
- * (2) stub-olja a `DyNTS_ScopedConfig_DataService.prototype.findActiveList`-et a kontrollált
21
- * rekord-halmazzal (a precedencia memóriában fut, így NEM kell élő Mongo) → a DB-round-trip
22
- * spec-ek így tisztán futnak Mongo NÉLKÜL (skip-guard nem szükséges).
23
- */
24
- describe('| DyNTS_ScopedConfig_ControlService', () => {
25
-
26
- let control: DyNTS_ScopedConfig_ControlService;
27
- let mockDBService: jasmine.SpyObj<{ find: () => Promise<unknown[]>; findOne: () => Promise<unknown> }>;
28
-
29
- /** Egy aktív rekord gyors gyártása a kontrollált rekord-halmazhoz. */
30
- const makeRecord = (set: Partial<DyNTS_ScopedConfig>): DyNTS_ScopedConfig =>
31
- new DyNTS_ScopedConfig(set);
32
-
33
- beforeAll(() => {
34
- if (!DyNTS_global_settings.systemShortCodeName) {
35
- (DyNTS_global_settings as { systemShortCodeName?: string }).systemShortCodeName = 'TEST';
1
+
2
+ import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
3
+
4
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
5
+ import { DyNTS_GlobalService } from '../../../_services/core/global.service';
6
+ import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
7
+ import { DyNTS_ScopedConfig } from '../_models/data-models/dynts-scoped-config.data-model';
8
+ import {
9
+ DyNTS_ScopedConfigResolvedValue
10
+ } from '../_models/interfaces/dynts-scoped-config.interface';
11
+ import { DyNTS_ScopedConfig_DataService } from './dynts-scoped-config.data-service';
12
+ import { DyNTS_ScopedConfig_ControlService } from './dynts-scoped-config.control-service';
13
+
14
+ /**
15
+ * BFR-AM-004 — a generikus scoped-config precedencia-engine spec-jei.
16
+ *
17
+ * A `DyNTS_ScopedConfig_ControlService` minden DB-művelet előtt lazy `new DyNTS_ScopedConfig_DataService`-t
18
+ * készít (eager DB-resolve a base-ctor-ban — memory: dynts_dataservice_eager_resolve), ezért a teszt:
19
+ * (1) stub-olja a `DyNTS_GlobalService.getDBService`-t (hogy a base-ctor ne dobjon),
20
+ * (2) stub-olja a `DyNTS_ScopedConfig_DataService.prototype.findActiveList`-et a kontrollált
21
+ * rekord-halmazzal (a precedencia memóriában fut, így NEM kell élő Mongo) → a DB-round-trip
22
+ * spec-ek így tisztán futnak Mongo NÉLKÜL (skip-guard nem szükséges).
23
+ */
24
+ describe('| DyNTS_ScopedConfig_ControlService', () => {
25
+
26
+ let control: DyNTS_ScopedConfig_ControlService;
27
+ let mockDBService: jasmine.SpyObj<{ find: () => Promise<unknown[]>; findOne: () => Promise<unknown> }>;
28
+
29
+ /** Egy aktív rekord gyors gyártása a kontrollált rekord-halmazhoz. */
30
+ const makeRecord = (set: Partial<DyNTS_ScopedConfig>): DyNTS_ScopedConfig =>
31
+ new DyNTS_ScopedConfig(set);
32
+
33
+ beforeAll(() => {
34
+ if (!DyNTS_global_settings.systemShortCodeName) {
35
+ (DyNTS_global_settings as { systemShortCodeName?: string }).systemShortCodeName = 'TEST';
36
36
  }
37
-
38
- if (!DyNTS_global_settings.env_settings) {
39
- (DyNTS_global_settings as { env_settings?: unknown }).env_settings = {
40
- environment: DyFM_EnvironmentFlag.local,
41
- };
42
- }
43
- });
44
-
45
- beforeEach(() => {
46
- // A base-ctor eager getDBService-jét stub-oljuk, hogy a lazy DataService-példányok ne dobjanak.
47
- mockDBService = jasmine.createSpyObj('DyNTS_DBService', [ 'find', 'findOne' ]);
48
- mockDBService.find.and.returnValue(Promise.resolve([]));
49
- mockDBService.findOne.and.returnValue(Promise.resolve(null));
50
- spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService as never);
51
-
52
- // Friss singleton-állapot minden teszthez (új instance + tiszta cache).
53
- (DyNTS_ScopedConfig_ControlService as unknown as { _instance?: DyNTS_ScopedConfig_ControlService })._instance = undefined;
54
- control = DyNTS_ScopedConfig_ControlService.getInstance();
55
- control.invalidateCache();
56
- });
57
-
58
- /** A kontrollált aktív rekord-halmaz beállítása (a `loadEffectiveRecords` ezt kapja vissza). */
59
- const stubRecords = (records: DyNTS_ScopedConfig[]): void => {
60
- spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActiveList').and.returnValue(Promise.resolve(records));
61
- };
62
-
63
- describe('| getInstance', () => {
64
- it('| should return the same singleton instance', () => {
65
- expect(DyNTS_ScopedConfig_ControlService.getInstance()).toBe(control);
66
- });
67
- });
68
-
69
- describe('| resolve — precedence', () => {
70
-
71
- it('| should return builtinDefault when no DB record exists', async () => {
72
- stubRecords([]);
73
-
74
- const resolved: DyNTS_ScopedConfigResolvedValue<number> =
75
- await control.resolve<number>('read.topK', { builtinDefault: 5 });
76
-
77
- expect(resolved.value).toBe(5);
78
- expect(resolved.resolvedFrom).toBe('builtin');
79
- });
80
-
81
- it('| should return global over builtinDefault', async () => {
82
- stubRecords([
83
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10, setBy: 'manual' }),
84
- ]);
85
-
86
- const resolved: DyNTS_ScopedConfigResolvedValue<number> =
87
- await control.resolve<number>('read.topK', { builtinDefault: 5 });
88
-
89
- expect(resolved.value).toBe(10);
90
- expect(resolved.resolvedFrom).toBe('global');
91
- expect(resolved.setBy).toBe('manual');
92
- });
93
-
94
- it('| should return table over global', async () => {
95
- stubRecords([
96
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
97
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
98
- ]);
99
-
100
- const resolved: DyNTS_ScopedConfigResolvedValue<number> =
101
- await control.resolve<number>('read.topK', { table: 'documents', builtinDefault: 5 });
102
-
103
- expect(resolved.value).toBe(20);
104
- expect(resolved.resolvedFrom).toBe('table');
105
- });
106
-
107
- it('| should return scope-root over table', async () => {
108
- stubRecords([
109
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
110
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
111
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
112
- ]);
113
-
114
- const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
115
- table: 'documents',
116
- scopePath: [{ scopeId: 'root' }],
117
- builtinDefault: 5,
118
- });
119
-
120
- expect(resolved.value).toBe(30);
121
- expect(resolved.resolvedFrom).toBe('scope');
122
- expect(resolved.scopeId).toBe('root');
123
- });
124
-
125
- it('| should return scope-LEAF over scope-root (deepest wins)', async () => {
126
- stubRecords([
127
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
128
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
129
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.topK', value: 40 }),
130
- ]);
131
-
132
- // scopePath: gyökér→levél; a feloldás a LEVÉBŐL (leaf) indul → 'leaf' nyer 'root' felett.
133
- const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
134
- table: 'documents',
135
- scopePath: [{ scopeId: 'root' }, { scopeId: 'leaf' }],
136
- builtinDefault: 5,
137
- });
138
-
139
- expect(resolved.value).toBe(40);
140
- expect(resolved.resolvedFrom).toBe('scope');
141
- expect(resolved.scopeId).toBe('leaf');
142
- });
143
-
144
- it('| should fall back to scope-root when leaf has no record for the key', async () => {
145
- stubRecords([
146
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
147
- // 'leaf' csak EGY MÁSIK kulcsot állít — read.topK-ra nincs leaf-rekord → scope-root nyer.
148
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.maxResults', value: 99 }),
149
- ]);
150
-
151
- const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
152
- table: 'documents',
153
- scopePath: [{ scopeId: 'root' }, { scopeId: 'leaf' }],
154
- builtinDefault: 5,
155
- });
156
-
157
- expect(resolved.value).toBe(30);
158
- expect(resolved.scopeId).toBe('root');
159
- });
160
-
161
- it('| should NOT use a table record from a different tableScope', async () => {
162
- stubRecords([
163
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'other', key: 'read.topK', value: 999 }),
164
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
165
- ]);
166
-
167
- const resolved: DyNTS_ScopedConfigResolvedValue<number> =
168
- await control.resolve<number>('read.topK', { table: 'documents', builtinDefault: 5 });
169
-
170
- // 'other' table-rekord nem releváns → global nyer.
171
- expect(resolved.value).toBe(10);
172
- expect(resolved.resolvedFrom).toBe('global');
173
- });
174
-
175
- it('| should ignore scope/table records when context has no table', async () => {
176
- stubRecords([
177
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
178
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
179
- ]);
180
-
181
- const resolved: DyNTS_ScopedConfigResolvedValue<number> =
182
- await control.resolve<number>('read.topK', { builtinDefault: 5 });
183
-
184
- expect(resolved.value).toBe(10);
185
- expect(resolved.resolvedFrom).toBe('global');
186
- });
187
- });
188
-
189
- describe('| resolve — Mixed value get', () => {
190
-
191
- it('| should resolve a string[] (Mixed) value intact', async () => {
37
+
38
+ if (!DyNTS_global_settings.env_settings) {
39
+ (DyNTS_global_settings as { env_settings?: unknown }).env_settings = {
40
+ environment: DyFM_EnvironmentFlag.local,
41
+ };
42
+ }
43
+ });
44
+
45
+ beforeEach(() => {
46
+ // A base-ctor eager getDBService-jét stub-oljuk, hogy a lazy DataService-példányok ne dobjanak.
47
+ mockDBService = jasmine.createSpyObj('DyNTS_DBService', [ 'find', 'findOne' ]);
48
+ mockDBService.find.and.returnValue(Promise.resolve([]));
49
+ mockDBService.findOne.and.returnValue(Promise.resolve(null));
50
+ spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService as never);
51
+
52
+ // Friss singleton-állapot minden teszthez (új instance + tiszta cache).
53
+ (DyNTS_ScopedConfig_ControlService as unknown as { _instance?: DyNTS_ScopedConfig_ControlService })._instance = undefined;
54
+ control = DyNTS_ScopedConfig_ControlService.getInstance();
55
+ control.invalidateCache();
56
+ });
57
+
58
+ /** A kontrollált aktív rekord-halmaz beállítása (a `loadEffectiveRecords` ezt kapja vissza). */
59
+ const stubRecords = (records: DyNTS_ScopedConfig[]): void => {
60
+ spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActiveList').and.returnValue(Promise.resolve(records));
61
+ };
62
+
63
+ describe('| getInstance', () => {
64
+ it('| should return the same singleton instance', () => {
65
+ expect(DyNTS_ScopedConfig_ControlService.getInstance()).toBe(control);
66
+ });
67
+ });
68
+
69
+ describe('| resolve — precedence', () => {
70
+
71
+ it('| should return builtinDefault when no DB record exists', async () => {
72
+ stubRecords([]);
73
+
74
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> =
75
+ await control.resolve<number>('read.topK', { builtinDefault: 5 });
76
+
77
+ expect(resolved.value).toBe(5);
78
+ expect(resolved.resolvedFrom).toBe('builtin');
79
+ });
80
+
81
+ it('| should return global over builtinDefault', async () => {
82
+ stubRecords([
83
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10, setBy: 'manual' }),
84
+ ]);
85
+
86
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> =
87
+ await control.resolve<number>('read.topK', { builtinDefault: 5 });
88
+
89
+ expect(resolved.value).toBe(10);
90
+ expect(resolved.resolvedFrom).toBe('global');
91
+ expect(resolved.setBy).toBe('manual');
92
+ });
93
+
94
+ it('| should return table over global', async () => {
95
+ stubRecords([
96
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
97
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
98
+ ]);
99
+
100
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> =
101
+ await control.resolve<number>('read.topK', { table: 'documents', builtinDefault: 5 });
102
+
103
+ expect(resolved.value).toBe(20);
104
+ expect(resolved.resolvedFrom).toBe('table');
105
+ });
106
+
107
+ it('| should return scope-root over table', async () => {
108
+ stubRecords([
109
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
110
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
111
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
112
+ ]);
113
+
114
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
115
+ table: 'documents',
116
+ scopePath: [{ scopeId: 'root' }],
117
+ builtinDefault: 5,
118
+ });
119
+
120
+ expect(resolved.value).toBe(30);
121
+ expect(resolved.resolvedFrom).toBe('scope');
122
+ expect(resolved.scopeId).toBe('root');
123
+ });
124
+
125
+ it('| should return scope-LEAF over scope-root (deepest wins)', async () => {
126
+ stubRecords([
127
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
128
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
129
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.topK', value: 40 }),
130
+ ]);
131
+
132
+ // scopePath: gyökér→levél; a feloldás a LEVÉBŐL (leaf) indul → 'leaf' nyer 'root' felett.
133
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
134
+ table: 'documents',
135
+ scopePath: [{ scopeId: 'root' }, { scopeId: 'leaf' }],
136
+ builtinDefault: 5,
137
+ });
138
+
139
+ expect(resolved.value).toBe(40);
140
+ expect(resolved.resolvedFrom).toBe('scope');
141
+ expect(resolved.scopeId).toBe('leaf');
142
+ });
143
+
144
+ it('| should fall back to scope-root when leaf has no record for the key', async () => {
145
+ stubRecords([
146
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'root', key: 'read.topK', value: 30 }),
147
+ // 'leaf' csak EGY MÁSIK kulcsot állít — read.topK-ra nincs leaf-rekord → scope-root nyer.
148
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.maxResults', value: 99 }),
149
+ ]);
150
+
151
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> = await control.resolve<number>('read.topK', {
152
+ table: 'documents',
153
+ scopePath: [{ scopeId: 'root' }, { scopeId: 'leaf' }],
154
+ builtinDefault: 5,
155
+ });
156
+
157
+ expect(resolved.value).toBe(30);
158
+ expect(resolved.scopeId).toBe('root');
159
+ });
160
+
161
+ it('| should NOT use a table record from a different tableScope', async () => {
162
+ stubRecords([
163
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'other', key: 'read.topK', value: 999 }),
164
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
165
+ ]);
166
+
167
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> =
168
+ await control.resolve<number>('read.topK', { table: 'documents', builtinDefault: 5 });
169
+
170
+ // 'other' table-rekord nem releváns → global nyer.
171
+ expect(resolved.value).toBe(10);
172
+ expect(resolved.resolvedFrom).toBe('global');
173
+ });
174
+
175
+ it('| should ignore scope/table records when context has no table', async () => {
176
+ stubRecords([
177
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
178
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
179
+ ]);
180
+
181
+ const resolved: DyNTS_ScopedConfigResolvedValue<number> =
182
+ await control.resolve<number>('read.topK', { builtinDefault: 5 });
183
+
184
+ expect(resolved.value).toBe(10);
185
+ expect(resolved.resolvedFrom).toBe('global');
186
+ });
187
+ });
188
+
189
+ describe('| resolve — Mixed value get', () => {
190
+
191
+ it('| should resolve a string[] (Mixed) value intact', async () => {
192
192
  const patterns: string[] = [ '**/node_modules/**', '**/.git/**' ];
193
-
194
- stubRecords([
195
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'scan.ignorePatterns', value: patterns }),
196
- ]);
197
-
198
- const resolved: DyNTS_ScopedConfigResolvedValue<string[]> =
199
- await control.resolve<string[]>('scan.ignorePatterns', { builtinDefault: [] });
200
-
201
- expect(resolved.value).toEqual(patterns);
202
- expect(resolved.resolvedFrom).toBe('global');
203
- });
204
-
205
- it('| should resolve an object (Mixed) value intact', async () => {
193
+
194
+ stubRecords([
195
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'scan.ignorePatterns', value: patterns }),
196
+ ]);
197
+
198
+ const resolved: DyNTS_ScopedConfigResolvedValue<string[]> =
199
+ await control.resolve<string[]>('scan.ignorePatterns', { builtinDefault: [] });
200
+
201
+ expect(resolved.value).toEqual(patterns);
202
+ expect(resolved.resolvedFrom).toBe('global');
203
+ });
204
+
205
+ it('| should resolve an object (Mixed) value intact', async () => {
206
206
  const obj = { provider: 'openai', model: 'text-embedding-3-large' };
207
-
208
- stubRecords([
209
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'embedding.config', value: obj }),
210
- ]);
211
-
212
- const resolved: DyNTS_ScopedConfigResolvedValue<{ provider: string; model: string }> =
213
- await control.resolve('embedding.config', { builtinDefault: { provider: '', model: '' } });
214
-
215
- expect(resolved.value).toEqual(obj);
216
- });
217
- });
218
-
219
- describe('| resolveAll', () => {
220
-
221
- it('| should merge all configured keys with their resolved source level', async () => {
222
- stubRecords([
223
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
224
- makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
225
- makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.minScore', value: 0.5 }),
226
- makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.maxResults', value: 99 }),
227
- ]);
228
-
229
- const all = await control.resolveAll({ table: 'documents', scopePath: [{ scopeId: 'leaf' }] });
230
-
231
- // read.topK: table nyer a global felett.
232
- expect(all['read.topK'].value).toBe(20);
233
- expect(all['read.topK'].resolvedFrom).toBe('table');
234
- // read.minScore: csak global.
235
- expect(all['read.minScore'].value).toBe(0.5);
236
- expect(all['read.minScore'].resolvedFrom).toBe('global');
237
- // read.maxResults: scope (leaf).
238
- expect(all['read.maxResults'].value).toBe(99);
239
- expect(all['read.maxResults'].resolvedFrom).toBe('scope');
240
- });
241
-
242
- it('| should return empty object when no records configured', async () => {
243
- stubRecords([]);
207
+
208
+ stubRecords([
209
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'embedding.config', value: obj }),
210
+ ]);
211
+
212
+ const resolved: DyNTS_ScopedConfigResolvedValue<{ provider: string; model: string }> =
213
+ await control.resolve('embedding.config', { builtinDefault: { provider: '', model: '' } });
214
+
215
+ expect(resolved.value).toEqual(obj);
216
+ });
217
+ });
218
+
219
+ describe('| resolveAll', () => {
220
+
221
+ it('| should merge all configured keys with their resolved source level', async () => {
222
+ stubRecords([
223
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 }),
224
+ makeRecord({ level: DyNTS_ScopedConfig_Level.table, tableScope: 'documents', key: 'read.topK', value: 20 }),
225
+ makeRecord({ level: DyNTS_ScopedConfig_Level.global, key: 'read.minScore', value: 0.5 }),
226
+ makeRecord({ level: DyNTS_ScopedConfig_Level.scope, tableScope: 'documents', scopeId: 'leaf', key: 'read.maxResults', value: 99 }),
227
+ ]);
228
+
229
+ const all = await control.resolveAll({ table: 'documents', scopePath: [{ scopeId: 'leaf' }] });
230
+
231
+ // read.topK: table nyer a global felett.
232
+ expect(all['read.topK'].value).toBe(20);
233
+ expect(all['read.topK'].resolvedFrom).toBe('table');
234
+ // read.minScore: csak global.
235
+ expect(all['read.minScore'].value).toBe(0.5);
236
+ expect(all['read.minScore'].resolvedFrom).toBe('global');
237
+ // read.maxResults: scope (leaf).
238
+ expect(all['read.maxResults'].value).toBe(99);
239
+ expect(all['read.maxResults'].resolvedFrom).toBe('scope');
240
+ });
241
+
242
+ it('| should return empty object when no records configured', async () => {
243
+ stubRecords([]);
244
244
  const all = await control.resolveAll({ table: 'documents' });
245
-
246
- expect(Object.keys(all).length).toBe(0);
247
- });
248
- });
249
-
250
- describe('| set', () => {
251
-
252
- it('| should archive an existing active record then write the new one', async () => {
253
- const existing: DyNTS_ScopedConfig =
254
- makeRecord({ _id: 'old-id', level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 });
255
- const savedNew: DyNTS_ScopedConfig =
256
- makeRecord({ _id: 'new-id', level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 25 });
257
-
258
- const findActiveSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActive')
259
- .and.returnValue(Promise.resolve(existing));
260
- const deleteSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'deleteData')
261
- .and.returnValue(Promise.resolve());
262
- const saveSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'saveData')
263
- .and.returnValue(Promise.resolve(savedNew));
264
-
265
- const result: DyNTS_ScopedConfig =
266
- await control.set(DyNTS_ScopedConfig_Level.global, 'read.topK', 25, { setBy: 'cli' });
267
-
268
- expect(findActiveSpy).toHaveBeenCalled();
269
- expect(deleteSpy).toHaveBeenCalledWith('old-id');
270
- expect(saveSpy).toHaveBeenCalled();
271
- // A kiírt rekord a helyes kulcsot + értéket + audit-ot hordozza.
245
+
246
+ expect(Object.keys(all).length).toBe(0);
247
+ });
248
+ });
249
+
250
+ describe('| set', () => {
251
+
252
+ it('| should archive an existing active record then write the new one', async () => {
253
+ const existing: DyNTS_ScopedConfig =
254
+ makeRecord({ _id: 'old-id', level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 10 });
255
+ const savedNew: DyNTS_ScopedConfig =
256
+ makeRecord({ _id: 'new-id', level: DyNTS_ScopedConfig_Level.global, key: 'read.topK', value: 25 });
257
+
258
+ const findActiveSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActive')
259
+ .and.returnValue(Promise.resolve(existing));
260
+ const deleteSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'deleteData')
261
+ .and.returnValue(Promise.resolve());
262
+ const saveSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'saveData')
263
+ .and.returnValue(Promise.resolve(savedNew));
264
+
265
+ const result: DyNTS_ScopedConfig =
266
+ await control.set(DyNTS_ScopedConfig_Level.global, 'read.topK', 25, { setBy: 'cli' });
267
+
268
+ expect(findActiveSpy).toHaveBeenCalled();
269
+ expect(deleteSpy).toHaveBeenCalledWith('old-id');
270
+ expect(saveSpy).toHaveBeenCalled();
271
+ // A kiírt rekord a helyes kulcsot + értéket + audit-ot hordozza.
272
272
  const written: DyNTS_ScopedConfig = saveSpy.calls.mostRecent().args[0];
273
-
274
- expect(written.key).toBe('read.topK');
275
- expect(written.value).toBe(25);
276
- expect(written.setBy).toBe('cli');
277
- expect(result).toBe(savedNew);
278
- });
279
-
280
- it('| should write a new record without deleting when no active record exists', async () => {
281
- spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActive').and.returnValue(Promise.resolve(null));
273
+
274
+ expect(written.key).toBe('read.topK');
275
+ expect(written.value).toBe(25);
276
+ expect(written.setBy).toBe('cli');
277
+ expect(result).toBe(savedNew);
278
+ });
279
+
280
+ it('| should write a new record without deleting when no active record exists', async () => {
281
+ spyOn(DyNTS_ScopedConfig_DataService.prototype, 'findActive').and.returnValue(Promise.resolve(null));
282
282
  const deleteSpy = spyOn(DyNTS_ScopedConfig_DataService.prototype, 'deleteData').and.returnValue(Promise.resolve());
283
-
284
- spyOn(DyNTS_ScopedConfig_DataService.prototype, 'saveData')
285
- .and.callFake((data?: DyNTS_ScopedConfig) => Promise.resolve(data));
286
-
287
- const result: DyNTS_ScopedConfig = await control.set(
288
- DyNTS_ScopedConfig_Level.table,
289
- 'read.topK',
290
- 20,
291
- { tableScope: 'documents' },
292
- );
293
-
294
- expect(deleteSpy).not.toHaveBeenCalled();
295
- expect(result.value).toBe(20);
296
- expect(result.tableScope).toBe('documents');
297
- expect(result.setBy).toBe('system');
298
- });
299
-
300
- it('| should throw when table level set is missing tableScope', async () => {
301
- await expectAsync(
302
- control.set(DyNTS_ScopedConfig_Level.table, 'read.topK', 20, {}),
303
- ).toBeRejectedWithError(/tableScope/);
304
- });
305
-
306
- it('| should throw when scope level set is missing scopeId', async () => {
307
- await expectAsync(
308
- control.set(DyNTS_ScopedConfig_Level.scope, 'read.topK', 20, { tableScope: 'documents' }),
309
- ).toBeRejectedWithError(/scopeId/);
310
- });
311
- });
312
- });
283
+
284
+ spyOn(DyNTS_ScopedConfig_DataService.prototype, 'saveData')
285
+ .and.callFake((data?: DyNTS_ScopedConfig) => Promise.resolve(data));
286
+
287
+ const result: DyNTS_ScopedConfig = await control.set(
288
+ DyNTS_ScopedConfig_Level.table,
289
+ 'read.topK',
290
+ 20,
291
+ { tableScope: 'documents' },
292
+ );
293
+
294
+ expect(deleteSpy).not.toHaveBeenCalled();
295
+ expect(result.value).toBe(20);
296
+ expect(result.tableScope).toBe('documents');
297
+ expect(result.setBy).toBe('system');
298
+ });
299
+
300
+ it('| should throw when table level set is missing tableScope', async () => {
301
+ await expectAsync(
302
+ control.set(DyNTS_ScopedConfig_Level.table, 'read.topK', 20, {}),
303
+ ).toBeRejectedWithError(/tableScope/);
304
+ });
305
+
306
+ it('| should throw when scope level set is missing scopeId', async () => {
307
+ await expectAsync(
308
+ control.set(DyNTS_ScopedConfig_Level.scope, 'read.topK', 20, { tableScope: 'documents' }),
309
+ ).toBeRejectedWithError(/scopeId/);
310
+ });
311
+ });
312
+ });