@futdevpro/nts-dynamo 1.15.56 → 1.15.57

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 (323) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/logs/cicd-pipeline/output.log +4691 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +396 -0
  18. package/.github/workflows/main.yml +432 -432
  19. package/.vscode/settings.json +10 -10
  20. package/HOWTO.md +15 -15
  21. package/LICENSE +21 -21
  22. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  23. package/_specifications/BACKLOG.md +92 -92
  24. package/_specifications/TODO.md +15 -15
  25. package/_specifications/agent.md +138 -138
  26. package/eslint.config.js +3 -3
  27. package/nodemon.json +24 -24
  28. package/package.json +1 -1
  29. package/pnpm-workspace.yaml +4 -4
  30. package/scripts/run-coverage-tests.js +28 -28
  31. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  32. package/spec/support/helpers/ts-node-helper.js +93 -93
  33. package/spec/support/jasmine.coverage.json +24 -24
  34. package/spec/support/jasmine.json +24 -24
  35. package/src/_collections/archive.util.spec.ts +57 -57
  36. package/src/_collections/archive.util.ts +18 -18
  37. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  38. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  39. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  40. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  41. package/src/_collections/default-not-found-page.const.ts +22 -22
  42. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  43. package/src/_collections/default-socket-path.const.ts +2 -2
  44. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  45. package/src/_collections/get-environment-settings.util.ts +48 -48
  46. package/src/_collections/global-settings.const.ts +82 -82
  47. package/src/_collections/sample.env +21 -21
  48. package/src/_collections/star.controller.spec.ts +224 -224
  49. package/src/_collections/star.controller.ts +129 -129
  50. package/src/_enums/data-model-type.enum.ts +14 -14
  51. package/src/_enums/data-service-function.enum.ts +24 -24
  52. package/src/_enums/predefined-data-types.enum.ts +16 -16
  53. package/src/_enums/route-security.enum.ts +12 -12
  54. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  55. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  56. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  57. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  58. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  59. package/src/_models/control-models/app-params.control-model.ts +136 -136
  60. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  61. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  62. package/src/_models/control-models/endpoint-params.control-model.spec.ts +627 -627
  63. package/src/_models/control-models/endpoint-params.control-model.ts +627 -627
  64. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  65. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  66. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  67. package/src/_models/control-models/system-control.control-model.ts +12 -12
  68. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  69. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  70. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  71. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  72. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  73. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  74. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  75. package/src/_models/types/db-update.type.ts +100 -100
  76. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  77. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  78. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  79. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  80. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  81. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  82. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  83. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  84. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  85. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  86. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  87. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  88. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  89. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  90. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  91. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  92. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  93. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  94. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  95. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  96. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  97. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  98. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  99. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  100. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  101. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  102. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  103. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  104. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  105. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  106. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  107. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  108. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  109. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  110. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  111. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  112. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  113. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  114. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  115. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  116. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  117. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  118. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  119. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  120. package/src/_modules/ai/index.ts +13 -13
  121. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  122. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  123. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  124. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  125. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  126. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  127. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  128. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  129. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  130. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  131. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  132. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  133. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  134. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  135. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  136. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  137. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  138. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  139. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  140. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  141. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  142. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  143. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  144. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  145. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  146. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  147. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  148. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  149. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  150. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  151. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  152. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  153. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  154. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  155. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  156. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  157. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  158. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  159. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  160. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  161. package/src/_modules/custom-data/index.ts +9 -9
  162. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  163. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  164. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  165. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  166. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  167. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  168. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  169. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  170. package/src/_modules/defaults/index.ts +17 -17
  171. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  172. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  173. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  174. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  175. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  176. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  177. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  178. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  179. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  180. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  181. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  182. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  183. package/src/_modules/discord-assistant/index.ts +38 -38
  184. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  185. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  186. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  187. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  188. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  189. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  190. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  191. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  192. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  193. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  194. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  195. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  196. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  197. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  198. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  199. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  200. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  201. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  202. package/src/_modules/discord-bot/index.ts +36 -36
  203. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  204. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  205. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  206. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  207. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  208. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  209. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  210. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  211. package/src/_modules/local-vector-search/index.ts +11 -11
  212. package/src/_modules/logs/index.ts +11 -11
  213. package/src/_modules/messaging/README.md +354 -354
  214. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  215. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  216. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  217. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  218. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  219. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  220. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  221. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  222. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  223. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  224. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  225. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  226. package/src/_modules/messaging/index.ts +30 -30
  227. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  228. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  229. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  230. package/src/_modules/mock/app-params.mock.ts +9 -9
  231. package/src/_modules/mock/app-server.mock.ts +188 -188
  232. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  233. package/src/_modules/mock/auth-service.mock.ts +28 -28
  234. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  235. package/src/_modules/mock/controller.mock.ts +16 -16
  236. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  237. package/src/_modules/mock/data-model.mock.ts +82 -82
  238. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  239. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  240. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  241. package/src/_modules/mock/email-service.mock.ts +20 -20
  242. package/src/_modules/mock/email-template.mock.html +14 -14
  243. package/src/_modules/mock/endpoint.mock.ts +91 -91
  244. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  245. package/src/_modules/mock/socket-client.mock.ts +45 -45
  246. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  247. package/src/_modules/mock/socket-server.mock.ts +46 -46
  248. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  249. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  250. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  251. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  252. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  253. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  254. package/src/_modules/oauth2/index.ts +17 -17
  255. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  256. package/src/_modules/server/errors/errors.control-service.ts +85 -85
  257. package/src/_modules/server/errors/errors.controller.spec.ts +241 -241
  258. package/src/_modules/server/errors/errors.controller.ts +431 -431
  259. package/src/_modules/server/errors/errors.data-service.spec.ts +361 -361
  260. package/src/_modules/server/index.ts +30 -30
  261. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  262. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  263. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  264. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  265. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  266. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  267. package/src/_modules/server/server-status/server-status.controller.spec.ts +240 -240
  268. package/src/_modules/server/server-status/server-status.controller.ts +253 -253
  269. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  270. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  271. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  272. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  273. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  274. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  275. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  276. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  277. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  278. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  279. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  280. package/src/_modules/socket/app-extended.server.ts +630 -630
  281. package/src/_modules/socket/index.ts +42 -42
  282. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  283. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  284. package/src/_modules/test/index.ts +11 -11
  285. package/src/_modules/test/test.controller.spec.ts +72 -72
  286. package/src/_modules/test/test.controller.ts +115 -115
  287. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  288. package/src/_modules/usage/index.ts +15 -15
  289. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  290. package/src/_modules/usage/usage.controller.ts +126 -126
  291. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  292. package/src/_modules/usage/usage.data-service.ts +185 -185
  293. package/src/_services/base/api.service-base.spec.ts +125 -125
  294. package/src/_services/base/api.service-base.ts +74 -74
  295. package/src/_services/base/archive-data.service.spec.ts +196 -196
  296. package/src/_services/base/archive-data.service.ts +216 -216
  297. package/src/_services/base/data.service.spec.ts +674 -674
  298. package/src/_services/base/data.service.ts +2719 -2719
  299. package/src/_services/base/db.service.spec.ts +73 -73
  300. package/src/_services/base/db.service.ts +1575 -1575
  301. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  302. package/src/_services/base/singleton.service-base.ts +24 -24
  303. package/src/_services/base/singleton.service.spec.ts +114 -114
  304. package/src/_services/base/singleton.service.ts +38 -38
  305. package/src/_services/core/api.service.spec.ts +140 -140
  306. package/src/_services/core/auth.service.spec.ts +159 -159
  307. package/src/_services/core/auth.service.ts +174 -174
  308. package/src/_services/core/email.service.spec.ts +85 -85
  309. package/src/_services/core/email.service.ts +742 -742
  310. package/src/_services/core/global.service.spec.ts +275 -275
  311. package/src/_services/core/global.service.ts +461 -461
  312. package/src/_services/core/service-collection.service.spec.ts +46 -46
  313. package/src/_services/core/service-collection.service.ts +6 -6
  314. package/src/_services/route/controller.service.spec.ts +53 -53
  315. package/src/_services/route/controller.service.ts +148 -148
  316. package/src/_services/route/routing-module.service.spec.ts +98 -98
  317. package/src/_services/route/routing-module.service.ts +330 -330
  318. package/src/_services/server/app.server.ts +1726 -1726
  319. package/src/_services/shared.static-service.spec.ts +99 -99
  320. package/src/_services/shared.static-service.ts +78 -78
  321. package/src/index.ts +96 -96
  322. package/tsconfig.app.json +12 -12
  323. package/tsconfig.json +42 -42
@@ -1,674 +1,674 @@
1
-
2
- import { DyNTS_DataService } from './data.service';
3
- import { DyNTS_DBService } from './db.service';
4
- import { DyNTS_GlobalService } from '../core/global.service';
5
- import { DyNTS_ArchiveDataService } from './archive-data.service';
6
- import { DyFM_Metadata, DyFM_DataModel_Params, DyFM_Error, DyFM_DBFilter, DyFM_SearchQuery, DyFM_BasicProperty_Type, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
7
- import { DyNTS_global_settings } from '../../_collections/global-settings.const';
8
-
9
- // Initialize global settings before any test runs
10
- beforeAll(() => {
11
- if (!DyNTS_global_settings.systemShortCodeName) {
12
- (DyNTS_global_settings as any).systemShortCodeName = 'TEST';
13
- }
14
- if (!DyNTS_global_settings.env_settings) {
15
- (DyNTS_global_settings as any).env_settings = {
16
- environment: DyFM_EnvironmentFlag.local,
17
- };
18
- }
19
- });
20
-
21
- class TestMetadata extends DyFM_Metadata {
22
- name: string;
23
- email?: string;
24
- userId?: string;
25
- }
26
-
27
- const testDataParams = new DyFM_DataModel_Params<TestMetadata>({
28
- dataName: 'test_data',
29
- properties: {
30
- name: {
31
- key: 'name',
32
- type: DyFM_BasicProperty_Type.string,
33
- required: true,
34
- },
35
- email: {
36
- key: 'email',
37
- type: DyFM_BasicProperty_Type.string,
38
- },
39
- userId: {
40
- key: 'userId',
41
- type: DyFM_BasicProperty_Type.string,
42
- dependencyDataName: 'user_data',
43
- },
44
- },
45
- });
46
-
47
- describe('| DyNTS_DataService', () => {
48
- let mockDBService: jasmine.SpyObj<DyNTS_DBService<TestMetadata>>;
49
- let service: DyNTS_DataService<TestMetadata>;
50
- let testData: TestMetadata;
51
-
52
- beforeEach(() => {
53
- testData = new TestMetadata({
54
- _id: 'test-id-123',
55
- name: 'Test Name',
56
- email: 'test@example.com',
57
- } as TestMetadata);
58
-
59
- mockDBService = jasmine.createSpyObj('DyNTS_DBService', [
60
- 'getAll',
61
- 'getDataById',
62
- 'getDataListByIds',
63
- 'getDataByDependencyId',
64
- 'getDataListByDependencyIds',
65
- 'getDataListByDependencyId',
66
- 'findOne',
67
- 'find',
68
- 'updateOne',
69
- 'createData',
70
- 'modifyData',
71
- 'markDeletedById',
72
- 'trueDeleteDataById',
73
- 'trueDeleteAllData',
74
- 'restoreDeletedById',
75
- ]);
76
-
77
- spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService);
78
- spyOn(DyNTS_GlobalService, 'getDBServiceByKey').and.returnValue(mockDBService);
79
-
80
- service = new DyNTS_DataService<TestMetadata>(
81
- testData,
82
- testDataParams,
83
- 'test-issuer'
84
- );
85
- });
86
-
87
- it('| should create service instance', () => {
88
- expect(service).toBeDefined();
89
- expect(service.data).toBe(testData);
90
- expect(service.dataParams).toBe(testDataParams);
91
- expect(service.issuer).toBe('test-issuer');
92
- expect(service.dataDBService).toBe(mockDBService);
93
- });
94
-
95
- it('| should set service name from constructor', () => {
96
- expect(service.serviceName).toBe('DyNTS_DataService');
97
- });
98
-
99
- it('| should have default error messages', () => {
100
- expect(service.defaultErrorUserMsg).toContain('Data Service Error');
101
- expect(service.defaultValidationErrorUserMsg).toContain('Validation Error');
102
- });
103
-
104
- it('| should throw error when DB service not found', () => {
105
- (DyNTS_GlobalService.getDBService as jasmine.Spy).and.throwError('DB Service not found');
106
-
107
- expect(() => {
108
- new DyNTS_DataService<TestMetadata>(testData, testDataParams, 'test-issuer');
109
- }).toThrow();
110
- });
111
-
112
- describe('| getAll', () => {
113
- it('| should get all data from database', async () => {
114
- const mockDataList = [testData, { ...testData, _id: 'test-id-456' }];
115
- mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
116
-
117
- const result = await service.getAll();
118
-
119
- expect(result).toEqual(mockDataList);
120
- expect(service.dataList).toEqual(mockDataList);
121
- expect(mockDBService.getAll).toHaveBeenCalled();
122
- });
123
-
124
- it('| should not set to service when dontSetToService is true', async () => {
125
- const mockDataList = [testData];
126
- mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
127
-
128
- const result = await service.getAll(true);
129
-
130
- expect(result).toEqual(mockDataList);
131
- expect(service.dataList).not.toEqual(mockDataList);
132
- });
133
- });
134
-
135
- describe('| getDataById', () => {
136
- it('| should get data by id', async () => {
137
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
138
-
139
- const result = await service.getDataById('test-id-123');
140
-
141
- expect(result).toBe(testData);
142
- expect(service.data).toBe(testData);
143
- expect(mockDBService.getDataById).toHaveBeenCalledWith('test-id-123');
144
- });
145
-
146
- it('| should use data._id when id not provided', async () => {
147
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
148
-
149
- const result = await service.getDataById();
150
-
151
- expect(mockDBService.getDataById).toHaveBeenCalledWith('test-id-123');
152
- });
153
-
154
- it('| should throw error when id is missing', async () => {
155
- service.data = new TestMetadata({});
156
-
157
- await expectAsync(
158
- service.getDataById()
159
- ).toBeRejected();
160
- });
161
-
162
- it('| should load from archive when not found and archive enabled', async () => {
163
- service.haveArchiveDataService = true;
164
- mockDBService.getDataById.and.returnValue(Promise.resolve(null));
165
- const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['getDataByOriginalId']);
166
- mockArchiveService.getDataByOriginalId.and.returnValue(Promise.resolve(testData));
167
- spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
168
-
169
- const result = await service.getDataById('test-id-123');
170
-
171
- expect(result).toBe(testData);
172
- expect(mockArchiveService.getDataByOriginalId).toHaveBeenCalled();
173
- });
174
-
175
- it('| should not load from archive when skipArchiveLoad is true', async () => {
176
- service.haveArchiveDataService = true;
177
- mockDBService.getDataById.and.returnValue(Promise.resolve(null));
178
- spyOn(service, 'getArchiveDataService');
179
-
180
- const result = await service.getDataById('test-id-123', false, true);
181
-
182
- expect(result).toBeNull();
183
- expect(service.getArchiveDataService).not.toHaveBeenCalled();
184
- });
185
- });
186
-
187
- describe('| getDataByIds', () => {
188
- it('| should get data by ids', async () => {
189
- const ids = ['id-1', 'id-2'];
190
- const mockDataList = [testData, { ...testData, _id: 'id-2' }];
191
- mockDBService.find.and.returnValue(Promise.resolve(mockDataList));
192
-
193
- const result = await service.getDataByIds(ids);
194
-
195
- expect(result).toEqual(mockDataList);
196
- expect(mockDBService.find).toHaveBeenCalledWith({ _id: { $in: ids } });
197
- });
198
-
199
- it('| should throw error when ids is missing', async () => {
200
- await expectAsync(
201
- service.getDataByIds(null as any)
202
- ).toBeRejected();
203
- });
204
-
205
- it('| should return empty array when ids is empty array', async () => {
206
- const result = await service.getDataByIds([]);
207
-
208
- expect(result).toEqual([]);
209
- });
210
- });
211
-
212
- describe('| getDataListByIds', () => {
213
- it('| should get data list by ids', async () => {
214
- const ids = ['id-1', 'id-2'];
215
- const mockDataList = [testData, { ...testData, _id: 'id-2' }];
216
- mockDBService.getDataListByIds.and.returnValue(Promise.resolve(mockDataList));
217
-
218
- const result = await service.getDataListByIds(ids);
219
-
220
- expect(result).toEqual(mockDataList);
221
- expect(service.dataList).toEqual(mockDataList);
222
- });
223
- });
224
-
225
- describe('| getDataByDependencyId', () => {
226
- it('| should get data by dependency id', async () => {
227
- const dependencyData = { ...testData, userId: 'user-123' };
228
- mockDBService.getDataByDependencyId.and.returnValue(Promise.resolve(dependencyData));
229
-
230
- const result = await service.getDataByDependencyId('user-123');
231
-
232
- expect(result).toBe(dependencyData);
233
- expect(service.data).toBe(dependencyData);
234
- });
235
-
236
- it('| should throw error when dependency settings not configured', async () => {
237
- const serviceWithoutDeps = new DyNTS_DataService<TestMetadata>(
238
- testData,
239
- new DyFM_DataModel_Params<TestMetadata>({
240
- dataName: 'test_data',
241
- properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
242
- }),
243
- 'test-issuer'
244
- );
245
-
246
- await expectAsync(
247
- serviceWithoutDeps.getDataByDependencyId('user-123')
248
- ).toBeRejected();
249
- });
250
- });
251
-
252
- describe('| findData', () => {
253
- it('| should find data by filter', async () => {
254
- const filter: DyFM_DBFilter<TestMetadata> = { email: 'test@example.com' };
255
- mockDBService.findOne.and.returnValue(Promise.resolve(testData));
256
-
257
- const result = await service.findData(filter);
258
-
259
- expect(result).toBe(testData);
260
- expect(service.data).toBe(testData);
261
- expect(mockDBService.findOne).toHaveBeenCalledWith(filter);
262
- });
263
- });
264
-
265
- describe('| findDataList', () => {
266
- it('| should find data list by filter', async () => {
267
- const filter: DyFM_DBFilter<TestMetadata> = { name: 'Test' };
268
- const mockDataList = [testData];
269
- mockDBService.find.and.returnValue(Promise.resolve(mockDataList));
270
-
271
- const result = await service.findDataList(filter);
272
-
273
- expect(result).toEqual(mockDataList);
274
- expect(service.dataList).toEqual(mockDataList);
275
- });
276
- });
277
-
278
- describe('| updateData', () => {
279
- it('| should update data by filterBy', async () => {
280
- const filter: DyFM_DBFilter<TestMetadata> = { email: 'test@example.com' };
281
- const update = { name: 'Updated Name' };
282
- mockDBService.updateOne.and.returnValue(Promise.resolve());
283
-
284
- await service.updateData({ filterBy: filter, update });
285
-
286
- expect(mockDBService.updateOne).toHaveBeenCalledWith(
287
- filter,
288
- update,
289
- 'test-issuer',
290
- undefined
291
- );
292
- });
293
-
294
- it('| should update data by data._id', async () => {
295
- const update = { name: 'Updated Name' };
296
- mockDBService.updateOne.and.returnValue(Promise.resolve());
297
-
298
- await service.updateData({ update });
299
-
300
- expect(mockDBService.updateOne).toHaveBeenCalledWith(
301
- { _id: 'test-id-123' } as any,
302
- update,
303
- 'test-issuer',
304
- undefined
305
- );
306
- });
307
-
308
- it('| should throw error when no usable parameter provided', async () => {
309
- service.data = new TestMetadata({});
310
- const update = { name: 'Updated Name' };
311
-
312
- await expectAsync(
313
- service.updateData({ update })
314
- ).toBeRejected();
315
- });
316
- });
317
-
318
- describe('| saveData', () => {
319
- it('| should modify existing data when _id is present', async () => {
320
- const existingData = { ...testData, name: 'Updated Name' };
321
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
322
- mockDBService.modifyData.and.returnValue(Promise.resolve(existingData));
323
- spyOn(service, 'validateForSave').and.returnValue(Promise.resolve());
324
-
325
- const result = await service.saveData(existingData);
326
-
327
- expect(result).toBe(existingData);
328
- expect(mockDBService.modifyData).toHaveBeenCalled();
329
- });
330
-
331
- it('| should throw error when data with _id does not exist', async () => {
332
- const dataWithId = { ...testData, _id: 'non-existent-id' };
333
- mockDBService.getDataById.and.returnValue(Promise.resolve(null));
334
- spyOn(service, 'validateForSave').and.returnValue(Promise.resolve());
335
-
336
- await expectAsync(
337
- service.saveData(dataWithId)
338
- ).toBeRejected();
339
- });
340
- });
341
-
342
- describe('| deleteData', () => {
343
- it('| should delete data by id', async () => {
344
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
345
- mockDBService.markDeletedById.and.returnValue(Promise.resolve());
346
-
347
- await service.deleteData('test-id-123');
348
-
349
- expect(mockDBService.markDeletedById).toHaveBeenCalledWith('test-id-123', 'test-issuer');
350
- });
351
-
352
- it('| should use data._id when id not provided', async () => {
353
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
354
- mockDBService.markDeletedById.and.returnValue(Promise.resolve());
355
-
356
- await service.deleteData();
357
-
358
- expect(mockDBService.markDeletedById).toHaveBeenCalledWith('test-id-123', 'test-issuer');
359
- });
360
-
361
- it('| should throw error when id is missing', async () => {
362
- service.data = new TestMetadata({});
363
-
364
- await expectAsync(
365
- service.deleteData()
366
- ).toBeRejected();
367
- });
368
-
369
- it('| should archive data when archive service enabled', async () => {
370
- service.haveArchiveDataService = true;
371
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
372
- mockDBService.trueDeleteDataById.and.returnValue(Promise.resolve());
373
- const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['saveData']);
374
- mockArchiveService.saveData.and.returnValue(Promise.resolve());
375
- spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
376
-
377
- await service.deleteData('test-id-123');
378
-
379
- expect(mockDBService.trueDeleteDataById).toHaveBeenCalled();
380
- expect(mockArchiveService.saveData).toHaveBeenCalled();
381
- });
382
-
383
- it('| should permanently delete when absolute is true', async () => {
384
- mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
385
- mockDBService.trueDeleteDataById.and.returnValue(Promise.resolve());
386
-
387
- await service.deleteData('test-id-123', true);
388
-
389
- expect(mockDBService.trueDeleteDataById).toHaveBeenCalledWith('test-id-123');
390
- });
391
- });
392
-
393
- describe('| deleteAllData', () => {
394
- it('| should delete all data', async () => {
395
- const mockDataList = [testData, { ...testData, _id: 'id-2' }];
396
- mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
397
- mockDBService.markDeletedById.and.returnValue(Promise.resolve());
398
-
399
- await service.deleteAllData();
400
-
401
- expect(mockDBService.markDeletedById).toHaveBeenCalledTimes(2);
402
- });
403
-
404
- it('| should archive all data when archive service enabled', async () => {
405
- service.haveArchiveDataService = true;
406
- const mockDataList = [testData];
407
- mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
408
- mockDBService.trueDeleteAllData.and.returnValue(Promise.resolve());
409
- const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['saveData']);
410
- mockArchiveService.saveData.and.returnValue(Promise.resolve());
411
- spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
412
-
413
- await service.deleteAllData();
414
-
415
- expect(mockDBService.trueDeleteAllData).toHaveBeenCalled();
416
- expect(mockArchiveService.saveData).toHaveBeenCalled();
417
- });
418
- });
419
-
420
- describe('| searchData', () => {
421
- it('| should search data with query', async () => {
422
- const query: DyFM_SearchQuery<TestMetadata> = {
423
- filterBy: { name: 'Test' },
424
- page: 0,
425
- pageSize: 10,
426
- sortBy: [{ key: 'name', order: 1 }],
427
- };
428
- const mockDataList = [testData];
429
- spyOn(service, 'sortAndFilterDataList').and.returnValue(Promise.resolve({
430
- results: mockDataList,
431
- totalItems: 1,
432
- }));
433
-
434
- const result = await service.searchData(query);
435
-
436
- expect(result.results).toEqual(mockDataList);
437
- expect(service.sortAndFilterDataList).toHaveBeenCalledWith(query, undefined);
438
- });
439
-
440
- it('| should apply pagination', async () => {
441
- const query: DyFM_SearchQuery<TestMetadata> = {
442
- page: 1,
443
- pageSize: 2,
444
- };
445
- const mockResults = [
446
- testData,
447
- { ...testData, _id: 'id-2' },
448
- { ...testData, _id: 'id-3' },
449
- ];
450
- spyOn(service, 'sortAndFilterDataList').and.returnValue(Promise.resolve({
451
- results: mockResults,
452
- totalItems: 3,
453
- }));
454
-
455
- const result = await service.searchData(query);
456
-
457
- expect(result.results.length).toBe(1);
458
- expect(result.results[0]._id).toBe('id-3');
459
- });
460
- });
461
-
462
- describe('| getArchiveDataService', () => {
463
- it('| should throw error when not implemented', () => {
464
- expect(() => {
465
- service.getArchiveDataService();
466
- }).toThrow();
467
- });
468
- });
469
-
470
- describe('| getDependencyDataDBService', () => {
471
- it('| should get dependency DB service when configured', () => {
472
- const depService = service.getDependencyDataDBService('user_data');
473
-
474
- expect(depService).toBeDefined();
475
- });
476
-
477
- it('| should throw error when service key not set', () => {
478
- const serviceWithoutDeps = new DyNTS_DataService<TestMetadata>(
479
- testData,
480
- new DyFM_DataModel_Params<TestMetadata>({
481
- dataName: 'test_data',
482
- properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
483
- }),
484
- 'test-issuer'
485
- );
486
-
487
- expect(() => {
488
- serviceWithoutDeps.getDependencyDataDBService();
489
- }).toThrow();
490
- });
491
- });
492
-
493
- // ════════════════════════════════════════════════════════════════════════
494
- // FR-001 — Generic compareData()
495
- // ════════════════════════════════════════════════════════════════════════
496
-
497
- describe('| compareData() — FR-001', (): void => {
498
- let svc: DyNTS_DataService<TestMetadata>;
499
-
500
- beforeEach((): void => {
501
- // Re-use existing TestMetadata + testDataParams.
502
- const t: TestMetadata = new TestMetadata();
503
- svc = new DyNTS_DataService<TestMetadata>(t, testDataParams, 'test-issuer');
504
- });
505
-
506
- it('| equal POJO returns { result: "equal" } — sin changedFields', (): void => {
507
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
508
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
509
- const r = svc.compareData(a, b);
510
- expect(r.result).toBe('equal');
511
- expect(r.changedFields).toBeUndefined();
512
- });
513
-
514
- it('| modified single field — changedFields tartalmazza azt', (): void => {
515
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
516
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'bob', email: 'a@x' });
517
- const r = svc.compareData(a, b);
518
- expect(r.result).toBe('modified');
519
- expect(r.changedFields).toEqual(['name']);
520
- });
521
-
522
- it('| modified multi-field — changedFields TELJES listat ad (nem early-return)', (): void => {
523
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x', userId: 'u1' });
524
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'bob', email: 'b@y', userId: 'u2' });
525
- const r = svc.compareData(a, b);
526
- expect(r.result).toBe('modified');
527
- expect(r.changedFields?.sort()).toEqual(['email', 'name', 'userId'] as any);
528
- });
529
-
530
- it('| auto-discovery SKIP-eli a metadata fields-et (_id, __created, __lastModified)', (): void => {
531
- const now: Date = new Date();
532
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'X', __created: now, __lastModified: now });
533
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'Y', __created: new Date(2000, 0, 1), __lastModified: new Date(2001, 0, 1) });
534
- const r = svc.compareData(a, b);
535
- expect(r.result).toBe('equal');
536
- });
537
-
538
- it('| explicit fields override — KIFEJEZETT _id-val VIZSGALJA a skip-listet is', (): void => {
539
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'X' });
540
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'Y' });
541
- const r = svc.compareData(a, b, { fields: ['_id' as keyof TestMetadata] });
542
- expect(r.result).toBe('modified');
543
- expect(r.changedFields).toEqual(['_id' as keyof TestMetadata]);
544
- });
545
-
546
- it('| explicit fields scope-szukit — csak a listazott fields szamit', (): void => {
547
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
548
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'b@y' });
549
- const r = svc.compareData(a, b, { fields: ['name'] });
550
- expect(r.result).toBe('equal'); // email change ignored, only 'name' checked
551
- });
552
-
553
- it('| customComparator override (case-insensitive string)', (): void => {
554
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'Alice' });
555
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
556
- const r = svc.compareData(a, b, {
557
- customComparators: { name: (x: string, y: string) => x.toLowerCase() === y.toLowerCase() },
558
- });
559
- expect(r.result).toBe('equal');
560
- });
561
-
562
- it('| customComparator — array-set-equality eltero sorrendre', (): void => {
563
- class WithArr extends DyFM_Metadata {
564
- name?: string;
565
- tags?: string[];
566
- }
567
- const arrSvc = new DyNTS_DataService<WithArr>(
568
- new WithArr(),
569
- new DyFM_DataModel_Params<WithArr>({
570
- dataName: 'with_arr',
571
- properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
572
- }),
573
- 'test-issuer',
574
- );
575
- const a: WithArr = Object.assign(new WithArr(), { name: 'x', tags: ['a', 'b', 'c'] });
576
- const b: WithArr = Object.assign(new WithArr(), { name: 'x', tags: ['c', 'b', 'a'] });
577
- const r = arrSvc.compareData(a, b, {
578
- customComparators: {
579
- tags: (x: string[], y: string[]) => {
580
- const s: Set<string> = new Set<string>(x);
581
- return y.length === x.length && y.every((v: string) => s.has(v));
582
- },
583
- },
584
- });
585
- expect(r.result).toBe('equal');
586
- });
587
-
588
- it('| deep-equal: Date instances ugyanazon time-stamp-pel equal-nek szamitanak', (): void => {
589
- class WithDate extends DyFM_Metadata {
590
- when?: Date;
591
- }
592
- const dateSvc = new DyNTS_DataService<WithDate>(
593
- new WithDate(),
594
- new DyFM_DataModel_Params<WithDate>({
595
- dataName: 'with_date',
596
- properties: {},
597
- }),
598
- 'test-issuer',
599
- );
600
- const t: number = 1_700_000_000_000;
601
- const a: WithDate = Object.assign(new WithDate(), { when: new Date(t) });
602
- const b: WithDate = Object.assign(new WithDate(), { when: new Date(t) });
603
- expect(dateSvc.compareData(a, b).result).toBe('equal');
604
- });
605
-
606
- it('| deep-equal: nested object', (): void => {
607
- class WithNested extends DyFM_Metadata {
608
- nested?: { a: number; b: { c: string } };
609
- }
610
- const nSvc = new DyNTS_DataService<WithNested>(
611
- new WithNested(),
612
- new DyFM_DataModel_Params<WithNested>({ dataName: 'with_nested', properties: {} }),
613
- 'test-issuer',
614
- );
615
- const a: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'x' } } });
616
- const b: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'x' } } });
617
- const c: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'y' } } });
618
- expect(nSvc.compareData(a, b).result).toBe('equal');
619
- expect(nSvc.compareData(a, c).result).toBe('modified');
620
- });
621
-
622
- it('| deep-equal: array index-szerinti compare (eltero sorrend → modified default-ban)', (): void => {
623
- class WithArr2 extends DyFM_Metadata {
624
- items?: number[];
625
- }
626
- const aSvc = new DyNTS_DataService<WithArr2>(
627
- new WithArr2(),
628
- new DyFM_DataModel_Params<WithArr2>({ dataName: 'with_arr2', properties: {} }),
629
- 'test-issuer',
630
- );
631
- const a: WithArr2 = Object.assign(new WithArr2(), { items: [1, 2, 3] });
632
- const b: WithArr2 = Object.assign(new WithArr2(), { items: [1, 2, 3] });
633
- const c: WithArr2 = Object.assign(new WithArr2(), { items: [3, 2, 1] });
634
- expect(aSvc.compareData(a, b).result).toBe('equal');
635
- expect(aSvc.compareData(a, c).result).toBe('modified');
636
- });
637
-
638
- it('| throw 400 ha newData null', (): void => {
639
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'x' });
640
- let thrown: any = null;
641
- try { svc.compareData(null as any, b); } catch (e) { thrown = e; }
642
- expect(thrown).not.toBeNull();
643
- expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
644
- expect(DyFM_Error.getErrorCode(thrown)).toContain('DyNTS-DS0-CD1');
645
- });
646
-
647
- it('| throw 400 ha oldData undefined', (): void => {
648
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'x' });
649
- let thrown: any = null;
650
- try { svc.compareData(a, undefined as any); } catch (e) { thrown = e; }
651
- expect(thrown).not.toBeNull();
652
- expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
653
- });
654
-
655
- it('| throw 400 ha options.fields ures array', (): void => {
656
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
657
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
658
- let thrown: any = null;
659
- try { svc.compareData(a, b, { fields: [] }); } catch (e) { thrown = e; }
660
- expect(thrown).not.toBeNull();
661
- expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
662
- expect(DyFM_Error.getErrorCode(thrown)).toContain('DyNTS-DS0-CD2');
663
- });
664
-
665
- it('| asymmetric keys: ha az egyik objektum-bol hianyzik a key, modified-nek szamit', (): void => {
666
- const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
667
- const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' }); // no email
668
- const r = svc.compareData(a, b);
669
- expect(r.result).toBe('modified');
670
- expect(r.changedFields).toEqual(['email']);
671
- });
672
- });
673
- });
674
-
1
+
2
+ import { DyNTS_DataService } from './data.service';
3
+ import { DyNTS_DBService } from './db.service';
4
+ import { DyNTS_GlobalService } from '../core/global.service';
5
+ import { DyNTS_ArchiveDataService } from './archive-data.service';
6
+ import { DyFM_Metadata, DyFM_DataModel_Params, DyFM_Error, DyFM_DBFilter, DyFM_SearchQuery, DyFM_BasicProperty_Type, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
7
+ import { DyNTS_global_settings } from '../../_collections/global-settings.const';
8
+
9
+ // Initialize global settings before any test runs
10
+ beforeAll(() => {
11
+ if (!DyNTS_global_settings.systemShortCodeName) {
12
+ (DyNTS_global_settings as any).systemShortCodeName = 'TEST';
13
+ }
14
+ if (!DyNTS_global_settings.env_settings) {
15
+ (DyNTS_global_settings as any).env_settings = {
16
+ environment: DyFM_EnvironmentFlag.local,
17
+ };
18
+ }
19
+ });
20
+
21
+ class TestMetadata extends DyFM_Metadata {
22
+ name: string;
23
+ email?: string;
24
+ userId?: string;
25
+ }
26
+
27
+ const testDataParams = new DyFM_DataModel_Params<TestMetadata>({
28
+ dataName: 'test_data',
29
+ properties: {
30
+ name: {
31
+ key: 'name',
32
+ type: DyFM_BasicProperty_Type.string,
33
+ required: true,
34
+ },
35
+ email: {
36
+ key: 'email',
37
+ type: DyFM_BasicProperty_Type.string,
38
+ },
39
+ userId: {
40
+ key: 'userId',
41
+ type: DyFM_BasicProperty_Type.string,
42
+ dependencyDataName: 'user_data',
43
+ },
44
+ },
45
+ });
46
+
47
+ describe('| DyNTS_DataService', () => {
48
+ let mockDBService: jasmine.SpyObj<DyNTS_DBService<TestMetadata>>;
49
+ let service: DyNTS_DataService<TestMetadata>;
50
+ let testData: TestMetadata;
51
+
52
+ beforeEach(() => {
53
+ testData = new TestMetadata({
54
+ _id: 'test-id-123',
55
+ name: 'Test Name',
56
+ email: 'test@example.com',
57
+ } as TestMetadata);
58
+
59
+ mockDBService = jasmine.createSpyObj('DyNTS_DBService', [
60
+ 'getAll',
61
+ 'getDataById',
62
+ 'getDataListByIds',
63
+ 'getDataByDependencyId',
64
+ 'getDataListByDependencyIds',
65
+ 'getDataListByDependencyId',
66
+ 'findOne',
67
+ 'find',
68
+ 'updateOne',
69
+ 'createData',
70
+ 'modifyData',
71
+ 'markDeletedById',
72
+ 'trueDeleteDataById',
73
+ 'trueDeleteAllData',
74
+ 'restoreDeletedById',
75
+ ]);
76
+
77
+ spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService);
78
+ spyOn(DyNTS_GlobalService, 'getDBServiceByKey').and.returnValue(mockDBService);
79
+
80
+ service = new DyNTS_DataService<TestMetadata>(
81
+ testData,
82
+ testDataParams,
83
+ 'test-issuer'
84
+ );
85
+ });
86
+
87
+ it('| should create service instance', () => {
88
+ expect(service).toBeDefined();
89
+ expect(service.data).toBe(testData);
90
+ expect(service.dataParams).toBe(testDataParams);
91
+ expect(service.issuer).toBe('test-issuer');
92
+ expect(service.dataDBService).toBe(mockDBService);
93
+ });
94
+
95
+ it('| should set service name from constructor', () => {
96
+ expect(service.serviceName).toBe('DyNTS_DataService');
97
+ });
98
+
99
+ it('| should have default error messages', () => {
100
+ expect(service.defaultErrorUserMsg).toContain('Data Service Error');
101
+ expect(service.defaultValidationErrorUserMsg).toContain('Validation Error');
102
+ });
103
+
104
+ it('| should throw error when DB service not found', () => {
105
+ (DyNTS_GlobalService.getDBService as jasmine.Spy).and.throwError('DB Service not found');
106
+
107
+ expect(() => {
108
+ new DyNTS_DataService<TestMetadata>(testData, testDataParams, 'test-issuer');
109
+ }).toThrow();
110
+ });
111
+
112
+ describe('| getAll', () => {
113
+ it('| should get all data from database', async () => {
114
+ const mockDataList = [testData, { ...testData, _id: 'test-id-456' }];
115
+ mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
116
+
117
+ const result = await service.getAll();
118
+
119
+ expect(result).toEqual(mockDataList);
120
+ expect(service.dataList).toEqual(mockDataList);
121
+ expect(mockDBService.getAll).toHaveBeenCalled();
122
+ });
123
+
124
+ it('| should not set to service when dontSetToService is true', async () => {
125
+ const mockDataList = [testData];
126
+ mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
127
+
128
+ const result = await service.getAll(true);
129
+
130
+ expect(result).toEqual(mockDataList);
131
+ expect(service.dataList).not.toEqual(mockDataList);
132
+ });
133
+ });
134
+
135
+ describe('| getDataById', () => {
136
+ it('| should get data by id', async () => {
137
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
138
+
139
+ const result = await service.getDataById('test-id-123');
140
+
141
+ expect(result).toBe(testData);
142
+ expect(service.data).toBe(testData);
143
+ expect(mockDBService.getDataById).toHaveBeenCalledWith('test-id-123');
144
+ });
145
+
146
+ it('| should use data._id when id not provided', async () => {
147
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
148
+
149
+ const result = await service.getDataById();
150
+
151
+ expect(mockDBService.getDataById).toHaveBeenCalledWith('test-id-123');
152
+ });
153
+
154
+ it('| should throw error when id is missing', async () => {
155
+ service.data = new TestMetadata({});
156
+
157
+ await expectAsync(
158
+ service.getDataById()
159
+ ).toBeRejected();
160
+ });
161
+
162
+ it('| should load from archive when not found and archive enabled', async () => {
163
+ service.haveArchiveDataService = true;
164
+ mockDBService.getDataById.and.returnValue(Promise.resolve(null));
165
+ const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['getDataByOriginalId']);
166
+ mockArchiveService.getDataByOriginalId.and.returnValue(Promise.resolve(testData));
167
+ spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
168
+
169
+ const result = await service.getDataById('test-id-123');
170
+
171
+ expect(result).toBe(testData);
172
+ expect(mockArchiveService.getDataByOriginalId).toHaveBeenCalled();
173
+ });
174
+
175
+ it('| should not load from archive when skipArchiveLoad is true', async () => {
176
+ service.haveArchiveDataService = true;
177
+ mockDBService.getDataById.and.returnValue(Promise.resolve(null));
178
+ spyOn(service, 'getArchiveDataService');
179
+
180
+ const result = await service.getDataById('test-id-123', false, true);
181
+
182
+ expect(result).toBeNull();
183
+ expect(service.getArchiveDataService).not.toHaveBeenCalled();
184
+ });
185
+ });
186
+
187
+ describe('| getDataByIds', () => {
188
+ it('| should get data by ids', async () => {
189
+ const ids = ['id-1', 'id-2'];
190
+ const mockDataList = [testData, { ...testData, _id: 'id-2' }];
191
+ mockDBService.find.and.returnValue(Promise.resolve(mockDataList));
192
+
193
+ const result = await service.getDataByIds(ids);
194
+
195
+ expect(result).toEqual(mockDataList);
196
+ expect(mockDBService.find).toHaveBeenCalledWith({ _id: { $in: ids } });
197
+ });
198
+
199
+ it('| should throw error when ids is missing', async () => {
200
+ await expectAsync(
201
+ service.getDataByIds(null as any)
202
+ ).toBeRejected();
203
+ });
204
+
205
+ it('| should return empty array when ids is empty array', async () => {
206
+ const result = await service.getDataByIds([]);
207
+
208
+ expect(result).toEqual([]);
209
+ });
210
+ });
211
+
212
+ describe('| getDataListByIds', () => {
213
+ it('| should get data list by ids', async () => {
214
+ const ids = ['id-1', 'id-2'];
215
+ const mockDataList = [testData, { ...testData, _id: 'id-2' }];
216
+ mockDBService.getDataListByIds.and.returnValue(Promise.resolve(mockDataList));
217
+
218
+ const result = await service.getDataListByIds(ids);
219
+
220
+ expect(result).toEqual(mockDataList);
221
+ expect(service.dataList).toEqual(mockDataList);
222
+ });
223
+ });
224
+
225
+ describe('| getDataByDependencyId', () => {
226
+ it('| should get data by dependency id', async () => {
227
+ const dependencyData = { ...testData, userId: 'user-123' };
228
+ mockDBService.getDataByDependencyId.and.returnValue(Promise.resolve(dependencyData));
229
+
230
+ const result = await service.getDataByDependencyId('user-123');
231
+
232
+ expect(result).toBe(dependencyData);
233
+ expect(service.data).toBe(dependencyData);
234
+ });
235
+
236
+ it('| should throw error when dependency settings not configured', async () => {
237
+ const serviceWithoutDeps = new DyNTS_DataService<TestMetadata>(
238
+ testData,
239
+ new DyFM_DataModel_Params<TestMetadata>({
240
+ dataName: 'test_data',
241
+ properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
242
+ }),
243
+ 'test-issuer'
244
+ );
245
+
246
+ await expectAsync(
247
+ serviceWithoutDeps.getDataByDependencyId('user-123')
248
+ ).toBeRejected();
249
+ });
250
+ });
251
+
252
+ describe('| findData', () => {
253
+ it('| should find data by filter', async () => {
254
+ const filter: DyFM_DBFilter<TestMetadata> = { email: 'test@example.com' };
255
+ mockDBService.findOne.and.returnValue(Promise.resolve(testData));
256
+
257
+ const result = await service.findData(filter);
258
+
259
+ expect(result).toBe(testData);
260
+ expect(service.data).toBe(testData);
261
+ expect(mockDBService.findOne).toHaveBeenCalledWith(filter);
262
+ });
263
+ });
264
+
265
+ describe('| findDataList', () => {
266
+ it('| should find data list by filter', async () => {
267
+ const filter: DyFM_DBFilter<TestMetadata> = { name: 'Test' };
268
+ const mockDataList = [testData];
269
+ mockDBService.find.and.returnValue(Promise.resolve(mockDataList));
270
+
271
+ const result = await service.findDataList(filter);
272
+
273
+ expect(result).toEqual(mockDataList);
274
+ expect(service.dataList).toEqual(mockDataList);
275
+ });
276
+ });
277
+
278
+ describe('| updateData', () => {
279
+ it('| should update data by filterBy', async () => {
280
+ const filter: DyFM_DBFilter<TestMetadata> = { email: 'test@example.com' };
281
+ const update = { name: 'Updated Name' };
282
+ mockDBService.updateOne.and.returnValue(Promise.resolve());
283
+
284
+ await service.updateData({ filterBy: filter, update });
285
+
286
+ expect(mockDBService.updateOne).toHaveBeenCalledWith(
287
+ filter,
288
+ update,
289
+ 'test-issuer',
290
+ undefined
291
+ );
292
+ });
293
+
294
+ it('| should update data by data._id', async () => {
295
+ const update = { name: 'Updated Name' };
296
+ mockDBService.updateOne.and.returnValue(Promise.resolve());
297
+
298
+ await service.updateData({ update });
299
+
300
+ expect(mockDBService.updateOne).toHaveBeenCalledWith(
301
+ { _id: 'test-id-123' } as any,
302
+ update,
303
+ 'test-issuer',
304
+ undefined
305
+ );
306
+ });
307
+
308
+ it('| should throw error when no usable parameter provided', async () => {
309
+ service.data = new TestMetadata({});
310
+ const update = { name: 'Updated Name' };
311
+
312
+ await expectAsync(
313
+ service.updateData({ update })
314
+ ).toBeRejected();
315
+ });
316
+ });
317
+
318
+ describe('| saveData', () => {
319
+ it('| should modify existing data when _id is present', async () => {
320
+ const existingData = { ...testData, name: 'Updated Name' };
321
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
322
+ mockDBService.modifyData.and.returnValue(Promise.resolve(existingData));
323
+ spyOn(service, 'validateForSave').and.returnValue(Promise.resolve());
324
+
325
+ const result = await service.saveData(existingData);
326
+
327
+ expect(result).toBe(existingData);
328
+ expect(mockDBService.modifyData).toHaveBeenCalled();
329
+ });
330
+
331
+ it('| should throw error when data with _id does not exist', async () => {
332
+ const dataWithId = { ...testData, _id: 'non-existent-id' };
333
+ mockDBService.getDataById.and.returnValue(Promise.resolve(null));
334
+ spyOn(service, 'validateForSave').and.returnValue(Promise.resolve());
335
+
336
+ await expectAsync(
337
+ service.saveData(dataWithId)
338
+ ).toBeRejected();
339
+ });
340
+ });
341
+
342
+ describe('| deleteData', () => {
343
+ it('| should delete data by id', async () => {
344
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
345
+ mockDBService.markDeletedById.and.returnValue(Promise.resolve());
346
+
347
+ await service.deleteData('test-id-123');
348
+
349
+ expect(mockDBService.markDeletedById).toHaveBeenCalledWith('test-id-123', 'test-issuer');
350
+ });
351
+
352
+ it('| should use data._id when id not provided', async () => {
353
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
354
+ mockDBService.markDeletedById.and.returnValue(Promise.resolve());
355
+
356
+ await service.deleteData();
357
+
358
+ expect(mockDBService.markDeletedById).toHaveBeenCalledWith('test-id-123', 'test-issuer');
359
+ });
360
+
361
+ it('| should throw error when id is missing', async () => {
362
+ service.data = new TestMetadata({});
363
+
364
+ await expectAsync(
365
+ service.deleteData()
366
+ ).toBeRejected();
367
+ });
368
+
369
+ it('| should archive data when archive service enabled', async () => {
370
+ service.haveArchiveDataService = true;
371
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
372
+ mockDBService.trueDeleteDataById.and.returnValue(Promise.resolve());
373
+ const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['saveData']);
374
+ mockArchiveService.saveData.and.returnValue(Promise.resolve());
375
+ spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
376
+
377
+ await service.deleteData('test-id-123');
378
+
379
+ expect(mockDBService.trueDeleteDataById).toHaveBeenCalled();
380
+ expect(mockArchiveService.saveData).toHaveBeenCalled();
381
+ });
382
+
383
+ it('| should permanently delete when absolute is true', async () => {
384
+ mockDBService.getDataById.and.returnValue(Promise.resolve(testData));
385
+ mockDBService.trueDeleteDataById.and.returnValue(Promise.resolve());
386
+
387
+ await service.deleteData('test-id-123', true);
388
+
389
+ expect(mockDBService.trueDeleteDataById).toHaveBeenCalledWith('test-id-123');
390
+ });
391
+ });
392
+
393
+ describe('| deleteAllData', () => {
394
+ it('| should delete all data', async () => {
395
+ const mockDataList = [testData, { ...testData, _id: 'id-2' }];
396
+ mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
397
+ mockDBService.markDeletedById.and.returnValue(Promise.resolve());
398
+
399
+ await service.deleteAllData();
400
+
401
+ expect(mockDBService.markDeletedById).toHaveBeenCalledTimes(2);
402
+ });
403
+
404
+ it('| should archive all data when archive service enabled', async () => {
405
+ service.haveArchiveDataService = true;
406
+ const mockDataList = [testData];
407
+ mockDBService.getAll.and.returnValue(Promise.resolve(mockDataList));
408
+ mockDBService.trueDeleteAllData.and.returnValue(Promise.resolve());
409
+ const mockArchiveService = jasmine.createSpyObj('DyNTS_ArchiveDataService', ['saveData']);
410
+ mockArchiveService.saveData.and.returnValue(Promise.resolve());
411
+ spyOn(service, 'getArchiveDataService').and.returnValue(mockArchiveService);
412
+
413
+ await service.deleteAllData();
414
+
415
+ expect(mockDBService.trueDeleteAllData).toHaveBeenCalled();
416
+ expect(mockArchiveService.saveData).toHaveBeenCalled();
417
+ });
418
+ });
419
+
420
+ describe('| searchData', () => {
421
+ it('| should search data with query', async () => {
422
+ const query: DyFM_SearchQuery<TestMetadata> = {
423
+ filterBy: { name: 'Test' },
424
+ page: 0,
425
+ pageSize: 10,
426
+ sortBy: [{ key: 'name', order: 1 }],
427
+ };
428
+ const mockDataList = [testData];
429
+ spyOn(service, 'sortAndFilterDataList').and.returnValue(Promise.resolve({
430
+ results: mockDataList,
431
+ totalItems: 1,
432
+ }));
433
+
434
+ const result = await service.searchData(query);
435
+
436
+ expect(result.results).toEqual(mockDataList);
437
+ expect(service.sortAndFilterDataList).toHaveBeenCalledWith(query, undefined);
438
+ });
439
+
440
+ it('| should apply pagination', async () => {
441
+ const query: DyFM_SearchQuery<TestMetadata> = {
442
+ page: 1,
443
+ pageSize: 2,
444
+ };
445
+ const mockResults = [
446
+ testData,
447
+ { ...testData, _id: 'id-2' },
448
+ { ...testData, _id: 'id-3' },
449
+ ];
450
+ spyOn(service, 'sortAndFilterDataList').and.returnValue(Promise.resolve({
451
+ results: mockResults,
452
+ totalItems: 3,
453
+ }));
454
+
455
+ const result = await service.searchData(query);
456
+
457
+ expect(result.results.length).toBe(1);
458
+ expect(result.results[0]._id).toBe('id-3');
459
+ });
460
+ });
461
+
462
+ describe('| getArchiveDataService', () => {
463
+ it('| should throw error when not implemented', () => {
464
+ expect(() => {
465
+ service.getArchiveDataService();
466
+ }).toThrow();
467
+ });
468
+ });
469
+
470
+ describe('| getDependencyDataDBService', () => {
471
+ it('| should get dependency DB service when configured', () => {
472
+ const depService = service.getDependencyDataDBService('user_data');
473
+
474
+ expect(depService).toBeDefined();
475
+ });
476
+
477
+ it('| should throw error when service key not set', () => {
478
+ const serviceWithoutDeps = new DyNTS_DataService<TestMetadata>(
479
+ testData,
480
+ new DyFM_DataModel_Params<TestMetadata>({
481
+ dataName: 'test_data',
482
+ properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
483
+ }),
484
+ 'test-issuer'
485
+ );
486
+
487
+ expect(() => {
488
+ serviceWithoutDeps.getDependencyDataDBService();
489
+ }).toThrow();
490
+ });
491
+ });
492
+
493
+ // ════════════════════════════════════════════════════════════════════════
494
+ // FR-001 — Generic compareData()
495
+ // ════════════════════════════════════════════════════════════════════════
496
+
497
+ describe('| compareData() — FR-001', (): void => {
498
+ let svc: DyNTS_DataService<TestMetadata>;
499
+
500
+ beforeEach((): void => {
501
+ // Re-use existing TestMetadata + testDataParams.
502
+ const t: TestMetadata = new TestMetadata();
503
+ svc = new DyNTS_DataService<TestMetadata>(t, testDataParams, 'test-issuer');
504
+ });
505
+
506
+ it('| equal POJO returns { result: "equal" } — sin changedFields', (): void => {
507
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
508
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
509
+ const r = svc.compareData(a, b);
510
+ expect(r.result).toBe('equal');
511
+ expect(r.changedFields).toBeUndefined();
512
+ });
513
+
514
+ it('| modified single field — changedFields tartalmazza azt', (): void => {
515
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
516
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'bob', email: 'a@x' });
517
+ const r = svc.compareData(a, b);
518
+ expect(r.result).toBe('modified');
519
+ expect(r.changedFields).toEqual(['name']);
520
+ });
521
+
522
+ it('| modified multi-field — changedFields TELJES listat ad (nem early-return)', (): void => {
523
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x', userId: 'u1' });
524
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'bob', email: 'b@y', userId: 'u2' });
525
+ const r = svc.compareData(a, b);
526
+ expect(r.result).toBe('modified');
527
+ expect(r.changedFields?.sort()).toEqual(['email', 'name', 'userId'] as any);
528
+ });
529
+
530
+ it('| auto-discovery SKIP-eli a metadata fields-et (_id, __created, __lastModified)', (): void => {
531
+ const now: Date = new Date();
532
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'X', __created: now, __lastModified: now });
533
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'Y', __created: new Date(2000, 0, 1), __lastModified: new Date(2001, 0, 1) });
534
+ const r = svc.compareData(a, b);
535
+ expect(r.result).toBe('equal');
536
+ });
537
+
538
+ it('| explicit fields override — KIFEJEZETT _id-val VIZSGALJA a skip-listet is', (): void => {
539
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'X' });
540
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', _id: 'Y' });
541
+ const r = svc.compareData(a, b, { fields: ['_id' as keyof TestMetadata] });
542
+ expect(r.result).toBe('modified');
543
+ expect(r.changedFields).toEqual(['_id' as keyof TestMetadata]);
544
+ });
545
+
546
+ it('| explicit fields scope-szukit — csak a listazott fields szamit', (): void => {
547
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
548
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'b@y' });
549
+ const r = svc.compareData(a, b, { fields: ['name'] });
550
+ expect(r.result).toBe('equal'); // email change ignored, only 'name' checked
551
+ });
552
+
553
+ it('| customComparator override (case-insensitive string)', (): void => {
554
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'Alice' });
555
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
556
+ const r = svc.compareData(a, b, {
557
+ customComparators: { name: (x: string, y: string) => x.toLowerCase() === y.toLowerCase() },
558
+ });
559
+ expect(r.result).toBe('equal');
560
+ });
561
+
562
+ it('| customComparator — array-set-equality eltero sorrendre', (): void => {
563
+ class WithArr extends DyFM_Metadata {
564
+ name?: string;
565
+ tags?: string[];
566
+ }
567
+ const arrSvc = new DyNTS_DataService<WithArr>(
568
+ new WithArr(),
569
+ new DyFM_DataModel_Params<WithArr>({
570
+ dataName: 'with_arr',
571
+ properties: { name: { key: 'name', type: DyFM_BasicProperty_Type.string } },
572
+ }),
573
+ 'test-issuer',
574
+ );
575
+ const a: WithArr = Object.assign(new WithArr(), { name: 'x', tags: ['a', 'b', 'c'] });
576
+ const b: WithArr = Object.assign(new WithArr(), { name: 'x', tags: ['c', 'b', 'a'] });
577
+ const r = arrSvc.compareData(a, b, {
578
+ customComparators: {
579
+ tags: (x: string[], y: string[]) => {
580
+ const s: Set<string> = new Set<string>(x);
581
+ return y.length === x.length && y.every((v: string) => s.has(v));
582
+ },
583
+ },
584
+ });
585
+ expect(r.result).toBe('equal');
586
+ });
587
+
588
+ it('| deep-equal: Date instances ugyanazon time-stamp-pel equal-nek szamitanak', (): void => {
589
+ class WithDate extends DyFM_Metadata {
590
+ when?: Date;
591
+ }
592
+ const dateSvc = new DyNTS_DataService<WithDate>(
593
+ new WithDate(),
594
+ new DyFM_DataModel_Params<WithDate>({
595
+ dataName: 'with_date',
596
+ properties: {},
597
+ }),
598
+ 'test-issuer',
599
+ );
600
+ const t: number = 1_700_000_000_000;
601
+ const a: WithDate = Object.assign(new WithDate(), { when: new Date(t) });
602
+ const b: WithDate = Object.assign(new WithDate(), { when: new Date(t) });
603
+ expect(dateSvc.compareData(a, b).result).toBe('equal');
604
+ });
605
+
606
+ it('| deep-equal: nested object', (): void => {
607
+ class WithNested extends DyFM_Metadata {
608
+ nested?: { a: number; b: { c: string } };
609
+ }
610
+ const nSvc = new DyNTS_DataService<WithNested>(
611
+ new WithNested(),
612
+ new DyFM_DataModel_Params<WithNested>({ dataName: 'with_nested', properties: {} }),
613
+ 'test-issuer',
614
+ );
615
+ const a: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'x' } } });
616
+ const b: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'x' } } });
617
+ const c: WithNested = Object.assign(new WithNested(), { nested: { a: 1, b: { c: 'y' } } });
618
+ expect(nSvc.compareData(a, b).result).toBe('equal');
619
+ expect(nSvc.compareData(a, c).result).toBe('modified');
620
+ });
621
+
622
+ it('| deep-equal: array index-szerinti compare (eltero sorrend → modified default-ban)', (): void => {
623
+ class WithArr2 extends DyFM_Metadata {
624
+ items?: number[];
625
+ }
626
+ const aSvc = new DyNTS_DataService<WithArr2>(
627
+ new WithArr2(),
628
+ new DyFM_DataModel_Params<WithArr2>({ dataName: 'with_arr2', properties: {} }),
629
+ 'test-issuer',
630
+ );
631
+ const a: WithArr2 = Object.assign(new WithArr2(), { items: [1, 2, 3] });
632
+ const b: WithArr2 = Object.assign(new WithArr2(), { items: [1, 2, 3] });
633
+ const c: WithArr2 = Object.assign(new WithArr2(), { items: [3, 2, 1] });
634
+ expect(aSvc.compareData(a, b).result).toBe('equal');
635
+ expect(aSvc.compareData(a, c).result).toBe('modified');
636
+ });
637
+
638
+ it('| throw 400 ha newData null', (): void => {
639
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'x' });
640
+ let thrown: any = null;
641
+ try { svc.compareData(null as any, b); } catch (e) { thrown = e; }
642
+ expect(thrown).not.toBeNull();
643
+ expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
644
+ expect(DyFM_Error.getErrorCode(thrown)).toContain('DyNTS-DS0-CD1');
645
+ });
646
+
647
+ it('| throw 400 ha oldData undefined', (): void => {
648
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'x' });
649
+ let thrown: any = null;
650
+ try { svc.compareData(a, undefined as any); } catch (e) { thrown = e; }
651
+ expect(thrown).not.toBeNull();
652
+ expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
653
+ });
654
+
655
+ it('| throw 400 ha options.fields ures array', (): void => {
656
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
657
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' });
658
+ let thrown: any = null;
659
+ try { svc.compareData(a, b, { fields: [] }); } catch (e) { thrown = e; }
660
+ expect(thrown).not.toBeNull();
661
+ expect(DyFM_Error.getErrorStatus(thrown)).toBe(400);
662
+ expect(DyFM_Error.getErrorCode(thrown)).toContain('DyNTS-DS0-CD2');
663
+ });
664
+
665
+ it('| asymmetric keys: ha az egyik objektum-bol hianyzik a key, modified-nek szamit', (): void => {
666
+ const a: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice', email: 'a@x' });
667
+ const b: TestMetadata = Object.assign(new TestMetadata(), { name: 'alice' }); // no email
668
+ const r = svc.compareData(a, b);
669
+ expect(r.result).toBe('modified');
670
+ expect(r.changedFields).toEqual(['email']);
671
+ });
672
+ });
673
+ });
674
+