@futdevpro/nts-dynamo 1.15.56 → 1.15.58

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 (450) 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 +2844 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +94 -0
  18. package/.github/workflows/main.yml +432 -432
  19. package/.vscode/settings.json +10 -10
  20. package/HOWTO.md +15 -15
  21. package/LICENSE +21 -21
  22. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  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/ai/_modules/document-ai/_collections/dai-code-chunking.util.d.ts +110 -0
  27. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.d.ts.map +1 -0
  28. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.js +419 -0
  29. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.js.map +1 -0
  30. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.d.ts +50 -0
  31. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.d.ts.map +1 -0
  32. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.js +3 -0
  33. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.js.map +1 -0
  34. package/build/_modules/ai/_modules/document-ai/index.d.ts +2 -0
  35. package/build/_modules/ai/_modules/document-ai/index.d.ts.map +1 -1
  36. package/build/_modules/ai/_modules/document-ai/index.js +2 -0
  37. package/build/_modules/ai/_modules/document-ai/index.js.map +1 -1
  38. package/build/_modules/ai/_services/ai-embedding-mock.service.d.ts +81 -0
  39. package/build/_modules/ai/_services/ai-embedding-mock.service.d.ts.map +1 -0
  40. package/build/_modules/ai/_services/ai-embedding-mock.service.js +167 -0
  41. package/build/_modules/ai/_services/ai-embedding-mock.service.js.map +1 -0
  42. package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts +52 -0
  43. package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts.map +1 -0
  44. package/build/_modules/ai/_services/ai-embedding-provider.registry.js +79 -0
  45. package/build/_modules/ai/_services/ai-embedding-provider.registry.js.map +1 -0
  46. package/build/_modules/ai/_services/lmstudio-embedding.control-service.d.ts +111 -0
  47. package/build/_modules/ai/_services/lmstudio-embedding.control-service.d.ts.map +1 -0
  48. package/build/_modules/ai/_services/lmstudio-embedding.control-service.js +298 -0
  49. package/build/_modules/ai/_services/lmstudio-embedding.control-service.js.map +1 -0
  50. package/build/_modules/ai/index.d.ts +3 -0
  51. package/build/_modules/ai/index.d.ts.map +1 -1
  52. package/build/_modules/ai/index.js +4 -0
  53. package/build/_modules/ai/index.js.map +1 -1
  54. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.d.ts +59 -0
  55. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.d.ts.map +1 -0
  56. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.js +169 -0
  57. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.js.map +1 -0
  58. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.d.ts +32 -0
  59. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.d.ts.map +1 -0
  60. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js +8 -0
  61. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js.map +1 -0
  62. package/build/_modules/data-readers/index.d.ts +3 -0
  63. package/build/_modules/data-readers/index.d.ts.map +1 -0
  64. package/build/_modules/data-readers/index.js +11 -0
  65. package/build/_modules/data-readers/index.js.map +1 -0
  66. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts +36 -0
  67. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts.map +1 -0
  68. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js +54 -0
  69. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js.map +1 -0
  70. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts +70 -0
  71. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts.map +1 -0
  72. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js +123 -0
  73. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js.map +1 -0
  74. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts +43 -0
  75. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts.map +1 -0
  76. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js +72 -0
  77. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js.map +1 -0
  78. package/build/_modules/local-vector-search/index.d.ts +3 -0
  79. package/build/_modules/local-vector-search/index.d.ts.map +1 -1
  80. package/build/_modules/local-vector-search/index.js +4 -0
  81. package/build/_modules/local-vector-search/index.js.map +1 -1
  82. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts +109 -0
  83. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts.map +1 -0
  84. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js +14 -0
  85. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js.map +1 -0
  86. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts +71 -0
  87. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts.map +1 -0
  88. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js +99 -0
  89. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js.map +1 -0
  90. package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts +57 -0
  91. package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts.map +1 -0
  92. package/build/_modules/mcp/_services/dynts-mcp.adapter.js +134 -0
  93. package/build/_modules/mcp/_services/dynts-mcp.adapter.js.map +1 -0
  94. package/build/_modules/mcp/index.d.ts +4 -0
  95. package/build/_modules/mcp/index.d.ts.map +1 -0
  96. package/build/_modules/mcp/index.js +13 -0
  97. package/build/_modules/mcp/index.js.map +1 -0
  98. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts +19 -0
  99. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts.map +1 -0
  100. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js +23 -0
  101. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js.map +1 -0
  102. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts +44 -0
  103. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts.map +1 -0
  104. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js +68 -0
  105. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js.map +1 -0
  106. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts +89 -0
  107. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts.map +1 -0
  108. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js +3 -0
  109. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js.map +1 -0
  110. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.d.ts +84 -0
  111. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.d.ts.map +1 -0
  112. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.js +220 -0
  113. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.js.map +1 -0
  114. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.d.ts +54 -0
  115. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.d.ts.map +1 -0
  116. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.js +76 -0
  117. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.js.map +1 -0
  118. package/build/_modules/scoped-config/index.d.ts +6 -0
  119. package/build/_modules/scoped-config/index.d.ts.map +1 -0
  120. package/build/_modules/scoped-config/index.js +15 -0
  121. package/build/_modules/scoped-config/index.js.map +1 -0
  122. package/eslint.config.js +3 -3
  123. package/nodemon.json +24 -24
  124. package/package.json +58 -2
  125. package/pnpm-workspace.yaml +5 -4
  126. package/scripts/run-coverage-tests.js +28 -28
  127. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  128. package/spec/support/helpers/ts-node-helper.js +93 -93
  129. package/spec/support/jasmine.coverage.json +24 -24
  130. package/spec/support/jasmine.json +24 -24
  131. package/src/_collections/archive.util.spec.ts +57 -57
  132. package/src/_collections/archive.util.ts +18 -18
  133. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  134. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  135. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  136. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  137. package/src/_collections/default-not-found-page.const.ts +22 -22
  138. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  139. package/src/_collections/default-socket-path.const.ts +2 -2
  140. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  141. package/src/_collections/get-environment-settings.util.ts +48 -48
  142. package/src/_collections/global-settings.const.ts +82 -82
  143. package/src/_collections/sample.env +21 -21
  144. package/src/_collections/star.controller.spec.ts +224 -224
  145. package/src/_collections/star.controller.ts +129 -129
  146. package/src/_enums/data-model-type.enum.ts +14 -14
  147. package/src/_enums/data-service-function.enum.ts +24 -24
  148. package/src/_enums/predefined-data-types.enum.ts +16 -16
  149. package/src/_enums/route-security.enum.ts +12 -12
  150. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  151. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  152. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  153. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  154. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  155. package/src/_models/control-models/app-params.control-model.ts +136 -136
  156. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  157. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  158. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  159. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  160. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  161. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  162. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  163. package/src/_models/control-models/system-control.control-model.ts +12 -12
  164. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  165. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  166. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  167. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  168. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  169. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  170. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  171. package/src/_models/types/db-update.type.ts +100 -100
  172. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  173. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  174. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  175. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  176. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  177. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  178. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -0
  179. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +520 -0
  180. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  181. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  182. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  183. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  184. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  185. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  186. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -0
  187. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  188. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  189. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  190. package/src/_modules/ai/_modules/document-ai/index.ts +30 -28
  191. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  192. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  193. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  194. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  195. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  196. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  197. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  198. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  199. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  200. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  201. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  202. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  203. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  204. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  205. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  206. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  207. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  208. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  209. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  210. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  211. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -0
  212. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +219 -0
  213. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -0
  214. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -0
  215. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  216. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  217. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  218. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  219. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  220. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  221. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  222. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  223. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -0
  224. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +378 -0
  225. package/src/_modules/ai/index.ts +18 -13
  226. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  227. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  228. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  229. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  230. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  231. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  232. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  233. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  234. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  235. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  236. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  237. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  238. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  239. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  240. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  241. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  242. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  243. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  244. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  245. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  246. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  247. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  248. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  249. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  250. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  251. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  252. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  253. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  254. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  255. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  256. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  257. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  258. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  259. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  260. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  261. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  262. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  263. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  264. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  265. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  266. package/src/_modules/custom-data/index.ts +9 -9
  267. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -0
  268. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +192 -0
  269. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -0
  270. package/src/_modules/data-readers/index.ts +11 -0
  271. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  272. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  273. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  274. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  275. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  276. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  277. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  278. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  279. package/src/_modules/defaults/index.ts +17 -17
  280. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  281. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  282. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  283. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  284. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  285. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  286. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  287. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  288. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  289. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  290. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  291. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  292. package/src/_modules/discord-assistant/index.ts +38 -38
  293. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  294. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  295. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  296. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  297. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  298. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  299. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  300. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  301. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  302. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  303. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  304. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  305. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  306. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  307. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  308. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  309. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  310. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  311. package/src/_modules/discord-bot/index.ts +36 -36
  312. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  313. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -0
  314. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  315. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  316. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  317. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  318. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  319. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -0
  320. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -0
  321. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -0
  322. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -0
  323. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  324. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  325. package/src/_modules/local-vector-search/index.ts +17 -12
  326. package/src/_modules/logs/index.ts +11 -11
  327. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -0
  328. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -0
  329. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -0
  330. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +157 -0
  331. package/src/_modules/mcp/index.ts +13 -0
  332. package/src/_modules/messaging/README.md +354 -354
  333. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  334. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  335. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  336. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  337. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  338. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  339. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  340. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  341. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  342. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  343. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  344. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  345. package/src/_modules/messaging/index.ts +30 -30
  346. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  347. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  348. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  349. package/src/_modules/mock/app-params.mock.ts +9 -9
  350. package/src/_modules/mock/app-server.mock.ts +188 -188
  351. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  352. package/src/_modules/mock/auth-service.mock.ts +28 -28
  353. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  354. package/src/_modules/mock/controller.mock.ts +16 -16
  355. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  356. package/src/_modules/mock/data-model.mock.ts +82 -82
  357. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  358. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  359. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  360. package/src/_modules/mock/email-service.mock.ts +20 -20
  361. package/src/_modules/mock/email-template.mock.html +14 -14
  362. package/src/_modules/mock/endpoint.mock.ts +91 -91
  363. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  364. package/src/_modules/mock/socket-client.mock.ts +45 -45
  365. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  366. package/src/_modules/mock/socket-server.mock.ts +46 -46
  367. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  368. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  369. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  370. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  371. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  372. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  373. package/src/_modules/oauth2/index.ts +17 -17
  374. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -0
  375. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -0
  376. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +109 -0
  377. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -0
  378. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -0
  379. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -0
  380. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -0
  381. package/src/_modules/scoped-config/index.ts +17 -0
  382. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  383. package/src/_modules/server/errors/errors.control-service.ts +85 -85
  384. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  385. package/src/_modules/server/errors/errors.controller.ts +431 -431
  386. package/src/_modules/server/errors/errors.data-service.spec.ts +361 -361
  387. package/src/_modules/server/index.ts +30 -30
  388. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  389. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  390. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  391. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  392. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  393. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  394. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
  395. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  396. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  397. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  398. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  399. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  400. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  401. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  402. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  403. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  404. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  405. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  406. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  407. package/src/_modules/socket/app-extended.server.ts +630 -630
  408. package/src/_modules/socket/index.ts +42 -42
  409. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  410. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  411. package/src/_modules/test/index.ts +11 -11
  412. package/src/_modules/test/test.controller.spec.ts +72 -72
  413. package/src/_modules/test/test.controller.ts +115 -115
  414. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  415. package/src/_modules/usage/index.ts +15 -15
  416. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  417. package/src/_modules/usage/usage.controller.ts +126 -126
  418. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  419. package/src/_modules/usage/usage.data-service.ts +185 -185
  420. package/src/_services/base/api.service-base.spec.ts +125 -125
  421. package/src/_services/base/api.service-base.ts +74 -74
  422. package/src/_services/base/archive-data.service.spec.ts +196 -196
  423. package/src/_services/base/archive-data.service.ts +216 -216
  424. package/src/_services/base/data.service.spec.ts +674 -674
  425. package/src/_services/base/data.service.ts +2719 -2719
  426. package/src/_services/base/db.service.spec.ts +73 -73
  427. package/src/_services/base/db.service.ts +1575 -1575
  428. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  429. package/src/_services/base/singleton.service-base.ts +24 -24
  430. package/src/_services/base/singleton.service.spec.ts +114 -114
  431. package/src/_services/base/singleton.service.ts +38 -38
  432. package/src/_services/core/api.service.spec.ts +140 -140
  433. package/src/_services/core/auth.service.spec.ts +159 -159
  434. package/src/_services/core/auth.service.ts +174 -174
  435. package/src/_services/core/email.service.spec.ts +85 -85
  436. package/src/_services/core/email.service.ts +742 -742
  437. package/src/_services/core/global.service.spec.ts +275 -275
  438. package/src/_services/core/global.service.ts +461 -461
  439. package/src/_services/core/service-collection.service.spec.ts +46 -46
  440. package/src/_services/core/service-collection.service.ts +6 -6
  441. package/src/_services/route/controller.service.spec.ts +53 -53
  442. package/src/_services/route/controller.service.ts +148 -148
  443. package/src/_services/route/routing-module.service.spec.ts +98 -98
  444. package/src/_services/route/routing-module.service.ts +330 -330
  445. package/src/_services/server/app.server.ts +1726 -1726
  446. package/src/_services/shared.static-service.spec.ts +99 -99
  447. package/src/_services/shared.static-service.ts +78 -78
  448. package/src/index.ts +96 -96
  449. package/tsconfig.app.json +12 -12
  450. package/tsconfig.json +42 -42
@@ -0,0 +1,419 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DyNTS_DAI_CodeChunking_Util = void 0;
4
+ const tslib_1 = require("tslib");
5
+ const ts = tslib_1.__importStar(require("typescript"));
6
+ const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
7
+ /**
8
+ * `DyNTS_DAI_CodeChunking_Util` (BFR-AM-005) — **AST-pontos** TypeScript/JavaScript kód-chunker
9
+ * a TypeScript Compiler API-val (`ts.createSourceFile`). A FAM `FAM_TsChunker_Util` regex/brace-depth
10
+ * workaround-jának **bedrock-szintű, durable** változata: a `{`/`}` számolás helyett a valódi
11
+ * szintaxisfát járja be, így string-literálban / template-literálban / comment-ben lévő zárójelek
12
+ * NEM tévesztik meg.
13
+ *
14
+ * **Chunkolási stratégia (top-level node-onként, egy chunk per szemantikus egység):**
15
+ * - **import-group** — az összes egymást követő top-level `import` / `export ... from` egy chunkba
16
+ * (a köztük lévő üres sorokkal együtt).
17
+ * - **class** — ha belefér a `maxChunkSize`-ba, az egész osztály egy chunk (dekorátorok + JSDoc-cal);
18
+ * ha NEM fér bele, **metódusonként** bomlik (osztály-fej + minden metódus külön chunk, a
19
+ * `class:Foo > method:bar` symbol-lánccal).
20
+ * - **interface / enum / type-alias / standalone function / top-level const(=>fn/value)** — egy chunk
21
+ * per deklaráció.
22
+ * - **nagy node** (a fentiek közül bármelyik, ami a metódus-bontás UTÁN is `maxChunkSize` fölötti) →
23
+ * karakter-alapú **sliding-window** sub-split (örökölt `chunkType` + symbol-lánc, `subChunkIndex`-szel).
24
+ * - **tiny / parse-degenerált tartalom** → egyetlen `fallback` chunk (a teljes forrás), hogy soha
25
+ * ne vesszen el tartalom.
26
+ *
27
+ * A JSDoc + `@Decorator` MINDIG a következő node-dal együtt marad (a `node.getStart(sf, true)` a
28
+ * leading-JSDoc elejétől indul, a `ts.getDecorators` a node része).
29
+ *
30
+ * **headingPath = kód-symbol-lánc** (a markdown-chunker heading-láncának kód-megfelelője):
31
+ * `symbolPath` = a szegmensek ` > `-rel összefűzve.
32
+ */
33
+ class DyNTS_DAI_CodeChunking_Util {
34
+ /** A FAM/CCAP-egyeztetett default méret-konstansok. */
35
+ static DEFAULT_MAX_CHUNK_SIZE = 1500;
36
+ static DEFAULT_OVERLAP = 100;
37
+ static DEFAULT_MIN_CHUNK_SIZE = 50;
38
+ /**
39
+ * Egy TS/JS forrás chunkolása szemantikus blokkok mentén a TS Compiler API AST-jával.
40
+ * Üres / whitespace-only tartalom → üres lista. A `maxChunkSize` fölötti node-ok sliding-window-ra
41
+ * bomlanak; a degenerált (parse-hiba / 0 blokk) esetet egyetlen `fallback` chunk fedi.
42
+ *
43
+ * @param code - A forráskód.
44
+ * @param opts - Méret-paraméterek (default 1500/100/50).
45
+ * @returns A szemantikus kód-chunkok listája (0-alapú `chunkIndex`-szel).
46
+ */
47
+ static chunkTs(code, opts) {
48
+ if (!code || !code.trim()) {
49
+ return [];
50
+ }
51
+ const sizing = this.resolveSizing(opts);
52
+ let blocks = [];
53
+ try {
54
+ const sourceFile = ts.createSourceFile('chunk-input.ts', code, ts.ScriptTarget.Latest,
55
+ /* setParentNodes */ true, ts.ScriptKind.TSX);
56
+ blocks = this.identifyBlocks(sourceFile, code, sizing);
57
+ }
58
+ catch (error) {
59
+ // Parse-hiba (degenerált forrás) → a tiny-fallback veszi át lentebb.
60
+ fsm_dynamo_1.DyFM_Log.warn('DyNTS_DAI_CodeChunking_Util.chunkTs: AST parse failed, using fallback chunk', {
61
+ error: error?.message,
62
+ });
63
+ blocks = [];
64
+ }
65
+ // Tiny / degenerált esetek: ha nincs azonosított blokk, vagy a teljes forrás kicsi → egyetlen
66
+ // fallback chunk (soha ne vesszen el tartalom).
67
+ if (!blocks.length) {
68
+ return this.buildFallbackChunks(code, sizing);
69
+ }
70
+ // A sor-pozíciókhoz a teljes forrás sortörés-offszetjei (egyszer számolva).
71
+ const lineStartOffsets = this.computeLineStartOffsets(code);
72
+ const chunks = [];
73
+ for (const block of blocks) {
74
+ // Zaj-szűrés: CSAK a névtelen `generic` blokkokat dobjuk a minChunkSize alatt. A nevesített
75
+ // szemantikus deklarációk (type-alias / rövid function / class-fej / metódus / interface /
76
+ // enum / variable) MINDIG saját chunkot kapnak, méretüktől függetlenül — egy `type Id = string`
77
+ // teljes értékű egység. Az import-csoport sosem esik ki.
78
+ if (block.chunkType === 'generic' && block.text.trim().length < sizing.minChunkSize) {
79
+ continue;
80
+ }
81
+ if (block.text.length <= sizing.maxChunkSize) {
82
+ chunks.push(this.blockToChunk(block, chunks.length, lineStartOffsets));
83
+ continue;
84
+ }
85
+ // Túl nagy node → karakter-alapú sliding-window sub-split (örökölt symbol-lánc + chunkType).
86
+ this.splitLargeBlock(block, sizing, chunks, lineStartOffsets);
87
+ }
88
+ // Ha minden blokk kiesett a minChunkSize-szűrőn (pl. sok apró egysoros), essünk vissza a
89
+ // fallback-re, hogy ne adjunk vissza üres listát nem-üres bemenetre.
90
+ if (!chunks.length) {
91
+ return this.buildFallbackChunks(code, sizing);
92
+ }
93
+ return chunks;
94
+ }
95
+ /**
96
+ * Dispatcher: a `filename` kiterjesztése alapján a `.ts/.tsx/.js/.jsx/.mts/.cts/.mjs/.cjs`
97
+ * forrásokat az AST-chunkerre (`chunkTs`), minden mást (pl. `.md`) az adott formátum nyers
98
+ * sliding-fallback-jére irányít. A markdown-specifikus chunkolás a `DyNTS_DAI_DocChunking_Util`
99
+ * felelőssége (page-modell + parent-hierarchia kell hozzá), ezért azt itt NEM hívjuk —
100
+ * additív marad. Nem-kód input → `fallback` chunk a tartalom megőrzéséhez.
101
+ *
102
+ * @param content - A fájl tartalma.
103
+ * @param filename - A fájlnév (a kiterjesztés-alapú routinghoz).
104
+ * @param opts - Méret-paraméterek.
105
+ */
106
+ static chunk(content, filename, opts) {
107
+ if (this.isTsLike(filename)) {
108
+ return this.chunkTs(content, opts);
109
+ }
110
+ // Nem-kód (pl. .md / .txt / ismeretlen): nyers fallback chunkok — a tartalmat megőrizzük,
111
+ // de NEM próbáljuk szemantikusan darabolni (a markdown-darabolás külön util-é).
112
+ if (!content || !content.trim()) {
113
+ return [];
114
+ }
115
+ return this.buildFallbackChunks(content, this.resolveSizing(opts));
116
+ }
117
+ /** `true`, ha a fájlnév TS/JS-szerű (a `chunkTs` AST-parsere tudja kezelni). */
118
+ static isTsLike(filename) {
119
+ return /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/i.test(filename || '');
120
+ }
121
+ /** A default-ok feloldása (1500/100/50) + sanity-clamp. */
122
+ static resolveSizing(opts) {
123
+ const maxChunkSize = Math.max(1, opts?.maxChunkSize ?? this.DEFAULT_MAX_CHUNK_SIZE);
124
+ const overlap = Math.max(0, Math.min(opts?.overlap ?? this.DEFAULT_OVERLAP, maxChunkSize - 1));
125
+ const minChunkSize = Math.max(0, opts?.minChunkSize ?? this.DEFAULT_MIN_CHUNK_SIZE);
126
+ return { maxChunkSize: maxChunkSize, overlap: overlap, minChunkSize: minChunkSize };
127
+ }
128
+ /**
129
+ * AST-bejárás: a `SourceFile` top-level statement-jeit szemantikus blokkokká alakítja. Az
130
+ * egymást követő import-okat egy `imports` blokkba vonja össze. A `maxChunkSize` fölötti
131
+ * osztályt metódusonként bontja.
132
+ */
133
+ static identifyBlocks(sourceFile, code, sizing) {
134
+ const blocks = [];
135
+ // -- Import-csoport összevonás --
136
+ let importStart = -1;
137
+ let importEnd = -1;
138
+ const flushImports = () => {
139
+ if (importStart < 0) {
140
+ return;
141
+ }
142
+ const text = code.substring(importStart, importEnd);
143
+ if (text.trim().length) {
144
+ blocks.push({
145
+ text: text,
146
+ chunkType: 'imports',
147
+ symbolSegments: [],
148
+ symbolName: undefined,
149
+ charStart: importStart,
150
+ charEnd: importEnd,
151
+ });
152
+ }
153
+ importStart = -1;
154
+ importEnd = -1;
155
+ };
156
+ for (const statement of sourceFile.statements) {
157
+ if (this.isImportLike(statement)) {
158
+ const start = statement.getStart(sourceFile, /* includeJsDocComment */ true);
159
+ if (importStart < 0) {
160
+ importStart = start;
161
+ }
162
+ importEnd = statement.getEnd();
163
+ continue;
164
+ }
165
+ // Más jött → import-csoport lezárása.
166
+ flushImports();
167
+ const detected = this.detectDeclaration(statement);
168
+ const start = statement.getStart(sourceFile, /* includeJsDocComment */ true);
169
+ const end = statement.getEnd();
170
+ const text = code.substring(start, end);
171
+ const symbolSegments = detected.name ? [`${detected.chunkType}:${detected.name}`] : [];
172
+ // Nagy osztály → metódusonkénti bontás (osztály-fej + metódusok).
173
+ if (ts.isClassDeclaration(statement) && text.length > sizing.maxChunkSize) {
174
+ this.splitClassByMethods(statement, sourceFile, code, detected.name, blocks);
175
+ continue;
176
+ }
177
+ blocks.push({
178
+ text: text,
179
+ chunkType: detected.chunkType,
180
+ symbolSegments: symbolSegments,
181
+ symbolName: detected.name,
182
+ charStart: start,
183
+ charEnd: end,
184
+ });
185
+ }
186
+ // Maradék import-csoport (ha a fájl import-tal végződik).
187
+ flushImports();
188
+ return blocks;
189
+ }
190
+ /** `true`, ha a statement import / re-export (`export ... from`) — az import-csoporthoz. */
191
+ static isImportLike(statement) {
192
+ if (ts.isImportDeclaration(statement) || ts.isImportEqualsDeclaration(statement)) {
193
+ return true;
194
+ }
195
+ // `export { ... } from '...'` / `export * from '...'` — csak ha van moduleSpecifier.
196
+ if (ts.isExportDeclaration(statement) && !!statement.moduleSpecifier) {
197
+ return true;
198
+ }
199
+ return false;
200
+ }
201
+ /** Egy top-level statement → szemantikus chunk-típus + symbol-név. */
202
+ static detectDeclaration(statement) {
203
+ if (ts.isClassDeclaration(statement)) {
204
+ return { chunkType: 'class', name: statement.name?.getText() };
205
+ }
206
+ if (ts.isInterfaceDeclaration(statement)) {
207
+ return { chunkType: 'interface', name: statement.name.getText() };
208
+ }
209
+ if (ts.isEnumDeclaration(statement)) {
210
+ return { chunkType: 'enum', name: statement.name.getText() };
211
+ }
212
+ if (ts.isTypeAliasDeclaration(statement)) {
213
+ return { chunkType: 'type', name: statement.name.getText() };
214
+ }
215
+ if (ts.isFunctionDeclaration(statement)) {
216
+ return { chunkType: 'function', name: statement.name?.getText() };
217
+ }
218
+ if (ts.isVariableStatement(statement)) {
219
+ const firstDecl = statement.declarationList.declarations[0];
220
+ const name = firstDecl && ts.isIdentifier(firstDecl.name)
221
+ ? firstDecl.name.getText()
222
+ : undefined;
223
+ // Ha a const egy függvény/arrow → 'function', egyébként 'variable'.
224
+ const initializer = firstDecl?.initializer;
225
+ const isFn = !!initializer
226
+ && (ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer));
227
+ return { chunkType: isFn ? 'function' : 'variable', name: name };
228
+ }
229
+ return { chunkType: 'generic', name: undefined };
230
+ }
231
+ /**
232
+ * Nagy osztály metódusonkénti bontása. Az első chunk az osztály-fej (a class-kulcsszótól az első
233
+ * tag előttig, dekorátorok + JSDoc-cal), majd minden metódus / property-deklaráció külön chunk a
234
+ * `class:Foo > method:bar` symbol-lánccal.
235
+ */
236
+ static splitClassByMethods(classDecl, sourceFile, code, className, blocks) {
237
+ const classSegment = `class:${className ?? 'anonymous'}`;
238
+ const classStart = classDecl.getStart(sourceFile, /* includeJsDocComment */ true);
239
+ const members = [...classDecl.members];
240
+ // Osztály-fej: a class kezdetétől az első tag kezdetéig (dekorátorok/JSDoc + `class X {`-rész).
241
+ const headerEnd = members.length
242
+ ? members[0].getStart(sourceFile, /* includeJsDocComment */ true)
243
+ : classDecl.getEnd();
244
+ const headerText = code.substring(classStart, headerEnd);
245
+ if (headerText.trim().length) {
246
+ blocks.push({
247
+ text: headerText,
248
+ chunkType: 'class',
249
+ symbolSegments: [classSegment],
250
+ symbolName: className,
251
+ charStart: classStart,
252
+ charEnd: headerEnd,
253
+ });
254
+ }
255
+ // Tagonkénti chunk (metódus / accessor / property).
256
+ for (const member of members) {
257
+ const memberStart = member.getStart(sourceFile, /* includeJsDocComment */ true);
258
+ const memberEnd = member.getEnd();
259
+ const memberText = code.substring(memberStart, memberEnd);
260
+ if (!memberText.trim().length) {
261
+ continue;
262
+ }
263
+ const memberName = member.name && ts.isIdentifier(member.name)
264
+ ? member.name.getText()
265
+ : (member.name ? member.name.getText() : undefined);
266
+ const memberKind = this.classMemberKind(member);
267
+ const memberSegment = memberName
268
+ ? `${memberKind}:${memberName}`
269
+ : memberKind;
270
+ blocks.push({
271
+ text: memberText,
272
+ chunkType: memberKind,
273
+ symbolSegments: [classSegment, memberSegment],
274
+ symbolName: memberName,
275
+ charStart: memberStart,
276
+ charEnd: memberEnd,
277
+ });
278
+ }
279
+ }
280
+ /** Egy osztály-tag → chunk-típus (metódus/accessor → 'method', mező → 'variable'). */
281
+ static classMemberKind(member) {
282
+ if (ts.isMethodDeclaration(member)
283
+ || ts.isConstructorDeclaration(member)
284
+ || ts.isGetAccessorDeclaration(member)
285
+ || ts.isSetAccessorDeclaration(member)) {
286
+ return 'method';
287
+ }
288
+ return 'variable';
289
+ }
290
+ /** Egy belső blokk → `DyNTS_DAI_CodeChunk` (pozíció + symbol-lánc kiszámolásával). */
291
+ static blockToChunk(block, chunkIndex, lineStartOffsets) {
292
+ const lineStart = this.lineOfOffset(block.charStart, lineStartOffsets);
293
+ const lineEnd = this.lineOfOffset(Math.max(block.charStart, block.charEnd - 1), lineStartOffsets);
294
+ return {
295
+ content: block.text,
296
+ chunkType: block.chunkType,
297
+ symbolPath: block.symbolSegments.join(' > '),
298
+ symbolSegments: block.symbolSegments,
299
+ symbolName: block.symbolName,
300
+ lineStart: lineStart,
301
+ lineEnd: lineEnd,
302
+ charStart: block.charStart,
303
+ charEnd: block.charEnd,
304
+ chunkIndex: chunkIndex,
305
+ };
306
+ }
307
+ /**
308
+ * Túl nagy blokk karakter-alapú sliding-window sub-splitje (örökölt chunkType + symbol-lánc).
309
+ * Az átfedés (`overlap`) karakter-szinten, a `minChunkSize` alatti farok-chunkokat kihagyja.
310
+ */
311
+ static splitLargeBlock(block, sizing, out, lineStartOffsets) {
312
+ const text = block.text;
313
+ const step = Math.max(1, sizing.maxChunkSize - sizing.overlap);
314
+ let subChunkIndex = 0;
315
+ for (let start = 0; start < text.length; start += step) {
316
+ const end = Math.min(start + sizing.maxChunkSize, text.length);
317
+ const slice = text.substring(start, end);
318
+ // A nagyon kicsi farok-chunkot (az utolsó, ami már nem éri el a minChunkSize-t) kihagyjuk,
319
+ // de csak ha NEM ez az egyetlen chunk.
320
+ if (slice.trim().length < sizing.minChunkSize && subChunkIndex > 0) {
321
+ break;
322
+ }
323
+ const absoluteCharStart = block.charStart + start;
324
+ const absoluteCharEnd = block.charStart + end;
325
+ const lineStart = this.lineOfOffset(absoluteCharStart, lineStartOffsets);
326
+ const lineEnd = this.lineOfOffset(Math.max(absoluteCharStart, absoluteCharEnd - 1), lineStartOffsets);
327
+ out.push({
328
+ content: slice,
329
+ chunkType: block.chunkType,
330
+ symbolPath: block.symbolSegments.join(' > '),
331
+ symbolSegments: block.symbolSegments,
332
+ symbolName: block.symbolName,
333
+ lineStart: lineStart,
334
+ lineEnd: lineEnd,
335
+ charStart: absoluteCharStart,
336
+ charEnd: absoluteCharEnd,
337
+ chunkIndex: out.length,
338
+ subChunkIndex: subChunkIndex,
339
+ });
340
+ subChunkIndex++;
341
+ if (end >= text.length) {
342
+ break;
343
+ }
344
+ }
345
+ }
346
+ /**
347
+ * Tiny / degenerált fallback: a teljes tartalmat egy (vagy nagy bemenetnél sliding) chunkba teszi.
348
+ * Soha nem ad vissza üres listát nem-üres bemenetre — a tartalom megőrzése a cél.
349
+ */
350
+ static buildFallbackChunks(content, sizing) {
351
+ const trimmed = content.trim();
352
+ if (!trimmed) {
353
+ return [];
354
+ }
355
+ const lineStartOffsets = this.computeLineStartOffsets(content);
356
+ // Kis tartalom → egyetlen fallback chunk.
357
+ if (content.length <= sizing.maxChunkSize) {
358
+ const lineEnd = this.lineOfOffset(Math.max(0, content.length - 1), lineStartOffsets);
359
+ return [{
360
+ content: content,
361
+ chunkType: 'fallback',
362
+ symbolPath: '',
363
+ symbolSegments: [],
364
+ symbolName: undefined,
365
+ lineStart: 1,
366
+ lineEnd: lineEnd,
367
+ charStart: 0,
368
+ charEnd: content.length,
369
+ chunkIndex: 0,
370
+ }];
371
+ }
372
+ // Nagy, de nem-parse-olható tartalom → sliding-window fallback.
373
+ const fallbackBlock = {
374
+ text: content,
375
+ chunkType: 'fallback',
376
+ symbolSegments: [],
377
+ symbolName: undefined,
378
+ charStart: 0,
379
+ charEnd: content.length,
380
+ };
381
+ const out = [];
382
+ this.splitLargeBlock(fallbackBlock, sizing, out, lineStartOffsets);
383
+ return out;
384
+ }
385
+ /**
386
+ * A forrás minden sorának kezdő karakter-offszetje (0-alapú). A `lineStartOffsets[i]` az `i`-edik
387
+ * (0-alapú) sor első karakterének abszolút pozíciója — bináris kereséssel gyors `offset → sor`
388
+ * konverziót ad a chunkokhoz.
389
+ */
390
+ static computeLineStartOffsets(source) {
391
+ const offsets = [0];
392
+ for (let i = 0; i < source.length; i++) {
393
+ if (source[i] === '\n') {
394
+ offsets.push(i + 1);
395
+ }
396
+ }
397
+ return offsets;
398
+ }
399
+ /**
400
+ * Egy abszolút karakter-offszet → 1-alapú sorszám a forrásban (bináris keresés a
401
+ * `lineStartOffsets`-ben). A sor-mezők így a forrás VALÓDI soraira mutatnak (nem chunk-relatív).
402
+ */
403
+ static lineOfOffset(offset, lineStartOffsets) {
404
+ let lo = 0;
405
+ let hi = lineStartOffsets.length - 1;
406
+ while (lo < hi) {
407
+ const mid = (lo + hi + 1) >> 1;
408
+ if (lineStartOffsets[mid] <= offset) {
409
+ lo = mid;
410
+ }
411
+ else {
412
+ hi = mid - 1;
413
+ }
414
+ }
415
+ return lo + 1;
416
+ }
417
+ }
418
+ exports.DyNTS_DAI_CodeChunking_Util = DyNTS_DAI_CodeChunking_Util;
419
+ //# sourceMappingURL=dai-code-chunking.util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dai-code-chunking.util.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * `DyNTS_DAI_CodeChunkType` — egy kód-chunk szemantikus típusa (BFR-AM-005).
3
+ * A TS Compiler API node-fajtáihoz igazítva: import-csoport, top-level deklarációk
4
+ * (class/interface/enum/type/function/standalone const) + osztály-metódus + nagy-node
5
+ * sliding-sub-chunk + tiny-fallback.
6
+ */
7
+ export type DyNTS_DAI_CodeChunkType = 'imports' | 'class' | 'method' | 'interface' | 'enum' | 'type' | 'function' | 'variable' | 'generic' | 'fallback';
8
+ /**
9
+ * `DyNTS_DAI_CodeChunk` (BFR-AM-005) — egy szemantikus kód-chunk, amit a
10
+ * `DyNTS_DAI_CodeChunking_Util.chunkTs(...)` állít elő a TypeScript Compiler API AST-jából.
11
+ *
12
+ * A markdown-oldali `DyNTS_DAI_DocChunk`-kal párhuzamos, de kód-specifikus mezőkkel:
13
+ * a `symbolPath` (pl. `class:Foo > method:bar`) a kód-symbol-láncot, a `chunkType` a
14
+ * node-fajtát, a `lineStart/lineEnd` + `charStart/charEnd` a forrás-pozíciót hordozza.
15
+ *
16
+ * Tisztán a chunker kimeneti alakja (NEM DB data-model) — a consumer dönti el, hogyan
17
+ * mappeli a `DyNTS_DAI_DocChunk` perzisztencia-modellre (pl. `symbolPath` → `path`).
18
+ */
19
+ export interface DyNTS_DAI_CodeChunk {
20
+ /** A chunk nyers szövege (a node forrás-tartománya, JSDoc + dekorátorokkal együtt). */
21
+ content: string;
22
+ /** A chunk szemantikus típusa (node-fajta). */
23
+ chunkType: DyNTS_DAI_CodeChunkType;
24
+ /**
25
+ * A kód-symbol-lánc, ` > ` szeparátorral összefűzve (a `chunkHeadParents`-mintára).
26
+ * Pl. `class:FooService > method:doThing`, `interface:Bar`, `function:helper`.
27
+ * Import-csoportra / generic-re üres string.
28
+ */
29
+ symbolPath: string;
30
+ /** A symbol-lánc szegmensei tömbként (pl. `['class:FooService', 'method:doThing']`). */
31
+ symbolSegments: string[];
32
+ /** A deklaráció neve (a legbelső symbol neve), ha van — pl. `doThing`, `FooService`. */
33
+ symbolName?: string;
34
+ /** 1-alapú kezdő sor a forrásban (inkluzív). */
35
+ lineStart: number;
36
+ /** 1-alapú záró sor a forrásban (inkluzív). */
37
+ lineEnd: number;
38
+ /** Karakter-kezdőpozíció a forrásban (0-alapú, inkluzív). */
39
+ charStart: number;
40
+ /** Karakter-végpozíció a forrásban (0-alapú, exkluzív). */
41
+ charEnd: number;
42
+ /** A chunk sorszáma a teljes kimenetben (0-alapú). */
43
+ chunkIndex: number;
44
+ /**
45
+ * Ha a chunk egy túl nagy node sliding-window sub-chunkja, akkor a sub-chunk
46
+ * 0-alapú indexe a szülő node-on belül; egyébként `undefined`.
47
+ */
48
+ subChunkIndex?: number;
49
+ }
50
+ //# sourceMappingURL=dai-code-chunk.interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dai-code-chunk.interface.d.ts","sourceRoot":"","sources":["../../../../../../../src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,SAAS,EAAE,uBAAuB,CAAC;IAEnC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,wFAAwF;IACxF,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAEhB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=dai-code-chunk.interface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dai-code-chunk.interface.js","sourceRoot":"","sources":["../../../../../../../src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts"],"names":[],"mappings":""}
@@ -1,10 +1,12 @@
1
1
  export * from '@futdevpro/fsm-dynamo/ai/document-ai';
2
2
  export * from './_collections/dai-chunking.util';
3
+ export * from './_collections/dai-code-chunking.util';
3
4
  export * from './_collections/dai-document.util';
4
5
  export * from './_enums/dai-compare-result-type.enum';
5
6
  export * from './_models/data-models/dai-doc-chunk.data-model';
6
7
  export * from './_models/data-models/dai-document.data-model';
7
8
  export * from './_models/data-models/dai-doc-page.data-model';
9
+ export * from './_models/interfaces/dai-code-chunk.interface';
8
10
  export * from './_models/interfaces/dai-doc-chunk-compare-result.interface';
9
11
  export * from './_models/interfaces/dai-doc-page-compare-result.interface';
10
12
  export * from './_models/interfaces/dai-document-compare-result.interface';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/document-ai/index.ts"],"names":[],"mappings":"AACA,cAAc,sCAAsC,CAAC;AAGrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,uCAAuC,CAAC;AAItD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,+CAA+C,CAAC;AAG9D,cAAc,6DAA6D,CAAC;AAC5E,cAAc,4DAA4D,CAAC;AAC3E,cAAc,4DAA4D,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/document-ai/index.ts"],"names":[],"mappings":"AACA,cAAc,sCAAsC,CAAC;AAGrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,uCAAuC,CAAC;AAItD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,+CAA+C,CAAC;AAG9D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6DAA6D,CAAC;AAC5E,cAAc,4DAA4D,CAAC;AAC3E,cAAc,4DAA4D,CAAC"}
@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
5
5
  tslib_1.__exportStar(require("@futdevpro/fsm-dynamo/ai/document-ai"), exports);
6
6
  // COLLECTIONS
7
7
  tslib_1.__exportStar(require("./_collections/dai-chunking.util"), exports);
8
+ tslib_1.__exportStar(require("./_collections/dai-code-chunking.util"), exports);
8
9
  tslib_1.__exportStar(require("./_collections/dai-document.util"), exports);
9
10
  // ENUMS
10
11
  //export * from './_enums/dai-validation-error.enum';
@@ -15,6 +16,7 @@ tslib_1.__exportStar(require("./_models/data-models/dai-doc-chunk.data-model"),
15
16
  tslib_1.__exportStar(require("./_models/data-models/dai-document.data-model"), exports);
16
17
  tslib_1.__exportStar(require("./_models/data-models/dai-doc-page.data-model"), exports);
17
18
  // models/INTERFACES
19
+ tslib_1.__exportStar(require("./_models/interfaces/dai-code-chunk.interface"), exports);
18
20
  tslib_1.__exportStar(require("./_models/interfaces/dai-doc-chunk-compare-result.interface"), exports);
19
21
  tslib_1.__exportStar(require("./_models/interfaces/dai-doc-page-compare-result.interface"), exports);
20
22
  tslib_1.__exportStar(require("./_models/interfaces/dai-document-compare-result.interface"), exports);
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/document-ai/index.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,+EAAqD;AAErD,cAAc;AACd,2EAAiD;AACjD,2EAAiD;AAEjD,QAAQ;AACR,qDAAqD;AACrD,gFAAsD;AAEtD,SAAS;AACT,qBAAqB;AACrB,yFAA+D;AAC/D,wFAA8D;AAC9D,wFAA8D;AAE9D,oBAAoB;AACpB,sGAA4E;AAC5E,qGAA2E;AAC3E,qGAA2E;AAE3E,yDAAyD;AACzD,+DAA+D;AAE/D,WAAW;AACX,2DAA2D;AAC3D,6DAA6D"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/document-ai/index.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,+EAAqD;AAErD,cAAc;AACd,2EAAiD;AACjD,gFAAsD;AACtD,2EAAiD;AAEjD,QAAQ;AACR,qDAAqD;AACrD,gFAAsD;AAEtD,SAAS;AACT,qBAAqB;AACrB,yFAA+D;AAC/D,wFAA8D;AAC9D,wFAA8D;AAE9D,oBAAoB;AACpB,wFAA8D;AAC9D,sGAA4E;AAC5E,qGAA2E;AAC3E,qGAA2E;AAE3E,yDAAyD;AACzD,+DAA+D;AAE/D,WAAW;AACX,2DAA2D;AAC3D,6DAA6D"}
@@ -0,0 +1,81 @@
1
+ import { CreateEmbeddingResponse } from 'openai/resources';
2
+ import { DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
3
+ import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
4
+ import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
5
+ import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
6
+ /** A mock-embedding default dimenziója (kicsi, hogy a teszt-pool gyors legyen, de elég a koszinuszhoz). */
7
+ export declare const DyNTS_AI_MOCK_EMBEDDING_DIMS: number;
8
+ /**
9
+ * A mock embedding-service config-set-je. A `dims` a generált vektor dimenziója (default
10
+ * `DyNTS_AI_MOCK_EMBEDDING_DIMS`), az `onCostEvent` a per-call cost-event sink (FR-002 / BFR-AM-007).
11
+ */
12
+ export interface DyNTS_AI_Embedding_MockSettings {
13
+ /** A generált vektor dimenziója (default `DyNTS_AI_MOCK_EMBEDDING_DIMS`). */
14
+ dims?: number;
15
+ /** Per-call cost-event callback (FR-002 / BFR-AM-007). Non-breaking: ha undefined, nincs emit. */
16
+ onCostEvent?: DyNTS_AI_CostEventCallback;
17
+ }
18
+ /**
19
+ * `DyNTS_AI_Embedding_MockService` (BFR-AM-008) — determinisztikus, hash-alapú, fix-dimenziós,
20
+ * l2-normalizált pszeudo-vektor a szövegből. Provider- és hálózat-mentes → a tesztek + a tsc-/offline-
21
+ * smoke valódi API-kulcs nélkül futnak. Azonos `(model, text)` → azonos vektor (idempotens), így a
22
+ * koszinusz-keresés determinisztikusan tesztelhető. A FAM `FAM_Mock_EmbeddingProvider` workaround-ját
23
+ * emeli bedrock-szintre, mint újrahasználható test-double.
24
+ *
25
+ * **Cost-event (BFR-AM-007):** minden call után `emitCostEvent`-tel jelez (fake token-fogyasztás,
26
+ * 4 char ≈ 1 token), provider `'mock'`, callType `embedding-single` / `embedding-batch`. Így a
27
+ * cost-aggregáló pipeline mock-providerrel is end-to-end tesztelhető.
28
+ */
29
+ export declare class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBase {
30
+ /** A mock a `LocalAI` provider-enum alá tartozik (nincs külső hívás). */
31
+ readonly aiProvider: DyFM_AI_Provider;
32
+ /** A cost-event provider-string (a `DyNTS_AI_CostEvent.provider` szabad-string mezőjéhez). */
33
+ protected readonly costProvider: string;
34
+ /** Mock capability-k: csak embedding (determinisztikus). */
35
+ readonly capabilities: DyFM_AI_ProviderCapabilities;
36
+ /** A generált vektor dimenziója. */
37
+ protected dims: number;
38
+ /** @param set opcionális dims + onCostEvent. */
39
+ constructor(set?: DyNTS_AI_Embedding_MockSettings);
40
+ /** A mock-nak nincs külső config-ja; a `setup` a dimenzió override-jára szolgál (config.dimensions). */
41
+ setup(config: DyFM_AI_Config): void;
42
+ /**
43
+ * Egy determinisztikus embedding. A `model`-t beleszövi a seed-be, hogy modell-váltás más vektort
44
+ * adjon (re-embed teszteléshez). `fullResponse=true` → OpenAI-alakú válasz-objektum.
45
+ */
46
+ createEmbedding(set: {
47
+ text: string;
48
+ model: string;
49
+ fullResponse?: boolean;
50
+ issuer: string;
51
+ }): Promise<number[] | CreateEmbeddingResponse>;
52
+ /**
53
+ * Determinisztikus batch-embedding: minden szöveghez a `(model, text)` seed-ből generál egy fix-
54
+ * dimenziós, l2-normalizált vektort. A `texts` sorrendje == a visszaadott `number[][]` sorrendje.
55
+ */
56
+ createEmbeddings(set: {
57
+ texts: string[];
58
+ model: string;
59
+ fullResponse?: boolean;
60
+ issuer: string;
61
+ }): Promise<number[][] | CreateEmbeddingResponse>;
62
+ /** Embedding model-info: provider `LocalAI`, model a megadott azonosító. */
63
+ getEmbeddingInfo(model: string): DyFM_DAI_EmbeddingInfo;
64
+ /** A mock mindig elérhető (nincs külső függőség). */
65
+ testConnection(_issuer: string): Promise<boolean>;
66
+ /**
67
+ * Egy determinisztikus, l2-normalizált vektor a seed-ből. A SHA-256 hash bájtjait körkörösen
68
+ * használja a `dims` kitöltésére, [-1, 1) tartományra képzi, majd l2-normalizál (egységhossz a
69
+ * koszinuszhoz). Egy második hash-bájttal kever, hogy a hosszabb dimenziókon ne ismétlődjön a minta.
70
+ */
71
+ protected deterministicVector(seed: string): number[];
72
+ /** L2-normalizálás (egységhossz). Nulla-vektor → változatlan (elkerüli a 0-osztást). */
73
+ protected l2Normalize(vector: number[]): number[];
74
+ /** OpenAI-alakú válasz-objektum a vektorokból (a `fullResponse=true` ághoz). */
75
+ protected toResponse(vectors: number[][], model: string, texts: string[]): CreateEmbeddingResponse;
76
+ /** Cost-event emit (BFR-AM-007) fake tokennel (4 char ≈ 1 token), provider `'mock'`. */
77
+ protected emitMockCostEvent(callType: 'embedding-single' | 'embedding-batch', model: string, texts: string[], durationMs: number, issuer: string): void;
78
+ /** Becsült (fake) token-szám: 4 char ≈ 1 token. */
79
+ protected estimateTokens(texts: string[]): number;
80
+ }
81
+ //# sourceMappingURL=ai-embedding-mock.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ai-embedding-mock.service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAE1G,2GAA2G;AAC3G,eAAO,MAAM,4BAA4B,EAAE,MAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,8BAA+B,SAAQ,8BAA8B;IAEhF,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAA4B;IAEjE,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAU;IAEjD,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAWjD;IAEF,oCAAoC;IACpC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IAEvB,gDAAgD;gBACpC,GAAG,CAAC,EAAE,+BAA+B;IAQjD,wGAAwG;IACxG,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAOnC;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,GAAG,uBAAuB,CAAC;IAa9C;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC;IAchD,4EAA4E;IAC5E,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAOvD,qDAAqD;IAC/C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAYrD,wFAAwF;IACxF,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAYjD,gFAAgF;IAChF,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,uBAAuB;IAalG,wFAAwF;IACxF,SAAS,CAAC,iBAAiB,CACzB,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI;IAiBP,mDAAmD;IACnD,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CAOlD"}