@futdevpro/nts-dynamo 1.15.38 → 1.15.40

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 (338) 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 +2567 -0
  17. package/.dynamo/logs/cicd-pipeline/status.json +319 -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/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts +6 -0
  27. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts.map +1 -1
  28. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js +25 -7
  29. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js.map +1 -1
  30. package/build/_modules/ai/_services/ai-llm.service-base.d.ts.map +1 -1
  31. package/build/_modules/ai/_services/ai-llm.service-base.js +7 -0
  32. package/build/_modules/ai/_services/ai-llm.service-base.js.map +1 -1
  33. package/build/_modules/server/errors/errors.control-service.d.ts +1 -0
  34. package/build/_modules/server/errors/errors.control-service.d.ts.map +1 -1
  35. package/build/_modules/server/errors/errors.control-service.js.map +1 -1
  36. package/build/_modules/server/errors/errors.controller.d.ts.map +1 -1
  37. package/build/_modules/server/errors/errors.controller.js +19 -1
  38. package/build/_modules/server/errors/errors.controller.js.map +1 -1
  39. package/build/_modules/server/errors/errors.data-service.d.ts +7 -0
  40. package/build/_modules/server/errors/errors.data-service.d.ts.map +1 -1
  41. package/build/_modules/server/errors/errors.data-service.js +31 -0
  42. package/build/_modules/server/errors/errors.data-service.js.map +1 -1
  43. package/eslint.config.js +3 -3
  44. package/nodemon.json +24 -24
  45. package/package.json +2 -2
  46. package/pnpm-workspace.yaml +8 -7
  47. package/scripts/run-coverage-tests.js +28 -28
  48. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  49. package/spec/support/helpers/ts-node-helper.js +93 -93
  50. package/spec/support/jasmine.coverage.json +24 -24
  51. package/spec/support/jasmine.json +24 -24
  52. package/src/_collections/archive.util.spec.ts +57 -57
  53. package/src/_collections/archive.util.ts +18 -18
  54. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  55. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  56. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  57. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  58. package/src/_collections/default-not-found-page.const.ts +22 -22
  59. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  60. package/src/_collections/default-socket-path.const.ts +2 -2
  61. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  62. package/src/_collections/get-environment-settings.util.ts +48 -48
  63. package/src/_collections/sample.env +21 -21
  64. package/src/_collections/star.controller.spec.ts +224 -224
  65. package/src/_collections/star.controller.ts +129 -129
  66. package/src/_enums/data-model-type.enum.ts +14 -14
  67. package/src/_enums/data-service-function.enum.ts +24 -24
  68. package/src/_enums/predefined-data-types.enum.ts +16 -16
  69. package/src/_enums/route-security.enum.ts +12 -12
  70. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  71. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  72. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  73. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  74. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  75. package/src/_models/control-models/app-params.control-model.ts +136 -136
  76. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  77. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  78. package/src/_models/control-models/endpoint-params.control-model.spec.ts +578 -578
  79. package/src/_models/control-models/endpoint-params.control-model.ts +526 -526
  80. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  81. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  82. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  83. package/src/_models/control-models/system-control.control-model.ts +12 -12
  84. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  85. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  86. package/src/_models/interfaces/global-log-settings.interface.ts +144 -144
  87. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  88. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  89. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  90. package/src/_models/interfaces/static-client-settings.interface.ts +28 -28
  91. package/src/_models/types/db-update.type.ts +100 -100
  92. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  93. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  94. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  95. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  96. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  97. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  98. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  99. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  100. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  101. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  102. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  103. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  104. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  105. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  106. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  107. package/src/_modules/ai/_modules/document-ai/index.ts +28 -28
  108. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  109. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  110. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  111. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  112. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  113. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  114. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  115. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  116. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  117. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  118. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  119. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  120. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  121. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  122. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  123. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  124. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  125. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -106
  126. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1011
  127. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  128. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  129. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  130. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  131. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  132. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  133. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -510
  134. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  135. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  136. package/src/_modules/ai/index.ts +13 -13
  137. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  138. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  139. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  140. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  141. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  142. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  143. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  144. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  145. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  146. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  147. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  148. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  149. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  150. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  151. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  152. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  153. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  154. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  155. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  156. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  157. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  158. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  159. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  160. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  161. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  162. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  163. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  164. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  165. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  166. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  167. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  168. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  169. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  170. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  171. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  172. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  173. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  174. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  175. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  176. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  177. package/src/_modules/custom-data/index.ts +9 -9
  178. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  179. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  180. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  181. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  182. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  183. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  184. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  185. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  186. package/src/_modules/defaults/index.ts +17 -17
  187. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  188. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  189. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  190. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  191. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  192. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  193. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  194. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  195. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  196. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  197. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  198. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  199. package/src/_modules/discord-assistant/index.ts +38 -38
  200. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  201. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  202. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  203. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  204. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  205. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  206. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  207. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  208. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  209. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  210. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  211. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  212. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  213. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  214. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  215. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  216. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  217. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  218. package/src/_modules/discord-bot/index.ts +36 -36
  219. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  220. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  221. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  222. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  223. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  224. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  225. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +393 -393
  226. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +220 -220
  227. package/src/_modules/local-vector-search/index.ts +11 -11
  228. package/src/_modules/messaging/README.md +354 -354
  229. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  230. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  231. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  232. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  233. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  234. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  235. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  236. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  237. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  238. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  239. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  240. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  241. package/src/_modules/messaging/index.ts +30 -30
  242. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  243. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  244. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  245. package/src/_modules/mock/app-params.mock.ts +9 -9
  246. package/src/_modules/mock/app-server.mock.ts +188 -188
  247. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  248. package/src/_modules/mock/auth-service.mock.ts +28 -28
  249. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  250. package/src/_modules/mock/controller.mock.ts +16 -16
  251. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  252. package/src/_modules/mock/data-model.mock.ts +82 -82
  253. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  254. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  255. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  256. package/src/_modules/mock/email-service.mock.ts +20 -20
  257. package/src/_modules/mock/email-template.mock.html +14 -14
  258. package/src/_modules/mock/endpoint.mock.ts +91 -91
  259. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  260. package/src/_modules/mock/socket-client.mock.ts +45 -45
  261. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  262. package/src/_modules/mock/socket-server.mock.ts +46 -46
  263. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  264. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  265. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  266. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  267. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  268. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  269. package/src/_modules/oauth2/index.ts +17 -17
  270. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -234
  271. package/src/_modules/server/errors/errors.control-service.ts +85 -77
  272. package/src/_modules/server/errors/errors.controller.spec.ts +241 -238
  273. package/src/_modules/server/errors/errors.controller.ts +431 -402
  274. package/src/_modules/server/errors/errors.data-service.spec.ts +355 -355
  275. package/src/_modules/server/errors/errors.data-service.ts +48 -6
  276. package/src/_modules/server/index.ts +30 -30
  277. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  278. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  279. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  280. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  281. package/src/_modules/server/server-status/server-status.control-service.spec.ts +524 -520
  282. package/src/_modules/server/server-status/server-status.control-service.ts +336 -336
  283. package/src/_modules/server/server-status/server-status.controller.spec.ts +162 -159
  284. package/src/_modules/server/server-status/server-status.controller.ts +131 -131
  285. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  286. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  287. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  288. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  289. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  290. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  291. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  292. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  293. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  294. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  295. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  296. package/src/_modules/socket/app-extended.server.ts +630 -630
  297. package/src/_modules/socket/index.ts +42 -42
  298. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  299. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  300. package/src/_modules/test/index.ts +11 -11
  301. package/src/_modules/test/test.controller.spec.ts +72 -72
  302. package/src/_modules/test/test.controller.ts +115 -115
  303. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  304. package/src/_modules/usage/index.ts +15 -15
  305. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  306. package/src/_modules/usage/usage.controller.ts +126 -126
  307. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  308. package/src/_modules/usage/usage.data-service.ts +185 -185
  309. package/src/_services/base/api.service-base.spec.ts +125 -125
  310. package/src/_services/base/api.service-base.ts +74 -74
  311. package/src/_services/base/archive-data.service.spec.ts +196 -196
  312. package/src/_services/base/archive-data.service.ts +216 -216
  313. package/src/_services/base/data.service.spec.ts +674 -674
  314. package/src/_services/base/data.service.ts +2719 -2719
  315. package/src/_services/base/db.service.spec.ts +73 -73
  316. package/src/_services/base/db.service.ts +1575 -1575
  317. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  318. package/src/_services/base/singleton.service-base.ts +24 -24
  319. package/src/_services/base/singleton.service.spec.ts +114 -114
  320. package/src/_services/base/singleton.service.ts +38 -38
  321. package/src/_services/core/api.service.spec.ts +140 -140
  322. package/src/_services/core/auth.service.spec.ts +159 -159
  323. package/src/_services/core/auth.service.ts +174 -174
  324. package/src/_services/core/email.service.spec.ts +85 -85
  325. package/src/_services/core/email.service.ts +742 -742
  326. package/src/_services/core/global.service.spec.ts +275 -275
  327. package/src/_services/core/global.service.ts +461 -461
  328. package/src/_services/core/service-collection.service.spec.ts +46 -46
  329. package/src/_services/core/service-collection.service.ts +6 -6
  330. package/src/_services/route/controller.service.spec.ts +53 -53
  331. package/src/_services/route/controller.service.ts +148 -148
  332. package/src/_services/route/routing-module.service.spec.ts +98 -98
  333. package/src/_services/route/routing-module.service.ts +330 -330
  334. package/src/_services/shared.static-service.spec.ts +99 -99
  335. package/src/_services/shared.static-service.ts +78 -78
  336. package/src/index.ts +95 -95
  337. package/tsconfig.app.json +12 -12
  338. 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
+