@futdevpro/nts-dynamo 1.15.89 → 1.15.90

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