@futdevpro/nts-dynamo 1.15.144 → 1.15.150

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 (421) 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 +2896 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +74 -0
  18. package/.vscode/settings.json +10 -10
  19. package/HOWTO.md +15 -15
  20. package/LICENSE +21 -21
  21. package/README.md +16 -0
  22. package/__documentations/2026-08-18-artifact-compiler.md +3 -1
  23. package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +59 -0
  24. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  25. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  26. package/_specifications/BACKLOG.md +92 -92
  27. package/_specifications/TODO.md +15 -15
  28. package/_specifications/agent.md +138 -138
  29. package/build/_collections/npm-token-check.util.d.ts +139 -0
  30. package/build/_collections/npm-token-check.util.d.ts.map +1 -0
  31. package/build/_collections/npm-token-check.util.js +302 -0
  32. package/build/_collections/npm-token-check.util.js.map +1 -0
  33. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts +6 -0
  34. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts.map +1 -0
  35. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js +10 -0
  36. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js.map +1 -0
  37. package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts +15 -6
  38. package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts.map +1 -1
  39. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts +9 -0
  40. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts.map +1 -0
  41. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js +3 -0
  42. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js.map +1 -0
  43. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts +7 -0
  44. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts.map +1 -0
  45. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js +3 -0
  46. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js.map +1 -0
  47. package/build/_modules/rate-limit/_models/rate-limit-store.interface.d.ts +9 -0
  48. package/build/_modules/rate-limit/_models/rate-limit-store.interface.d.ts.map +1 -0
  49. package/build/_modules/rate-limit/_models/rate-limit-store.interface.js +3 -0
  50. package/build/_modules/rate-limit/_models/rate-limit-store.interface.js.map +1 -0
  51. package/build/_modules/rate-limit/index.d.ts +5 -0
  52. package/build/_modules/rate-limit/index.d.ts.map +1 -1
  53. package/build/_modules/rate-limit/index.js +5 -1
  54. package/build/_modules/rate-limit/index.js.map +1 -1
  55. package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts +19 -0
  56. package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts.map +1 -0
  57. package/build/_modules/rate-limit/rate-limit-in-memory.store.js +71 -0
  58. package/build/_modules/rate-limit/rate-limit-in-memory.store.js.map +1 -0
  59. package/build/_modules/rate-limit/rate-limit.middleware.d.ts +39 -103
  60. package/build/_modules/rate-limit/rate-limit.middleware.d.ts.map +1 -1
  61. package/build/_modules/rate-limit/rate-limit.middleware.js +325 -236
  62. package/build/_modules/rate-limit/rate-limit.middleware.js.map +1 -1
  63. package/build/_services/core/collection-growth-monitor.service.d.ts +1 -1
  64. package/build/_services/core/collection-growth-monitor.service.d.ts.map +1 -1
  65. package/build/_services/core/collection-growth-monitor.service.js +24 -5
  66. package/build/_services/core/collection-growth-monitor.service.js.map +1 -1
  67. package/build/index.d.ts +1 -0
  68. package/build/index.d.ts.map +1 -1
  69. package/build/index.js +1 -0
  70. package/build/index.js.map +1 -1
  71. package/eslint.config.js +3 -3
  72. package/nodemon.json +24 -24
  73. package/package.json +1 -1
  74. package/pnpm-workspace.yaml +2 -2
  75. package/scripts/run-coverage-tests.js +28 -28
  76. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  77. package/spec/support/helpers/ts-node-helper.js +93 -93
  78. package/spec/support/jasmine.coverage.json +24 -24
  79. package/spec/support/jasmine.json +24 -24
  80. package/src/_collections/archive.util.spec.ts +57 -57
  81. package/src/_collections/archive.util.ts +18 -18
  82. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  83. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  84. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  85. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  86. package/src/_collections/default-not-found-page.const.ts +22 -22
  87. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  88. package/src/_collections/default-socket-path.const.ts +2 -2
  89. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  90. package/src/_collections/get-environment-settings.util.ts +48 -48
  91. package/src/_collections/global-settings.const.ts +126 -126
  92. package/src/_collections/npm-token-check.util.spec.ts +218 -0
  93. package/src/_collections/npm-token-check.util.ts +327 -0
  94. package/src/_collections/sample.env +21 -21
  95. package/src/_collections/signed-url.util.spec.ts +198 -198
  96. package/src/_collections/signed-url.util.ts +170 -170
  97. package/src/_collections/star.controller.spec.ts +224 -224
  98. package/src/_collections/star.controller.ts +129 -129
  99. package/src/_enums/data-model-type.enum.ts +14 -14
  100. package/src/_enums/data-service-function.enum.ts +24 -24
  101. package/src/_enums/predefined-data-types.enum.ts +16 -16
  102. package/src/_enums/route-security.enum.ts +12 -12
  103. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  104. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  105. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  106. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  107. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  108. package/src/_models/control-models/app-params.control-model.ts +136 -136
  109. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  110. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  111. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  112. package/src/_models/control-models/endpoint-params.control-model.ts +664 -664
  113. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  114. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  115. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  116. package/src/_models/control-models/system-control.control-model.ts +12 -12
  117. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  118. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  119. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  120. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  121. package/src/_models/interfaces/global-settings.interface.ts +294 -294
  122. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  123. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  124. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  125. package/src/_models/types/db-update.type.ts +100 -100
  126. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  127. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  128. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +115 -115
  129. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +233 -233
  130. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  131. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  132. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  133. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  134. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  135. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  136. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  137. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  138. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  139. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  140. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  141. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  142. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  143. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  144. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  145. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  146. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  147. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  148. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  149. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  150. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  151. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  152. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  153. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  154. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  155. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  156. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  157. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  158. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  159. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  160. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  161. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  162. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  163. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  164. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  165. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1085 -1085
  166. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  167. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  168. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +114 -114
  169. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  170. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  171. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  172. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  173. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  174. package/src/_modules/ai/_services/ai-llm.service-base.ts +599 -599
  175. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  176. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  177. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  178. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  179. package/src/_modules/ai/index.ts +33 -33
  180. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  181. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  182. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  183. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  184. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  185. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  186. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  187. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  188. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  189. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  190. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  191. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  192. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  193. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  194. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  195. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  196. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  197. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  198. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  199. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  200. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  201. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  202. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  203. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  204. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  205. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  206. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  207. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  208. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  209. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  210. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  211. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  212. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  213. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  214. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  215. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  216. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  217. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  218. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  219. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  220. package/src/_modules/custom-data/index.ts +9 -9
  221. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  222. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  223. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  224. package/src/_modules/data-readers/index.ts +11 -11
  225. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  226. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  227. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  228. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  229. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  230. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  231. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  232. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  233. package/src/_modules/defaults/index.ts +17 -17
  234. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  235. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  236. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  237. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  238. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  239. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  240. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  241. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  242. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  243. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  244. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  245. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  246. package/src/_modules/discord-assistant/index.ts +38 -38
  247. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  248. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  249. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  250. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  251. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  252. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  253. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  254. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  255. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  256. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  257. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  258. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  259. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  260. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  261. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  262. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  263. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  264. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  265. package/src/_modules/discord-bot/index.ts +36 -36
  266. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  267. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  268. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  269. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  270. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  271. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  272. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  273. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +214 -214
  274. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +186 -186
  275. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  276. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +130 -130
  277. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +509 -509
  278. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +323 -323
  279. package/src/_modules/local-vector-search/index.ts +16 -16
  280. package/src/_modules/logs/index.ts +11 -11
  281. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  282. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  283. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  284. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  285. package/src/_modules/mcp/index.ts +13 -13
  286. package/src/_modules/messaging/README.md +354 -354
  287. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  288. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  289. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  290. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  291. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  292. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  293. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  294. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  295. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  296. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  297. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  298. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  299. package/src/_modules/messaging/index.ts +30 -30
  300. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  301. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  302. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  303. package/src/_modules/mock/app-params.mock.ts +9 -9
  304. package/src/_modules/mock/app-server.mock.ts +188 -188
  305. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  306. package/src/_modules/mock/auth-service.mock.ts +28 -28
  307. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  308. package/src/_modules/mock/controller.mock.ts +16 -16
  309. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  310. package/src/_modules/mock/data-model.mock.ts +82 -82
  311. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  312. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  313. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  314. package/src/_modules/mock/email-service.mock.ts +20 -20
  315. package/src/_modules/mock/email-template.mock.html +14 -14
  316. package/src/_modules/mock/endpoint.mock.ts +91 -91
  317. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  318. package/src/_modules/mock/socket-client.mock.ts +45 -45
  319. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  320. package/src/_modules/mock/socket-server.mock.ts +46 -46
  321. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  322. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  323. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  324. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  325. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  326. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  327. package/src/_modules/oauth2/index.ts +17 -17
  328. package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +5 -0
  329. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +19 -6
  330. package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +9 -0
  331. package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +6 -0
  332. package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +9 -0
  333. package/src/_modules/rate-limit/index.ts +5 -0
  334. package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +91 -0
  335. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +424 -200
  336. package/src/_modules/rate-limit/rate-limit.middleware.ts +436 -275
  337. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  338. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  339. package/src/_modules/scheduler/index.ts +8 -8
  340. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  341. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  342. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  343. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  344. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  345. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  346. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  347. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  348. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  349. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  350. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  351. package/src/_modules/scoped-config/index.ts +17 -17
  352. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  353. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  354. package/src/_modules/server/errors/errors.controller.ts +559 -559
  355. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  356. package/src/_modules/server/index.ts +30 -30
  357. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  358. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  359. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  360. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  361. package/src/_modules/server/server-status/server-status.control-service.spec.ts +672 -672
  362. package/src/_modules/server/server-status/server-status.control-service.ts +490 -490
  363. package/src/_modules/server/server-status/server-status.controller.spec.ts +276 -276
  364. package/src/_modules/server/server-status/server-status.controller.ts +336 -336
  365. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  366. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  367. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  368. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +158 -158
  369. package/src/_modules/socket/_models/socket-presence.control-model.ts +209 -209
  370. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +69 -69
  371. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  372. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  373. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  374. package/src/_modules/socket/app-extended.server.ts +648 -648
  375. package/src/_modules/socket/index.ts +42 -42
  376. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  377. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  378. package/src/_modules/test/index.ts +11 -11
  379. package/src/_modules/test/test.controller.spec.ts +72 -72
  380. package/src/_modules/test/test.controller.ts +115 -115
  381. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  382. package/src/_modules/usage/index.ts +15 -15
  383. package/src/_modules/usage/usage.controller.spec.ts +106 -106
  384. package/src/_modules/usage/usage.controller.ts +140 -140
  385. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  386. package/src/_modules/usage/usage.data-service.ts +185 -185
  387. package/src/_services/base/api.service-base.spec.ts +125 -125
  388. package/src/_services/base/api.service-base.ts +74 -74
  389. package/src/_services/base/archive-data.service.spec.ts +209 -209
  390. package/src/_services/base/archive-data.service.ts +223 -223
  391. package/src/_services/base/data.service.spec.ts +784 -784
  392. package/src/_services/base/data.service.ts +2792 -2792
  393. package/src/_services/base/db.service.spec.ts +160 -160
  394. package/src/_services/base/db.service.ts +1698 -1698
  395. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  396. package/src/_services/base/singleton.service-base.ts +24 -24
  397. package/src/_services/base/singleton.service.spec.ts +114 -114
  398. package/src/_services/base/singleton.service.ts +38 -38
  399. package/src/_services/core/api.service.spec.ts +140 -140
  400. package/src/_services/core/auth.service.spec.ts +159 -159
  401. package/src/_services/core/auth.service.ts +174 -174
  402. package/src/_services/core/collection-growth-monitor.service.spec.ts +53 -1
  403. package/src/_services/core/collection-growth-monitor.service.ts +29 -6
  404. package/src/_services/core/email.service.spec.ts +85 -85
  405. package/src/_services/core/email.service.ts +757 -757
  406. package/src/_services/core/global.service.spec.ts +292 -292
  407. package/src/_services/core/global.service.ts +487 -487
  408. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  409. package/src/_services/core/memory-guard.service.ts +481 -481
  410. package/src/_services/core/service-collection.service.spec.ts +46 -46
  411. package/src/_services/core/service-collection.service.ts +6 -6
  412. package/src/_services/route/controller.service.spec.ts +53 -53
  413. package/src/_services/route/controller.service.ts +148 -148
  414. package/src/_services/route/routing-module.service.spec.ts +98 -98
  415. package/src/_services/route/routing-module.service.ts +330 -330
  416. package/src/_services/server/app.server.ts +2012 -2012
  417. package/src/_services/shared.static-service.spec.ts +99 -99
  418. package/src/_services/shared.static-service.ts +78 -78
  419. package/src/index.ts +1 -0
  420. package/tsconfig.app.json +12 -12
  421. 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
+