@futdevpro/nts-dynamo 1.15.13 → 1.15.14

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 (352) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.vscode/settings.json +10 -10
  17. package/HOWTO.md +15 -15
  18. package/LICENSE +21 -21
  19. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  20. package/_specifications/BACKLOG.md +50 -22
  21. package/_specifications/TODO.md +15 -15
  22. package/_specifications/agent.md +138 -138
  23. package/build/_collections/global-settings.const.d.ts.map +1 -1
  24. package/build/_collections/global-settings.const.js +4 -0
  25. package/build/_collections/global-settings.const.js.map +1 -1
  26. package/build/_models/interfaces/global-log-settings.interface.d.ts +11 -0
  27. package/build/_models/interfaces/global-log-settings.interface.d.ts.map +1 -1
  28. package/build/_modules/logs/get-logs-routing-module.util.d.ts +19 -0
  29. package/build/_modules/logs/get-logs-routing-module.util.d.ts.map +1 -0
  30. package/build/_modules/logs/get-logs-routing-module.util.js +32 -0
  31. package/build/_modules/logs/get-logs-routing-module.util.js.map +1 -0
  32. package/build/_modules/logs/index.d.ts +4 -0
  33. package/build/_modules/logs/index.d.ts.map +1 -0
  34. package/build/_modules/logs/index.js +10 -0
  35. package/build/_modules/logs/index.js.map +1 -0
  36. package/build/_modules/logs/log-buffer.service.d.ts +38 -0
  37. package/build/_modules/logs/log-buffer.service.d.ts.map +1 -0
  38. package/build/_modules/logs/log-buffer.service.js +97 -0
  39. package/build/_modules/logs/log-buffer.service.js.map +1 -0
  40. package/build/_modules/logs/logs.controller.d.ts +27 -0
  41. package/build/_modules/logs/logs.controller.d.ts.map +1 -0
  42. package/build/_modules/logs/logs.controller.js +90 -0
  43. package/build/_modules/logs/logs.controller.js.map +1 -0
  44. package/build/_modules/logs/logs.service.d.ts +40 -0
  45. package/build/_modules/logs/logs.service.d.ts.map +1 -0
  46. package/build/_modules/logs/logs.service.js +97 -0
  47. package/build/_modules/logs/logs.service.js.map +1 -0
  48. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  49. package/build/_modules/server/errors/errors.data-service.js +2 -1
  50. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  51. package/eslint.config.js +3 -3
  52. package/nodemon.json +24 -24
  53. package/package.json +359 -353
  54. package/scripts/run-coverage-tests.js +28 -28
  55. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  56. package/spec/support/helpers/ts-node-helper.js +93 -93
  57. package/spec/support/jasmine.coverage.json +24 -24
  58. package/spec/support/jasmine.json +24 -24
  59. package/src/_collections/archive.util.spec.ts +57 -57
  60. package/src/_collections/archive.util.ts +18 -18
  61. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  62. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  63. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  64. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  65. package/src/_collections/default-not-found-page.const.ts +22 -22
  66. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  67. package/src/_collections/default-socket-path.const.ts +2 -2
  68. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  69. package/src/_collections/get-environment-settings.util.ts +48 -48
  70. package/src/_collections/global-settings.const.ts +5 -0
  71. package/src/_collections/sample.env +21 -21
  72. package/src/_collections/star.controller.spec.ts +224 -224
  73. package/src/_collections/star.controller.ts +129 -129
  74. package/src/_enums/data-model-type.enum.ts +14 -14
  75. package/src/_enums/data-service-function.enum.ts +24 -24
  76. package/src/_enums/predefined-data-types.enum.ts +16 -16
  77. package/src/_enums/route-security.enum.ts +12 -12
  78. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  79. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  80. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  81. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  82. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  83. package/src/_models/control-models/app-params.control-model.ts +136 -136
  84. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  85. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  86. package/src/_models/control-models/endpoint-params.control-model.spec.ts +578 -578
  87. package/src/_models/control-models/endpoint-params.control-model.ts +526 -526
  88. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  89. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  90. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  91. package/src/_models/control-models/system-control.control-model.ts +12 -12
  92. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  93. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  94. package/src/_models/interfaces/global-log-settings.interface.ts +108 -96
  95. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  96. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  97. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  98. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  99. package/src/_models/types/db-update.type.ts +100 -100
  100. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  101. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  102. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  103. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  104. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  105. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  106. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  107. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  108. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  109. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  110. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  111. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  112. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  113. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  114. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  115. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  116. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  117. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  118. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  119. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  120. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  121. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  122. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  123. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  124. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  125. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  126. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  127. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  128. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  129. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +240 -240
  130. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +98 -98
  131. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  132. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +615 -615
  133. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +437 -437
  134. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +833 -833
  135. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  136. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  137. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  138. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  139. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  140. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  141. package/src/_modules/ai/_services/ai-llm.service-base.ts +332 -332
  142. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +79 -79
  143. package/src/_modules/ai/_services/ai-provider.service-base.ts +29 -29
  144. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  145. package/src/_modules/ai/index.ts +13 -13
  146. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  147. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  148. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  149. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  150. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  151. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  152. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  153. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  154. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  155. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  156. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  157. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  158. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  159. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  160. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  161. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  162. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  163. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  164. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  165. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  166. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  167. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  168. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  169. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  170. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  171. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  172. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  173. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  174. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  175. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  176. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  177. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  178. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  179. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  180. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  181. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  182. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  183. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  184. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  185. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  186. package/src/_modules/custom-data/index.ts +9 -9
  187. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  188. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  189. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  190. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  191. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  192. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  193. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  194. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  195. package/src/_modules/defaults/index.ts +17 -17
  196. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  197. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  198. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  199. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  200. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  201. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  202. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  203. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  204. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  205. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  206. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  207. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  208. package/src/_modules/discord-assistant/index.ts +38 -38
  209. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  210. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  211. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  212. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  213. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  214. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  215. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  216. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  217. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  218. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  219. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  220. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  221. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  222. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  223. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  224. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  225. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  226. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  227. package/src/_modules/discord-bot/index.ts +36 -36
  228. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +19 -19
  229. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  230. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  231. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  232. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +345 -345
  233. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +330 -330
  234. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  235. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  236. package/src/_modules/local-vector-search/index.ts +11 -11
  237. package/src/_modules/logs/get-logs-routing-module.util.ts +36 -0
  238. package/src/_modules/logs/index.ts +3 -0
  239. package/src/_modules/logs/log-buffer.service.ts +101 -0
  240. package/src/_modules/logs/logs.controller.ts +109 -0
  241. package/src/_modules/logs/logs.service.ts +100 -0
  242. package/src/_modules/messaging/README.md +354 -354
  243. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  244. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  245. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  246. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  247. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  248. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  249. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  250. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  251. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  252. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  253. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  254. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  255. package/src/_modules/messaging/index.ts +30 -30
  256. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  257. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  258. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  259. package/src/_modules/mock/app-params.mock.ts +9 -9
  260. package/src/_modules/mock/app-server.mock.ts +188 -188
  261. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  262. package/src/_modules/mock/auth-service.mock.ts +28 -28
  263. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  264. package/src/_modules/mock/controller.mock.ts +16 -16
  265. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  266. package/src/_modules/mock/data-model.mock.ts +82 -82
  267. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  268. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  269. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  270. package/src/_modules/mock/email-service.mock.ts +20 -20
  271. package/src/_modules/mock/email-template.mock.html +14 -14
  272. package/src/_modules/mock/endpoint.mock.ts +91 -91
  273. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  274. package/src/_modules/mock/socket-client.mock.ts +45 -45
  275. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  276. package/src/_modules/mock/socket-server.mock.ts +46 -46
  277. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  278. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  279. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  280. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  281. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  282. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  283. package/src/_modules/oauth2/index.ts +17 -17
  284. package/src/_modules/server/errors/errors.control-service.spec.ts +230 -230
  285. package/src/_modules/server/errors/errors.control-service.ts +69 -69
  286. package/src/_modules/server/errors/errors.controller.spec.ts +165 -165
  287. package/src/_modules/server/errors/errors.controller.ts +270 -270
  288. package/src/_modules/server/errors/errors.data-service.spec.ts +355 -355
  289. package/src/_modules/server/errors/errors.data-service.ts +2 -1
  290. package/src/_modules/server/index.ts +30 -30
  291. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  292. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  293. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  294. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  295. package/src/_modules/server/server-status/server-status.control-service.spec.ts +516 -516
  296. package/src/_modules/server/server-status/server-status.control-service.ts +336 -336
  297. package/src/_modules/server/server-status/server-status.controller.spec.ts +156 -156
  298. package/src/_modules/server/server-status/server-status.controller.ts +131 -131
  299. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  300. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  301. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  302. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  303. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  304. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  305. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  306. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  307. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  308. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  309. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  310. package/src/_modules/socket/app-extended.server.ts +630 -630
  311. package/src/_modules/socket/index.ts +42 -42
  312. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  313. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  314. package/src/_modules/test/index.ts +11 -11
  315. package/src/_modules/test/test.controller.spec.ts +72 -72
  316. package/src/_modules/test/test.controller.ts +115 -115
  317. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  318. package/src/_modules/usage/index.ts +15 -15
  319. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  320. package/src/_modules/usage/usage.controller.ts +126 -126
  321. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  322. package/src/_modules/usage/usage.data-service.ts +185 -185
  323. package/src/_services/base/api.service-base.spec.ts +125 -125
  324. package/src/_services/base/api.service-base.ts +74 -74
  325. package/src/_services/base/archive-data.service.spec.ts +196 -196
  326. package/src/_services/base/archive-data.service.ts +216 -216
  327. package/src/_services/base/data.service.spec.ts +493 -493
  328. package/src/_services/base/data.service.ts +2525 -2525
  329. package/src/_services/base/db.service.spec.ts +73 -73
  330. package/src/_services/base/db.service.ts +1575 -1575
  331. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  332. package/src/_services/base/singleton.service-base.ts +24 -24
  333. package/src/_services/base/singleton.service.spec.ts +114 -114
  334. package/src/_services/base/singleton.service.ts +38 -38
  335. package/src/_services/core/api.service.spec.ts +140 -140
  336. package/src/_services/core/auth.service.spec.ts +159 -159
  337. package/src/_services/core/auth.service.ts +174 -174
  338. package/src/_services/core/email.service.spec.ts +85 -85
  339. package/src/_services/core/email.service.ts +742 -742
  340. package/src/_services/core/global.service.spec.ts +275 -275
  341. package/src/_services/core/global.service.ts +461 -461
  342. package/src/_services/core/service-collection.service.spec.ts +46 -46
  343. package/src/_services/core/service-collection.service.ts +6 -6
  344. package/src/_services/route/controller.service.spec.ts +53 -53
  345. package/src/_services/route/controller.service.ts +148 -148
  346. package/src/_services/route/routing-module.service.spec.ts +98 -98
  347. package/src/_services/route/routing-module.service.ts +330 -330
  348. package/src/_services/shared.static-service.spec.ts +99 -99
  349. package/src/_services/shared.static-service.ts +78 -78
  350. package/src/index.ts +94 -94
  351. package/tsconfig.app.json +12 -12
  352. package/tsconfig.json +42 -42
@@ -1,408 +1,408 @@
1
-
2
- import { DyNTS_DiBo_Main_ControlService } from './dibo-main.control-service';
3
- import { Client, GatewayIntentBits, Guild, TextChannel, Message, Role } from 'discord.js';
4
- import { DyFM_Error, DyFM_Log, DyFM_Async } from '@futdevpro/fsm-dynamo';
5
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
6
- import { DyNTS_DiBo_IO_ControlService } from './dibo-io.control-service';
7
- import { DyNTS_DiBo_Routines_ControlService } from './dibo-routines.control-service';
8
- import { DyNTS_DiBo_Commands_ControlService } from './dibo-commands.control-service';
9
- import { second } from '@futdevpro/fsm-dynamo';
10
-
11
- class TestDiBoMainService extends DyNTS_DiBo_Main_ControlService {
12
- protected getBotIOControlService(): DyNTS_DiBo_IO_ControlService {
13
- return this.botIO_CS;
14
- }
15
-
16
- protected getRoutinesControlService(): DyNTS_DiBo_Routines_ControlService {
17
- return this.routines_CS;
18
- }
19
-
20
- protected getCommandsControlService(): DyNTS_DiBo_Commands_ControlService {
21
- return this.commands_CS;
22
- }
23
-
24
- static getInstance(): TestDiBoMainService {
25
- return TestDiBoMainService.getSingletonInstance();
26
- }
27
- }
28
-
29
- xdescribe('| DyNTS_DiBo_Main_ControlService', () => {
30
- let service: TestDiBoMainService;
31
- let mockClient: jasmine.SpyObj<Client>;
32
- let mockGuild: jasmine.SpyObj<Guild>;
33
- let mockTextChannel: jasmine.SpyObj<TextChannel>;
34
- let mockBotIO_CS: jasmine.SpyObj<DyNTS_DiBo_IO_ControlService>;
35
- let mockRoutines_CS: jasmine.SpyObj<DyNTS_DiBo_Routines_ControlService>;
36
- let mockCommands_CS: jasmine.SpyObj<DyNTS_DiBo_Commands_ControlService>;
37
-
38
- beforeEach(() => {
39
- // Mock global settings
40
- DyNTS_global_settings.env_settings = {
41
- environment: 'local',
42
- discord: {
43
- token: 'test-token',
44
- guildId: 'guild-123',
45
- clientId: 'client-123',
46
- oauth2Url: 'https://oauth2.example.com',
47
- },
48
- mongoUri: undefined,
49
- openAi: {},
50
- } as any;
51
-
52
- DyNTS_global_settings.bot_settings = {
53
- intents: [GatewayIntentBits.Guilds],
54
- partials: [],
55
- } as any;
56
-
57
- // Create mock services
58
- mockBotIO_CS = jasmine.createSpyObj('DyNTS_DiBo_IO_ControlService', ['setup', 'start', 'handleNewMessage']);
59
- mockRoutines_CS = jasmine.createSpyObj('DyNTS_DiBo_Routines_ControlService', ['setup', 'start']);
60
- mockCommands_CS = jasmine.createSpyObj('DyNTS_DiBo_Commands_ControlService', ['setup', 'start']);
61
-
62
- // Create mock Discord objects
63
- mockTextChannel = jasmine.createSpyObj('TextChannel', ['send'], {
64
- id: 'channel-123',
65
- name: 'test-channel',
66
- isTextBased: () => true,
67
- });
68
-
69
- mockGuild = jasmine.createSpyObj('Guild', [], {
70
- id: 'guild-123',
71
- channels: {
72
- cache: new Map([['channel-123', mockTextChannel]]),
73
- },
74
- roles: {
75
- cache: new Map(),
76
- },
77
- });
78
-
79
- mockClient = jasmine.createSpyObj('Client', ['login', 'on'], {
80
- user: {
81
- id: 'bot-123',
82
- tag: 'TestBot#1234',
83
- displayName: 'Test Bot',
84
- },
85
- guilds: {
86
- cache: new Map([['guild-123', mockGuild]]),
87
- get: jasmine.createSpy('guilds.get').and.returnValue(mockGuild),
88
- },
89
- });
90
-
91
- // Mock Client constructor by preventing actual Client instantiation
92
- // We'll create the service without calling the constructor that creates Client
93
- service = TestDiBoMainService.getInstance();
94
- (service as any).client = mockClient;
95
- (service as any)._discordServer = mockGuild;
96
- (service as any).botIO_CS = mockBotIO_CS;
97
- (service as any).routines_CS = mockRoutines_CS;
98
- (service as any).commands_CS = mockCommands_CS;
99
- });
100
-
101
- afterEach(async () => {
102
- try {
103
- // Megvárjuk, hogy a bot leálljon és a process listener-ek lefussanak
104
- await DyFM_Async.delay(200);
105
-
106
- // Biztosítjuk, hogy a discordServer ne próbáljon üzenetet küldeni
107
- if (service && (service as any)._discordServer) {
108
- const discordServer = (service as any)._discordServer as Guild;
109
- // Invalidáljuk a channels.cache-t, hogy ne próbáljon channel-t keresni
110
- if (discordServer.channels && discordServer.channels.cache) {
111
- // Invalidáljuk a cache-t, hogy ne lehessen használni
112
- (discordServer.channels as any).cache = undefined;
113
- }
114
- // Invalidáljuk a channels-t is
115
- (discordServer as any).channels = undefined;
116
- }
117
-
118
- // Invalidáljuk a discordServer-t is
119
- if (service) {
120
- (service as any)._discordServer = undefined;
121
- }
122
-
123
- await DyFM_Async.delay(200);
124
- } catch (error) {
125
- // Csendes hiba-kezelés
126
- }
127
- });
128
-
129
- afterAll(async () => {
130
- try {
131
- // Végleges cleanup a tesztek végén - megvárjuk, hogy minden process listener lefusson
132
- await DyFM_Async.delay(500);
133
-
134
- // Invalidáljuk a service-t is
135
- if (service) {
136
- (service as any)._discordServer = undefined;
137
- (service as any).client = undefined;
138
- }
139
-
140
- await DyFM_Async.delay(500);
141
- } catch (error) {
142
- // Csendes hiba-kezelés
143
- }
144
- });
145
-
146
- describe('| constructor', () => {
147
- it('| should initialize Discord client', () => {
148
- expect(service.client).toBeDefined();
149
- });
150
-
151
- it('| should throw error if client already initialized', () => {
152
- // This test is skipped because we can't easily mock the Client constructor
153
- // The service is already initialized via getInstance()
154
- expect(service.client).toBeDefined();
155
- });
156
- });
157
-
158
- describe('| properties', () => {
159
- it('| should return discordServer', () => {
160
- expect(service.discordServer).toBe(mockGuild);
161
- });
162
-
163
- it('| should return botClientId from client user', () => {
164
- expect(service.botClientId).toBe('bot-123');
165
- });
166
-
167
- it('| should return botDisplayName from client user', () => {
168
- expect(service.botDisplayName).toBe('Test Bot');
169
- });
170
- });
171
-
172
- describe('| setup', () => {
173
- it('| should setup bot services', async () => {
174
- mockClient.login.and.returnValue(Promise.resolve('token'));
175
- mockClient.on.and.callFake((event: string, callback: Function): any => {
176
- if (event === 'ready') {
177
- setTimeout(() => callback(), 10);
178
- }
179
- });
180
-
181
- mockBotIO_CS.setup.and.returnValue(Promise.resolve());
182
- mockRoutines_CS.setup.and.returnValue(Promise.resolve());
183
- mockCommands_CS.setup.and.returnValue(Promise.resolve());
184
-
185
- await service.setup('test-issuer');
186
-
187
- expect(mockBotIO_CS.setup).toHaveBeenCalled();
188
- expect(mockRoutines_CS.setup).toHaveBeenCalled();
189
- expect(mockCommands_CS.setup).toHaveBeenCalled();
190
- });
191
-
192
- it('| should throw error if guildId not found', async () => {
193
- DyNTS_global_settings.env_settings.discord.guildId = null as any;
194
-
195
- try {
196
- await service.setup('test-issuer');
197
- fail('Should have thrown an error');
198
- } catch (error) {
199
- // Error may be wrapped in DyFM_Error
200
- expect(error).toBeDefined();
201
- const errorMessage = (error as DyFM_Error)?._message || (error as Error)?.message || '';
202
- expect(errorMessage).toContain('No discord server id found');
203
- }
204
- });
205
-
206
- it('| should throw error if token not found', async () => {
207
- DyNTS_global_settings.env_settings.discord.token = null as any;
208
-
209
- try {
210
- await service.setup('test-issuer');
211
- fail('Should have thrown an error');
212
- } catch (error) {
213
- // Error may be wrapped in DyFM_Error
214
- expect(error).toBeDefined();
215
- const errorMessage = (error as DyFM_Error)?._message || (error as Error)?.message || '';
216
- expect(errorMessage).toContain('No discord token found');
217
- }
218
- });
219
-
220
- it('| should throw error if botIO_CS not found', async () => {
221
- (service as any).botIO_CS = null;
222
- mockClient.login.and.returnValue(Promise.resolve('token'));
223
- mockClient.on.and.callFake((event: string, callback: Function): any => {
224
- if (event === 'ready') {
225
- setTimeout(() => callback(), 10);
226
- }
227
- });
228
-
229
- try {
230
- await service.setup('test-issuer');
231
- fail('Should have thrown an error');
232
- } catch (error) {
233
- expect(error).toBeInstanceOf(DyFM_Error);
234
- }
235
- });
236
- });
237
-
238
- describe('| start', () => {
239
- it('| should start bot services', async () => {
240
- mockRoutines_CS.start.and.returnValue(Promise.resolve());
241
- mockBotIO_CS.start.and.returnValue(Promise.resolve());
242
- mockCommands_CS.start.and.returnValue(Promise.resolve());
243
-
244
- await service.start('test-issuer');
245
-
246
- expect(mockRoutines_CS.start).toHaveBeenCalled();
247
- expect(mockBotIO_CS.start).toHaveBeenCalled();
248
- expect(mockCommands_CS.start).toHaveBeenCalled();
249
- });
250
-
251
- it('| should throw error if discordServer not initialized', async () => {
252
- (service as any)._discordServer = null;
253
-
254
- try {
255
- await service.start('test-issuer');
256
- fail('Should have thrown an error');
257
- } catch (error) {
258
- expect(error).toBeInstanceOf(DyFM_Error);
259
- expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-ST01');
260
- }
261
- });
262
- });
263
-
264
- describe('| getRoleByName', () => {
265
- it('| should return role from cache if exists', () => {
266
- const mockRole = jasmine.createSpyObj('Role', [], {
267
- id: 'role-123',
268
- name: 'Test Role',
269
- });
270
- (service as any)._rolesByNames['Test Role'] = mockRole;
271
-
272
- const result = service.getRoleByName('Test Role');
273
-
274
- expect(result).toBe(mockRole);
275
- });
276
-
277
- it('| should find role in guild and cache it', () => {
278
- const mockRole = jasmine.createSpyObj('Role', [], {
279
- id: 'role-123',
280
- name: 'Test Role',
281
- });
282
- ((mockGuild.roles.cache as unknown) as { find: jasmine.Spy }).find =
283
- jasmine.createSpy('cache.find').and.returnValue(mockRole);
284
-
285
- const result = service.getRoleByName('Test Role');
286
-
287
- // Use toEqual for object comparison
288
- expect(result).toEqual(mockRole);
289
- expect((service as any)._rolesByNames['Test Role']).toEqual(mockRole);
290
- });
291
- });
292
-
293
- describe('| getChannelByName', () => {
294
- it('| should return channel from cache if exists', () => {
295
- (service as any)._channelsByNames['test-channel'] = mockTextChannel;
296
-
297
- const result = service.getChannelByName('test-channel');
298
-
299
- expect(result).toBe(mockTextChannel);
300
- });
301
-
302
- // Skip this test - requires findTextChannelByName which may not be available
303
- it('| should find channel in guild and cache it', () => {
304
- // Skipped - DyNTS_DiBo_Operations_Util.findTextChannelByName may not be available
305
- });
306
- });
307
-
308
- describe('| getRolePingByName', () => {
309
- it('| should return role ping', async () => {
310
- const mockRole = jasmine.createSpyObj('Role', [], {
311
- id: 'role-123',
312
- name: 'Test Role',
313
- });
314
- spyOn(service, 'getRoleByName').and.returnValue(mockRole);
315
-
316
- const result = await service.getRolePingByName('Test Role');
317
-
318
- expect(result).toBe('<@&role-123>');
319
- });
320
-
321
- it('| should return empty string if role not found', async () => {
322
- spyOn(service, 'getRoleByName').and.returnValue(null);
323
-
324
- const result = await service.getRolePingByName('Non-existent');
325
-
326
- expect(result).toBe('');
327
- });
328
- });
329
-
330
- describe('| getRolePingsByName', () => {
331
- it('| should return multiple role pings', async () => {
332
- spyOn(service, 'getRolePingByName').and.returnValues(
333
- Promise.resolve('<@&role-1>'),
334
- Promise.resolve('<@&role-2>')
335
- );
336
-
337
- const result = await service.getRolePingsByName(['Role1', 'Role2']);
338
-
339
- expect(result).toBe('<@&role-1> <@&role-2>');
340
- });
341
- });
342
-
343
- describe('| sendMessageToChannelByName', () => {
344
- it('| should send message to channel', async () => {
345
- const mockMessage = jasmine.createSpyObj('Message', [], {
346
- id: 'message-123',
347
- content: 'Test message',
348
- });
349
- spyOn(service, 'getChannelByName').and.returnValue(mockTextChannel);
350
- mockTextChannel.send.and.returnValue(Promise.resolve(mockMessage));
351
-
352
- const result = await service.sendMessageToChannelByName('test-channel', 'Test message', 'test-issuer');
353
-
354
- expect(mockTextChannel.send).toHaveBeenCalledWith('Test message');
355
- expect(result).toBe(mockMessage);
356
- });
357
-
358
- it('| should split long messages', async () => {
359
- const longMessage = 'x'.repeat(5000);
360
- const mockMessage = jasmine.createSpyObj('Message', [], {
361
- id: 'message-123',
362
- content: 'Test message',
363
- });
364
- spyOn(service, 'getChannelByName').and.returnValue(mockTextChannel);
365
- // Return mockMessage for each call
366
- mockTextChannel.send.and.returnValue(Promise.resolve(mockMessage));
367
-
368
- const result = await service.sendMessageToChannelByName('test-channel', longMessage, 'test-issuer');
369
-
370
- // Message split depends on implementation - expect at least 2 calls for long message
371
- expect(mockTextChannel.send).toHaveBeenCalled();
372
- expect(mockTextChannel.send.calls.count()).toBeGreaterThanOrEqual(2);
373
- // Result may be undefined or the last message, depending on implementation
374
- // Just verify that send was called multiple times for long messages
375
- expect(result === undefined || result === mockMessage).toBeTrue();
376
- });
377
-
378
- it('| should throw error if channel not found', async () => {
379
- spyOn(service, 'getChannelByName').and.returnValue(null);
380
-
381
- try {
382
- await service.sendMessageToChannelByName('non-existent', 'Test', 'test-issuer');
383
- fail('Should have thrown an error');
384
- } catch (error) {
385
- expect(error).toBeInstanceOf(DyFM_Error);
386
- expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-SMCN1');
387
- }
388
- });
389
-
390
- it('| should throw error if channel is not text-based', async () => {
391
- const voiceChannel = jasmine.createSpyObj('VoiceChannel', [], {
392
- id: 'voice-123',
393
- name: 'voice-channel',
394
- isTextBased: () => false,
395
- });
396
- spyOn(service, 'getChannelByName').and.returnValue(voiceChannel);
397
-
398
- try {
399
- await service.sendMessageToChannelByName('voice-channel', 'Test', 'test-issuer');
400
- fail('Should have thrown an error');
401
- } catch (error) {
402
- expect(error).toBeInstanceOf(DyFM_Error);
403
- expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-SMCN2');
404
- }
405
- });
406
- });
407
- });
408
-
1
+
2
+ import { DyNTS_DiBo_Main_ControlService } from './dibo-main.control-service';
3
+ import { Client, GatewayIntentBits, Guild, TextChannel, Message, Role } from 'discord.js';
4
+ import { DyFM_Error, DyFM_Log, DyFM_Async } from '@futdevpro/fsm-dynamo';
5
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
6
+ import { DyNTS_DiBo_IO_ControlService } from './dibo-io.control-service';
7
+ import { DyNTS_DiBo_Routines_ControlService } from './dibo-routines.control-service';
8
+ import { DyNTS_DiBo_Commands_ControlService } from './dibo-commands.control-service';
9
+ import { second } from '@futdevpro/fsm-dynamo';
10
+
11
+ class TestDiBoMainService extends DyNTS_DiBo_Main_ControlService {
12
+ protected getBotIOControlService(): DyNTS_DiBo_IO_ControlService {
13
+ return this.botIO_CS;
14
+ }
15
+
16
+ protected getRoutinesControlService(): DyNTS_DiBo_Routines_ControlService {
17
+ return this.routines_CS;
18
+ }
19
+
20
+ protected getCommandsControlService(): DyNTS_DiBo_Commands_ControlService {
21
+ return this.commands_CS;
22
+ }
23
+
24
+ static getInstance(): TestDiBoMainService {
25
+ return TestDiBoMainService.getSingletonInstance();
26
+ }
27
+ }
28
+
29
+ xdescribe('| DyNTS_DiBo_Main_ControlService', () => {
30
+ let service: TestDiBoMainService;
31
+ let mockClient: jasmine.SpyObj<Client>;
32
+ let mockGuild: jasmine.SpyObj<Guild>;
33
+ let mockTextChannel: jasmine.SpyObj<TextChannel>;
34
+ let mockBotIO_CS: jasmine.SpyObj<DyNTS_DiBo_IO_ControlService>;
35
+ let mockRoutines_CS: jasmine.SpyObj<DyNTS_DiBo_Routines_ControlService>;
36
+ let mockCommands_CS: jasmine.SpyObj<DyNTS_DiBo_Commands_ControlService>;
37
+
38
+ beforeEach(() => {
39
+ // Mock global settings
40
+ DyNTS_global_settings.env_settings = {
41
+ environment: 'local',
42
+ discord: {
43
+ token: 'test-token',
44
+ guildId: 'guild-123',
45
+ clientId: 'client-123',
46
+ oauth2Url: 'https://oauth2.example.com',
47
+ },
48
+ mongoUri: undefined,
49
+ openAi: {},
50
+ } as any;
51
+
52
+ DyNTS_global_settings.bot_settings = {
53
+ intents: [GatewayIntentBits.Guilds],
54
+ partials: [],
55
+ } as any;
56
+
57
+ // Create mock services
58
+ mockBotIO_CS = jasmine.createSpyObj('DyNTS_DiBo_IO_ControlService', ['setup', 'start', 'handleNewMessage']);
59
+ mockRoutines_CS = jasmine.createSpyObj('DyNTS_DiBo_Routines_ControlService', ['setup', 'start']);
60
+ mockCommands_CS = jasmine.createSpyObj('DyNTS_DiBo_Commands_ControlService', ['setup', 'start']);
61
+
62
+ // Create mock Discord objects
63
+ mockTextChannel = jasmine.createSpyObj('TextChannel', ['send'], {
64
+ id: 'channel-123',
65
+ name: 'test-channel',
66
+ isTextBased: () => true,
67
+ });
68
+
69
+ mockGuild = jasmine.createSpyObj('Guild', [], {
70
+ id: 'guild-123',
71
+ channels: {
72
+ cache: new Map([['channel-123', mockTextChannel]]),
73
+ },
74
+ roles: {
75
+ cache: new Map(),
76
+ },
77
+ });
78
+
79
+ mockClient = jasmine.createSpyObj('Client', ['login', 'on'], {
80
+ user: {
81
+ id: 'bot-123',
82
+ tag: 'TestBot#1234',
83
+ displayName: 'Test Bot',
84
+ },
85
+ guilds: {
86
+ cache: new Map([['guild-123', mockGuild]]),
87
+ get: jasmine.createSpy('guilds.get').and.returnValue(mockGuild),
88
+ },
89
+ });
90
+
91
+ // Mock Client constructor by preventing actual Client instantiation
92
+ // We'll create the service without calling the constructor that creates Client
93
+ service = TestDiBoMainService.getInstance();
94
+ (service as any).client = mockClient;
95
+ (service as any)._discordServer = mockGuild;
96
+ (service as any).botIO_CS = mockBotIO_CS;
97
+ (service as any).routines_CS = mockRoutines_CS;
98
+ (service as any).commands_CS = mockCommands_CS;
99
+ });
100
+
101
+ afterEach(async () => {
102
+ try {
103
+ // Megvárjuk, hogy a bot leálljon és a process listener-ek lefussanak
104
+ await DyFM_Async.delay(200);
105
+
106
+ // Biztosítjuk, hogy a discordServer ne próbáljon üzenetet küldeni
107
+ if (service && (service as any)._discordServer) {
108
+ const discordServer = (service as any)._discordServer as Guild;
109
+ // Invalidáljuk a channels.cache-t, hogy ne próbáljon channel-t keresni
110
+ if (discordServer.channels && discordServer.channels.cache) {
111
+ // Invalidáljuk a cache-t, hogy ne lehessen használni
112
+ (discordServer.channels as any).cache = undefined;
113
+ }
114
+ // Invalidáljuk a channels-t is
115
+ (discordServer as any).channels = undefined;
116
+ }
117
+
118
+ // Invalidáljuk a discordServer-t is
119
+ if (service) {
120
+ (service as any)._discordServer = undefined;
121
+ }
122
+
123
+ await DyFM_Async.delay(200);
124
+ } catch (error) {
125
+ // Csendes hiba-kezelés
126
+ }
127
+ });
128
+
129
+ afterAll(async () => {
130
+ try {
131
+ // Végleges cleanup a tesztek végén - megvárjuk, hogy minden process listener lefusson
132
+ await DyFM_Async.delay(500);
133
+
134
+ // Invalidáljuk a service-t is
135
+ if (service) {
136
+ (service as any)._discordServer = undefined;
137
+ (service as any).client = undefined;
138
+ }
139
+
140
+ await DyFM_Async.delay(500);
141
+ } catch (error) {
142
+ // Csendes hiba-kezelés
143
+ }
144
+ });
145
+
146
+ describe('| constructor', () => {
147
+ it('| should initialize Discord client', () => {
148
+ expect(service.client).toBeDefined();
149
+ });
150
+
151
+ it('| should throw error if client already initialized', () => {
152
+ // This test is skipped because we can't easily mock the Client constructor
153
+ // The service is already initialized via getInstance()
154
+ expect(service.client).toBeDefined();
155
+ });
156
+ });
157
+
158
+ describe('| properties', () => {
159
+ it('| should return discordServer', () => {
160
+ expect(service.discordServer).toBe(mockGuild);
161
+ });
162
+
163
+ it('| should return botClientId from client user', () => {
164
+ expect(service.botClientId).toBe('bot-123');
165
+ });
166
+
167
+ it('| should return botDisplayName from client user', () => {
168
+ expect(service.botDisplayName).toBe('Test Bot');
169
+ });
170
+ });
171
+
172
+ describe('| setup', () => {
173
+ it('| should setup bot services', async () => {
174
+ mockClient.login.and.returnValue(Promise.resolve('token'));
175
+ mockClient.on.and.callFake((event: string, callback: Function): any => {
176
+ if (event === 'ready') {
177
+ setTimeout(() => callback(), 10);
178
+ }
179
+ });
180
+
181
+ mockBotIO_CS.setup.and.returnValue(Promise.resolve());
182
+ mockRoutines_CS.setup.and.returnValue(Promise.resolve());
183
+ mockCommands_CS.setup.and.returnValue(Promise.resolve());
184
+
185
+ await service.setup('test-issuer');
186
+
187
+ expect(mockBotIO_CS.setup).toHaveBeenCalled();
188
+ expect(mockRoutines_CS.setup).toHaveBeenCalled();
189
+ expect(mockCommands_CS.setup).toHaveBeenCalled();
190
+ });
191
+
192
+ it('| should throw error if guildId not found', async () => {
193
+ DyNTS_global_settings.env_settings.discord.guildId = null as any;
194
+
195
+ try {
196
+ await service.setup('test-issuer');
197
+ fail('Should have thrown an error');
198
+ } catch (error) {
199
+ // Error may be wrapped in DyFM_Error
200
+ expect(error).toBeDefined();
201
+ const errorMessage = (error as DyFM_Error)?._message || (error as Error)?.message || '';
202
+ expect(errorMessage).toContain('No discord server id found');
203
+ }
204
+ });
205
+
206
+ it('| should throw error if token not found', async () => {
207
+ DyNTS_global_settings.env_settings.discord.token = null as any;
208
+
209
+ try {
210
+ await service.setup('test-issuer');
211
+ fail('Should have thrown an error');
212
+ } catch (error) {
213
+ // Error may be wrapped in DyFM_Error
214
+ expect(error).toBeDefined();
215
+ const errorMessage = (error as DyFM_Error)?._message || (error as Error)?.message || '';
216
+ expect(errorMessage).toContain('No discord token found');
217
+ }
218
+ });
219
+
220
+ it('| should throw error if botIO_CS not found', async () => {
221
+ (service as any).botIO_CS = null;
222
+ mockClient.login.and.returnValue(Promise.resolve('token'));
223
+ mockClient.on.and.callFake((event: string, callback: Function): any => {
224
+ if (event === 'ready') {
225
+ setTimeout(() => callback(), 10);
226
+ }
227
+ });
228
+
229
+ try {
230
+ await service.setup('test-issuer');
231
+ fail('Should have thrown an error');
232
+ } catch (error) {
233
+ expect(error).toBeInstanceOf(DyFM_Error);
234
+ }
235
+ });
236
+ });
237
+
238
+ describe('| start', () => {
239
+ it('| should start bot services', async () => {
240
+ mockRoutines_CS.start.and.returnValue(Promise.resolve());
241
+ mockBotIO_CS.start.and.returnValue(Promise.resolve());
242
+ mockCommands_CS.start.and.returnValue(Promise.resolve());
243
+
244
+ await service.start('test-issuer');
245
+
246
+ expect(mockRoutines_CS.start).toHaveBeenCalled();
247
+ expect(mockBotIO_CS.start).toHaveBeenCalled();
248
+ expect(mockCommands_CS.start).toHaveBeenCalled();
249
+ });
250
+
251
+ it('| should throw error if discordServer not initialized', async () => {
252
+ (service as any)._discordServer = null;
253
+
254
+ try {
255
+ await service.start('test-issuer');
256
+ fail('Should have thrown an error');
257
+ } catch (error) {
258
+ expect(error).toBeInstanceOf(DyFM_Error);
259
+ expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-ST01');
260
+ }
261
+ });
262
+ });
263
+
264
+ describe('| getRoleByName', () => {
265
+ it('| should return role from cache if exists', () => {
266
+ const mockRole = jasmine.createSpyObj('Role', [], {
267
+ id: 'role-123',
268
+ name: 'Test Role',
269
+ });
270
+ (service as any)._rolesByNames['Test Role'] = mockRole;
271
+
272
+ const result = service.getRoleByName('Test Role');
273
+
274
+ expect(result).toBe(mockRole);
275
+ });
276
+
277
+ it('| should find role in guild and cache it', () => {
278
+ const mockRole = jasmine.createSpyObj('Role', [], {
279
+ id: 'role-123',
280
+ name: 'Test Role',
281
+ });
282
+ ((mockGuild.roles.cache as unknown) as { find: jasmine.Spy }).find =
283
+ jasmine.createSpy('cache.find').and.returnValue(mockRole);
284
+
285
+ const result = service.getRoleByName('Test Role');
286
+
287
+ // Use toEqual for object comparison
288
+ expect(result).toEqual(mockRole);
289
+ expect((service as any)._rolesByNames['Test Role']).toEqual(mockRole);
290
+ });
291
+ });
292
+
293
+ describe('| getChannelByName', () => {
294
+ it('| should return channel from cache if exists', () => {
295
+ (service as any)._channelsByNames['test-channel'] = mockTextChannel;
296
+
297
+ const result = service.getChannelByName('test-channel');
298
+
299
+ expect(result).toBe(mockTextChannel);
300
+ });
301
+
302
+ // Skip this test - requires findTextChannelByName which may not be available
303
+ it('| should find channel in guild and cache it', () => {
304
+ // Skipped - DyNTS_DiBo_Operations_Util.findTextChannelByName may not be available
305
+ });
306
+ });
307
+
308
+ describe('| getRolePingByName', () => {
309
+ it('| should return role ping', async () => {
310
+ const mockRole = jasmine.createSpyObj('Role', [], {
311
+ id: 'role-123',
312
+ name: 'Test Role',
313
+ });
314
+ spyOn(service, 'getRoleByName').and.returnValue(mockRole);
315
+
316
+ const result = await service.getRolePingByName('Test Role');
317
+
318
+ expect(result).toBe('<@&role-123>');
319
+ });
320
+
321
+ it('| should return empty string if role not found', async () => {
322
+ spyOn(service, 'getRoleByName').and.returnValue(null);
323
+
324
+ const result = await service.getRolePingByName('Non-existent');
325
+
326
+ expect(result).toBe('');
327
+ });
328
+ });
329
+
330
+ describe('| getRolePingsByName', () => {
331
+ it('| should return multiple role pings', async () => {
332
+ spyOn(service, 'getRolePingByName').and.returnValues(
333
+ Promise.resolve('<@&role-1>'),
334
+ Promise.resolve('<@&role-2>')
335
+ );
336
+
337
+ const result = await service.getRolePingsByName(['Role1', 'Role2']);
338
+
339
+ expect(result).toBe('<@&role-1> <@&role-2>');
340
+ });
341
+ });
342
+
343
+ describe('| sendMessageToChannelByName', () => {
344
+ it('| should send message to channel', async () => {
345
+ const mockMessage = jasmine.createSpyObj('Message', [], {
346
+ id: 'message-123',
347
+ content: 'Test message',
348
+ });
349
+ spyOn(service, 'getChannelByName').and.returnValue(mockTextChannel);
350
+ mockTextChannel.send.and.returnValue(Promise.resolve(mockMessage));
351
+
352
+ const result = await service.sendMessageToChannelByName('test-channel', 'Test message', 'test-issuer');
353
+
354
+ expect(mockTextChannel.send).toHaveBeenCalledWith('Test message');
355
+ expect(result).toBe(mockMessage);
356
+ });
357
+
358
+ it('| should split long messages', async () => {
359
+ const longMessage = 'x'.repeat(5000);
360
+ const mockMessage = jasmine.createSpyObj('Message', [], {
361
+ id: 'message-123',
362
+ content: 'Test message',
363
+ });
364
+ spyOn(service, 'getChannelByName').and.returnValue(mockTextChannel);
365
+ // Return mockMessage for each call
366
+ mockTextChannel.send.and.returnValue(Promise.resolve(mockMessage));
367
+
368
+ const result = await service.sendMessageToChannelByName('test-channel', longMessage, 'test-issuer');
369
+
370
+ // Message split depends on implementation - expect at least 2 calls for long message
371
+ expect(mockTextChannel.send).toHaveBeenCalled();
372
+ expect(mockTextChannel.send.calls.count()).toBeGreaterThanOrEqual(2);
373
+ // Result may be undefined or the last message, depending on implementation
374
+ // Just verify that send was called multiple times for long messages
375
+ expect(result === undefined || result === mockMessage).toBeTrue();
376
+ });
377
+
378
+ it('| should throw error if channel not found', async () => {
379
+ spyOn(service, 'getChannelByName').and.returnValue(null);
380
+
381
+ try {
382
+ await service.sendMessageToChannelByName('non-existent', 'Test', 'test-issuer');
383
+ fail('Should have thrown an error');
384
+ } catch (error) {
385
+ expect(error).toBeInstanceOf(DyFM_Error);
386
+ expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-SMCN1');
387
+ }
388
+ });
389
+
390
+ it('| should throw error if channel is not text-based', async () => {
391
+ const voiceChannel = jasmine.createSpyObj('VoiceChannel', [], {
392
+ id: 'voice-123',
393
+ name: 'voice-channel',
394
+ isTextBased: () => false,
395
+ });
396
+ spyOn(service, 'getChannelByName').and.returnValue(voiceChannel);
397
+
398
+ try {
399
+ await service.sendMessageToChannelByName('voice-channel', 'Test', 'test-issuer');
400
+ fail('Should have thrown an error');
401
+ } catch (error) {
402
+ expect(error).toBeInstanceOf(DyFM_Error);
403
+ expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-MCS-SMCN2');
404
+ }
405
+ });
406
+ });
407
+ });
408
+