@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,585 +1,585 @@
1
-
2
- import { DyNTS_OAuth2_ControlService } from './oauth2.control-service';
3
- import { DyNTS_OAuth2_AuthService } from './oauth2.auth-service';
4
- import { Request, Response } from 'express';
5
- import { DyFM_Error } from '@futdevpro/fsm-dynamo';
6
- import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
7
-
8
- describe('| DyNTS_OAuth2_ControlService', () => {
9
- let service: DyNTS_OAuth2_ControlService;
10
- let mockAuthService: jasmine.SpyObj<DyNTS_OAuth2_AuthService>;
11
- let mockRequest: Partial<Request>;
12
- let mockResponse: Partial<Response>;
13
- let cryptoJsOrigLib: unknown;
14
-
15
- beforeAll(() => {
16
- const cjs = require('crypto-js');
17
- const ref = (cjs && (cjs as { cryptoJs?: unknown }).cryptoJs) || (cjs && (cjs as { default?: unknown }).default) || cjs;
18
- if (ref && typeof ref === 'object') {
19
- cryptoJsOrigLib = (ref as { lib?: unknown }).lib;
20
- (ref as { lib: unknown }).lib = {
21
- WordArray: {
22
- random: (_n?: number): { toString: () => string } => ({
23
- toString: (): string => 'mock-token-' + Math.random().toString(36).slice(2, 12),
24
- }),
25
- },
26
- };
27
- }
28
- });
29
-
30
- afterAll(() => {
31
- if (cryptoJsOrigLib !== undefined) {
32
- const cjs = require('crypto-js');
33
- const cryptoJsRef = (cjs && (cjs as { cryptoJs?: { lib?: unknown } }).cryptoJs) || cjs.default || cjs;
34
- if (cryptoJsRef && typeof cryptoJsRef === 'object') {
35
- (cryptoJsRef as { lib: unknown }).lib = cryptoJsOrigLib;
36
- }
37
- }
38
- });
39
-
40
- beforeEach(() => {
41
- // Reset singleton instances to prevent state leakage between tests
42
- (DyNTS_OAuth2_ControlService as any).instance = undefined;
43
- (DyNTS_OAuth2_AuthService as any).instance = undefined;
44
-
45
- // Mock the AuthService.getInstance() to prevent circular dependency
46
- mockAuthService = jasmine.createSpyObj('DyNTS_OAuth2_AuthService', [
47
- 'getTokenFromRequest',
48
- 'authenticate_token',
49
- ]);
50
- spyOn(DyNTS_OAuth2_AuthService, 'getInstance').and.returnValue(mockAuthService);
51
-
52
- // Now we can safely get the ControlService instance
53
- service = DyNTS_OAuth2_ControlService.getInstance();
54
-
55
- // Replace the authService with our mock (cryptoJs is patched at module level in beforeAll)
56
- (service as any).authService = mockAuthService;
57
- mockRequest = {
58
- query: {},
59
- body: {},
60
- headers: {},
61
- };
62
- mockResponse = {
63
- redirect: jasmine.createSpy('redirect'),
64
- json: jasmine.createSpy('json'),
65
- status: jasmine.createSpy('status').and.returnValue({
66
- send: jasmine.createSpy('send'),
67
- }),
68
- };
69
-
70
- // Clear all maps before each test
71
- (service as any).authorizationCodes.clear();
72
- (service as any).accessTokens.clear();
73
- (service as any).refreshTokens.clear();
74
- (service as any).clients.clear();
75
- (service as any).users.clear();
76
- });
77
-
78
- it('| should be a singleton instance', () => {
79
- const instance1 = DyNTS_OAuth2_ControlService.getInstance();
80
- const instance2 = DyNTS_OAuth2_ControlService.getInstance();
81
-
82
- expect(instance1).toBe(instance2);
83
- expect(instance1).toBeInstanceOf(DyNTS_OAuth2_ControlService);
84
- });
85
-
86
- it('| should have correct service name', () => {
87
- expect(service.serviceName).toBe('OAuth2ControlService');
88
- });
89
-
90
- describe('| registerClient', () => {
91
- it('| should register a new client', () => {
92
- const result = service.registerClient(
93
- 'client-123',
94
- 'secret-123',
95
- ['http://localhost:3000/callback'],
96
- ['read', 'write']
97
- );
98
-
99
- expect(result).toBe(true);
100
- });
101
-
102
- it('| should not register duplicate client', () => {
103
- service.registerClient('client-123', 'secret-123', ['http://localhost:3000/callback'], ['read']);
104
- const result = service.registerClient('client-123', 'secret-456', ['http://localhost:3000/callback'], ['write']);
105
-
106
- expect(result).toBe(false);
107
- });
108
- });
109
-
110
- describe('| registerUser', () => {
111
- it('| should register a new user', () => {
112
- const result = service.registerUser('user-123', 'password-123', ['read', 'write']);
113
-
114
- expect(result).toBe(true);
115
- });
116
-
117
- it('| should not register duplicate user', () => {
118
- service.registerUser('user-123', 'password-123', ['read']);
119
- const result = service.registerUser('user-123', 'password-456', ['write']);
120
-
121
- expect(result).toBe(false);
122
- });
123
- });
124
-
125
- describe('| handleAuthorizationRequest', () => {
126
- beforeEach(() => {
127
- service.registerClient(
128
- 'client-123',
129
- 'secret-123',
130
- ['http://localhost:3000/callback'],
131
- ['read', 'write']
132
- );
133
- });
134
-
135
- it('| should handle authorization code flow', async () => {
136
- mockRequest.query = {
137
- response_type: 'code',
138
- client_id: 'client-123',
139
- redirect_uri: 'http://localhost:3000/callback',
140
- scope: 'read write',
141
- state: 'state-123',
142
- };
143
- // Spy to bypass cryptoJs.lib in generateAuthorizationCode (crypto-js nem mockolható ebben a környezetben)
144
- spyOn(service as any, 'generateAuthorizationCode').and.returnValue(Promise.resolve('mock-code-123'));
145
-
146
- await service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response);
147
-
148
- expect(mockResponse.redirect).toHaveBeenCalled();
149
- const redirectUrl = (mockResponse.redirect as jasmine.Spy).calls.mostRecent().args[0];
150
- expect(redirectUrl).toContain('http://localhost:3000/callback');
151
- expect(redirectUrl).toContain('code=');
152
- expect(redirectUrl).toContain('state=state-123');
153
- });
154
-
155
- it('| should handle implicit flow', async () => {
156
- mockRequest.query = {
157
- response_type: 'token',
158
- client_id: 'client-123',
159
- redirect_uri: 'http://localhost:3000/callback',
160
- scope: 'read',
161
- state: 'state-123',
162
- };
163
- // Spy to bypass cryptoJs.lib in generateAccessToken (crypto-js nem mockolható ebben a környezetben)
164
- spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token-123'));
165
-
166
- await service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response);
167
-
168
- expect(mockResponse.redirect).toHaveBeenCalled();
169
- const redirectUrl = (mockResponse.redirect as jasmine.Spy).calls.mostRecent().args[0];
170
- expect(redirectUrl).toContain('http://localhost:3000/callback');
171
- expect(redirectUrl).toContain('#access_token=');
172
- });
173
-
174
- it('| should throw error when missing required parameters', async () => {
175
- mockRequest.query = {
176
- response_type: 'code',
177
- // Missing client_id and redirect_uri
178
- };
179
-
180
- await expectAsync(
181
- service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
182
- ).toBeRejected();
183
- });
184
-
185
- it('| should throw error when client_id is invalid', async () => {
186
- mockRequest.query = {
187
- response_type: 'code',
188
- client_id: 'invalid-client',
189
- redirect_uri: 'http://localhost:3000/callback',
190
- };
191
-
192
- await expectAsync(
193
- service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
194
- ).toBeRejected();
195
- });
196
-
197
- it('| should throw error when redirect_uri is invalid', async () => {
198
- mockRequest.query = {
199
- response_type: 'code',
200
- client_id: 'client-123',
201
- redirect_uri: 'http://evil.com/callback',
202
- };
203
-
204
- await expectAsync(
205
- service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
206
- ).toBeRejected();
207
- });
208
-
209
- it('| should throw error when scope is invalid', async () => {
210
- mockRequest.query = {
211
- response_type: 'code',
212
- client_id: 'client-123',
213
- redirect_uri: 'http://localhost:3000/callback',
214
- scope: 'invalid-scope',
215
- };
216
-
217
- await expectAsync(
218
- service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
219
- ).toBeRejected();
220
- });
221
-
222
- it('| should throw error when response_type is unsupported', async () => {
223
- mockRequest.query = {
224
- response_type: 'unsupported',
225
- client_id: 'client-123',
226
- redirect_uri: 'http://localhost:3000/callback',
227
- };
228
-
229
- await expectAsync(
230
- service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
231
- ).toBeRejected();
232
- });
233
- });
234
-
235
- describe('| handleTokenRequest', () => {
236
- beforeEach(() => {
237
- service.registerClient(
238
- 'client-123',
239
- 'secret-123',
240
- ['http://localhost:3000/callback'],
241
- ['read', 'write']
242
- );
243
- // Bypass cryptoJs.lib (crypto-js nem mockolható ebben a környezetben)
244
- spyOn(service as any, 'generateAuthorizationCode').and.returnValue(Promise.resolve('mock-code'));
245
- spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token'));
246
- spyOn(service as any, 'generateRefreshToken').and.returnValue(Promise.resolve('mock-refresh-token'));
247
- });
248
-
249
- it('| should handle refresh_token grant type', async () => {
250
- // First, get a refresh token
251
- const refreshToken = await (service as any).generateRefreshToken('client-123');
252
- (service as any).refreshTokens.set(refreshToken, {
253
- clientId: 'client-123',
254
- scope: 'read',
255
- accessToken: 'old-access-token',
256
- });
257
-
258
- mockRequest.body = {
259
- grant_type: 'refresh_token',
260
- refresh_token: refreshToken,
261
- client_id: 'client-123',
262
- client_secret: 'secret-123',
263
- };
264
- mockResponse.json = jasmine.createSpy('json');
265
-
266
- await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
267
-
268
- expect(mockResponse.json).toHaveBeenCalled();
269
- const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
270
- expect(response.access_token).toBeDefined();
271
- expect(response.refresh_token).toBeDefined();
272
- });
273
-
274
- it('| should handle client_credentials grant type', async () => {
275
- mockRequest.body = {
276
- grant_type: 'client_credentials',
277
- client_id: 'client-123',
278
- client_secret: 'secret-123',
279
- };
280
- mockResponse.json = jasmine.createSpy('json');
281
-
282
- await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
283
-
284
- expect(mockResponse.json).toHaveBeenCalled();
285
- const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
286
- expect(response.access_token).toBeDefined();
287
- expect(response.token_type).toBe('Bearer');
288
- });
289
-
290
- it('| should handle password grant type', async () => {
291
- service.registerUser('user-123', 'password-123', ['read', 'write']);
292
-
293
- mockRequest.body = {
294
- grant_type: 'password',
295
- client_id: 'client-123',
296
- client_secret: 'secret-123',
297
- username: 'user-123',
298
- password: 'password-123',
299
- };
300
- mockResponse.json = jasmine.createSpy('json');
301
-
302
- await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
303
-
304
- expect(mockResponse.json).toHaveBeenCalled();
305
- const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
306
- expect(response.access_token).toBeDefined();
307
- expect(response.refresh_token).toBeDefined();
308
- });
309
-
310
- it('| should throw error when missing required parameters', async () => {
311
- mockRequest.body = {
312
- grant_type: 'authorization_code',
313
- // Missing client_id and client_secret
314
- };
315
-
316
- await expectAsync(
317
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
318
- ).toBeRejected();
319
- });
320
-
321
- it('| should throw error when client credentials are invalid', async () => {
322
- mockRequest.body = {
323
- grant_type: 'authorization_code',
324
- client_id: 'client-123',
325
- client_secret: 'wrong-secret',
326
- };
327
-
328
- await expectAsync(
329
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
330
- ).toBeRejected();
331
- });
332
-
333
- it('| should throw error when authorization code is missing', async () => {
334
- mockRequest.body = {
335
- grant_type: 'authorization_code',
336
- client_id: 'client-123',
337
- client_secret: 'secret-123',
338
- // Missing code
339
- };
340
-
341
- await expectAsync(
342
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
343
- ).toBeRejected();
344
- });
345
-
346
- it('| should throw error when authorization code is invalid', async () => {
347
- mockRequest.body = {
348
- grant_type: 'authorization_code',
349
- code: 'invalid-code',
350
- client_id: 'client-123',
351
- client_secret: 'secret-123',
352
- };
353
-
354
- await expectAsync(
355
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
356
- ).toBeRejected();
357
- });
358
-
359
- it('| should throw error when refresh token is missing', async () => {
360
- mockRequest.body = {
361
- grant_type: 'refresh_token',
362
- client_id: 'client-123',
363
- client_secret: 'secret-123',
364
- // Missing refresh_token
365
- };
366
-
367
- await expectAsync(
368
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
369
- ).toBeRejected();
370
- });
371
-
372
- it('| should throw error when refresh token is invalid', async () => {
373
- mockRequest.body = {
374
- grant_type: 'refresh_token',
375
- refresh_token: 'invalid-refresh-token',
376
- client_id: 'client-123',
377
- client_secret: 'secret-123',
378
- };
379
-
380
- await expectAsync(
381
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
382
- ).toBeRejected();
383
- });
384
-
385
- it('| should throw error when username or password is missing', async () => {
386
- mockRequest.body = {
387
- grant_type: 'password',
388
- client_id: 'client-123',
389
- client_secret: 'secret-123',
390
- // Missing username and password
391
- };
392
-
393
- await expectAsync(
394
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
395
- ).toBeRejected();
396
- });
397
-
398
- it('| should throw error when user credentials are invalid', async () => {
399
- mockRequest.body = {
400
- grant_type: 'password',
401
- client_id: 'client-123',
402
- client_secret: 'secret-123',
403
- username: 'user-123',
404
- password: 'wrong-password',
405
- };
406
-
407
- await expectAsync(
408
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
409
- ).toBeRejected();
410
- });
411
-
412
- it('| should throw error when grant_type is unsupported', async () => {
413
- mockRequest.body = {
414
- grant_type: 'unsupported',
415
- client_id: 'client-123',
416
- client_secret: 'secret-123',
417
- };
418
-
419
- await expectAsync(
420
- service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
421
- ).toBeRejected();
422
- });
423
- });
424
-
425
- describe('| handleUserInfoRequest', () => {
426
- beforeEach(() => {
427
- service.registerClient(
428
- 'client-123',
429
- 'secret-123',
430
- ['http://localhost:3000/callback'],
431
- ['read', 'write']
432
- );
433
- // Don't spy here, let each test set up its own spy
434
- });
435
-
436
- // Skipped: Token validation fails even with manually created token
437
- it('| should return user info for valid token', async () => {
438
- // Manually create a token and store it in accessTokens map
439
- const accessToken = 'test-access-token-' + Date.now();
440
- const tokenData = {
441
- clientId: 'client-123',
442
- scope: 'profile email',
443
- expiresAt: Date.now() + 3600000, // 1 hour
444
- };
445
- (service as any).accessTokens.set(accessToken, tokenData);
446
- mockAuthService.getTokenFromRequest.and.returnValue(accessToken);
447
- mockResponse.json = jasmine.createSpy('json');
448
-
449
- await service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response);
450
-
451
- expect(mockResponse.json).toHaveBeenCalled();
452
- const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
453
- expect(response.sub).toBeDefined();
454
- expect(response.name).toBeDefined();
455
- expect(response.email).toBeDefined();
456
- });
457
-
458
- it('| should throw error when token is missing', async () => {
459
- mockAuthService.getTokenFromRequest.and.throwError(new Error('Token missing'));
460
-
461
- await expectAsync(
462
- service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
463
- ).toBeRejected();
464
- });
465
-
466
- it('| should throw error when token is invalid', async () => {
467
- mockAuthService.getTokenFromRequest.and.returnValue('invalid-token');
468
-
469
- await expectAsync(
470
- service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
471
- ).toBeRejected();
472
- });
473
-
474
- it('| should throw error when token is expired', async () => {
475
- // Manually create an expired token
476
- const expiredToken = 'expired-token-' + Date.now();
477
- (service as any).accessTokens.set(expiredToken, {
478
- clientId: 'client-123',
479
- scope: 'read',
480
- expiresAt: Date.now() - 1000, // Expired
481
- });
482
- mockAuthService.getTokenFromRequest.and.returnValue(`Bearer ${expiredToken}`);
483
-
484
- await expectAsync(
485
- service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
486
- ).toBeRejected();
487
- });
488
- });
489
-
490
- describe('| handleTokenRevocation', () => {
491
- beforeEach(() => {
492
- spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token'));
493
- spyOn(service as any, 'generateRefreshToken').and.returnValue(Promise.resolve('mock-refresh-token'));
494
- });
495
-
496
- it('| should revoke access token', async () => {
497
- const accessToken = await (service as any).generateAccessToken('client-123', 'read');
498
- (service as any).accessTokens.set(accessToken, {
499
- clientId: 'client-123',
500
- scope: 'read',
501
- expiresAt: Date.now() + 3600000,
502
- });
503
- mockRequest.body = {
504
- token: accessToken,
505
- token_type_hint: 'access_token',
506
- };
507
-
508
- await service.handleTokenRevocation(mockRequest as Request, mockResponse as Response);
509
-
510
- expect(mockResponse.status).toHaveBeenCalledWith(200);
511
- expect((service as any).accessTokens.has(accessToken)).toBe(false);
512
- });
513
-
514
- it('| should revoke refresh token and associated access token', async () => {
515
- const accessToken = await (service as any).generateAccessToken('client-123', 'read');
516
- (service as any).accessTokens.set(accessToken, {
517
- clientId: 'client-123',
518
- scope: 'read',
519
- expiresAt: Date.now() + 3600000,
520
- });
521
- const refreshToken = await (service as any).generateRefreshToken('client-123');
522
- (service as any).refreshTokens.set(refreshToken, {
523
- clientId: 'client-123',
524
- scope: 'read',
525
- accessToken: accessToken,
526
- });
527
-
528
- mockRequest.body = {
529
- token: refreshToken,
530
- token_type_hint: 'refresh_token',
531
- };
532
-
533
- await service.handleTokenRevocation(mockRequest as Request, mockResponse as Response);
534
-
535
- expect(mockResponse.status).toHaveBeenCalledWith(200);
536
- expect((service as any).refreshTokens.has(refreshToken)).toBe(false);
537
- expect((service as any).accessTokens.has(accessToken)).toBe(false);
538
- });
539
-
540
- it('| should throw error when token is missing', async () => {
541
- mockRequest.body = {};
542
-
543
- await expectAsync(
544
- service.handleTokenRevocation(mockRequest as Request, mockResponse as Response)
545
- ).toBeRejected();
546
- });
547
-
548
- it('| should throw error when token is not found', async () => {
549
- mockRequest.body = {
550
- token: 'non-existent-token',
551
- };
552
-
553
- await expectAsync(
554
- service.handleTokenRevocation(mockRequest as Request, mockResponse as Response)
555
- ).toBeRejected();
556
- });
557
- });
558
-
559
- describe('| getAccessTokenData', () => {
560
- it('| should return access token data when token exists', async () => {
561
- // Manually create a token and store it in accessTokens map
562
- const accessToken = 'test-access-token-' + Date.now();
563
- const tokenData = {
564
- clientId: 'client-123',
565
- scope: 'read',
566
- expiresAt: Date.now() + 3600000, // 1 hour
567
- };
568
- (service as any).accessTokens.set(accessToken, tokenData);
569
-
570
- const result = service.getAccessTokenData(accessToken);
571
-
572
- expect(result).toBeDefined();
573
- expect(result?.clientId).toBe('client-123');
574
- expect(result?.scope).toBe('read');
575
- expect(result?.expiresAt).toBeGreaterThan(Date.now());
576
- });
577
-
578
- it('| should return undefined when token does not exist', () => {
579
- const tokenData = service.getAccessTokenData('non-existent-token');
580
-
581
- expect(tokenData).toBeUndefined();
582
- });
583
- });
584
- });
585
-
1
+
2
+ import { DyNTS_OAuth2_ControlService } from './oauth2.control-service';
3
+ import { DyNTS_OAuth2_AuthService } from './oauth2.auth-service';
4
+ import { Request, Response } from 'express';
5
+ import { DyFM_Error } from '@futdevpro/fsm-dynamo';
6
+ import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
7
+
8
+ describe('| DyNTS_OAuth2_ControlService', () => {
9
+ let service: DyNTS_OAuth2_ControlService;
10
+ let mockAuthService: jasmine.SpyObj<DyNTS_OAuth2_AuthService>;
11
+ let mockRequest: Partial<Request>;
12
+ let mockResponse: Partial<Response>;
13
+ let cryptoJsOrigLib: unknown;
14
+
15
+ beforeAll(() => {
16
+ const cjs = require('crypto-js');
17
+ const ref = (cjs && (cjs as { cryptoJs?: unknown }).cryptoJs) || (cjs && (cjs as { default?: unknown }).default) || cjs;
18
+ if (ref && typeof ref === 'object') {
19
+ cryptoJsOrigLib = (ref as { lib?: unknown }).lib;
20
+ (ref as { lib: unknown }).lib = {
21
+ WordArray: {
22
+ random: (_n?: number): { toString: () => string } => ({
23
+ toString: (): string => 'mock-token-' + Math.random().toString(36).slice(2, 12),
24
+ }),
25
+ },
26
+ };
27
+ }
28
+ });
29
+
30
+ afterAll(() => {
31
+ if (cryptoJsOrigLib !== undefined) {
32
+ const cjs = require('crypto-js');
33
+ const cryptoJsRef = (cjs && (cjs as { cryptoJs?: { lib?: unknown } }).cryptoJs) || cjs.default || cjs;
34
+ if (cryptoJsRef && typeof cryptoJsRef === 'object') {
35
+ (cryptoJsRef as { lib: unknown }).lib = cryptoJsOrigLib;
36
+ }
37
+ }
38
+ });
39
+
40
+ beforeEach(() => {
41
+ // Reset singleton instances to prevent state leakage between tests
42
+ (DyNTS_OAuth2_ControlService as any).instance = undefined;
43
+ (DyNTS_OAuth2_AuthService as any).instance = undefined;
44
+
45
+ // Mock the AuthService.getInstance() to prevent circular dependency
46
+ mockAuthService = jasmine.createSpyObj('DyNTS_OAuth2_AuthService', [
47
+ 'getTokenFromRequest',
48
+ 'authenticate_token',
49
+ ]);
50
+ spyOn(DyNTS_OAuth2_AuthService, 'getInstance').and.returnValue(mockAuthService);
51
+
52
+ // Now we can safely get the ControlService instance
53
+ service = DyNTS_OAuth2_ControlService.getInstance();
54
+
55
+ // Replace the authService with our mock (cryptoJs is patched at module level in beforeAll)
56
+ (service as any).authService = mockAuthService;
57
+ mockRequest = {
58
+ query: {},
59
+ body: {},
60
+ headers: {},
61
+ };
62
+ mockResponse = {
63
+ redirect: jasmine.createSpy('redirect'),
64
+ json: jasmine.createSpy('json'),
65
+ status: jasmine.createSpy('status').and.returnValue({
66
+ send: jasmine.createSpy('send'),
67
+ }),
68
+ };
69
+
70
+ // Clear all maps before each test
71
+ (service as any).authorizationCodes.clear();
72
+ (service as any).accessTokens.clear();
73
+ (service as any).refreshTokens.clear();
74
+ (service as any).clients.clear();
75
+ (service as any).users.clear();
76
+ });
77
+
78
+ it('| should be a singleton instance', () => {
79
+ const instance1 = DyNTS_OAuth2_ControlService.getInstance();
80
+ const instance2 = DyNTS_OAuth2_ControlService.getInstance();
81
+
82
+ expect(instance1).toBe(instance2);
83
+ expect(instance1).toBeInstanceOf(DyNTS_OAuth2_ControlService);
84
+ });
85
+
86
+ it('| should have correct service name', () => {
87
+ expect(service.serviceName).toBe('OAuth2ControlService');
88
+ });
89
+
90
+ describe('| registerClient', () => {
91
+ it('| should register a new client', () => {
92
+ const result = service.registerClient(
93
+ 'client-123',
94
+ 'secret-123',
95
+ ['http://localhost:3000/callback'],
96
+ ['read', 'write']
97
+ );
98
+
99
+ expect(result).toBe(true);
100
+ });
101
+
102
+ it('| should not register duplicate client', () => {
103
+ service.registerClient('client-123', 'secret-123', ['http://localhost:3000/callback'], ['read']);
104
+ const result = service.registerClient('client-123', 'secret-456', ['http://localhost:3000/callback'], ['write']);
105
+
106
+ expect(result).toBe(false);
107
+ });
108
+ });
109
+
110
+ describe('| registerUser', () => {
111
+ it('| should register a new user', () => {
112
+ const result = service.registerUser('user-123', 'password-123', ['read', 'write']);
113
+
114
+ expect(result).toBe(true);
115
+ });
116
+
117
+ it('| should not register duplicate user', () => {
118
+ service.registerUser('user-123', 'password-123', ['read']);
119
+ const result = service.registerUser('user-123', 'password-456', ['write']);
120
+
121
+ expect(result).toBe(false);
122
+ });
123
+ });
124
+
125
+ describe('| handleAuthorizationRequest', () => {
126
+ beforeEach(() => {
127
+ service.registerClient(
128
+ 'client-123',
129
+ 'secret-123',
130
+ ['http://localhost:3000/callback'],
131
+ ['read', 'write']
132
+ );
133
+ });
134
+
135
+ it('| should handle authorization code flow', async () => {
136
+ mockRequest.query = {
137
+ response_type: 'code',
138
+ client_id: 'client-123',
139
+ redirect_uri: 'http://localhost:3000/callback',
140
+ scope: 'read write',
141
+ state: 'state-123',
142
+ };
143
+ // Spy to bypass cryptoJs.lib in generateAuthorizationCode (crypto-js nem mockolható ebben a környezetben)
144
+ spyOn(service as any, 'generateAuthorizationCode').and.returnValue(Promise.resolve('mock-code-123'));
145
+
146
+ await service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response);
147
+
148
+ expect(mockResponse.redirect).toHaveBeenCalled();
149
+ const redirectUrl = (mockResponse.redirect as jasmine.Spy).calls.mostRecent().args[0];
150
+ expect(redirectUrl).toContain('http://localhost:3000/callback');
151
+ expect(redirectUrl).toContain('code=');
152
+ expect(redirectUrl).toContain('state=state-123');
153
+ });
154
+
155
+ it('| should handle implicit flow', async () => {
156
+ mockRequest.query = {
157
+ response_type: 'token',
158
+ client_id: 'client-123',
159
+ redirect_uri: 'http://localhost:3000/callback',
160
+ scope: 'read',
161
+ state: 'state-123',
162
+ };
163
+ // Spy to bypass cryptoJs.lib in generateAccessToken (crypto-js nem mockolható ebben a környezetben)
164
+ spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token-123'));
165
+
166
+ await service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response);
167
+
168
+ expect(mockResponse.redirect).toHaveBeenCalled();
169
+ const redirectUrl = (mockResponse.redirect as jasmine.Spy).calls.mostRecent().args[0];
170
+ expect(redirectUrl).toContain('http://localhost:3000/callback');
171
+ expect(redirectUrl).toContain('#access_token=');
172
+ });
173
+
174
+ it('| should throw error when missing required parameters', async () => {
175
+ mockRequest.query = {
176
+ response_type: 'code',
177
+ // Missing client_id and redirect_uri
178
+ };
179
+
180
+ await expectAsync(
181
+ service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
182
+ ).toBeRejected();
183
+ });
184
+
185
+ it('| should throw error when client_id is invalid', async () => {
186
+ mockRequest.query = {
187
+ response_type: 'code',
188
+ client_id: 'invalid-client',
189
+ redirect_uri: 'http://localhost:3000/callback',
190
+ };
191
+
192
+ await expectAsync(
193
+ service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
194
+ ).toBeRejected();
195
+ });
196
+
197
+ it('| should throw error when redirect_uri is invalid', async () => {
198
+ mockRequest.query = {
199
+ response_type: 'code',
200
+ client_id: 'client-123',
201
+ redirect_uri: 'http://evil.com/callback',
202
+ };
203
+
204
+ await expectAsync(
205
+ service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
206
+ ).toBeRejected();
207
+ });
208
+
209
+ it('| should throw error when scope is invalid', async () => {
210
+ mockRequest.query = {
211
+ response_type: 'code',
212
+ client_id: 'client-123',
213
+ redirect_uri: 'http://localhost:3000/callback',
214
+ scope: 'invalid-scope',
215
+ };
216
+
217
+ await expectAsync(
218
+ service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
219
+ ).toBeRejected();
220
+ });
221
+
222
+ it('| should throw error when response_type is unsupported', async () => {
223
+ mockRequest.query = {
224
+ response_type: 'unsupported',
225
+ client_id: 'client-123',
226
+ redirect_uri: 'http://localhost:3000/callback',
227
+ };
228
+
229
+ await expectAsync(
230
+ service.handleAuthorizationRequest(mockRequest as Request, mockResponse as Response)
231
+ ).toBeRejected();
232
+ });
233
+ });
234
+
235
+ describe('| handleTokenRequest', () => {
236
+ beforeEach(() => {
237
+ service.registerClient(
238
+ 'client-123',
239
+ 'secret-123',
240
+ ['http://localhost:3000/callback'],
241
+ ['read', 'write']
242
+ );
243
+ // Bypass cryptoJs.lib (crypto-js nem mockolható ebben a környezetben)
244
+ spyOn(service as any, 'generateAuthorizationCode').and.returnValue(Promise.resolve('mock-code'));
245
+ spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token'));
246
+ spyOn(service as any, 'generateRefreshToken').and.returnValue(Promise.resolve('mock-refresh-token'));
247
+ });
248
+
249
+ it('| should handle refresh_token grant type', async () => {
250
+ // First, get a refresh token
251
+ const refreshToken = await (service as any).generateRefreshToken('client-123');
252
+ (service as any).refreshTokens.set(refreshToken, {
253
+ clientId: 'client-123',
254
+ scope: 'read',
255
+ accessToken: 'old-access-token',
256
+ });
257
+
258
+ mockRequest.body = {
259
+ grant_type: 'refresh_token',
260
+ refresh_token: refreshToken,
261
+ client_id: 'client-123',
262
+ client_secret: 'secret-123',
263
+ };
264
+ mockResponse.json = jasmine.createSpy('json');
265
+
266
+ await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
267
+
268
+ expect(mockResponse.json).toHaveBeenCalled();
269
+ const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
270
+ expect(response.access_token).toBeDefined();
271
+ expect(response.refresh_token).toBeDefined();
272
+ });
273
+
274
+ it('| should handle client_credentials grant type', async () => {
275
+ mockRequest.body = {
276
+ grant_type: 'client_credentials',
277
+ client_id: 'client-123',
278
+ client_secret: 'secret-123',
279
+ };
280
+ mockResponse.json = jasmine.createSpy('json');
281
+
282
+ await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
283
+
284
+ expect(mockResponse.json).toHaveBeenCalled();
285
+ const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
286
+ expect(response.access_token).toBeDefined();
287
+ expect(response.token_type).toBe('Bearer');
288
+ });
289
+
290
+ it('| should handle password grant type', async () => {
291
+ service.registerUser('user-123', 'password-123', ['read', 'write']);
292
+
293
+ mockRequest.body = {
294
+ grant_type: 'password',
295
+ client_id: 'client-123',
296
+ client_secret: 'secret-123',
297
+ username: 'user-123',
298
+ password: 'password-123',
299
+ };
300
+ mockResponse.json = jasmine.createSpy('json');
301
+
302
+ await service.handleTokenRequest(mockRequest as Request, mockResponse as Response);
303
+
304
+ expect(mockResponse.json).toHaveBeenCalled();
305
+ const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
306
+ expect(response.access_token).toBeDefined();
307
+ expect(response.refresh_token).toBeDefined();
308
+ });
309
+
310
+ it('| should throw error when missing required parameters', async () => {
311
+ mockRequest.body = {
312
+ grant_type: 'authorization_code',
313
+ // Missing client_id and client_secret
314
+ };
315
+
316
+ await expectAsync(
317
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
318
+ ).toBeRejected();
319
+ });
320
+
321
+ it('| should throw error when client credentials are invalid', async () => {
322
+ mockRequest.body = {
323
+ grant_type: 'authorization_code',
324
+ client_id: 'client-123',
325
+ client_secret: 'wrong-secret',
326
+ };
327
+
328
+ await expectAsync(
329
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
330
+ ).toBeRejected();
331
+ });
332
+
333
+ it('| should throw error when authorization code is missing', async () => {
334
+ mockRequest.body = {
335
+ grant_type: 'authorization_code',
336
+ client_id: 'client-123',
337
+ client_secret: 'secret-123',
338
+ // Missing code
339
+ };
340
+
341
+ await expectAsync(
342
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
343
+ ).toBeRejected();
344
+ });
345
+
346
+ it('| should throw error when authorization code is invalid', async () => {
347
+ mockRequest.body = {
348
+ grant_type: 'authorization_code',
349
+ code: 'invalid-code',
350
+ client_id: 'client-123',
351
+ client_secret: 'secret-123',
352
+ };
353
+
354
+ await expectAsync(
355
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
356
+ ).toBeRejected();
357
+ });
358
+
359
+ it('| should throw error when refresh token is missing', async () => {
360
+ mockRequest.body = {
361
+ grant_type: 'refresh_token',
362
+ client_id: 'client-123',
363
+ client_secret: 'secret-123',
364
+ // Missing refresh_token
365
+ };
366
+
367
+ await expectAsync(
368
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
369
+ ).toBeRejected();
370
+ });
371
+
372
+ it('| should throw error when refresh token is invalid', async () => {
373
+ mockRequest.body = {
374
+ grant_type: 'refresh_token',
375
+ refresh_token: 'invalid-refresh-token',
376
+ client_id: 'client-123',
377
+ client_secret: 'secret-123',
378
+ };
379
+
380
+ await expectAsync(
381
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
382
+ ).toBeRejected();
383
+ });
384
+
385
+ it('| should throw error when username or password is missing', async () => {
386
+ mockRequest.body = {
387
+ grant_type: 'password',
388
+ client_id: 'client-123',
389
+ client_secret: 'secret-123',
390
+ // Missing username and password
391
+ };
392
+
393
+ await expectAsync(
394
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
395
+ ).toBeRejected();
396
+ });
397
+
398
+ it('| should throw error when user credentials are invalid', async () => {
399
+ mockRequest.body = {
400
+ grant_type: 'password',
401
+ client_id: 'client-123',
402
+ client_secret: 'secret-123',
403
+ username: 'user-123',
404
+ password: 'wrong-password',
405
+ };
406
+
407
+ await expectAsync(
408
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
409
+ ).toBeRejected();
410
+ });
411
+
412
+ it('| should throw error when grant_type is unsupported', async () => {
413
+ mockRequest.body = {
414
+ grant_type: 'unsupported',
415
+ client_id: 'client-123',
416
+ client_secret: 'secret-123',
417
+ };
418
+
419
+ await expectAsync(
420
+ service.handleTokenRequest(mockRequest as Request, mockResponse as Response)
421
+ ).toBeRejected();
422
+ });
423
+ });
424
+
425
+ describe('| handleUserInfoRequest', () => {
426
+ beforeEach(() => {
427
+ service.registerClient(
428
+ 'client-123',
429
+ 'secret-123',
430
+ ['http://localhost:3000/callback'],
431
+ ['read', 'write']
432
+ );
433
+ // Don't spy here, let each test set up its own spy
434
+ });
435
+
436
+ // Skipped: Token validation fails even with manually created token
437
+ it('| should return user info for valid token', async () => {
438
+ // Manually create a token and store it in accessTokens map
439
+ const accessToken = 'test-access-token-' + Date.now();
440
+ const tokenData = {
441
+ clientId: 'client-123',
442
+ scope: 'profile email',
443
+ expiresAt: Date.now() + 3600000, // 1 hour
444
+ };
445
+ (service as any).accessTokens.set(accessToken, tokenData);
446
+ mockAuthService.getTokenFromRequest.and.returnValue(accessToken);
447
+ mockResponse.json = jasmine.createSpy('json');
448
+
449
+ await service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response);
450
+
451
+ expect(mockResponse.json).toHaveBeenCalled();
452
+ const response = (mockResponse.json as jasmine.Spy).calls.mostRecent().args[0];
453
+ expect(response.sub).toBeDefined();
454
+ expect(response.name).toBeDefined();
455
+ expect(response.email).toBeDefined();
456
+ });
457
+
458
+ it('| should throw error when token is missing', async () => {
459
+ mockAuthService.getTokenFromRequest.and.throwError(new Error('Token missing'));
460
+
461
+ await expectAsync(
462
+ service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
463
+ ).toBeRejected();
464
+ });
465
+
466
+ it('| should throw error when token is invalid', async () => {
467
+ mockAuthService.getTokenFromRequest.and.returnValue('invalid-token');
468
+
469
+ await expectAsync(
470
+ service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
471
+ ).toBeRejected();
472
+ });
473
+
474
+ it('| should throw error when token is expired', async () => {
475
+ // Manually create an expired token
476
+ const expiredToken = 'expired-token-' + Date.now();
477
+ (service as any).accessTokens.set(expiredToken, {
478
+ clientId: 'client-123',
479
+ scope: 'read',
480
+ expiresAt: Date.now() - 1000, // Expired
481
+ });
482
+ mockAuthService.getTokenFromRequest.and.returnValue(`Bearer ${expiredToken}`);
483
+
484
+ await expectAsync(
485
+ service.handleUserInfoRequest(mockRequest as Request, mockResponse as Response)
486
+ ).toBeRejected();
487
+ });
488
+ });
489
+
490
+ describe('| handleTokenRevocation', () => {
491
+ beforeEach(() => {
492
+ spyOn(service as any, 'generateAccessToken').and.returnValue(Promise.resolve('mock-access-token'));
493
+ spyOn(service as any, 'generateRefreshToken').and.returnValue(Promise.resolve('mock-refresh-token'));
494
+ });
495
+
496
+ it('| should revoke access token', async () => {
497
+ const accessToken = await (service as any).generateAccessToken('client-123', 'read');
498
+ (service as any).accessTokens.set(accessToken, {
499
+ clientId: 'client-123',
500
+ scope: 'read',
501
+ expiresAt: Date.now() + 3600000,
502
+ });
503
+ mockRequest.body = {
504
+ token: accessToken,
505
+ token_type_hint: 'access_token',
506
+ };
507
+
508
+ await service.handleTokenRevocation(mockRequest as Request, mockResponse as Response);
509
+
510
+ expect(mockResponse.status).toHaveBeenCalledWith(200);
511
+ expect((service as any).accessTokens.has(accessToken)).toBe(false);
512
+ });
513
+
514
+ it('| should revoke refresh token and associated access token', async () => {
515
+ const accessToken = await (service as any).generateAccessToken('client-123', 'read');
516
+ (service as any).accessTokens.set(accessToken, {
517
+ clientId: 'client-123',
518
+ scope: 'read',
519
+ expiresAt: Date.now() + 3600000,
520
+ });
521
+ const refreshToken = await (service as any).generateRefreshToken('client-123');
522
+ (service as any).refreshTokens.set(refreshToken, {
523
+ clientId: 'client-123',
524
+ scope: 'read',
525
+ accessToken: accessToken,
526
+ });
527
+
528
+ mockRequest.body = {
529
+ token: refreshToken,
530
+ token_type_hint: 'refresh_token',
531
+ };
532
+
533
+ await service.handleTokenRevocation(mockRequest as Request, mockResponse as Response);
534
+
535
+ expect(mockResponse.status).toHaveBeenCalledWith(200);
536
+ expect((service as any).refreshTokens.has(refreshToken)).toBe(false);
537
+ expect((service as any).accessTokens.has(accessToken)).toBe(false);
538
+ });
539
+
540
+ it('| should throw error when token is missing', async () => {
541
+ mockRequest.body = {};
542
+
543
+ await expectAsync(
544
+ service.handleTokenRevocation(mockRequest as Request, mockResponse as Response)
545
+ ).toBeRejected();
546
+ });
547
+
548
+ it('| should throw error when token is not found', async () => {
549
+ mockRequest.body = {
550
+ token: 'non-existent-token',
551
+ };
552
+
553
+ await expectAsync(
554
+ service.handleTokenRevocation(mockRequest as Request, mockResponse as Response)
555
+ ).toBeRejected();
556
+ });
557
+ });
558
+
559
+ describe('| getAccessTokenData', () => {
560
+ it('| should return access token data when token exists', async () => {
561
+ // Manually create a token and store it in accessTokens map
562
+ const accessToken = 'test-access-token-' + Date.now();
563
+ const tokenData = {
564
+ clientId: 'client-123',
565
+ scope: 'read',
566
+ expiresAt: Date.now() + 3600000, // 1 hour
567
+ };
568
+ (service as any).accessTokens.set(accessToken, tokenData);
569
+
570
+ const result = service.getAccessTokenData(accessToken);
571
+
572
+ expect(result).toBeDefined();
573
+ expect(result?.clientId).toBe('client-123');
574
+ expect(result?.scope).toBe('read');
575
+ expect(result?.expiresAt).toBeGreaterThan(Date.now());
576
+ });
577
+
578
+ it('| should return undefined when token does not exist', () => {
579
+ const tokenData = service.getAccessTokenData('non-existent-token');
580
+
581
+ expect(tokenData).toBeUndefined();
582
+ });
583
+ });
584
+ });
585
+