@futdevpro/nts-dynamo 1.15.85 → 1.15.86

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