@futdevpro/nts-dynamo 1.15.157 → 1.15.160

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 (634) hide show
  1. package/LICENSE +17 -17
  2. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts +71 -0
  3. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts.map +1 -0
  4. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js +3 -0
  5. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js.map +1 -0
  6. package/build/_modules/privacy-lifecycle/index.d.ts +3 -0
  7. package/build/_modules/privacy-lifecycle/index.d.ts.map +1 -1
  8. package/build/_modules/privacy-lifecycle/index.js +5 -1
  9. package/build/_modules/privacy-lifecycle/index.js.map +1 -1
  10. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts +48 -0
  11. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts.map +1 -0
  12. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js +332 -0
  13. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js.map +1 -0
  14. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts +25 -0
  15. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts.map +1 -0
  16. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js +126 -0
  17. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js.map +1 -0
  18. package/package.json +11 -4
  19. package/.c8rc.json +0 -26
  20. package/.copilot/patterns.json +0 -8
  21. package/.cursor/rules/__assistant_guide.mdc +0 -30
  22. package/.cursor/rules/__main.mdc +0 -64
  23. package/.cursor/rules/_ag_backend-structure.mdc +0 -86
  24. package/.cursor/rules/_ag_backend.mdc +0 -16
  25. package/.cursor/rules/_ag_debug.mdc +0 -8
  26. package/.cursor/rules/_ag_documentation_writing_rules.mdc +0 -372
  27. package/.cursor/rules/_ag_file-refactoring.mdc +0 -113
  28. package/.cursor/rules/_ag_fixes_rules.mdc +0 -6
  29. package/.cursor/rules/_ag_frontend-structure.mdc +0 -87
  30. package/.cursor/rules/_ag_frontend.mdc +0 -40
  31. package/.cursor/rules/_ag_import-rules.mdc +0 -45
  32. package/.cursor/rules/_ag_naming.mdc +0 -116
  33. package/.cursor/rules/_ag_running_commands.mdc +0 -5
  34. package/.cursor/rules/_ag_server-controller.mdc +0 -6
  35. package/.cursor/rules/_ag_should-be.mdc +0 -7
  36. package/.cursor/rules/_ag_swearing.mdc +0 -47
  37. package/.cursor/rules/ai_development_guide.md +0 -61
  38. package/.cursor/rules/ai_directives.md +0 -114
  39. package/.cursor/rules/cursor-rules.md +0 -160
  40. package/.cursor/rules/default-command.mdc +0 -465
  41. package/.cursor/rules/error_code_pattern.md +0 -40
  42. package/.cursor/rules/saved rule mcp server use.md +0 -16
  43. package/.dynamo/pipeline.cicd.config.json +0 -190
  44. package/.dynamo/version-bump.config.json +0 -5
  45. package/.github/workflows/main.yml +0 -438
  46. package/.husky/pre-commit +0 -3
  47. package/.vscode/settings.json +0 -11
  48. package/BuildPackage.bat +0 -1
  49. package/HOWTO.md +0 -15
  50. package/__documentations/2026-04-28-logs-module.md +0 -49
  51. package/__documentations/2026-05-17-oai-compatible-providers.md +0 -229
  52. package/__documentations/2026-05-17-static-client-serving-howto.md +0 -144
  53. package/__documentations/2026-06-01-fr041-cors-middleware.md +0 -96
  54. package/__documentations/2026-06-01-fr047-p2p3-function-calling.md +0 -81
  55. package/__documentations/2026-06-15-fr193-memory-guard.md +0 -73
  56. package/__documentations/2026-08-08-fr292-app-version-header.md +0 -38
  57. package/__documentations/2026-08-14-field-encryption-mongoose-document-spread.md +0 -124
  58. package/__documentations/2026-08-18-artifact-compiler.md +0 -46
  59. package/__documentations/2026-08-18-mongo-transaction-control-service.md +0 -82
  60. package/__documentations/2026-08-18-standalone-account-security-and-privacy-bedrock.md +0 -132
  61. package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +0 -59
  62. package/__documentations/2026-08-22-bfr-ctm-018-content-free-endpoint-errors.md +0 -54
  63. package/__documentations/2026-08-22-bfr-ctm-020-content-free-request-telemetry.md +0 -65
  64. package/__documentations/2026-08-22-content-free-process-error-boundary.md +0 -111
  65. package/__documentations/2026-08-22-npm-token-state-classifier.md +0 -92
  66. package/__documentations/nts-integration-tests-2026-03-17.md +0 -26
  67. package/__documentations/plans/BEDROCK-HYPERPLAN.md +0 -95
  68. package/_specifications/BACKLOG.md +0 -92
  69. package/_specifications/TODO.md +0 -15
  70. package/_specifications/agent.md +0 -138
  71. package/eslint.config.js +0 -3
  72. package/nodemon.json +0 -24
  73. package/pnpm-workspace.yaml +0 -6
  74. package/scripts/_seed-out/aim-seed.fixtures.ts +0 -161
  75. package/scripts/_seed-out/image-raw.json +0 -1
  76. package/scripts/_seed-out/llm-expand-raw.json +0 -60
  77. package/scripts/_seed-out/sample-image.png +0 -0
  78. package/scripts/_seed-out/seed-raw.json +0 -153
  79. package/scripts/ai-fixture-seed.js +0 -126
  80. package/scripts/run-coverage-tests.js +0 -28
  81. package/spec/support/helpers/spec-reporter-loader.js +0 -359
  82. package/spec/support/helpers/ts-node-helper.js +0 -93
  83. package/spec/support/jasmine.coverage.json +0 -24
  84. package/spec/support/jasmine.json +0 -24
  85. package/src/_assets/dynamo-nts-logo-128.png +0 -0
  86. package/src/_assets/dynamo-nts-logo-256.png +0 -0
  87. package/src/_assets/dynamo-nts-logo-512.png +0 -0
  88. package/src/_assets/dynamo-nts-logo-64.png +0 -0
  89. package/src/_collections/app-version-header.util.spec.ts +0 -108
  90. package/src/_collections/app-version-header.util.ts +0 -74
  91. package/src/_collections/archive-service-registry.const.ts +0 -21
  92. package/src/_collections/archive.util.spec.ts +0 -57
  93. package/src/_collections/archive.util.ts +0 -18
  94. package/src/_collections/atlas-default-db-options.const.ts +0 -10
  95. package/src/_collections/client-safe-error.util.spec.ts +0 -151
  96. package/src/_collections/client-safe-error.util.ts +0 -107
  97. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +0 -11
  98. package/src/_collections/default-fallback-cache-max-age.const.ts +0 -2
  99. package/src/_collections/default-not-found-page.const.spec.ts +0 -19
  100. package/src/_collections/default-not-found-page.const.ts +0 -22
  101. package/src/_collections/default-socket-path.const.spec.ts +0 -12
  102. package/src/_collections/default-socket-path.const.ts +0 -2
  103. package/src/_collections/field-encryption.util.spec.ts +0 -195
  104. package/src/_collections/field-encryption.util.ts +0 -222
  105. package/src/_collections/get-environment-settings.util.spec.ts +0 -210
  106. package/src/_collections/get-environment-settings.util.ts +0 -49
  107. package/src/_collections/global-settings.const.ts +0 -126
  108. package/src/_collections/load-shed.util.spec.ts +0 -62
  109. package/src/_collections/load-shed.util.ts +0 -51
  110. package/src/_collections/mongo-reconnect-guard.util.spec.ts +0 -52
  111. package/src/_collections/mongo-reconnect-guard.util.ts +0 -172
  112. package/src/_collections/npm-token-check.util.spec.ts +0 -218
  113. package/src/_collections/npm-token-check.util.ts +0 -327
  114. package/src/_collections/sample.env +0 -21
  115. package/src/_collections/security-headers.util.spec.ts +0 -98
  116. package/src/_collections/security-headers.util.ts +0 -96
  117. package/src/_collections/signed-url.util.spec.ts +0 -198
  118. package/src/_collections/signed-url.util.ts +0 -170
  119. package/src/_collections/star.controller.spec.ts +0 -224
  120. package/src/_collections/star.controller.ts +0 -130
  121. package/src/_collections/static-cache-control.util.spec.ts +0 -47
  122. package/src/_collections/static-cache-control.util.ts +0 -25
  123. package/src/_enums/data-model-type.enum.ts +0 -14
  124. package/src/_enums/data-service-function.enum.ts +0 -24
  125. package/src/_enums/predefined-data-types.enum.ts +0 -17
  126. package/src/_enums/route-security.enum.ts +0 -12
  127. package/src/_models/control-models/api-call-params.control-model.spec.ts +0 -152
  128. package/src/_models/control-models/api-call-params.control-model.ts +0 -142
  129. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +0 -52
  130. package/src/_models/control-models/app-ext-system-controls.control-model.ts +0 -9
  131. package/src/_models/control-models/app-params.control-model.spec.ts +0 -229
  132. package/src/_models/control-models/app-params.control-model.ts +0 -137
  133. package/src/_models/control-models/app-system-controls.control-model.spec.ts +0 -31
  134. package/src/_models/control-models/app-system-controls.control-model.ts +0 -9
  135. package/src/_models/control-models/endpoint-params.control-model.spec.ts +0 -754
  136. package/src/_models/control-models/endpoint-params.control-model.ts +0 -575
  137. package/src/_models/control-models/http-settings.control-model.spec.ts +0 -77
  138. package/src/_models/control-models/http-settings.control-model.ts +0 -37
  139. package/src/_models/control-models/system-control.control-model.spec.ts +0 -27
  140. package/src/_models/control-models/system-control.control-model.ts +0 -12
  141. package/src/_models/data-models/schema-migration.data-model.ts +0 -50
  142. package/src/_models/interfaces/app-version-header-settings.interface.ts +0 -17
  143. package/src/_models/interfaces/certification-settings.interface.ts +0 -7
  144. package/src/_models/interfaces/compare-data-options.interface.ts +0 -27
  145. package/src/_models/interfaces/compare-data-result.interface.ts +0 -12
  146. package/src/_models/interfaces/cors-settings.interface.spec.ts +0 -52
  147. package/src/_models/interfaces/cors-settings.interface.ts +0 -56
  148. package/src/_models/interfaces/db-query-options.interface.ts +0 -33
  149. package/src/_models/interfaces/environment-settings.interface.ts +0 -59
  150. package/src/_models/interfaces/global-log-settings.interface.ts +0 -171
  151. package/src/_models/interfaces/global-service-settings.interface.ts +0 -47
  152. package/src/_models/interfaces/global-settings.interface.ts +0 -294
  153. package/src/_models/interfaces/migration-entry.interface.ts +0 -19
  154. package/src/_models/interfaces/mongo-transaction-settings.interface.ts +0 -9
  155. package/src/_models/interfaces/request-telemetry-settings.interface.ts +0 -9
  156. package/src/_models/interfaces/request-telemetry-snapshot.interface.ts +0 -30
  157. package/src/_models/interfaces/routing-module-settings.interface.ts +0 -21
  158. package/src/_models/interfaces/security-headers-settings.interface.ts +0 -50
  159. package/src/_models/interfaces/signed-url-verify-result.interface.ts +0 -13
  160. package/src/_models/interfaces/static-client-settings.interface.spec.ts +0 -29
  161. package/src/_models/interfaces/static-client-settings.interface.ts +0 -36
  162. package/src/_models/types/db-update.type.ts +0 -100
  163. package/src/_modules/account-security/_enums/account-challenge-purpose.type-enum.ts +0 -5
  164. package/src/_modules/account-security/_enums/account-refresh-token-state.type-enum.ts +0 -6
  165. package/src/_modules/account-security/_enums/account-session-state.type-enum.ts +0 -6
  166. package/src/_modules/account-security/_models/account-challenge-adapter.interface.ts +0 -17
  167. package/src/_modules/account-security/_models/account-challenge-issued.interface.ts +0 -6
  168. package/src/_modules/account-security/_models/account-challenge-record.interface.ts +0 -13
  169. package/src/_modules/account-security/_models/account-challenge-result.interface.ts +0 -8
  170. package/src/_modules/account-security/_models/account-challenge-settings.interface.ts +0 -9
  171. package/src/_modules/account-security/_models/account-password-policy.interface.ts +0 -11
  172. package/src/_modules/account-security/_models/account-password-verification.interface.ts +0 -5
  173. package/src/_modules/account-security/_models/account-refresh-token-record.interface.ts +0 -13
  174. package/src/_modules/account-security/_models/account-session-adapter.interface.ts +0 -19
  175. package/src/_modules/account-security/_models/account-session-claims.interface.ts +0 -7
  176. package/src/_modules/account-security/_models/account-session-context.interface.ts +0 -6
  177. package/src/_modules/account-security/_models/account-session-create.interface.ts +0 -8
  178. package/src/_modules/account-security/_models/account-session-record.interface.ts +0 -21
  179. package/src/_modules/account-security/_models/account-session-rotate.interface.ts +0 -11
  180. package/src/_modules/account-security/_models/account-session-settings.interface.ts +0 -11
  181. package/src/_modules/account-security/_models/account-session-token-pair.interface.ts +0 -8
  182. package/src/_modules/account-security/_models/account-session-view.interface.ts +0 -13
  183. package/src/_modules/account-security/account-challenge.control-service.spec.ts +0 -195
  184. package/src/_modules/account-security/account-challenge.control-service.ts +0 -164
  185. package/src/_modules/account-security/account-password.control-service.spec.ts +0 -96
  186. package/src/_modules/account-security/account-password.control-service.ts +0 -288
  187. package/src/_modules/account-security/account-session.control-service.spec.ts +0 -294
  188. package/src/_modules/account-security/account-session.control-service.ts +0 -376
  189. package/src/_modules/account-security/index.ts +0 -31
  190. package/src/_modules/admin-auth/_models/admin-api-key-config.interface.ts +0 -33
  191. package/src/_modules/admin-auth/admin-api-key.auth-service.spec.ts +0 -200
  192. package/src/_modules/admin-auth/admin-api-key.auth-service.ts +0 -220
  193. package/src/_modules/admin-auth/index.ts +0 -2
  194. package/src/_modules/ai/_collections/ai-model-config-validator.util.spec.ts +0 -150
  195. package/src/_modules/ai/_collections/ai-model-config-validator.util.ts +0 -131
  196. package/src/_modules/ai/_collections/ai-provider-error.util.ts +0 -144
  197. package/src/_modules/ai/_models/ai-input-interfaces.ts +0 -117
  198. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +0 -16
  199. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts +0 -14
  200. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts +0 -56
  201. package/src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts +0 -16
  202. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.spec.ts +0 -72
  203. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts +0 -71
  204. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.spec.ts +0 -57
  205. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts +0 -60
  206. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.spec.ts +0 -56
  207. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts +0 -117
  208. package/src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts +0 -28
  209. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.ts +0 -14
  210. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.ts +0 -11
  211. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.ts +0 -30
  212. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.ts +0 -19
  213. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.ts +0 -20
  214. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +0 -115
  215. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +0 -233
  216. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.spec.ts +0 -134
  217. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.ts +0 -127
  218. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-pipeline.spec.ts +0 -105
  219. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.spec.ts +0 -50
  220. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.ts +0 -65
  221. package/src/_modules/ai/_modules/ai-mock/_services/aim-integration-proof.spec.ts +0 -92
  222. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.spec.ts +0 -112
  223. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts +0 -155
  224. package/src/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.ts +0 -649
  225. package/src/_modules/ai/_modules/ai-mock/index.ts +0 -47
  226. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +0 -138
  227. package/src/_modules/ai/_modules/anthropic/index.ts +0 -5
  228. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +0 -242
  229. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +0 -639
  230. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +0 -295
  231. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +0 -552
  232. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +0 -209
  233. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +0 -85
  234. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +0 -8
  235. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +0 -146
  236. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +0 -163
  237. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +0 -100
  238. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +0 -68
  239. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +0 -18
  240. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +0 -19
  241. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +0 -25
  242. package/src/_modules/ai/_modules/document-ai/index.ts +0 -30
  243. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +0 -189
  244. package/src/_modules/ai/_modules/fdp-ai/index.ts +0 -5
  245. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +0 -9
  246. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +0 -83
  247. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +0 -76
  248. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +0 -45
  249. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +0 -8
  250. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +0 -7
  251. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +0 -57
  252. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +0 -293
  253. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.ts +0 -572
  254. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +0 -342
  255. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.ts +0 -435
  256. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +0 -550
  257. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +0 -631
  258. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +0 -332
  259. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +0 -132
  260. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +0 -462
  261. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +0 -635
  262. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +0 -489
  263. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +0 -173
  264. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +0 -1085
  265. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +0 -157
  266. package/src/_modules/ai/_modules/open-ai/index.ts +0 -74
  267. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +0 -110
  268. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +0 -114
  269. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +0 -98
  270. package/src/_modules/ai/_services/ai-embedding.service-base.ts +0 -48
  271. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +0 -229
  272. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +0 -68
  273. package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts +0 -133
  274. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +0 -250
  275. package/src/_modules/ai/_services/ai-llm.service-base.ts +0 -599
  276. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +0 -158
  277. package/src/_modules/ai/_services/ai-provider.service-base.ts +0 -67
  278. package/src/_modules/ai/_services/ai-user-key.service-base.ts +0 -59
  279. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +0 -197
  280. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +0 -399
  281. package/src/_modules/ai/index.ts +0 -33
  282. package/src/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.ts +0 -5
  283. package/src/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.ts +0 -8
  284. package/src/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.ts +0 -6
  285. package/src/_modules/artifact-compiler/_models/artifact-compile.interface.ts +0 -35
  286. package/src/_modules/artifact-compiler/artifact-compiler.control-service.spec.ts +0 -151
  287. package/src/_modules/artifact-compiler/artifact-compiler.control-service.ts +0 -356
  288. package/src/_modules/artifact-compiler/index.ts +0 -9
  289. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +0 -13
  290. package/src/_modules/assistant/_collections/ass.util.spec.ts +0 -176
  291. package/src/_modules/assistant/_collections/ass.util.ts +0 -50
  292. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +0 -15
  293. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +0 -140
  294. package/src/_modules/assistant/_services/ass-io.control-service.ts +0 -74
  295. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +0 -192
  296. package/src/_modules/assistant/_services/ass-main.control-service.ts +0 -107
  297. package/src/_modules/assistant/index.ts +0 -19
  298. package/src/_modules/bot/_collections/bot-default-commands.const.ts +0 -12
  299. package/src/_modules/bot/_collections/bot-global-settings.const.ts +0 -39
  300. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +0 -62
  301. package/src/_modules/bot/_models/bot-command.interface.ts +0 -8
  302. package/src/_modules/bot/_models/bot-global-settings.interface.ts +0 -96
  303. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +0 -6
  304. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +0 -5
  305. package/src/_modules/bot/_models/bot-message-wrapper.interface.ts +0 -90
  306. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +0 -41
  307. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +0 -10
  308. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +0 -431
  309. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.ts +0 -641
  310. package/src/_modules/bot/_modules/discord-bot/index.ts +0 -12
  311. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +0 -160
  312. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +0 -55
  313. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +0 -15
  314. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +0 -374
  315. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +0 -447
  316. package/src/_modules/bot/_modules/dynamo-bot/index.ts +0 -15
  317. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +0 -9
  318. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +0 -344
  319. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +0 -197
  320. package/src/_modules/bot/_modules/slack-bot/index.ts +0 -12
  321. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +0 -9
  322. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +0 -345
  323. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +0 -197
  324. package/src/_modules/bot/_modules/teams-bot/index.ts +0 -11
  325. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +0 -116
  326. package/src/_modules/bot/_services/bot-commands.control-service.ts +0 -158
  327. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +0 -285
  328. package/src/_modules/bot/_services/bot-io.control-service.ts +0 -329
  329. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +0 -208
  330. package/src/_modules/bot/_services/bot-main.control-service.ts +0 -489
  331. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +0 -349
  332. package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts +0 -158
  333. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +0 -111
  334. package/src/_modules/bot/_services/bot-routines.control-service.ts +0 -78
  335. package/src/_modules/bot/index.ts +0 -37
  336. package/src/_modules/custom-data/custom-data.controller.spec.ts +0 -49
  337. package/src/_modules/custom-data/custom-data.controller.ts +0 -67
  338. package/src/_modules/custom-data/custom-data.data-service.spec.ts +0 -54
  339. package/src/_modules/custom-data/custom-data.data-service.ts +0 -22
  340. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +0 -28
  341. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +0 -24
  342. package/src/_modules/custom-data/index.ts +0 -9
  343. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +0 -176
  344. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +0 -203
  345. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +0 -33
  346. package/src/_modules/data-readers/index.ts +0 -11
  347. package/src/_modules/defaults/_collections/default-endpoints.util.ts +0 -487
  348. package/src/_modules/defaults/_models/default-user.data-model.ts +0 -72
  349. package/src/_modules/defaults/_services/default-auth.service.spec.ts +0 -269
  350. package/src/_modules/defaults/_services/default-auth.service.ts +0 -177
  351. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +0 -42
  352. package/src/_modules/defaults/_services/default-socket-events.service.ts +0 -61
  353. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +0 -187
  354. package/src/_modules/defaults/_services/default-user.data-service.ts +0 -98
  355. package/src/_modules/defaults/index.ts +0 -17
  356. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +0 -19
  357. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +0 -366
  358. package/src/_modules/discord-assistant/_collections/dias.util.ts +0 -133
  359. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +0 -20
  360. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +0 -53
  361. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +0 -177
  362. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +0 -108
  363. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +0 -69
  364. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +0 -22
  365. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +0 -27
  366. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +0 -195
  367. package/src/_modules/discord-assistant/_services/dias.service-base.ts +0 -77
  368. package/src/_modules/discord-assistant/index.ts +0 -38
  369. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +0 -34
  370. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +0 -11
  371. package/src/_modules/discord-assistant-voiced/index.ts +0 -36
  372. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +0 -17
  373. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +0 -56
  374. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +0 -214
  375. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +0 -387
  376. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +0 -12
  377. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +0 -98
  378. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +0 -8
  379. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +0 -6
  380. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +0 -154
  381. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +0 -153
  382. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +0 -264
  383. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +0 -306
  384. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +0 -408
  385. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +0 -488
  386. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +0 -105
  387. package/src/_modules/discord-bot/_services/dibo-routines.control-service.ts +0 -97
  388. package/src/_modules/discord-bot/index.ts +0 -36
  389. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +0 -35
  390. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +0 -60
  391. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +0 -17
  392. package/src/_modules/local-vector-search/_services/lvs-bm25.util.spec.ts +0 -159
  393. package/src/_modules/local-vector-search/_services/lvs-bm25.util.ts +0 -206
  394. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +0 -418
  395. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +0 -276
  396. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +0 -480
  397. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +0 -416
  398. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +0 -214
  399. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +0 -186
  400. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +0 -167
  401. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +0 -130
  402. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +0 -509
  403. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +0 -323
  404. package/src/_modules/local-vector-search/index.ts +0 -17
  405. package/src/_modules/logs/_models/file-log-entry.interface.ts +0 -13
  406. package/src/_modules/logs/_models/file-log-read-result.interface.ts +0 -37
  407. package/src/_modules/logs/file-log.service.spec.ts +0 -341
  408. package/src/_modules/logs/file-log.service.ts +0 -466
  409. package/src/_modules/logs/file-logs.controller.spec.ts +0 -245
  410. package/src/_modules/logs/file-logs.controller.ts +0 -165
  411. package/src/_modules/logs/get-file-logs-routing-module.util.ts +0 -51
  412. package/src/_modules/logs/get-logs-routing-module.util.ts +0 -36
  413. package/src/_modules/logs/index.ts +0 -11
  414. package/src/_modules/logs/log-buffer.service.ts +0 -101
  415. package/src/_modules/logs/logs.controller.ts +0 -109
  416. package/src/_modules/logs/logs.service.ts +0 -100
  417. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +0 -111
  418. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +0 -151
  419. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +0 -125
  420. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +0 -168
  421. package/src/_modules/mcp/index.ts +0 -13
  422. package/src/_modules/messaging/README.md +0 -354
  423. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +0 -26
  424. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +0 -22
  425. package/src/_modules/messaging/_collections/msg.util.spec.ts +0 -226
  426. package/src/_modules/messaging/_collections/msg.util.ts +0 -83
  427. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +0 -37
  428. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +0 -146
  429. package/src/_modules/messaging/_services/msg-events.service.spec.ts +0 -219
  430. package/src/_modules/messaging/_services/msg-events.service.ts +0 -267
  431. package/src/_modules/messaging/_services/msg-integration.control-service.ts +0 -180
  432. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +0 -147
  433. package/src/_modules/messaging/_services/msg-main.control-service.ts +0 -572
  434. package/src/_modules/messaging/_services/msg-message.data-service.ts +0 -129
  435. package/src/_modules/messaging/_services/msg.controller.spec.ts +0 -201
  436. package/src/_modules/messaging/_services/msg.controller.ts +0 -370
  437. package/src/_modules/messaging/index.ts +0 -30
  438. package/src/_modules/mock/app-extended-server.mock.ts +0 -201
  439. package/src/_modules/mock/app-integration-test.mock.ts +0 -51
  440. package/src/_modules/mock/app-params.mock.spec.ts +0 -21
  441. package/src/_modules/mock/app-params.mock.ts +0 -9
  442. package/src/_modules/mock/app-server.mock.ts +0 -188
  443. package/src/_modules/mock/auth-service.mock.spec.ts +0 -47
  444. package/src/_modules/mock/auth-service.mock.ts +0 -28
  445. package/src/_modules/mock/controller.mock.spec.ts +0 -26
  446. package/src/_modules/mock/controller.mock.ts +0 -16
  447. package/src/_modules/mock/data-model.mock.spec.ts +0 -111
  448. package/src/_modules/mock/data-model.mock.ts +0 -82
  449. package/src/_modules/mock/email-service-collection.mock.spec.ts +0 -24
  450. package/src/_modules/mock/email-service-collection.mock.ts +0 -15
  451. package/src/_modules/mock/email-service.mock.spec.ts +0 -17
  452. package/src/_modules/mock/email-service.mock.ts +0 -20
  453. package/src/_modules/mock/email-template.mock.html +0 -15
  454. package/src/_modules/mock/endpoint.mock.ts +0 -91
  455. package/src/_modules/mock/socket-client.mock.spec.ts +0 -40
  456. package/src/_modules/mock/socket-client.mock.ts +0 -45
  457. package/src/_modules/mock/socket-server.mock.spec.ts +0 -44
  458. package/src/_modules/mock/socket-server.mock.ts +0 -46
  459. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +0 -107
  460. package/src/_modules/oauth2/_routes/oauth2.controller.ts +0 -99
  461. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +0 -254
  462. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +0 -232
  463. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +0 -585
  464. package/src/_modules/oauth2/_services/oauth2.control-service.ts +0 -654
  465. package/src/_modules/oauth2/index.ts +0 -17
  466. package/src/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.ts +0 -5
  467. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.ts +0 -10
  468. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.ts +0 -7
  469. package/src/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.ts +0 -15
  470. package/src/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.ts +0 -9
  471. package/src/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.ts +0 -12
  472. package/src/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.ts +0 -7
  473. package/src/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.ts +0 -15
  474. package/src/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.ts +0 -7
  475. package/src/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.ts +0 -13
  476. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.ts +0 -9
  477. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.ts +0 -14
  478. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.ts +0 -8
  479. package/src/_modules/privacy-lifecycle/_models/privacy-contributor.interface.ts +0 -17
  480. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.ts +0 -21
  481. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.ts +0 -9
  482. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.ts +0 -7
  483. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.ts +0 -10
  484. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.ts +0 -7
  485. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.ts +0 -7
  486. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.ts +0 -11
  487. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.ts +0 -13
  488. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.ts +0 -19
  489. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.ts +0 -9
  490. package/src/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.ts +0 -7
  491. package/src/_modules/privacy-lifecycle/_models/privacy-request-open.interface.ts +0 -10
  492. package/src/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.ts +0 -7
  493. package/src/_modules/privacy-lifecycle/_models/privacy-request-record.interface.ts +0 -21
  494. package/src/_modules/privacy-lifecycle/_models/privacy-request-result.interface.ts +0 -8
  495. package/src/_modules/privacy-lifecycle/_models/privacy-request-view.interface.ts +0 -20
  496. package/src/_modules/privacy-lifecycle/index.ts +0 -40
  497. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.spec.ts +0 -206
  498. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.ts +0 -253
  499. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.spec.ts +0 -353
  500. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.ts +0 -586
  501. package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +0 -5
  502. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +0 -82
  503. package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +0 -9
  504. package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +0 -6
  505. package/src/_modules/rate-limit/_models/rate-limit-policy.interface.ts +0 -16
  506. package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +0 -9
  507. package/src/_modules/rate-limit/index.ts +0 -8
  508. package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +0 -91
  509. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +0 -488
  510. package/src/_modules/rate-limit/rate-limit.middleware.ts +0 -504
  511. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +0 -35
  512. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +0 -33
  513. package/src/_modules/scheduler/index.ts +0 -8
  514. package/src/_modules/scheduler/scheduler.controller.spec.ts +0 -42
  515. package/src/_modules/scheduler/scheduler.controller.ts +0 -69
  516. package/src/_modules/scheduler/scheduler.service.spec.ts +0 -141
  517. package/src/_modules/scheduler/scheduler.service.ts +0 -176
  518. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +0 -22
  519. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +0 -82
  520. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +0 -107
  521. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +0 -312
  522. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +0 -311
  523. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +0 -123
  524. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +0 -108
  525. package/src/_modules/scoped-config/index.ts +0 -17
  526. package/src/_modules/server/errors/errors.control-service.spec.ts +0 -246
  527. package/src/_modules/server/errors/errors.control-service.ts +0 -100
  528. package/src/_modules/server/errors/errors.controller.spec.ts +0 -340
  529. package/src/_modules/server/errors/errors.controller.ts +0 -559
  530. package/src/_modules/server/errors/errors.data-service.spec.ts +0 -480
  531. package/src/_modules/server/errors/errors.data-service.ts +0 -867
  532. package/src/_modules/server/index.ts +0 -40
  533. package/src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts +0 -8
  534. package/src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts +0 -20
  535. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.spec.ts +0 -124
  536. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.ts +0 -99
  537. package/src/_modules/server/safe-diagnostic/safe-diagnostic.interface.ts +0 -20
  538. package/src/_modules/server/server-status/db-readiness-probe-code.type-enum.ts +0 -13
  539. package/src/_modules/server/server-status/db-readiness-probe-stage.type-enum.ts +0 -7
  540. package/src/_modules/server/server-status/db-readiness-probe.control-service.spec.ts +0 -235
  541. package/src/_modules/server/server-status/db-readiness-probe.control-service.ts +0 -158
  542. package/src/_modules/server/server-status/db-readiness-probe.interface.ts +0 -20
  543. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +0 -70
  544. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +0 -17
  545. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +0 -77
  546. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +0 -37
  547. package/src/_modules/server/server-status/server-status.control-service.spec.ts +0 -672
  548. package/src/_modules/server/server-status/server-status.control-service.ts +0 -491
  549. package/src/_modules/server/server-status/server-status.controller.spec.ts +0 -276
  550. package/src/_modules/server/server-status/server-status.controller.ts +0 -336
  551. package/src/_modules/socket/_enums/socket-security.enum.ts +0 -11
  552. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +0 -32
  553. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +0 -22
  554. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +0 -165
  555. package/src/_modules/socket/_models/socket-presence.control-model.ts +0 -211
  556. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +0 -69
  557. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +0 -33
  558. package/src/_modules/socket/_services/socket-client.service.spec.ts +0 -15
  559. package/src/_modules/socket/_services/socket-client.service.ts +0 -260
  560. package/src/_modules/socket/_services/socket-server.service.spec.ts +0 -272
  561. package/src/_modules/socket/_services/socket-server.service.ts +0 -1037
  562. package/src/_modules/socket/app-extended.integration.spec.ts +0 -85
  563. package/src/_modules/socket/app-extended.server.ts +0 -648
  564. package/src/_modules/socket/index.ts +0 -42
  565. package/src/_modules/test/get-test-routing-module.util.spec.ts +0 -28
  566. package/src/_modules/test/get-test-routing-module.util.ts +0 -23
  567. package/src/_modules/test/index.ts +0 -12
  568. package/src/_modules/test/test.controller.spec.ts +0 -72
  569. package/src/_modules/test/test.controller.ts +0 -115
  570. package/src/_modules/test-email-sink/_collections/test-email-pattern.const.ts +0 -10
  571. package/src/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.ts +0 -41
  572. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.spec.ts +0 -112
  573. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.ts +0 -141
  574. package/src/_modules/test-email-sink/get-sent-mail-routing-module.util.ts +0 -29
  575. package/src/_modules/test-email-sink/index.ts +0 -11
  576. package/src/_modules/test-email-sink/test-email-sink.controller.ts +0 -83
  577. package/src/_modules/usage/get-usage-routing-module.util.ts +0 -23
  578. package/src/_modules/usage/index.ts +0 -15
  579. package/src/_modules/usage/usage.controller.spec.ts +0 -106
  580. package/src/_modules/usage/usage.controller.ts +0 -140
  581. package/src/_modules/usage/usage.data-service.spec.ts +0 -332
  582. package/src/_modules/usage/usage.data-service.ts +0 -185
  583. package/src/_services/base/api.service-base.spec.ts +0 -125
  584. package/src/_services/base/api.service-base.ts +0 -75
  585. package/src/_services/base/archive-data.service.spec.ts +0 -209
  586. package/src/_services/base/archive-data.service.ts +0 -228
  587. package/src/_services/base/data.service.spec.ts +0 -784
  588. package/src/_services/base/data.service.ts +0 -2792
  589. package/src/_services/base/db.service.encryption.spec.ts +0 -76
  590. package/src/_services/base/db.service.spec.ts +0 -160
  591. package/src/_services/base/db.service.ts +0 -1698
  592. package/src/_services/base/singleton.service-base.spec.ts +0 -28
  593. package/src/_services/base/singleton.service-base.ts +0 -24
  594. package/src/_services/base/singleton.service.spec.ts +0 -114
  595. package/src/_services/base/singleton.service.ts +0 -38
  596. package/src/_services/core/api.service.spec.ts +0 -187
  597. package/src/_services/core/api.service.ts +0 -627
  598. package/src/_services/core/auth.service.spec.ts +0 -159
  599. package/src/_services/core/auth.service.ts +0 -174
  600. package/src/_services/core/collection-growth-monitor.service.spec.ts +0 -119
  601. package/src/_services/core/collection-growth-monitor.service.ts +0 -234
  602. package/src/_services/core/db-stats.service.ts +0 -104
  603. package/src/_services/core/diagnostics.service.spec.ts +0 -44
  604. package/src/_services/core/diagnostics.service.ts +0 -158
  605. package/src/_services/core/email.service.spec.ts +0 -85
  606. package/src/_services/core/email.service.ts +0 -757
  607. package/src/_services/core/event-loop-diag.service.spec.ts +0 -22
  608. package/src/_services/core/event-loop-diag.service.ts +0 -144
  609. package/src/_services/core/global.service.spec.ts +0 -292
  610. package/src/_services/core/global.service.ts +0 -488
  611. package/src/_services/core/memory-guard.service.spec.ts +0 -245
  612. package/src/_services/core/memory-guard.service.ts +0 -481
  613. package/src/_services/core/migration-runner.service.spec.ts +0 -91
  614. package/src/_services/core/migration-runner.service.ts +0 -106
  615. package/src/_services/core/mongo-transaction.control-service.spec.ts +0 -165
  616. package/src/_services/core/mongo-transaction.control-service.ts +0 -148
  617. package/src/_services/core/request-hunter.service.spec.ts +0 -124
  618. package/src/_services/core/request-hunter.service.ts +0 -157
  619. package/src/_services/core/request-telemetry.control-service.spec.ts +0 -217
  620. package/src/_services/core/request-telemetry.control-service.ts +0 -381
  621. package/src/_services/core/service-collection.service.spec.ts +0 -46
  622. package/src/_services/core/service-collection.service.ts +0 -6
  623. package/src/_services/route/controller.service.spec.ts +0 -53
  624. package/src/_services/route/controller.service.ts +0 -148
  625. package/src/_services/route/routing-module.service.spec.ts +0 -98
  626. package/src/_services/route/routing-module.service.ts +0 -339
  627. package/src/_services/server/app-safe-diagnostic.spec.ts +0 -124
  628. package/src/_services/server/app.server-retention.spec.ts +0 -106
  629. package/src/_services/server/app.server.ts +0 -1979
  630. package/src/_services/shared.static-service.spec.ts +0 -133
  631. package/src/_services/shared.static-service.ts +0 -107
  632. package/src/index.ts +0 -120
  633. package/tsconfig.app.json +0 -12
  634. package/tsconfig.json +0 -42
@@ -1,2792 +0,0 @@
1
-
2
- import {
3
- DyFM_AnyError,
4
- DyFM_Array,
5
- DyFM_BasicProperty_Type,
6
- DyFM_DataModel_Params,
7
- DyFM_DataProperties,
8
- DyFM_DataProperty_Params,
9
- DyFM_DBFilter,
10
- DyFM_DBFilterExpressions,
11
- DyFM_DSNestedPropertySort,
12
- DyFM_DSPropertySort,
13
- DyFM_DSSort,
14
- DyFM_Error,
15
- DyFM_Error_Settings,
16
- DyFM_ErrorLevel,
17
- DyFM_Log,
18
- DyFM_Metadata,
19
- DyFM_NestPropertySearch,
20
- DyFM_Object,
21
- DyFM_RangeValue,
22
- DyFM_SearchQuery,
23
- DyFM_SearchResult,
24
- DyFM_SpecialSearch,
25
- DyFM_String,
26
- DyFM_ValidationError,
27
- DyFM_ValidationErrors
28
- } from '@futdevpro/fsm-dynamo';
29
-
30
- import { DyNTS_getArchivedDBName } from '../../_collections/archive.util';
31
- import { DyNTS_global_settings } from '../../_collections/global-settings.const';
32
- import { DyNTS_CompareData_Options } from '../../_models/interfaces/compare-data-options.interface';
33
- import { DyNTS_CompareData_Result } from '../../_models/interfaces/compare-data-result.interface';
34
- import { DyNTS_DBQueryOptions } from '../../_models/interfaces/db-query-options.interface';
35
- import { DyNTS_DBUpdate } from '../../_models/types/db-update.type';
36
- import { DyNTS_GlobalService } from '../core/global.service';
37
- import { DyNTS_ArchiveDataService } from './archive-data.service';
38
- import { DyNTS_archiveServiceRegistry } from '../../_collections/archive-service-registry.const';
39
- import { DyNTS_DBService } from './db.service';
40
-
41
-
42
- /**
43
- * `DyFM_Metadata` field-ek amik auto-discovery modban (fields opcio nelkul)
44
- * KI vannak hagyva a compareData()-bol. Ezek normal mukodes kozben kezelt
45
- * mezok (id-allocation, audit timestamps, audit usernames) — szemantikus
46
- * adatvaltozas-ellenorzeshez irrelevansak.
47
- *
48
- * Explicit `fields: ['_id']`-vel meg vizsgaltathato, ha valamiert kell.
49
- */
50
- /**
51
- * BFR-OVERSEER-011 (b): e dokumentum-szám fölött a searchData memóriabeli lapozása warn-t ad —
52
- * a teljes-kollekció-betöltés hívóhelyei incidens ELŐTT láthatóvá válnak (mérve: 5 hívóhely,
53
- * GC-thrash, ~11 óra akadozó CI).
54
- */
55
- const DyNTS_SEARCHDATA_INMEMORY_WARN_THRESHOLD: number = 1000;
56
-
57
- const COMPARE_DATA_METADATA_SKIP_FIELDS: ReadonlySet<string> = new Set<string>([
58
- '_id',
59
- '__created',
60
- '__createdBy',
61
- '__lastModified',
62
- '__lastModifiedBy',
63
- ]);
64
-
65
- // TODO: 2 type of archiving service system: within list, or separate db elements
66
-
67
- /**
68
- * Basic Data Service that is connected to the relevant DBServices
69
- *
70
- * @example
71
- * export class UserMatchStatisticsService extends DyNTS_DataService<UserMatchStatistics> {
72
- * constructor(
73
- * set: {
74
- * data?: UserMatchStatistics,
75
- * issuer: string,
76
- * }
77
- * ) {
78
- * super(
79
- * new UserMatchStatistics(set?.data),
80
- * userMatchStatisticsModelParams
81
- * );
82
- * this.issuer = set.issuer;
83
- * }
84
- * }
85
- */
86
- export class DyNTS_DataService<T extends DyFM_Metadata> {
87
-
88
- serviceName: string;
89
- serviceNameShortCode: string;
90
- /** error code base */
91
- ecBase: string = `${DyNTS_global_settings.systemShortCodeName}|`;
92
-
93
- /**
94
- * FR-258 / SR-3 — over-fetch küszöb. Ennél több dokumentumot visszaadó {@link findDataList} hívás
95
- * az unbounded-growth → GC-thrash/OOM vektor (2026-06-23 incidens): a teljes (akár több-100k-s)
96
- * collection a heap-be töltődik. NEM capeljük a query-t (az törné a hívókat) — csak WARNINGot
97
- * logolunk, hogy az over-fetch LÁTHATÓ legyen és paginálható/szűkíthető. Runtime felülírható
98
- * (`DyNTS_DataService.findDataListWarnThreshold = N`). Default: 10000.
99
- */
100
- static findDataListWarnThreshold: number = 10000;
101
-
102
- dataDBService: DyNTS_DBService<T>;
103
- haveArchiveDataService: boolean;
104
-
105
- /* data: T; */
106
- /** @deprecated */
107
- dataList: T[] = [];
108
- /* issuer: string; */
109
-
110
- readonly depSettings: {
111
- key: string;
112
- dbServiceKey: string;
113
- keyIsUnique: boolean;
114
- keyIsRequired: boolean;
115
- }[] = [];
116
- /* depKeys: string[] = [];
117
- depDBServiceKeys: string[] = [];
118
- depKeyIsUnique: boolean[] = [];
119
- depKeyIsRequired: boolean[] = []; */
120
- private depDataDBService: DyNTS_DBService<any>;
121
-
122
- /* dataParams: DyFM_DataModel_Params<T>; */
123
-
124
- readonly defaultErrorUserMsg: string =
125
- `We encountered an unhandled Data Service Error, ` +
126
- `\nplease contact the responsible development team.`;
127
- readonly defaultValidationErrorUserMsg: string =
128
- `We encountered an unhandled Validation Error, ` +
129
- `\nplease contact the responsible development team.`;
130
-
131
- constructor(
132
- /**
133
- * Initial data, this will be used by functions on default
134
- * @deprecated
135
- */
136
- public data: T,
137
- /**
138
- * DB data prams will be used to connect to usable dbService on GlobalService
139
- */
140
- /* dataParams: DyFM_DataModel_Params, */
141
- public dataParams: DyFM_DataModel_Params<T>,
142
- /**
143
- * Initial set for issuer to be able to follow the issuer's activity
144
- */
145
- public issuer: string
146
- ) {
147
- try {
148
- this.serviceName = this.constructor?.name;
149
- this.serviceNameShortCode = DyFM_String.anyNameToShortCode(this.serviceName);
150
- this.ecBase = `${DyNTS_global_settings.systemShortCodeName}|${this.serviceNameShortCode}|`;
151
- this.dataDBService = DyNTS_GlobalService.getDBService<T>(this.dataParams);
152
- /* this.data = data; */
153
- /* this.dataParams = dataParams; */
154
- this.haveArchiveDataService = this.dataParams.addArchive;
155
- this.lookForDependencyDataSettings();
156
- /* this.issuer = issuer; */
157
- /* DyNTS_GlobalService.addDataService(this); */
158
- } catch (error) {
159
- throw new DyFM_Error({
160
- ...this._getDefaultErrorSettings('constructor', error),
161
-
162
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-C00`,
163
- message:
164
- `The dataService construction failed for "${this.dataParams?.dataName}". ` +
165
- `at "${this.serviceName}" (${this.constructor.name})` +
166
- `\nMaybe you forgot to add the dbService to the GlobalService?` +
167
- `\nOr just trying to use a dependencyDataName that is not present in this db...`,
168
- level: DyFM_ErrorLevel.critical,
169
- });
170
- /* DyFM_Log.error(
171
- `\nDyNTS_DataService ERROR: ` +
172
- `\nThe dataService construction failed for ` +
173
- `${this.dataParams?.dataName}. ${this.serviceName} (${this.constructor.name})` +
174
- `\nMaybe you forgot to add the dbService to the GlobalService?` +
175
- `\n\n`,
176
- new Error()
177
- ); */
178
- }
179
- }
180
-
181
- getArchiveDataService(): DyNTS_ArchiveDataService<T> {
182
- // Non-throwing default (BFR-AM-012): ha a dataParams `addArchive`-ot kér, a base ELŐÁLLÍTJA a
183
- // default archive-service-t — az `addArchive: true` így out-of-the-box működik (soft-delete →
184
- // archív-collection), per-service boilerplate-override nélkül. A korábbi feltétlen throw a
185
- // loadData/delete archive-útjain futásidőben crashelt (és async-kontextusban néma
186
- // `.split`-elfedésű rejected-promise-ként jelent meg). Override továbbra is felülírhatja.
187
- // a registry-n át példányosítunk (körkörös-import feloldás — l. archive-service-registry.const)
188
- if (this.dataParams?.addArchive && DyNTS_archiveServiceRegistry.ArchiveDataService) {
189
- return new DyNTS_archiveServiceRegistry.ArchiveDataService<T>(this.data, this.dataParams, this.issuer);
190
- }
191
-
192
- // addArchive nélkül az archive-service-hívás valódi programhiba → marad az explicit throw
193
- throw new DyFM_Error({
194
- ...this._getDefaultErrorSettings(
195
- 'getArchiveDataService',
196
- new Error('getArchiveDataService is not implemented! (dataParams.addArchive is not set)')
197
- ),
198
-
199
- errorCode: `${this.ecBase}DyNTS-DS-GAD0`,
200
- });
201
- }
202
-
203
- /**
204
- * returns all data from database to service dataList
205
- */
206
- async getAll(dontSetToService?: boolean): Promise<T[]> {
207
- try {
208
- const dataListExists: T[] = await this.dataDBService.getAll().catch((error): T[] => {
209
- if (error?.errorCode?.includes('DBS-GA1')) {
210
- DyFM_Log.warn(`getAll "${this.dataParams.dataName}" didn't found any.`);
211
-
212
- return [];
213
- } else {
214
- throw error;
215
- }
216
- });
217
-
218
- if (!dontSetToService) {
219
- this.dataList = dataListExists;
220
- }
221
-
222
- return dataListExists;
223
- } catch (error) {
224
- throw new DyFM_Error({
225
- ...this._getDefaultErrorSettings('getAll', error),
226
-
227
- errorCode: `${this.ecBase}DyNTS-DS-GA0`,
228
- });
229
- }
230
- }
231
-
232
- /**
233
- * @description
234
- * returns data from database by id
235
- * also if dontSetToService is false or not setted,
236
- * the data will be saved to the service, even if its not found
237
- *
238
- * if the data is not found, it will try to find it from the archive
239
- * unless skipArchiveLoad is set to true
240
- *
241
- * @remarks
242
- * If you need to get-save a data, if possible,
243
- * use db-service update instead.
244
- *
245
- * @param {string} id
246
- * (using id from service.data, if not provided)
247
- * @param dontSetToService
248
- *
249
- * @return {T} data: T
250
- */
251
- async getDataById(
252
- id?: string,
253
- dontSetToService?: boolean,
254
- skipArchiveLoad?: boolean
255
- ): Promise<T> {
256
- try {
257
- id = id ?? this.data?._id;
258
-
259
- if (!id) {
260
- throw new DyFM_Error({
261
- ...this._getDefaultErrorSettings(
262
- 'getDataById',
263
- new Error(
264
- `getDataById failed, ID is missing! ` +
265
- `(maybe you wanted to use getDataByDependencyId() instead...) ` +
266
- `(${this.dataParams.dataName})`
267
- )
268
- ),
269
-
270
- errorCode: `${this.ecBase}DyNTS-DS-GI1`,
271
- });
272
- }
273
-
274
- let dataExists: T = await this.dataDBService.getDataById(id);
275
-
276
- if (!dataExists && this.haveArchiveDataService && !skipArchiveLoad) {
277
- const archiveDataService: DyNTS_ArchiveDataService<T> = this.getArchiveDataService();
278
-
279
- dataExists = await archiveDataService.getDataByOriginalId(id, true);
280
- }
281
-
282
- if (!dontSetToService) {
283
- this.data = dataExists;
284
- }
285
-
286
- return dataExists;
287
- } catch (error) {
288
- if (error?.errorCode == `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-GI1`) {
289
- throw error;
290
- } else {
291
- throw new DyFM_Error({
292
- ...this._getDefaultErrorSettings('getDataById', error),
293
- errorCode: `${this.ecBase}DyNTS-DS-GI0`,
294
- });
295
- }
296
- }
297
- }
298
-
299
- async getDataByIds(ids: string[], dontSetToService?: boolean): Promise<T[]> {
300
- try {
301
- if (!ids) {
302
- throw new DyFM_Error({
303
- ...this._getDefaultErrorSettings(
304
- 'getDataByIds',
305
- new Error(`getDataByIds failed, ids is missing! (${this.dataParams.dataName})`)
306
- ),
307
-
308
- errorCode: `${this.ecBase}DyNTS-DS-GIS1`,
309
- });
310
- }
311
-
312
- if (ids.length === 0) {
313
- return [];
314
- }
315
-
316
- const dataList: T[] = await this.dataDBService.find({ _id: { $in: ids } });
317
-
318
- if (!dontSetToService) {
319
- this.dataList = dataList;
320
- }
321
-
322
- return dataList;
323
- } catch (error) {
324
- throw new DyFM_Error({
325
- ...this._getDefaultErrorSettings('getDataByIds', error),
326
-
327
- errorCode: `${this.ecBase}DyNTS-DS-GIS0`,
328
- });
329
- }
330
- }
331
-
332
- async getDataListByIds(ids: string[], dontSetToService?: boolean): Promise<T[]> {
333
- try {
334
- const dataList: T[] = await this.dataDBService.getDataListByIds(ids);
335
-
336
- if (!dontSetToService) {
337
- this.dataList = dataList;
338
- }
339
-
340
- return dataList;
341
- } catch (error) {
342
- throw new DyFM_Error({
343
- ...this._getDefaultErrorSettings('getDataListByIds', error),
344
-
345
- errorCode: `${this.ecBase}DyNTS-DS-GIL0`,
346
- });
347
- }
348
- }
349
-
350
- private getDependencyIdsFilter(
351
- dependencyIds?: string | { [key: string]: string }
352
- ): { [key: string]: string } {
353
- if (!this.depSettings.length) {
354
- DyFM_Log.warn(
355
- `❌ getDataByDependencyId failed, dependencyKey is missing from service! ` +
356
- `(${this.dataParams.dataName})` +
357
- `\n 📍 ${this.dataParams.stackLocation}`
358
- );
359
-
360
- throw new DyFM_Error({
361
- ...this._getDefaultErrorSettings(
362
- 'getDataByDependencyId',
363
- new Error(
364
- `getDataByDependencyId failed, dependencyKey is missing from service! ` +
365
- `(${this.dataParams.dataName})`
366
- )
367
- ),
368
-
369
- errorCode: `${this.ecBase}DyNTS-DS-GD1`,
370
- });
371
- }
372
-
373
- if (typeof dependencyIds === 'string') {
374
- if (this.depSettings.length === 1) {
375
- dependencyIds = { [this.depSettings[0].key]: dependencyIds };
376
- } else if (this.depSettings.length > 1) {
377
- throw new DyFM_Error({
378
- ...this._getDefaultErrorSettings(
379
- 'getDataByDependencyId',
380
- new Error(
381
- `getDataByDependencyId failed, there are multiple dependencyKeys, ` +
382
- `so you need to provide a map of dependencyKeys! ` +
383
- `(${this.dataParams.dataName})`
384
- )
385
- ),
386
-
387
- errorCode: `${this.ecBase}DyNTS-DS-GD2`,
388
- });
389
- }
390
- } else if (!dependencyIds) {
391
- dependencyIds = {};
392
- this.depSettings.forEach((depSetting) => {
393
- if (this.data?.[depSetting.key]) {
394
- dependencyIds[depSetting.key] = this.data?.[depSetting.key];
395
- }
396
- });
397
- }
398
-
399
- if (
400
- !dependencyIds ||
401
- this.depSettings.every((depSetting) => !dependencyIds[depSetting.key])
402
- ) {
403
- throw new DyFM_Error({
404
- ...this._getDefaultErrorSettings(
405
- 'getDataByDependencyId',
406
- new Error(
407
- `getDataByDependencyId failed, dependencyId is missing! ` +
408
- `(${this.dataParams.dataName})`
409
- )
410
- ),
411
-
412
- errorCode: `${this.ecBase}DyNTS-DS-GD3`,
413
- });
414
- }
415
-
416
- return dependencyIds as { [key: string]: string };
417
- }
418
-
419
- /**
420
- * returns data from database by dependencyId to the service
421
- * (using id from service.data, if not provided)
422
- * @param dependencyIds
423
- */
424
- async getDataByDependencyId(
425
- dependencyIds?: string | { [key: string]: string },
426
- dontSetToService?: boolean
427
- ): Promise<T> {
428
- try {
429
- const dependencyIdsFilter: { [key: string]: string } =
430
- this.getDependencyIdsFilter(dependencyIds);
431
-
432
- const dataExists: T =
433
- await this.dataDBService.getDataByDependencyId(dependencyIdsFilter).catch(
434
- (error): null => {
435
- if (error?.errorCode?.includes('DBS-GD2')) {
436
- DyFM_Log.warn(
437
- `getDataByDependencyId failed; "${this.dataParams.dataName}" ` +
438
- `(${JSON.stringify(dependencyIds)}) didn't found any.`
439
- );
440
-
441
- return null;
442
- } else {
443
- throw error;
444
- }
445
- }
446
- );
447
-
448
- if (!dontSetToService) {
449
- this.data = dataExists;
450
- }
451
-
452
- return dataExists;
453
- } catch (error) {
454
- if ([
455
- `${this.ecBase}DyNTS-DS0-GD1`,
456
- `${this.ecBase}DyNTS-DS0-GD2`
457
- ].includes(error?.errorCode)) {
458
- throw error;
459
- } else {
460
- throw new DyFM_Error({
461
- ...this._getDefaultErrorSettings('getDataByDependencyId', error),
462
-
463
- errorCode: `${this.ecBase}DyNTS-DS-GD0`,
464
- });
465
- }
466
- }
467
- }
468
-
469
- async getDataListByDependencyIds(
470
- dependencyIds: string[],
471
- dontSetToService?: boolean,
472
- dependencyKey?: string,
473
- ): Promise<T[]> {
474
- try {
475
- if (!this.depSettings.length) {
476
- throw new DyFM_Error({
477
- ...this._getDefaultErrorSettings(
478
- 'getDataListByDependencyIds',
479
- new Error(
480
- `getDataListByDependencyIds failed, dependencyKey is missing from service! ` +
481
- `(${this.dataParams.dataName})`
482
- )
483
- ),
484
-
485
- errorCode: `${this.ecBase}DyNTS-DS-GDS1`,
486
- });
487
- }
488
-
489
- if (!dependencyKey) {
490
- if (this.depSettings.length === 1) {
491
- dependencyKey = this.depSettings[0].key;
492
- } else {
493
- throw new DyFM_Error({
494
- ...this._getDefaultErrorSettings(
495
- 'getDataListByDependencyIds',
496
- new Error(
497
- `getDataListByDependencyIds failed, dependencyKey is missing! ` +
498
- `since there are multiple dependencyKeys, you need to provide one! ` +
499
- `(${this.dataParams.dataName})`
500
- )
501
- ),
502
-
503
- errorCode: `${this.ecBase}DyNTS-DS-GDS2`,
504
- });
505
- }
506
- }
507
-
508
- if (!dependencyIds) {
509
- throw new DyFM_Error({
510
- ...this._getDefaultErrorSettings(
511
- 'getDataListByDependencyIds',
512
- new Error(
513
- `getDataListByDependencyIds failed, dependencyIds is missing! ` +
514
- `(${this.dataParams.dataName})`
515
- )
516
- ),
517
-
518
- errorCode: `${this.ecBase}DyNTS-DS-GDS3`,
519
- });
520
- }
521
-
522
- if (dependencyIds.length === 0) {
523
- return [];
524
- }
525
-
526
- const dataList: T[] = await this.dataDBService.getDataListByDependencyIds(
527
- dependencyKey, dependencyIds
528
- );
529
-
530
- if (!dontSetToService) {
531
- this.dataList = dataList;
532
- }
533
-
534
- return dataList;
535
- } catch (error) {
536
- if ([
537
- `${this.ecBase}DyNTS-DS0-GDS1`,
538
- `${this.ecBase}DyNTS-DS0-GDS2`
539
- ].includes(error?.errorCode)) {
540
- throw error;
541
- } else {
542
- throw new DyFM_Error({
543
- ...this._getDefaultErrorSettings('getDataListByDependencyIds', error),
544
-
545
- errorCode: `${this.ecBase}DyNTS-DS0-GDS0`,
546
- });
547
- }
548
- }
549
- }
550
-
551
- /**
552
- * returns dataList from database by dependencyId to the service
553
- * @param dependencyIds
554
- */
555
- async getDataListByDependencyId(
556
- dependencyIds?: string | { [key: string]: string },
557
- dontSetToService?: boolean
558
- ): Promise<T[]> {
559
- try {
560
- const dependencyIdsFilter: { [key: string]: string } =
561
- this.getDependencyIdsFilter(dependencyIds);
562
-
563
- const dataListExists: T[] =
564
- await this.dataDBService.getDataListByDependencyId(dependencyIdsFilter).catch(
565
- (error): T[] => {
566
- if (error?.errorCode?.includes('DBS-GLD2')) {
567
- DyFM_Log.warn(
568
- `getDataListByDependencyId "${this.dataParams.dataName}" ` +
569
- `(${JSON.stringify(dependencyIdsFilter)}) didn't found any.`
570
- );
571
-
572
- return [];
573
- } else {
574
- throw error;
575
- }
576
- }
577
- );
578
-
579
- if (!dontSetToService) {
580
- this.dataList = dataListExists;
581
- }
582
-
583
- return dataListExists;
584
- } catch (error) {
585
- if ([
586
- `${this.ecBase}DyNTS-DS0-GLD1`,
587
- `${this.ecBase}DyNTS-DS0-GLD2`
588
- ].includes(error?.errorCode)) {
589
- throw error;
590
- } else {
591
- throw new DyFM_Error({
592
- ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
593
-
594
- errorCode: `${this.ecBase}DyNTS-DS0-GLD0`,
595
-
596
- });
597
- }
598
- }
599
- }
600
-
601
- /**
602
- *
603
- * // findOne desc:
604
- *
605
- * Find the data first by any of its parameters,
606
- * also if dontSetToService is false or not setted,
607
- * the data will be saved to the service, even if non found
608
- *
609
- * @param filter if you can, use unique parameters for find!
610
- *
611
- * @example
612
- * // by email:
613
- * { email: email }
614
- * //
615
- * @example
616
- * // or by id that is in list:
617
- * { userIds: { $in: this.userId } }
618
- * // or by userIds:
619
- * { userId: { $in: userIds } }
620
- * //
621
- * @example
622
- * // or by number or Date that is Greater Than AND Less Than:
623
- * { points: { $gt: 2, $lt: 14 } }
624
- * // further tools (syntax matches with $gt):
625
- * $eq: // Matches values that are EQual to a specified value.
626
- * $gte: // Matches values that are Greater Than OR Equal to a specified value.
627
- * $lte: // Matches values that are Less Than or Equal to a specified value.
628
- * $ne: // Matches all values that are Not Equal to a specified value.
629
- * $nin: // Matches None of the values specified IN an array.
630
- * //
631
- * @returns {T} data: T
632
- */
633
- async findData(filterBy: DyFM_DBFilter<T>, dontSetToService?: boolean): Promise<T> {
634
- try {
635
- const dataExists: T = await this.dataDBService.findOne(filterBy).catch((error): null => {
636
- if (error?.errorCode?.includes('DBS-FO1')) {
637
- DyFM_Log.warn(`findData "${this.dataParams.dataName}" didn't found any.`);
638
-
639
- return null;
640
- } else {
641
- throw error;
642
- }
643
- });
644
-
645
- if (!dontSetToService) {
646
- this.data = dataExists;
647
- }
648
-
649
- return dataExists;
650
- } catch (error) {
651
- throw new DyFM_Error({
652
- ...this._getDefaultErrorSettings('findData', error),
653
-
654
- errorCode: `${this.ecBase}DyNTS-DS0-FD0`,
655
- });
656
- }
657
- }
658
- getDataByQuery: typeof this.findData = this.findData;
659
-
660
- /**
661
- *
662
- * // find desc:
663
- *
664
- * Find the data first by any of its parameters,
665
- * also if dontSetToService is false or not setted,
666
- * the data will be saved to the service, even if non found
667
- *
668
- * @param filter if you can, use unique parameters for find!
669
- *
670
- * @example
671
- * // by email:
672
- * { email: email }
673
- * //
674
- * @example
675
- * // or by id that is in list:
676
- * { userIds: { $in: this.userId } }
677
- * // or by userIds:
678
- * { userId: { $in: userIds } }
679
- * //
680
- * @example
681
- * // or by number or Date that is Greater Than AND Less Than:
682
- * { points: { $gt: 2, $lt: 14 } }
683
- * // further tools (syntax matches with $gt):
684
- * $eq: // Matches values that are EQual to a specified value.
685
- * $gte: // Matches values that are Greater Than OR Equal to a specified value.
686
- * $lte: // Matches values that are Less Than or Equal to a specified value.
687
- * $ne: // Matches all values that are Not Equal to a specified value.
688
- * $nin: // Matches None of the values specified IN an array.
689
- * //
690
- * @param options BFR-008: opcionalis projection/limit/sort — DB-szinten szukit (a nagy mezok be sem toltodnek)
691
- * @returns {T[]} dataList: T[]
692
- */
693
- async findDataList(filterBy: DyFM_DBFilter<T>, dontSetToService?: boolean, options?: DyNTS_DBQueryOptions<T>): Promise<T[]> {
694
- try {
695
- // BFR-OVERSEER-008 — az opcionalis projection/limit/sort DB-szintre tovabbitodik, igy a nagy
696
- // mezok be sem toltodnek (event-loop-block + heap-churn megelozes nagy collection-oknel).
697
- const dataListExists: T[] = await this.dataDBService.find(filterBy, undefined, options).catch((error): T[] => {
698
- if (error?.errorCode?.includes('DBS-F1')) {
699
- DyFM_Log.warn(`findDataList "${this.dataParams.dataName}" didn't found any.`);
700
-
701
- return [];
702
- } else {
703
- throw error;
704
- }
705
- });
706
-
707
- if (!dontSetToService) {
708
- this.dataList = dataListExists;
709
- }
710
-
711
- // FR-258 / SR-3 — over-fetch guard. Egy szűretlen find, ami egy nagy collection EGÉSZÉT a heap-be
712
- // tölti, a GC-thrash/OOM vektor (2026-06-23). NEM capeljük a query-t (az törné a hívókat), csak
713
- // WARNINGot logolunk, hogy az over-fetch LÁTHATÓ legyen → paginate/szűkebb filter a megoldás.
714
- const overFetchThreshold: number = DyNTS_DataService.findDataListWarnThreshold;
715
- if (overFetchThreshold > 0 && dataListExists.length > overFetchThreshold) {
716
- DyFM_Log.warn(
717
- `[FR-258 SR-3] findDataList "${this.dataParams.dataName}" returned ${dataListExists.length} documents ` +
718
- `(> ${overFetchThreshold}) — the whole result is held in heap. Consider a tighter filter or ` +
719
- `pagination (skip/limit) to avoid unbounded memory growth.`,
720
- );
721
- }
722
-
723
- return dataListExists;
724
- } catch (error) {
725
- throw new DyFM_Error({
726
- ...this._getDefaultErrorSettings('findDataList', error),
727
-
728
- errorCode: `${this.ecBase}DyNTS-DS0-FDS0`,
729
- });
730
- }
731
- }
732
-
733
- /**
734
- * This function uses the dataDBService.updateOne function.
735
- * This uses updateBy if setted, or data._id if its setted or this.data[this.dependencyKey]
736
- * @param set
737
- *
738
- * // updateOne desc:
739
- *
740
- * Find the data first by any of its parameters, throws error if not found
741
- * @param filter This uses the basic Mongoose updateOne.
742
- * If you can, use unique parameters for find!
743
- * @example
744
- * // by email:
745
- * { email: email }
746
- * //
747
- * @example
748
- * // or by id that is in list:
749
- * { userIds: { $in: this.userId } }
750
- * // or by userIds:
751
- * { userId: { $in: userIds } }
752
- * //
753
- * @example
754
- * // or by number or Date that is Greater Than AND Less Than:
755
- * { points: { $gt: 2, $lt: 14 } }
756
- * // further tools (syntax matches with $gt):
757
- * $eq: // Matches values that are EQual to a specified value.
758
- * $gte: // Matches values that are Greater Than OR Equal to a specified value.
759
- * $lte: // Matches values that are Less Than or Equal to a specified value.
760
- * $ne: // Matches all values that are Not Equal to a specified value.
761
- * $nin: // Matches None of the values specified IN an array.
762
- * //
763
- *
764
- * @param update this uses the basic Mongoose updateOne
765
- * @example
766
- * // increase a specific value (here by 15):
767
- * { $inc: { popularity: 15 } }
768
- * //
769
- * @example
770
- * // or add element to a list:
771
- * { $push: { reactions: this.newReaction }
772
- * // or add multiple elements to a list
773
- * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
774
- * //
775
- * @example
776
- * // or all at once
777
- * {
778
- * $inc: { popularity: this.newVote.amount },
779
- * emailVerified: true,
780
- * $push: { reactions: this.newReaction }
781
- * }
782
- * // further tools (syntax matches with $inc):
783
- * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
784
- * $min: // Only updates the field if the specified value is less than the existing field value.
785
- * $max: // Only updates the field if the specified value is greater than the existing field value.
786
- * $mul: // Multiplies the value of the field by the specified amount.
787
- * $rename: // Renames a field.
788
- * $unset: // Removes the specified field from a document. (set: "" to value)
789
- * //
790
- */
791
- async updateData(
792
- set: { filterBy?: DyFM_DBFilter<T>, update: DyNTS_DBUpdate<T> },
793
- dontUpdateModified?: boolean
794
- ): Promise<void> {
795
- try {
796
- if (set.filterBy) {
797
- await this.dataDBService.updateOne(
798
- set.filterBy,
799
- set.update,
800
- this.issuer,
801
- dontUpdateModified
802
- );
803
-
804
- } else if (this.data._id) {
805
- await this.dataDBService.updateOne(
806
- { _id: this.data._id } as DyFM_DBFilter<T>,
807
- set.update,
808
- this.issuer,
809
- dontUpdateModified
810
- );
811
-
812
- } else if (
813
- this.depSettings.length &&
814
- this.depSettings.some((depSetting) => this.data[depSetting.key])
815
- ) {
816
- const dependencyIdsFilter: { [key: string]: string } = {};
817
-
818
- this.depSettings.forEach((depSetting) => {
819
- if (this.data[depSetting.key]) {
820
- dependencyIdsFilter[depSetting.key] = this.data[depSetting.key];
821
- }
822
- });
823
-
824
- await this.dataDBService.updateOne(
825
- dependencyIdsFilter as DyFM_DBFilter<T>,
826
- set.update,
827
- this.issuer,
828
- dontUpdateModified
829
- );
830
-
831
- } else {
832
- throw new DyFM_Error({
833
- ...this._getDefaultErrorSettings(
834
- 'updateData',
835
- new Error(
836
- `no usable parameter provided for updateData; no updateBy, no id, no dependencyId ` +
837
- `(${this.dataParams.dataName})`
838
- )
839
- ),
840
-
841
- errorCode: `${this.ecBase}DyNTS-DS0-UD1`,
842
- additionalContent: {
843
- data: this.data,
844
- filterBy: set.filterBy,
845
- },
846
- });
847
- }
848
- } catch (error) {
849
- if (error?.errorCode?.includes('DS0-UD1')) {
850
- throw error;
851
- } else {
852
- throw new DyFM_Error({
853
- ...this._getDefaultErrorSettings('updateData', error),
854
-
855
- errorCode: `${this.ecBase}DyNTS-DS0-UD0`,
856
- });
857
- }
858
- }
859
- }
860
-
861
- protected ensureData(data?: T): T {
862
- if (!data && this.data) {
863
- data = this.data;
864
- }
865
-
866
- if (!data) {
867
- throw new DyFM_Error({
868
- ...this._getDefaultErrorSettings(
869
- 'ensureData',
870
- new Error(`no data to save! (${this.dataParams.dataName})`)
871
- ),
872
-
873
- errorCode: `${this.ecBase}DyNTS-DS0-ED0`,
874
- });
875
- }
876
-
877
- return data;
878
- }
879
-
880
- async patchData(data?: Partial<T>): Promise<T> {
881
- try {
882
- if (!data._id) {
883
- throw new DyFM_Error({
884
- ...this._getDefaultErrorSettings(
885
- 'patchData',
886
- new Error(`no ID to patch data! (${this.dataParams.dataName})`)
887
- ),
888
- });
889
- }
890
-
891
- const dataExists = await this.getDataById(data._id, true);
892
-
893
- if (!dataExists) {
894
- throw new DyFM_Error({
895
- ...this._getDefaultErrorSettings(
896
- 'patchData',
897
- new Error(`data not found! (${this.dataParams.dataName})`)
898
- ),
899
- });
900
- }
901
-
902
- for (const key in this.depSettings) {
903
- if (data[key] && data[key] !== dataExists[key]) {
904
- throw new DyFM_Error({
905
- ...this._getDefaultErrorSettings(
906
- 'patchData',
907
- new Error(`Cannot patch data: dependency data mismatch! (${this.dataParams.dataName})`)
908
- ),
909
- });
910
- }
911
- }
912
-
913
- DyFM_Object.cleanAssign(dataExists, data);
914
-
915
- await this.validateForSave(dataExists);
916
-
917
- return await this.dataDBService.modifyData(dataExists, this.issuer);
918
- } catch (error) {
919
- throw new DyFM_Error({
920
- ...this._getDefaultErrorSettings('patchData', error),
921
-
922
- errorCode: `${this.ecBase}DyNTS-DS0-PD0`,
923
- });
924
- }
925
- }
926
-
927
- /**
928
- * modifies data if the data have ID and already exists in the DB,
929
- * creates new if the ID is not present or cant find in DB,
930
- * and if dependency data setted up, will check before creation,
931
- *
932
- * @warning
933
- * but the proper way to update data, if you use update method instead,
934
- * this way, you can avoid data override errors
935
- * (when you simultaneously trying to change the same data's
936
- * different values from different flows)
937
- */
938
- async saveData(data?: T, dontSetToService?: boolean, dontUpdateModified?: boolean): Promise<T> {
939
- try {
940
- data = this.ensureData(data);
941
-
942
- await this.validateForSave(data);
943
-
944
- if (!data._id) {
945
- if (
946
- this.depSettings.length &&
947
- this.depSettings.some((depSetting) => !data[depSetting.key])
948
- ) {
949
- throw new DyFM_Error({
950
- ...this._getDefaultErrorSettings(
951
- 'saveData',
952
- new Error(
953
- `saveData was unsuccessful: dependency data id missing from data ` +
954
- `(key: ${this.depSettings.map((depSetting) => depSetting.key).join(', ')}, ` +
955
- `${this.dataParams.dataName})`
956
- )
957
- ),
958
-
959
- errorCode: `${this.ecBase}DyNTS-DS0-SD1`,
960
- additionalContent: {
961
- data: data,
962
- },
963
- });
964
- }
965
-
966
- // if ID of dependencyID is not present, data not exists, create new data
967
- data = await this.dataDBService.createData(data, this.issuer);
968
-
969
- if (!dontSetToService) {
970
- this.data = data;
971
- }
972
-
973
- return data;
974
- }
975
-
976
- let dataExists: T;
977
-
978
- // check if data already exists with the specific ID
979
- if (data._id) {
980
- dataExists = await this.getDataById(data._id, true);
981
-
982
- if (!dataExists) {
983
- throw new DyFM_Error({
984
- ...this._getDefaultErrorSettings(
985
- 'saveData',
986
- new Error(
987
- `saveData was unsuccessful: provided ID not exists ` +
988
- `(id: "${data._id}", ${this.dataParams.dataName})`
989
- )
990
- ),
991
-
992
- errorCode: `${this.ecBase}DyNTS-DS0-SD2`,
993
- additionalContent: {
994
- data: data,
995
- },
996
- });
997
- }
998
-
999
- // if data exists do modify
1000
- data = await this.dataDBService.modifyData(data, this.issuer, dontUpdateModified);
1001
-
1002
- if (!dontSetToService) {
1003
- this.data = data;
1004
- }
1005
-
1006
- return data;
1007
- }
1008
-
1009
- if (this.depSettings.length) {
1010
- if (this.depSettings.some((depSetting) => !data[depSetting.key])) {
1011
- throw new DyFM_Error({
1012
- ...this._getDefaultErrorSettings(
1013
- 'saveData',
1014
- new Error(
1015
- `saveData was unsuccessful: dependency data id missing from data ` +
1016
- `(key: ${this.depSettings.map((depSetting) => depSetting.key).join(', ')}, ` +
1017
- `${this.dataParams.dataName})`
1018
- )
1019
- ),
1020
-
1021
- errorCode: `${this.ecBase}DyNTS-DS0-SD3`,
1022
- additionalContent: {
1023
- data: data,
1024
- },
1025
- });
1026
- }
1027
-
1028
- if (this.depSettings.some((depSetting) => depSetting.keyIsRequired)) {
1029
- await DyFM_Array.asyncForEach(
1030
- this.depSettings,
1031
- async (depSetting) => {
1032
- if (depSetting.keyIsRequired) {
1033
- if (!data[depSetting.key]) {
1034
- throw new DyFM_Error({
1035
- ...this._getDefaultErrorSettings(
1036
- 'saveData',
1037
- new Error(
1038
- `saveData was unsuccessful: dependency data id missing from data ` +
1039
- `(key: ${depSetting.key}, ${this.dataParams.dataName})`
1040
- )
1041
- ),
1042
-
1043
- errorCode: `${this.ecBase}DyNTS-DS0-SD4`,
1044
- });
1045
- }
1046
-
1047
- const dependencyExists = await this.getDependencyDataDBService(depSetting.dbServiceKey)
1048
- .getDataById(data[depSetting.key])
1049
- .catch();
1050
-
1051
- if (!dependencyExists) {
1052
- throw new DyFM_Error({
1053
- ...this._getDefaultErrorSettings(
1054
- 'saveData',
1055
- new Error(
1056
- `saveData was unsuccessful: dependency data not exists ` +
1057
- `(key: ${depSetting.key}, id: "${data[depSetting.key]}", ` +
1058
- `${this.dataParams.dataName})`
1059
- )
1060
- ),
1061
-
1062
- errorCode: `${this.ecBase}DyNTS-DS0-SD4`,
1063
- });
1064
- }
1065
- }
1066
- }
1067
- );
1068
- }
1069
-
1070
- /* the db is handling the unique key, so no need to check it here
1071
- if (this.depKeyIsUnique) {
1072
- dataExists = await this.getDataByDependencyId(data[this.depKeys], true);
1073
-
1074
- if (dataExists) {
1075
- // if data exists do modify
1076
- data = await this.dataDBService.modifyData(data, this.issuer, dontUpdateModified);
1077
-
1078
- if (!dontSetToService) {
1079
- this.data = data;
1080
- }
1081
-
1082
- return data;
1083
-
1084
- }
1085
- } */
1086
- }
1087
-
1088
- // if data not exists create new data
1089
- data = await this.dataDBService.createData(data, this.issuer);
1090
-
1091
- if (!data._id) {
1092
- throw new DyFM_Error({
1093
- ...this._getDefaultErrorSettings(
1094
- 'saveData',
1095
- new Error(
1096
- `saveData was unsuccessful: data creation failed ` +
1097
- `(${this.dataParams.dataName})`
1098
- )
1099
- ),
1100
-
1101
- errorCode: `${this.ecBase}DyNTS-DS0-SD5`,
1102
- additionalContent: {
1103
- data: data,
1104
- },
1105
- });
1106
- }
1107
-
1108
- if (!dontSetToService) {
1109
- this.data = data;
1110
- }
1111
-
1112
- return data;
1113
-
1114
- } catch (error) {
1115
- if ([
1116
- `${this.ecBase}DyNTS-DS0-SD1`,
1117
- `${this.ecBase}DyNTS-DS0-SD2`,
1118
- `${this.ecBase}DyNTS-DS0-SD3`,
1119
- `${this.ecBase}DyNTS-DS0-SD4`,
1120
- `${this.ecBase}DyNTS-DS0-SD5`,
1121
- ].includes(error?.errorCode)) {
1122
- throw error;
1123
-
1124
- } else {
1125
- throw new DyFM_Error({
1126
- ...this._getDefaultErrorSettings('saveData', error),
1127
-
1128
- errorCode: `${this.ecBase}DyNTS-DS0-SD0`,
1129
- });
1130
- }
1131
- }
1132
- }
1133
-
1134
- /**
1135
- * markes data as deleted, if can be archived, will be archived as well
1136
- * if absolute is true, permanently deletes data from database by data._id
1137
- */
1138
- async deleteData(id?: string, absolute?: boolean): Promise<void> {
1139
- try {
1140
- if (!id && this.data._id) {
1141
- id = this.data._id;
1142
- }
1143
-
1144
- if (!id) {
1145
- throw new DyFM_Error({
1146
- ...this._getDefaultErrorSettings(
1147
- 'deleteData',
1148
- new Error(`deleteData failed, ID is missing! (${this.dataParams.dataName})`)
1149
- ),
1150
-
1151
- errorCode: `${this.ecBase}DyNTS-DS0-DD1`,
1152
- });
1153
- }
1154
-
1155
- this.data = await this.getDataById(id, true);
1156
-
1157
- if (!this.data) {
1158
- throw new DyFM_Error({
1159
- ...this._getDefaultErrorSettings(
1160
- 'deleteData',
1161
- new Error(`deleteData failed, data not found! (${this.dataParams.dataName})`)
1162
- ),
1163
-
1164
- errorCode: `${this.ecBase}DyNTS-DS0-DD2`,
1165
- });
1166
- }
1167
-
1168
- if (this.haveArchiveDataService) {
1169
- const archive_DS: DyNTS_DataService<T> = this.getArchiveDataService();
1170
-
1171
- await this.dataDBService.trueDeleteDataById(id);
1172
-
1173
- this.data._deleted = new Date();
1174
- this.data._deletedBy = this.issuer;
1175
- this.data._originalId = this.data._id;
1176
- this.data._archived = new Date();
1177
- delete this.data._id;
1178
-
1179
- await archive_DS.saveData(this.data, true);
1180
- } else if (absolute) {
1181
- await this.dataDBService.trueDeleteDataById(id);
1182
-
1183
- delete this.data._id;
1184
- } else {
1185
- await this.dataDBService.markDeletedById(id, this.issuer);
1186
- }
1187
- } catch (error) {
1188
- if (error?.errorCode?.includes('DS0-DD1')) {
1189
- throw error;
1190
- } else {
1191
- throw new DyFM_Error({
1192
- ...this._getDefaultErrorSettings('deleteData', error),
1193
-
1194
- errorCode: `${this.ecBase}DyNTS-DS0-DD0`,
1195
- });
1196
- }
1197
- }
1198
- }
1199
-
1200
- async deleteAllData(absolute?: boolean): Promise<void> {
1201
- try {
1202
- this.dataList = await this.getAll(true);
1203
-
1204
- if (this.haveArchiveDataService) {
1205
- const archive_DS: DyNTS_DataService<T> = this.getArchiveDataService();
1206
-
1207
- await this.dataDBService.trueDeleteAllData();
1208
-
1209
- await DyFM_Array.asyncForEachAllAtOnce(
1210
- this.dataList,
1211
- async (data: T) => {
1212
- data._deleted = new Date();
1213
- data._deletedBy = this.issuer;
1214
- data._originalId = data._id;
1215
- data._archived = new Date();
1216
- delete data._id;
1217
-
1218
- await archive_DS.saveData(data, true);
1219
- }
1220
- );
1221
- } else if (absolute) {
1222
- await this.dataDBService.trueDeleteAllData();
1223
-
1224
- this.dataList.forEach((data: T) => {
1225
- delete data._id;
1226
- });
1227
- } else {
1228
- await DyFM_Array.asyncForEachAllAtOnce(
1229
- this.dataList,
1230
- async (data: T) => {
1231
- await this.dataDBService.markDeletedById(data._id, this.issuer);
1232
- }
1233
- );
1234
- }
1235
- } catch (error) {
1236
- throw new DyFM_Error({
1237
- ...this._getDefaultErrorSettings('deleteAllData', error),
1238
-
1239
- errorCode: `${this.ecBase}DyNTS-DS0-DAD0`,
1240
- });
1241
- }
1242
- }
1243
-
1244
- restoreDeletedData(id?: string): Promise<void> {
1245
- try {
1246
- if (!id && this.data._id) {
1247
- id = this.data._id;
1248
- }
1249
-
1250
- if (!id) {
1251
- throw new DyFM_Error({
1252
- ...this._getDefaultErrorSettings(
1253
- 'restoreDeletedData',
1254
- new Error(`restoreDeletedData failed, ID is missing! (${this.dataParams.dataName})`)
1255
- ),
1256
-
1257
- errorCode: `${this.ecBase}DyNTS-DS0-RD1`,
1258
- });
1259
- }
1260
-
1261
- let archive_DS;
1262
-
1263
- try {
1264
- archive_DS = DyNTS_GlobalService.getDBServiceByKey(
1265
- DyNTS_getArchivedDBName(this.dataParams.dataName),
1266
- );
1267
- } catch (error) {}
1268
-
1269
- if (archive_DS) {
1270
- throw new DyFM_Error({
1271
- ...this._getDefaultErrorSettings(
1272
- 'restoreDeletedData',
1273
- new Error(
1274
- `restoreDeletedData failed, archive service is setted up, ` +
1275
- `archived restoration not implemented yet! ` +
1276
- `(request implementation, and restore by yourself)`
1277
- )
1278
- ),
1279
-
1280
- errorCode: `${this.ecBase}DyNTS-DS0-RD2`,
1281
- });
1282
- }
1283
-
1284
- return this.dataDBService.restoreDeletedById(id, this.issuer);
1285
- } catch (error) {
1286
- if (error?.errorCode?.includes('DS0-RD1')) {
1287
- throw error;
1288
- } else {
1289
- throw new DyFM_Error({
1290
- ...this._getDefaultErrorSettings('restoreDeletedData', error),
1291
-
1292
- errorCode: `${this.ecBase}DyNTS-DS0-RD0`,
1293
- });
1294
- }
1295
- }
1296
- }
1297
-
1298
- /**
1299
- * validation of data, for modify and create, by the ModelParams
1300
- */
1301
- async validateForSave(data?: T): Promise<void> {
1302
- try {
1303
- data = this.ensureData(data);
1304
-
1305
- if (!data) {
1306
- throw new DyFM_Error({
1307
- ...this._getDefaultErrorSettings('validateForSave', new Error('No data to validate! (validateForSave)')),
1308
- errorCode: `${this.ecBase}DyNTS-DS0-VBP0`,
1309
- });
1310
- }
1311
-
1312
- await this.validateDataByPropertyParams(data, this.dataParams.properties);
1313
- } catch (error) {
1314
- // a TELJES validacios csalad (VP/VDP/VBP/VD) valtozatlanul atmegy — a korabbi szukebb szuro a VDP*-t
1315
- // ujra-becsomagolta (double-wrap: a 400 elveszett; BFR-FUTDEVPRO-001)
1316
- if (error?.errorCode?.includes?.('DyNTS-DS0-V')) {
1317
- throw error;
1318
- } else {
1319
- throw new DyFM_Error({
1320
- ...this._getDefaultErrorSettings('validateForSave', error),
1321
-
1322
- status: 400,
1323
- errorCode: `${this.ecBase}DyNTS-DS0-VD0`,
1324
- });
1325
- }
1326
- }
1327
- }
1328
-
1329
- private validateDataByPropertyParams(
1330
- data: T,
1331
- properties: DyFM_DataProperties<T>,
1332
- isSubObjectOf?: DyFM_DataProperty_Params<any, T>
1333
- ): void {
1334
- try {
1335
- if (!data) {
1336
- if (isSubObjectOf?.required) {
1337
- throw new DyFM_Error({
1338
- ...this._getDefaultErrorSettings(
1339
- 'validateDataByPropertyParams',
1340
- new Error(
1341
- `validateData failed, data is required! ` +
1342
- `(${isSubObjectOf?.key ? `${isSubObjectOf.key}.` : ''}${this.dataParams.dataName})` +
1343
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1344
- )
1345
- ),
1346
- errorCode: `${this.ecBase}DyNTS-DS0-VDP1`,
1347
- });
1348
- } else {
1349
- return;
1350
- }
1351
- } else if (isSubObjectOf?.forbidden) {
1352
- throw new DyFM_Error({
1353
- ...this._getDefaultErrorSettings(
1354
- 'validateDataByPropertyParams',
1355
- new Error(
1356
- `validateData failed, data is forbidden! ` +
1357
- `(${isSubObjectOf?.key ? `${isSubObjectOf.key}.` : ''}${this.dataParams.dataName})` +
1358
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1359
- )
1360
- ),
1361
- errorCode: `${this.ecBase}DyNTS-DS0-VDP2`,
1362
- additionalContent: {
1363
- data: data,
1364
- },
1365
- });
1366
- }
1367
-
1368
- const validationErrors: DyFM_Error[] = [];
1369
-
1370
- Object.values(properties).forEach(
1371
- (propertyParams: DyFM_DataProperty_Params<any, T>) => {
1372
- try {
1373
- this.validateProperty(data, data[propertyParams.key], propertyParams, isSubObjectOf);
1374
- } catch (error) {
1375
- validationErrors.push(error);
1376
- }
1377
- }
1378
- );
1379
-
1380
- if (validationErrors.length > 0) {
1381
- if (validationErrors.length === 1) {
1382
- throw validationErrors[0];
1383
- } else {
1384
- const validationErrorsSet: DyFM_ValidationErrors = {};
1385
- validationErrors.forEach((error: DyFM_Error) => {
1386
- Object.keys(error.validationErrors).forEach((key: string) => {
1387
- validationErrorsSet[key] = error.validationErrors[key];
1388
- });
1389
- });
1390
-
1391
- throw new DyFM_Error({
1392
- ...this._getDefaultErrorSettings(
1393
- 'validateByPropertyParams',
1394
- new Error(
1395
- `Validation failed! (multiple validation errors for ${this.dataParams.dataName})` +
1396
- validationErrors.map((error: DyFM_Error) => `\n ${DyFM_Error.getAnyMessage(error)}`).join('')
1397
- )
1398
- ),
1399
- errorCode: `${this.ecBase}DyNTS-DS0-VDP3`,
1400
- errors: validationErrors,
1401
- validationErrors: validationErrorsSet,
1402
- });
1403
- }
1404
- }
1405
- } catch (error) {
1406
- // a teljes validacios csalad atengedese (a leaf VP-hibak eddig VDP0-ba csomagolodtak ujra)
1407
- if (error?.errorCode?.includes?.('DyNTS-DS0-V')) {
1408
- throw error;
1409
- } else {
1410
- throw new DyFM_Error({
1411
- ...this._getDefaultErrorSettings('validateByPropertyParams', error),
1412
-
1413
- status: 400,
1414
- errorCode: `${this.ecBase}DyNTS-DS0-VDP0`,
1415
- });
1416
- }
1417
- }
1418
- }
1419
-
1420
- private getPropertyKey(
1421
- propertyParams: DyFM_DataProperty_Params<any, T>,
1422
- isSubObjectOf?: DyFM_DataProperty_Params<any, T>
1423
- ): string {
1424
- return (isSubObjectOf && isSubObjectOf.key !== propertyParams.key) ?
1425
- `${isSubObjectOf.key}.${propertyParams.key}` : propertyParams.key;
1426
- }
1427
-
1428
- private validateProperty(
1429
- data: T,
1430
- propertyValue: any,
1431
- propertyParams: DyFM_DataProperty_Params<any, T>,
1432
- isSubObjectOf?: DyFM_DataProperty_Params<any, T>
1433
- ): void {
1434
- // basic required validations
1435
- if (
1436
- propertyParams.required && (
1437
- propertyValue === null ||
1438
- propertyValue === undefined
1439
- )
1440
- ) {
1441
- throw new DyFM_Error({
1442
- ...this._getDefaultErrorSettings(
1443
- 'validateProperty',
1444
- new Error(
1445
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is missing! ` +
1446
- `(required in "${this.dataParams.dataName}" dataParams) ` +
1447
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1448
- )
1449
- ),
1450
-
1451
- status: 400,
1452
- errorCode: `${this.ecBase}DyNTS-DS0-VP1`,
1453
- userMessage: this.defaultValidationErrorUserMsg,
1454
- validationErrors: {
1455
- [propertyParams.key]: {
1456
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is missing! ` +
1457
- `(required in "${this.dataParams.dataName}" dataParams) ` +
1458
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1459
- code: `${this.ecBase}DyNTS-DS0-VP1`,
1460
- userMessage: 'The property is required and must be a valid value!',
1461
- },
1462
- },
1463
- __localStack: this.dataParams.stackLocation,
1464
- additionalContent: {
1465
- data: data,
1466
- },
1467
- });
1468
- } else if (
1469
- propertyParams.forbidden &&
1470
- propertyValue !== undefined
1471
- ) {
1472
- throw new DyFM_Error({
1473
- ...this._getDefaultErrorSettings(
1474
- 'validateProperty',
1475
- new Error(
1476
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is forbidden! ` +
1477
- `(${this.dataParams.dataName}) ` +
1478
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1479
- )
1480
- ),
1481
-
1482
- status: 400,
1483
- errorCode: `${this.ecBase}DyNTS-DS0-VP2`,
1484
- userMessage: this.defaultValidationErrorUserMsg,
1485
- validationErrors: {
1486
- [propertyParams.key]: {
1487
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is forbidden! ` +
1488
- `(${this.dataParams.dataName}) ` +
1489
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1490
- code: `${this.ecBase}DyNTS-DS0-VP2`,
1491
- userMessage: 'The property modification is forbidden!',
1492
- },
1493
- },
1494
- __localStack: this.dataParams.stackLocation,
1495
- additionalContent: {
1496
- data: data,
1497
- },
1498
- });
1499
- }
1500
-
1501
- // specific Date validation
1502
- switch (propertyParams.type) {
1503
- case DyFM_BasicProperty_Type.date:
1504
- const date = new Date(propertyValue);
1505
- if (
1506
- propertyParams.required && (
1507
- !(date instanceof Date) ||
1508
- date.toString() === 'Invalid Date' ||
1509
- isNaN(date.getTime()) ||
1510
- date.toString() === new Date(0).toString()
1511
- )
1512
- ) {
1513
- throw new DyFM_Error({
1514
- ...this._getDefaultErrorSettings(
1515
- 'validateProperty',
1516
- new Error(
1517
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid date! ` +
1518
- `(${this.dataParams.dataName})` +
1519
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1520
- )
1521
- ),
1522
-
1523
- status: 400,
1524
- errorCode: `${this.ecBase}DyNTS-DS0-VP3`,
1525
- userMessage: this.defaultValidationErrorUserMsg,
1526
- validationErrors: {
1527
- [propertyParams.key]: {
1528
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid date! ` +
1529
- `(${this.dataParams.dataName})` +
1530
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1531
- code: `${this.ecBase}DyNTS-DS0-VP3`,
1532
- userMessage: 'The property is required and must be a valid date!',
1533
- },
1534
- },
1535
- __localStack: this.dataParams.stackLocation,
1536
- additionalContent: {
1537
- data: data,
1538
- },
1539
- });
1540
- }
1541
- break;
1542
-
1543
- case DyFM_BasicProperty_Type.number:
1544
- if (propertyParams.required && isNaN(propertyValue)) {
1545
- throw new DyFM_Error({
1546
- ...this._getDefaultErrorSettings(
1547
- 'validateProperty',
1548
- new Error(
1549
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid number! ` +
1550
- `(${this.dataParams.dataName})` +
1551
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1552
- )
1553
- ),
1554
-
1555
- status: 400,
1556
- errorCode: `${this.ecBase}DyNTS-DS0-VP4`,
1557
- userMessage: this.defaultValidationErrorUserMsg,
1558
- validationErrors: {
1559
- [propertyParams.key]: {
1560
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid number! ` +
1561
- `(${this.dataParams.dataName})` +
1562
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1563
- code: `${this.ecBase}DyNTS-DS0-VP4`,
1564
- userMessage: 'The property is required and must be a valid number!',
1565
- },
1566
- },
1567
- __localStack: this.dataParams.stackLocation,
1568
- additionalContent: {
1569
- data: data,
1570
- },
1571
- });
1572
- }
1573
- break;
1574
-
1575
- case DyFM_BasicProperty_Type.string:
1576
- if (propertyParams.required && typeof propertyValue !== 'string') {
1577
- throw new DyFM_Error({
1578
- ...this._getDefaultErrorSettings(
1579
- 'validateProperty',
1580
- new Error(
1581
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid string! ` +
1582
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1583
- `(${this.dataParams.dataName})` +
1584
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1585
- )
1586
- ),
1587
-
1588
- status: 400,
1589
- errorCode: `${this.ecBase}DyNTS-DS0-VP5`,
1590
- userMessage: this.defaultValidationErrorUserMsg,
1591
- validationErrors: {
1592
- [propertyParams.key]: {
1593
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid string! ` +
1594
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1595
- `(${this.dataParams.dataName})` +
1596
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1597
- code: `${this.ecBase}DyNTS-DS0-VP5`,
1598
- userMessage: 'The property is required and must be a valid string!',
1599
- },
1600
- },
1601
- __localStack: this.dataParams.stackLocation,
1602
- additionalContent: {
1603
- data: data,
1604
- },
1605
- });
1606
- }
1607
- break;
1608
-
1609
- case DyFM_BasicProperty_Type.boolean:
1610
- if (propertyParams.required && typeof propertyValue !== 'boolean') {
1611
- throw new DyFM_Error({
1612
- ...this._getDefaultErrorSettings(
1613
- 'validateProperty',
1614
- new Error(
1615
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid boolean! ` +
1616
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1617
- `(${this.dataParams.dataName})` +
1618
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1619
- )
1620
- ),
1621
-
1622
- status: 400,
1623
- errorCode: `${this.ecBase}DyNTS-DS0-VP6`,
1624
- userMessage: this.defaultValidationErrorUserMsg,
1625
- validationErrors: {
1626
- [propertyParams.key]: {
1627
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid boolean! ` +
1628
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1629
- `(${this.dataParams.dataName})` +
1630
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1631
- code: `${this.ecBase}DyNTS-DS0-VP6`,
1632
- userMessage: 'The property is required and must be a valid boolean!',
1633
- },
1634
- },
1635
- __localStack: this.dataParams.stackLocation,
1636
- });
1637
- }
1638
- break;
1639
-
1640
- case DyFM_BasicProperty_Type.object:
1641
- if (propertyParams.required && typeof propertyValue !== 'object') {
1642
- throw new DyFM_Error({
1643
- ...this._getDefaultErrorSettings(
1644
- 'validateProperty',
1645
- new Error(
1646
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid object! ` +
1647
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1648
- `(${this.dataParams.dataName})` +
1649
- (data as any)?.name ? `\n That failed data's name: ${(data as any).name}` : ''
1650
- )
1651
- ),
1652
-
1653
- status: 400,
1654
- errorCode: `${this.ecBase}DyNTS-DS0-VP7`,
1655
- userMessage: this.defaultValidationErrorUserMsg,
1656
- validationErrors: {
1657
- [propertyParams.key]: {
1658
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid object! ` +
1659
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1660
- `(${this.dataParams.dataName})` +
1661
- (data as any)?.name ? `\n That failed data's name: ${(data as any).name}` : '',
1662
- code: `${this.ecBase}DyNTS-DS0-VP7`,
1663
- userMessage: 'The property is required and must be an object!',
1664
- },
1665
- },
1666
- __localStack: this.dataParams.stackLocation,
1667
- });
1668
- }
1669
-
1670
- if (propertyParams.subObjectParams) {
1671
- this.validateDataByPropertyParams(propertyValue, propertyParams.subObjectParams, propertyParams);
1672
- }
1673
- break;
1674
-
1675
- case DyFM_BasicProperty_Type.array:
1676
- if (propertyParams.required && (!Array.isArray(propertyValue) || !propertyValue.length)) {
1677
- throw new DyFM_Error({
1678
- ...this._getDefaultErrorSettings(
1679
- 'validateProperty',
1680
- new Error(
1681
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid array! ` +
1682
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1683
- `(${this.dataParams.dataName})` +
1684
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1685
- )
1686
- ),
1687
-
1688
- status: 400,
1689
- errorCode: `${this.ecBase}DyNTS-DS0-VP8`,
1690
- userMessage: this.defaultValidationErrorUserMsg,
1691
- validationErrors: {
1692
- [propertyParams.key]: {
1693
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid array! ` +
1694
- `(type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1695
- `(${this.dataParams.dataName})` +
1696
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1697
- code: `${this.ecBase}DyNTS-DS0-VP8`,
1698
- userMessage: 'The property is required and must be a valid array!',
1699
- },
1700
- },
1701
- __localStack: this.dataParams.stackLocation,
1702
- });
1703
- }
1704
-
1705
- // BFR-FDPTOKENSERVICE-011: csak TÉNYLEGES tömbnél szállunk le a sub-objektumokba — egy
1706
- // OPCIONÁLIS `X[]` mező `undefined` értéke (a normál „még nincs elem" eset) nem dönthet
1707
- // `forEach`-TypeError-ba; a required-hiányt a fenti VP8-ág fogja, ez az őr nem gyengít.
1708
- if (propertyParams.subObjectParams && Array.isArray(propertyValue)) {
1709
- propertyValue.forEach((item: any): void => {
1710
- this.validateDataByPropertyParams(item, propertyParams.subObjectParams, propertyParams);
1711
- });
1712
- }
1713
- break;
1714
-
1715
- case DyFM_BasicProperty_Type.function:
1716
- DyFM_Log.warn(
1717
- 'validateProperty: function type is not supported yet! ' +
1718
- '(it will be skipped, but you still can use it in additionalValidators)'
1719
- );
1720
- /* if (propertyParams.required && typeof propertyValue !== 'function') {
1721
- throw new DyFM_Error({
1722
- ...this._getDefaultErrorSettings(
1723
- 'validateProperty',
1724
- new Error(
1725
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid function! ` +
1726
- `(${this.dataParams.dataName})` +
1727
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1728
- )
1729
- ),
1730
-
1731
- status: 400,
1732
- errorCode: `${this.ecBase}VP9`,
1733
- userMessage: this.defaultValidationErrorUserMsg,
1734
- validationErrors: {
1735
- [propertyParams.key]: {
1736
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid function! ` +
1737
- `(${this.dataParams.dataName})` +
1738
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1739
- code: `${this.ecBase}DyNTS-DS0-VP9`,
1740
- userMessage: 'The property is required and must be a valid function!',
1741
- },
1742
- },
1743
- __localStack: this.dataParams.stackLocation,
1744
- });
1745
- } */
1746
- break;
1747
-
1748
- default:
1749
- throw new DyFM_Error({
1750
- ...this._getDefaultErrorSettings(
1751
- 'validateProperty',
1752
- new Error(
1753
- `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid property type! ` +
1754
- `(type: ${propertyParams.type}, nonBasicType: ${propertyParams.nonBasicType}) ` +
1755
- `(value type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1756
- `(${this.dataParams.dataName})` +
1757
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : '')
1758
- )
1759
- ),
1760
-
1761
- status: 400,
1762
- errorCode: `${this.ecBase}DyNTS-DS0-VP10`,
1763
- userMessage: this.defaultValidationErrorUserMsg,
1764
- validationErrors: {
1765
- [propertyParams.key]: {
1766
- message: `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid property type! ` +
1767
- `(type: ${propertyParams.type}, nonBasicType: ${propertyParams.nonBasicType}) ` +
1768
- `(value type: ${typeof propertyValue}, value: "${propertyValue}") ` +
1769
- `(${this.dataParams.dataName})` +
1770
- ((data as any)?.name ? `\n The failed data's name: ${(data as any).name}` : ''),
1771
- code: `${this.ecBase}DyNTS-DS0-VP10`,
1772
- userMessage: 'The property is required and must be a valid property type!',
1773
- },
1774
- },
1775
- __localStack: this.dataParams.stackLocation,
1776
- });
1777
- }
1778
-
1779
- // call additional validators
1780
- if (propertyParams.additionalValidators) {
1781
- for (let j = 0; j < propertyParams.additionalValidators.length; j++) {
1782
- propertyParams.additionalValidators[j](
1783
- propertyValue,
1784
- data
1785
- );
1786
- }
1787
- }
1788
- }
1789
-
1790
- /**
1791
- * Search the data list based on the search query
1792
- * Sorts and filters the data list based on the search query
1793
- *
1794
- * ⚠️ **BFR-OVERSEER-011 — a lapozás MEMÓRIÁBAN történik, a `pageSize` NEM DB-limit!**
1795
- * A metódus a TELJES (elő-szűrt) kollekciót betölti (`findDataList`/`getAll` limit nélkül),
1796
- * memóriában rendez/szűr, és CSAK UTÁNA `slice`-ol — egy `searchData({ pageSize: 1 })` is a
1797
- * teljes kollekciót húzza a heap-be (mért incidens: GC-thrash + event-loop-megállás nagy
1798
- * kollekción). **Mikor MIT használj:**
1799
- * - lapozott lekérdezés nagy kollekción → `DyNTS_DBService.findWithPaging(filter, page, pageSize, sort)`
1800
- * (DB-szintű `.skip().limit()`);
1801
- * - „legfrissebb N" → `findDataList(filter, undefined, { projection, sort, limit })`;
1802
- * - `searchData` CSAK kis/korlátos kollekcióra vagy már memóriában lévő `dataList`-re való
1803
- * (komplex, memóriabeli szűrés/rendezés).
1804
- *
1805
- * NOTE: For more simple and with better performance and if you don't need sorting, use findDataList instead.
1806
- *
1807
- * @example
1808
- * ```ts
1809
- * const searchResult = await this.searchData({
1810
- * filterBy: {
1811
- * name: 'John Doe',
1812
- * },
1813
- * sortBy: [
1814
- * { key: 'name', order: 1 },
1815
- * ],
1816
- * });
1817
- * ```
1818
- */
1819
- async searchData(query?: DyFM_SearchQuery<T>, dataList?: T[]): Promise<DyFM_SearchResult<T>> {
1820
- try {
1821
- const searchResult = await this.sortAndFilterDataList(query, dataList);
1822
-
1823
- if (query.page !== undefined && query.pageSize !== undefined) {
1824
- const start = query.page * query.pageSize;
1825
- const end = start + query.pageSize;
1826
-
1827
- searchResult.results = searchResult.results.slice(start, end);
1828
- }
1829
-
1830
- return searchResult;
1831
- } catch (error) {
1832
- throw new DyFM_Error({
1833
- ...this._getDefaultErrorSettings('searchData', error),
1834
-
1835
- errorCode: `${this.ecBase}DyNTS-DS0-SD0`,
1836
- });
1837
- }
1838
- }
1839
-
1840
- async sortAndFilterDataList(
1841
- query: DyFM_SearchQuery<T>,
1842
- dataList?: T[]
1843
- ): Promise<DyFM_SearchResult<T>> {
1844
- try {
1845
- if (!query.filterBy) {
1846
- query.filterBy = {};
1847
- }
1848
-
1849
- if (!query.page) {
1850
- query.page = 0;
1851
- }
1852
-
1853
- if (!query.pageSize) {
1854
- DyFM_Log.warn(
1855
- `searchData pageSize is not setted, setting to ${DyNTS_global_settings.defaultPageSize}.`
1856
- );
1857
- query.pageSize = DyNTS_global_settings.defaultPageSize;
1858
- }
1859
-
1860
- if (!query.sortBy?.length) {
1861
- query.sortBy = [{ key: '__lastModified', order: -1 }];
1862
- }
1863
-
1864
- query.sortBy.reverse();
1865
-
1866
- let preFilter: DyFM_DBFilter<T> = {};
1867
-
1868
- Object.keys(query.filterBy).forEach((key: string) => {
1869
- if (
1870
- typeof query.filterBy[key] === 'object' &&
1871
- Object.keys(query.filterBy[key]).includes('$')
1872
- ) {
1873
- (preFilter as any)[key] = query.filterBy[key] as DyFM_DBFilterExpressions<T[keyof T]>;
1874
- delete query.filterBy[key];
1875
- }
1876
- });
1877
-
1878
- if (!dataList) {
1879
- if (Object.keys(preFilter).length) {
1880
- dataList = await this.findDataList(preFilter);
1881
- } else {
1882
- dataList = await this.getAll();
1883
- }
1884
-
1885
- // BFR-OVERSEER-011 (b) runtime-guard: a memóriabeli lapozás a TELJES kollekciót húzza be —
1886
- // nagy halmazon ez GC-thrash-t okoz (mért incidens: ~43k dok/host, event-loop-megállás).
1887
- // A warn a hívóhelyet AZONNAL felszínre hozza, incidens előtt.
1888
- if (dataList.length > DyNTS_SEARCHDATA_INMEMORY_WARN_THRESHOLD) {
1889
- DyFM_Log.warn(
1890
- `searchData('${this.dataParams.dataName}'): ${dataList.length} docs loaded INTO MEMORY for ` +
1891
- `in-memory paging (pageSize is NOT a DB-limit!). For paged queries use ` +
1892
- `DyNTS_DBService.findWithPaging(); for "latest N" use findDataList(filter, undefined, ` +
1893
- `{ projection, sort, limit }).`
1894
- );
1895
- }
1896
- } else {
1897
- if (Object.keys(preFilter).length) {
1898
- DyFM_Log.H_warn(
1899
- 'prefilters not supported when dataList is set! (will be ignored the following keys: ' +
1900
- Object.keys(preFilter).map((key: string) => `"${key}"`).join(', ') +
1901
- ')'
1902
- );
1903
- }
1904
- }
1905
-
1906
- const filterKeys: string[] = Object.keys(query.filterBy);
1907
- const filterFunctionsByKey: { [key: string]: (dataProperty) => boolean } = {};
1908
-
1909
- const addFilterKeys: string[] = [];
1910
- const removeFilterKeys: string[] = [];
1911
-
1912
- filterKeys.forEach((key: string): void => {
1913
- const filterBy = query.filterBy[key];
1914
-
1915
- if (filterBy.isSpecialNestSearch) {
1916
- filterBy.nestedPropertySearches.forEach((nestSearch: DyFM_NestPropertySearch<any>): void => {
1917
- const nestKey = nestSearch.nestKeys.join('.');
1918
- filterFunctionsByKey[nestKey] = this.getFilterFunctionForKey(
1919
- nestKey,
1920
- nestSearch.search,
1921
- nestSearch.valueType
1922
- );
1923
- query.filterBy[nestKey] = nestSearch;
1924
- addFilterKeys.push(nestKey);
1925
- });
1926
- removeFilterKeys.push(key);
1927
- } else {
1928
- filterFunctionsByKey[key] = this.getFilterFunctionForKey(key, filterBy);
1929
- }
1930
- });
1931
-
1932
- addFilterKeys.forEach((key: string): void => {
1933
- filterKeys.push(key);
1934
- });
1935
- removeFilterKeys.forEach((key: string): void => {
1936
- filterKeys.splice(filterKeys.indexOf(key), 1);
1937
- });
1938
-
1939
- query.sortBy.forEach((sort: DyFM_DSSort): void => {
1940
- dataList.sort(this.getSortFunctionForKey(sort));
1941
- });
1942
-
1943
- if (filterKeys.some((key: string): boolean => key.includes('.'))) {
1944
- const keyResolvers: { [key: string]: (data: T) => any } = {};
1945
-
1946
- filterKeys.forEach((key: string): void => {
1947
- if (key.includes('.')) {
1948
- if (!query.filterBy[key].nestKeys) {
1949
- throw new DyFM_Error({
1950
- ...this._getDefaultErrorSettings(
1951
- 'searchData',
1952
- new Error(
1953
- `searchData failed, nestKeys missing from nestedPropertySearch! ` +
1954
- `(${this.dataParams.dataName})`
1955
- )
1956
- ),
1957
-
1958
- errorCode: `${this.ecBase}DyNTS-DS0-SD1`,
1959
- });
1960
- }
1961
-
1962
- keyResolvers[key] = this.getKeyResolver(query.filterBy[key].nestKeys);
1963
- } else {
1964
- keyResolvers[key] = (data: T): any => data[key];
1965
- }
1966
- });
1967
-
1968
- if (filterKeys.some((key: string): boolean => query.filterBy[key].isSpecialNestSearch)) {
1969
- dataList = dataList.filter(
1970
- (data: T): boolean => filterKeys.every(
1971
- (key: string): boolean => query.filterBy[key].isSpecialNestSearch ?
1972
- keyResolvers[key](data).some(
1973
- (dataProperty: any): boolean => filterFunctionsByKey[key](dataProperty)
1974
- ) :
1975
- filterFunctionsByKey[key](keyResolvers[key](data))
1976
- )
1977
- );
1978
- } else {
1979
- dataList = dataList.filter(
1980
- (data: T): boolean => filterKeys.every(
1981
- (key: string): boolean => filterFunctionsByKey[key](keyResolvers[key](data))
1982
- )
1983
- );
1984
- }
1985
- } else {
1986
- dataList = dataList.filter(
1987
- (data: T): boolean => filterKeys.every(
1988
- (key: string): boolean => filterFunctionsByKey[key](data[key])
1989
- )
1990
- );
1991
- }
1992
-
1993
- return {
1994
- results: dataList,
1995
- totalItems: dataList.length,
1996
- };
1997
- } catch (error) {
1998
- throw new DyFM_Error({
1999
- ...this._getDefaultErrorSettings('searchData', error),
2000
-
2001
- errorCode: `${this.ecBase}DyNTS-DS0-SD0`,
2002
- });
2003
- }
2004
- }
2005
-
2006
- protected getFilterFunctionForKey<T, N>(
2007
- key: string,
2008
- searchValue: T | T[] | DyFM_RangeValue<T> | DyFM_SpecialSearch<N>,
2009
- propertyType?: DyFM_BasicProperty_Type
2010
- ): (dataProperty) => boolean {
2011
- try {
2012
- if (searchValue === undefined) {
2013
- throw new DyFM_Error({
2014
- ...this._getDefaultErrorSettings(
2015
- 'getFilterFunctionForKey',
2016
- new Error(
2017
- `getFilterFunctionForKey failed, searchValue is missing for key: "${key}" ` +
2018
- `(${this.dataParams.dataName})`
2019
- )
2020
- ),
2021
-
2022
- errorCode: `${this.ecBase}DyNTS-DS0-GFF1`,
2023
- });
2024
- }
2025
-
2026
- if (key.includes('.')) {
2027
- if (!propertyType) {
2028
- throw new DyFM_Error({
2029
- ...this._getDefaultErrorSettings(
2030
- 'getFilterFunctionForKey',
2031
- new Error(
2032
- `getFilterFunctionForKey failed, propertyType is missing for key: "${key}" ` +
2033
- `(${this.dataParams.dataName})`
2034
- )
2035
- ),
2036
-
2037
- errorCode: `${this.ecBase}DyNTS-DS0-GFF3`,
2038
- });
2039
- }
2040
- } else {
2041
- if (!this.dataParams.properties[key]) {
2042
- throw new DyFM_Error({
2043
- ...this._getDefaultErrorSettings(
2044
- 'getFilterFunctionForKey',
2045
- new Error(
2046
- `getFilterFunctionForKey failed, key not found in dataParams: "${key}" ` +
2047
- `(${this.dataParams.dataName})`
2048
- )
2049
- ),
2050
-
2051
- errorCode: `${this.ecBase}DyNTS-DS0-GFF2`,
2052
- });
2053
- }
2054
-
2055
- propertyType = this.dataParams.properties[key].type;
2056
- }
2057
-
2058
- switch (propertyType) {
2059
- case DyFM_BasicProperty_Type.string:
2060
- if (typeof searchValue !== 'string') {
2061
- throw new DyFM_Error({
2062
- ...this._getDefaultErrorSettings(
2063
- 'getFilterFunctionForKey',
2064
- new Error(
2065
- `getFilterFunctionForKey failed, searchValue is not a string! ` +
2066
- `(${this.dataParams.dataName})`
2067
- )
2068
- ),
2069
-
2070
- errorCode: `${this.ecBase}DyNTS-DS0-GFF4`,
2071
- });
2072
- }
2073
-
2074
- if (Array.isArray(searchValue)) {
2075
- const lowerCaseSearchValueArray: string[] = (searchValue as string[]).filter(
2076
- (searchString: string): boolean => Boolean(searchString)
2077
- ).map(
2078
- (searchString: string): string => searchString.toLowerCase()
2079
- );
2080
-
2081
- return (dataProperty: string): boolean => {
2082
- // Convert to string if not already a string (handles numbers, etc.)
2083
- const dataPropertyAsString: string =
2084
- dataProperty != null ? String(dataProperty) : '';
2085
- return lowerCaseSearchValueArray.some(
2086
- (searchString: string): boolean =>
2087
- dataPropertyAsString?.toLowerCase().includes(searchString)
2088
- );
2089
- };
2090
- } else {
2091
- const lowerCaseSearchValue: string = (searchValue as string)?.toLowerCase();
2092
-
2093
- if (!lowerCaseSearchValue) {
2094
- return (dataProperty: string): boolean => !dataProperty;
2095
- }
2096
-
2097
- return (dataProperty: string): boolean => {
2098
- // Convert to string if not already a string (handles numbers, etc.)
2099
- const dataPropertyAsString: string =
2100
- dataProperty != null ? String(dataProperty) : '';
2101
- return dataPropertyAsString?.toLowerCase().includes(lowerCaseSearchValue);
2102
- };
2103
- }
2104
-
2105
- case DyFM_BasicProperty_Type.date:
2106
- if ((searchValue as DyFM_RangeValue).isRange) {
2107
- if (
2108
- (searchValue as DyFM_RangeValue).from === undefined ||
2109
- (searchValue as DyFM_RangeValue).from === null
2110
- ) {
2111
- const toAsNumber = +new Date((searchValue as DyFM_RangeValue).to);
2112
-
2113
- return (dataProperty): boolean => +new Date(dataProperty) <= toAsNumber;
2114
- } else if (
2115
- (searchValue as DyFM_RangeValue).to === undefined ||
2116
- (searchValue as DyFM_RangeValue).to === null
2117
- ) {
2118
- const fromAsNumber = +new Date((searchValue as DyFM_RangeValue).from);
2119
-
2120
- return (dataProperty): boolean => +new Date(dataProperty) >= fromAsNumber;
2121
- }
2122
-
2123
- const rangeAsNumber = new DyFM_RangeValue<number>(
2124
- +new Date((searchValue as DyFM_RangeValue).from),
2125
- +new Date((searchValue as DyFM_RangeValue).to)
2126
- );
2127
-
2128
- return (dataProperty): boolean => DyFM_RangeValue.isInRange(
2129
- +new Date(dataProperty), rangeAsNumber
2130
- );
2131
- }
2132
-
2133
- if (Array.isArray(searchValue)) {
2134
- const searchValueAsNumberArray: number[] = (searchValue as Date[]).map(
2135
- (date: Date): number => +new Date(date)
2136
- );
2137
-
2138
- return (dataProperty): boolean => searchValueAsNumberArray.includes(+new Date(dataProperty));
2139
- }
2140
-
2141
- const searchValueAsNumber: number = +new Date(searchValue as Date);
2142
-
2143
- return (dataProperty): boolean => +new Date(dataProperty) === searchValueAsNumber;
2144
-
2145
- case DyFM_BasicProperty_Type.number:
2146
- if ((searchValue as DyFM_RangeValue).isRange) {
2147
- if (
2148
- (searchValue as DyFM_RangeValue).from === undefined ||
2149
- (searchValue as DyFM_RangeValue).from === null
2150
- ) {
2151
- return (dataProperty): boolean => dataProperty <= (searchValue as DyFM_RangeValue).to;
2152
- } else if (
2153
- (searchValue as DyFM_RangeValue).to === undefined ||
2154
- (searchValue as DyFM_RangeValue).to === null
2155
- ) {
2156
- return (dataProperty): boolean => dataProperty >= (searchValue as DyFM_RangeValue).from;
2157
- }
2158
-
2159
- return (dataProperty): boolean => DyFM_RangeValue.isInRange(
2160
- dataProperty, searchValue as DyFM_RangeValue<number>
2161
- );
2162
- }
2163
-
2164
- if (Array.isArray(searchValue)) {
2165
- return (dataProperty): boolean => (searchValue as number[]).includes(dataProperty);
2166
- }
2167
-
2168
- return (dataProperty): boolean => dataProperty === searchValue;
2169
-
2170
- case DyFM_BasicProperty_Type.boolean:
2171
- return (dataProperty): boolean => dataProperty === searchValue;
2172
-
2173
- case DyFM_BasicProperty_Type.object:
2174
- if (Array.isArray(searchValue)) {
2175
- throw new DyFM_Error({
2176
- ...this._getDefaultErrorSettings(
2177
- 'getFilterFunctionForKey',
2178
- new Error(
2179
- `getFilterFunctionForKey failed, array search not implemented for this type ` +
2180
- `(${this.dataParams.dataName})`
2181
- )
2182
- ),
2183
-
2184
- errorCode: `${this.ecBase}DyNTS-DS0-GFF5`,
2185
- });
2186
- }
2187
-
2188
- return (dataProperty): boolean => {
2189
- const searchValueKeys: string[] = Object.keys(searchValue as object);
2190
- const stringifiedSearchValue = {};
2191
-
2192
- try {
2193
- searchValueKeys.forEach(
2194
- (key: string): void => {
2195
- stringifiedSearchValue[key] = JSON.stringify(searchValue[key]);
2196
- }
2197
- );
2198
- } catch (error) {
2199
- throw new DyFM_Error({
2200
- ...this._getDefaultErrorSettings(
2201
- 'getFilterFunctionForKey',
2202
- new Error(
2203
- `getFilterFunctionForKey failed, object search failed! ` +
2204
- `(${this.dataParams.dataName})`
2205
- )
2206
- ),
2207
-
2208
- errorCode: `${this.ecBase}DyNTS-DS0-GFF6`,
2209
- additionalContent: {
2210
- searchValue: searchValue,
2211
- },
2212
- });
2213
- }
2214
-
2215
- return searchValueKeys.every(
2216
- (key: string): boolean => {
2217
- try {
2218
- return stringifiedSearchValue[key] === JSON.stringify(dataProperty[key]);
2219
- } catch (error) {
2220
- console.error(
2221
- 'object filter returning false, bc of an error',
2222
- 'searchValue:', searchValue,
2223
- 'dataProperty:', dataProperty,
2224
- 'key:', key,
2225
- 'error:', error
2226
- );
2227
- return false;
2228
- }
2229
- }
2230
- );
2231
- }
2232
-
2233
- default:
2234
- if ((searchValue as DyFM_RangeValue).isRange) {
2235
- throw new DyFM_Error({
2236
- ...this._getDefaultErrorSettings(
2237
- 'getFilterFunctionForKey',
2238
- new Error(
2239
- `getFilterFunctionForKey failed, range search not implemented for this type ` +
2240
- `(${this.dataParams.dataName})`
2241
- )
2242
- ),
2243
-
2244
- errorCode: `${this.ecBase}DyNTS-DS0-GFF7`,
2245
- });
2246
- }
2247
-
2248
- if (Array.isArray(searchValue)) {
2249
- return (dataProperty): boolean => (searchValue as number[]).includes(dataProperty);
2250
- }
2251
-
2252
- return (dataProperty): boolean => dataProperty === searchValue;
2253
- }
2254
- } catch (error) {
2255
- throw new DyFM_Error({
2256
- ...this._getDefaultErrorSettings(
2257
- 'getFilterFunctionForKey',
2258
- error
2259
- ),
2260
-
2261
- errorCode: `${this.ecBase}DyNTS-DS0-GFF0`,
2262
- additionalContent: {
2263
- key: key,
2264
- searchValue: searchValue,
2265
- propertyType: propertyType,
2266
- },
2267
- });
2268
- }
2269
- }
2270
-
2271
- /**
2272
- * Get the value of a nested key.
2273
- * @param nestKeys - The nested keys to resolve.
2274
- * @returns The value of the nested key.
2275
- */
2276
- private getKeyResolver(nestKeys: string[]): (data: T) => any {
2277
- return (data: T): any => {
2278
- let value: any = data;
2279
-
2280
- nestKeys.forEach((nestKey: string): void => {
2281
- if (!value) {
2282
- return;
2283
- }
2284
-
2285
- if (nestKey === '*') {
2286
- // Wildcard: ha value egy tömb, akkor minden elemet visszaadunk
2287
- // A következő nestKey minden elemre alkalmazva lesz
2288
- if (Array.isArray(value)) {
2289
- // value marad tömb, a következő nestKey minden elemre alkalmazva lesz
2290
- // Nem változtatjuk meg a value-t, hogy a következő iterációban
2291
- // a tömb minden elemére alkalmazva legyen a következő nestKey
2292
- } else if (value && typeof value === 'object') {
2293
- // Ha objektum, akkor az értékeit adja vissza tömbként
2294
- value = Object.values(value);
2295
- } else {
2296
- // Egyébként undefined
2297
- value = undefined;
2298
- }
2299
- } else if (Array.isArray(value)) {
2300
- // Ha value tömb, akkor minden elemre alkalmazzuk a nestKey-t
2301
- if (!isNaN(+nestKey)) {
2302
- value = value[+nestKey];
2303
- } else {
2304
- value = value.map((element: any): any => element ? element[nestKey] : element);
2305
- }
2306
- } else {
2307
- value = value[nestKey];
2308
- }
2309
- });
2310
-
2311
- return value;
2312
- };
2313
- }
2314
-
2315
- /**
2316
- * Get the sort function for a key.
2317
- * @param sortSettings - The sort settings.
2318
- * @returns The sort function for the key.
2319
- */
2320
- protected getSortFunctionForKey<T>(sortSettings: DyFM_DSSort): (a: T, b: T) => number {
2321
- let keyResolver: (data: any) => any;
2322
- let valueType: DyFM_BasicProperty_Type;
2323
-
2324
- if (
2325
- !this.dataParams.properties[(sortSettings as DyFM_DSPropertySort).key] &&
2326
- !(sortSettings as DyFM_DSNestedPropertySort).isNestedPropertySort
2327
- ) {
2328
- throw new DyFM_Error({
2329
- ...this._getDefaultErrorSettings(
2330
- 'getSortFunctionForKey',
2331
- new Error(
2332
- `getSortFunctionForKey failed, key not found in dataParams ` +
2333
- `(${this.dataParams.dataName})`
2334
- )
2335
- ),
2336
-
2337
- errorCode: `${this.ecBase}DyNTS-DS0-GSF1`,
2338
- });
2339
- }
2340
-
2341
- if ((sortSettings as DyFM_DSNestedPropertySort).isNestedPropertySort) {
2342
- keyResolver = this.getKeyResolver((sortSettings as DyFM_DSNestedPropertySort).nestKeys);
2343
- valueType = (sortSettings as DyFM_DSNestedPropertySort).valueType;
2344
- } else {
2345
- keyResolver = (data: T): any => data[(sortSettings as DyFM_DSPropertySort).key];
2346
- valueType = this.dataParams.properties[(sortSettings as DyFM_DSPropertySort).key].type;
2347
- }
2348
-
2349
- if (!valueType) {
2350
- throw new DyFM_Error({
2351
- ...this._getDefaultErrorSettings(
2352
- 'getSortFunctionForKey',
2353
- new Error(
2354
- `getSortFunctionForKey failed, valueType is missing! ` +
2355
- `(${this.dataParams.dataName})`
2356
- )
2357
- ),
2358
-
2359
- errorCode: `${this.ecBase}DyNTS-DS0-GSF1`,
2360
- });
2361
- }
2362
-
2363
- const sortValue: 1 | -1 = (
2364
- sortSettings.order === 1 ||
2365
- sortSettings.order === 'asc' ||
2366
- sortSettings.order === 'ascending'
2367
- ) ? 1 : -1;
2368
-
2369
- switch (valueType) {
2370
- case DyFM_BasicProperty_Type.string:
2371
- return (a: T, b: T): number => {
2372
- a = keyResolver(a);
2373
- b = keyResolver(b);
2374
-
2375
- return (a as string).localeCompare(b as string) * sortValue;
2376
- }
2377
-
2378
- case DyFM_BasicProperty_Type.date:
2379
- return (a: T, b: T): number => {
2380
- const aNum = +new Date(keyResolver(a));
2381
- const bNum = +new Date(keyResolver(b));
2382
-
2383
- if (aNum < bNum) {
2384
- return -sortValue;
2385
- } else if (aNum > bNum) {
2386
- return sortValue;
2387
- } else {
2388
- return 0;
2389
- }
2390
- };
2391
-
2392
- case DyFM_BasicProperty_Type.number:
2393
- return (a: T, b: T): number => {
2394
- a = keyResolver(a);
2395
- b = keyResolver(b);
2396
-
2397
- if (a < b) {
2398
- return -sortValue;
2399
- } else if (a > b) {
2400
- return sortValue;
2401
- } else {
2402
- return 0;
2403
- }
2404
- };
2405
-
2406
- case DyFM_BasicProperty_Type.boolean:
2407
- return (a: T, b: T): number => {
2408
- a = keyResolver(a);
2409
- b = keyResolver(b);
2410
-
2411
- if (a === b) {
2412
- return 0;
2413
- }
2414
-
2415
- if (a) {
2416
- return sortValue;
2417
- }
2418
-
2419
- return -sortValue;
2420
- };
2421
-
2422
- default:
2423
- throw new DyFM_Error({
2424
- ...this._getDefaultErrorSettings(
2425
- 'getSortFunctionForKey',
2426
- new Error(
2427
- `getSortFunctionForKey failed, sorting not implemented for this type ` +
2428
- `(${this.dataParams.dataName}, ${valueType})`
2429
- )
2430
- ),
2431
-
2432
- errorCode: `${this.ecBase}DyNTS-DS0-GSF2`,
2433
- });
2434
- }
2435
- }
2436
-
2437
- /* private getSortFunctionForNestedKeys<T>(
2438
- sortSettings: DyFM_DSNestedPropertySort
2439
- ): (a: T, b: T) => number {
2440
- const nestedPropertyResolver: (data) => any = this.getKeyResolver(sortSettings.nestKeys);
2441
-
2442
- const sortValue: 1 | -1 = (
2443
- sortSettings.order === 1 ||
2444
- sortSettings.order === 'asc' ||
2445
- sortSettings.order === 'ascending'
2446
- ) ? 1 : -1;
2447
-
2448
- switch (sortSettings.valueType) {
2449
- case DyFM_BasicProperty_Type.string:
2450
- return (a: T, b: T): number => {
2451
- a = nestedPropertyResolver(a);
2452
- b = nestedPropertyResolver(b);
2453
-
2454
- return (a as string).localeCompare(b as string) * sortValue
2455
- };
2456
-
2457
- case DyFM_BasicProperty_Type.date:
2458
- return (a: T, b: T): number => {
2459
- a = nestedPropertyResolver(a);
2460
- b = nestedPropertyResolver(b);
2461
-
2462
- if (+new Date(a) < +new Date(b)) {
2463
- return -sortValue;
2464
- } else if (+new Date(a) > +new Date(b)) {
2465
- return sortValue;
2466
- } else {
2467
- return 0;
2468
- }
2469
- };
2470
-
2471
- case DyFM_BasicProperty_Type.number:
2472
- return (a: T, b: T): number => {
2473
- a = nestedPropertyResolver(a);
2474
- b = nestedPropertyResolver(b);
2475
-
2476
- if (a < b) {
2477
- return -sortValue;
2478
- } else if (a > b) {
2479
- return sortValue;
2480
- } else {
2481
- return 0;
2482
- }
2483
- };
2484
-
2485
- case DyFM_BasicProperty_Type.boolean:
2486
- return (a: T, b: T): number => {
2487
- a = nestedPropertyResolver(a);
2488
- b = nestedPropertyResolver(b);
2489
-
2490
- if (a === b) {
2491
- return 0;
2492
- }
2493
-
2494
- if (a) {
2495
- return sortValue;
2496
- }
2497
-
2498
- return -sortValue;
2499
- };
2500
-
2501
- default:
2502
- throw new DyFM_Error({
2503
- ...this._getDefaultErrorSettings(
2504
- 'getSortFunctionForKey',
2505
- new Error(
2506
- `getSortFunctionForKey failed, sorting not implemented for this type ` +
2507
- `(${this.dataParams.dataName}, ${this.dataParams.properties[key].type})`
2508
- )
2509
- ),
2510
-
2511
- errorCode: `${this.ecBase}DyNTS-DS0-GSF2`,
2512
- });
2513
- }
2514
- } */
2515
-
2516
-
2517
- /**
2518
- * setting up dependency dataHook by DynamoNTSDataModelParams
2519
- */
2520
- private lookForDependencyDataSettings(): void {
2521
- const dependencyParams: DyFM_DataProperty_Params<any, T>[] =
2522
- Object.values(this.dataParams.properties).filter(
2523
- (modelParams: DyFM_DataProperty_Params<any, T>): boolean =>
2524
- Boolean(modelParams.dependencyDataName)
2525
- );
2526
-
2527
- this.depSettings.push(...dependencyParams.map((dependencyParams) => ({
2528
- key: dependencyParams.key,
2529
- dbServiceKey: dependencyParams.dependencyDataName,
2530
- keyIsUnique: dependencyParams.unique,
2531
- keyIsRequired: dependencyParams.required,
2532
- })));
2533
-
2534
- if (this.depSettings.length === 1) {
2535
- this.depDataDBService = DyNTS_GlobalService.getDBServiceByKey(
2536
- this.depSettings[0].dbServiceKey
2537
- );
2538
- }
2539
- }
2540
-
2541
- /**
2542
- *
2543
- * @returns
2544
- */
2545
- getDependencyDataDBService(dBServiceKey?: string): DyNTS_DBService<any> {
2546
- if (!dBServiceKey && !this.depDataDBService) {
2547
- throw new DyFM_Error({
2548
- ...this._getDefaultErrorSettings(
2549
- 'getDependencyDataDBService',
2550
- new Error(
2551
- `getDependencyDataDBService was unsuccessful, service key not setted up! ` +
2552
- `(key: ${this.depSettings.map((depSetting) => depSetting.key).join(', ')}, ` +
2553
- `(${this.dataParams.dataName})`
2554
- )
2555
- ),
2556
-
2557
- status: 500,
2558
- errorCode: `${this.ecBase}DyNTS-DS0-GDDB0`,
2559
- });
2560
- }
2561
-
2562
- if (this.depDataDBService) {
2563
- return this.depDataDBService;
2564
- } else {
2565
- this.depDataDBService = DyNTS_GlobalService.getDBServiceByKey(dBServiceKey);
2566
-
2567
- return this.depDataDBService;
2568
- }
2569
- }
2570
-
2571
- getProvidedData(data: T): T {
2572
- return data;
2573
- }
2574
-
2575
- getProvidedDataList(dataList: T[]): T[] {
2576
- return dataList;
2577
- }
2578
-
2579
- private _getDefaultErrorSettings(
2580
- fnName: string,
2581
- error: DyFM_AnyError
2582
- ): DyFM_Error_Settings {
2583
- return {
2584
- status: (error as DyFM_Error)?.___status ?? 500,
2585
- message: (error as Error)?.message ??
2586
- (error as DyFM_Error)?._message ??
2587
- `${fnName} was UNSUCCESSFUL (NTS; ${this.dataParams.dataName})`,
2588
- addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
2589
- userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
2590
- issuer: this.issuer,
2591
- issuerService: this.serviceName + ` (${this?.constructor?.name}-DyNTS_DataService)`,
2592
- systemVersion: DyNTS_global_settings.systemVersion,
2593
- error: error,
2594
- };
2595
- }
2596
-
2597
- protected getDefaultErrorSettings(
2598
- fnName: string,
2599
- error: DyFM_AnyError,
2600
- /** @deprecated we wont support the separate user message in the future, use the message instead */
2601
- useMessageAsUserMessage: boolean = true,
2602
- ): DyFM_Error_Settings {
2603
- return {
2604
- status: (error as DyFM_Error)?.___status ?? 500,
2605
- message: (error as Error)?.message ??
2606
- (error as DyFM_Error)?._message ??
2607
- `${fnName} was UNSUCCESSFUL (${DyNTS_global_settings.systemShortCodeName})`,
2608
- addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
2609
- userMessage: (error as DyFM_Error)?.__userMessage ??
2610
- (useMessageAsUserMessage ? (error as Error)?.message : this.defaultErrorUserMsg),
2611
- issuer: this.issuer,
2612
- issuerService: this.constructor?.name,
2613
- systemVersion: DyNTS_global_settings.systemVersion,
2614
- error: error,
2615
- };
2616
- }
2617
-
2618
-
2619
- // ════════════════════════════════════════════════════════════════════════
2620
- // GENERIC DATA COMPARE (FR-001)
2621
- // ════════════════════════════════════════════════════════════════════════
2622
-
2623
- /**
2624
- * Generic, field-szintu osszehasonlitas ket adat-objektum kozott.
2625
- *
2626
- * **Auto-discovery mod** (`options.fields` nelkul): a metodus mindket
2627
- * objektum kulcs-uniojan iter, KIVEVE a `DyFM_Metadata` skip-listet
2628
- * (`_id`, `__created`, `__createdBy`, `__lastModified`, `__lastModifiedBy`).
2629
- *
2630
- * **Scope-szukito mod** (`options.fields = [...]`): KIZAROLAG a felsorolt
2631
- * mezoket vizsgalja. A skip-list IGNORALODIK — explicit fields override.
2632
- *
2633
- * **Custom comparator** (`options.customComparators`): per-field override
2634
- * a default deep-equal helyett (pl. set-equality array-ekre,
2635
- * case-insensitive string compare-re). A custom function `true`-val signal-ozza
2636
- * az equality-t.
2637
- *
2638
- * **Return:** `'equal'` ha minden vizsgalt field egyezik; `'modified'` ha
2639
- * legalabb egy elter — ilyenkor `changedFields` tartalmazza a TELJES
2640
- * mismatch-listat (nem early-return).
2641
- *
2642
- * **Throws:**
2643
- * - `newData` vagy `oldData` null/undefined → `DyFM_Error(400, DyNTS-DS0-CD1)`
2644
- * - `options.fields = []` ures array → `DyFM_Error(400, DyNTS-DS0-CD2)`
2645
- *
2646
- * **Sync method** (nincs I/O szukseglet); a host wrappel-i ha async kell.
2647
- *
2648
- * @example
2649
- * const result = userService.compareData(newUser, oldUser);
2650
- * if (result.result === 'modified') {
2651
- * console.log('Changed:', result.changedFields);
2652
- * }
2653
- *
2654
- * @example // Scope-szukites + custom comparator
2655
- * userService.compareData(newUser, oldUser, {
2656
- * fields: ['email', 'roles'],
2657
- * customComparators: {
2658
- * roles: (a, b) => new Set(a).size === new Set([...a, ...b]).size,
2659
- * },
2660
- * });
2661
- */
2662
- compareData(
2663
- newData: T,
2664
- oldData: T,
2665
- options?: DyNTS_CompareData_Options<T>,
2666
- ): DyNTS_CompareData_Result<T> {
2667
- // Input guard
2668
- if (newData === null || newData === undefined || oldData === null || oldData === undefined) {
2669
- throw new DyFM_Error({
2670
- ...this.getDefaultErrorSettings('compareData', new Error('newData/oldData required')),
2671
- status: 400,
2672
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-CD1`,
2673
- message: 'compareData: newData and oldData are required (both must be non-null/undefined)',
2674
- });
2675
- }
2676
-
2677
- if (options?.fields !== undefined && options.fields.length === 0) {
2678
- throw new DyFM_Error({
2679
- ...this.getDefaultErrorSettings('compareData', new Error('options.fields must not be empty')),
2680
- status: 400,
2681
- errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-CD2`,
2682
- message: 'compareData: options.fields must not be an empty array',
2683
- });
2684
- }
2685
-
2686
- const fieldsToCheck: (keyof T)[] = this._resolveCompareFields(newData, oldData, options);
2687
- const comparators: Partial<Record<keyof T, (a: any, b: any) => boolean>> =
2688
- options?.customComparators ?? {};
2689
-
2690
- const changedFields: (keyof T)[] = [];
2691
- for (const field of fieldsToCheck) {
2692
- const a: any = (newData as any)[field];
2693
- const b: any = (oldData as any)[field];
2694
-
2695
- const isEqual: boolean = comparators[field]
2696
- ? comparators[field]!(a, b)
2697
- : this._deepEqual(a, b);
2698
-
2699
- if (!isEqual) {
2700
- changedFields.push(field);
2701
- }
2702
- }
2703
-
2704
- if (changedFields.length === 0) {
2705
- return { result: 'equal' };
2706
- }
2707
- return { result: 'modified', changedFields: changedFields };
2708
- }
2709
-
2710
- /**
2711
- * Eldonti az osszehasonlitando fields-listat:
2712
- * - explicit `options.fields` esetan annak masolata (skip-list ignoralt)
2713
- * - egyebkent `Object.keys(newData) UNION Object.keys(oldData)` minus skip-list
2714
- */
2715
- private _resolveCompareFields(
2716
- newData: T,
2717
- oldData: T,
2718
- options?: DyNTS_CompareData_Options<T>,
2719
- ): (keyof T)[] {
2720
- if (options?.fields !== undefined) {
2721
- // Explicit fields — copy-spread (defensive against caller mutation mid-flight)
2722
- return [...options.fields];
2723
- }
2724
-
2725
- const keySet: Set<string> = new Set<string>();
2726
- for (const k of Object.keys(newData as object)) { keySet.add(k); }
2727
- for (const k of Object.keys(oldData as object)) { keySet.add(k); }
2728
-
2729
- const result: (keyof T)[] = [];
2730
- for (const k of keySet) {
2731
- if (COMPARE_DATA_METADATA_SKIP_FIELDS.has(k)) { continue; }
2732
- result.push(k as keyof T);
2733
- }
2734
- return result;
2735
- }
2736
-
2737
- /**
2738
- * Deep-equal helper.
2739
- *
2740
- * - Primitive (`string`/`number`/`boolean`/`null`/`undefined`): `===` / `Object.is`
2741
- * (a `NaN === NaN` esetet `Object.is` kezeli helyesen)
2742
- * - `Date`: `.getTime()` egyenloseg (kulonbozo Date instance-ok same-time-mal egyenlonek)
2743
- * - Array: length + index-szerinti rekurziv deep-equal
2744
- * - POJO: keys-union + per-key rekurzio
2745
- * - Egyeb (RegExp / Map / Set / Buffer): `Object.is` fallback (reference compare)
2746
- *
2747
- * NEM kezelt: cyclic references — a hivo objektum-grafja flat / fa kell legyen
2748
- * (a tipikus FDP data-model esete; cycle eseten stack overflow lesz, ami ertelmes
2749
- * jelzes a programozonak).
2750
- */
2751
- private _deepEqual(a: any, b: any): boolean {
2752
- if (a === b) { return true; }
2753
- if (Object.is(a, b)) { return true; }
2754
-
2755
- // Null/undefined es a masik nem ugyanaz → false
2756
- if (a === null || a === undefined || b === null || b === undefined) { return false; }
2757
-
2758
- // Date
2759
- if (a instanceof Date && b instanceof Date) {
2760
- return a.getTime() === b.getTime();
2761
- }
2762
- if (a instanceof Date || b instanceof Date) { return false; }
2763
-
2764
- // Array
2765
- if (Array.isArray(a) && Array.isArray(b)) {
2766
- if (a.length !== b.length) { return false; }
2767
- for (let i: number = 0; i < a.length; i++) {
2768
- if (!this._deepEqual(a[i], b[i])) { return false; }
2769
- }
2770
- return true;
2771
- }
2772
- if (Array.isArray(a) || Array.isArray(b)) { return false; }
2773
-
2774
- // POJO (Object.prototype) — keys union, per-key compare
2775
- if (typeof a === 'object' && typeof b === 'object') {
2776
- const keysA: string[] = Object.keys(a);
2777
- const keysB: string[] = Object.keys(b);
2778
- if (keysA.length !== keysB.length) { return false; }
2779
- const keysAset: Set<string> = new Set<string>(keysA);
2780
- for (const k of keysB) {
2781
- if (!keysAset.has(k)) { return false; }
2782
- }
2783
- for (const k of keysA) {
2784
- if (!this._deepEqual(a[k], b[k])) { return false; }
2785
- }
2786
- return true;
2787
- }
2788
-
2789
- // Fallback (function, symbol, BigInt, stb.) — strict equality mar nem stimmelt
2790
- return false;
2791
- }
2792
- }