@futdevpro/nts-dynamo 1.15.39 → 1.15.40

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 (327) 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/logs/cicd-pipeline/output.log +2567 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +319 -0
  18. package/.github/workflows/main.yml +432 -432
  19. package/.vscode/settings.json +10 -10
  20. package/HOWTO.md +15 -15
  21. package/LICENSE +21 -21
  22. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  23. package/_specifications/BACKLOG.md +92 -92
  24. package/_specifications/TODO.md +15 -15
  25. package/_specifications/agent.md +138 -138
  26. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts +6 -0
  27. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts.map +1 -1
  28. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js +25 -7
  29. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js.map +1 -1
  30. package/build/_modules/ai/_services/ai-llm.service-base.d.ts.map +1 -1
  31. package/build/_modules/ai/_services/ai-llm.service-base.js +7 -0
  32. package/build/_modules/ai/_services/ai-llm.service-base.js.map +1 -1
  33. package/eslint.config.js +3 -3
  34. package/nodemon.json +24 -24
  35. package/package.json +1 -1
  36. package/pnpm-workspace.yaml +8 -8
  37. package/scripts/run-coverage-tests.js +28 -28
  38. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  39. package/spec/support/helpers/ts-node-helper.js +93 -93
  40. package/spec/support/jasmine.coverage.json +24 -24
  41. package/spec/support/jasmine.json +24 -24
  42. package/src/_collections/archive.util.spec.ts +57 -57
  43. package/src/_collections/archive.util.ts +18 -18
  44. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  45. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  46. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  47. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  48. package/src/_collections/default-not-found-page.const.ts +22 -22
  49. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  50. package/src/_collections/default-socket-path.const.ts +2 -2
  51. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  52. package/src/_collections/get-environment-settings.util.ts +48 -48
  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 +578 -578
  69. package/src/_models/control-models/endpoint-params.control-model.ts +526 -526
  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 -106
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1011
  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 -510
  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/messaging/README.md +354 -354
  219. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  220. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  221. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  222. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  223. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  224. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  225. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  226. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  227. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  228. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  229. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  230. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  231. package/src/_modules/messaging/index.ts +30 -30
  232. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  233. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  234. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  235. package/src/_modules/mock/app-params.mock.ts +9 -9
  236. package/src/_modules/mock/app-server.mock.ts +188 -188
  237. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  238. package/src/_modules/mock/auth-service.mock.ts +28 -28
  239. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  240. package/src/_modules/mock/controller.mock.ts +16 -16
  241. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  242. package/src/_modules/mock/data-model.mock.ts +82 -82
  243. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  244. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  245. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  246. package/src/_modules/mock/email-service.mock.ts +20 -20
  247. package/src/_modules/mock/email-template.mock.html +14 -14
  248. package/src/_modules/mock/endpoint.mock.ts +91 -91
  249. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  250. package/src/_modules/mock/socket-client.mock.ts +45 -45
  251. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  252. package/src/_modules/mock/socket-server.mock.ts +46 -46
  253. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  254. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  255. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  256. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  257. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  258. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  259. package/src/_modules/oauth2/index.ts +17 -17
  260. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  261. package/src/_modules/server/errors/errors.control-service.ts +85 -85
  262. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  263. package/src/_modules/server/errors/errors.controller.ts +431 -431
  264. package/src/_modules/server/errors/errors.data-service.spec.ts +355 -355
  265. package/src/_modules/server/index.ts +30 -30
  266. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  267. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  268. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  269. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  270. package/src/_modules/server/server-status/server-status.control-service.spec.ts +524 -524
  271. package/src/_modules/server/server-status/server-status.control-service.ts +336 -336
  272. package/src/_modules/server/server-status/server-status.controller.spec.ts +162 -162
  273. package/src/_modules/server/server-status/server-status.controller.ts +131 -131
  274. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  275. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  276. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  277. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  278. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  279. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  280. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  281. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  282. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  283. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  284. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  285. package/src/_modules/socket/app-extended.server.ts +630 -630
  286. package/src/_modules/socket/index.ts +42 -42
  287. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  288. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  289. package/src/_modules/test/index.ts +11 -11
  290. package/src/_modules/test/test.controller.spec.ts +72 -72
  291. package/src/_modules/test/test.controller.ts +115 -115
  292. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  293. package/src/_modules/usage/index.ts +15 -15
  294. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  295. package/src/_modules/usage/usage.controller.ts +126 -126
  296. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  297. package/src/_modules/usage/usage.data-service.ts +185 -185
  298. package/src/_services/base/api.service-base.spec.ts +125 -125
  299. package/src/_services/base/api.service-base.ts +74 -74
  300. package/src/_services/base/archive-data.service.spec.ts +196 -196
  301. package/src/_services/base/archive-data.service.ts +216 -216
  302. package/src/_services/base/data.service.spec.ts +674 -674
  303. package/src/_services/base/data.service.ts +2719 -2719
  304. package/src/_services/base/db.service.spec.ts +73 -73
  305. package/src/_services/base/db.service.ts +1575 -1575
  306. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  307. package/src/_services/base/singleton.service-base.ts +24 -24
  308. package/src/_services/base/singleton.service.spec.ts +114 -114
  309. package/src/_services/base/singleton.service.ts +38 -38
  310. package/src/_services/core/api.service.spec.ts +140 -140
  311. package/src/_services/core/auth.service.spec.ts +159 -159
  312. package/src/_services/core/auth.service.ts +174 -174
  313. package/src/_services/core/email.service.spec.ts +85 -85
  314. package/src/_services/core/email.service.ts +742 -742
  315. package/src/_services/core/global.service.spec.ts +275 -275
  316. package/src/_services/core/global.service.ts +461 -461
  317. package/src/_services/core/service-collection.service.spec.ts +46 -46
  318. package/src/_services/core/service-collection.service.ts +6 -6
  319. package/src/_services/route/controller.service.spec.ts +53 -53
  320. package/src/_services/route/controller.service.ts +148 -148
  321. package/src/_services/route/routing-module.service.spec.ts +98 -98
  322. package/src/_services/route/routing-module.service.ts +330 -330
  323. package/src/_services/shared.static-service.spec.ts +99 -99
  324. package/src/_services/shared.static-service.ts +78 -78
  325. package/src/index.ts +95 -95
  326. package/tsconfig.app.json +12 -12
  327. package/tsconfig.json +42 -42
@@ -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
+