@futdevpro/nts-dynamo 1.15.67 → 1.15.68

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 (932) 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/__main.mdc +64 -64
  5. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  6. package/.cursor/rules/_ag_backend.mdc +16 -16
  7. package/.cursor/rules/_ag_debug.mdc +7 -7
  8. package/.cursor/rules/_ag_documentation_writing_rules.mdc +372 -372
  9. package/.cursor/rules/_ag_file-refactoring.mdc +113 -113
  10. package/.cursor/rules/_ag_fixes_rules.mdc +5 -5
  11. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  12. package/.cursor/rules/_ag_frontend.mdc +39 -39
  13. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  14. package/.cursor/rules/_ag_naming.mdc +115 -115
  15. package/.cursor/rules/_ag_running_commands.mdc +4 -4
  16. package/.cursor/rules/_ag_server-controller.mdc +5 -5
  17. package/.cursor/rules/_ag_should-be.mdc +6 -6
  18. package/.cursor/rules/_ag_swearing.mdc +47 -47
  19. package/.cursor/rules/ai_development_guide.md +60 -60
  20. package/.cursor/rules/ai_directives.md +114 -114
  21. package/.cursor/rules/cursor-rules.md +160 -160
  22. package/.cursor/rules/default-command.mdc +464 -464
  23. package/.cursor/rules/error_code_pattern.md +39 -39
  24. package/.cursor/rules/saved rule mcp server use.md +15 -15
  25. package/.dynamo/pipeline.cicd.config.json +180 -180
  26. package/.dynamo/version-bump.config.json +5 -5
  27. package/.github/workflows/main.yml +438 -438
  28. package/.husky/pre-commit +3 -3
  29. package/.vscode/settings.json +10 -10
  30. package/HOWTO.md +15 -15
  31. package/LICENSE +21 -21
  32. package/README.md +678 -678
  33. package/__documentations/2026-04-28-logs-module.md +49 -49
  34. package/__documentations/2026-05-17-oai-compatible-providers.md +229 -229
  35. package/__documentations/2026-05-17-static-client-serving-howto.md +144 -144
  36. package/__documentations/2026-06-01-fr041-cors-middleware.md +96 -96
  37. package/__documentations/2026-06-01-fr047-p2p3-function-calling.md +81 -81
  38. package/__documentations/2026-06-15-fr193-memory-guard.md +73 -73
  39. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  40. package/_specifications/BACKLOG.md +92 -92
  41. package/_specifications/TODO.md +15 -15
  42. package/_specifications/agent.md +138 -138
  43. package/build/_collections/archive.util.d.ts +12 -12
  44. package/build/_collections/archive.util.js +18 -18
  45. package/build/_collections/atlas-default-db-options.const.d.ts +2 -2
  46. package/build/_collections/atlas-default-db-options.const.js +9 -9
  47. package/build/_collections/default-fallback-cache-max-age.const.d.ts +2 -2
  48. package/build/_collections/default-fallback-cache-max-age.const.js +5 -5
  49. package/build/_collections/default-not-found-page.const.d.ts +5 -5
  50. package/build/_collections/default-not-found-page.const.js +24 -24
  51. package/build/_collections/default-socket-path.const.d.ts +2 -2
  52. package/build/_collections/default-socket-path.const.js +5 -5
  53. package/build/_collections/get-environment-settings.util.d.ts +2 -2
  54. package/build/_collections/get-environment-settings.util.js +43 -43
  55. package/build/_collections/global-settings.const.d.ts +6 -6
  56. package/build/_collections/global-settings.const.js +69 -69
  57. package/build/_collections/mongo-reconnect-guard.util.d.ts +73 -73
  58. package/build/_collections/mongo-reconnect-guard.util.js +110 -110
  59. package/build/_collections/star.controller.d.ts +7 -7
  60. package/build/_collections/star.controller.js +97 -97
  61. package/build/_enums/data-model-type.enum.d.ts +13 -13
  62. package/build/_enums/data-model-type.enum.js +17 -17
  63. package/build/_enums/data-service-function.enum.d.ts +18 -18
  64. package/build/_enums/data-service-function.enum.js +24 -24
  65. package/build/_enums/predefined-data-types.enum.d.ts +15 -15
  66. package/build/_enums/predefined-data-types.enum.js +19 -19
  67. package/build/_enums/route-security.enum.d.ts +11 -11
  68. package/build/_enums/route-security.enum.js +15 -15
  69. package/build/_models/control-models/api-call-params.control-model.d.ts +79 -79
  70. package/build/_models/control-models/api-call-params.control-model.js +101 -101
  71. package/build/_models/control-models/app-ext-system-controls.control-model.d.ts +6 -6
  72. package/build/_models/control-models/app-ext-system-controls.control-model.js +10 -10
  73. package/build/_models/control-models/app-params.control-model.d.ts +51 -51
  74. package/build/_models/control-models/app-params.control-model.js +119 -119
  75. package/build/_models/control-models/app-system-controls.control-model.d.ts +7 -7
  76. package/build/_models/control-models/app-system-controls.control-model.js +11 -11
  77. package/build/_models/control-models/endpoint-params.control-model.d.ts +114 -114
  78. package/build/_models/control-models/endpoint-params.control-model.js +442 -442
  79. package/build/_models/control-models/http-settings.control-model.d.ts +17 -17
  80. package/build/_models/control-models/http-settings.control-model.js +34 -34
  81. package/build/_models/control-models/system-control.control-model.d.ts +5 -5
  82. package/build/_models/control-models/system-control.control-model.js +11 -11
  83. package/build/_models/interfaces/certification-settings.interface.d.ts +5 -5
  84. package/build/_models/interfaces/certification-settings.interface.js +2 -2
  85. package/build/_models/interfaces/compare-data-options.interface.d.ts +26 -26
  86. package/build/_models/interfaces/compare-data-options.interface.js +2 -2
  87. package/build/_models/interfaces/compare-data-result.interface.d.ts +12 -12
  88. package/build/_models/interfaces/compare-data-result.interface.js +2 -2
  89. package/build/_models/interfaces/cors-settings.interface.d.ts +51 -51
  90. package/build/_models/interfaces/cors-settings.interface.js +2 -2
  91. package/build/_models/interfaces/environment-settings.interface.d.ts +34 -34
  92. package/build/_models/interfaces/environment-settings.interface.js +2 -2
  93. package/build/_models/interfaces/global-log-settings.interface.d.ts +145 -145
  94. package/build/_models/interfaces/global-log-settings.interface.js +2 -2
  95. package/build/_models/interfaces/global-service-settings.interface.d.ts +30 -30
  96. package/build/_models/interfaces/global-service-settings.interface.js +2 -2
  97. package/build/_models/interfaces/global-settings.interface.d.ts +161 -161
  98. package/build/_models/interfaces/global-settings.interface.js +2 -2
  99. package/build/_models/interfaces/routing-module-settings.interface.d.ts +19 -19
  100. package/build/_models/interfaces/routing-module-settings.interface.js +2 -2
  101. package/build/_models/interfaces/static-client-settings.interface.d.ts +28 -28
  102. package/build/_models/interfaces/static-client-settings.interface.js +2 -2
  103. package/build/_models/types/db-update.type.d.ts +129 -129
  104. package/build/_models/types/db-update.type.js +2 -2
  105. package/build/_modules/admin-auth/_models/admin-api-key-config.interface.d.ts +31 -31
  106. package/build/_modules/admin-auth/_models/admin-api-key-config.interface.js +2 -2
  107. package/build/_modules/admin-auth/admin-api-key.auth-service.d.ts +89 -89
  108. package/build/_modules/admin-auth/admin-api-key.auth-service.js +194 -194
  109. package/build/_modules/admin-auth/index.d.ts +2 -2
  110. package/build/_modules/admin-auth/index.js +5 -5
  111. package/build/_modules/ai/_models/ai-input-interfaces.d.ts +53 -53
  112. package/build/_modules/ai/_models/ai-input-interfaces.js +5 -5
  113. package/build/_modules/ai/_models/ai-test-generation-result.interface.d.ts +16 -16
  114. package/build/_modules/ai/_models/ai-test-generation-result.interface.js +2 -2
  115. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.d.ts +13 -13
  116. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.js +2 -2
  117. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.d.ts +49 -49
  118. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.js +2 -2
  119. package/build/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.d.ts +35 -35
  120. package/build/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.js +117 -117
  121. package/build/_modules/ai/_modules/anthropic/index.d.ts +2 -2
  122. package/build/_modules/ai/_modules/anthropic/index.js +7 -7
  123. package/build/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.d.ts +84 -84
  124. package/build/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.js +467 -467
  125. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.d.ts +109 -109
  126. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.js +418 -418
  127. package/build/_modules/ai/_modules/document-ai/_collections/dai-document.util.d.ts +28 -28
  128. package/build/_modules/ai/_modules/document-ai/_collections/dai-document.util.js +73 -73
  129. package/build/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.d.ts +6 -6
  130. package/build/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.js +10 -10
  131. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.d.ts +51 -51
  132. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.js +132 -132
  133. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.d.ts +47 -47
  134. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.js +136 -136
  135. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.d.ts +17 -17
  136. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.js +76 -76
  137. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.d.ts +49 -49
  138. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.js +2 -2
  139. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.d.ts +8 -8
  140. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.js +2 -2
  141. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.d.ts +11 -11
  142. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.js +2 -2
  143. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.d.ts +12 -12
  144. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.js +2 -2
  145. package/build/_modules/ai/_modules/document-ai/index.d.ts +12 -12
  146. package/build/_modules/ai/_modules/document-ai/index.js +27 -27
  147. package/build/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.d.ts +34 -34
  148. package/build/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.js +128 -128
  149. package/build/_modules/ai/_modules/fdp-ai/index.d.ts +2 -2
  150. package/build/_modules/ai/_modules/fdp-ai/index.js +7 -7
  151. package/build/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.d.ts +2 -2
  152. package/build/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.js +8 -8
  153. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.d.ts +2 -2
  154. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.js +74 -74
  155. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.d.ts +2 -2
  156. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.js +67 -67
  157. package/build/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.js +42 -42
  158. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.d.ts +5 -5
  159. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.js +2 -2
  160. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.js +6 -6
  161. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.d.ts +51 -51
  162. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.js +2 -2
  163. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.d.ts +21 -21
  164. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.js +187 -187
  165. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.d.ts +26 -26
  166. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.js +278 -278
  167. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.d.ts +22 -22
  168. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.js +322 -322
  169. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.d.ts +119 -119
  170. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.js +480 -480
  171. package/build/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.d.ts +25 -25
  172. package/build/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.js +103 -103
  173. package/build/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.d.ts +169 -169
  174. package/build/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.js +479 -479
  175. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts +201 -201
  176. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js +579 -579
  177. package/build/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.d.ts +39 -39
  178. package/build/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.js +110 -110
  179. package/build/_modules/ai/_modules/open-ai/index.d.ts +14 -14
  180. package/build/_modules/ai/_modules/open-ai/index.js +55 -55
  181. package/build/_modules/ai/_services/ai-embedding-mock.service.d.ts +80 -80
  182. package/build/_modules/ai/_services/ai-embedding-mock.service.js +166 -166
  183. package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts +51 -51
  184. package/build/_modules/ai/_services/ai-embedding-provider.registry.js +78 -78
  185. package/build/_modules/ai/_services/ai-embedding.service-base.d.ts +41 -41
  186. package/build/_modules/ai/_services/ai-embedding.service-base.js +11 -11
  187. package/build/_modules/ai/_services/ai-llm-chat.service-base.d.ts +39 -39
  188. package/build/_modules/ai/_services/ai-llm-chat.service-base.js +11 -11
  189. package/build/_modules/ai/_services/ai-llm.service-base.d.ts +132 -132
  190. package/build/_modules/ai/_services/ai-llm.service-base.js +313 -313
  191. package/build/_modules/ai/_services/ai-provider.service-base.d.ts +46 -46
  192. package/build/_modules/ai/_services/ai-provider.service-base.js +43 -43
  193. package/build/_modules/ai/_services/ai-user-key.service-base.d.ts +44 -44
  194. package/build/_modules/ai/_services/ai-user-key.service-base.js +14 -14
  195. package/build/_modules/ai/_services/lmstudio-embedding.control-service.d.ts +110 -110
  196. package/build/_modules/ai/_services/lmstudio-embedding.control-service.js +297 -297
  197. package/build/_modules/ai/index.d.ts +13 -13
  198. package/build/_modules/ai/index.js +22 -22
  199. package/build/_modules/assistant/_collections/ass-global-settings.const.d.ts +2 -2
  200. package/build/_modules/assistant/_collections/ass-global-settings.const.js +14 -14
  201. package/build/_modules/assistant/_collections/ass.util.d.ts +15 -15
  202. package/build/_modules/assistant/_collections/ass.util.js +42 -42
  203. package/build/_modules/assistant/_models/ass-global-settings.interface.d.ts +13 -13
  204. package/build/_modules/assistant/_models/ass-global-settings.interface.js +2 -2
  205. package/build/_modules/assistant/_services/ass-io.control-service.d.ts +19 -19
  206. package/build/_modules/assistant/_services/ass-io.control-service.js +57 -57
  207. package/build/_modules/assistant/_services/ass-main.control-service.d.ts +32 -32
  208. package/build/_modules/assistant/_services/ass-main.control-service.js +65 -65
  209. package/build/_modules/assistant/index.d.ts +6 -6
  210. package/build/_modules/assistant/index.js +18 -18
  211. package/build/_modules/bot/_collections/bot-default-commands.const.d.ts +2 -2
  212. package/build/_modules/bot/_collections/bot-default-commands.const.js +13 -13
  213. package/build/_modules/bot/_collections/bot-global-settings.const.d.ts +2 -2
  214. package/build/_modules/bot/_collections/bot-global-settings.const.js +31 -31
  215. package/build/_modules/bot/_models/bot-channel-wrapper.interface.d.ts +25 -25
  216. package/build/_modules/bot/_models/bot-channel-wrapper.interface.js +38 -38
  217. package/build/_modules/bot/_models/bot-command.interface.d.ts +7 -7
  218. package/build/_modules/bot/_models/bot-command.interface.js +2 -2
  219. package/build/_modules/bot/_models/bot-global-settings.interface.d.ts +85 -85
  220. package/build/_modules/bot/_models/bot-global-settings.interface.js +2 -2
  221. package/build/_modules/bot/_models/bot-last-mention-date.interface.d.ts +6 -6
  222. package/build/_modules/bot/_models/bot-last-mention-date.interface.js +2 -2
  223. package/build/_modules/bot/_models/bot-last-message-date.interface.d.ts +5 -5
  224. package/build/_modules/bot/_models/bot-last-message-date.interface.js +2 -2
  225. package/build/_modules/bot/_models/bot-message-wrapper.interface.d.ts +37 -37
  226. package/build/_modules/bot/_models/bot-message-wrapper.interface.js +54 -54
  227. package/build/_modules/bot/_models/bot-user-wrapper.interface.d.ts +23 -23
  228. package/build/_modules/bot/_models/bot-user-wrapper.interface.js +28 -28
  229. package/build/_modules/bot/_modules/discord-bot/_models/dib-platform.types.js +10 -10
  230. package/build/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.d.ts +69 -69
  231. package/build/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.js +497 -497
  232. package/build/_modules/bot/_modules/discord-bot/index.d.ts +1 -1
  233. package/build/_modules/bot/_modules/discord-bot/index.js +12 -12
  234. package/build/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.d.ts +16 -16
  235. package/build/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.js +42 -42
  236. package/build/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.d.ts +9 -9
  237. package/build/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.js +2 -2
  238. package/build/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.d.ts +59 -59
  239. package/build/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.js +349 -349
  240. package/build/_modules/bot/_modules/dynamo-bot/index.d.ts +3 -3
  241. package/build/_modules/bot/_modules/dynamo-bot/index.js +15 -15
  242. package/build/_modules/bot/_modules/slack-bot/_models/slb-platform.types.d.ts +6 -6
  243. package/build/_modules/bot/_modules/slack-bot/_models/slb-platform.types.js +2 -2
  244. package/build/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.d.ts +56 -56
  245. package/build/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.js +137 -137
  246. package/build/_modules/bot/_modules/slack-bot/index.d.ts +2 -2
  247. package/build/_modules/bot/_modules/slack-bot/index.js +12 -12
  248. package/build/_modules/bot/_modules/teams-bot/_models/teb-platform.types.d.ts +6 -6
  249. package/build/_modules/bot/_modules/teams-bot/_models/teb-platform.types.js +2 -2
  250. package/build/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.d.ts +56 -56
  251. package/build/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.js +137 -137
  252. package/build/_modules/bot/_modules/teams-bot/index.d.ts +2 -2
  253. package/build/_modules/bot/_modules/teams-bot/index.js +12 -12
  254. package/build/_modules/bot/_services/bot-commands.control-service.d.ts +12 -12
  255. package/build/_modules/bot/_services/bot-commands.control-service.js +117 -117
  256. package/build/_modules/bot/_services/bot-io.control-service.d.ts +23 -23
  257. package/build/_modules/bot/_services/bot-io.control-service.js +226 -226
  258. package/build/_modules/bot/_services/bot-main.control-service.d.ts +35 -35
  259. package/build/_modules/bot/_services/bot-main.control-service.js +195 -195
  260. package/build/_modules/bot/_services/bot-messaging-provider.service-base.d.ts +71 -71
  261. package/build/_modules/bot/_services/bot-messaging-provider.service-base.js +15 -15
  262. package/build/_modules/bot/_services/bot-routines.control-service.d.ts +13 -13
  263. package/build/_modules/bot/_services/bot-routines.control-service.js +59 -59
  264. package/build/_modules/bot/index.d.ts +17 -17
  265. package/build/_modules/bot/index.js +36 -36
  266. package/build/_modules/custom-data/custom-data.controller.d.ts +5 -5
  267. package/build/_modules/custom-data/custom-data.controller.js +56 -56
  268. package/build/_modules/custom-data/custom-data.data-service.d.ts +5 -5
  269. package/build/_modules/custom-data/custom-data.data-service.js +11 -11
  270. package/build/_modules/custom-data/get-custom-data-routing-module.util.d.ts +3 -3
  271. package/build/_modules/custom-data/get-custom-data-routing-module.util.js +16 -16
  272. package/build/_modules/custom-data/index.d.ts +4 -4
  273. package/build/_modules/custom-data/index.js +9 -9
  274. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.d.ts +58 -58
  275. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.js +168 -168
  276. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.d.ts +31 -31
  277. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js +7 -7
  278. package/build/_modules/data-readers/index.d.ts +2 -2
  279. package/build/_modules/data-readers/index.js +10 -10
  280. package/build/_modules/defaults/_collections/default-endpoints.util.d.ts +248 -248
  281. package/build/_modules/defaults/_collections/default-endpoints.util.js +386 -386
  282. package/build/_modules/defaults/_models/default-user.data-model.d.ts +19 -19
  283. package/build/_modules/defaults/_models/default-user.data-model.js +72 -72
  284. package/build/_modules/defaults/_services/default-auth.service.d.ts +50 -50
  285. package/build/_modules/defaults/_services/default-auth.service.js +158 -158
  286. package/build/_modules/defaults/_services/default-socket-events.service.d.ts +23 -23
  287. package/build/_modules/defaults/_services/default-socket-events.service.js +60 -60
  288. package/build/_modules/defaults/_services/default-user.data-service.d.ts +24 -24
  289. package/build/_modules/defaults/_services/default-user.data-service.js +87 -87
  290. package/build/_modules/defaults/index.d.ts +5 -5
  291. package/build/_modules/defaults/index.js +17 -17
  292. package/build/_modules/discord-assistant/_collections/dias-global-settings.const.d.ts +2 -2
  293. package/build/_modules/discord-assistant/_collections/dias-global-settings.const.js +16 -16
  294. package/build/_modules/discord-assistant/_collections/dias.util.d.ts +31 -31
  295. package/build/_modules/discord-assistant/_collections/dias.util.js +85 -85
  296. package/build/_modules/discord-assistant/_models/dias-global-settings.interface.d.ts +17 -17
  297. package/build/_modules/discord-assistant/_models/dias-global-settings.interface.js +2 -2
  298. package/build/_modules/discord-assistant/_models/dias-knowledge.data-model.d.ts +8 -8
  299. package/build/_modules/discord-assistant/_models/dias-knowledge.data-model.js +46 -46
  300. package/build/_modules/discord-assistant/_services/dias-chunk.data-service.d.ts +17 -17
  301. package/build/_modules/discord-assistant/_services/dias-chunk.data-service.js +123 -123
  302. package/build/_modules/discord-assistant/_services/dias-io.control-service.d.ts +10 -10
  303. package/build/_modules/discord-assistant/_services/dias-io.control-service.js +49 -49
  304. package/build/_modules/discord-assistant/_services/dias-main.control-service.d.ts +3 -3
  305. package/build/_modules/discord-assistant/_services/dias-main.control-service.js +7 -7
  306. package/build/_modules/discord-assistant/_services/dias.service-base.d.ts +18 -18
  307. package/build/_modules/discord-assistant/_services/dias.service-base.js +46 -46
  308. package/build/_modules/discord-assistant/index.d.ts +11 -11
  309. package/build/_modules/discord-assistant/index.js +24 -24
  310. package/build/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.d.ts +3 -3
  311. package/build/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.js +7 -7
  312. package/build/_modules/discord-assistant-voiced/index.d.ts +2 -2
  313. package/build/_modules/discord-assistant-voiced/index.js +28 -28
  314. package/build/_modules/discord-bot/_collections/dibo-default-commands.const.d.ts +2 -2
  315. package/build/_modules/discord-bot/_collections/dibo-default-commands.const.js +12 -12
  316. package/build/_modules/discord-bot/_collections/dibo-global-settings.conts.d.ts +2 -2
  317. package/build/_modules/discord-bot/_collections/dibo-global-settings.conts.js +43 -43
  318. package/build/_modules/discord-bot/_collections/dibo-operations.util.d.ts +22 -22
  319. package/build/_modules/discord-bot/_collections/dibo-operations.util.js +275 -275
  320. package/build/_modules/discord-bot/_models/dibo-command.interface.d.ts +7 -7
  321. package/build/_modules/discord-bot/_models/dibo-command.interface.js +2 -2
  322. package/build/_modules/discord-bot/_models/dibo-global-settings.interface.d.ts +87 -87
  323. package/build/_modules/discord-bot/_models/dibo-global-settings.interface.js +2 -2
  324. package/build/_modules/discord-bot/_models/dibo-last-mention-date.inteface.d.ts +6 -6
  325. package/build/_modules/discord-bot/_models/dibo-last-mention-date.inteface.js +2 -2
  326. package/build/_modules/discord-bot/_models/dibo-last-message-date.interface.d.ts +5 -5
  327. package/build/_modules/discord-bot/_models/dibo-last-message-date.interface.js +2 -2
  328. package/build/_modules/discord-bot/_services/dibo-commands.control-service.d.ts +11 -11
  329. package/build/_modules/discord-bot/_services/dibo-commands.control-service.js +109 -109
  330. package/build/_modules/discord-bot/_services/dibo-io.control-service.d.ts +21 -21
  331. package/build/_modules/discord-bot/_services/dibo-io.control-service.js +218 -218
  332. package/build/_modules/discord-bot/_services/dibo-main.control-service.d.ts +89 -89
  333. package/build/_modules/discord-bot/_services/dibo-main.control-service.js +363 -363
  334. package/build/_modules/discord-bot/_services/dibo-routines.control-service.d.ts +13 -13
  335. package/build/_modules/discord-bot/_services/dibo-routines.control-service.js +73 -73
  336. package/build/_modules/discord-bot/index.d.ts +11 -11
  337. package/build/_modules/discord-bot/index.js +30 -30
  338. package/build/_modules/local-vector-search/_enums/lvs-search-mode.enum.d.ts +34 -34
  339. package/build/_modules/local-vector-search/_enums/lvs-search-mode.enum.js +38 -38
  340. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts +35 -35
  341. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js +53 -53
  342. package/build/_modules/local-vector-search/_models/lvs-search-result.interface.d.ts +16 -16
  343. package/build/_modules/local-vector-search/_models/lvs-search-result.interface.js +2 -2
  344. package/build/_modules/local-vector-search/_services/lvs-bm25.util.d.ts +88 -88
  345. package/build/_modules/local-vector-search/_services/lvs-bm25.util.js +189 -189
  346. package/build/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.d.ts +26 -26
  347. package/build/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.js +197 -197
  348. package/build/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.d.ts +145 -145
  349. package/build/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.js +294 -294
  350. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts +69 -69
  351. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js +122 -122
  352. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts +42 -42
  353. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js +71 -71
  354. package/build/_modules/local-vector-search/_services/lvs-vector-pool.control-service.d.ts +70 -70
  355. package/build/_modules/local-vector-search/_services/lvs-vector-pool.control-service.js +181 -181
  356. package/build/_modules/local-vector-search/index.d.ts +8 -8
  357. package/build/_modules/local-vector-search/index.js +15 -15
  358. package/build/_modules/logs/_models/file-log-entry.interface.d.ts +13 -13
  359. package/build/_modules/logs/_models/file-log-entry.interface.js +2 -2
  360. package/build/_modules/logs/_models/file-log-read-result.interface.d.ts +35 -35
  361. package/build/_modules/logs/_models/file-log-read-result.interface.js +2 -2
  362. package/build/_modules/logs/file-log.service.d.ts +132 -132
  363. package/build/_modules/logs/file-log.service.js +444 -444
  364. package/build/_modules/logs/file-logs.controller.d.ts +40 -40
  365. package/build/_modules/logs/file-logs.controller.js +138 -138
  366. package/build/_modules/logs/get-file-logs-routing-module.util.d.ts +31 -31
  367. package/build/_modules/logs/get-file-logs-routing-module.util.js +37 -37
  368. package/build/_modules/logs/get-logs-routing-module.util.d.ts +18 -18
  369. package/build/_modules/logs/get-logs-routing-module.util.js +31 -31
  370. package/build/_modules/logs/index.d.ts +8 -8
  371. package/build/_modules/logs/index.js +15 -15
  372. package/build/_modules/logs/log-buffer.service.d.ts +37 -37
  373. package/build/_modules/logs/log-buffer.service.js +96 -96
  374. package/build/_modules/logs/logs.controller.d.ts +26 -26
  375. package/build/_modules/logs/logs.controller.js +89 -89
  376. package/build/_modules/logs/logs.service.d.ts +39 -39
  377. package/build/_modules/logs/logs.service.js +96 -96
  378. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts +108 -108
  379. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js +13 -13
  380. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts +70 -70
  381. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js +98 -98
  382. package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts +56 -56
  383. package/build/_modules/mcp/_services/dynts-mcp.adapter.js +138 -138
  384. package/build/_modules/mcp/index.d.ts +3 -3
  385. package/build/_modules/mcp/index.js +12 -12
  386. package/build/_modules/messaging/_collections/get-messaging-routing-module.util.d.ts +7 -7
  387. package/build/_modules/messaging/_collections/get-messaging-routing-module.util.js +20 -20
  388. package/build/_modules/messaging/_collections/msg-global-settings.const.d.ts +5 -5
  389. package/build/_modules/messaging/_collections/msg-global-settings.const.js +22 -22
  390. package/build/_modules/messaging/_collections/msg.util.d.ts +24 -24
  391. package/build/_modules/messaging/_collections/msg.util.js +62 -62
  392. package/build/_modules/messaging/_models/msg-global-settings.interface.d.ts +28 -28
  393. package/build/_modules/messaging/_models/msg-global-settings.interface.js +2 -2
  394. package/build/_modules/messaging/_services/msg-conversation.data-service.d.ts +28 -28
  395. package/build/_modules/messaging/_services/msg-conversation.data-service.js +109 -109
  396. package/build/_modules/messaging/_services/msg-events.service.d.ts +61 -61
  397. package/build/_modules/messaging/_services/msg-events.service.js +203 -203
  398. package/build/_modules/messaging/_services/msg-integration.control-service.js +180 -180
  399. package/build/_modules/messaging/_services/msg-main.control-service.d.ts +62 -62
  400. package/build/_modules/messaging/_services/msg-main.control-service.js +428 -428
  401. package/build/_modules/messaging/_services/msg-message.data-service.d.ts +28 -28
  402. package/build/_modules/messaging/_services/msg-message.data-service.js +103 -103
  403. package/build/_modules/messaging/_services/msg.controller.d.ts +12 -12
  404. package/build/_modules/messaging/_services/msg.controller.js +256 -256
  405. package/build/_modules/messaging/index.d.ts +10 -10
  406. package/build/_modules/messaging/index.js +27 -27
  407. package/build/_modules/mock/app-extended-server.mock.d.ts +41 -41
  408. package/build/_modules/mock/app-extended-server.mock.js +169 -169
  409. package/build/_modules/mock/app-integration-test.mock.d.ts +19 -19
  410. package/build/_modules/mock/app-integration-test.mock.js +45 -45
  411. package/build/_modules/mock/app-params.mock.d.ts +2 -2
  412. package/build/_modules/mock/app-params.mock.js +9 -9
  413. package/build/_modules/mock/app-server.mock.d.ts +41 -41
  414. package/build/_modules/mock/app-server.mock.js +148 -148
  415. package/build/_modules/mock/auth-service.mock.d.ts +10 -10
  416. package/build/_modules/mock/auth-service.mock.js +19 -19
  417. package/build/_modules/mock/controller.mock.d.ts +5 -5
  418. package/build/_modules/mock/controller.mock.js +14 -14
  419. package/build/_modules/mock/data-model.mock.d.ts +26 -26
  420. package/build/_modules/mock/data-model.mock.js +72 -72
  421. package/build/_modules/mock/email-service-collection.mock.d.ts +7 -7
  422. package/build/_modules/mock/email-service-collection.mock.js +12 -12
  423. package/build/_modules/mock/email-service.mock.d.ts +4 -4
  424. package/build/_modules/mock/email-service.mock.js +20 -20
  425. package/build/_modules/mock/endpoint.mock.d.ts +8 -8
  426. package/build/_modules/mock/endpoint.mock.js +79 -79
  427. package/build/_modules/mock/socket-client.mock.d.ts +9 -9
  428. package/build/_modules/mock/socket-client.mock.js +38 -38
  429. package/build/_modules/mock/socket-server.mock.d.ts +15 -15
  430. package/build/_modules/mock/socket-server.mock.js +32 -32
  431. package/build/_modules/oauth2/_routes/oauth2.controller.d.ts +16 -16
  432. package/build/_modules/oauth2/_routes/oauth2.controller.js +96 -96
  433. package/build/_modules/oauth2/_services/oauth2.auth-service.d.ts +30 -30
  434. package/build/_modules/oauth2/_services/oauth2.auth-service.js +215 -215
  435. package/build/_modules/oauth2/_services/oauth2.control-service.d.ts +132 -132
  436. package/build/_modules/oauth2/_services/oauth2.control-service.js +576 -576
  437. package/build/_modules/oauth2/index.d.ts +3 -3
  438. package/build/_modules/oauth2/index.js +14 -14
  439. package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts +61 -61
  440. package/build/_modules/rate-limit/_models/rate-limit-config.interface.js +2 -2
  441. package/build/_modules/rate-limit/_models/rate-limit-policy.interface.d.ts +15 -15
  442. package/build/_modules/rate-limit/_models/rate-limit-policy.interface.js +2 -2
  443. package/build/_modules/rate-limit/index.d.ts +3 -3
  444. package/build/_modules/rate-limit/index.js +5 -5
  445. package/build/_modules/rate-limit/rate-limit.middleware.d.ts +132 -132
  446. package/build/_modules/rate-limit/rate-limit.middleware.js +289 -289
  447. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts +18 -18
  448. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js +22 -22
  449. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts +43 -43
  450. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js +67 -67
  451. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts +88 -88
  452. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js +11 -11
  453. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.d.ts +83 -83
  454. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.js +219 -219
  455. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.d.ts +53 -53
  456. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.js +75 -75
  457. package/build/_modules/scoped-config/index.d.ts +5 -5
  458. package/build/_modules/scoped-config/index.js +14 -14
  459. package/build/_modules/server/errors/errors.control-service.d.ts +21 -19
  460. package/build/_modules/server/errors/errors.control-service.d.ts.map +1 -1
  461. package/build/_modules/server/errors/errors.control-service.js +10 -10
  462. package/build/_modules/server/errors/errors.control-service.js.map +1 -1
  463. package/build/_modules/server/errors/errors.controller.d.ts +100 -99
  464. package/build/_modules/server/errors/errors.controller.d.ts.map +1 -1
  465. package/build/_modules/server/errors/errors.controller.js +355 -313
  466. package/build/_modules/server/errors/errors.controller.js.map +1 -1
  467. package/build/_modules/server/errors/errors.data-service.d.ts +64 -47
  468. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  469. package/build/_modules/server/errors/errors.data-service.js +628 -552
  470. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  471. package/build/_modules/server/index.d.ts +7 -7
  472. package/build/_modules/server/index.js +26 -26
  473. package/build/_modules/server/server-status/server-status-snapshot.control-service.d.ts +4 -4
  474. package/build/_modules/server/server-status/server-status-snapshot.control-service.js +7 -7
  475. package/build/_modules/server/server-status/server-status-snapshot.data-service.d.ts +6 -6
  476. package/build/_modules/server/server-status/server-status-snapshot.data-service.js +22 -22
  477. package/build/_modules/server/server-status/server-status.control-service.d.ts +74 -74
  478. package/build/_modules/server/server-status/server-status.control-service.js +234 -234
  479. package/build/_modules/server/server-status/server-status.controller.d.ts +84 -84
  480. package/build/_modules/server/server-status/server-status.controller.js +172 -172
  481. package/build/_modules/socket/_enums/socket-security.enum.d.ts +10 -10
  482. package/build/_modules/socket/_enums/socket-security.enum.js +14 -14
  483. package/build/_modules/socket/_models/socket-client-service-params.control-model.d.ts +8 -8
  484. package/build/_modules/socket/_models/socket-client-service-params.control-model.js +16 -16
  485. package/build/_modules/socket/_models/socket-presence.control-model.d.ts +25 -25
  486. package/build/_modules/socket/_models/socket-presence.control-model.js +139 -139
  487. package/build/_modules/socket/_models/socket-server-service-params.control-model.d.ts +12 -12
  488. package/build/_modules/socket/_models/socket-server-service-params.control-model.js +20 -20
  489. package/build/_modules/socket/_services/socket-client.service.d.ts +37 -37
  490. package/build/_modules/socket/_services/socket-client.service.js +196 -196
  491. package/build/_modules/socket/_services/socket-server.service.d.ts +94 -94
  492. package/build/_modules/socket/_services/socket-server.service.js +689 -689
  493. package/build/_modules/socket/app-extended.server.d.ts +145 -145
  494. package/build/_modules/socket/app-extended.server.js +506 -506
  495. package/build/_modules/socket/index.d.ts +8 -8
  496. package/build/_modules/socket/index.js +35 -35
  497. package/build/_modules/test/get-test-routing-module.util.d.ts +3 -3
  498. package/build/_modules/test/get-test-routing-module.util.js +16 -16
  499. package/build/_modules/test/index.d.ts +3 -3
  500. package/build/_modules/test/index.js +11 -11
  501. package/build/_modules/test/test.controller.d.ts +5 -5
  502. package/build/_modules/test/test.controller.js +103 -103
  503. package/build/_modules/usage/get-usage-routing-module.util.d.ts +3 -3
  504. package/build/_modules/usage/get-usage-routing-module.util.js +16 -16
  505. package/build/_modules/usage/index.d.ts +4 -4
  506. package/build/_modules/usage/index.js +13 -13
  507. package/build/_modules/usage/usage.controller.d.ts +6 -6
  508. package/build/_modules/usage/usage.controller.js +95 -95
  509. package/build/_modules/usage/usage.data-service.d.ts +17 -17
  510. package/build/_modules/usage/usage.data-service.js +135 -135
  511. package/build/_services/base/api.service-base.d.ts +9 -9
  512. package/build/_services/base/api.service-base.js +46 -46
  513. package/build/_services/base/archive-data.service.d.ts +25 -25
  514. package/build/_services/base/archive-data.service.js +140 -140
  515. package/build/_services/base/data.service.d.ts +381 -381
  516. package/build/_services/base/data.service.js +2068 -2068
  517. package/build/_services/base/db.service.d.ts +393 -393
  518. package/build/_services/base/db.service.js +1256 -1256
  519. package/build/_services/base/singleton.service-base.d.ts +8 -8
  520. package/build/_services/base/singleton.service-base.js +21 -21
  521. package/build/_services/base/singleton.service.d.ts +11 -11
  522. package/build/_services/base/singleton.service.js +31 -31
  523. package/build/_services/core/api.service.d.ts +45 -45
  524. package/build/_services/core/api.service.js +436 -436
  525. package/build/_services/core/auth.service.d.ts +129 -129
  526. package/build/_services/core/auth.service.js +59 -59
  527. package/build/_services/core/email.service.d.ts +77 -77
  528. package/build/_services/core/email.service.js +489 -489
  529. package/build/_services/core/global.service.d.ts +76 -76
  530. package/build/_services/core/global.service.js +370 -370
  531. package/build/_services/core/memory-guard.service.d.ts +110 -110
  532. package/build/_services/core/memory-guard.service.js +197 -197
  533. package/build/_services/core/service-collection.service.d.ts +4 -4
  534. package/build/_services/core/service-collection.service.js +7 -7
  535. package/build/_services/route/controller.service.d.ts +124 -124
  536. package/build/_services/route/controller.service.js +95 -95
  537. package/build/_services/route/routing-module.service.d.ts +80 -80
  538. package/build/_services/route/routing-module.service.js +250 -250
  539. package/build/_services/server/app.server.d.ts +352 -352
  540. package/build/_services/server/app.server.js +1323 -1323
  541. package/build/_services/shared.static-service.d.ts +36 -36
  542. package/build/_services/shared.static-service.js +72 -72
  543. package/build/index.d.ts +43 -43
  544. package/build/index.js +80 -80
  545. package/eslint.config.js +3 -3
  546. package/nodemon.json +24 -24
  547. package/package.json +416 -417
  548. package/pnpm-workspace.yaml +5 -5
  549. package/scripts/run-coverage-tests.js +28 -28
  550. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  551. package/spec/support/helpers/ts-node-helper.js +93 -93
  552. package/spec/support/jasmine.coverage.json +24 -24
  553. package/spec/support/jasmine.json +24 -24
  554. package/src/_collections/archive.util.spec.ts +57 -57
  555. package/src/_collections/archive.util.ts +18 -18
  556. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  557. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  558. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  559. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  560. package/src/_collections/default-not-found-page.const.ts +22 -22
  561. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  562. package/src/_collections/default-socket-path.const.ts +2 -2
  563. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  564. package/src/_collections/get-environment-settings.util.ts +48 -48
  565. package/src/_collections/global-settings.const.ts +89 -89
  566. package/src/_collections/mongo-reconnect-guard.util.spec.ts +52 -52
  567. package/src/_collections/mongo-reconnect-guard.util.ts +172 -172
  568. package/src/_collections/sample.env +21 -21
  569. package/src/_collections/star.controller.spec.ts +224 -224
  570. package/src/_collections/star.controller.ts +129 -129
  571. package/src/_enums/data-model-type.enum.ts +14 -14
  572. package/src/_enums/data-service-function.enum.ts +24 -24
  573. package/src/_enums/predefined-data-types.enum.ts +16 -16
  574. package/src/_enums/route-security.enum.ts +12 -12
  575. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  576. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  577. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  578. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  579. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  580. package/src/_models/control-models/app-params.control-model.ts +136 -136
  581. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  582. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  583. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  584. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  585. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  586. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  587. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  588. package/src/_models/control-models/system-control.control-model.ts +12 -12
  589. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  590. package/src/_models/interfaces/compare-data-options.interface.ts +27 -27
  591. package/src/_models/interfaces/compare-data-result.interface.ts +12 -12
  592. package/src/_models/interfaces/cors-settings.interface.spec.ts +52 -52
  593. package/src/_models/interfaces/cors-settings.interface.ts +56 -56
  594. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  595. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  596. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  597. package/src/_models/interfaces/global-settings.interface.ts +185 -185
  598. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  599. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  600. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  601. package/src/_models/types/db-update.type.ts +100 -100
  602. package/src/_modules/admin-auth/_models/admin-api-key-config.interface.ts +33 -33
  603. package/src/_modules/admin-auth/admin-api-key.auth-service.spec.ts +200 -200
  604. package/src/_modules/admin-auth/admin-api-key.auth-service.ts +220 -220
  605. package/src/_modules/admin-auth/index.ts +2 -2
  606. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  607. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  608. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts +14 -14
  609. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts +56 -56
  610. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  611. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  612. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  613. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  614. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  615. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +552 -552
  616. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  617. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  618. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  619. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  620. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  621. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  622. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  623. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  624. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  625. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  626. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  627. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  628. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  629. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  630. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  631. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  632. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  633. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  634. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  635. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  636. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  637. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.ts +572 -572
  638. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  639. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.ts +435 -435
  640. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  641. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  642. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  643. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +132 -132
  644. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  645. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  646. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  647. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  648. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  649. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  650. package/src/_modules/ai/_modules/open-ai/index.ts +74 -74
  651. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  652. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +233 -233
  653. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  654. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  655. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  656. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  657. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  658. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  659. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  660. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  661. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  662. package/src/_modules/ai/_services/ai-provider.service-base.ts +67 -67
  663. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  664. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  665. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +399 -399
  666. package/src/_modules/ai/index.ts +23 -23
  667. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  668. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  669. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  670. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  671. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  672. package/src/_modules/assistant/_services/ass-io.control-service.ts +74 -74
  673. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  674. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  675. package/src/_modules/assistant/index.ts +19 -19
  676. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  677. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  678. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  679. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  680. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  681. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  682. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  683. package/src/_modules/bot/_models/bot-message-wrapper.interface.ts +90 -90
  684. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  685. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  686. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  687. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.ts +641 -641
  688. package/src/_modules/bot/_modules/discord-bot/index.ts +12 -12
  689. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  690. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  691. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  692. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  693. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  694. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  695. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  696. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  697. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  698. package/src/_modules/bot/_modules/slack-bot/index.ts +12 -12
  699. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  700. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  701. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  702. package/src/_modules/bot/_modules/teams-bot/index.ts +11 -11
  703. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  704. package/src/_modules/bot/_services/bot-commands.control-service.ts +158 -158
  705. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  706. package/src/_modules/bot/_services/bot-io.control-service.ts +329 -329
  707. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  708. package/src/_modules/bot/_services/bot-main.control-service.ts +489 -489
  709. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  710. package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts +158 -158
  711. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  712. package/src/_modules/bot/_services/bot-routines.control-service.ts +78 -78
  713. package/src/_modules/bot/index.ts +37 -37
  714. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  715. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  716. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  717. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  718. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  719. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  720. package/src/_modules/custom-data/index.ts +9 -9
  721. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +176 -176
  722. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  723. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  724. package/src/_modules/data-readers/index.ts +11 -11
  725. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  726. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  727. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  728. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  729. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  730. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  731. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  732. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  733. package/src/_modules/defaults/index.ts +17 -17
  734. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  735. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  736. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  737. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  738. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  739. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  740. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  741. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  742. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  743. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  744. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  745. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  746. package/src/_modules/discord-assistant/index.ts +38 -38
  747. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  748. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  749. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  750. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  751. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  752. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  753. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  754. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  755. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  756. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  757. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  758. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  759. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  760. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  761. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  762. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  763. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  764. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  765. package/src/_modules/discord-bot/_services/dibo-routines.control-service.ts +97 -97
  766. package/src/_modules/discord-bot/index.ts +36 -36
  767. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  768. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +60 -60
  769. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  770. package/src/_modules/local-vector-search/_services/lvs-bm25.util.spec.ts +159 -159
  771. package/src/_modules/local-vector-search/_services/lvs-bm25.util.ts +206 -206
  772. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  773. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  774. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  775. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  776. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  777. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +150 -150
  778. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  779. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +108 -108
  780. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  781. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  782. package/src/_modules/local-vector-search/index.ts +16 -16
  783. package/src/_modules/logs/_models/file-log-entry.interface.ts +13 -13
  784. package/src/_modules/logs/_models/file-log-read-result.interface.ts +37 -37
  785. package/src/_modules/logs/file-log.service.spec.ts +341 -341
  786. package/src/_modules/logs/file-log.service.ts +466 -466
  787. package/src/_modules/logs/file-logs.controller.spec.ts +245 -245
  788. package/src/_modules/logs/file-logs.controller.ts +165 -165
  789. package/src/_modules/logs/get-file-logs-routing-module.util.ts +51 -51
  790. package/src/_modules/logs/get-logs-routing-module.util.ts +36 -36
  791. package/src/_modules/logs/index.ts +11 -11
  792. package/src/_modules/logs/log-buffer.service.ts +101 -101
  793. package/src/_modules/logs/logs.controller.ts +109 -109
  794. package/src/_modules/logs/logs.service.ts +100 -100
  795. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  796. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +151 -151
  797. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +125 -125
  798. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  799. package/src/_modules/mcp/index.ts +13 -13
  800. package/src/_modules/messaging/README.md +354 -354
  801. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  802. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  803. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  804. package/src/_modules/messaging/_collections/msg.util.ts +83 -83
  805. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  806. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  807. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  808. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  809. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  810. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  811. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  812. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  813. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  814. package/src/_modules/messaging/_services/msg.controller.ts +370 -370
  815. package/src/_modules/messaging/index.ts +30 -30
  816. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  817. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  818. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  819. package/src/_modules/mock/app-params.mock.ts +9 -9
  820. package/src/_modules/mock/app-server.mock.ts +188 -188
  821. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  822. package/src/_modules/mock/auth-service.mock.ts +28 -28
  823. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  824. package/src/_modules/mock/controller.mock.ts +16 -16
  825. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  826. package/src/_modules/mock/data-model.mock.ts +82 -82
  827. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  828. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  829. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  830. package/src/_modules/mock/email-service.mock.ts +20 -20
  831. package/src/_modules/mock/email-template.mock.html +14 -14
  832. package/src/_modules/mock/endpoint.mock.ts +91 -91
  833. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  834. package/src/_modules/mock/socket-client.mock.ts +45 -45
  835. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  836. package/src/_modules/mock/socket-server.mock.ts +46 -46
  837. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  838. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  839. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  840. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  841. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  842. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  843. package/src/_modules/oauth2/index.ts +17 -17
  844. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +69 -69
  845. package/src/_modules/rate-limit/_models/rate-limit-policy.interface.ts +16 -16
  846. package/src/_modules/rate-limit/index.ts +3 -3
  847. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +264 -264
  848. package/src/_modules/rate-limit/rate-limit.middleware.ts +343 -343
  849. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  850. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +82 -82
  851. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  852. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +312 -312
  853. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +311 -311
  854. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +123 -123
  855. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +108 -108
  856. package/src/_modules/scoped-config/index.ts +17 -17
  857. package/src/_modules/server/errors/errors.control-service.spec.ts +246 -238
  858. package/src/_modules/server/errors/errors.control-service.ts +100 -85
  859. package/src/_modules/server/errors/errors.controller.spec.ts +249 -241
  860. package/src/_modules/server/errors/errors.controller.ts +489 -431
  861. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -361
  862. package/src/_modules/server/errors/errors.data-service.ts +816 -722
  863. package/src/_modules/server/index.ts +30 -30
  864. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  865. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  866. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  867. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  868. package/src/_modules/server/server-status/server-status.control-service.spec.ts +584 -576
  869. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  870. package/src/_modules/server/server-status/server-status.controller.spec.ts +248 -240
  871. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  872. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  873. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  874. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  875. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  876. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  877. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  878. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  879. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  880. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  881. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  882. package/src/_modules/socket/_services/socket-server.service.ts +1068 -1068
  883. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  884. package/src/_modules/socket/app-extended.server.ts +630 -630
  885. package/src/_modules/socket/index.ts +42 -42
  886. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  887. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  888. package/src/_modules/test/index.ts +11 -11
  889. package/src/_modules/test/test.controller.spec.ts +72 -72
  890. package/src/_modules/test/test.controller.ts +115 -115
  891. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  892. package/src/_modules/usage/index.ts +15 -15
  893. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  894. package/src/_modules/usage/usage.controller.ts +126 -126
  895. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  896. package/src/_modules/usage/usage.data-service.ts +185 -185
  897. package/src/_services/base/api.service-base.spec.ts +125 -125
  898. package/src/_services/base/api.service-base.ts +74 -74
  899. package/src/_services/base/archive-data.service.spec.ts +196 -196
  900. package/src/_services/base/archive-data.service.ts +216 -216
  901. package/src/_services/base/data.service.spec.ts +674 -674
  902. package/src/_services/base/data.service.ts +2719 -2719
  903. package/src/_services/base/db.service.spec.ts +73 -73
  904. package/src/_services/base/db.service.ts +1575 -1575
  905. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  906. package/src/_services/base/singleton.service-base.ts +24 -24
  907. package/src/_services/base/singleton.service.spec.ts +114 -114
  908. package/src/_services/base/singleton.service.ts +38 -38
  909. package/src/_services/core/api.service.spec.ts +140 -140
  910. package/src/_services/core/api.service.ts +607 -607
  911. package/src/_services/core/auth.service.spec.ts +159 -159
  912. package/src/_services/core/auth.service.ts +174 -174
  913. package/src/_services/core/email.service.spec.ts +85 -85
  914. package/src/_services/core/email.service.ts +742 -742
  915. package/src/_services/core/global.service.spec.ts +292 -292
  916. package/src/_services/core/global.service.ts +475 -475
  917. package/src/_services/core/memory-guard.service.spec.ts +165 -165
  918. package/src/_services/core/memory-guard.service.ts +281 -281
  919. package/src/_services/core/service-collection.service.spec.ts +46 -46
  920. package/src/_services/core/service-collection.service.ts +6 -6
  921. package/src/_services/route/controller.service.spec.ts +53 -53
  922. package/src/_services/route/controller.service.ts +148 -148
  923. package/src/_services/route/routing-module.service.spec.ts +98 -98
  924. package/src/_services/route/routing-module.service.ts +330 -330
  925. package/src/_services/server/app.server.ts +1747 -1747
  926. package/src/_services/shared.static-service.spec.ts +99 -99
  927. package/src/_services/shared.static-service.ts +78 -78
  928. package/src/index.ts +96 -96
  929. package/tsconfig.app.json +12 -12
  930. package/tsconfig.json +42 -42
  931. package/.dynamo/logs/cicd-pipeline/output.log +0 -2857
  932. package/.dynamo/logs/cicd-pipeline/status.json +0 -94
@@ -1,641 +1,641 @@
1
- import { Client, GatewayIntentBits, Guild, Collection, GuildMember, Message, Partials, Role, TextChannel, Channel, DMChannel } from 'discord.js';
2
- import { DyFM_AnyError, DyFM_Array, DyFM_Error, DyFM_Log, week } from '@futdevpro/fsm-dynamo';
3
- import { DyNTS_Bot_MessagingProvider_ServiceBase, DyNTS_Bot_MessagingProvider_Config } from '../../../_services/bot-messaging-provider.service-base';
4
- import { DyNTS_Bot_LastMessageDate } from '../../../_models/bot-last-message-date.interface';
5
- import { DyNTS_Bot_LastMentionDate } from '../../../_models/bot-last-mention-date.interface';
6
- import { DyFM_Msg_Provider_Type } from '@futdevpro/fsm-dynamo/messaging';
7
- import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
8
- import { DyNTS_Bot_ChannelWrapper } from '../../../_models/bot-channel-wrapper.interface';
9
- import { DyNTS_Bot_MessageWrapper } from '../../../_models/bot-message-wrapper.interface';
10
- import { DyNTS_Bot_UserWrapper } from '../../../_models/bot-user-wrapper.interface';
11
-
12
- export type DyNTS_DiB_Message = DyNTS_Bot_MessageWrapper<Message>;
13
- export type DyNTS_DiB_Channel = DyNTS_Bot_ChannelWrapper<Channel>;
14
- export type DyNTS_DiB_User = DyNTS_Bot_UserWrapper<GuildMember>;
15
-
16
- export interface Discord_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config {
17
- token: string;
18
- guildId: string;
19
- clientId: string;
20
- oauth2Url: string;
21
- intents: GatewayIntentBits[];
22
- partials: Partials[];
23
- }
24
-
25
- export class DyNTS_DiB_MessagingProvider_ControlService extends DyNTS_Bot_MessagingProvider_ServiceBase<
26
- Channel,
27
- Message,
28
- GuildMember,
29
- Discord_MessagingProviderConfig,
30
- Role
31
- > {
32
- readonly name = 'discord';
33
- readonly type = DyFM_Msg_Provider_Type.discord;
34
-
35
- get botId(): string {
36
- return this.client.user?.id;
37
- }
38
-
39
- get botDisplayName(): string {
40
- return this.client.user?.displayName;
41
- }
42
-
43
- override readonly config: Discord_MessagingProviderConfig;
44
-
45
- private client: Client;
46
- private guild: Guild;
47
-
48
- constructor(
49
- setConfig: Discord_MessagingProviderConfig
50
- ) {
51
- super();
52
-
53
- this.config = setConfig;
54
- }
55
-
56
- // Public accessors for Discord-specific objects (for backward compatibility with CCAP)
57
- get discordClient(): Client {
58
- return this.client;
59
- }
60
-
61
- get discordGuild(): Guild {
62
- return this.guild;
63
- }
64
-
65
- async setup(issuer: string): Promise<void> {
66
- try {
67
- this.client = new Client({
68
- intents: this.config.intents,
69
- partials: this.config.partials,
70
- });
71
-
72
- } catch (error) {
73
- DyFM_Error.logSimple('Error during Discord bot setup:', error);
74
-
75
- throw new DyFM_Error({
76
- ...this.getDefaultErrorSettings('setup', error, issuer),
77
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S000`,
78
- });
79
- }
80
- }
81
-
82
- async start(issuer: string): Promise<void> {
83
- try {
84
- if (!this.client) {
85
- throw new Error('Discord client not initialized. Call setup() first.');
86
- }
87
-
88
- return new Promise((resolve, reject) => {
89
- this.client.on('ready', async () => {
90
- if (DyNTS_global_settings.bot_settings?.debugLevel >= 1) {
91
- DyFM_Log.success(`Discord bot logged in as ${this.client.user?.tag}`);
92
- }
93
-
94
- // Get guild
95
- this.guild = this.client.guilds.cache.get(this.config.guildId);
96
- if (!this.guild) {
97
- reject(new Error(`Discord server not found with ID: ${this.config.guildId}`));
98
- return;
99
- }
100
-
101
- resolve();
102
- });
103
-
104
- this.client.login(this.config.token).catch(reject);
105
- });
106
- } catch (error) {
107
- DyFM_Error.logSimple('Error during Discord bot start:', error);
108
-
109
- throw new DyFM_Error({
110
- ...this.getDefaultErrorSettings('start', error, issuer),
111
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S001`,
112
- });
113
- }
114
- }
115
-
116
- async getChannelByName(name: string): Promise<DyNTS_DiB_Channel> {
117
- if (this.channelCache.has(name)) {
118
- return await this.wrapChannel(this.channelCache.get(name));
119
- }
120
-
121
- const channel = this.guild.channels.cache.find(
122
- (ch) => ch.name === name && ch.isTextBased()
123
- ) as TextChannel;
124
-
125
- if (!channel) {
126
- throw new Error(`No text channel found with name "${name}"`);
127
- }
128
-
129
- this.channelCache.set(name, channel);
130
- return await this.wrapChannel(channel);
131
- }
132
-
133
- async getChannelById(id: string): Promise<DyNTS_DiB_Channel> {
134
- const channel = this.guild.channels.cache.get(id) as TextChannel;
135
- if (!channel) {
136
- throw new Error(`No text channel found with ID "${id}"`);
137
- }
138
-
139
- if (!this.channelCache.has(channel.name)) {
140
- this.channelCache.set(channel.name, channel);
141
- }
142
- return await this.wrapChannel(channel);
143
- }
144
-
145
- async sendMessageToChannelByName(channelName: string, message: string): Promise<DyNTS_DiB_Message> {
146
- const discordChannel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
147
-
148
- return await this.sendMessageToChannel(discordChannel, message);
149
-
150
- /* if (!discordChannel) {
151
- throw new Error(`No text channel found with name "${channelName}"`);
152
- }
153
-
154
- if (!discordChannel.rawPlatformChannel.isTextBased()) {
155
- throw new Error(`Channel "${channelName}" is not a text channel`);
156
- }
157
-
158
- //const sentMessage: Message = await (discordChannel.rawPlatformChannel as TextChannel).send(message);
159
- const channel: TextChannel = discordChannel.rawPlatformChannel as TextChannel;
160
-
161
- let firstMessage: Message;
162
- const originalMessage: string = message;
163
- if (message.length > 2_000) { // 2000 characters per message
164
- while (message.length) {
165
- if (!firstMessage) {
166
- firstMessage = await channel.send(message.substring(0, 2_000));
167
- } else {
168
- await channel.send(message.substring(0, 2_000));
169
- }
170
-
171
- message = message.substring(2_000);
172
- }
173
-
174
- firstMessage.content = originalMessage;
175
- return this.wrapMessage(firstMessage);
176
- } else {
177
- const messageSent: Message = await channel.send(message);
178
- return this.wrapMessage(messageSent);
179
- } */
180
- }
181
-
182
- async getMessagesFromChannelByChannelName(channelName: string, limit: number = 100): Promise<DyNTS_DiB_Message[]> {
183
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
184
-
185
- if (!channel.rawPlatformChannel.isTextBased()) {
186
- throw new Error(`Channel "${channelName}" is not a text channel`);
187
- }
188
-
189
- const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
190
- limit: limit
191
- });
192
-
193
- return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
194
- }
195
-
196
- async getLastMessageInChannel(channelName: string): Promise<DyNTS_DiB_Message> {
197
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
198
-
199
- if (!channel.rawPlatformChannel.isTextBased()) {
200
- throw new Error(`Channel "${channelName}" is not a text channel`);
201
- }
202
-
203
- const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
204
- limit: 1
205
- });
206
- const lastMessage: Message = messages.first();
207
-
208
- return lastMessage ? await this.wrapMessage(lastMessage) : null;
209
- }
210
-
211
- async clearChannel(channel: DyNTS_DiB_Channel): Promise<void> {
212
- if (!channel.rawPlatformChannel.isTextBased()) {
213
- throw new Error(`Channel "${channel.name}" is not a text channel`);
214
- }
215
-
216
- let lastId: string | undefined = undefined;
217
- let fetched: number = 0;
218
- const maxFetch: number = 1000;
219
-
220
- while (fetched < maxFetch) {
221
- const options: { limit: number; before?: string } = { limit: 100 };
222
- if (lastId) {
223
- options.before = lastId;
224
- }
225
-
226
- const messageCollection: Collection<string, Message> = await channel.rawPlatformChannel.messages.fetch(options);
227
- if (messageCollection.size === 0) {
228
- break;
229
- }
230
-
231
- const deletePromises = Array.from(messageCollection.values()).map((message: Message) =>
232
- message.delete().catch((error) => {
233
- DyFM_Error.logSimple('Failed to delete message', error);
234
- })
235
- );
236
-
237
- await Promise.all(deletePromises);
238
- lastId = Array.from(messageCollection.values()).pop()?.id;
239
- fetched += messageCollection.size;
240
- }
241
- }
242
-
243
- // Message operations
244
- async sendMessageToChannel(channel: DyNTS_DiB_Channel, content: string): Promise<DyNTS_DiB_Message> {
245
- if (!channel.rawPlatformChannel.isTextBased()) {
246
- throw new Error(`Channel "${channel.name}" is not a text channel`);
247
- }
248
- const discordTextChannel: TextChannel = channel.rawPlatformChannel as TextChannel;
249
-
250
- const originalContent: string = content;
251
-
252
- let firstMessage: Message;
253
- if (content.length > 2_000) { // 2000 characters per message
254
- while (content.length) {
255
- if (!firstMessage) {
256
- firstMessage = await discordTextChannel.send(content.substring(0, 2_000));
257
- } else {
258
- await discordTextChannel.send(content.substring(0, 2_000));
259
- }
260
- content = content.substring(2_000);
261
- }
262
-
263
- firstMessage.content = originalContent;
264
- return await this.wrapMessage(firstMessage);
265
- } else {
266
- const message: Message = await discordTextChannel.send(content);
267
- return await this.wrapMessage(message);
268
- }
269
- }
270
-
271
- async replyToMessage(message: DyNTS_DiB_Message, content: string): Promise<DyNTS_DiB_Message> {
272
- try {
273
- /* const channel = this.guild.channels.cache.get(channelId) as TextChannel;
274
- if (!channel) {
275
- throw new Error(`Channel not found with ID: ${channelId}`);
276
- }
277
- const message = await channel.messages.fetch(messageId); */
278
- if (!message.rawPlatformMessage.channel.isTextBased()) {
279
- throw new Error(`Message "${message.id}" is not a text message`);
280
- }
281
-
282
- const originalContent: string = content;
283
- if (content.length > 2_000) {
284
- let firstMessage: Message;
285
-
286
- while (content.length) {
287
- if (!firstMessage) {
288
- firstMessage = await (message.rawPlatformMessage.channel as TextChannel).send(
289
- content.substring(0, 2_000)
290
- );
291
- } else {
292
- await message.reply(content.substring(0, 2_000));
293
- }
294
- content = content.substring(2_000);
295
- }
296
-
297
- firstMessage.content = originalContent;
298
- return await this.wrapMessage(firstMessage);
299
- } else {
300
- const reply: Message= await message.rawPlatformMessage.reply(content);
301
- return await this.wrapMessage(reply);
302
- }
303
- } catch (error) {
304
- DyFM_Error.logSimple('Error replying to message:', error);
305
-
306
- throw new DyFM_Error({
307
- ...this.getDefaultErrorSettings('replyToMessage', error, message.issuer),
308
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S002`,
309
- });
310
- }
311
- }
312
-
313
- async sendTyping(channel: DyNTS_DiB_Channel): Promise<void> {
314
- if (!channel.rawPlatformChannel.isTextBased()) {
315
- throw new Error(`Channel "${channel.name}" is not a text channel`);
316
- }
317
-
318
- await (channel.rawPlatformChannel as TextChannel).sendTyping();
319
- }
320
-
321
- async sendTypingForMessage(message: DyNTS_DiB_Message): Promise<void> {
322
- if (!message.rawPlatformMessage.channel.isTextBased()) {
323
- throw new Error(`Message "${message.id}" is not a text message`);
324
- }
325
-
326
- await (message.rawPlatformMessage.channel as TextChannel).sendTyping();
327
- }
328
-
329
- async fetchMessages(channel: DyNTS_DiB_Channel, limit: number): Promise<DyNTS_DiB_Message[]> {
330
- if (!channel.rawPlatformChannel.isTextBased()) {
331
- throw new Error(`Channel "${channel.name}" is not a text channel`);
332
- }
333
-
334
- const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
335
- limit: limit
336
- });
337
- return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
338
- }
339
-
340
- async fetchMessagesById(id: string, limit: number): Promise<DyNTS_DiB_Message[]> {
341
- const channel: DyNTS_DiB_Channel = await this.getChannelById(id);
342
- return this.fetchMessages(channel, limit);
343
- }
344
-
345
- async fetchMessagesForMessage(message: DyNTS_DiB_Message, limit: number): Promise<DyNTS_DiB_Message[]> {
346
- if (!message.rawPlatformMessage.channel.isTextBased()) {
347
- throw new Error(`Message "${message.id}" is not a text message`);
348
- }
349
-
350
- const messages: Collection<string, Message> = await message.rawPlatformMessage.channel.messages.fetch({
351
- limit: limit
352
- });
353
- return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
354
- }
355
-
356
- async fetchAllMessagesWithPaging(channel: DyNTS_DiB_Channel, maxFetch: number = 1000): Promise<DyNTS_DiB_Message[]> {
357
- if (!channel.rawPlatformChannel.isTextBased()) {
358
- throw new Error(`Channel "${channel.name}" is not a text channel`);
359
- }
360
-
361
- let lastId: string | undefined = undefined;
362
- let fetched: number = 0;
363
- const allMessages: DyNTS_DiB_Message[] = [];
364
-
365
- while (fetched < maxFetch) {
366
- const options: { limit: number; before?: string } = { limit: 100 };
367
- if (lastId) options.before = lastId;
368
-
369
- const messageCollection: Collection<string, Message> = await channel.rawPlatformChannel.messages.fetch(options);
370
- if (messageCollection.size === 0) break;
371
-
372
- await DyFM_Array.asyncForEach(
373
- Array.from(messageCollection.values()),
374
- async (msg: Message) => {
375
- allMessages.push(await this.wrapMessage(msg));
376
- }
377
- );
378
-
379
- lastId = Array.from(messageCollection.values()).pop()?.id;
380
- fetched += messageCollection.size;
381
- }
382
-
383
- return allMessages;
384
- }
385
-
386
- async deleteMessage(message: DyNTS_DiB_Message): Promise<void> {
387
- await message.rawPlatformMessage.delete();
388
- }
389
-
390
- // User operations
391
- async updateMessage(message: Message, issuer: string): Promise<void> {
392
- throw new Error('Discord provider not yet implemented');
393
- }
394
-
395
- async getUserByName(username: string): Promise<DyNTS_DiB_User> {
396
- const member: GuildMember = this.guild.members.cache.find((m: GuildMember) => m.user.username === username);
397
-
398
- if (!member) {
399
- throw new Error(`User not found with username: ${username}`);
400
- }
401
-
402
- return await this.wrapUser(member);
403
- }
404
-
405
- getUserMention(userId: string): string {
406
- return `<@${userId}>`;
407
- }
408
-
409
- async readMembersInChannel(channelName: string): Promise<DyNTS_DiB_User[]> {
410
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
411
- const members: Collection<string, GuildMember> = await this.fetchMembersInGuild(this.guild);
412
-
413
- const allowedMembers: Collection<string, GuildMember> = members.filter((member: GuildMember) =>
414
- channel.rawPlatformChannel.isTextBased() &&
415
- (channel.rawPlatformChannel as TextChannel).permissionsFor(member)?.has('ViewChannel')
416
- );
417
-
418
- return await DyFM_Array.asyncMap(
419
- Array.from(allowedMembers.values()),
420
- async (member: GuildMember) => await this.wrapUser(member)
421
- );
422
- }
423
-
424
- async fetchMembersInGuild(guild: Guild): Promise<Collection<string, GuildMember>> {
425
- try {
426
- // Try to fetch with a limit to avoid timeout
427
- return await guild?.members.fetch({ limit: 1000 })
428
- } catch (fetchError: any) {
429
- throw new DyFM_Error({
430
- errorCode: 'DIB-OPS-FMI0',
431
- message: 'Failed to fetch members',
432
- error: fetchError,
433
- })
434
- }
435
- }
436
-
437
- async readMemberNamesInChannel(channelName: string): Promise<string[]> {
438
- const members: DyNTS_DiB_User[] = await this.readMembersInChannel(channelName);
439
- return members.map((member: DyNTS_DiB_User) => member.username);
440
- }
441
-
442
- // Advanced message queries
443
- async getLastMessageSentBy(channelName: string, username: string): Promise<DyNTS_DiB_Message> {
444
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
445
- const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
446
-
447
- return messages.find((msg: DyNTS_DiB_Message) => msg.authorName === username) || null;
448
- }
449
-
450
- async getLastMentionOf(channelName: string, username: string): Promise<DyNTS_DiB_Message> {
451
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
452
- const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
453
-
454
- return messages.find((msg: DyNTS_DiB_Message) =>
455
- msg.content.includes(`@${username}`) ||
456
- msg.content.includes(`<@${username}>`)
457
- ) || null;
458
- }
459
-
460
- // Advanced message queries
461
- async readLastMessageDatesByMembers(channelName: string, memberNames: string[]): Promise<DyNTS_Bot_LastMessageDate[]> {
462
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
463
- const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
464
-
465
- const memberStatus: Record<string, { lastMessageDate: Date | null, allMessages: number }> = {};
466
- memberNames.forEach((name: string) => {
467
- memberStatus[name] = { lastMessageDate: null, allMessages: 0 };
468
- });
469
-
470
- const cutoffTime: number = Date.now() - (3 * week); // 3 weeks
471
-
472
- messages.forEach((message: DyNTS_DiB_Message) => {
473
- if (message.timestamp < cutoffTime) return;
474
-
475
- const author = message.authorName;
476
- if (memberStatus[author] !== undefined) {
477
- memberStatus[author].allMessages++;
478
- if (!memberStatus[author].lastMessageDate) {
479
- memberStatus[author].lastMessageDate = new Date(message.timestamp);
480
- }
481
- }
482
- });
483
-
484
- return memberNames.map((memberName: string) => {
485
- const status: { lastMessageDate: Date | null, allMessages: number } = memberStatus[memberName];
486
-
487
- return {
488
- memberName: memberName,
489
- allMessages: status.allMessages,
490
- lastMessageDate: status.lastMessageDate
491
- };
492
- });
493
- }
494
-
495
- // Advanced message queries
496
- async readLastMessageWithMemberNamePingInIt(channelName: string, users: DyNTS_DiB_User[]): Promise<DyNTS_Bot_LastMentionDate[]> {
497
- const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
498
- const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
499
-
500
- const memberStatus: Record<string, { lastMentionDate: Date | null, allMentions: number }> = {};
501
- users.forEach((user: DyNTS_DiB_User) => {
502
- memberStatus[user.username] = { lastMentionDate: null, allMentions: 0 };
503
- });
504
-
505
- const cutoffTime: number = Date.now() - (3 * week); // 3 weeks
506
-
507
- messages.forEach((message: DyNTS_DiB_Message) => {
508
- if (message.timestamp < cutoffTime) return;
509
-
510
- users.forEach((user: DyNTS_DiB_User) => {
511
- if (
512
- message.content.includes(`@${user.id}`) &&
513
- !memberStatus[user.username].lastMentionDate
514
- ) {
515
- memberStatus[user.username].lastMentionDate = new Date(message.timestamp);
516
- memberStatus[user.username].allMentions++;
517
- }
518
- });
519
- });
520
-
521
- return users.map((user: DyNTS_DiB_User) => {
522
- const status: { lastMentionDate: Date | null, allMentions: number } = memberStatus[user.username];
523
-
524
- return {
525
- memberId: user.id,
526
- memberName: user.username,
527
- allMentions: status.allMentions,
528
- lastMentionDate: status.lastMentionDate
529
- };
530
- });
531
- }
532
-
533
- // Discord-specific features
534
- getRoleByName(roleName: string): Role {
535
- if (this.roleCache.has(roleName)) {
536
- return this.roleCache.get(roleName);
537
- }
538
-
539
- const role: Role = this.guild.roles.cache.find((r: Role) => r.name === roleName);
540
- if (role) {
541
- this.roleCache.set(roleName, role);
542
- }
543
- return role;
544
- }
545
-
546
- async getRolePingByName(roleName: string): Promise<string> {
547
- const role: Role = this.getRoleByName(roleName);
548
- return role ? `<@&${role.id}>` : '';
549
- }
550
-
551
- async getRolePingsByName(roleNames: string[]): Promise<string> {
552
- const pings: string[] = await Promise.all(
553
- roleNames.map((roleName: string) => this.getRolePingByName(roleName))
554
- );
555
- return pings.join(' ');
556
- }
557
-
558
- async create_onMessageEventListener(handler: (message: DyNTS_DiB_Message, issuer: string) => Promise<void>): Promise<void> {
559
- this.client.on('messageCreate', async (message: Message) => {
560
- await handler(await this.wrapMessage(message), 'discord');
561
- });
562
- }
563
-
564
- create_onErrorEventListener(handler: (error: DyFM_AnyError) => void): void {
565
- this.client.on('error', (error: Error) => {
566
- handler(error);
567
- });
568
- }
569
-
570
- async sendReport(message: string): Promise<DyNTS_DiB_Message> {
571
- return await this.sendMessageToChannelByName(this.config.reportChannelName, message);
572
- }
573
-
574
- async sendReportIn(message: string): Promise<DyNTS_DiB_Message> {
575
- return await this.sendMessageToChannelByName(
576
- this.config.reportChannelName,
577
- `${this.botDisplayName} report for duty! ` +
578
- `(v${DyNTS_global_settings.systemVersion} ${DyNTS_global_settings.env_settings?.environment})`
579
- );
580
- }
581
-
582
- async wrapMessage(message: Message): Promise<DyNTS_DiB_Message> {
583
- let replyTo: Message | null = null;
584
- if (message.reference?.messageId) {
585
- replyTo = message.channel.messages.cache.get(
586
- message.reference.messageId
587
- );
588
- }
589
-
590
- return new DyNTS_Bot_MessageWrapper<Message>({
591
- id: message.id,
592
- content: message.content,
593
- authorId: message.author.id,
594
- authorName: message.author.username,
595
- authorDisplayName: message.author.displayName,
596
- channelId: message.channel.id,
597
- channelName: (message.channel as TextChannel)?.name || 'DM Channel with ' + (message.channel as DMChannel).recipient.username,
598
- timestamp: message.createdTimestamp,
599
- isBot: message.author.bot,
600
- isTextBased: message.channel.isTextBased(),
601
- isVoiceBased: false, /* message.channel.isVoiceBased(), */
602
- isDM: message.channel.isDMBased(),
603
- mentions: Array.from(message.mentions.users.keys()),
604
- replyToMessageId: message.reference?.messageId,
605
- replyToMessageAuthorId: replyTo?.author?.id,
606
- rawPlatformMessage: message,
607
-
608
- issuer: message.author.id,
609
-
610
- channel: await this.wrapChannel(message.channel),
611
- /* user: this.wrapUser(message.author), */
612
-
613
- provider: this,
614
- });
615
- }
616
-
617
- async wrapChannel(channel: Channel): Promise<DyNTS_DiB_Channel> {
618
- return new DyNTS_Bot_ChannelWrapper<Channel>({
619
- id: channel.id,
620
- name: (channel as TextChannel).name || ('DM Channel with ' + (channel as DMChannel).recipient.username),
621
- isTextBased: channel.isTextBased(),
622
- isDM: channel.isDMBased(),
623
- isVoiceBased: channel.isVoiceBased(),
624
- rawPlatformChannel: channel,
625
-
626
- provider: this,
627
- });
628
- }
629
-
630
- async wrapUser(user: GuildMember): Promise<DyNTS_DiB_User> {
631
- return new DyNTS_Bot_UserWrapper<GuildMember>({
632
- id: user.user.id,
633
- username: user.user.username,
634
- displayName: user.displayName,
635
- isBot: user.user.bot,
636
- rawPlatformUser: user,
637
-
638
- provider: this,
639
- });
640
- }
641
- }
1
+ import { Client, GatewayIntentBits, Guild, Collection, GuildMember, Message, Partials, Role, TextChannel, Channel, DMChannel } from 'discord.js';
2
+ import { DyFM_AnyError, DyFM_Array, DyFM_Error, DyFM_Log, week } from '@futdevpro/fsm-dynamo';
3
+ import { DyNTS_Bot_MessagingProvider_ServiceBase, DyNTS_Bot_MessagingProvider_Config } from '../../../_services/bot-messaging-provider.service-base';
4
+ import { DyNTS_Bot_LastMessageDate } from '../../../_models/bot-last-message-date.interface';
5
+ import { DyNTS_Bot_LastMentionDate } from '../../../_models/bot-last-mention-date.interface';
6
+ import { DyFM_Msg_Provider_Type } from '@futdevpro/fsm-dynamo/messaging';
7
+ import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
8
+ import { DyNTS_Bot_ChannelWrapper } from '../../../_models/bot-channel-wrapper.interface';
9
+ import { DyNTS_Bot_MessageWrapper } from '../../../_models/bot-message-wrapper.interface';
10
+ import { DyNTS_Bot_UserWrapper } from '../../../_models/bot-user-wrapper.interface';
11
+
12
+ export type DyNTS_DiB_Message = DyNTS_Bot_MessageWrapper<Message>;
13
+ export type DyNTS_DiB_Channel = DyNTS_Bot_ChannelWrapper<Channel>;
14
+ export type DyNTS_DiB_User = DyNTS_Bot_UserWrapper<GuildMember>;
15
+
16
+ export interface Discord_MessagingProviderConfig extends DyNTS_Bot_MessagingProvider_Config {
17
+ token: string;
18
+ guildId: string;
19
+ clientId: string;
20
+ oauth2Url: string;
21
+ intents: GatewayIntentBits[];
22
+ partials: Partials[];
23
+ }
24
+
25
+ export class DyNTS_DiB_MessagingProvider_ControlService extends DyNTS_Bot_MessagingProvider_ServiceBase<
26
+ Channel,
27
+ Message,
28
+ GuildMember,
29
+ Discord_MessagingProviderConfig,
30
+ Role
31
+ > {
32
+ readonly name = 'discord';
33
+ readonly type = DyFM_Msg_Provider_Type.discord;
34
+
35
+ get botId(): string {
36
+ return this.client.user?.id;
37
+ }
38
+
39
+ get botDisplayName(): string {
40
+ return this.client.user?.displayName;
41
+ }
42
+
43
+ override readonly config: Discord_MessagingProviderConfig;
44
+
45
+ private client: Client;
46
+ private guild: Guild;
47
+
48
+ constructor(
49
+ setConfig: Discord_MessagingProviderConfig
50
+ ) {
51
+ super();
52
+
53
+ this.config = setConfig;
54
+ }
55
+
56
+ // Public accessors for Discord-specific objects (for backward compatibility with CCAP)
57
+ get discordClient(): Client {
58
+ return this.client;
59
+ }
60
+
61
+ get discordGuild(): Guild {
62
+ return this.guild;
63
+ }
64
+
65
+ async setup(issuer: string): Promise<void> {
66
+ try {
67
+ this.client = new Client({
68
+ intents: this.config.intents,
69
+ partials: this.config.partials,
70
+ });
71
+
72
+ } catch (error) {
73
+ DyFM_Error.logSimple('Error during Discord bot setup:', error);
74
+
75
+ throw new DyFM_Error({
76
+ ...this.getDefaultErrorSettings('setup', error, issuer),
77
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S000`,
78
+ });
79
+ }
80
+ }
81
+
82
+ async start(issuer: string): Promise<void> {
83
+ try {
84
+ if (!this.client) {
85
+ throw new Error('Discord client not initialized. Call setup() first.');
86
+ }
87
+
88
+ return new Promise((resolve, reject) => {
89
+ this.client.on('ready', async () => {
90
+ if (DyNTS_global_settings.bot_settings?.debugLevel >= 1) {
91
+ DyFM_Log.success(`Discord bot logged in as ${this.client.user?.tag}`);
92
+ }
93
+
94
+ // Get guild
95
+ this.guild = this.client.guilds.cache.get(this.config.guildId);
96
+ if (!this.guild) {
97
+ reject(new Error(`Discord server not found with ID: ${this.config.guildId}`));
98
+ return;
99
+ }
100
+
101
+ resolve();
102
+ });
103
+
104
+ this.client.login(this.config.token).catch(reject);
105
+ });
106
+ } catch (error) {
107
+ DyFM_Error.logSimple('Error during Discord bot start:', error);
108
+
109
+ throw new DyFM_Error({
110
+ ...this.getDefaultErrorSettings('start', error, issuer),
111
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S001`,
112
+ });
113
+ }
114
+ }
115
+
116
+ async getChannelByName(name: string): Promise<DyNTS_DiB_Channel> {
117
+ if (this.channelCache.has(name)) {
118
+ return await this.wrapChannel(this.channelCache.get(name));
119
+ }
120
+
121
+ const channel = this.guild.channels.cache.find(
122
+ (ch) => ch.name === name && ch.isTextBased()
123
+ ) as TextChannel;
124
+
125
+ if (!channel) {
126
+ throw new Error(`No text channel found with name "${name}"`);
127
+ }
128
+
129
+ this.channelCache.set(name, channel);
130
+ return await this.wrapChannel(channel);
131
+ }
132
+
133
+ async getChannelById(id: string): Promise<DyNTS_DiB_Channel> {
134
+ const channel = this.guild.channels.cache.get(id) as TextChannel;
135
+ if (!channel) {
136
+ throw new Error(`No text channel found with ID "${id}"`);
137
+ }
138
+
139
+ if (!this.channelCache.has(channel.name)) {
140
+ this.channelCache.set(channel.name, channel);
141
+ }
142
+ return await this.wrapChannel(channel);
143
+ }
144
+
145
+ async sendMessageToChannelByName(channelName: string, message: string): Promise<DyNTS_DiB_Message> {
146
+ const discordChannel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
147
+
148
+ return await this.sendMessageToChannel(discordChannel, message);
149
+
150
+ /* if (!discordChannel) {
151
+ throw new Error(`No text channel found with name "${channelName}"`);
152
+ }
153
+
154
+ if (!discordChannel.rawPlatformChannel.isTextBased()) {
155
+ throw new Error(`Channel "${channelName}" is not a text channel`);
156
+ }
157
+
158
+ //const sentMessage: Message = await (discordChannel.rawPlatformChannel as TextChannel).send(message);
159
+ const channel: TextChannel = discordChannel.rawPlatformChannel as TextChannel;
160
+
161
+ let firstMessage: Message;
162
+ const originalMessage: string = message;
163
+ if (message.length > 2_000) { // 2000 characters per message
164
+ while (message.length) {
165
+ if (!firstMessage) {
166
+ firstMessage = await channel.send(message.substring(0, 2_000));
167
+ } else {
168
+ await channel.send(message.substring(0, 2_000));
169
+ }
170
+
171
+ message = message.substring(2_000);
172
+ }
173
+
174
+ firstMessage.content = originalMessage;
175
+ return this.wrapMessage(firstMessage);
176
+ } else {
177
+ const messageSent: Message = await channel.send(message);
178
+ return this.wrapMessage(messageSent);
179
+ } */
180
+ }
181
+
182
+ async getMessagesFromChannelByChannelName(channelName: string, limit: number = 100): Promise<DyNTS_DiB_Message[]> {
183
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
184
+
185
+ if (!channel.rawPlatformChannel.isTextBased()) {
186
+ throw new Error(`Channel "${channelName}" is not a text channel`);
187
+ }
188
+
189
+ const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
190
+ limit: limit
191
+ });
192
+
193
+ return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
194
+ }
195
+
196
+ async getLastMessageInChannel(channelName: string): Promise<DyNTS_DiB_Message> {
197
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
198
+
199
+ if (!channel.rawPlatformChannel.isTextBased()) {
200
+ throw new Error(`Channel "${channelName}" is not a text channel`);
201
+ }
202
+
203
+ const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
204
+ limit: 1
205
+ });
206
+ const lastMessage: Message = messages.first();
207
+
208
+ return lastMessage ? await this.wrapMessage(lastMessage) : null;
209
+ }
210
+
211
+ async clearChannel(channel: DyNTS_DiB_Channel): Promise<void> {
212
+ if (!channel.rawPlatformChannel.isTextBased()) {
213
+ throw new Error(`Channel "${channel.name}" is not a text channel`);
214
+ }
215
+
216
+ let lastId: string | undefined = undefined;
217
+ let fetched: number = 0;
218
+ const maxFetch: number = 1000;
219
+
220
+ while (fetched < maxFetch) {
221
+ const options: { limit: number; before?: string } = { limit: 100 };
222
+ if (lastId) {
223
+ options.before = lastId;
224
+ }
225
+
226
+ const messageCollection: Collection<string, Message> = await channel.rawPlatformChannel.messages.fetch(options);
227
+ if (messageCollection.size === 0) {
228
+ break;
229
+ }
230
+
231
+ const deletePromises = Array.from(messageCollection.values()).map((message: Message) =>
232
+ message.delete().catch((error) => {
233
+ DyFM_Error.logSimple('Failed to delete message', error);
234
+ })
235
+ );
236
+
237
+ await Promise.all(deletePromises);
238
+ lastId = Array.from(messageCollection.values()).pop()?.id;
239
+ fetched += messageCollection.size;
240
+ }
241
+ }
242
+
243
+ // Message operations
244
+ async sendMessageToChannel(channel: DyNTS_DiB_Channel, content: string): Promise<DyNTS_DiB_Message> {
245
+ if (!channel.rawPlatformChannel.isTextBased()) {
246
+ throw new Error(`Channel "${channel.name}" is not a text channel`);
247
+ }
248
+ const discordTextChannel: TextChannel = channel.rawPlatformChannel as TextChannel;
249
+
250
+ const originalContent: string = content;
251
+
252
+ let firstMessage: Message;
253
+ if (content.length > 2_000) { // 2000 characters per message
254
+ while (content.length) {
255
+ if (!firstMessage) {
256
+ firstMessage = await discordTextChannel.send(content.substring(0, 2_000));
257
+ } else {
258
+ await discordTextChannel.send(content.substring(0, 2_000));
259
+ }
260
+ content = content.substring(2_000);
261
+ }
262
+
263
+ firstMessage.content = originalContent;
264
+ return await this.wrapMessage(firstMessage);
265
+ } else {
266
+ const message: Message = await discordTextChannel.send(content);
267
+ return await this.wrapMessage(message);
268
+ }
269
+ }
270
+
271
+ async replyToMessage(message: DyNTS_DiB_Message, content: string): Promise<DyNTS_DiB_Message> {
272
+ try {
273
+ /* const channel = this.guild.channels.cache.get(channelId) as TextChannel;
274
+ if (!channel) {
275
+ throw new Error(`Channel not found with ID: ${channelId}`);
276
+ }
277
+ const message = await channel.messages.fetch(messageId); */
278
+ if (!message.rawPlatformMessage.channel.isTextBased()) {
279
+ throw new Error(`Message "${message.id}" is not a text message`);
280
+ }
281
+
282
+ const originalContent: string = content;
283
+ if (content.length > 2_000) {
284
+ let firstMessage: Message;
285
+
286
+ while (content.length) {
287
+ if (!firstMessage) {
288
+ firstMessage = await (message.rawPlatformMessage.channel as TextChannel).send(
289
+ content.substring(0, 2_000)
290
+ );
291
+ } else {
292
+ await message.reply(content.substring(0, 2_000));
293
+ }
294
+ content = content.substring(2_000);
295
+ }
296
+
297
+ firstMessage.content = originalContent;
298
+ return await this.wrapMessage(firstMessage);
299
+ } else {
300
+ const reply: Message= await message.rawPlatformMessage.reply(content);
301
+ return await this.wrapMessage(reply);
302
+ }
303
+ } catch (error) {
304
+ DyFM_Error.logSimple('Error replying to message:', error);
305
+
306
+ throw new DyFM_Error({
307
+ ...this.getDefaultErrorSettings('replyToMessage', error, message.issuer),
308
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DiB-MessagingProvider-S002`,
309
+ });
310
+ }
311
+ }
312
+
313
+ async sendTyping(channel: DyNTS_DiB_Channel): Promise<void> {
314
+ if (!channel.rawPlatformChannel.isTextBased()) {
315
+ throw new Error(`Channel "${channel.name}" is not a text channel`);
316
+ }
317
+
318
+ await (channel.rawPlatformChannel as TextChannel).sendTyping();
319
+ }
320
+
321
+ async sendTypingForMessage(message: DyNTS_DiB_Message): Promise<void> {
322
+ if (!message.rawPlatformMessage.channel.isTextBased()) {
323
+ throw new Error(`Message "${message.id}" is not a text message`);
324
+ }
325
+
326
+ await (message.rawPlatformMessage.channel as TextChannel).sendTyping();
327
+ }
328
+
329
+ async fetchMessages(channel: DyNTS_DiB_Channel, limit: number): Promise<DyNTS_DiB_Message[]> {
330
+ if (!channel.rawPlatformChannel.isTextBased()) {
331
+ throw new Error(`Channel "${channel.name}" is not a text channel`);
332
+ }
333
+
334
+ const messages: Collection<string, Message> = await (channel.rawPlatformChannel as TextChannel).messages.fetch({
335
+ limit: limit
336
+ });
337
+ return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
338
+ }
339
+
340
+ async fetchMessagesById(id: string, limit: number): Promise<DyNTS_DiB_Message[]> {
341
+ const channel: DyNTS_DiB_Channel = await this.getChannelById(id);
342
+ return this.fetchMessages(channel, limit);
343
+ }
344
+
345
+ async fetchMessagesForMessage(message: DyNTS_DiB_Message, limit: number): Promise<DyNTS_DiB_Message[]> {
346
+ if (!message.rawPlatformMessage.channel.isTextBased()) {
347
+ throw new Error(`Message "${message.id}" is not a text message`);
348
+ }
349
+
350
+ const messages: Collection<string, Message> = await message.rawPlatformMessage.channel.messages.fetch({
351
+ limit: limit
352
+ });
353
+ return await Promise.all(Array.from(messages.values()).map(async (msg: Message) => await this.wrapMessage(msg)));
354
+ }
355
+
356
+ async fetchAllMessagesWithPaging(channel: DyNTS_DiB_Channel, maxFetch: number = 1000): Promise<DyNTS_DiB_Message[]> {
357
+ if (!channel.rawPlatformChannel.isTextBased()) {
358
+ throw new Error(`Channel "${channel.name}" is not a text channel`);
359
+ }
360
+
361
+ let lastId: string | undefined = undefined;
362
+ let fetched: number = 0;
363
+ const allMessages: DyNTS_DiB_Message[] = [];
364
+
365
+ while (fetched < maxFetch) {
366
+ const options: { limit: number; before?: string } = { limit: 100 };
367
+ if (lastId) options.before = lastId;
368
+
369
+ const messageCollection: Collection<string, Message> = await channel.rawPlatformChannel.messages.fetch(options);
370
+ if (messageCollection.size === 0) break;
371
+
372
+ await DyFM_Array.asyncForEach(
373
+ Array.from(messageCollection.values()),
374
+ async (msg: Message) => {
375
+ allMessages.push(await this.wrapMessage(msg));
376
+ }
377
+ );
378
+
379
+ lastId = Array.from(messageCollection.values()).pop()?.id;
380
+ fetched += messageCollection.size;
381
+ }
382
+
383
+ return allMessages;
384
+ }
385
+
386
+ async deleteMessage(message: DyNTS_DiB_Message): Promise<void> {
387
+ await message.rawPlatformMessage.delete();
388
+ }
389
+
390
+ // User operations
391
+ async updateMessage(message: Message, issuer: string): Promise<void> {
392
+ throw new Error('Discord provider not yet implemented');
393
+ }
394
+
395
+ async getUserByName(username: string): Promise<DyNTS_DiB_User> {
396
+ const member: GuildMember = this.guild.members.cache.find((m: GuildMember) => m.user.username === username);
397
+
398
+ if (!member) {
399
+ throw new Error(`User not found with username: ${username}`);
400
+ }
401
+
402
+ return await this.wrapUser(member);
403
+ }
404
+
405
+ getUserMention(userId: string): string {
406
+ return `<@${userId}>`;
407
+ }
408
+
409
+ async readMembersInChannel(channelName: string): Promise<DyNTS_DiB_User[]> {
410
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
411
+ const members: Collection<string, GuildMember> = await this.fetchMembersInGuild(this.guild);
412
+
413
+ const allowedMembers: Collection<string, GuildMember> = members.filter((member: GuildMember) =>
414
+ channel.rawPlatformChannel.isTextBased() &&
415
+ (channel.rawPlatformChannel as TextChannel).permissionsFor(member)?.has('ViewChannel')
416
+ );
417
+
418
+ return await DyFM_Array.asyncMap(
419
+ Array.from(allowedMembers.values()),
420
+ async (member: GuildMember) => await this.wrapUser(member)
421
+ );
422
+ }
423
+
424
+ async fetchMembersInGuild(guild: Guild): Promise<Collection<string, GuildMember>> {
425
+ try {
426
+ // Try to fetch with a limit to avoid timeout
427
+ return await guild?.members.fetch({ limit: 1000 })
428
+ } catch (fetchError: any) {
429
+ throw new DyFM_Error({
430
+ errorCode: 'DIB-OPS-FMI0',
431
+ message: 'Failed to fetch members',
432
+ error: fetchError,
433
+ })
434
+ }
435
+ }
436
+
437
+ async readMemberNamesInChannel(channelName: string): Promise<string[]> {
438
+ const members: DyNTS_DiB_User[] = await this.readMembersInChannel(channelName);
439
+ return members.map((member: DyNTS_DiB_User) => member.username);
440
+ }
441
+
442
+ // Advanced message queries
443
+ async getLastMessageSentBy(channelName: string, username: string): Promise<DyNTS_DiB_Message> {
444
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
445
+ const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
446
+
447
+ return messages.find((msg: DyNTS_DiB_Message) => msg.authorName === username) || null;
448
+ }
449
+
450
+ async getLastMentionOf(channelName: string, username: string): Promise<DyNTS_DiB_Message> {
451
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
452
+ const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
453
+
454
+ return messages.find((msg: DyNTS_DiB_Message) =>
455
+ msg.content.includes(`@${username}`) ||
456
+ msg.content.includes(`<@${username}>`)
457
+ ) || null;
458
+ }
459
+
460
+ // Advanced message queries
461
+ async readLastMessageDatesByMembers(channelName: string, memberNames: string[]): Promise<DyNTS_Bot_LastMessageDate[]> {
462
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
463
+ const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
464
+
465
+ const memberStatus: Record<string, { lastMessageDate: Date | null, allMessages: number }> = {};
466
+ memberNames.forEach((name: string) => {
467
+ memberStatus[name] = { lastMessageDate: null, allMessages: 0 };
468
+ });
469
+
470
+ const cutoffTime: number = Date.now() - (3 * week); // 3 weeks
471
+
472
+ messages.forEach((message: DyNTS_DiB_Message) => {
473
+ if (message.timestamp < cutoffTime) return;
474
+
475
+ const author = message.authorName;
476
+ if (memberStatus[author] !== undefined) {
477
+ memberStatus[author].allMessages++;
478
+ if (!memberStatus[author].lastMessageDate) {
479
+ memberStatus[author].lastMessageDate = new Date(message.timestamp);
480
+ }
481
+ }
482
+ });
483
+
484
+ return memberNames.map((memberName: string) => {
485
+ const status: { lastMessageDate: Date | null, allMessages: number } = memberStatus[memberName];
486
+
487
+ return {
488
+ memberName: memberName,
489
+ allMessages: status.allMessages,
490
+ lastMessageDate: status.lastMessageDate
491
+ };
492
+ });
493
+ }
494
+
495
+ // Advanced message queries
496
+ async readLastMessageWithMemberNamePingInIt(channelName: string, users: DyNTS_DiB_User[]): Promise<DyNTS_Bot_LastMentionDate[]> {
497
+ const channel: DyNTS_DiB_Channel = await this.getChannelByName(channelName);
498
+ const messages: DyNTS_DiB_Message[] = await this.fetchAllMessagesWithPaging(channel, 1000);
499
+
500
+ const memberStatus: Record<string, { lastMentionDate: Date | null, allMentions: number }> = {};
501
+ users.forEach((user: DyNTS_DiB_User) => {
502
+ memberStatus[user.username] = { lastMentionDate: null, allMentions: 0 };
503
+ });
504
+
505
+ const cutoffTime: number = Date.now() - (3 * week); // 3 weeks
506
+
507
+ messages.forEach((message: DyNTS_DiB_Message) => {
508
+ if (message.timestamp < cutoffTime) return;
509
+
510
+ users.forEach((user: DyNTS_DiB_User) => {
511
+ if (
512
+ message.content.includes(`@${user.id}`) &&
513
+ !memberStatus[user.username].lastMentionDate
514
+ ) {
515
+ memberStatus[user.username].lastMentionDate = new Date(message.timestamp);
516
+ memberStatus[user.username].allMentions++;
517
+ }
518
+ });
519
+ });
520
+
521
+ return users.map((user: DyNTS_DiB_User) => {
522
+ const status: { lastMentionDate: Date | null, allMentions: number } = memberStatus[user.username];
523
+
524
+ return {
525
+ memberId: user.id,
526
+ memberName: user.username,
527
+ allMentions: status.allMentions,
528
+ lastMentionDate: status.lastMentionDate
529
+ };
530
+ });
531
+ }
532
+
533
+ // Discord-specific features
534
+ getRoleByName(roleName: string): Role {
535
+ if (this.roleCache.has(roleName)) {
536
+ return this.roleCache.get(roleName);
537
+ }
538
+
539
+ const role: Role = this.guild.roles.cache.find((r: Role) => r.name === roleName);
540
+ if (role) {
541
+ this.roleCache.set(roleName, role);
542
+ }
543
+ return role;
544
+ }
545
+
546
+ async getRolePingByName(roleName: string): Promise<string> {
547
+ const role: Role = this.getRoleByName(roleName);
548
+ return role ? `<@&${role.id}>` : '';
549
+ }
550
+
551
+ async getRolePingsByName(roleNames: string[]): Promise<string> {
552
+ const pings: string[] = await Promise.all(
553
+ roleNames.map((roleName: string) => this.getRolePingByName(roleName))
554
+ );
555
+ return pings.join(' ');
556
+ }
557
+
558
+ async create_onMessageEventListener(handler: (message: DyNTS_DiB_Message, issuer: string) => Promise<void>): Promise<void> {
559
+ this.client.on('messageCreate', async (message: Message) => {
560
+ await handler(await this.wrapMessage(message), 'discord');
561
+ });
562
+ }
563
+
564
+ create_onErrorEventListener(handler: (error: DyFM_AnyError) => void): void {
565
+ this.client.on('error', (error: Error) => {
566
+ handler(error);
567
+ });
568
+ }
569
+
570
+ async sendReport(message: string): Promise<DyNTS_DiB_Message> {
571
+ return await this.sendMessageToChannelByName(this.config.reportChannelName, message);
572
+ }
573
+
574
+ async sendReportIn(message: string): Promise<DyNTS_DiB_Message> {
575
+ return await this.sendMessageToChannelByName(
576
+ this.config.reportChannelName,
577
+ `${this.botDisplayName} report for duty! ` +
578
+ `(v${DyNTS_global_settings.systemVersion} ${DyNTS_global_settings.env_settings?.environment})`
579
+ );
580
+ }
581
+
582
+ async wrapMessage(message: Message): Promise<DyNTS_DiB_Message> {
583
+ let replyTo: Message | null = null;
584
+ if (message.reference?.messageId) {
585
+ replyTo = message.channel.messages.cache.get(
586
+ message.reference.messageId
587
+ );
588
+ }
589
+
590
+ return new DyNTS_Bot_MessageWrapper<Message>({
591
+ id: message.id,
592
+ content: message.content,
593
+ authorId: message.author.id,
594
+ authorName: message.author.username,
595
+ authorDisplayName: message.author.displayName,
596
+ channelId: message.channel.id,
597
+ channelName: (message.channel as TextChannel)?.name || 'DM Channel with ' + (message.channel as DMChannel).recipient.username,
598
+ timestamp: message.createdTimestamp,
599
+ isBot: message.author.bot,
600
+ isTextBased: message.channel.isTextBased(),
601
+ isVoiceBased: false, /* message.channel.isVoiceBased(), */
602
+ isDM: message.channel.isDMBased(),
603
+ mentions: Array.from(message.mentions.users.keys()),
604
+ replyToMessageId: message.reference?.messageId,
605
+ replyToMessageAuthorId: replyTo?.author?.id,
606
+ rawPlatformMessage: message,
607
+
608
+ issuer: message.author.id,
609
+
610
+ channel: await this.wrapChannel(message.channel),
611
+ /* user: this.wrapUser(message.author), */
612
+
613
+ provider: this,
614
+ });
615
+ }
616
+
617
+ async wrapChannel(channel: Channel): Promise<DyNTS_DiB_Channel> {
618
+ return new DyNTS_Bot_ChannelWrapper<Channel>({
619
+ id: channel.id,
620
+ name: (channel as TextChannel).name || ('DM Channel with ' + (channel as DMChannel).recipient.username),
621
+ isTextBased: channel.isTextBased(),
622
+ isDM: channel.isDMBased(),
623
+ isVoiceBased: channel.isVoiceBased(),
624
+ rawPlatformChannel: channel,
625
+
626
+ provider: this,
627
+ });
628
+ }
629
+
630
+ async wrapUser(user: GuildMember): Promise<DyNTS_DiB_User> {
631
+ return new DyNTS_Bot_UserWrapper<GuildMember>({
632
+ id: user.user.id,
633
+ username: user.user.username,
634
+ displayName: user.displayName,
635
+ isBot: user.user.bot,
636
+ rawPlatformUser: user,
637
+
638
+ provider: this,
639
+ });
640
+ }
641
+ }