@futdevpro/nts-dynamo 1.15.127 → 1.15.129

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 (389) 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 +2852 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.dynamo/pipeline.cicd.config.json +3 -1
  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/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  24. package/_specifications/BACKLOG.md +92 -92
  25. package/_specifications/TODO.md +15 -15
  26. package/_specifications/agent.md +138 -138
  27. package/build/_models/control-models/endpoint-params.control-model.d.ts.map +1 -1
  28. package/build/_models/control-models/endpoint-params.control-model.js +9 -0
  29. package/build/_models/control-models/endpoint-params.control-model.js.map +1 -1
  30. package/build/_modules/server/errors/errors.data-service.d.ts +6 -0
  31. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  32. package/build/_modules/server/errors/errors.data-service.js +29 -3
  33. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  34. package/build/_services/core/event-loop-diag.service.d.ts +6 -0
  35. package/build/_services/core/event-loop-diag.service.d.ts.map +1 -1
  36. package/build/_services/core/event-loop-diag.service.js +19 -1
  37. package/build/_services/core/event-loop-diag.service.js.map +1 -1
  38. package/build/_services/core/request-hunter.service.d.ts +74 -0
  39. package/build/_services/core/request-hunter.service.d.ts.map +1 -0
  40. package/build/_services/core/request-hunter.service.js +123 -0
  41. package/build/_services/core/request-hunter.service.js.map +1 -0
  42. package/build/index.d.ts +1 -0
  43. package/build/index.d.ts.map +1 -1
  44. package/build/index.js +1 -0
  45. package/build/index.js.map +1 -1
  46. package/eslint.config.js +3 -3
  47. package/nodemon.json +24 -24
  48. package/package.json +2 -2
  49. package/pnpm-workspace.yaml +5 -5
  50. package/scripts/run-coverage-tests.js +28 -28
  51. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  52. package/spec/support/helpers/ts-node-helper.js +93 -93
  53. package/spec/support/jasmine.coverage.json +24 -24
  54. package/spec/support/jasmine.json +24 -24
  55. package/src/_collections/archive.util.spec.ts +57 -57
  56. package/src/_collections/archive.util.ts +18 -18
  57. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  58. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  59. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  60. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  61. package/src/_collections/default-not-found-page.const.ts +22 -22
  62. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  63. package/src/_collections/default-socket-path.const.ts +2 -2
  64. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  65. package/src/_collections/get-environment-settings.util.ts +48 -48
  66. package/src/_collections/global-settings.const.ts +126 -126
  67. package/src/_collections/sample.env +21 -21
  68. package/src/_collections/signed-url.util.spec.ts +198 -198
  69. package/src/_collections/signed-url.util.ts +170 -170
  70. package/src/_collections/star.controller.spec.ts +224 -224
  71. package/src/_collections/star.controller.ts +129 -129
  72. package/src/_enums/data-model-type.enum.ts +14 -14
  73. package/src/_enums/data-service-function.enum.ts +24 -24
  74. package/src/_enums/predefined-data-types.enum.ts +16 -16
  75. package/src/_enums/route-security.enum.ts +12 -12
  76. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  77. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  78. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  79. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  80. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  81. package/src/_models/control-models/app-params.control-model.ts +136 -136
  82. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  83. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  84. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  85. package/src/_models/control-models/endpoint-params.control-model.ts +664 -656
  86. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  87. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  88. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  89. package/src/_models/control-models/system-control.control-model.ts +12 -12
  90. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  91. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  92. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  93. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  94. package/src/_models/interfaces/global-settings.interface.ts +286 -286
  95. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  96. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  97. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  98. package/src/_models/types/db-update.type.ts +100 -100
  99. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  100. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  101. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  102. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  103. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  104. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  105. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  106. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  107. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  108. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  109. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  110. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  111. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  112. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  113. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  114. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  115. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  116. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  117. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  118. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  119. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  120. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  121. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  122. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  123. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  124. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  125. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  126. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  127. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  128. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  129. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  130. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  131. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  132. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  133. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  134. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  135. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  136. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  137. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  138. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  139. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  140. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  141. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  142. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  143. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  144. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  145. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  146. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  147. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  148. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  149. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  150. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  151. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  152. package/src/_modules/ai/index.ts +33 -33
  153. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  154. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  155. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  156. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  157. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  158. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  159. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  160. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  161. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  162. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  163. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  164. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  165. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  166. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  167. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  168. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  169. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  170. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  171. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  172. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  173. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  174. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  175. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  176. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  177. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  178. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  179. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  180. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  181. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  182. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  183. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  184. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  185. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  186. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  187. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  188. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  189. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  190. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  191. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  192. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  193. package/src/_modules/custom-data/index.ts +9 -9
  194. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  195. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  196. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  197. package/src/_modules/data-readers/index.ts +11 -11
  198. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  199. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  200. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  201. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  202. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  203. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  204. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  205. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  206. package/src/_modules/defaults/index.ts +17 -17
  207. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  208. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  209. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  210. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  211. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  212. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  213. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  214. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  215. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  216. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  217. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  218. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  219. package/src/_modules/discord-assistant/index.ts +38 -38
  220. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  221. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  222. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  223. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  224. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  225. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  226. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  227. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  228. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  229. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  230. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  231. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  232. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  233. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  234. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  235. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  236. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  237. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  238. package/src/_modules/discord-bot/index.ts +36 -36
  239. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  240. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  241. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  242. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  243. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  244. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  245. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  246. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  247. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  248. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  249. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  250. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  251. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  252. package/src/_modules/local-vector-search/index.ts +16 -16
  253. package/src/_modules/logs/index.ts +11 -11
  254. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  255. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  256. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  257. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  258. package/src/_modules/mcp/index.ts +13 -13
  259. package/src/_modules/messaging/README.md +354 -354
  260. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  261. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  262. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  263. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  264. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  265. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  266. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  267. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  268. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  269. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  270. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  271. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  272. package/src/_modules/messaging/index.ts +30 -30
  273. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  274. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  275. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  276. package/src/_modules/mock/app-params.mock.ts +9 -9
  277. package/src/_modules/mock/app-server.mock.ts +188 -188
  278. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  279. package/src/_modules/mock/auth-service.mock.ts +28 -28
  280. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  281. package/src/_modules/mock/controller.mock.ts +16 -16
  282. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  283. package/src/_modules/mock/data-model.mock.ts +82 -82
  284. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  285. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  286. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  287. package/src/_modules/mock/email-service.mock.ts +20 -20
  288. package/src/_modules/mock/email-template.mock.html +14 -14
  289. package/src/_modules/mock/endpoint.mock.ts +91 -91
  290. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  291. package/src/_modules/mock/socket-client.mock.ts +45 -45
  292. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  293. package/src/_modules/mock/socket-server.mock.ts +46 -46
  294. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  295. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  296. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  297. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  298. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  299. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  300. package/src/_modules/oauth2/index.ts +17 -17
  301. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  302. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  303. package/src/_modules/scheduler/index.ts +8 -8
  304. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  305. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  306. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  307. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  308. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  309. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  310. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  311. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  312. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  313. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  314. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  315. package/src/_modules/scoped-config/index.ts +17 -17
  316. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  317. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  318. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  319. package/src/_modules/server/errors/errors.controller.ts +515 -515
  320. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  321. package/src/_modules/server/errors/errors.data-service.ts +30 -3
  322. package/src/_modules/server/index.ts +30 -30
  323. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  324. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  325. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  326. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  327. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  328. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  329. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  330. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  331. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  332. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  333. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  334. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  335. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  336. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  337. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  338. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  339. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  340. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  341. package/src/_modules/socket/app-extended.server.ts +648 -648
  342. package/src/_modules/socket/index.ts +42 -42
  343. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  344. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  345. package/src/_modules/test/index.ts +11 -11
  346. package/src/_modules/test/test.controller.spec.ts +72 -72
  347. package/src/_modules/test/test.controller.ts +115 -115
  348. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  349. package/src/_modules/usage/index.ts +15 -15
  350. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  351. package/src/_modules/usage/usage.controller.ts +126 -126
  352. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  353. package/src/_modules/usage/usage.data-service.ts +185 -185
  354. package/src/_services/base/api.service-base.spec.ts +125 -125
  355. package/src/_services/base/api.service-base.ts +74 -74
  356. package/src/_services/base/archive-data.service.spec.ts +209 -209
  357. package/src/_services/base/archive-data.service.ts +223 -223
  358. package/src/_services/base/data.service.spec.ts +729 -729
  359. package/src/_services/base/data.service.ts +2758 -2758
  360. package/src/_services/base/db.service.spec.ts +160 -160
  361. package/src/_services/base/db.service.ts +1698 -1698
  362. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  363. package/src/_services/base/singleton.service-base.ts +24 -24
  364. package/src/_services/base/singleton.service.spec.ts +114 -114
  365. package/src/_services/base/singleton.service.ts +38 -38
  366. package/src/_services/core/api.service.spec.ts +140 -140
  367. package/src/_services/core/auth.service.spec.ts +159 -159
  368. package/src/_services/core/auth.service.ts +174 -174
  369. package/src/_services/core/email.service.spec.ts +85 -85
  370. package/src/_services/core/email.service.ts +757 -757
  371. package/src/_services/core/event-loop-diag.service.ts +23 -1
  372. package/src/_services/core/global.service.spec.ts +292 -292
  373. package/src/_services/core/global.service.ts +487 -487
  374. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  375. package/src/_services/core/memory-guard.service.ts +481 -481
  376. package/src/_services/core/request-hunter.service.spec.ts +124 -0
  377. package/src/_services/core/request-hunter.service.ts +157 -0
  378. package/src/_services/core/service-collection.service.spec.ts +46 -46
  379. package/src/_services/core/service-collection.service.ts +6 -6
  380. package/src/_services/route/controller.service.spec.ts +53 -53
  381. package/src/_services/route/controller.service.ts +148 -148
  382. package/src/_services/route/routing-module.service.spec.ts +98 -98
  383. package/src/_services/route/routing-module.service.ts +330 -330
  384. package/src/_services/server/app.server.ts +1985 -1985
  385. package/src/_services/shared.static-service.spec.ts +99 -99
  386. package/src/_services/shared.static-service.ts +78 -78
  387. package/src/index.ts +113 -112
  388. package/tsconfig.app.json +12 -12
  389. package/tsconfig.json +42 -42
@@ -1,669 +1,669 @@
1
-
2
- import { Request, Response } from 'express';
3
- import { DyFM_HttpCallType, DyFM_Log, DyFM_Error, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
4
- import { DyNTS_Endpoint_Params } from './endpoint-params.control-model';
5
- import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
6
- import { DyNTS_global_settings } from '../../_collections/global-settings.const';
7
- import { DyNTS_GlobalService } from '../../_services/core/global.service';
8
-
9
- // Skipped: DyFM_Error stack trace causes Jasmine 'split' errors
10
- describe('| DyNTS_Endpoint_Params', () => {
11
- // Ensure env_settings and log_settings exist before tests
12
- beforeAll(() => {
13
- if (!DyNTS_global_settings.env_settings) {
14
- (DyNTS_global_settings as any).env_settings = {
15
- environment: DyFM_EnvironmentFlag.local,
16
- discord: {},
17
- mongoUri: undefined,
18
- openAi: {},
19
- };
20
- } else if (!DyNTS_global_settings.env_settings.environment) {
21
- DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.local;
22
- }
23
- // Initialize log_settings for error handling tests
24
- if (!DyNTS_global_settings.log_settings) {
25
- (DyNTS_global_settings as any).log_settings = {
26
- highDetailedLogs: false,
27
- api_errors: true,
28
- requestStackLocation: false,
29
- };
30
- }
31
- // Initialize compactErrorResponse
32
- if (DyNTS_global_settings.compactErrorResponse === undefined) {
33
- (DyNTS_global_settings as any).compactErrorResponse = false;
34
- }
35
- });
36
-
37
- describe('| constructor', () => {
38
- it('| should create an instance with required parameters', () => {
39
- const tasks = [
40
- async (req: Request, res: Response, issuer: string): Promise<void> => {
41
- res.send({ success: true });
42
- },
43
- ];
44
-
45
- const params = new DyNTS_Endpoint_Params({
46
- name: 'testEndpoint',
47
- type: DyFM_HttpCallType.get,
48
- endpoint: '/test',
49
- tasks: tasks,
50
- });
51
-
52
- expect(params.name).toBe('testEndpoint');
53
- expect(params.type).toBe(DyFM_HttpCallType.get);
54
- expect(params.endpoint).toBe('/test');
55
- expect((params as any).tasks).toBe(tasks);
56
- });
57
-
58
- it('| should set default security to open', () => {
59
- const tasks = [
60
- async (req: Request, res: Response, issuer: string): Promise<void> => {
61
- res.send({ success: true });
62
- },
63
- ];
64
-
65
- const params = new DyNTS_Endpoint_Params({
66
- name: 'testEndpoint',
67
- type: DyFM_HttpCallType.get,
68
- endpoint: '/test',
69
- tasks: tasks,
70
- });
71
-
72
- expect(params.security).toBe(DyNTS_RouteSecurity.open);
73
- });
74
-
75
- it('| should use provided security', () => {
76
- const tasks = [
77
- async (req: Request, res: Response, issuer: string): Promise<void> => {
78
- res.send({ success: true });
79
- },
80
- ];
81
-
82
- const params = new DyNTS_Endpoint_Params({
83
- name: 'testEndpoint',
84
- type: DyFM_HttpCallType.get,
85
- endpoint: '/test',
86
- security: DyNTS_RouteSecurity.secure,
87
- tasks: tasks,
88
- });
89
-
90
- expect(params.security).toBe(DyNTS_RouteSecurity.secure);
91
- });
92
-
93
- it('| should extract path parameters from endpoint', () => {
94
- const tasks = [
95
- async (req: Request, res: Response, issuer: string): Promise<void> => {
96
- res.send({ success: true });
97
- },
98
- ];
99
-
100
- const params = new DyNTS_Endpoint_Params({
101
- name: 'testEndpoint',
102
- type: DyFM_HttpCallType.get,
103
- endpoint: '/test/:userId/:itemId',
104
- tasks: tasks,
105
- });
106
-
107
- expect(params['pathParams']).toEqual(['userId', 'itemId']);
108
- });
109
-
110
- it('| should handle endpoint without path parameters', () => {
111
- const tasks = [
112
- async (req: Request, res: Response, issuer: string): Promise<void> => {
113
- res.send({ success: true });
114
- },
115
- ];
116
-
117
- const params = new DyNTS_Endpoint_Params({
118
- name: 'testEndpoint',
119
- type: DyFM_HttpCallType.get,
120
- endpoint: '/test',
121
- tasks: tasks,
122
- });
123
-
124
- expect(params['pathParams']).toEqual([]);
125
- });
126
-
127
- it('| should set default logRequest to false', () => {
128
- const tasks = [
129
- async (req: Request, res: Response, issuer: string): Promise<void> => {
130
- res.send({ success: true });
131
- },
132
- ];
133
-
134
- const params = new DyNTS_Endpoint_Params({
135
- name: 'testEndpoint',
136
- type: DyFM_HttpCallType.get,
137
- endpoint: '/test',
138
- tasks: tasks,
139
- });
140
-
141
- expect(params['logRequest']).toBe(DyNTS_global_settings.log_settings.request);
142
- });
143
-
144
- it('| should use provided logRequest value', () => {
145
- const tasks = [
146
- async (req: Request, res: Response, issuer: string): Promise<void> => {
147
- res.send({ success: true });
148
- },
149
- ];
150
-
151
- const params = new DyNTS_Endpoint_Params({
152
- name: 'testEndpoint',
153
- type: DyFM_HttpCallType.get,
154
- endpoint: '/test',
155
- tasks: tasks,
156
- logRequest: true,
157
- });
158
-
159
- expect(params['logRequest']).toBe(true);
160
- });
161
-
162
- it('| should set default autoResolveCirculation to false', () => {
163
- const tasks = [
164
- async (req: Request, res: Response, issuer: string): Promise<void> => {
165
- res.send({ success: true });
166
- },
167
- ];
168
-
169
- const params = new DyNTS_Endpoint_Params({
170
- name: 'testEndpoint',
171
- type: DyFM_HttpCallType.get,
172
- endpoint: '/test',
173
- tasks: tasks,
174
- });
175
-
176
- expect(params['autoResolveCirculation']).toBe(DyNTS_global_settings.autoResolveEndpointCirculationErrors);
177
- });
178
-
179
- it('| should set stackLocation', () => {
180
- const tasks = [
181
- async (req: Request, res: Response, issuer: string): Promise<void> => {
182
- res.send({ success: true });
183
- },
184
- ];
185
-
186
- const params = new DyNTS_Endpoint_Params({
187
- name: 'testEndpoint',
188
- type: DyFM_HttpCallType.get,
189
- endpoint: '/test',
190
- tasks: tasks,
191
- });
192
-
193
- expect(params.stackLocation).toBeDefined();
194
- expect(typeof params.stackLocation).toBe('string');
195
- });
196
-
197
- it('| should handle preProcesses', () => {
198
- const preProcess = async (req: Request, res: Response): Promise<void> => {
199
- // Pre-process logic
200
- };
201
-
202
- const tasks = [
203
- async (req: Request, res: Response, issuer: string): Promise<void> => {
204
- res.send({ success: true });
205
- },
206
- ];
207
-
208
- const params = new DyNTS_Endpoint_Params({
209
- name: 'testEndpoint',
210
- type: DyFM_HttpCallType.get,
211
- endpoint: '/test',
212
- preProcesses: [preProcess],
213
- tasks: tasks,
214
- });
215
-
216
- expect(params['preProcesses']).toEqual([preProcess]);
217
- });
218
-
219
- it('| should throw error when endpoint is not provided', () => {
220
- const tasks = [
221
- async (req: Request, res: Response, issuer: string): Promise<void> => {
222
- res.send({ success: true });
223
- },
224
- ];
225
-
226
- expect(() => {
227
- new DyNTS_Endpoint_Params({
228
- name: 'testEndpoint',
229
- type: DyFM_HttpCallType.get,
230
- endpoint: '',
231
- tasks: tasks,
232
- });
233
- }).toThrow();
234
- });
235
-
236
- it('| should set default log settings from global settings', () => {
237
- const tasks = [
238
- async (req: Request, res: Response, issuer: string): Promise<void> => {
239
- res.send({ success: true });
240
- },
241
- ];
242
-
243
- const params = new DyNTS_Endpoint_Params({
244
- name: 'testEndpoint',
245
- type: DyFM_HttpCallType.get,
246
- endpoint: '/test',
247
- tasks: tasks,
248
- });
249
-
250
- expect(params['logRequestsParams']).toBe(DyNTS_global_settings.log_settings.requestsParams);
251
- expect(params['logRequestsContent']).toBe(DyNTS_global_settings.log_settings.requestsContent);
252
- expect(params['logResponseContent']).toBe(DyNTS_global_settings.log_settings.responseContent);
253
- });
254
-
255
- it('| should use provided log settings', () => {
256
- const tasks = [
257
- async (req: Request, res: Response, issuer: string): Promise<void> => {
258
- res.send({ success: true });
259
- },
260
- ];
261
-
262
- const params = new DyNTS_Endpoint_Params({
263
- name: 'testEndpoint',
264
- type: DyFM_HttpCallType.get,
265
- endpoint: '/test',
266
- tasks: tasks,
267
- logRequestsParams: true,
268
- logRequestsContent: true,
269
- logResponseContent: true,
270
- });
271
-
272
- expect(params['logRequestsParams']).toBe(true);
273
- expect(params['logRequestsContent']).toBe(true);
274
- expect(params['logResponseContent']).toBe(true);
275
- });
276
-
277
- it('| should use endpoint as name when name is not provided', () => {
278
- const tasks = [
279
- async (req: Request, res: Response, issuer: string): Promise<void> => {
280
- res.send({ success: true });
281
- },
282
- ];
283
-
284
- const params = new DyNTS_Endpoint_Params({
285
- name: '/test-endpoint',
286
- type: DyFM_HttpCallType.get,
287
- endpoint: '/test-endpoint',
288
- tasks: tasks,
289
- });
290
-
291
- expect(params.name).toBe('/test-endpoint');
292
- });
293
- });
294
-
295
- describe('| getFullExecution', () => {
296
- let mockRequest: Partial<Request>;
297
- let mockResponse: Partial<Response>;
298
- let sendSpy: jasmine.Spy;
299
- let statusSpy: jasmine.Spy;
300
-
301
- beforeEach(() => {
302
- mockRequest = {
303
- params: {},
304
- body: {},
305
- originalUrl: '/test',
306
- };
307
- sendSpy = jasmine.createSpy('send');
308
- statusSpy = jasmine.createSpy('status').and.returnValue({ send: sendSpy });
309
- mockResponse = {
310
- send: sendSpy,
311
- status: statusSpy,
312
- };
313
-
314
- spyOn(DyNTS_GlobalService, 'getAuthService').and.returnValue({
315
- getIssuerFromRequest: () => 'test-issuer',
316
- } as any);
317
- });
318
-
319
- it('| should execute tasks successfully', async () => {
320
- const taskSpy = jasmine.createSpy('task').and.callFake(async (req: Request, res: Response, issuer: string) => {
321
- res.send({ success: true });
322
- });
323
- const params = new DyNTS_Endpoint_Params({
324
- name: 'testEndpoint',
325
- type: DyFM_HttpCallType.get,
326
- endpoint: '/test',
327
- tasks: [taskSpy],
328
- logRequest: false,
329
- });
330
-
331
- const execution = params.getFullExecution();
332
- await execution(mockRequest as Request, mockResponse as Response);
333
-
334
- expect(taskSpy).toHaveBeenCalledWith(mockRequest, mockResponse, 'test-issuer');
335
- expect(sendSpy).toHaveBeenCalled();
336
- });
337
-
338
- it('| should execute preProcesses before tasks', async () => {
339
- const preProcessSpy = jasmine.createSpy('preProcess').and.returnValue(Promise.resolve());
340
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
341
- const params = new DyNTS_Endpoint_Params({
342
- name: 'testEndpoint',
343
- type: DyFM_HttpCallType.get,
344
- endpoint: '/test',
345
- preProcesses: [preProcessSpy],
346
- tasks: [taskSpy],
347
- logRequest: false,
348
- });
349
-
350
- const execution = params.getFullExecution();
351
- await execution(mockRequest as Request, mockResponse as Response);
352
-
353
- expect(preProcessSpy).toHaveBeenCalledBefore(taskSpy as any);
354
- expect(preProcessSpy).toHaveBeenCalledWith(mockRequest, mockResponse);
355
- });
356
-
357
- it('| should handle errors and call error handler', async () => {
358
- const error = new Error('Test error');
359
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
360
- const params = new DyNTS_Endpoint_Params({
361
- name: 'testEndpoint',
362
- type: DyFM_HttpCallType.get,
363
- endpoint: '/test',
364
- tasks: [taskSpy],
365
- logRequest: false,
366
- });
367
-
368
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
369
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
370
-
371
- const execution = params.getFullExecution();
372
- await execution(mockRequest as Request, mockResponse as Response);
373
- // Wait for async error handling to complete (error handler is not awaited in source)
374
- await new Promise(resolve => setTimeout(resolve, 50));
375
-
376
- expect(globalErrorHandlerSpy).toHaveBeenCalled();
377
- expect(statusSpy).toHaveBeenCalled();
378
- expect(statusSpy.calls.mostRecent().args[0]).toBe(500);
379
- expect(sendSpy).toHaveBeenCalled();
380
- });
381
-
382
- it('| should log request when logRequest is true', async () => {
383
- const logInfoSpy = spyOn(DyFM_Log, 'info');
384
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
385
- const params = new DyNTS_Endpoint_Params({
386
- name: 'testEndpoint',
387
- type: DyFM_HttpCallType.get,
388
- endpoint: '/test',
389
- tasks: [taskSpy],
390
- logRequest: true,
391
- logRequestsParams: false,
392
- logRequestsContent: false,
393
- });
394
-
395
- const execution = params.getFullExecution();
396
- await execution(mockRequest as Request, mockResponse as Response);
397
-
398
- expect(logInfoSpy).toHaveBeenCalled();
399
- });
400
-
401
- it('| should log path params when logRequestsParams is true', async () => {
402
- const logInfoSpy = spyOn(DyFM_Log, 'info');
403
- mockRequest.params = { userId: '123', itemId: '456' };
404
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
405
- const params = new DyNTS_Endpoint_Params({
406
- name: 'testEndpoint',
407
- type: DyFM_HttpCallType.get,
408
- endpoint: '/test/:userId/:itemId',
409
- tasks: [taskSpy],
410
- logRequest: true,
411
- logRequestsParams: true,
412
- logRequestsContent: false,
413
- });
414
-
415
- const execution = params.getFullExecution();
416
- await execution(mockRequest as Request, mockResponse as Response);
417
-
418
- expect(logInfoSpy).toHaveBeenCalled();
419
- });
420
-
421
- it('| should log request body when logRequestsContent is true', async () => {
422
- const logInfoSpy = spyOn(DyFM_Log, 'info');
423
- mockRequest.body = { key: 'value' };
424
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
425
- const params = new DyNTS_Endpoint_Params({
426
- name: 'testEndpoint',
427
- type: DyFM_HttpCallType.get,
428
- endpoint: '/test',
429
- tasks: [taskSpy],
430
- logRequest: true,
431
- logRequestsParams: false,
432
- logRequestsContent: true,
433
- });
434
-
435
- const execution = params.getFullExecution();
436
- await execution(mockRequest as Request, mockResponse as Response);
437
-
438
- expect(logInfoSpy).toHaveBeenCalled();
439
- });
440
-
441
- it('| should handle issuer retrieval error', async () => {
442
- (DyNTS_GlobalService.getAuthService as jasmine.Spy).and.returnValue({
443
- getIssuerFromRequest: () => { throw new Error('Auth error'); },
444
- } as any);
445
- const logWarnSpy = spyOn(DyFM_Log, 'warn');
446
- const taskSpy = jasmine.createSpy('task').and.callFake(async (req: Request, res: Response, issuer: string) => {
447
- res.send({ success: true });
448
- });
449
- const params = new DyNTS_Endpoint_Params({
450
- name: 'testEndpoint',
451
- type: DyFM_HttpCallType.get,
452
- endpoint: '/test',
453
- tasks: [taskSpy],
454
- logRequest: false,
455
- });
456
-
457
- const execution = params.getFullExecution();
458
- await execution(mockRequest as Request, mockResponse as Response);
459
-
460
- expect(logWarnSpy).toHaveBeenCalled();
461
- expect(taskSpy).toHaveBeenCalledWith(mockRequest, mockResponse, 'unknown-issuer');
462
- });
463
-
464
- it('| should handle DyFM_Error with status code', async () => {
465
- const error = new DyFM_Error({
466
- error: new Error('Test error'),
467
- });
468
- (error as any).___status = 404;
469
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
470
- const params = new DyNTS_Endpoint_Params({
471
- name: 'testEndpoint',
472
- type: DyFM_HttpCallType.get,
473
- endpoint: '/test',
474
- tasks: [taskSpy],
475
- logRequest: false,
476
- });
477
-
478
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
479
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
480
-
481
- const execution = params.getFullExecution();
482
- await execution(mockRequest as Request, mockResponse as Response);
483
- // Wait for async error handling to complete
484
- await new Promise(resolve => setTimeout(resolve, 50));
485
-
486
- expect(statusSpy).toHaveBeenCalled();
487
- expect(statusSpy.calls.mostRecent().args[0]).toBe(404);
488
- expect(sendSpy).toHaveBeenCalled();
489
- });
490
-
491
- it('| should use default status 500 when error has no status', async () => {
492
- const error = new Error('Test error');
493
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
494
- const params = new DyNTS_Endpoint_Params({
495
- name: 'testEndpoint',
496
- type: DyFM_HttpCallType.get,
497
- endpoint: '/test',
498
- tasks: [taskSpy],
499
- logRequest: false,
500
- });
501
-
502
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
503
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
504
-
505
- const execution = params.getFullExecution();
506
- await execution(mockRequest as Request, mockResponse as Response);
507
- // Wait for async error handling to complete
508
- await new Promise(resolve => setTimeout(resolve, 50));
509
-
510
- expect(statusSpy).toHaveBeenCalledWith(500);
511
- expect(sendSpy).toHaveBeenCalled();
512
- });
513
-
514
- // FR-067 (2026-06-06): non-DyFM_Error wrap — minden plain Error a kliens
515
- // fele DyFM_Error-shape-ben mehessen, errorCode-szal, userMessage-zsel.
516
- it('| FR-067: should wrap plain Error into DyFM_Error with FDP errorCode + userMessage', async () => {
517
- const originalShortCode = DyNTS_global_settings.systemShortCodeName;
518
- DyNTS_global_settings.systemShortCodeName = 'TST';
519
- const error = new Error('Raw error message');
520
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
521
- const params = new DyNTS_Endpoint_Params({
522
- name: 'myEndpoint',
523
- type: DyFM_HttpCallType.get,
524
- endpoint: '/test',
525
- tasks: [taskSpy],
526
- logRequest: false,
527
- });
528
- (DyNTS_GlobalService as any).globalErrorHandler = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
529
-
530
- const execution = params.getFullExecution();
531
- await execution(mockRequest as Request, mockResponse as Response);
532
- await new Promise(resolve => setTimeout(resolve, 50));
533
-
534
- expect(sendSpy).toHaveBeenCalled();
535
- const sent = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
536
- expect(sent._errorCode).toBe('TST|DyNTS-EPP-myEndpoint');
537
- expect(sent.__userMessage).toBeDefined();
538
- expect(statusSpy).toHaveBeenCalledWith(500);
539
-
540
- DyNTS_global_settings.systemShortCodeName = originalShortCode;
541
- });
542
-
543
- // FR-067: axios-style HTTP errors (with `status` field) — wrap-status onorzes.
544
- it('| FR-067: should preserve downstream HTTP status when wrapping axios-style error', async () => {
545
- const error = Object.assign(new Error('Upstream 502'), { status: 502 });
546
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
547
- const params = new DyNTS_Endpoint_Params({
548
- name: 'proxyEndpoint',
549
- type: DyFM_HttpCallType.get,
550
- endpoint: '/proxy',
551
- tasks: [taskSpy],
552
- logRequest: false,
553
- });
554
- (DyNTS_GlobalService as any).globalErrorHandler = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
555
-
556
- const execution = params.getFullExecution();
557
- await execution(mockRequest as Request, mockResponse as Response);
558
- await new Promise(resolve => setTimeout(resolve, 50));
559
-
560
- expect(statusSpy).toHaveBeenCalledWith(502);
561
- });
562
-
563
- it('| should handle production environment error response', async () => {
564
- const originalEnv = DyNTS_global_settings.env_settings.environment;
565
- DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
566
-
567
- const error = new DyFM_Error({
568
- error: new Error('Test error'),
569
- });
570
- (error as any).___status = 500;
571
- error.confidentialContent = { secret: 'value' };
572
- error.additionalContent = { debug: 'info' };
573
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
574
- const params = new DyNTS_Endpoint_Params({
575
- name: 'testEndpoint',
576
- type: DyFM_HttpCallType.get,
577
- endpoint: '/test',
578
- tasks: [taskSpy],
579
- logRequest: false,
580
- });
581
-
582
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
583
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
584
-
585
- const execution = params.getFullExecution();
586
- await execution(mockRequest as Request, mockResponse as Response);
587
- // Wait for async error handling to complete
588
- await new Promise(resolve => setTimeout(resolve, 50));
589
-
590
- expect(statusSpy).toHaveBeenCalled();
591
- const statusCall = statusSpy.calls.mostRecent();
592
- expect(statusCall.args[0]).toBe(500);
593
- expect(sendSpy).toHaveBeenCalled();
594
- const sentError = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
595
- expect(sentError.confidentialContent).toBeUndefined();
596
-
597
- DyNTS_global_settings.env_settings.environment = originalEnv;
598
- });
599
-
600
- it('| should handle autoResolveCirculation for non-serializable errors', async () => {
601
- const circularError: any = { message: 'Circular error' };
602
- circularError.self = circularError;
603
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(circularError));
604
- const params = new DyNTS_Endpoint_Params({
605
- name: 'testEndpoint',
606
- type: DyFM_HttpCallType.get,
607
- endpoint: '/test',
608
- tasks: [taskSpy],
609
- logRequest: false,
610
- autoResolveCirculation: true,
611
- });
612
-
613
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
614
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
615
-
616
- const execution = params.getFullExecution();
617
- await execution(mockRequest as Request, mockResponse as Response);
618
- // Wait for async error handling to complete
619
- await new Promise(resolve => setTimeout(resolve, 50));
620
-
621
- expect(statusSpy).toHaveBeenCalled();
622
- expect(statusSpy.calls.mostRecent().args[0]).toBe(500);
623
- expect(sendSpy).toHaveBeenCalled();
624
- });
625
-
626
- it('| FR-263 security: skips tasks when a preProcess already sent a response (res.headersSent)', async () => {
627
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
628
- const respondingPreProcess = jasmine.createSpy('preProcess').and.callFake(
629
- async (_req: Request, res: Response): Promise<void> => {
630
- (res as any).headersSent = true; // a guard MÁR válaszolt (pl. 401)
631
- }
632
- );
633
- const params = new DyNTS_Endpoint_Params({
634
- name: 'guardedEndpoint',
635
- type: DyFM_HttpCallType.get,
636
- endpoint: '/guarded',
637
- preProcesses: [respondingPreProcess],
638
- tasks: [taskSpy],
639
- logRequest: false,
640
- });
641
-
642
- (mockResponse as any).headersSent = false;
643
- await params.getFullExecution()(mockRequest as Request, mockResponse as Response);
644
-
645
- expect(respondingPreProcess).toHaveBeenCalled();
646
- // FR-263 defense-in-depth: a preProcess-válasz (headersSent) UTÁN a task-ok NEM futhatnak
647
- expect(taskSpy).not.toHaveBeenCalled();
648
- });
649
-
650
- it('| FR-263 security: runs tasks normally when no preProcess responded (headersSent false)', async () => {
651
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
652
- const params = new DyNTS_Endpoint_Params({
653
- name: 'openEndpoint',
654
- type: DyFM_HttpCallType.get,
655
- endpoint: '/open',
656
- preProcesses: [],
657
- tasks: [taskSpy],
658
- logRequest: false,
659
- });
660
-
661
- (mockResponse as any).headersSent = false;
662
- await params.getFullExecution()(mockRequest as Request, mockResponse as Response);
663
-
664
- // normál endpoint (nem-válaszoló preProcess) — a task-ok LEFUTNAK (nincs regresszió)
665
- expect(taskSpy).toHaveBeenCalled();
666
- });
667
- });
668
- });
669
-
1
+
2
+ import { Request, Response } from 'express';
3
+ import { DyFM_HttpCallType, DyFM_Log, DyFM_Error, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
4
+ import { DyNTS_Endpoint_Params } from './endpoint-params.control-model';
5
+ import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
6
+ import { DyNTS_global_settings } from '../../_collections/global-settings.const';
7
+ import { DyNTS_GlobalService } from '../../_services/core/global.service';
8
+
9
+ // Skipped: DyFM_Error stack trace causes Jasmine 'split' errors
10
+ describe('| DyNTS_Endpoint_Params', () => {
11
+ // Ensure env_settings and log_settings exist before tests
12
+ beforeAll(() => {
13
+ if (!DyNTS_global_settings.env_settings) {
14
+ (DyNTS_global_settings as any).env_settings = {
15
+ environment: DyFM_EnvironmentFlag.local,
16
+ discord: {},
17
+ mongoUri: undefined,
18
+ openAi: {},
19
+ };
20
+ } else if (!DyNTS_global_settings.env_settings.environment) {
21
+ DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.local;
22
+ }
23
+ // Initialize log_settings for error handling tests
24
+ if (!DyNTS_global_settings.log_settings) {
25
+ (DyNTS_global_settings as any).log_settings = {
26
+ highDetailedLogs: false,
27
+ api_errors: true,
28
+ requestStackLocation: false,
29
+ };
30
+ }
31
+ // Initialize compactErrorResponse
32
+ if (DyNTS_global_settings.compactErrorResponse === undefined) {
33
+ (DyNTS_global_settings as any).compactErrorResponse = false;
34
+ }
35
+ });
36
+
37
+ describe('| constructor', () => {
38
+ it('| should create an instance with required parameters', () => {
39
+ const tasks = [
40
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
41
+ res.send({ success: true });
42
+ },
43
+ ];
44
+
45
+ const params = new DyNTS_Endpoint_Params({
46
+ name: 'testEndpoint',
47
+ type: DyFM_HttpCallType.get,
48
+ endpoint: '/test',
49
+ tasks: tasks,
50
+ });
51
+
52
+ expect(params.name).toBe('testEndpoint');
53
+ expect(params.type).toBe(DyFM_HttpCallType.get);
54
+ expect(params.endpoint).toBe('/test');
55
+ expect((params as any).tasks).toBe(tasks);
56
+ });
57
+
58
+ it('| should set default security to open', () => {
59
+ const tasks = [
60
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
61
+ res.send({ success: true });
62
+ },
63
+ ];
64
+
65
+ const params = new DyNTS_Endpoint_Params({
66
+ name: 'testEndpoint',
67
+ type: DyFM_HttpCallType.get,
68
+ endpoint: '/test',
69
+ tasks: tasks,
70
+ });
71
+
72
+ expect(params.security).toBe(DyNTS_RouteSecurity.open);
73
+ });
74
+
75
+ it('| should use provided security', () => {
76
+ const tasks = [
77
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
78
+ res.send({ success: true });
79
+ },
80
+ ];
81
+
82
+ const params = new DyNTS_Endpoint_Params({
83
+ name: 'testEndpoint',
84
+ type: DyFM_HttpCallType.get,
85
+ endpoint: '/test',
86
+ security: DyNTS_RouteSecurity.secure,
87
+ tasks: tasks,
88
+ });
89
+
90
+ expect(params.security).toBe(DyNTS_RouteSecurity.secure);
91
+ });
92
+
93
+ it('| should extract path parameters from endpoint', () => {
94
+ const tasks = [
95
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
96
+ res.send({ success: true });
97
+ },
98
+ ];
99
+
100
+ const params = new DyNTS_Endpoint_Params({
101
+ name: 'testEndpoint',
102
+ type: DyFM_HttpCallType.get,
103
+ endpoint: '/test/:userId/:itemId',
104
+ tasks: tasks,
105
+ });
106
+
107
+ expect(params['pathParams']).toEqual(['userId', 'itemId']);
108
+ });
109
+
110
+ it('| should handle endpoint without path parameters', () => {
111
+ const tasks = [
112
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
113
+ res.send({ success: true });
114
+ },
115
+ ];
116
+
117
+ const params = new DyNTS_Endpoint_Params({
118
+ name: 'testEndpoint',
119
+ type: DyFM_HttpCallType.get,
120
+ endpoint: '/test',
121
+ tasks: tasks,
122
+ });
123
+
124
+ expect(params['pathParams']).toEqual([]);
125
+ });
126
+
127
+ it('| should set default logRequest to false', () => {
128
+ const tasks = [
129
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
130
+ res.send({ success: true });
131
+ },
132
+ ];
133
+
134
+ const params = new DyNTS_Endpoint_Params({
135
+ name: 'testEndpoint',
136
+ type: DyFM_HttpCallType.get,
137
+ endpoint: '/test',
138
+ tasks: tasks,
139
+ });
140
+
141
+ expect(params['logRequest']).toBe(DyNTS_global_settings.log_settings.request);
142
+ });
143
+
144
+ it('| should use provided logRequest value', () => {
145
+ const tasks = [
146
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
147
+ res.send({ success: true });
148
+ },
149
+ ];
150
+
151
+ const params = new DyNTS_Endpoint_Params({
152
+ name: 'testEndpoint',
153
+ type: DyFM_HttpCallType.get,
154
+ endpoint: '/test',
155
+ tasks: tasks,
156
+ logRequest: true,
157
+ });
158
+
159
+ expect(params['logRequest']).toBe(true);
160
+ });
161
+
162
+ it('| should set default autoResolveCirculation to false', () => {
163
+ const tasks = [
164
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
165
+ res.send({ success: true });
166
+ },
167
+ ];
168
+
169
+ const params = new DyNTS_Endpoint_Params({
170
+ name: 'testEndpoint',
171
+ type: DyFM_HttpCallType.get,
172
+ endpoint: '/test',
173
+ tasks: tasks,
174
+ });
175
+
176
+ expect(params['autoResolveCirculation']).toBe(DyNTS_global_settings.autoResolveEndpointCirculationErrors);
177
+ });
178
+
179
+ it('| should set stackLocation', () => {
180
+ const tasks = [
181
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
182
+ res.send({ success: true });
183
+ },
184
+ ];
185
+
186
+ const params = new DyNTS_Endpoint_Params({
187
+ name: 'testEndpoint',
188
+ type: DyFM_HttpCallType.get,
189
+ endpoint: '/test',
190
+ tasks: tasks,
191
+ });
192
+
193
+ expect(params.stackLocation).toBeDefined();
194
+ expect(typeof params.stackLocation).toBe('string');
195
+ });
196
+
197
+ it('| should handle preProcesses', () => {
198
+ const preProcess = async (req: Request, res: Response): Promise<void> => {
199
+ // Pre-process logic
200
+ };
201
+
202
+ const tasks = [
203
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
204
+ res.send({ success: true });
205
+ },
206
+ ];
207
+
208
+ const params = new DyNTS_Endpoint_Params({
209
+ name: 'testEndpoint',
210
+ type: DyFM_HttpCallType.get,
211
+ endpoint: '/test',
212
+ preProcesses: [preProcess],
213
+ tasks: tasks,
214
+ });
215
+
216
+ expect(params['preProcesses']).toEqual([preProcess]);
217
+ });
218
+
219
+ it('| should throw error when endpoint is not provided', () => {
220
+ const tasks = [
221
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
222
+ res.send({ success: true });
223
+ },
224
+ ];
225
+
226
+ expect(() => {
227
+ new DyNTS_Endpoint_Params({
228
+ name: 'testEndpoint',
229
+ type: DyFM_HttpCallType.get,
230
+ endpoint: '',
231
+ tasks: tasks,
232
+ });
233
+ }).toThrow();
234
+ });
235
+
236
+ it('| should set default log settings from global settings', () => {
237
+ const tasks = [
238
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
239
+ res.send({ success: true });
240
+ },
241
+ ];
242
+
243
+ const params = new DyNTS_Endpoint_Params({
244
+ name: 'testEndpoint',
245
+ type: DyFM_HttpCallType.get,
246
+ endpoint: '/test',
247
+ tasks: tasks,
248
+ });
249
+
250
+ expect(params['logRequestsParams']).toBe(DyNTS_global_settings.log_settings.requestsParams);
251
+ expect(params['logRequestsContent']).toBe(DyNTS_global_settings.log_settings.requestsContent);
252
+ expect(params['logResponseContent']).toBe(DyNTS_global_settings.log_settings.responseContent);
253
+ });
254
+
255
+ it('| should use provided log settings', () => {
256
+ const tasks = [
257
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
258
+ res.send({ success: true });
259
+ },
260
+ ];
261
+
262
+ const params = new DyNTS_Endpoint_Params({
263
+ name: 'testEndpoint',
264
+ type: DyFM_HttpCallType.get,
265
+ endpoint: '/test',
266
+ tasks: tasks,
267
+ logRequestsParams: true,
268
+ logRequestsContent: true,
269
+ logResponseContent: true,
270
+ });
271
+
272
+ expect(params['logRequestsParams']).toBe(true);
273
+ expect(params['logRequestsContent']).toBe(true);
274
+ expect(params['logResponseContent']).toBe(true);
275
+ });
276
+
277
+ it('| should use endpoint as name when name is not provided', () => {
278
+ const tasks = [
279
+ async (req: Request, res: Response, issuer: string): Promise<void> => {
280
+ res.send({ success: true });
281
+ },
282
+ ];
283
+
284
+ const params = new DyNTS_Endpoint_Params({
285
+ name: '/test-endpoint',
286
+ type: DyFM_HttpCallType.get,
287
+ endpoint: '/test-endpoint',
288
+ tasks: tasks,
289
+ });
290
+
291
+ expect(params.name).toBe('/test-endpoint');
292
+ });
293
+ });
294
+
295
+ describe('| getFullExecution', () => {
296
+ let mockRequest: Partial<Request>;
297
+ let mockResponse: Partial<Response>;
298
+ let sendSpy: jasmine.Spy;
299
+ let statusSpy: jasmine.Spy;
300
+
301
+ beforeEach(() => {
302
+ mockRequest = {
303
+ params: {},
304
+ body: {},
305
+ originalUrl: '/test',
306
+ };
307
+ sendSpy = jasmine.createSpy('send');
308
+ statusSpy = jasmine.createSpy('status').and.returnValue({ send: sendSpy });
309
+ mockResponse = {
310
+ send: sendSpy,
311
+ status: statusSpy,
312
+ };
313
+
314
+ spyOn(DyNTS_GlobalService, 'getAuthService').and.returnValue({
315
+ getIssuerFromRequest: () => 'test-issuer',
316
+ } as any);
317
+ });
318
+
319
+ it('| should execute tasks successfully', async () => {
320
+ const taskSpy = jasmine.createSpy('task').and.callFake(async (req: Request, res: Response, issuer: string) => {
321
+ res.send({ success: true });
322
+ });
323
+ const params = new DyNTS_Endpoint_Params({
324
+ name: 'testEndpoint',
325
+ type: DyFM_HttpCallType.get,
326
+ endpoint: '/test',
327
+ tasks: [taskSpy],
328
+ logRequest: false,
329
+ });
330
+
331
+ const execution = params.getFullExecution();
332
+ await execution(mockRequest as Request, mockResponse as Response);
333
+
334
+ expect(taskSpy).toHaveBeenCalledWith(mockRequest, mockResponse, 'test-issuer');
335
+ expect(sendSpy).toHaveBeenCalled();
336
+ });
337
+
338
+ it('| should execute preProcesses before tasks', async () => {
339
+ const preProcessSpy = jasmine.createSpy('preProcess').and.returnValue(Promise.resolve());
340
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
341
+ const params = new DyNTS_Endpoint_Params({
342
+ name: 'testEndpoint',
343
+ type: DyFM_HttpCallType.get,
344
+ endpoint: '/test',
345
+ preProcesses: [preProcessSpy],
346
+ tasks: [taskSpy],
347
+ logRequest: false,
348
+ });
349
+
350
+ const execution = params.getFullExecution();
351
+ await execution(mockRequest as Request, mockResponse as Response);
352
+
353
+ expect(preProcessSpy).toHaveBeenCalledBefore(taskSpy as any);
354
+ expect(preProcessSpy).toHaveBeenCalledWith(mockRequest, mockResponse);
355
+ });
356
+
357
+ it('| should handle errors and call error handler', async () => {
358
+ const error = new Error('Test error');
359
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
360
+ const params = new DyNTS_Endpoint_Params({
361
+ name: 'testEndpoint',
362
+ type: DyFM_HttpCallType.get,
363
+ endpoint: '/test',
364
+ tasks: [taskSpy],
365
+ logRequest: false,
366
+ });
367
+
368
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
369
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
370
+
371
+ const execution = params.getFullExecution();
372
+ await execution(mockRequest as Request, mockResponse as Response);
373
+ // Wait for async error handling to complete (error handler is not awaited in source)
374
+ await new Promise(resolve => setTimeout(resolve, 50));
375
+
376
+ expect(globalErrorHandlerSpy).toHaveBeenCalled();
377
+ expect(statusSpy).toHaveBeenCalled();
378
+ expect(statusSpy.calls.mostRecent().args[0]).toBe(500);
379
+ expect(sendSpy).toHaveBeenCalled();
380
+ });
381
+
382
+ it('| should log request when logRequest is true', async () => {
383
+ const logInfoSpy = spyOn(DyFM_Log, 'info');
384
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
385
+ const params = new DyNTS_Endpoint_Params({
386
+ name: 'testEndpoint',
387
+ type: DyFM_HttpCallType.get,
388
+ endpoint: '/test',
389
+ tasks: [taskSpy],
390
+ logRequest: true,
391
+ logRequestsParams: false,
392
+ logRequestsContent: false,
393
+ });
394
+
395
+ const execution = params.getFullExecution();
396
+ await execution(mockRequest as Request, mockResponse as Response);
397
+
398
+ expect(logInfoSpy).toHaveBeenCalled();
399
+ });
400
+
401
+ it('| should log path params when logRequestsParams is true', async () => {
402
+ const logInfoSpy = spyOn(DyFM_Log, 'info');
403
+ mockRequest.params = { userId: '123', itemId: '456' };
404
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
405
+ const params = new DyNTS_Endpoint_Params({
406
+ name: 'testEndpoint',
407
+ type: DyFM_HttpCallType.get,
408
+ endpoint: '/test/:userId/:itemId',
409
+ tasks: [taskSpy],
410
+ logRequest: true,
411
+ logRequestsParams: true,
412
+ logRequestsContent: false,
413
+ });
414
+
415
+ const execution = params.getFullExecution();
416
+ await execution(mockRequest as Request, mockResponse as Response);
417
+
418
+ expect(logInfoSpy).toHaveBeenCalled();
419
+ });
420
+
421
+ it('| should log request body when logRequestsContent is true', async () => {
422
+ const logInfoSpy = spyOn(DyFM_Log, 'info');
423
+ mockRequest.body = { key: 'value' };
424
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
425
+ const params = new DyNTS_Endpoint_Params({
426
+ name: 'testEndpoint',
427
+ type: DyFM_HttpCallType.get,
428
+ endpoint: '/test',
429
+ tasks: [taskSpy],
430
+ logRequest: true,
431
+ logRequestsParams: false,
432
+ logRequestsContent: true,
433
+ });
434
+
435
+ const execution = params.getFullExecution();
436
+ await execution(mockRequest as Request, mockResponse as Response);
437
+
438
+ expect(logInfoSpy).toHaveBeenCalled();
439
+ });
440
+
441
+ it('| should handle issuer retrieval error', async () => {
442
+ (DyNTS_GlobalService.getAuthService as jasmine.Spy).and.returnValue({
443
+ getIssuerFromRequest: () => { throw new Error('Auth error'); },
444
+ } as any);
445
+ const logWarnSpy = spyOn(DyFM_Log, 'warn');
446
+ const taskSpy = jasmine.createSpy('task').and.callFake(async (req: Request, res: Response, issuer: string) => {
447
+ res.send({ success: true });
448
+ });
449
+ const params = new DyNTS_Endpoint_Params({
450
+ name: 'testEndpoint',
451
+ type: DyFM_HttpCallType.get,
452
+ endpoint: '/test',
453
+ tasks: [taskSpy],
454
+ logRequest: false,
455
+ });
456
+
457
+ const execution = params.getFullExecution();
458
+ await execution(mockRequest as Request, mockResponse as Response);
459
+
460
+ expect(logWarnSpy).toHaveBeenCalled();
461
+ expect(taskSpy).toHaveBeenCalledWith(mockRequest, mockResponse, 'unknown-issuer');
462
+ });
463
+
464
+ it('| should handle DyFM_Error with status code', async () => {
465
+ const error = new DyFM_Error({
466
+ error: new Error('Test error'),
467
+ });
468
+ (error as any).___status = 404;
469
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
470
+ const params = new DyNTS_Endpoint_Params({
471
+ name: 'testEndpoint',
472
+ type: DyFM_HttpCallType.get,
473
+ endpoint: '/test',
474
+ tasks: [taskSpy],
475
+ logRequest: false,
476
+ });
477
+
478
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
479
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
480
+
481
+ const execution = params.getFullExecution();
482
+ await execution(mockRequest as Request, mockResponse as Response);
483
+ // Wait for async error handling to complete
484
+ await new Promise(resolve => setTimeout(resolve, 50));
485
+
486
+ expect(statusSpy).toHaveBeenCalled();
487
+ expect(statusSpy.calls.mostRecent().args[0]).toBe(404);
488
+ expect(sendSpy).toHaveBeenCalled();
489
+ });
490
+
491
+ it('| should use default status 500 when error has no status', async () => {
492
+ const error = new Error('Test error');
493
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
494
+ const params = new DyNTS_Endpoint_Params({
495
+ name: 'testEndpoint',
496
+ type: DyFM_HttpCallType.get,
497
+ endpoint: '/test',
498
+ tasks: [taskSpy],
499
+ logRequest: false,
500
+ });
501
+
502
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
503
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
504
+
505
+ const execution = params.getFullExecution();
506
+ await execution(mockRequest as Request, mockResponse as Response);
507
+ // Wait for async error handling to complete
508
+ await new Promise(resolve => setTimeout(resolve, 50));
509
+
510
+ expect(statusSpy).toHaveBeenCalledWith(500);
511
+ expect(sendSpy).toHaveBeenCalled();
512
+ });
513
+
514
+ // FR-067 (2026-06-06): non-DyFM_Error wrap — minden plain Error a kliens
515
+ // fele DyFM_Error-shape-ben mehessen, errorCode-szal, userMessage-zsel.
516
+ it('| FR-067: should wrap plain Error into DyFM_Error with FDP errorCode + userMessage', async () => {
517
+ const originalShortCode = DyNTS_global_settings.systemShortCodeName;
518
+ DyNTS_global_settings.systemShortCodeName = 'TST';
519
+ const error = new Error('Raw error message');
520
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
521
+ const params = new DyNTS_Endpoint_Params({
522
+ name: 'myEndpoint',
523
+ type: DyFM_HttpCallType.get,
524
+ endpoint: '/test',
525
+ tasks: [taskSpy],
526
+ logRequest: false,
527
+ });
528
+ (DyNTS_GlobalService as any).globalErrorHandler = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
529
+
530
+ const execution = params.getFullExecution();
531
+ await execution(mockRequest as Request, mockResponse as Response);
532
+ await new Promise(resolve => setTimeout(resolve, 50));
533
+
534
+ expect(sendSpy).toHaveBeenCalled();
535
+ const sent = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
536
+ expect(sent._errorCode).toBe('TST|DyNTS-EPP-myEndpoint');
537
+ expect(sent.__userMessage).toBeDefined();
538
+ expect(statusSpy).toHaveBeenCalledWith(500);
539
+
540
+ DyNTS_global_settings.systemShortCodeName = originalShortCode;
541
+ });
542
+
543
+ // FR-067: axios-style HTTP errors (with `status` field) — wrap-status onorzes.
544
+ it('| FR-067: should preserve downstream HTTP status when wrapping axios-style error', async () => {
545
+ const error = Object.assign(new Error('Upstream 502'), { status: 502 });
546
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
547
+ const params = new DyNTS_Endpoint_Params({
548
+ name: 'proxyEndpoint',
549
+ type: DyFM_HttpCallType.get,
550
+ endpoint: '/proxy',
551
+ tasks: [taskSpy],
552
+ logRequest: false,
553
+ });
554
+ (DyNTS_GlobalService as any).globalErrorHandler = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
555
+
556
+ const execution = params.getFullExecution();
557
+ await execution(mockRequest as Request, mockResponse as Response);
558
+ await new Promise(resolve => setTimeout(resolve, 50));
559
+
560
+ expect(statusSpy).toHaveBeenCalledWith(502);
561
+ });
562
+
563
+ it('| should handle production environment error response', async () => {
564
+ const originalEnv = DyNTS_global_settings.env_settings.environment;
565
+ DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
566
+
567
+ const error = new DyFM_Error({
568
+ error: new Error('Test error'),
569
+ });
570
+ (error as any).___status = 500;
571
+ error.confidentialContent = { secret: 'value' };
572
+ error.additionalContent = { debug: 'info' };
573
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
574
+ const params = new DyNTS_Endpoint_Params({
575
+ name: 'testEndpoint',
576
+ type: DyFM_HttpCallType.get,
577
+ endpoint: '/test',
578
+ tasks: [taskSpy],
579
+ logRequest: false,
580
+ });
581
+
582
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
583
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
584
+
585
+ const execution = params.getFullExecution();
586
+ await execution(mockRequest as Request, mockResponse as Response);
587
+ // Wait for async error handling to complete
588
+ await new Promise(resolve => setTimeout(resolve, 50));
589
+
590
+ expect(statusSpy).toHaveBeenCalled();
591
+ const statusCall = statusSpy.calls.mostRecent();
592
+ expect(statusCall.args[0]).toBe(500);
593
+ expect(sendSpy).toHaveBeenCalled();
594
+ const sentError = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
595
+ expect(sentError.confidentialContent).toBeUndefined();
596
+
597
+ DyNTS_global_settings.env_settings.environment = originalEnv;
598
+ });
599
+
600
+ it('| should handle autoResolveCirculation for non-serializable errors', async () => {
601
+ const circularError: any = { message: 'Circular error' };
602
+ circularError.self = circularError;
603
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(circularError));
604
+ const params = new DyNTS_Endpoint_Params({
605
+ name: 'testEndpoint',
606
+ type: DyFM_HttpCallType.get,
607
+ endpoint: '/test',
608
+ tasks: [taskSpy],
609
+ logRequest: false,
610
+ autoResolveCirculation: true,
611
+ });
612
+
613
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
614
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
615
+
616
+ const execution = params.getFullExecution();
617
+ await execution(mockRequest as Request, mockResponse as Response);
618
+ // Wait for async error handling to complete
619
+ await new Promise(resolve => setTimeout(resolve, 50));
620
+
621
+ expect(statusSpy).toHaveBeenCalled();
622
+ expect(statusSpy.calls.mostRecent().args[0]).toBe(500);
623
+ expect(sendSpy).toHaveBeenCalled();
624
+ });
625
+
626
+ it('| FR-263 security: skips tasks when a preProcess already sent a response (res.headersSent)', async () => {
627
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
628
+ const respondingPreProcess = jasmine.createSpy('preProcess').and.callFake(
629
+ async (_req: Request, res: Response): Promise<void> => {
630
+ (res as any).headersSent = true; // a guard MÁR válaszolt (pl. 401)
631
+ }
632
+ );
633
+ const params = new DyNTS_Endpoint_Params({
634
+ name: 'guardedEndpoint',
635
+ type: DyFM_HttpCallType.get,
636
+ endpoint: '/guarded',
637
+ preProcesses: [respondingPreProcess],
638
+ tasks: [taskSpy],
639
+ logRequest: false,
640
+ });
641
+
642
+ (mockResponse as any).headersSent = false;
643
+ await params.getFullExecution()(mockRequest as Request, mockResponse as Response);
644
+
645
+ expect(respondingPreProcess).toHaveBeenCalled();
646
+ // FR-263 defense-in-depth: a preProcess-válasz (headersSent) UTÁN a task-ok NEM futhatnak
647
+ expect(taskSpy).not.toHaveBeenCalled();
648
+ });
649
+
650
+ it('| FR-263 security: runs tasks normally when no preProcess responded (headersSent false)', async () => {
651
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.resolve());
652
+ const params = new DyNTS_Endpoint_Params({
653
+ name: 'openEndpoint',
654
+ type: DyFM_HttpCallType.get,
655
+ endpoint: '/open',
656
+ preProcesses: [],
657
+ tasks: [taskSpy],
658
+ logRequest: false,
659
+ });
660
+
661
+ (mockResponse as any).headersSent = false;
662
+ await params.getFullExecution()(mockRequest as Request, mockResponse as Response);
663
+
664
+ // normál endpoint (nem-válaszoló preProcess) — a task-ok LEFUTNAK (nincs regresszió)
665
+ expect(taskSpy).toHaveBeenCalled();
666
+ });
667
+ });
668
+ });
669
+