@futdevpro/nts-dynamo 1.15.52 → 1.15.54

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 (331) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/pipeline.cicd.config.json +19 -1
  17. package/.github/workflows/main.yml +432 -432
  18. package/.vscode/settings.json +10 -10
  19. package/HOWTO.md +15 -15
  20. package/LICENSE +21 -21
  21. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  22. package/_specifications/BACKLOG.md +92 -92
  23. package/_specifications/TODO.md +15 -15
  24. package/_specifications/agent.md +138 -138
  25. package/build/_modules/server/server-status/server-status.controller.d.ts.map +1 -1
  26. package/build/_modules/server/server-status/server-status.controller.js +14 -6
  27. package/build/_modules/server/server-status/server-status.controller.js.map +1 -1
  28. package/build/_services/server/app.server.d.ts +16 -0
  29. package/build/_services/server/app.server.d.ts.map +1 -1
  30. package/build/_services/server/app.server.js +24 -0
  31. package/build/_services/server/app.server.js.map +1 -1
  32. package/eslint.config.js +3 -3
  33. package/nodemon.json +24 -24
  34. package/package.json +1 -1
  35. package/pnpm-workspace.yaml +4 -4
  36. package/scripts/run-coverage-tests.js +28 -28
  37. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  38. package/spec/support/helpers/ts-node-helper.js +93 -93
  39. package/spec/support/jasmine.coverage.json +24 -24
  40. package/spec/support/jasmine.json +24 -24
  41. package/src/_collections/archive.util.spec.ts +57 -57
  42. package/src/_collections/archive.util.ts +18 -18
  43. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  44. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  45. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  46. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  47. package/src/_collections/default-not-found-page.const.ts +22 -22
  48. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  49. package/src/_collections/default-socket-path.const.ts +2 -2
  50. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  51. package/src/_collections/get-environment-settings.util.ts +48 -48
  52. package/src/_collections/global-settings.const.ts +70 -70
  53. package/src/_collections/sample.env +21 -21
  54. package/src/_collections/star.controller.spec.ts +224 -224
  55. package/src/_collections/star.controller.ts +129 -129
  56. package/src/_enums/data-model-type.enum.ts +14 -14
  57. package/src/_enums/data-service-function.enum.ts +24 -24
  58. package/src/_enums/predefined-data-types.enum.ts +16 -16
  59. package/src/_enums/route-security.enum.ts +12 -12
  60. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  61. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  62. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  63. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  64. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  65. package/src/_models/control-models/app-params.control-model.ts +136 -136
  66. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  67. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  68. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  69. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  70. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  71. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  72. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  73. package/src/_models/control-models/system-control.control-model.ts +12 -12
  74. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  75. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  76. package/src/_models/interfaces/global-log-settings.interface.ts +144 -144
  77. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  78. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  79. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  80. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  81. package/src/_models/types/db-update.type.ts +100 -100
  82. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  83. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  84. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  85. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  87. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  90. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  91. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  92. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  93. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  94. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  95. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  96. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  97. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  98. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  99. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  100. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  101. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  102. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  103. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  104. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  105. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  106. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  107. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  108. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  109. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  111. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  112. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  118. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  119. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  120. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  121. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  122. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  123. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  124. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  125. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  126. package/src/_modules/ai/index.ts +13 -13
  127. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  128. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  129. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  130. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  131. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  132. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  133. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  134. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  135. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  136. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  137. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  138. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  139. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  140. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  141. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  142. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  143. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  144. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  145. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  146. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  147. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  148. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  149. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  150. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  151. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  152. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  153. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  154. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  155. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  156. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  157. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  158. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  159. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  160. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  161. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  162. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  163. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  164. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  165. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  166. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  167. package/src/_modules/custom-data/index.ts +9 -9
  168. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  169. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  170. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  171. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  172. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  173. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  174. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  175. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  176. package/src/_modules/defaults/index.ts +17 -17
  177. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  178. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  179. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  180. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  181. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  182. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  183. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  184. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  185. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  186. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  187. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  188. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  189. package/src/_modules/discord-assistant/index.ts +38 -38
  190. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  191. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  192. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  193. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  194. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  195. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  196. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  197. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  198. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  199. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  200. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  201. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  202. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  203. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  204. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  205. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  206. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  207. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  208. package/src/_modules/discord-bot/index.ts +36 -36
  209. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  210. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  211. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  212. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  213. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  214. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  215. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  216. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  217. package/src/_modules/local-vector-search/index.ts +11 -11
  218. package/src/_modules/logs/index.ts +11 -11
  219. package/src/_modules/messaging/README.md +354 -354
  220. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  221. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  222. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  223. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  224. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  225. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  226. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  227. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  228. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  229. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  230. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  231. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  232. package/src/_modules/messaging/index.ts +30 -30
  233. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  234. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  235. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  236. package/src/_modules/mock/app-params.mock.ts +9 -9
  237. package/src/_modules/mock/app-server.mock.ts +188 -188
  238. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  239. package/src/_modules/mock/auth-service.mock.ts +28 -28
  240. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  241. package/src/_modules/mock/controller.mock.ts +16 -16
  242. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  243. package/src/_modules/mock/data-model.mock.ts +82 -82
  244. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  245. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  246. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  247. package/src/_modules/mock/email-service.mock.ts +20 -20
  248. package/src/_modules/mock/email-template.mock.html +14 -14
  249. package/src/_modules/mock/endpoint.mock.ts +91 -91
  250. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  251. package/src/_modules/mock/socket-client.mock.ts +45 -45
  252. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  253. package/src/_modules/mock/socket-server.mock.ts +46 -46
  254. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  255. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  256. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  257. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  258. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  259. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  260. package/src/_modules/oauth2/index.ts +17 -17
  261. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  262. package/src/_modules/server/errors/errors.control-service.ts +85 -85
  263. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  264. package/src/_modules/server/errors/errors.controller.ts +431 -431
  265. package/src/_modules/server/errors/errors.data-service.spec.ts +361 -361
  266. package/src/_modules/server/index.ts +30 -30
  267. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  268. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  269. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  270. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  271. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  272. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  273. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -239
  274. package/src/_modules/server/server-status/server-status.controller.ts +253 -245
  275. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  276. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  277. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  278. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  279. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  280. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  281. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  282. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  283. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  284. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  285. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  286. package/src/_modules/socket/app-extended.server.ts +630 -630
  287. package/src/_modules/socket/index.ts +42 -42
  288. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  289. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  290. package/src/_modules/test/index.ts +11 -11
  291. package/src/_modules/test/test.controller.spec.ts +72 -72
  292. package/src/_modules/test/test.controller.ts +115 -115
  293. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  294. package/src/_modules/usage/index.ts +15 -15
  295. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  296. package/src/_modules/usage/usage.controller.ts +126 -126
  297. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  298. package/src/_modules/usage/usage.data-service.ts +185 -185
  299. package/src/_services/base/api.service-base.spec.ts +125 -125
  300. package/src/_services/base/api.service-base.ts +74 -74
  301. package/src/_services/base/archive-data.service.spec.ts +196 -196
  302. package/src/_services/base/archive-data.service.ts +216 -216
  303. package/src/_services/base/data.service.spec.ts +674 -674
  304. package/src/_services/base/data.service.ts +2719 -2719
  305. package/src/_services/base/db.service.spec.ts +73 -73
  306. package/src/_services/base/db.service.ts +1575 -1575
  307. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  308. package/src/_services/base/singleton.service-base.ts +24 -24
  309. package/src/_services/base/singleton.service.spec.ts +114 -114
  310. package/src/_services/base/singleton.service.ts +38 -38
  311. package/src/_services/core/api.service.spec.ts +140 -140
  312. package/src/_services/core/auth.service.spec.ts +159 -159
  313. package/src/_services/core/auth.service.ts +174 -174
  314. package/src/_services/core/email.service.spec.ts +85 -85
  315. package/src/_services/core/email.service.ts +742 -742
  316. package/src/_services/core/global.service.spec.ts +275 -275
  317. package/src/_services/core/global.service.ts +461 -461
  318. package/src/_services/core/service-collection.service.spec.ts +46 -46
  319. package/src/_services/core/service-collection.service.ts +6 -6
  320. package/src/_services/route/controller.service.spec.ts +53 -53
  321. package/src/_services/route/controller.service.ts +148 -148
  322. package/src/_services/route/routing-module.service.spec.ts +98 -98
  323. package/src/_services/route/routing-module.service.ts +330 -330
  324. package/src/_services/server/app.server.ts +1713 -1672
  325. package/src/_services/shared.static-service.spec.ts +99 -99
  326. package/src/_services/shared.static-service.ts +78 -78
  327. package/src/index.ts +95 -95
  328. package/tsconfig.app.json +12 -12
  329. package/tsconfig.json +42 -42
  330. package/.dynamo/logs/cicd-pipeline/output.log +0 -2688
  331. package/.dynamo/logs/cicd-pipeline/status.json +0 -351
@@ -1,232 +1,232 @@
1
- import { Request, Response } from 'express';
2
- import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
3
- import { DyNTS_AuthService } from '../../../_services/core/auth.service';
4
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
5
- import { DyNTS_OAuth2_ControlService } from './oauth2.control-service';
6
-
7
- /**
8
- * OAuth2 Authentication Service implementation
9
- *
10
- * This service handles OAuth2 specific authentication flows and token management
11
- *
12
- * @example
13
- * const authService = DyNTS_OAuth2_AuthService.getInstance();
14
- * await authService.authenticate_token(req, res);
15
- */
16
- export class DyNTS_OAuth2_AuthService extends DyNTS_AuthService {
17
- static getInstance(): DyNTS_OAuth2_AuthService {
18
- return DyNTS_OAuth2_AuthService.getSingletonInstance();
19
- }
20
-
21
- private readonly controlService: DyNTS_OAuth2_ControlService = DyNTS_OAuth2_ControlService.getInstance();
22
-
23
- readonly authenticate_token = async (req: Request, res: Response): Promise<void> => {
24
- try {
25
- const token = this.getTokenFromRequest(req);
26
-
27
- // Validate token format
28
- if (!token?.startsWith('Bearer ')) {
29
- throw new DyFM_Error({
30
- status: 401,
31
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT1`,
32
- addECToUserMsg: true,
33
- message: 'Invalid token format',
34
- userMessage: this.defaultErrorUserMsg,
35
- issuerService: this.serviceName,
36
- });
37
- }
38
-
39
- const accessToken = token.substring(7); // Remove 'Bearer ' prefix
40
-
41
- // Validate token against stored tokens
42
- const tokenData = this.controlService.getAccessTokenData(accessToken);
43
- if (!tokenData || tokenData.expiresAt < Date.now()) {
44
- throw new DyFM_Error({
45
- status: 401,
46
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT2`,
47
- addECToUserMsg: true,
48
- message: 'Invalid or expired token',
49
- userMessage: this.defaultErrorUserMsg,
50
- issuerService: this.serviceName,
51
- });
52
- }
53
-
54
- // Set token in response header
55
- res.setHeader('authorization', `Bearer ${accessToken}`);
56
- } catch (error) {
57
- DyFM_Log.error('OAuth2 token authentication failed', error);
58
- throw new DyFM_Error({
59
- status: 401,
60
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT0`,
61
- addECToUserMsg: true,
62
- message: 'OAuth2 token authentication failed',
63
- userMessage: this.defaultErrorUserMsg,
64
- issuerService: this.serviceName,
65
- error
66
- });
67
- }
68
- };
69
-
70
- readonly authenticate_tokenSelf = async (req: Request, res: Response): Promise<void> => {
71
- try {
72
- const token = this.getTokenFromRequest(req);
73
-
74
- // Validate token format
75
- if (!token || !token.startsWith('Bearer ')) {
76
- throw new DyFM_Error({
77
- status: 401,
78
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS1`,
79
- addECToUserMsg: true,
80
- message: 'Invalid token format',
81
- userMessage: this.defaultErrorUserMsg,
82
- issuerService: this.serviceName,
83
- });
84
- }
85
-
86
- const accessToken = token.substring(7); // Remove 'Bearer ' prefix
87
-
88
- // Validate token against stored tokens
89
- const tokenData = this.controlService.getAccessTokenData(accessToken);
90
- if (!tokenData || tokenData.expiresAt < Date.now()) {
91
- throw new DyFM_Error({
92
- status: 401,
93
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS2`,
94
- addECToUserMsg: true,
95
- message: 'Invalid or expired token',
96
- userMessage: this.defaultErrorUserMsg,
97
- issuerService: this.serviceName,
98
- });
99
- }
100
-
101
- // For self-token validation, ensure the token is associated with the requesting user
102
- const issuer = this.getIssuerFromRequest(req);
103
- if (!issuer || issuer !== tokenData.clientId) {
104
- throw new DyFM_Error({
105
- status: 403,
106
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS3`,
107
- addECToUserMsg: true,
108
- message: 'Token not associated with requesting user',
109
- userMessage: this.defaultErrorUserMsg,
110
- issuerService: this.serviceName,
111
- });
112
- }
113
-
114
- // Set token in response header
115
- res.setHeader('authorization', `Bearer ${accessToken}`);
116
- } catch (error) {
117
- DyFM_Log.error('OAuth2 self-token authentication failed', error);
118
- throw new DyFM_Error({
119
- status: 401,
120
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS0`,
121
- addECToUserMsg: true,
122
- message: 'OAuth2 self-token authentication failed',
123
- userMessage: this.defaultErrorUserMsg,
124
- issuerService: this.serviceName,
125
- error
126
- });
127
- }
128
- };
129
-
130
- readonly authenticate_tokenPerm_accUsageData = async (req: Request, res: Response): Promise<void> => {
131
- try {
132
- const token = this.getTokenFromRequest(req);
133
-
134
- // Validate token format
135
- if (!token || !token.startsWith('Bearer ')) {
136
- throw new DyFM_Error({
137
- status: 401,
138
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU1`,
139
- addECToUserMsg: true,
140
- message: 'Invalid token format',
141
- userMessage: this.defaultErrorUserMsg,
142
- issuerService: this.serviceName,
143
- });
144
- }
145
-
146
- const accessToken = token.substring(7); // Remove 'Bearer ' prefix
147
-
148
- // Validate token against stored tokens
149
- const tokenData = this.controlService.getAccessTokenData(accessToken);
150
- if (!tokenData || tokenData.expiresAt < Date.now()) {
151
- throw new DyFM_Error({
152
- status: 401,
153
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU2`,
154
- addECToUserMsg: true,
155
- message: 'Invalid or expired token',
156
- userMessage: this.defaultErrorUserMsg,
157
- issuerService: this.serviceName,
158
- });
159
- }
160
-
161
- // Check if token has usage data permission
162
- if (!tokenData.scope.includes('usage_data')) {
163
- throw new DyFM_Error({
164
- status: 403,
165
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU3`,
166
- addECToUserMsg: true,
167
- message: 'Token does not have usage data permission',
168
- userMessage: this.defaultErrorUserMsg,
169
- issuerService: this.serviceName,
170
- });
171
- }
172
-
173
- // Set token in response header
174
- res.setHeader('authorization', `Bearer ${accessToken}`);
175
- } catch (error) {
176
- DyFM_Log.error('OAuth2 usage data permission check failed', error);
177
- throw new DyFM_Error({
178
- status: 401,
179
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU0`,
180
- addECToUserMsg: true,
181
- message: 'OAuth2 usage data permission check failed',
182
- userMessage: this.defaultErrorUserMsg,
183
- issuerService: this.serviceName,
184
- error
185
- });
186
- }
187
- };
188
-
189
- /**
190
- * Gets the issuer (user ID) from the OAuth2 token in the request
191
- * @param req Express Request object
192
- * @returns The issuer ID from the token
193
- */
194
- getIssuerFromRequest(req: Request): string {
195
- try {
196
- const token = this.getTokenFromRequest(req);
197
- if (!token || !token.startsWith('Bearer ')) {
198
- return undefined;
199
- }
200
-
201
- const accessToken = token.substring(7); // Remove 'Bearer ' prefix
202
- const tokenData = this.controlService.getAccessTokenData(accessToken);
203
-
204
- return tokenData?.clientId;
205
- } catch {
206
- return undefined;
207
- }
208
- }
209
-
210
- /**
211
- * Gets the username from the OAuth2 token in the request
212
- * @param req Express Request object
213
- * @returns The username from the token
214
- */
215
- getUsernameFromRequest(req: Request): string {
216
- try {
217
- const token = this.getTokenFromRequest(req);
218
- if (!token || !token.startsWith('Bearer ')) {
219
- return undefined;
220
- }
221
-
222
- const accessToken = token.substring(7); // Remove 'Bearer ' prefix
223
- const tokenData = this.controlService.getAccessTokenData(accessToken);
224
-
225
- // TODO: Implement user information retrieval from database/storage
226
- // For now, return the client ID as username
227
- return tokenData?.clientId;
228
- } catch {
229
- return undefined;
230
- }
231
- }
232
- }
1
+ import { Request, Response } from 'express';
2
+ import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
3
+ import { DyNTS_AuthService } from '../../../_services/core/auth.service';
4
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
5
+ import { DyNTS_OAuth2_ControlService } from './oauth2.control-service';
6
+
7
+ /**
8
+ * OAuth2 Authentication Service implementation
9
+ *
10
+ * This service handles OAuth2 specific authentication flows and token management
11
+ *
12
+ * @example
13
+ * const authService = DyNTS_OAuth2_AuthService.getInstance();
14
+ * await authService.authenticate_token(req, res);
15
+ */
16
+ export class DyNTS_OAuth2_AuthService extends DyNTS_AuthService {
17
+ static getInstance(): DyNTS_OAuth2_AuthService {
18
+ return DyNTS_OAuth2_AuthService.getSingletonInstance();
19
+ }
20
+
21
+ private readonly controlService: DyNTS_OAuth2_ControlService = DyNTS_OAuth2_ControlService.getInstance();
22
+
23
+ readonly authenticate_token = async (req: Request, res: Response): Promise<void> => {
24
+ try {
25
+ const token = this.getTokenFromRequest(req);
26
+
27
+ // Validate token format
28
+ if (!token?.startsWith('Bearer ')) {
29
+ throw new DyFM_Error({
30
+ status: 401,
31
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT1`,
32
+ addECToUserMsg: true,
33
+ message: 'Invalid token format',
34
+ userMessage: this.defaultErrorUserMsg,
35
+ issuerService: this.serviceName,
36
+ });
37
+ }
38
+
39
+ const accessToken = token.substring(7); // Remove 'Bearer ' prefix
40
+
41
+ // Validate token against stored tokens
42
+ const tokenData = this.controlService.getAccessTokenData(accessToken);
43
+ if (!tokenData || tokenData.expiresAt < Date.now()) {
44
+ throw new DyFM_Error({
45
+ status: 401,
46
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT2`,
47
+ addECToUserMsg: true,
48
+ message: 'Invalid or expired token',
49
+ userMessage: this.defaultErrorUserMsg,
50
+ issuerService: this.serviceName,
51
+ });
52
+ }
53
+
54
+ // Set token in response header
55
+ res.setHeader('authorization', `Bearer ${accessToken}`);
56
+ } catch (error) {
57
+ DyFM_Log.error('OAuth2 token authentication failed', error);
58
+ throw new DyFM_Error({
59
+ status: 401,
60
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-AT0`,
61
+ addECToUserMsg: true,
62
+ message: 'OAuth2 token authentication failed',
63
+ userMessage: this.defaultErrorUserMsg,
64
+ issuerService: this.serviceName,
65
+ error
66
+ });
67
+ }
68
+ };
69
+
70
+ readonly authenticate_tokenSelf = async (req: Request, res: Response): Promise<void> => {
71
+ try {
72
+ const token = this.getTokenFromRequest(req);
73
+
74
+ // Validate token format
75
+ if (!token || !token.startsWith('Bearer ')) {
76
+ throw new DyFM_Error({
77
+ status: 401,
78
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS1`,
79
+ addECToUserMsg: true,
80
+ message: 'Invalid token format',
81
+ userMessage: this.defaultErrorUserMsg,
82
+ issuerService: this.serviceName,
83
+ });
84
+ }
85
+
86
+ const accessToken = token.substring(7); // Remove 'Bearer ' prefix
87
+
88
+ // Validate token against stored tokens
89
+ const tokenData = this.controlService.getAccessTokenData(accessToken);
90
+ if (!tokenData || tokenData.expiresAt < Date.now()) {
91
+ throw new DyFM_Error({
92
+ status: 401,
93
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS2`,
94
+ addECToUserMsg: true,
95
+ message: 'Invalid or expired token',
96
+ userMessage: this.defaultErrorUserMsg,
97
+ issuerService: this.serviceName,
98
+ });
99
+ }
100
+
101
+ // For self-token validation, ensure the token is associated with the requesting user
102
+ const issuer = this.getIssuerFromRequest(req);
103
+ if (!issuer || issuer !== tokenData.clientId) {
104
+ throw new DyFM_Error({
105
+ status: 403,
106
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS3`,
107
+ addECToUserMsg: true,
108
+ message: 'Token not associated with requesting user',
109
+ userMessage: this.defaultErrorUserMsg,
110
+ issuerService: this.serviceName,
111
+ });
112
+ }
113
+
114
+ // Set token in response header
115
+ res.setHeader('authorization', `Bearer ${accessToken}`);
116
+ } catch (error) {
117
+ DyFM_Log.error('OAuth2 self-token authentication failed', error);
118
+ throw new DyFM_Error({
119
+ status: 401,
120
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATS0`,
121
+ addECToUserMsg: true,
122
+ message: 'OAuth2 self-token authentication failed',
123
+ userMessage: this.defaultErrorUserMsg,
124
+ issuerService: this.serviceName,
125
+ error
126
+ });
127
+ }
128
+ };
129
+
130
+ readonly authenticate_tokenPerm_accUsageData = async (req: Request, res: Response): Promise<void> => {
131
+ try {
132
+ const token = this.getTokenFromRequest(req);
133
+
134
+ // Validate token format
135
+ if (!token || !token.startsWith('Bearer ')) {
136
+ throw new DyFM_Error({
137
+ status: 401,
138
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU1`,
139
+ addECToUserMsg: true,
140
+ message: 'Invalid token format',
141
+ userMessage: this.defaultErrorUserMsg,
142
+ issuerService: this.serviceName,
143
+ });
144
+ }
145
+
146
+ const accessToken = token.substring(7); // Remove 'Bearer ' prefix
147
+
148
+ // Validate token against stored tokens
149
+ const tokenData = this.controlService.getAccessTokenData(accessToken);
150
+ if (!tokenData || tokenData.expiresAt < Date.now()) {
151
+ throw new DyFM_Error({
152
+ status: 401,
153
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU2`,
154
+ addECToUserMsg: true,
155
+ message: 'Invalid or expired token',
156
+ userMessage: this.defaultErrorUserMsg,
157
+ issuerService: this.serviceName,
158
+ });
159
+ }
160
+
161
+ // Check if token has usage data permission
162
+ if (!tokenData.scope.includes('usage_data')) {
163
+ throw new DyFM_Error({
164
+ status: 403,
165
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU3`,
166
+ addECToUserMsg: true,
167
+ message: 'Token does not have usage data permission',
168
+ userMessage: this.defaultErrorUserMsg,
169
+ issuerService: this.serviceName,
170
+ });
171
+ }
172
+
173
+ // Set token in response header
174
+ res.setHeader('authorization', `Bearer ${accessToken}`);
175
+ } catch (error) {
176
+ DyFM_Log.error('OAuth2 usage data permission check failed', error);
177
+ throw new DyFM_Error({
178
+ status: 401,
179
+ errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OA2-ATU0`,
180
+ addECToUserMsg: true,
181
+ message: 'OAuth2 usage data permission check failed',
182
+ userMessage: this.defaultErrorUserMsg,
183
+ issuerService: this.serviceName,
184
+ error
185
+ });
186
+ }
187
+ };
188
+
189
+ /**
190
+ * Gets the issuer (user ID) from the OAuth2 token in the request
191
+ * @param req Express Request object
192
+ * @returns The issuer ID from the token
193
+ */
194
+ getIssuerFromRequest(req: Request): string {
195
+ try {
196
+ const token = this.getTokenFromRequest(req);
197
+ if (!token || !token.startsWith('Bearer ')) {
198
+ return undefined;
199
+ }
200
+
201
+ const accessToken = token.substring(7); // Remove 'Bearer ' prefix
202
+ const tokenData = this.controlService.getAccessTokenData(accessToken);
203
+
204
+ return tokenData?.clientId;
205
+ } catch {
206
+ return undefined;
207
+ }
208
+ }
209
+
210
+ /**
211
+ * Gets the username from the OAuth2 token in the request
212
+ * @param req Express Request object
213
+ * @returns The username from the token
214
+ */
215
+ getUsernameFromRequest(req: Request): string {
216
+ try {
217
+ const token = this.getTokenFromRequest(req);
218
+ if (!token || !token.startsWith('Bearer ')) {
219
+ return undefined;
220
+ }
221
+
222
+ const accessToken = token.substring(7); // Remove 'Bearer ' prefix
223
+ const tokenData = this.controlService.getAccessTokenData(accessToken);
224
+
225
+ // TODO: Implement user information retrieval from database/storage
226
+ // For now, return the client ID as username
227
+ return tokenData?.clientId;
228
+ } catch {
229
+ return undefined;
230
+ }
231
+ }
232
+ }