@futdevpro/nts-dynamo 1.15.151 → 1.15.153

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 (621) 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 +190 -190
  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 +780 -754
  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/2026-08-08-fr292-app-version-header.md +38 -38
  40. package/__documentations/2026-08-14-field-encryption-mongoose-document-spread.md +124 -124
  41. package/__documentations/2026-08-18-artifact-compiler.md +46 -46
  42. package/__documentations/2026-08-18-mongo-transaction-control-service.md +82 -82
  43. package/__documentations/2026-08-18-standalone-account-security-and-privacy-bedrock.md +132 -132
  44. package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +59 -59
  45. package/__documentations/2026-08-22-npm-token-state-classifier.md +92 -92
  46. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  47. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  48. package/_specifications/BACKLOG.md +92 -92
  49. package/_specifications/TODO.md +15 -15
  50. package/_specifications/agent.md +138 -138
  51. package/build/_modules/server/index.d.ts +4 -0
  52. package/build/_modules/server/index.d.ts.map +1 -1
  53. package/build/_modules/server/index.js +4 -0
  54. package/build/_modules/server/index.js.map +1 -1
  55. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts +14 -0
  56. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts.map +1 -0
  57. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.js +18 -0
  58. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.js.map +1 -0
  59. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.d.ts +8 -0
  60. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.d.ts.map +1 -0
  61. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.js +12 -0
  62. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.js.map +1 -0
  63. package/build/_modules/server/server-status/db-readiness-probe.control-service.d.ts +14 -0
  64. package/build/_modules/server/server-status/db-readiness-probe.control-service.d.ts.map +1 -0
  65. package/build/_modules/server/server-status/db-readiness-probe.control-service.js +126 -0
  66. package/build/_modules/server/server-status/db-readiness-probe.control-service.js.map +1 -0
  67. package/build/_modules/server/server-status/db-readiness-probe.interface.d.ts +18 -0
  68. package/build/_modules/server/server-status/db-readiness-probe.interface.d.ts.map +1 -0
  69. package/build/_modules/server/server-status/db-readiness-probe.interface.js +3 -0
  70. package/build/_modules/server/server-status/db-readiness-probe.interface.js.map +1 -0
  71. package/eslint.config.js +3 -3
  72. package/nodemon.json +24 -24
  73. package/package.json +1 -1
  74. package/pnpm-workspace.yaml +6 -6
  75. package/scripts/_seed-out/aim-seed.fixtures.ts +161 -161
  76. package/scripts/_seed-out/llm-expand-raw.json +59 -59
  77. package/scripts/_seed-out/seed-raw.json +152 -152
  78. package/scripts/ai-fixture-seed.js +126 -126
  79. package/scripts/run-coverage-tests.js +28 -28
  80. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  81. package/spec/support/helpers/ts-node-helper.js +93 -93
  82. package/spec/support/jasmine.coverage.json +24 -24
  83. package/spec/support/jasmine.json +24 -24
  84. package/src/_collections/app-version-header.util.spec.ts +108 -108
  85. package/src/_collections/app-version-header.util.ts +74 -74
  86. package/src/_collections/archive-service-registry.const.ts +21 -21
  87. package/src/_collections/archive.util.spec.ts +57 -57
  88. package/src/_collections/archive.util.ts +18 -18
  89. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  90. package/src/_collections/client-safe-error.util.spec.ts +151 -151
  91. package/src/_collections/client-safe-error.util.ts +107 -107
  92. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  93. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  94. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  95. package/src/_collections/default-not-found-page.const.ts +22 -22
  96. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  97. package/src/_collections/default-socket-path.const.ts +2 -2
  98. package/src/_collections/field-encryption.util.spec.ts +195 -195
  99. package/src/_collections/field-encryption.util.ts +222 -222
  100. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  101. package/src/_collections/get-environment-settings.util.ts +48 -48
  102. package/src/_collections/global-settings.const.ts +126 -126
  103. package/src/_collections/load-shed.util.spec.ts +62 -62
  104. package/src/_collections/load-shed.util.ts +51 -51
  105. package/src/_collections/mongo-reconnect-guard.util.spec.ts +52 -52
  106. package/src/_collections/mongo-reconnect-guard.util.ts +172 -172
  107. package/src/_collections/npm-token-check.util.spec.ts +218 -218
  108. package/src/_collections/npm-token-check.util.ts +327 -327
  109. package/src/_collections/sample.env +21 -21
  110. package/src/_collections/security-headers.util.spec.ts +98 -98
  111. package/src/_collections/security-headers.util.ts +96 -96
  112. package/src/_collections/signed-url.util.spec.ts +198 -198
  113. package/src/_collections/signed-url.util.ts +170 -170
  114. package/src/_collections/star.controller.spec.ts +224 -224
  115. package/src/_collections/star.controller.ts +129 -129
  116. package/src/_collections/static-cache-control.util.spec.ts +47 -47
  117. package/src/_collections/static-cache-control.util.ts +25 -25
  118. package/src/_enums/data-model-type.enum.ts +14 -14
  119. package/src/_enums/data-service-function.enum.ts +24 -24
  120. package/src/_enums/predefined-data-types.enum.ts +16 -16
  121. package/src/_enums/route-security.enum.ts +12 -12
  122. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  123. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  124. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  125. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  126. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  127. package/src/_models/control-models/app-params.control-model.ts +136 -136
  128. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  129. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  130. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  131. package/src/_models/control-models/endpoint-params.control-model.ts +664 -664
  132. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  133. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  134. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  135. package/src/_models/control-models/system-control.control-model.ts +12 -12
  136. package/src/_models/data-models/schema-migration.data-model.ts +50 -50
  137. package/src/_models/interfaces/app-version-header-settings.interface.ts +17 -17
  138. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  139. package/src/_models/interfaces/compare-data-options.interface.ts +27 -27
  140. package/src/_models/interfaces/compare-data-result.interface.ts +12 -12
  141. package/src/_models/interfaces/cors-settings.interface.spec.ts +52 -52
  142. package/src/_models/interfaces/cors-settings.interface.ts +56 -56
  143. package/src/_models/interfaces/db-query-options.interface.ts +33 -33
  144. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  145. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  146. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  147. package/src/_models/interfaces/global-settings.interface.ts +294 -294
  148. package/src/_models/interfaces/migration-entry.interface.ts +19 -19
  149. package/src/_models/interfaces/mongo-transaction-settings.interface.ts +9 -9
  150. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  151. package/src/_models/interfaces/security-headers-settings.interface.ts +50 -50
  152. package/src/_models/interfaces/signed-url-verify-result.interface.ts +13 -13
  153. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  154. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  155. package/src/_models/types/db-update.type.ts +100 -100
  156. package/src/_modules/account-security/_enums/account-challenge-purpose.type-enum.ts +5 -5
  157. package/src/_modules/account-security/_enums/account-refresh-token-state.type-enum.ts +6 -6
  158. package/src/_modules/account-security/_enums/account-session-state.type-enum.ts +6 -6
  159. package/src/_modules/account-security/_models/account-challenge-adapter.interface.ts +17 -17
  160. package/src/_modules/account-security/_models/account-challenge-issued.interface.ts +6 -6
  161. package/src/_modules/account-security/_models/account-challenge-record.interface.ts +13 -13
  162. package/src/_modules/account-security/_models/account-challenge-result.interface.ts +8 -8
  163. package/src/_modules/account-security/_models/account-challenge-settings.interface.ts +9 -9
  164. package/src/_modules/account-security/_models/account-password-policy.interface.ts +11 -11
  165. package/src/_modules/account-security/_models/account-password-verification.interface.ts +5 -5
  166. package/src/_modules/account-security/_models/account-refresh-token-record.interface.ts +13 -13
  167. package/src/_modules/account-security/_models/account-session-adapter.interface.ts +19 -19
  168. package/src/_modules/account-security/_models/account-session-claims.interface.ts +7 -7
  169. package/src/_modules/account-security/_models/account-session-context.interface.ts +6 -6
  170. package/src/_modules/account-security/_models/account-session-create.interface.ts +8 -8
  171. package/src/_modules/account-security/_models/account-session-record.interface.ts +21 -21
  172. package/src/_modules/account-security/_models/account-session-rotate.interface.ts +11 -11
  173. package/src/_modules/account-security/_models/account-session-settings.interface.ts +11 -11
  174. package/src/_modules/account-security/_models/account-session-token-pair.interface.ts +8 -8
  175. package/src/_modules/account-security/_models/account-session-view.interface.ts +13 -13
  176. package/src/_modules/account-security/account-challenge.control-service.spec.ts +195 -195
  177. package/src/_modules/account-security/account-challenge.control-service.ts +164 -164
  178. package/src/_modules/account-security/account-password.control-service.spec.ts +96 -96
  179. package/src/_modules/account-security/account-password.control-service.ts +288 -288
  180. package/src/_modules/account-security/account-session.control-service.spec.ts +294 -294
  181. package/src/_modules/account-security/account-session.control-service.ts +376 -376
  182. package/src/_modules/account-security/index.ts +31 -31
  183. package/src/_modules/admin-auth/_models/admin-api-key-config.interface.ts +33 -33
  184. package/src/_modules/admin-auth/admin-api-key.auth-service.spec.ts +200 -200
  185. package/src/_modules/admin-auth/admin-api-key.auth-service.ts +220 -220
  186. package/src/_modules/admin-auth/index.ts +2 -2
  187. package/src/_modules/ai/_collections/ai-model-config-validator.util.spec.ts +150 -150
  188. package/src/_modules/ai/_collections/ai-model-config-validator.util.ts +131 -131
  189. package/src/_modules/ai/_collections/ai-provider-error.util.ts +144 -144
  190. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  191. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  192. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts +14 -14
  193. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts +56 -56
  194. package/src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts +16 -16
  195. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.spec.ts +72 -72
  196. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts +71 -71
  197. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.spec.ts +57 -57
  198. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts +60 -60
  199. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.spec.ts +56 -56
  200. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts +117 -117
  201. package/src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts +28 -28
  202. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.ts +14 -14
  203. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.ts +11 -11
  204. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.ts +30 -30
  205. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.ts +19 -19
  206. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.ts +20 -20
  207. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  208. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  209. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.spec.ts +134 -134
  210. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.ts +127 -127
  211. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-pipeline.spec.ts +105 -105
  212. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.spec.ts +50 -50
  213. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.ts +65 -65
  214. package/src/_modules/ai/_modules/ai-mock/_services/aim-integration-proof.spec.ts +92 -92
  215. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.spec.ts +112 -112
  216. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts +155 -155
  217. package/src/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.ts +649 -649
  218. package/src/_modules/ai/_modules/ai-mock/index.ts +47 -47
  219. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  220. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  221. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  222. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  223. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  224. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +552 -552
  225. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  226. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  227. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  228. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  229. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  230. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  231. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  232. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  233. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  234. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  235. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  236. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  237. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  238. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  239. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  240. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  241. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  242. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  243. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  244. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  245. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  246. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.ts +572 -572
  247. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  248. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.ts +435 -435
  249. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  250. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  251. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  252. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +132 -132
  253. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  254. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  255. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  256. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  257. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  258. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  259. package/src/_modules/ai/_modules/open-ai/index.ts +74 -74
  260. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  261. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  262. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  263. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  264. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  265. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  266. package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts +133 -133
  267. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  268. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  269. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  270. package/src/_modules/ai/_services/ai-provider.service-base.ts +67 -67
  271. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  272. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  273. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +399 -399
  274. package/src/_modules/ai/index.ts +33 -33
  275. package/src/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.ts +5 -5
  276. package/src/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.ts +8 -8
  277. package/src/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.ts +6 -6
  278. package/src/_modules/artifact-compiler/_models/artifact-compile.interface.ts +35 -35
  279. package/src/_modules/artifact-compiler/artifact-compiler.control-service.spec.ts +151 -151
  280. package/src/_modules/artifact-compiler/artifact-compiler.control-service.ts +356 -356
  281. package/src/_modules/artifact-compiler/index.ts +9 -9
  282. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  283. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  284. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  285. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  286. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  287. package/src/_modules/assistant/_services/ass-io.control-service.ts +74 -74
  288. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  289. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  290. package/src/_modules/assistant/index.ts +19 -19
  291. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  292. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  293. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  294. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  295. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  296. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  297. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  298. package/src/_modules/bot/_models/bot-message-wrapper.interface.ts +90 -90
  299. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  300. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  301. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  302. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.ts +641 -641
  303. package/src/_modules/bot/_modules/discord-bot/index.ts +12 -12
  304. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  305. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  306. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  307. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  308. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  309. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  310. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  311. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  312. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  313. package/src/_modules/bot/_modules/slack-bot/index.ts +12 -12
  314. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  315. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  316. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  317. package/src/_modules/bot/_modules/teams-bot/index.ts +11 -11
  318. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  319. package/src/_modules/bot/_services/bot-commands.control-service.ts +158 -158
  320. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  321. package/src/_modules/bot/_services/bot-io.control-service.ts +329 -329
  322. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  323. package/src/_modules/bot/_services/bot-main.control-service.ts +489 -489
  324. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  325. package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts +158 -158
  326. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  327. package/src/_modules/bot/_services/bot-routines.control-service.ts +78 -78
  328. package/src/_modules/bot/index.ts +37 -37
  329. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  330. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  331. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  332. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  333. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  334. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  335. package/src/_modules/custom-data/index.ts +9 -9
  336. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +176 -176
  337. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  338. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  339. package/src/_modules/data-readers/index.ts +11 -11
  340. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  341. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  342. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  343. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  344. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  345. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  346. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  347. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  348. package/src/_modules/defaults/index.ts +17 -17
  349. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  350. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  351. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  352. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  353. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  354. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  355. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  356. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  357. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  358. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  359. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  360. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  361. package/src/_modules/discord-assistant/index.ts +38 -38
  362. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  363. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  364. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  365. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  366. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  367. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  368. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  369. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  370. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  371. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  372. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  373. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  374. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  375. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  376. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  377. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  378. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  379. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  380. package/src/_modules/discord-bot/_services/dibo-routines.control-service.ts +97 -97
  381. package/src/_modules/discord-bot/index.ts +36 -36
  382. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  383. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +60 -60
  384. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  385. package/src/_modules/local-vector-search/_services/lvs-bm25.util.spec.ts +159 -159
  386. package/src/_modules/local-vector-search/_services/lvs-bm25.util.ts +206 -206
  387. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  388. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  389. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  390. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  391. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  392. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  393. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  394. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  395. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  396. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  397. package/src/_modules/local-vector-search/index.ts +16 -16
  398. package/src/_modules/logs/_models/file-log-entry.interface.ts +13 -13
  399. package/src/_modules/logs/_models/file-log-read-result.interface.ts +37 -37
  400. package/src/_modules/logs/file-log.service.spec.ts +341 -341
  401. package/src/_modules/logs/file-log.service.ts +466 -466
  402. package/src/_modules/logs/file-logs.controller.spec.ts +245 -245
  403. package/src/_modules/logs/file-logs.controller.ts +165 -165
  404. package/src/_modules/logs/get-file-logs-routing-module.util.ts +51 -51
  405. package/src/_modules/logs/get-logs-routing-module.util.ts +36 -36
  406. package/src/_modules/logs/index.ts +11 -11
  407. package/src/_modules/logs/log-buffer.service.ts +101 -101
  408. package/src/_modules/logs/logs.controller.ts +109 -109
  409. package/src/_modules/logs/logs.service.ts +100 -100
  410. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  411. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +151 -151
  412. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +125 -125
  413. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  414. package/src/_modules/mcp/index.ts +13 -13
  415. package/src/_modules/messaging/README.md +354 -354
  416. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  417. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  418. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  419. package/src/_modules/messaging/_collections/msg.util.ts +83 -83
  420. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  421. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  422. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  423. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  424. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  425. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  426. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  427. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  428. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  429. package/src/_modules/messaging/_services/msg.controller.ts +370 -370
  430. package/src/_modules/messaging/index.ts +30 -30
  431. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  432. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  433. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  434. package/src/_modules/mock/app-params.mock.ts +9 -9
  435. package/src/_modules/mock/app-server.mock.ts +188 -188
  436. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  437. package/src/_modules/mock/auth-service.mock.ts +28 -28
  438. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  439. package/src/_modules/mock/controller.mock.ts +16 -16
  440. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  441. package/src/_modules/mock/data-model.mock.ts +82 -82
  442. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  443. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  444. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  445. package/src/_modules/mock/email-service.mock.ts +20 -20
  446. package/src/_modules/mock/email-template.mock.html +14 -14
  447. package/src/_modules/mock/endpoint.mock.ts +91 -91
  448. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  449. package/src/_modules/mock/socket-client.mock.ts +45 -45
  450. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  451. package/src/_modules/mock/socket-server.mock.ts +46 -46
  452. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  453. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  454. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  455. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  456. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  457. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  458. package/src/_modules/oauth2/index.ts +17 -17
  459. package/src/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.ts +5 -5
  460. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.ts +10 -10
  461. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.ts +7 -7
  462. package/src/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.ts +15 -15
  463. package/src/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.ts +9 -9
  464. package/src/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.ts +12 -12
  465. package/src/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.ts +7 -7
  466. package/src/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.ts +15 -15
  467. package/src/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.ts +7 -7
  468. package/src/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.ts +13 -13
  469. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.ts +9 -9
  470. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.ts +14 -14
  471. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.ts +8 -8
  472. package/src/_modules/privacy-lifecycle/_models/privacy-contributor.interface.ts +17 -17
  473. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.ts +21 -21
  474. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.ts +9 -9
  475. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.ts +7 -7
  476. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.ts +10 -10
  477. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.ts +7 -7
  478. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.ts +7 -7
  479. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.ts +11 -11
  480. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.ts +13 -13
  481. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.ts +19 -19
  482. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.ts +9 -9
  483. package/src/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.ts +7 -7
  484. package/src/_modules/privacy-lifecycle/_models/privacy-request-open.interface.ts +10 -10
  485. package/src/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.ts +7 -7
  486. package/src/_modules/privacy-lifecycle/_models/privacy-request-record.interface.ts +21 -21
  487. package/src/_modules/privacy-lifecycle/_models/privacy-request-result.interface.ts +8 -8
  488. package/src/_modules/privacy-lifecycle/_models/privacy-request-view.interface.ts +20 -20
  489. package/src/_modules/privacy-lifecycle/index.ts +40 -40
  490. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.spec.ts +206 -206
  491. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.ts +253 -253
  492. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.spec.ts +353 -353
  493. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.ts +586 -586
  494. package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +5 -5
  495. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +82 -82
  496. package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +9 -9
  497. package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +6 -6
  498. package/src/_modules/rate-limit/_models/rate-limit-policy.interface.ts +16 -16
  499. package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +9 -9
  500. package/src/_modules/rate-limit/index.ts +8 -8
  501. package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +91 -91
  502. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +488 -488
  503. package/src/_modules/rate-limit/rate-limit.middleware.ts +504 -504
  504. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  505. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  506. package/src/_modules/scheduler/index.ts +8 -8
  507. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  508. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  509. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  510. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  511. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  512. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +82 -82
  513. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  514. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +312 -312
  515. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +311 -311
  516. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +123 -123
  517. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +108 -108
  518. package/src/_modules/scoped-config/index.ts +17 -17
  519. package/src/_modules/server/errors/errors.control-service.spec.ts +246 -246
  520. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  521. package/src/_modules/server/errors/errors.controller.spec.ts +340 -340
  522. package/src/_modules/server/errors/errors.controller.ts +559 -559
  523. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  524. package/src/_modules/server/errors/errors.data-service.ts +867 -867
  525. package/src/_modules/server/index.ts +34 -30
  526. package/src/_modules/server/server-status/db-readiness-probe-code.type-enum.ts +13 -0
  527. package/src/_modules/server/server-status/db-readiness-probe-stage.type-enum.ts +7 -0
  528. package/src/_modules/server/server-status/db-readiness-probe.control-service.spec.ts +235 -0
  529. package/src/_modules/server/server-status/db-readiness-probe.control-service.ts +158 -0
  530. package/src/_modules/server/server-status/db-readiness-probe.interface.ts +20 -0
  531. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  532. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  533. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  534. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  535. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  536. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  537. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  538. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  539. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  540. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  541. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  542. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +165 -165
  543. package/src/_modules/socket/_models/socket-presence.control-model.ts +211 -211
  544. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  545. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +33 -33
  546. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  547. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  548. package/src/_modules/socket/_services/socket-server.service.spec.ts +272 -272
  549. package/src/_modules/socket/_services/socket-server.service.ts +1037 -1037
  550. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  551. package/src/_modules/socket/app-extended.server.ts +648 -648
  552. package/src/_modules/socket/index.ts +42 -42
  553. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  554. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  555. package/src/_modules/test/index.ts +11 -11
  556. package/src/_modules/test/test.controller.spec.ts +72 -72
  557. package/src/_modules/test/test.controller.ts +115 -115
  558. package/src/_modules/test-email-sink/_collections/test-email-pattern.const.ts +10 -10
  559. package/src/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.ts +41 -41
  560. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.spec.ts +112 -112
  561. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.ts +141 -141
  562. package/src/_modules/test-email-sink/get-sent-mail-routing-module.util.ts +29 -29
  563. package/src/_modules/test-email-sink/index.ts +11 -11
  564. package/src/_modules/test-email-sink/test-email-sink.controller.ts +83 -83
  565. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  566. package/src/_modules/usage/index.ts +15 -15
  567. package/src/_modules/usage/usage.controller.spec.ts +106 -106
  568. package/src/_modules/usage/usage.controller.ts +140 -140
  569. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  570. package/src/_modules/usage/usage.data-service.ts +185 -185
  571. package/src/_services/base/api.service-base.spec.ts +125 -125
  572. package/src/_services/base/api.service-base.ts +74 -74
  573. package/src/_services/base/archive-data.service.spec.ts +209 -209
  574. package/src/_services/base/archive-data.service.ts +228 -228
  575. package/src/_services/base/data.service.spec.ts +784 -784
  576. package/src/_services/base/data.service.ts +2792 -2792
  577. package/src/_services/base/db.service.encryption.spec.ts +76 -76
  578. package/src/_services/base/db.service.spec.ts +160 -160
  579. package/src/_services/base/db.service.ts +1698 -1698
  580. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  581. package/src/_services/base/singleton.service-base.ts +24 -24
  582. package/src/_services/base/singleton.service.spec.ts +114 -114
  583. package/src/_services/base/singleton.service.ts +38 -38
  584. package/src/_services/core/api.service.spec.ts +187 -187
  585. package/src/_services/core/api.service.ts +627 -627
  586. package/src/_services/core/auth.service.spec.ts +159 -159
  587. package/src/_services/core/auth.service.ts +174 -174
  588. package/src/_services/core/collection-growth-monitor.service.spec.ts +119 -119
  589. package/src/_services/core/collection-growth-monitor.service.ts +234 -234
  590. package/src/_services/core/db-stats.service.ts +104 -104
  591. package/src/_services/core/diagnostics.service.spec.ts +44 -44
  592. package/src/_services/core/diagnostics.service.ts +158 -158
  593. package/src/_services/core/email.service.spec.ts +85 -85
  594. package/src/_services/core/email.service.ts +757 -757
  595. package/src/_services/core/event-loop-diag.service.spec.ts +22 -22
  596. package/src/_services/core/event-loop-diag.service.ts +144 -144
  597. package/src/_services/core/global.service.spec.ts +292 -292
  598. package/src/_services/core/global.service.ts +487 -487
  599. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  600. package/src/_services/core/memory-guard.service.ts +481 -481
  601. package/src/_services/core/migration-runner.service.spec.ts +91 -91
  602. package/src/_services/core/migration-runner.service.ts +106 -106
  603. package/src/_services/core/mongo-transaction.control-service.spec.ts +165 -165
  604. package/src/_services/core/mongo-transaction.control-service.ts +148 -148
  605. package/src/_services/core/request-hunter.service.spec.ts +124 -124
  606. package/src/_services/core/request-hunter.service.ts +157 -157
  607. package/src/_services/core/service-collection.service.spec.ts +46 -46
  608. package/src/_services/core/service-collection.service.ts +6 -6
  609. package/src/_services/route/controller.service.spec.ts +53 -53
  610. package/src/_services/route/controller.service.ts +148 -148
  611. package/src/_services/route/routing-module.service.spec.ts +98 -98
  612. package/src/_services/route/routing-module.service.ts +330 -330
  613. package/src/_services/server/app.server-retention.spec.ts +106 -106
  614. package/src/_services/server/app.server.ts +2012 -2012
  615. package/src/_services/shared.static-service.spec.ts +99 -99
  616. package/src/_services/shared.static-service.ts +78 -78
  617. package/src/index.ts +117 -117
  618. package/tsconfig.app.json +12 -12
  619. package/tsconfig.json +42 -42
  620. package/.dynamo/logs/cicd-pipeline/output.log +0 -2883
  621. package/.dynamo/logs/cicd-pipeline/status.json +0 -74
@@ -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
+ }