@futdevpro/nts-dynamo 1.15.83 → 1.15.85

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 (357) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.vscode/settings.json +10 -10
  17. package/HOWTO.md +15 -15
  18. package/LICENSE +21 -21
  19. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  20. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  21. package/_specifications/BACKLOG.md +92 -92
  22. package/_specifications/TODO.md +15 -15
  23. package/_specifications/agent.md +138 -138
  24. package/eslint.config.js +3 -3
  25. package/nodemon.json +24 -24
  26. package/package.json +3 -3
  27. package/pnpm-workspace.yaml +5 -5
  28. package/scripts/run-coverage-tests.js +28 -28
  29. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  30. package/spec/support/helpers/ts-node-helper.js +93 -93
  31. package/spec/support/jasmine.coverage.json +24 -24
  32. package/spec/support/jasmine.json +24 -24
  33. package/src/_collections/archive.util.spec.ts +57 -57
  34. package/src/_collections/archive.util.ts +18 -18
  35. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  36. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  37. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  38. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  39. package/src/_collections/default-not-found-page.const.ts +22 -22
  40. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  41. package/src/_collections/default-socket-path.const.ts +2 -2
  42. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  43. package/src/_collections/get-environment-settings.util.ts +48 -48
  44. package/src/_collections/global-settings.const.ts +109 -109
  45. package/src/_collections/sample.env +21 -21
  46. package/src/_collections/star.controller.spec.ts +224 -224
  47. package/src/_collections/star.controller.ts +129 -129
  48. package/src/_enums/data-model-type.enum.ts +14 -14
  49. package/src/_enums/data-service-function.enum.ts +24 -24
  50. package/src/_enums/predefined-data-types.enum.ts +16 -16
  51. package/src/_enums/route-security.enum.ts +12 -12
  52. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  53. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  54. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  55. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  56. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  57. package/src/_models/control-models/app-params.control-model.ts +136 -136
  58. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  59. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  60. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  61. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  62. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  63. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  64. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  65. package/src/_models/control-models/system-control.control-model.ts +12 -12
  66. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  67. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  68. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  69. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  70. package/src/_models/interfaces/global-settings.interface.ts +235 -235
  71. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  72. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  73. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  74. package/src/_models/types/db-update.type.ts +100 -100
  75. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  76. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  77. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  78. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  79. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  80. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  81. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  82. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  83. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  84. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  85. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  86. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  87. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  88. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  89. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  90. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  91. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  92. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  93. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  94. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  95. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  96. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  97. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  98. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  99. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  100. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  101. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  102. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  103. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  104. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  105. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  106. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  107. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  108. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  109. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  110. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  111. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  112. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  114. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  115. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  116. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  117. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  118. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  119. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  120. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  121. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  122. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  123. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  124. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  125. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  126. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  127. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  128. package/src/_modules/ai/index.ts +23 -23
  129. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  130. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  131. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  132. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  133. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  134. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  135. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  136. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  137. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  138. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  139. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  140. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  141. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  142. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  143. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  144. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  145. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  146. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  147. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  148. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  149. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  150. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  151. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  152. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  153. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  154. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  155. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  156. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  157. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  158. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  159. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  160. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  161. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  162. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  163. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  164. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  165. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  166. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  167. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  168. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  169. package/src/_modules/custom-data/index.ts +9 -9
  170. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  171. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  172. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  173. package/src/_modules/data-readers/index.ts +11 -11
  174. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  175. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  176. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  177. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  178. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  179. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  180. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  181. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  182. package/src/_modules/defaults/index.ts +17 -17
  183. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  184. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  185. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  186. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  187. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  188. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  189. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  190. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  191. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  192. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  193. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  194. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  195. package/src/_modules/discord-assistant/index.ts +38 -38
  196. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  197. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  198. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  199. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  200. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  201. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  202. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  203. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  204. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  205. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  206. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  207. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  208. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  209. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  210. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  211. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  212. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  213. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  214. package/src/_modules/discord-bot/index.ts +36 -36
  215. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  216. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  217. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  218. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  219. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  220. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  221. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  222. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  223. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  224. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  225. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  226. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  227. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  228. package/src/_modules/local-vector-search/index.ts +16 -16
  229. package/src/_modules/logs/index.ts +11 -11
  230. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  231. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  232. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  233. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  234. package/src/_modules/mcp/index.ts +13 -13
  235. package/src/_modules/messaging/README.md +354 -354
  236. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  237. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  238. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  239. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  240. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  241. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  242. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  243. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  244. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  245. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  246. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  247. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  248. package/src/_modules/messaging/index.ts +30 -30
  249. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  250. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  251. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  252. package/src/_modules/mock/app-params.mock.ts +9 -9
  253. package/src/_modules/mock/app-server.mock.ts +188 -188
  254. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  255. package/src/_modules/mock/auth-service.mock.ts +28 -28
  256. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  257. package/src/_modules/mock/controller.mock.ts +16 -16
  258. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  259. package/src/_modules/mock/data-model.mock.ts +82 -82
  260. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  261. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  262. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  263. package/src/_modules/mock/email-service.mock.ts +20 -20
  264. package/src/_modules/mock/email-template.mock.html +14 -14
  265. package/src/_modules/mock/endpoint.mock.ts +91 -91
  266. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  267. package/src/_modules/mock/socket-client.mock.ts +45 -45
  268. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  269. package/src/_modules/mock/socket-server.mock.ts +46 -46
  270. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  271. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  272. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  273. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  274. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  275. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  276. package/src/_modules/oauth2/index.ts +17 -17
  277. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  278. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  279. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  280. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  281. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  282. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  283. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  284. package/src/_modules/scoped-config/index.ts +17 -17
  285. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  286. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  287. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  288. package/src/_modules/server/errors/errors.controller.ts +515 -515
  289. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  290. package/src/_modules/server/index.ts +30 -30
  291. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  292. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  293. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  294. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  295. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  296. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  297. package/src/_modules/server/server-status/server-status.controller.spec.ts +255 -255
  298. package/src/_modules/server/server-status/server-status.controller.ts +272 -272
  299. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  300. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  301. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  302. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  303. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  304. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  305. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  306. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  307. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  308. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  309. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  310. package/src/_modules/socket/app-extended.server.ts +630 -630
  311. package/src/_modules/socket/index.ts +42 -42
  312. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  313. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  314. package/src/_modules/test/index.ts +11 -11
  315. package/src/_modules/test/test.controller.spec.ts +72 -72
  316. package/src/_modules/test/test.controller.ts +115 -115
  317. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  318. package/src/_modules/usage/index.ts +15 -15
  319. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  320. package/src/_modules/usage/usage.controller.ts +126 -126
  321. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  322. package/src/_modules/usage/usage.data-service.ts +185 -185
  323. package/src/_services/base/api.service-base.spec.ts +125 -125
  324. package/src/_services/base/api.service-base.ts +74 -74
  325. package/src/_services/base/archive-data.service.spec.ts +209 -209
  326. package/src/_services/base/archive-data.service.ts +224 -224
  327. package/src/_services/base/data.service.spec.ts +729 -729
  328. package/src/_services/base/data.service.ts +2740 -2740
  329. package/src/_services/base/db.service.spec.ts +73 -73
  330. package/src/_services/base/db.service.ts +1575 -1575
  331. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  332. package/src/_services/base/singleton.service-base.ts +24 -24
  333. package/src/_services/base/singleton.service.spec.ts +114 -114
  334. package/src/_services/base/singleton.service.ts +38 -38
  335. package/src/_services/core/api.service.spec.ts +140 -140
  336. package/src/_services/core/auth.service.spec.ts +159 -159
  337. package/src/_services/core/auth.service.ts +174 -174
  338. package/src/_services/core/email.service.spec.ts +85 -85
  339. package/src/_services/core/email.service.ts +742 -742
  340. package/src/_services/core/global.service.spec.ts +292 -292
  341. package/src/_services/core/global.service.ts +487 -487
  342. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  343. package/src/_services/core/memory-guard.service.ts +481 -481
  344. package/src/_services/core/service-collection.service.spec.ts +46 -46
  345. package/src/_services/core/service-collection.service.ts +6 -6
  346. package/src/_services/route/controller.service.spec.ts +53 -53
  347. package/src/_services/route/controller.service.ts +148 -148
  348. package/src/_services/route/routing-module.service.spec.ts +98 -98
  349. package/src/_services/route/routing-module.service.ts +330 -330
  350. package/src/_services/server/app.server.ts +1905 -1905
  351. package/src/_services/shared.static-service.spec.ts +99 -99
  352. package/src/_services/shared.static-service.ts +78 -78
  353. package/src/index.ts +97 -97
  354. package/tsconfig.app.json +12 -12
  355. package/tsconfig.json +42 -42
  356. package/.dynamo/logs/cicd-pipeline/output.log +0 -2791
  357. package/.dynamo/logs/cicd-pipeline/status.json +0 -94
@@ -1,272 +1,272 @@
1
- import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
2
- import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
3
-
4
- /**
5
- * Vektor pool kezelő utility class
6
- * Instance-based class, amely in-memory vektor pool-t kezel és vektor hasonlósági számításokat végez
7
- * Minden instance saját vektor pool-t tart fenn
8
- */
9
- export class LVS_VectorPool_ControlService {
10
- /**
11
- * In-memory vektor pool tárolás
12
- * Key: vektor ID, Value: vektor értékek
13
- */
14
- private vectorPool: Map<string, number[]> = new Map<string, number[]>();
15
-
16
- /**
17
- * Normalizált vektor pool tárolás (L2 normalizált másolatok)
18
- * Key: vektor ID, Value: L2 normalizált vektor értékek
19
- */
20
- private normalizedVectorPool: Map<string, number[]> = new Map<string, number[]>();
21
-
22
- /**
23
- * `normalizedOnly` mód: ha `true`, a pool NEM tárolja a nyers vektorokat (`vectorPool`) — CSAK a
24
- * normalizált másolatot. A kizárólag-cosine fogyasztóknak (pl. RAG-keresés) ez ~50% memória-megtakarítás
25
- * (a két párhuzamos pool helyett egy). Ekkor az `l2Distance`-keresés és a `getAll()` nyers-érték-olvasása
26
- * N/A (a `size()` + a `cosineSimilarity`-keresés továbbra is helyes). Default `false` (visszafelé kompatibilis).
27
- */
28
- private readonly normalizedOnly: boolean;
29
-
30
- constructor(set?: { normalizedOnly?: boolean }) {
31
- this.normalizedOnly = set?.normalizedOnly ?? false;
32
- }
33
-
34
- /**
35
- * Hozzáad egy vektort a pool-hoz
36
- * Opcionálisan L2 normalizált másolatot is tárol
37
- */
38
- addVector(id: string, vector: number[]): void {
39
- if (!id) {
40
- throw new Error('Vector ID is required');
41
- }
42
-
43
- if (!Array.isArray(vector) || vector.length === 0) {
44
- throw new Error('Vector must be a non-empty array');
45
- }
46
-
47
- // Validáljuk, hogy a vektor számokból áll
48
- for (let i: number = 0; i < vector.length; i++) {
49
- if (typeof vector[i] !== 'number' || !isFinite(vector[i])) {
50
- throw new Error(`Vector must contain only finite numbers at index ${i}`);
51
- }
52
- }
53
-
54
- // Tároljuk az eredeti vektort — KIVÉVE normalizedOnly módban (akkor a nyers pool kihagyva, ~50% memória).
55
- if (!this.normalizedOnly) {
56
- this.vectorPool.set(id, vector);
57
- }
58
-
59
- // L2 normalizált másolatot is tárolunk a cosine similarity számításokhoz
60
- const normalized: number[] = LVS_VectorPool_ControlService.l2Normalize(vector);
61
- this.normalizedVectorPool.set(id, normalized);
62
- }
63
-
64
- /**
65
- * Eltávolít egy vektort a pool-ból
66
- */
67
- removeVector(id: string): void {
68
- this.vectorPool.delete(id);
69
- this.normalizedVectorPool.delete(id);
70
- }
71
-
72
- /**
73
- * Frissít egy vektort a pool-ban
74
- */
75
- updateVector(id: string, vector: number[]): void {
76
- // A `normalizedVectorPool` a forrás (mindkét módban populált; `normalizedOnly`-ban a `vectorPool` üres).
77
- if (!this.normalizedVectorPool.has(id)) {
78
- throw new Error(`Vector with ID "${id}" does not exist`);
79
- }
80
-
81
- this.addVector(id, vector);
82
- }
83
-
84
- /**
85
- * A pool elemszáma. Mindkét módban helyes (a `normalizedVectorPool` a forrás), így `normalizedOnly`
86
- * módban is — szemben a `getAll().size`-szal, ami ott üres (a nyers pool nincs tárolva).
87
- */
88
- size(): number {
89
- return this.normalizedVectorPool.size;
90
- }
91
-
92
- /**
93
- * Törli az összes vektort a pool-ból
94
- */
95
- clearPool(): void {
96
- this.vectorPool.clear();
97
- this.normalizedVectorPool.clear();
98
- }
99
-
100
- /**
101
- * Visszaadja az összes vektort a pool-ból
102
- * Debugging és export céljára
103
- */
104
- getAll(): Map<string, number[]> {
105
- return new Map<string, number[]>(this.vectorPool);
106
- }
107
-
108
- /**
109
- * L2 normalizálás egy vektorra
110
- * A vektor hosszát 1-re normalizálja
111
- * Statikus metódus, mivel nincs szüksége instance state-re
112
- */
113
- private static l2Normalize(vector: number[]): number[] {
114
- const magnitude: number = Math.sqrt(
115
- vector.reduce((sum: number, value: number) => sum + value * value, 0)
116
- );
117
-
118
- if (magnitude === 0) {
119
- // Ha a vektor nullvektor, akkor nullvektort adunk vissza
120
- return new Array<number>(vector.length).fill(0);
121
- }
122
-
123
- return vector.map((value: number) => value / magnitude);
124
- }
125
-
126
- /**
127
- * Cosine similarity számítás két vektor között
128
- * Normalizált vektorokat használ a számításhoz
129
- * Eredmény: 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
130
- * Statikus metódus, mivel nincs szüksége instance state-re
131
- */
132
- static cosineSimilarity(a: number[], b: number[]): number {
133
- if (a.length !== b.length) {
134
- throw new Error(
135
- `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
136
- );
137
- }
138
-
139
- // Normalizáljuk a vektorokat
140
- const normalizedA: number[] = this.l2Normalize(a);
141
- const normalizedB: number[] = this.l2Normalize(b);
142
-
143
- // Dot product számítása
144
- let dotProduct: number = 0;
145
- for (let i: number = 0; i < normalizedA.length; i++) {
146
- dotProduct += normalizedA[i] * normalizedB[i];
147
- }
148
-
149
- // Cosine similarity = dot product of normalized vectors
150
- // Mivel a vektorok normalizáltak, ez egyenlő a cosine similarity-vel
151
- return dotProduct;
152
- }
153
-
154
- /**
155
- * L2 distance (Euklideszi távolság) számítás két vektor között
156
- * Eredmény: 0 vagy pozitív érték, ahol 0 a legkisebb távolság
157
- * Statikus metódus, mivel nincs szüksége instance state-re
158
- */
159
- static l2Distance(a: number[], b: number[]): number {
160
- if (a.length !== b.length) {
161
- throw new Error(
162
- `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
163
- );
164
- }
165
-
166
- // L2 distance = sqrt(sum((a[i] - b[i])^2))
167
- let sumSquaredDiff: number = 0;
168
- for (let i: number = 0; i < a.length; i++) {
169
- const diff: number = a[i] - b[i];
170
- sumSquaredDiff += diff * diff;
171
- }
172
-
173
- return Math.sqrt(sumSquaredDiff);
174
- }
175
-
176
- /**
177
- * Vektor keresés a pool-ban
178
- * Brute-force megközelítés (lineáris keresés)
179
- *
180
- * @param query A keresési query vektor
181
- * @param k A visszaadandó találatok száma (top-K)
182
- * @param mode A keresési mód (cosine similarity vagy L2 distance)
183
- * @param candidateIds Opcionális jelölt-ID szűrő: ha meg van adva, a keresés CSAK az ebben a
184
- * halmazban lévő ID-kra fut (a többit `Set.has` O(1)-gyel kihagyja). Így a hívónak NEM kell külön
185
- * szűkített pool-t építenie + a vektorokat újra-normalizálnia — a keresés a MÁR előre-normalizált
186
- * `normalizedVectorPool`-on iterál allokáció-mentesen. Üres halmaz → üres eredmény.
187
- * @returns A top-K találatok ID-val és score-rel, megfelelő sorrendben
188
- */
189
- search(
190
- query: number[],
191
- k: number,
192
- mode: LVS_Search_Mode,
193
- candidateIds?: Set<string>
194
- ): LVS_SearchResult[] {
195
- // Üres jelölt-halmaz → nincs mit keresni (a `undefined` viszont „nincs szűrés" = teljes pool).
196
- if (candidateIds && candidateIds.size === 0) {
197
- return [];
198
- }
199
- if (!Array.isArray(query) || query.length === 0) {
200
- throw new Error('Query vector must be a non-empty array');
201
- }
202
-
203
- if (k <= 0) {
204
- throw new Error('k must be a positive number');
205
- }
206
-
207
- // `normalizedOnly` módban nincs nyers pool → l2Distance nem számolható (csak cosine).
208
- if (this.normalizedOnly && mode === LVS_Search_Mode.l2Distance) {
209
- throw new Error('l2Distance search is not available in normalizedOnly mode (raw vectors are not stored)');
210
- }
211
-
212
- // Üres pool → üres eredmény. A `normalizedVectorPool` a forrás (mindkét módban populált; a nyers
213
- // `vectorPool` `normalizedOnly`-ban üres, ezért NEM azon ellenőrzünk).
214
- if (this.normalizedVectorPool.size === 0) {
215
- return [];
216
- }
217
-
218
- // Validáljuk, hogy minden vektor ugyanolyan dimenziójú-e. A referencia-pool mód-függő: l2 a nyers,
219
- // cosine a normalizált (azonos dimenzió, de `normalizedOnly`-ban a nyers pool üres).
220
- const referencePool: Map<string, number[]> =
221
- mode === LVS_Search_Mode.l2Distance ? this.vectorPool : this.normalizedVectorPool;
222
- const firstVector: number[] | undefined = Array.from(referencePool.values())[0];
223
- if (firstVector && firstVector.length !== query.length) {
224
- throw new Error(
225
- `Query vector dimension (${query.length}) does not match pool vector ` +
226
- `dimension (${firstVector.length})`
227
- );
228
- }
229
-
230
- // Számoljuk ki a hasonlóságot/távolságot minden vektorra
231
- const results: LVS_SearchResult[] = [];
232
-
233
- if (mode === LVS_Search_Mode.cosineSimilarity) {
234
- // PERF (BFR-AM-013): a query-t EGYSZER normalizáljuk, majd dot-product a MÁR ELŐRE eltárolt
235
- // `normalizedVectorPool` (l2-normalizált) vektorok ellen. Eredmény AZONOS a régi
236
- // `cosineSimilarity(query, vector)`-ral (= dot(norm(q), norm(v))), de:
237
- // (1) NEM normalizáljuk újra MINDEN vektort MINDEN keresésnél (a normalizálás a `addVector`-ban
238
- // egyszer megtörtént) → ~3× kevesebb FLOP;
239
- // (2) a per-összehasonlítás dot-product ALLOKÁCIÓ-MENTES (a régi `l2Normalize` hívásonként KÉT új
240
- // tömböt allokált → egy 24k-vektoros keresés ~48k tömb-allokáció + GC-spike-ot okozott).
241
- // A drágán eltárolt `normalizedVectorPool` korábban SOHA nem volt használva a keresésben.
242
- const queryNormalized: number[] = LVS_VectorPool_ControlService.l2Normalize(query);
243
- for (const [id, normalizedVector] of this.normalizedVectorPool.entries()) {
244
- if (candidateIds && !candidateIds.has(id)) {
245
- continue;
246
- }
247
- let dotProduct: number = 0;
248
- for (let i: number = 0; i < queryNormalized.length; i++) {
249
- dotProduct += queryNormalized[i] * normalizedVector[i];
250
- }
251
- results.push({ id, score: dotProduct });
252
- }
253
- // Cosine similarity: csökkenő sorrend (legnagyobb hasonlóság először)
254
- results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => b.score - a.score);
255
- } else if (mode === LVS_Search_Mode.l2Distance) {
256
- for (const [id, vector] of this.vectorPool.entries()) {
257
- if (candidateIds && !candidateIds.has(id)) {
258
- continue;
259
- }
260
- results.push({ id, score: LVS_VectorPool_ControlService.l2Distance(query, vector) });
261
- }
262
- // L2 distance: növekvő sorrend (legkisebb távolság először)
263
- results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => a.score - b.score);
264
- } else {
265
- throw new Error(`Unknown search mode: ${mode}`);
266
- }
267
-
268
- // Visszaadjuk a top-K találatot
269
- return results.slice(0, k);
270
- }
271
- }
272
-
1
+ import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
2
+ import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
3
+
4
+ /**
5
+ * Vektor pool kezelő utility class
6
+ * Instance-based class, amely in-memory vektor pool-t kezel és vektor hasonlósági számításokat végez
7
+ * Minden instance saját vektor pool-t tart fenn
8
+ */
9
+ export class LVS_VectorPool_ControlService {
10
+ /**
11
+ * In-memory vektor pool tárolás
12
+ * Key: vektor ID, Value: vektor értékek
13
+ */
14
+ private vectorPool: Map<string, number[]> = new Map<string, number[]>();
15
+
16
+ /**
17
+ * Normalizált vektor pool tárolás (L2 normalizált másolatok)
18
+ * Key: vektor ID, Value: L2 normalizált vektor értékek
19
+ */
20
+ private normalizedVectorPool: Map<string, number[]> = new Map<string, number[]>();
21
+
22
+ /**
23
+ * `normalizedOnly` mód: ha `true`, a pool NEM tárolja a nyers vektorokat (`vectorPool`) — CSAK a
24
+ * normalizált másolatot. A kizárólag-cosine fogyasztóknak (pl. RAG-keresés) ez ~50% memória-megtakarítás
25
+ * (a két párhuzamos pool helyett egy). Ekkor az `l2Distance`-keresés és a `getAll()` nyers-érték-olvasása
26
+ * N/A (a `size()` + a `cosineSimilarity`-keresés továbbra is helyes). Default `false` (visszafelé kompatibilis).
27
+ */
28
+ private readonly normalizedOnly: boolean;
29
+
30
+ constructor(set?: { normalizedOnly?: boolean }) {
31
+ this.normalizedOnly = set?.normalizedOnly ?? false;
32
+ }
33
+
34
+ /**
35
+ * Hozzáad egy vektort a pool-hoz
36
+ * Opcionálisan L2 normalizált másolatot is tárol
37
+ */
38
+ addVector(id: string, vector: number[]): void {
39
+ if (!id) {
40
+ throw new Error('Vector ID is required');
41
+ }
42
+
43
+ if (!Array.isArray(vector) || vector.length === 0) {
44
+ throw new Error('Vector must be a non-empty array');
45
+ }
46
+
47
+ // Validáljuk, hogy a vektor számokból áll
48
+ for (let i: number = 0; i < vector.length; i++) {
49
+ if (typeof vector[i] !== 'number' || !isFinite(vector[i])) {
50
+ throw new Error(`Vector must contain only finite numbers at index ${i}`);
51
+ }
52
+ }
53
+
54
+ // Tároljuk az eredeti vektort — KIVÉVE normalizedOnly módban (akkor a nyers pool kihagyva, ~50% memória).
55
+ if (!this.normalizedOnly) {
56
+ this.vectorPool.set(id, vector);
57
+ }
58
+
59
+ // L2 normalizált másolatot is tárolunk a cosine similarity számításokhoz
60
+ const normalized: number[] = LVS_VectorPool_ControlService.l2Normalize(vector);
61
+ this.normalizedVectorPool.set(id, normalized);
62
+ }
63
+
64
+ /**
65
+ * Eltávolít egy vektort a pool-ból
66
+ */
67
+ removeVector(id: string): void {
68
+ this.vectorPool.delete(id);
69
+ this.normalizedVectorPool.delete(id);
70
+ }
71
+
72
+ /**
73
+ * Frissít egy vektort a pool-ban
74
+ */
75
+ updateVector(id: string, vector: number[]): void {
76
+ // A `normalizedVectorPool` a forrás (mindkét módban populált; `normalizedOnly`-ban a `vectorPool` üres).
77
+ if (!this.normalizedVectorPool.has(id)) {
78
+ throw new Error(`Vector with ID "${id}" does not exist`);
79
+ }
80
+
81
+ this.addVector(id, vector);
82
+ }
83
+
84
+ /**
85
+ * A pool elemszáma. Mindkét módban helyes (a `normalizedVectorPool` a forrás), így `normalizedOnly`
86
+ * módban is — szemben a `getAll().size`-szal, ami ott üres (a nyers pool nincs tárolva).
87
+ */
88
+ size(): number {
89
+ return this.normalizedVectorPool.size;
90
+ }
91
+
92
+ /**
93
+ * Törli az összes vektort a pool-ból
94
+ */
95
+ clearPool(): void {
96
+ this.vectorPool.clear();
97
+ this.normalizedVectorPool.clear();
98
+ }
99
+
100
+ /**
101
+ * Visszaadja az összes vektort a pool-ból
102
+ * Debugging és export céljára
103
+ */
104
+ getAll(): Map<string, number[]> {
105
+ return new Map<string, number[]>(this.vectorPool);
106
+ }
107
+
108
+ /**
109
+ * L2 normalizálás egy vektorra
110
+ * A vektor hosszát 1-re normalizálja
111
+ * Statikus metódus, mivel nincs szüksége instance state-re
112
+ */
113
+ private static l2Normalize(vector: number[]): number[] {
114
+ const magnitude: number = Math.sqrt(
115
+ vector.reduce((sum: number, value: number) => sum + value * value, 0)
116
+ );
117
+
118
+ if (magnitude === 0) {
119
+ // Ha a vektor nullvektor, akkor nullvektort adunk vissza
120
+ return new Array<number>(vector.length).fill(0);
121
+ }
122
+
123
+ return vector.map((value: number) => value / magnitude);
124
+ }
125
+
126
+ /**
127
+ * Cosine similarity számítás két vektor között
128
+ * Normalizált vektorokat használ a számításhoz
129
+ * Eredmény: 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
130
+ * Statikus metódus, mivel nincs szüksége instance state-re
131
+ */
132
+ static cosineSimilarity(a: number[], b: number[]): number {
133
+ if (a.length !== b.length) {
134
+ throw new Error(
135
+ `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
136
+ );
137
+ }
138
+
139
+ // Normalizáljuk a vektorokat
140
+ const normalizedA: number[] = this.l2Normalize(a);
141
+ const normalizedB: number[] = this.l2Normalize(b);
142
+
143
+ // Dot product számítása
144
+ let dotProduct: number = 0;
145
+ for (let i: number = 0; i < normalizedA.length; i++) {
146
+ dotProduct += normalizedA[i] * normalizedB[i];
147
+ }
148
+
149
+ // Cosine similarity = dot product of normalized vectors
150
+ // Mivel a vektorok normalizáltak, ez egyenlő a cosine similarity-vel
151
+ return dotProduct;
152
+ }
153
+
154
+ /**
155
+ * L2 distance (Euklideszi távolság) számítás két vektor között
156
+ * Eredmény: 0 vagy pozitív érték, ahol 0 a legkisebb távolság
157
+ * Statikus metódus, mivel nincs szüksége instance state-re
158
+ */
159
+ static l2Distance(a: number[], b: number[]): number {
160
+ if (a.length !== b.length) {
161
+ throw new Error(
162
+ `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
163
+ );
164
+ }
165
+
166
+ // L2 distance = sqrt(sum((a[i] - b[i])^2))
167
+ let sumSquaredDiff: number = 0;
168
+ for (let i: number = 0; i < a.length; i++) {
169
+ const diff: number = a[i] - b[i];
170
+ sumSquaredDiff += diff * diff;
171
+ }
172
+
173
+ return Math.sqrt(sumSquaredDiff);
174
+ }
175
+
176
+ /**
177
+ * Vektor keresés a pool-ban
178
+ * Brute-force megközelítés (lineáris keresés)
179
+ *
180
+ * @param query A keresési query vektor
181
+ * @param k A visszaadandó találatok száma (top-K)
182
+ * @param mode A keresési mód (cosine similarity vagy L2 distance)
183
+ * @param candidateIds Opcionális jelölt-ID szűrő: ha meg van adva, a keresés CSAK az ebben a
184
+ * halmazban lévő ID-kra fut (a többit `Set.has` O(1)-gyel kihagyja). Így a hívónak NEM kell külön
185
+ * szűkített pool-t építenie + a vektorokat újra-normalizálnia — a keresés a MÁR előre-normalizált
186
+ * `normalizedVectorPool`-on iterál allokáció-mentesen. Üres halmaz → üres eredmény.
187
+ * @returns A top-K találatok ID-val és score-rel, megfelelő sorrendben
188
+ */
189
+ search(
190
+ query: number[],
191
+ k: number,
192
+ mode: LVS_Search_Mode,
193
+ candidateIds?: Set<string>
194
+ ): LVS_SearchResult[] {
195
+ // Üres jelölt-halmaz → nincs mit keresni (a `undefined` viszont „nincs szűrés" = teljes pool).
196
+ if (candidateIds && candidateIds.size === 0) {
197
+ return [];
198
+ }
199
+ if (!Array.isArray(query) || query.length === 0) {
200
+ throw new Error('Query vector must be a non-empty array');
201
+ }
202
+
203
+ if (k <= 0) {
204
+ throw new Error('k must be a positive number');
205
+ }
206
+
207
+ // `normalizedOnly` módban nincs nyers pool → l2Distance nem számolható (csak cosine).
208
+ if (this.normalizedOnly && mode === LVS_Search_Mode.l2Distance) {
209
+ throw new Error('l2Distance search is not available in normalizedOnly mode (raw vectors are not stored)');
210
+ }
211
+
212
+ // Üres pool → üres eredmény. A `normalizedVectorPool` a forrás (mindkét módban populált; a nyers
213
+ // `vectorPool` `normalizedOnly`-ban üres, ezért NEM azon ellenőrzünk).
214
+ if (this.normalizedVectorPool.size === 0) {
215
+ return [];
216
+ }
217
+
218
+ // Validáljuk, hogy minden vektor ugyanolyan dimenziójú-e. A referencia-pool mód-függő: l2 a nyers,
219
+ // cosine a normalizált (azonos dimenzió, de `normalizedOnly`-ban a nyers pool üres).
220
+ const referencePool: Map<string, number[]> =
221
+ mode === LVS_Search_Mode.l2Distance ? this.vectorPool : this.normalizedVectorPool;
222
+ const firstVector: number[] | undefined = Array.from(referencePool.values())[0];
223
+ if (firstVector && firstVector.length !== query.length) {
224
+ throw new Error(
225
+ `Query vector dimension (${query.length}) does not match pool vector ` +
226
+ `dimension (${firstVector.length})`
227
+ );
228
+ }
229
+
230
+ // Számoljuk ki a hasonlóságot/távolságot minden vektorra
231
+ const results: LVS_SearchResult[] = [];
232
+
233
+ if (mode === LVS_Search_Mode.cosineSimilarity) {
234
+ // PERF (BFR-AM-013): a query-t EGYSZER normalizáljuk, majd dot-product a MÁR ELŐRE eltárolt
235
+ // `normalizedVectorPool` (l2-normalizált) vektorok ellen. Eredmény AZONOS a régi
236
+ // `cosineSimilarity(query, vector)`-ral (= dot(norm(q), norm(v))), de:
237
+ // (1) NEM normalizáljuk újra MINDEN vektort MINDEN keresésnél (a normalizálás a `addVector`-ban
238
+ // egyszer megtörtént) → ~3× kevesebb FLOP;
239
+ // (2) a per-összehasonlítás dot-product ALLOKÁCIÓ-MENTES (a régi `l2Normalize` hívásonként KÉT új
240
+ // tömböt allokált → egy 24k-vektoros keresés ~48k tömb-allokáció + GC-spike-ot okozott).
241
+ // A drágán eltárolt `normalizedVectorPool` korábban SOHA nem volt használva a keresésben.
242
+ const queryNormalized: number[] = LVS_VectorPool_ControlService.l2Normalize(query);
243
+ for (const [id, normalizedVector] of this.normalizedVectorPool.entries()) {
244
+ if (candidateIds && !candidateIds.has(id)) {
245
+ continue;
246
+ }
247
+ let dotProduct: number = 0;
248
+ for (let i: number = 0; i < queryNormalized.length; i++) {
249
+ dotProduct += queryNormalized[i] * normalizedVector[i];
250
+ }
251
+ results.push({ id, score: dotProduct });
252
+ }
253
+ // Cosine similarity: csökkenő sorrend (legnagyobb hasonlóság először)
254
+ results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => b.score - a.score);
255
+ } else if (mode === LVS_Search_Mode.l2Distance) {
256
+ for (const [id, vector] of this.vectorPool.entries()) {
257
+ if (candidateIds && !candidateIds.has(id)) {
258
+ continue;
259
+ }
260
+ results.push({ id, score: LVS_VectorPool_ControlService.l2Distance(query, vector) });
261
+ }
262
+ // L2 distance: növekvő sorrend (legkisebb távolság először)
263
+ results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => a.score - b.score);
264
+ } else {
265
+ throw new Error(`Unknown search mode: ${mode}`);
266
+ }
267
+
268
+ // Visszaadjuk a top-K találatot
269
+ return results.slice(0, k);
270
+ }
271
+ }
272
+
@@ -1,17 +1,17 @@
1
-
2
-
3
- // ENUMS
4
- export * from './_enums/lvs-search-mode.enum';
5
-
6
- // INTERFACES
7
- export * from './_models/lvs-search-result.interface';
8
-
9
- // DATA MODELS
10
- export * from './_models/data-models/lvs-vector-persist.data-model';
11
-
12
- // SERVICES
13
- export * from './_services/lvs-doc-chunk-data.service';
14
- export * from './_services/lvs-local-vector-search.data-service';
15
- export * from './_services/lvs-vector-pool.control-service';
16
- export * from './_services/lvs-vector-persist.data-service';
1
+
2
+
3
+ // ENUMS
4
+ export * from './_enums/lvs-search-mode.enum';
5
+
6
+ // INTERFACES
7
+ export * from './_models/lvs-search-result.interface';
8
+
9
+ // DATA MODELS
10
+ export * from './_models/data-models/lvs-vector-persist.data-model';
11
+
12
+ // SERVICES
13
+ export * from './_services/lvs-doc-chunk-data.service';
14
+ export * from './_services/lvs-local-vector-search.data-service';
15
+ export * from './_services/lvs-vector-pool.control-service';
16
+ export * from './_services/lvs-vector-persist.data-service';
17
17
  export * from './_services/lvs-persistent-vector-pool.control-service';
@@ -1,11 +1,11 @@
1
- export { DyNTS_Logs_Service } from './logs.service';
2
- export { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
3
- export { DyNTS_getLogsRoutingModule } from './get-logs-routing-module.util';
4
- export { DyNTS_FileLog_Service } from './file-log.service';
5
- export { DyNTS_FileLogs_Controller, DyNTS_FileLogsController_Config } from './file-logs.controller';
6
- export {
7
- DyNTS_getFileLogsRoutingModule,
8
- DyNTS_FileLogsRoutingModule_Config,
9
- } from './get-file-logs-routing-module.util';
10
- export { DyNTS_FileLog_Entry } from './_models/file-log-entry.interface';
11
- export { DyNTS_FileLog_ReadResult, DyNTS_FileLog_ReadOptions } from './_models/file-log-read-result.interface';
1
+ export { DyNTS_Logs_Service } from './logs.service';
2
+ export { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
3
+ export { DyNTS_getLogsRoutingModule } from './get-logs-routing-module.util';
4
+ export { DyNTS_FileLog_Service } from './file-log.service';
5
+ export { DyNTS_FileLogs_Controller, DyNTS_FileLogsController_Config } from './file-logs.controller';
6
+ export {
7
+ DyNTS_getFileLogsRoutingModule,
8
+ DyNTS_FileLogsRoutingModule_Config,
9
+ } from './get-file-logs-routing-module.util';
10
+ export { DyNTS_FileLog_Entry } from './_models/file-log-entry.interface';
11
+ export { DyNTS_FileLog_ReadResult, DyNTS_FileLog_ReadOptions } from './_models/file-log-read-result.interface';