@futdevpro/nts-dynamo 1.15.83 → 1.15.84

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