@futdevpro/nts-dynamo 1.15.37 → 1.15.39

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 (332) 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/.github/workflows/main.yml +432 -432
  17. package/.vscode/settings.json +10 -10
  18. package/HOWTO.md +15 -15
  19. package/LICENSE +21 -21
  20. package/__documentations/2026-06-01-fr041-cors-middleware.md +96 -0
  21. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  22. package/_specifications/BACKLOG.md +92 -92
  23. package/_specifications/TODO.md +15 -15
  24. package/_specifications/agent.md +138 -138
  25. package/build/_modules/server/errors/errors.control-service.d.ts +3 -1
  26. package/build/_modules/server/errors/errors.control-service.d.ts.map +1 -1
  27. package/build/_modules/server/errors/errors.control-service.js.map +1 -1
  28. package/build/_modules/server/errors/errors.controller.d.ts.map +1 -1
  29. package/build/_modules/server/errors/errors.controller.js +45 -1
  30. package/build/_modules/server/errors/errors.controller.js.map +1 -1
  31. package/build/_modules/server/errors/errors.data-service.d.ts +27 -1
  32. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  33. package/build/_modules/server/errors/errors.data-service.js +124 -0
  34. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  35. package/eslint.config.js +3 -3
  36. package/nodemon.json +24 -24
  37. package/package.json +2 -2
  38. package/pnpm-workspace.yaml +8 -5
  39. package/scripts/run-coverage-tests.js +28 -28
  40. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  41. package/spec/support/helpers/ts-node-helper.js +93 -93
  42. package/spec/support/jasmine.coverage.json +24 -24
  43. package/spec/support/jasmine.json +24 -24
  44. package/src/_collections/archive.util.spec.ts +57 -57
  45. package/src/_collections/archive.util.ts +18 -18
  46. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  47. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  48. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  49. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  50. package/src/_collections/default-not-found-page.const.ts +22 -22
  51. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  52. package/src/_collections/default-socket-path.const.ts +2 -2
  53. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  54. package/src/_collections/get-environment-settings.util.ts +48 -48
  55. package/src/_collections/sample.env +21 -21
  56. package/src/_collections/star.controller.spec.ts +224 -224
  57. package/src/_collections/star.controller.ts +129 -129
  58. package/src/_enums/data-model-type.enum.ts +14 -14
  59. package/src/_enums/data-service-function.enum.ts +24 -24
  60. package/src/_enums/predefined-data-types.enum.ts +16 -16
  61. package/src/_enums/route-security.enum.ts +12 -12
  62. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  63. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  64. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  65. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  66. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  67. package/src/_models/control-models/app-params.control-model.ts +136 -136
  68. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  69. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  70. package/src/_models/control-models/endpoint-params.control-model.spec.ts +578 -578
  71. package/src/_models/control-models/endpoint-params.control-model.ts +526 -526
  72. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  73. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  74. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  75. package/src/_models/control-models/system-control.control-model.ts +12 -12
  76. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  77. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  78. package/src/_models/interfaces/global-log-settings.interface.ts +144 -144
  79. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  80. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  81. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  82. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  83. package/src/_models/types/db-update.type.ts +100 -100
  84. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  85. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  86. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  87. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  90. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  91. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  92. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  93. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  94. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  95. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  96. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  97. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  98. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  99. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  100. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  101. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  102. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  103. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  104. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  105. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  106. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  107. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  108. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  109. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  111. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  112. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  113. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +106 -106
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1011 -1011
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  120. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  121. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  122. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  123. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  124. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  125. package/src/_modules/ai/_services/ai-llm.service-base.ts +510 -510
  126. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  127. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  128. package/src/_modules/ai/index.ts +13 -13
  129. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  130. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  131. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  132. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  133. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  134. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  135. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  136. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  137. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  138. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  139. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  140. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  141. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  142. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  143. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  144. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  145. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  146. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  147. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  148. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  149. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  150. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  151. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  152. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  153. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  154. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  155. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  156. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  157. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  158. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  159. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  160. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  161. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  162. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  163. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  164. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  165. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  166. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  167. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  168. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  169. package/src/_modules/custom-data/index.ts +9 -9
  170. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  171. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  172. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  173. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  174. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  175. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  176. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  177. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  178. package/src/_modules/defaults/index.ts +17 -17
  179. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  180. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  181. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  182. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  183. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  184. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  185. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  186. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  187. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  188. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  189. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  190. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  191. package/src/_modules/discord-assistant/index.ts +38 -38
  192. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  193. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  194. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  195. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  196. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  197. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  198. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  199. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  200. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  201. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  202. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  203. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  204. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  205. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  206. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  207. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  208. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  209. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  210. package/src/_modules/discord-bot/index.ts +36 -36
  211. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  212. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  213. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  214. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  215. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  216. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  217. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  218. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  219. package/src/_modules/local-vector-search/index.ts +11 -11
  220. package/src/_modules/messaging/README.md +354 -354
  221. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  222. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  223. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  224. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  225. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  226. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  227. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  228. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  229. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  230. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  231. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  232. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  233. package/src/_modules/messaging/index.ts +30 -30
  234. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  235. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  236. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  237. package/src/_modules/mock/app-params.mock.ts +9 -9
  238. package/src/_modules/mock/app-server.mock.ts +188 -188
  239. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  240. package/src/_modules/mock/auth-service.mock.ts +28 -28
  241. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  242. package/src/_modules/mock/controller.mock.ts +16 -16
  243. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  244. package/src/_modules/mock/data-model.mock.ts +82 -82
  245. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  246. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  247. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  248. package/src/_modules/mock/email-service.mock.ts +20 -20
  249. package/src/_modules/mock/email-template.mock.html +14 -14
  250. package/src/_modules/mock/endpoint.mock.ts +91 -91
  251. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  252. package/src/_modules/mock/socket-client.mock.ts +45 -45
  253. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  254. package/src/_modules/mock/socket-server.mock.ts +46 -46
  255. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  256. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  257. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  258. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  259. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  260. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  261. package/src/_modules/oauth2/index.ts +17 -17
  262. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -230
  263. package/src/_modules/server/errors/errors.control-service.ts +85 -69
  264. package/src/_modules/server/errors/errors.controller.spec.ts +241 -235
  265. package/src/_modules/server/errors/errors.controller.ts +431 -372
  266. package/src/_modules/server/errors/errors.data-service.spec.ts +355 -355
  267. package/src/_modules/server/errors/errors.data-service.ts +157 -7
  268. package/src/_modules/server/index.ts +30 -30
  269. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  270. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  271. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  272. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  273. package/src/_modules/server/server-status/server-status.control-service.spec.ts +524 -516
  274. package/src/_modules/server/server-status/server-status.control-service.ts +336 -336
  275. package/src/_modules/server/server-status/server-status.controller.spec.ts +162 -156
  276. package/src/_modules/server/server-status/server-status.controller.ts +131 -131
  277. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  278. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  279. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  280. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  281. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  282. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  283. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  284. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  285. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  286. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  287. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  288. package/src/_modules/socket/app-extended.server.ts +630 -630
  289. package/src/_modules/socket/index.ts +42 -42
  290. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  291. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  292. package/src/_modules/test/index.ts +11 -11
  293. package/src/_modules/test/test.controller.spec.ts +72 -72
  294. package/src/_modules/test/test.controller.ts +115 -115
  295. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  296. package/src/_modules/usage/index.ts +15 -15
  297. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  298. package/src/_modules/usage/usage.controller.ts +126 -126
  299. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  300. package/src/_modules/usage/usage.data-service.ts +185 -185
  301. package/src/_services/base/api.service-base.spec.ts +125 -125
  302. package/src/_services/base/api.service-base.ts +74 -74
  303. package/src/_services/base/archive-data.service.spec.ts +196 -196
  304. package/src/_services/base/archive-data.service.ts +216 -216
  305. package/src/_services/base/data.service.spec.ts +674 -674
  306. package/src/_services/base/data.service.ts +2719 -2719
  307. package/src/_services/base/db.service.spec.ts +73 -73
  308. package/src/_services/base/db.service.ts +1575 -1575
  309. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  310. package/src/_services/base/singleton.service-base.ts +24 -24
  311. package/src/_services/base/singleton.service.spec.ts +114 -114
  312. package/src/_services/base/singleton.service.ts +38 -38
  313. package/src/_services/core/api.service.spec.ts +140 -140
  314. package/src/_services/core/auth.service.spec.ts +159 -159
  315. package/src/_services/core/auth.service.ts +174 -174
  316. package/src/_services/core/email.service.spec.ts +85 -85
  317. package/src/_services/core/email.service.ts +742 -742
  318. package/src/_services/core/global.service.spec.ts +275 -275
  319. package/src/_services/core/global.service.ts +461 -461
  320. package/src/_services/core/service-collection.service.spec.ts +46 -46
  321. package/src/_services/core/service-collection.service.ts +6 -6
  322. package/src/_services/route/controller.service.spec.ts +53 -53
  323. package/src/_services/route/controller.service.ts +148 -148
  324. package/src/_services/route/routing-module.service.spec.ts +98 -98
  325. package/src/_services/route/routing-module.service.ts +330 -330
  326. package/src/_services/shared.static-service.spec.ts +99 -99
  327. package/src/_services/shared.static-service.ts +78 -78
  328. package/src/index.ts +95 -95
  329. package/tsconfig.app.json +12 -12
  330. package/tsconfig.json +42 -42
  331. package/.dynamo/logs/cicd-pipeline/output.log +0 -2630
  332. package/.dynamo/logs/cicd-pipeline/status.json +0 -321
@@ -1,578 +1,578 @@
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(501);
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 501 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(501);
511
- expect(sendSpy).toHaveBeenCalled();
512
- });
513
-
514
- it('| should handle production environment error response', async () => {
515
- const originalEnv = DyNTS_global_settings.env_settings.environment;
516
- DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
517
-
518
- const error = new DyFM_Error({
519
- error: new Error('Test error'),
520
- });
521
- (error as any).___status = 500;
522
- error.confidentialContent = { secret: 'value' };
523
- error.additionalContent = { debug: 'info' };
524
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
525
- const params = new DyNTS_Endpoint_Params({
526
- name: 'testEndpoint',
527
- type: DyFM_HttpCallType.get,
528
- endpoint: '/test',
529
- tasks: [taskSpy],
530
- logRequest: false,
531
- });
532
-
533
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
534
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
535
-
536
- const execution = params.getFullExecution();
537
- await execution(mockRequest as Request, mockResponse as Response);
538
- // Wait for async error handling to complete
539
- await new Promise(resolve => setTimeout(resolve, 50));
540
-
541
- expect(statusSpy).toHaveBeenCalled();
542
- const statusCall = statusSpy.calls.mostRecent();
543
- expect(statusCall.args[0]).toBe(500);
544
- expect(sendSpy).toHaveBeenCalled();
545
- const sentError = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
546
- expect(sentError.confidentialContent).toBeUndefined();
547
-
548
- DyNTS_global_settings.env_settings.environment = originalEnv;
549
- });
550
-
551
- it('| should handle autoResolveCirculation for non-serializable errors', async () => {
552
- const circularError: any = { message: 'Circular error' };
553
- circularError.self = circularError;
554
- const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(circularError));
555
- const params = new DyNTS_Endpoint_Params({
556
- name: 'testEndpoint',
557
- type: DyFM_HttpCallType.get,
558
- endpoint: '/test',
559
- tasks: [taskSpy],
560
- logRequest: false,
561
- autoResolveCirculation: true,
562
- });
563
-
564
- const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
565
- (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
566
-
567
- const execution = params.getFullExecution();
568
- await execution(mockRequest as Request, mockResponse as Response);
569
- // Wait for async error handling to complete
570
- await new Promise(resolve => setTimeout(resolve, 50));
571
-
572
- expect(statusSpy).toHaveBeenCalled();
573
- expect(statusSpy.calls.mostRecent().args[0]).toBe(501);
574
- expect(sendSpy).toHaveBeenCalled();
575
- });
576
- });
577
- });
578
-
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(501);
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 501 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(501);
511
+ expect(sendSpy).toHaveBeenCalled();
512
+ });
513
+
514
+ it('| should handle production environment error response', async () => {
515
+ const originalEnv = DyNTS_global_settings.env_settings.environment;
516
+ DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
517
+
518
+ const error = new DyFM_Error({
519
+ error: new Error('Test error'),
520
+ });
521
+ (error as any).___status = 500;
522
+ error.confidentialContent = { secret: 'value' };
523
+ error.additionalContent = { debug: 'info' };
524
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(error));
525
+ const params = new DyNTS_Endpoint_Params({
526
+ name: 'testEndpoint',
527
+ type: DyFM_HttpCallType.get,
528
+ endpoint: '/test',
529
+ tasks: [taskSpy],
530
+ logRequest: false,
531
+ });
532
+
533
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
534
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
535
+
536
+ const execution = params.getFullExecution();
537
+ await execution(mockRequest as Request, mockResponse as Response);
538
+ // Wait for async error handling to complete
539
+ await new Promise(resolve => setTimeout(resolve, 50));
540
+
541
+ expect(statusSpy).toHaveBeenCalled();
542
+ const statusCall = statusSpy.calls.mostRecent();
543
+ expect(statusCall.args[0]).toBe(500);
544
+ expect(sendSpy).toHaveBeenCalled();
545
+ const sentError = sendSpy.calls.mostRecent().args[0] as DyFM_Error;
546
+ expect(sentError.confidentialContent).toBeUndefined();
547
+
548
+ DyNTS_global_settings.env_settings.environment = originalEnv;
549
+ });
550
+
551
+ it('| should handle autoResolveCirculation for non-serializable errors', async () => {
552
+ const circularError: any = { message: 'Circular error' };
553
+ circularError.self = circularError;
554
+ const taskSpy = jasmine.createSpy('task').and.returnValue(Promise.reject(circularError));
555
+ const params = new DyNTS_Endpoint_Params({
556
+ name: 'testEndpoint',
557
+ type: DyFM_HttpCallType.get,
558
+ endpoint: '/test',
559
+ tasks: [taskSpy],
560
+ logRequest: false,
561
+ autoResolveCirculation: true,
562
+ });
563
+
564
+ const globalErrorHandlerSpy = jasmine.createSpy('globalErrorHandler').and.returnValue(Promise.resolve());
565
+ (DyNTS_GlobalService as any).globalErrorHandler = globalErrorHandlerSpy;
566
+
567
+ const execution = params.getFullExecution();
568
+ await execution(mockRequest as Request, mockResponse as Response);
569
+ // Wait for async error handling to complete
570
+ await new Promise(resolve => setTimeout(resolve, 50));
571
+
572
+ expect(statusSpy).toHaveBeenCalled();
573
+ expect(statusSpy.calls.mostRecent().args[0]).toBe(501);
574
+ expect(sendSpy).toHaveBeenCalled();
575
+ });
576
+ });
577
+ });
578
+