@futdevpro/nts-dynamo 1.15.102 → 1.15.104

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 (371) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/pipeline.cicd.config.json +3 -3
  17. package/.vscode/settings.json +10 -10
  18. package/HOWTO.md +15 -15
  19. package/LICENSE +21 -21
  20. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  21. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  22. package/_specifications/BACKLOG.md +92 -92
  23. package/_specifications/TODO.md +15 -15
  24. package/_specifications/agent.md +138 -138
  25. package/build/_collections/client-safe-error.util.d.ts +9 -3
  26. package/build/_collections/client-safe-error.util.d.ts.map +1 -1
  27. package/build/_collections/client-safe-error.util.js +32 -3
  28. package/build/_collections/client-safe-error.util.js.map +1 -1
  29. package/eslint.config.js +3 -3
  30. package/nodemon.json +24 -24
  31. package/package.json +3 -3
  32. package/pnpm-workspace.yaml +5 -5
  33. package/scripts/run-coverage-tests.js +28 -28
  34. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  35. package/spec/support/helpers/ts-node-helper.js +93 -93
  36. package/spec/support/jasmine.coverage.json +24 -24
  37. package/spec/support/jasmine.json +24 -24
  38. package/src/_collections/archive.util.spec.ts +57 -57
  39. package/src/_collections/archive.util.ts +18 -18
  40. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  41. package/src/_collections/client-safe-error.util.spec.ts +58 -2
  42. package/src/_collections/client-safe-error.util.ts +38 -3
  43. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  44. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  45. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  46. package/src/_collections/default-not-found-page.const.ts +22 -22
  47. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  48. package/src/_collections/default-socket-path.const.ts +2 -2
  49. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  50. package/src/_collections/get-environment-settings.util.ts +48 -48
  51. package/src/_collections/global-settings.const.ts +126 -126
  52. package/src/_collections/sample.env +21 -21
  53. package/src/_collections/star.controller.spec.ts +224 -224
  54. package/src/_collections/star.controller.ts +129 -129
  55. package/src/_enums/data-model-type.enum.ts +14 -14
  56. package/src/_enums/data-service-function.enum.ts +24 -24
  57. package/src/_enums/predefined-data-types.enum.ts +16 -16
  58. package/src/_enums/route-security.enum.ts +12 -12
  59. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  60. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  61. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  62. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  63. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  64. package/src/_models/control-models/app-params.control-model.ts +136 -136
  65. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  66. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  67. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  68. package/src/_models/control-models/endpoint-params.control-model.ts +628 -628
  69. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  70. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  71. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  72. package/src/_models/control-models/system-control.control-model.ts +12 -12
  73. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  74. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  75. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  76. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  77. package/src/_models/interfaces/global-settings.interface.ts +286 -286
  78. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  79. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  80. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  81. package/src/_models/types/db-update.type.ts +100 -100
  82. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  83. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  84. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  85. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  87. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  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-code-chunk.interface.ts +68 -68
  97. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  98. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  99. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  100. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  101. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  102. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  103. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  104. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  105. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  106. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  107. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  108. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  109. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  111. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  112. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  113. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  120. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  121. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  122. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  123. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  124. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  125. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  126. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  127. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  128. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  129. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  130. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  131. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  132. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  133. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  134. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  135. package/src/_modules/ai/index.ts +23 -23
  136. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  137. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  138. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  139. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  140. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  141. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  142. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  143. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  144. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  145. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  146. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  147. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  148. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  149. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  150. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  151. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  152. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  153. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  154. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  155. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  156. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  157. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  158. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  159. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  160. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  161. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  162. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  163. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  164. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  165. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  166. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  167. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  168. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  169. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  170. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  171. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  172. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  173. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  174. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  175. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  176. package/src/_modules/custom-data/index.ts +9 -9
  177. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  178. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  179. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  180. package/src/_modules/data-readers/index.ts +11 -11
  181. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  182. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  183. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  184. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  185. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  186. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  187. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  188. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  189. package/src/_modules/defaults/index.ts +17 -17
  190. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  191. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  192. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  193. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  194. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  195. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  196. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  197. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  198. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  199. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  200. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  201. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  202. package/src/_modules/discord-assistant/index.ts +38 -38
  203. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  204. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  205. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  206. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  207. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  208. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  209. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  210. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  211. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  212. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  213. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  214. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  215. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  216. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  217. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  218. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  219. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  220. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  221. package/src/_modules/discord-bot/index.ts +36 -36
  222. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  223. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  224. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  225. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  226. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  227. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  228. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  229. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  230. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  231. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  232. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  233. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  234. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  235. package/src/_modules/local-vector-search/index.ts +16 -16
  236. package/src/_modules/logs/index.ts +11 -11
  237. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  238. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  239. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  240. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  241. package/src/_modules/mcp/index.ts +13 -13
  242. package/src/_modules/messaging/README.md +354 -354
  243. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  244. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  245. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  246. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  247. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  248. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  249. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  250. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  251. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  252. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  253. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  254. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  255. package/src/_modules/messaging/index.ts +30 -30
  256. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  257. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  258. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  259. package/src/_modules/mock/app-params.mock.ts +9 -9
  260. package/src/_modules/mock/app-server.mock.ts +188 -188
  261. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  262. package/src/_modules/mock/auth-service.mock.ts +28 -28
  263. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  264. package/src/_modules/mock/controller.mock.ts +16 -16
  265. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  266. package/src/_modules/mock/data-model.mock.ts +82 -82
  267. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  268. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  269. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  270. package/src/_modules/mock/email-service.mock.ts +20 -20
  271. package/src/_modules/mock/email-template.mock.html +14 -14
  272. package/src/_modules/mock/endpoint.mock.ts +91 -91
  273. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  274. package/src/_modules/mock/socket-client.mock.ts +45 -45
  275. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  276. package/src/_modules/mock/socket-server.mock.ts +46 -46
  277. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  278. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  279. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  280. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  281. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  282. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  283. package/src/_modules/oauth2/index.ts +17 -17
  284. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  285. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  286. package/src/_modules/scheduler/index.ts +8 -8
  287. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  288. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  289. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  290. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  291. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  292. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  293. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  294. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  295. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  296. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  297. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  298. package/src/_modules/scoped-config/index.ts +17 -17
  299. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  300. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  301. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  302. package/src/_modules/server/errors/errors.controller.ts +515 -515
  303. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  304. package/src/_modules/server/index.ts +30 -30
  305. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  306. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  307. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  308. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  309. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  310. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  311. package/src/_modules/server/server-status/server-status.controller.spec.ts +255 -255
  312. package/src/_modules/server/server-status/server-status.controller.ts +292 -292
  313. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  314. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  315. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  316. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  317. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  318. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  319. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  320. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  321. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  322. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  323. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  324. package/src/_modules/socket/app-extended.server.ts +642 -642
  325. package/src/_modules/socket/index.ts +42 -42
  326. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  327. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  328. package/src/_modules/test/index.ts +11 -11
  329. package/src/_modules/test/test.controller.spec.ts +72 -72
  330. package/src/_modules/test/test.controller.ts +115 -115
  331. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  332. package/src/_modules/usage/index.ts +15 -15
  333. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  334. package/src/_modules/usage/usage.controller.ts +126 -126
  335. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  336. package/src/_modules/usage/usage.data-service.ts +185 -185
  337. package/src/_services/base/api.service-base.spec.ts +125 -125
  338. package/src/_services/base/api.service-base.ts +74 -74
  339. package/src/_services/base/archive-data.service.spec.ts +209 -209
  340. package/src/_services/base/archive-data.service.ts +223 -223
  341. package/src/_services/base/data.service.spec.ts +729 -729
  342. package/src/_services/base/data.service.ts +2758 -2758
  343. package/src/_services/base/db.service.spec.ts +160 -160
  344. package/src/_services/base/db.service.ts +1644 -1644
  345. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  346. package/src/_services/base/singleton.service-base.ts +24 -24
  347. package/src/_services/base/singleton.service.spec.ts +114 -114
  348. package/src/_services/base/singleton.service.ts +38 -38
  349. package/src/_services/core/api.service.spec.ts +140 -140
  350. package/src/_services/core/auth.service.spec.ts +159 -159
  351. package/src/_services/core/auth.service.ts +174 -174
  352. package/src/_services/core/email.service.spec.ts +85 -85
  353. package/src/_services/core/email.service.ts +757 -757
  354. package/src/_services/core/global.service.spec.ts +292 -292
  355. package/src/_services/core/global.service.ts +487 -487
  356. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  357. package/src/_services/core/memory-guard.service.ts +481 -481
  358. package/src/_services/core/service-collection.service.spec.ts +46 -46
  359. package/src/_services/core/service-collection.service.ts +6 -6
  360. package/src/_services/route/controller.service.spec.ts +53 -53
  361. package/src/_services/route/controller.service.ts +148 -148
  362. package/src/_services/route/routing-module.service.spec.ts +98 -98
  363. package/src/_services/route/routing-module.service.ts +330 -330
  364. package/src/_services/server/app.server.ts +1985 -1985
  365. package/src/_services/shared.static-service.spec.ts +99 -99
  366. package/src/_services/shared.static-service.ts +78 -78
  367. package/src/index.ts +100 -100
  368. package/tsconfig.app.json +12 -12
  369. package/tsconfig.json +42 -42
  370. package/.dynamo/logs/cicd-pipeline/output.log +0 -2855
  371. package/.dynamo/logs/cicd-pipeline/status.json +0 -74
@@ -1,268 +1,268 @@
1
-
2
- import { DyNTS_Errors_Controller } from './errors.controller';
3
- import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
- import { DyNTS_Errors_ControlService } from './errors.control-service';
5
- import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
6
-
7
- class TestError extends DyFM_Error {
8
- testProperty?: string;
9
- }
10
-
11
- class TestErrors extends DyFM_Errors<TestError> {
12
- testProperty?: string;
13
- }
14
-
15
- class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
16
- async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
17
- async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
18
- checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
19
- getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
20
- async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
21
- async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
22
- async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
23
- async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
24
- return { at: new Date(), by: issuer, version, hypothesis };
25
- }
26
- async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
27
- return { items: [], total: 0, pageIndex, pageSize };
28
- }
29
-
30
- async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
31
- return;
32
- }
33
-
34
- async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
35
- return { items: [], total: 0, pageIndex, pageSize };
36
- }
37
- async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
38
- async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
39
- async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
40
- async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
41
- }
42
-
43
- class TestErrorsController extends DyNTS_Errors_Controller<TestError, TestErrors, TestErrorsControlService> {
44
- protected getError_ControlService(set: { data?: TestError, issuer: string }): TestErrorsControlService {
45
- return new TestErrorsControlService();
46
- }
47
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
48
- }
49
-
50
- describe('| DyNTS_Errors_Controller', () => {
51
- let controller: TestErrorsController;
52
-
53
- beforeEach(() => {
54
- controller = new (TestErrorsController as any)();
55
- });
56
-
57
- describe('| setupEndpoints', () => {
58
- it('| should setup all error endpoints', () => {
59
- controller.setupEndpoints();
60
-
61
- expect(controller.endpoints).toBeDefined();
62
- expect(controller.endpoints.length).toBeGreaterThanOrEqual(6);
63
- });
64
-
65
- it('| should setup logError endpoint', () => {
66
- controller.setupEndpoints();
67
-
68
- const logErrorEndpoint = controller.endpoints.find(ep => ep.name === 'logError');
69
- expect(logErrorEndpoint).toBeDefined();
70
- expect(logErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
71
- expect(logErrorEndpoint?.endpoint).toBe('/error/log');
72
- expect((logErrorEndpoint as any)?.tasks).toBeDefined();
73
- expect((logErrorEndpoint as any)?.tasks?.length).toBe(1);
74
- });
75
-
76
- it('| should setup newError endpoint', () => {
77
- controller.setupEndpoints();
78
-
79
- const newErrorEndpoint = controller.endpoints.find(ep => ep.name === 'newError');
80
- expect(newErrorEndpoint).toBeDefined();
81
- expect(newErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
82
- expect(newErrorEndpoint?.endpoint).toBe('/error/new');
83
- expect((newErrorEndpoint as any)?.tasks).toBeDefined();
84
- expect((newErrorEndpoint as any)?.tasks?.length).toBe(1);
85
- });
86
-
87
- it('| should setup markErrorDone endpoint', () => {
88
- controller.setupEndpoints();
89
-
90
- const markErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markErrorDone');
91
- expect(markErrorDoneEndpoint).toBeDefined();
92
- expect(markErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
93
- expect(markErrorDoneEndpoint?.endpoint).toBe('/error/mark-done/:errorId');
94
- expect((markErrorDoneEndpoint as any)?.tasks).toBeDefined();
95
- expect((markErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
96
- });
97
-
98
- it('| should setup markAllErrorDone endpoint', () => {
99
- controller.setupEndpoints();
100
-
101
- const markAllErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markAllErrorDone');
102
- expect(markAllErrorDoneEndpoint).toBeDefined();
103
- expect(markAllErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
104
- expect(markAllErrorDoneEndpoint?.endpoint).toBe('/error/mark-all-done');
105
- expect((markAllErrorDoneEndpoint as any)?.tasks).toBeDefined();
106
- expect((markAllErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
107
- });
108
-
109
- it('| should setup getErrors endpoint', () => {
110
- controller.setupEndpoints();
111
-
112
- const getErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrors');
113
- expect(getErrorsEndpoint).toBeDefined();
114
- expect(getErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
115
- expect(getErrorsEndpoint?.endpoint).toBe('/error/get-range/:range');
116
- expect((getErrorsEndpoint as any)?.tasks).toBeDefined();
117
- expect((getErrorsEndpoint as any)?.tasks?.length).toBe(1);
118
- });
119
-
120
- it('| should setup getErrorsPaged endpoint', () => {
121
- controller.setupEndpoints();
122
-
123
- const getErrorsPagedEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorsPaged');
124
- expect(getErrorsPagedEndpoint).toBeDefined();
125
- expect(getErrorsPagedEndpoint?.type).toBe(DyFM_HttpCallType.get);
126
- expect(getErrorsPagedEndpoint?.endpoint).toBe('/error/get-paged/:range/:pageSize/:pageIndex');
127
- expect((getErrorsPagedEndpoint as any)?.tasks).toBeDefined();
128
- expect((getErrorsPagedEndpoint as any)?.tasks?.length).toBe(1);
129
- });
130
-
131
- it('| should setup getLastErrors endpoint', () => {
132
- controller.setupEndpoints();
133
-
134
- const getLastErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getLastErrors');
135
- expect(getLastErrorsEndpoint).toBeDefined();
136
- expect(getLastErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
137
- expect(getLastErrorsEndpoint?.endpoint).toBe('/error/get-last-paged/:range/:pageSize/:pageIndex');
138
- expect((getLastErrorsEndpoint as any)?.tasks).toBeDefined();
139
- expect((getLastErrorsEndpoint as any)?.tasks?.length).toBe(1);
140
- });
141
-
142
- it('| should setup searchErrors endpoint', () => {
143
- controller.setupEndpoints();
144
-
145
- const searchErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'searchErrors');
146
- expect(searchErrorsEndpoint).toBeDefined();
147
- expect(searchErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
148
- expect(searchErrorsEndpoint?.endpoint).toBe('/error/search');
149
- expect((searchErrorsEndpoint as any)?.tasks).toBeDefined();
150
- expect((searchErrorsEndpoint as any)?.tasks?.length).toBe(1);
151
- });
152
-
153
- it('| should include additionalEndpoints', () => {
154
- const additionalEndpoint = new DyNTS_Endpoint_Params({
155
- name: 'customEndpoint',
156
- type: DyFM_HttpCallType.get,
157
- endpoint: '/error/custom',
158
- tasks: [],
159
- });
160
- (controller as any).additionalEndpoints.push(additionalEndpoint);
161
-
162
- controller.setupEndpoints();
163
-
164
- const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
165
- expect(customEndpoint).toBeDefined();
166
- });
167
-
168
- it('| should throw error when additionalEndpoints is not defined', () => {
169
- const controllerWithoutEndpoints = new (class extends TestErrorsController {
170
- protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
171
- } as any)();
172
-
173
- expect(() => {
174
- controllerWithoutEndpoints.setupEndpoints();
175
- }).toThrow();
176
- });
177
- });
178
-
179
- describe('| opt-in admin auth retrofit (BL-20260420-004)', (): void => {
180
- afterEach((): void => {
181
- DyNTS_Errors_Controller._resetAuthConfigForTesting();
182
- });
183
-
184
- // FR-263 — a guard mostantol REQUEST-IDOBEN fut (lazy wrapper); igy MINDEN endpoint-on pontosan
185
- // 1 preProcess (a wrapper) van, a tenyleges guard-logikat a wrapper MEGHIVASAVAL teszteljuk.
186
- const lazyWrapperOf = (c: any, name: string): ((req: any, res: any) => Promise<void>) | undefined => {
187
- const ep: any = c.endpoints.find((e: any) => e.name === name);
188
- return ep?.preProcesses?.[0];
189
- };
190
- const mockReqRes = (): { req: any; res: any } => ({ req: {} as any, res: { headersSent: false } as any });
191
-
192
- it('| default (no config): a lazy wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
193
- controller.setupEndpoints();
194
- for (const name of ['logError', 'getErrors', 'searchErrors']) {
195
- const w = lazyWrapperOf(controller, name);
196
- expect(w).withContext(`${name} wrapper`).toBeDefined();
197
- const { req, res } = mockReqRes();
198
- await w!(req, res); // nincs config → no-op, nem dob, nem blokkol
199
- }
200
- });
201
-
202
- it('| configure({ authPreProcess }) → egy keres MINDEN built-in endpoint-on meghivja a guardot', async (): Promise<void> => {
203
- let calls: number = 0;
204
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
205
- const c = new (TestErrorsController as any)();
206
- c.setupEndpoints();
207
- const builtIn: string[] = [
208
- 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
209
- 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors',
210
- ];
211
- for (const name of builtIn) {
212
- const w = lazyWrapperOf(c, name);
213
- expect(w).withContext(`endpoint ${name} missing`).toBeDefined();
214
- const { req, res } = mockReqRes();
215
- await w!(req, res);
216
- }
217
- expect(calls).toBe(builtIn.length);
218
- });
219
-
220
- it('| configure({ protectedEndpoints: subset }) → a guard CSAK a listazott endpoint-okon fut', async (): Promise<void> => {
221
- let calls: number = 0;
222
- DyNTS_Errors_Controller.configure({
223
- authPreProcess: async (): Promise<void> => { calls++; },
224
- protectedEndpoints: ['markAllErrorDone', 'logError'],
225
- });
226
- const c = new (TestErrorsController as any)();
227
- c.setupEndpoints();
228
- for (const name of ['markAllErrorDone', 'logError']) {
229
- const { req, res } = mockReqRes();
230
- await lazyWrapperOf(c, name)!(req, res);
231
- }
232
- expect(calls).withContext('protected → guard runs').toBe(2);
233
- calls = 0;
234
- const { req, res } = mockReqRes();
235
- await lazyWrapperOf(c, 'getErrors')!(req, res);
236
- expect(calls).withContext('non-protected getErrors → guard does NOT run').toBe(0);
237
- });
238
-
239
- it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot (a fix lenyege)', async (): Promise<void> => {
240
- // A framework korai singleton-konstrukcioja: az endpoints config NELKUL epul fel...
241
- const c = new (TestErrorsController as any)();
242
- c.setupEndpoints();
243
- // ...es a configure() KESOBB fut (ez volt a fals-200 info-disclosure bug). A lazy wrapper
244
- // request-idoben olvassa a configot → a guard MEGIS lefut. Ez az FR-263 regresszio-guard.
245
- let calls: number = 0;
246
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
247
- const { req, res } = mockReqRes();
248
- await lazyWrapperOf(c, 'getErrors')!(req, res);
249
- expect(calls).withContext('guard must run despite configure() AFTER setupEndpoints').toBe(1);
250
- });
251
-
252
- it('| getAuthConfig() returns the active config', (): void => {
253
- const fakeAuth = async (): Promise<void> => { /* noop */ };
254
- DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: ['logError'] });
255
- const cfg = DyNTS_Errors_Controller.getAuthConfig();
256
- expect(cfg.authPreProcess).toBe(fakeAuth);
257
- expect(cfg.protectedEndpoints).toEqual(['logError']);
258
- });
259
-
260
- it('| _resetAuthConfigForTesting() clears the config', (): void => {
261
- DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
262
- DyNTS_Errors_Controller._resetAuthConfigForTesting();
263
- const cfg = DyNTS_Errors_Controller.getAuthConfig();
264
- expect(cfg.authPreProcess).toBeUndefined();
265
- });
266
- });
267
- });
268
-
1
+
2
+ import { DyNTS_Errors_Controller } from './errors.controller';
3
+ import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
4
+ import { DyNTS_Errors_ControlService } from './errors.control-service';
5
+ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
6
+
7
+ class TestError extends DyFM_Error {
8
+ testProperty?: string;
9
+ }
10
+
11
+ class TestErrors extends DyFM_Errors<TestError> {
12
+ testProperty?: string;
13
+ }
14
+
15
+ class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
16
+ async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
17
+ async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
18
+ checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
19
+ getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
20
+ async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
21
+ async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
22
+ async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
23
+ async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
24
+ return { at: new Date(), by: issuer, version, hypothesis };
25
+ }
26
+ async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
27
+ return { items: [], total: 0, pageIndex, pageSize };
28
+ }
29
+
30
+ async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
31
+ return;
32
+ }
33
+
34
+ async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
35
+ return { items: [], total: 0, pageIndex, pageSize };
36
+ }
37
+ async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
38
+ async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
39
+ async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
40
+ async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
41
+ }
42
+
43
+ class TestErrorsController extends DyNTS_Errors_Controller<TestError, TestErrors, TestErrorsControlService> {
44
+ protected getError_ControlService(set: { data?: TestError, issuer: string }): TestErrorsControlService {
45
+ return new TestErrorsControlService();
46
+ }
47
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
48
+ }
49
+
50
+ describe('| DyNTS_Errors_Controller', () => {
51
+ let controller: TestErrorsController;
52
+
53
+ beforeEach(() => {
54
+ controller = new (TestErrorsController as any)();
55
+ });
56
+
57
+ describe('| setupEndpoints', () => {
58
+ it('| should setup all error endpoints', () => {
59
+ controller.setupEndpoints();
60
+
61
+ expect(controller.endpoints).toBeDefined();
62
+ expect(controller.endpoints.length).toBeGreaterThanOrEqual(6);
63
+ });
64
+
65
+ it('| should setup logError endpoint', () => {
66
+ controller.setupEndpoints();
67
+
68
+ const logErrorEndpoint = controller.endpoints.find(ep => ep.name === 'logError');
69
+ expect(logErrorEndpoint).toBeDefined();
70
+ expect(logErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
71
+ expect(logErrorEndpoint?.endpoint).toBe('/error/log');
72
+ expect((logErrorEndpoint as any)?.tasks).toBeDefined();
73
+ expect((logErrorEndpoint as any)?.tasks?.length).toBe(1);
74
+ });
75
+
76
+ it('| should setup newError endpoint', () => {
77
+ controller.setupEndpoints();
78
+
79
+ const newErrorEndpoint = controller.endpoints.find(ep => ep.name === 'newError');
80
+ expect(newErrorEndpoint).toBeDefined();
81
+ expect(newErrorEndpoint?.type).toBe(DyFM_HttpCallType.post);
82
+ expect(newErrorEndpoint?.endpoint).toBe('/error/new');
83
+ expect((newErrorEndpoint as any)?.tasks).toBeDefined();
84
+ expect((newErrorEndpoint as any)?.tasks?.length).toBe(1);
85
+ });
86
+
87
+ it('| should setup markErrorDone endpoint', () => {
88
+ controller.setupEndpoints();
89
+
90
+ const markErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markErrorDone');
91
+ expect(markErrorDoneEndpoint).toBeDefined();
92
+ expect(markErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
93
+ expect(markErrorDoneEndpoint?.endpoint).toBe('/error/mark-done/:errorId');
94
+ expect((markErrorDoneEndpoint as any)?.tasks).toBeDefined();
95
+ expect((markErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
96
+ });
97
+
98
+ it('| should setup markAllErrorDone endpoint', () => {
99
+ controller.setupEndpoints();
100
+
101
+ const markAllErrorDoneEndpoint = controller.endpoints.find(ep => ep.name === 'markAllErrorDone');
102
+ expect(markAllErrorDoneEndpoint).toBeDefined();
103
+ expect(markAllErrorDoneEndpoint?.type).toBe(DyFM_HttpCallType.get);
104
+ expect(markAllErrorDoneEndpoint?.endpoint).toBe('/error/mark-all-done');
105
+ expect((markAllErrorDoneEndpoint as any)?.tasks).toBeDefined();
106
+ expect((markAllErrorDoneEndpoint as any)?.tasks?.length).toBe(1);
107
+ });
108
+
109
+ it('| should setup getErrors endpoint', () => {
110
+ controller.setupEndpoints();
111
+
112
+ const getErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrors');
113
+ expect(getErrorsEndpoint).toBeDefined();
114
+ expect(getErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
115
+ expect(getErrorsEndpoint?.endpoint).toBe('/error/get-range/:range');
116
+ expect((getErrorsEndpoint as any)?.tasks).toBeDefined();
117
+ expect((getErrorsEndpoint as any)?.tasks?.length).toBe(1);
118
+ });
119
+
120
+ it('| should setup getErrorsPaged endpoint', () => {
121
+ controller.setupEndpoints();
122
+
123
+ const getErrorsPagedEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorsPaged');
124
+ expect(getErrorsPagedEndpoint).toBeDefined();
125
+ expect(getErrorsPagedEndpoint?.type).toBe(DyFM_HttpCallType.get);
126
+ expect(getErrorsPagedEndpoint?.endpoint).toBe('/error/get-paged/:range/:pageSize/:pageIndex');
127
+ expect((getErrorsPagedEndpoint as any)?.tasks).toBeDefined();
128
+ expect((getErrorsPagedEndpoint as any)?.tasks?.length).toBe(1);
129
+ });
130
+
131
+ it('| should setup getLastErrors endpoint', () => {
132
+ controller.setupEndpoints();
133
+
134
+ const getLastErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'getLastErrors');
135
+ expect(getLastErrorsEndpoint).toBeDefined();
136
+ expect(getLastErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
137
+ expect(getLastErrorsEndpoint?.endpoint).toBe('/error/get-last-paged/:range/:pageSize/:pageIndex');
138
+ expect((getLastErrorsEndpoint as any)?.tasks).toBeDefined();
139
+ expect((getLastErrorsEndpoint as any)?.tasks?.length).toBe(1);
140
+ });
141
+
142
+ it('| should setup searchErrors endpoint', () => {
143
+ controller.setupEndpoints();
144
+
145
+ const searchErrorsEndpoint = controller.endpoints.find(ep => ep.name === 'searchErrors');
146
+ expect(searchErrorsEndpoint).toBeDefined();
147
+ expect(searchErrorsEndpoint?.type).toBe(DyFM_HttpCallType.get);
148
+ expect(searchErrorsEndpoint?.endpoint).toBe('/error/search');
149
+ expect((searchErrorsEndpoint as any)?.tasks).toBeDefined();
150
+ expect((searchErrorsEndpoint as any)?.tasks?.length).toBe(1);
151
+ });
152
+
153
+ it('| should include additionalEndpoints', () => {
154
+ const additionalEndpoint = new DyNTS_Endpoint_Params({
155
+ name: 'customEndpoint',
156
+ type: DyFM_HttpCallType.get,
157
+ endpoint: '/error/custom',
158
+ tasks: [],
159
+ });
160
+ (controller as any).additionalEndpoints.push(additionalEndpoint);
161
+
162
+ controller.setupEndpoints();
163
+
164
+ const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
165
+ expect(customEndpoint).toBeDefined();
166
+ });
167
+
168
+ it('| should throw error when additionalEndpoints is not defined', () => {
169
+ const controllerWithoutEndpoints = new (class extends TestErrorsController {
170
+ protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
171
+ } as any)();
172
+
173
+ expect(() => {
174
+ controllerWithoutEndpoints.setupEndpoints();
175
+ }).toThrow();
176
+ });
177
+ });
178
+
179
+ describe('| opt-in admin auth retrofit (BL-20260420-004)', (): void => {
180
+ afterEach((): void => {
181
+ DyNTS_Errors_Controller._resetAuthConfigForTesting();
182
+ });
183
+
184
+ // FR-263 — a guard mostantol REQUEST-IDOBEN fut (lazy wrapper); igy MINDEN endpoint-on pontosan
185
+ // 1 preProcess (a wrapper) van, a tenyleges guard-logikat a wrapper MEGHIVASAVAL teszteljuk.
186
+ const lazyWrapperOf = (c: any, name: string): ((req: any, res: any) => Promise<void>) | undefined => {
187
+ const ep: any = c.endpoints.find((e: any) => e.name === name);
188
+ return ep?.preProcesses?.[0];
189
+ };
190
+ const mockReqRes = (): { req: any; res: any } => ({ req: {} as any, res: { headersSent: false } as any });
191
+
192
+ it('| default (no config): a lazy wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
193
+ controller.setupEndpoints();
194
+ for (const name of ['logError', 'getErrors', 'searchErrors']) {
195
+ const w = lazyWrapperOf(controller, name);
196
+ expect(w).withContext(`${name} wrapper`).toBeDefined();
197
+ const { req, res } = mockReqRes();
198
+ await w!(req, res); // nincs config → no-op, nem dob, nem blokkol
199
+ }
200
+ });
201
+
202
+ it('| configure({ authPreProcess }) → egy keres MINDEN built-in endpoint-on meghivja a guardot', async (): Promise<void> => {
203
+ let calls: number = 0;
204
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
205
+ const c = new (TestErrorsController as any)();
206
+ c.setupEndpoints();
207
+ const builtIn: string[] = [
208
+ 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
209
+ 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors',
210
+ ];
211
+ for (const name of builtIn) {
212
+ const w = lazyWrapperOf(c, name);
213
+ expect(w).withContext(`endpoint ${name} missing`).toBeDefined();
214
+ const { req, res } = mockReqRes();
215
+ await w!(req, res);
216
+ }
217
+ expect(calls).toBe(builtIn.length);
218
+ });
219
+
220
+ it('| configure({ protectedEndpoints: subset }) → a guard CSAK a listazott endpoint-okon fut', async (): Promise<void> => {
221
+ let calls: number = 0;
222
+ DyNTS_Errors_Controller.configure({
223
+ authPreProcess: async (): Promise<void> => { calls++; },
224
+ protectedEndpoints: ['markAllErrorDone', 'logError'],
225
+ });
226
+ const c = new (TestErrorsController as any)();
227
+ c.setupEndpoints();
228
+ for (const name of ['markAllErrorDone', 'logError']) {
229
+ const { req, res } = mockReqRes();
230
+ await lazyWrapperOf(c, name)!(req, res);
231
+ }
232
+ expect(calls).withContext('protected → guard runs').toBe(2);
233
+ calls = 0;
234
+ const { req, res } = mockReqRes();
235
+ await lazyWrapperOf(c, 'getErrors')!(req, res);
236
+ expect(calls).withContext('non-protected getErrors → guard does NOT run').toBe(0);
237
+ });
238
+
239
+ it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot (a fix lenyege)', async (): Promise<void> => {
240
+ // A framework korai singleton-konstrukcioja: az endpoints config NELKUL epul fel...
241
+ const c = new (TestErrorsController as any)();
242
+ c.setupEndpoints();
243
+ // ...es a configure() KESOBB fut (ez volt a fals-200 info-disclosure bug). A lazy wrapper
244
+ // request-idoben olvassa a configot → a guard MEGIS lefut. Ez az FR-263 regresszio-guard.
245
+ let calls: number = 0;
246
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { calls++; } });
247
+ const { req, res } = mockReqRes();
248
+ await lazyWrapperOf(c, 'getErrors')!(req, res);
249
+ expect(calls).withContext('guard must run despite configure() AFTER setupEndpoints').toBe(1);
250
+ });
251
+
252
+ it('| getAuthConfig() returns the active config', (): void => {
253
+ const fakeAuth = async (): Promise<void> => { /* noop */ };
254
+ DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: ['logError'] });
255
+ const cfg = DyNTS_Errors_Controller.getAuthConfig();
256
+ expect(cfg.authPreProcess).toBe(fakeAuth);
257
+ expect(cfg.protectedEndpoints).toEqual(['logError']);
258
+ });
259
+
260
+ it('| _resetAuthConfigForTesting() clears the config', (): void => {
261
+ DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
262
+ DyNTS_Errors_Controller._resetAuthConfigForTesting();
263
+ const cfg = DyNTS_Errors_Controller.getAuthConfig();
264
+ expect(cfg.authPreProcess).toBeUndefined();
265
+ });
266
+ });
267
+ });
268
+