@futdevpro/nts-dynamo 1.15.53 → 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 (328) 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/_services/server/app.server.d.ts +16 -0
  26. package/build/_services/server/app.server.d.ts.map +1 -1
  27. package/build/_services/server/app.server.js +24 -0
  28. package/build/_services/server/app.server.js.map +1 -1
  29. package/eslint.config.js +3 -3
  30. package/nodemon.json +24 -24
  31. package/package.json +1 -1
  32. package/pnpm-workspace.yaml +4 -4
  33. package/scripts/run-coverage-tests.js +28 -28
  34. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  35. package/spec/support/helpers/ts-node-helper.js +93 -93
  36. package/spec/support/jasmine.coverage.json +24 -24
  37. package/spec/support/jasmine.json +24 -24
  38. package/src/_collections/archive.util.spec.ts +57 -57
  39. package/src/_collections/archive.util.ts +18 -18
  40. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  41. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  42. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  43. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  44. package/src/_collections/default-not-found-page.const.ts +22 -22
  45. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  46. package/src/_collections/default-socket-path.const.ts +2 -2
  47. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  48. package/src/_collections/get-environment-settings.util.ts +48 -48
  49. package/src/_collections/global-settings.const.ts +70 -70
  50. package/src/_collections/sample.env +21 -21
  51. package/src/_collections/star.controller.spec.ts +224 -224
  52. package/src/_collections/star.controller.ts +129 -129
  53. package/src/_enums/data-model-type.enum.ts +14 -14
  54. package/src/_enums/data-service-function.enum.ts +24 -24
  55. package/src/_enums/predefined-data-types.enum.ts +16 -16
  56. package/src/_enums/route-security.enum.ts +12 -12
  57. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  58. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  59. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  60. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  61. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  62. package/src/_models/control-models/app-params.control-model.ts +136 -136
  63. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  64. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  65. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  66. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  67. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  68. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  69. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  70. package/src/_models/control-models/system-control.control-model.ts +12 -12
  71. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  72. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  73. package/src/_models/interfaces/global-log-settings.interface.ts +144 -144
  74. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  75. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  76. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  77. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  78. package/src/_models/types/db-update.type.ts +100 -100
  79. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  80. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  81. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  82. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  83. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  84. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  85. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  87. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  88. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  89. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  90. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  91. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  92. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  93. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  94. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  95. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  96. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  97. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  98. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  99. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  100. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  101. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  102. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  103. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  104. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  105. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  106. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  107. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  108. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  109. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  110. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  111. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  112. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  115. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  116. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  117. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  118. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  119. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  120. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  121. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  122. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  123. package/src/_modules/ai/index.ts +13 -13
  124. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  125. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  126. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  127. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  128. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  129. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  130. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  131. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  132. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  133. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  134. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  135. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  136. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  137. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  138. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  139. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  140. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  141. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  142. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  143. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  144. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  145. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  146. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  147. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  148. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  149. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  150. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  151. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  152. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  153. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  154. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  155. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  156. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  157. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  158. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  159. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  160. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  161. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  162. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  163. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  164. package/src/_modules/custom-data/index.ts +9 -9
  165. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  166. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  167. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  168. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  169. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  170. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  171. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  172. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  173. package/src/_modules/defaults/index.ts +17 -17
  174. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  175. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  176. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  177. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  178. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  179. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  180. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  181. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  182. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  183. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  184. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  185. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  186. package/src/_modules/discord-assistant/index.ts +38 -38
  187. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  188. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  189. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  190. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  191. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  192. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  193. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  194. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  195. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  196. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  197. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  198. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  199. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  200. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  201. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  202. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  203. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  204. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  205. package/src/_modules/discord-bot/index.ts +36 -36
  206. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  207. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  208. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  209. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  210. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  211. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  212. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  213. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  214. package/src/_modules/local-vector-search/index.ts +11 -11
  215. package/src/_modules/logs/index.ts +11 -11
  216. package/src/_modules/messaging/README.md +354 -354
  217. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  218. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  219. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  220. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  221. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  222. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  223. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  224. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  225. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  226. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  227. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  228. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  229. package/src/_modules/messaging/index.ts +30 -30
  230. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  231. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  232. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  233. package/src/_modules/mock/app-params.mock.ts +9 -9
  234. package/src/_modules/mock/app-server.mock.ts +188 -188
  235. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  236. package/src/_modules/mock/auth-service.mock.ts +28 -28
  237. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  238. package/src/_modules/mock/controller.mock.ts +16 -16
  239. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  240. package/src/_modules/mock/data-model.mock.ts +82 -82
  241. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  242. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  243. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  244. package/src/_modules/mock/email-service.mock.ts +20 -20
  245. package/src/_modules/mock/email-template.mock.html +14 -14
  246. package/src/_modules/mock/endpoint.mock.ts +91 -91
  247. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  248. package/src/_modules/mock/socket-client.mock.ts +45 -45
  249. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  250. package/src/_modules/mock/socket-server.mock.ts +46 -46
  251. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  252. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  253. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  254. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  255. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  256. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  257. package/src/_modules/oauth2/index.ts +17 -17
  258. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  259. package/src/_modules/server/errors/errors.control-service.ts +85 -85
  260. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  261. package/src/_modules/server/errors/errors.controller.ts +431 -431
  262. package/src/_modules/server/errors/errors.data-service.spec.ts +361 -361
  263. package/src/_modules/server/index.ts +30 -30
  264. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  265. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  266. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  267. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  268. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  269. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  270. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
  271. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  272. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  273. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  274. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  275. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  276. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  277. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  278. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  279. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  280. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  281. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  282. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  283. package/src/_modules/socket/app-extended.server.ts +630 -630
  284. package/src/_modules/socket/index.ts +42 -42
  285. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  286. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  287. package/src/_modules/test/index.ts +11 -11
  288. package/src/_modules/test/test.controller.spec.ts +72 -72
  289. package/src/_modules/test/test.controller.ts +115 -115
  290. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  291. package/src/_modules/usage/index.ts +15 -15
  292. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  293. package/src/_modules/usage/usage.controller.ts +126 -126
  294. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  295. package/src/_modules/usage/usage.data-service.ts +185 -185
  296. package/src/_services/base/api.service-base.spec.ts +125 -125
  297. package/src/_services/base/api.service-base.ts +74 -74
  298. package/src/_services/base/archive-data.service.spec.ts +196 -196
  299. package/src/_services/base/archive-data.service.ts +216 -216
  300. package/src/_services/base/data.service.spec.ts +674 -674
  301. package/src/_services/base/data.service.ts +2719 -2719
  302. package/src/_services/base/db.service.spec.ts +73 -73
  303. package/src/_services/base/db.service.ts +1575 -1575
  304. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  305. package/src/_services/base/singleton.service-base.ts +24 -24
  306. package/src/_services/base/singleton.service.spec.ts +114 -114
  307. package/src/_services/base/singleton.service.ts +38 -38
  308. package/src/_services/core/api.service.spec.ts +140 -140
  309. package/src/_services/core/auth.service.spec.ts +159 -159
  310. package/src/_services/core/auth.service.ts +174 -174
  311. package/src/_services/core/email.service.spec.ts +85 -85
  312. package/src/_services/core/email.service.ts +742 -742
  313. package/src/_services/core/global.service.spec.ts +275 -275
  314. package/src/_services/core/global.service.ts +461 -461
  315. package/src/_services/core/service-collection.service.spec.ts +46 -46
  316. package/src/_services/core/service-collection.service.ts +6 -6
  317. package/src/_services/route/controller.service.spec.ts +53 -53
  318. package/src/_services/route/controller.service.ts +148 -148
  319. package/src/_services/route/routing-module.service.spec.ts +98 -98
  320. package/src/_services/route/routing-module.service.ts +330 -330
  321. package/src/_services/server/app.server.ts +1713 -1672
  322. package/src/_services/shared.static-service.spec.ts +99 -99
  323. package/src/_services/shared.static-service.ts +78 -78
  324. package/src/index.ts +95 -95
  325. package/tsconfig.app.json +12 -12
  326. package/tsconfig.json +42 -42
  327. package/.dynamo/logs/cicd-pipeline/output.log +0 -2682
  328. 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
+