@futdevpro/nts-dynamo 1.15.157 → 1.15.163

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 (642) hide show
  1. package/LICENSE +17 -17
  2. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.d.ts +7 -1
  3. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.d.ts.map +1 -1
  4. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.js +6 -0
  5. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.js.map +1 -1
  6. package/build/_modules/account-security/account-challenge.control-service.d.ts +1 -1
  7. package/build/_modules/account-security/account-challenge.control-service.d.ts.map +1 -1
  8. package/build/_modules/account-security/account-challenge.control-service.js +1 -1
  9. package/build/_modules/account-security/account-challenge.control-service.js.map +1 -1
  10. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts +71 -0
  11. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts.map +1 -0
  12. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js +3 -0
  13. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js.map +1 -0
  14. package/build/_modules/privacy-lifecycle/index.d.ts +3 -0
  15. package/build/_modules/privacy-lifecycle/index.d.ts.map +1 -1
  16. package/build/_modules/privacy-lifecycle/index.js +5 -1
  17. package/build/_modules/privacy-lifecycle/index.js.map +1 -1
  18. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts +48 -0
  19. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts.map +1 -0
  20. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js +332 -0
  21. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js.map +1 -0
  22. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts +25 -0
  23. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts.map +1 -0
  24. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js +126 -0
  25. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js.map +1 -0
  26. package/package.json +11 -4
  27. package/.c8rc.json +0 -26
  28. package/.copilot/patterns.json +0 -8
  29. package/.cursor/rules/__assistant_guide.mdc +0 -30
  30. package/.cursor/rules/__main.mdc +0 -64
  31. package/.cursor/rules/_ag_backend-structure.mdc +0 -86
  32. package/.cursor/rules/_ag_backend.mdc +0 -16
  33. package/.cursor/rules/_ag_debug.mdc +0 -8
  34. package/.cursor/rules/_ag_documentation_writing_rules.mdc +0 -372
  35. package/.cursor/rules/_ag_file-refactoring.mdc +0 -113
  36. package/.cursor/rules/_ag_fixes_rules.mdc +0 -6
  37. package/.cursor/rules/_ag_frontend-structure.mdc +0 -87
  38. package/.cursor/rules/_ag_frontend.mdc +0 -40
  39. package/.cursor/rules/_ag_import-rules.mdc +0 -45
  40. package/.cursor/rules/_ag_naming.mdc +0 -116
  41. package/.cursor/rules/_ag_running_commands.mdc +0 -5
  42. package/.cursor/rules/_ag_server-controller.mdc +0 -6
  43. package/.cursor/rules/_ag_should-be.mdc +0 -7
  44. package/.cursor/rules/_ag_swearing.mdc +0 -47
  45. package/.cursor/rules/ai_development_guide.md +0 -61
  46. package/.cursor/rules/ai_directives.md +0 -114
  47. package/.cursor/rules/cursor-rules.md +0 -160
  48. package/.cursor/rules/default-command.mdc +0 -465
  49. package/.cursor/rules/error_code_pattern.md +0 -40
  50. package/.cursor/rules/saved rule mcp server use.md +0 -16
  51. package/.dynamo/pipeline.cicd.config.json +0 -190
  52. package/.dynamo/version-bump.config.json +0 -5
  53. package/.github/workflows/main.yml +0 -438
  54. package/.husky/pre-commit +0 -3
  55. package/.vscode/settings.json +0 -11
  56. package/BuildPackage.bat +0 -1
  57. package/HOWTO.md +0 -15
  58. package/__documentations/2026-04-28-logs-module.md +0 -49
  59. package/__documentations/2026-05-17-oai-compatible-providers.md +0 -229
  60. package/__documentations/2026-05-17-static-client-serving-howto.md +0 -144
  61. package/__documentations/2026-06-01-fr041-cors-middleware.md +0 -96
  62. package/__documentations/2026-06-01-fr047-p2p3-function-calling.md +0 -81
  63. package/__documentations/2026-06-15-fr193-memory-guard.md +0 -73
  64. package/__documentations/2026-08-08-fr292-app-version-header.md +0 -38
  65. package/__documentations/2026-08-14-field-encryption-mongoose-document-spread.md +0 -124
  66. package/__documentations/2026-08-18-artifact-compiler.md +0 -46
  67. package/__documentations/2026-08-18-mongo-transaction-control-service.md +0 -82
  68. package/__documentations/2026-08-18-standalone-account-security-and-privacy-bedrock.md +0 -132
  69. package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +0 -59
  70. package/__documentations/2026-08-22-bfr-ctm-018-content-free-endpoint-errors.md +0 -54
  71. package/__documentations/2026-08-22-bfr-ctm-020-content-free-request-telemetry.md +0 -65
  72. package/__documentations/2026-08-22-content-free-process-error-boundary.md +0 -111
  73. package/__documentations/2026-08-22-npm-token-state-classifier.md +0 -92
  74. package/__documentations/nts-integration-tests-2026-03-17.md +0 -26
  75. package/__documentations/plans/BEDROCK-HYPERPLAN.md +0 -95
  76. package/_specifications/BACKLOG.md +0 -92
  77. package/_specifications/TODO.md +0 -15
  78. package/_specifications/agent.md +0 -138
  79. package/eslint.config.js +0 -3
  80. package/nodemon.json +0 -24
  81. package/pnpm-workspace.yaml +0 -6
  82. package/scripts/_seed-out/aim-seed.fixtures.ts +0 -161
  83. package/scripts/_seed-out/image-raw.json +0 -1
  84. package/scripts/_seed-out/llm-expand-raw.json +0 -60
  85. package/scripts/_seed-out/sample-image.png +0 -0
  86. package/scripts/_seed-out/seed-raw.json +0 -153
  87. package/scripts/ai-fixture-seed.js +0 -126
  88. package/scripts/run-coverage-tests.js +0 -28
  89. package/spec/support/helpers/spec-reporter-loader.js +0 -359
  90. package/spec/support/helpers/ts-node-helper.js +0 -93
  91. package/spec/support/jasmine.coverage.json +0 -24
  92. package/spec/support/jasmine.json +0 -24
  93. package/src/_assets/dynamo-nts-logo-128.png +0 -0
  94. package/src/_assets/dynamo-nts-logo-256.png +0 -0
  95. package/src/_assets/dynamo-nts-logo-512.png +0 -0
  96. package/src/_assets/dynamo-nts-logo-64.png +0 -0
  97. package/src/_collections/app-version-header.util.spec.ts +0 -108
  98. package/src/_collections/app-version-header.util.ts +0 -74
  99. package/src/_collections/archive-service-registry.const.ts +0 -21
  100. package/src/_collections/archive.util.spec.ts +0 -57
  101. package/src/_collections/archive.util.ts +0 -18
  102. package/src/_collections/atlas-default-db-options.const.ts +0 -10
  103. package/src/_collections/client-safe-error.util.spec.ts +0 -151
  104. package/src/_collections/client-safe-error.util.ts +0 -107
  105. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +0 -11
  106. package/src/_collections/default-fallback-cache-max-age.const.ts +0 -2
  107. package/src/_collections/default-not-found-page.const.spec.ts +0 -19
  108. package/src/_collections/default-not-found-page.const.ts +0 -22
  109. package/src/_collections/default-socket-path.const.spec.ts +0 -12
  110. package/src/_collections/default-socket-path.const.ts +0 -2
  111. package/src/_collections/field-encryption.util.spec.ts +0 -195
  112. package/src/_collections/field-encryption.util.ts +0 -222
  113. package/src/_collections/get-environment-settings.util.spec.ts +0 -210
  114. package/src/_collections/get-environment-settings.util.ts +0 -49
  115. package/src/_collections/global-settings.const.ts +0 -126
  116. package/src/_collections/load-shed.util.spec.ts +0 -62
  117. package/src/_collections/load-shed.util.ts +0 -51
  118. package/src/_collections/mongo-reconnect-guard.util.spec.ts +0 -52
  119. package/src/_collections/mongo-reconnect-guard.util.ts +0 -172
  120. package/src/_collections/npm-token-check.util.spec.ts +0 -218
  121. package/src/_collections/npm-token-check.util.ts +0 -327
  122. package/src/_collections/sample.env +0 -21
  123. package/src/_collections/security-headers.util.spec.ts +0 -98
  124. package/src/_collections/security-headers.util.ts +0 -96
  125. package/src/_collections/signed-url.util.spec.ts +0 -198
  126. package/src/_collections/signed-url.util.ts +0 -170
  127. package/src/_collections/star.controller.spec.ts +0 -224
  128. package/src/_collections/star.controller.ts +0 -130
  129. package/src/_collections/static-cache-control.util.spec.ts +0 -47
  130. package/src/_collections/static-cache-control.util.ts +0 -25
  131. package/src/_enums/data-model-type.enum.ts +0 -14
  132. package/src/_enums/data-service-function.enum.ts +0 -24
  133. package/src/_enums/predefined-data-types.enum.ts +0 -17
  134. package/src/_enums/route-security.enum.ts +0 -12
  135. package/src/_models/control-models/api-call-params.control-model.spec.ts +0 -152
  136. package/src/_models/control-models/api-call-params.control-model.ts +0 -142
  137. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +0 -52
  138. package/src/_models/control-models/app-ext-system-controls.control-model.ts +0 -9
  139. package/src/_models/control-models/app-params.control-model.spec.ts +0 -229
  140. package/src/_models/control-models/app-params.control-model.ts +0 -137
  141. package/src/_models/control-models/app-system-controls.control-model.spec.ts +0 -31
  142. package/src/_models/control-models/app-system-controls.control-model.ts +0 -9
  143. package/src/_models/control-models/endpoint-params.control-model.spec.ts +0 -754
  144. package/src/_models/control-models/endpoint-params.control-model.ts +0 -575
  145. package/src/_models/control-models/http-settings.control-model.spec.ts +0 -77
  146. package/src/_models/control-models/http-settings.control-model.ts +0 -37
  147. package/src/_models/control-models/system-control.control-model.spec.ts +0 -27
  148. package/src/_models/control-models/system-control.control-model.ts +0 -12
  149. package/src/_models/data-models/schema-migration.data-model.ts +0 -50
  150. package/src/_models/interfaces/app-version-header-settings.interface.ts +0 -17
  151. package/src/_models/interfaces/certification-settings.interface.ts +0 -7
  152. package/src/_models/interfaces/compare-data-options.interface.ts +0 -27
  153. package/src/_models/interfaces/compare-data-result.interface.ts +0 -12
  154. package/src/_models/interfaces/cors-settings.interface.spec.ts +0 -52
  155. package/src/_models/interfaces/cors-settings.interface.ts +0 -56
  156. package/src/_models/interfaces/db-query-options.interface.ts +0 -33
  157. package/src/_models/interfaces/environment-settings.interface.ts +0 -59
  158. package/src/_models/interfaces/global-log-settings.interface.ts +0 -171
  159. package/src/_models/interfaces/global-service-settings.interface.ts +0 -47
  160. package/src/_models/interfaces/global-settings.interface.ts +0 -294
  161. package/src/_models/interfaces/migration-entry.interface.ts +0 -19
  162. package/src/_models/interfaces/mongo-transaction-settings.interface.ts +0 -9
  163. package/src/_models/interfaces/request-telemetry-settings.interface.ts +0 -9
  164. package/src/_models/interfaces/request-telemetry-snapshot.interface.ts +0 -30
  165. package/src/_models/interfaces/routing-module-settings.interface.ts +0 -21
  166. package/src/_models/interfaces/security-headers-settings.interface.ts +0 -50
  167. package/src/_models/interfaces/signed-url-verify-result.interface.ts +0 -13
  168. package/src/_models/interfaces/static-client-settings.interface.spec.ts +0 -29
  169. package/src/_models/interfaces/static-client-settings.interface.ts +0 -36
  170. package/src/_models/types/db-update.type.ts +0 -100
  171. package/src/_modules/account-security/_enums/account-challenge-purpose.type-enum.ts +0 -5
  172. package/src/_modules/account-security/_enums/account-refresh-token-state.type-enum.ts +0 -6
  173. package/src/_modules/account-security/_enums/account-session-state.type-enum.ts +0 -6
  174. package/src/_modules/account-security/_models/account-challenge-adapter.interface.ts +0 -17
  175. package/src/_modules/account-security/_models/account-challenge-issued.interface.ts +0 -6
  176. package/src/_modules/account-security/_models/account-challenge-record.interface.ts +0 -13
  177. package/src/_modules/account-security/_models/account-challenge-result.interface.ts +0 -8
  178. package/src/_modules/account-security/_models/account-challenge-settings.interface.ts +0 -9
  179. package/src/_modules/account-security/_models/account-password-policy.interface.ts +0 -11
  180. package/src/_modules/account-security/_models/account-password-verification.interface.ts +0 -5
  181. package/src/_modules/account-security/_models/account-refresh-token-record.interface.ts +0 -13
  182. package/src/_modules/account-security/_models/account-session-adapter.interface.ts +0 -19
  183. package/src/_modules/account-security/_models/account-session-claims.interface.ts +0 -7
  184. package/src/_modules/account-security/_models/account-session-context.interface.ts +0 -6
  185. package/src/_modules/account-security/_models/account-session-create.interface.ts +0 -8
  186. package/src/_modules/account-security/_models/account-session-record.interface.ts +0 -21
  187. package/src/_modules/account-security/_models/account-session-rotate.interface.ts +0 -11
  188. package/src/_modules/account-security/_models/account-session-settings.interface.ts +0 -11
  189. package/src/_modules/account-security/_models/account-session-token-pair.interface.ts +0 -8
  190. package/src/_modules/account-security/_models/account-session-view.interface.ts +0 -13
  191. package/src/_modules/account-security/account-challenge.control-service.spec.ts +0 -195
  192. package/src/_modules/account-security/account-challenge.control-service.ts +0 -164
  193. package/src/_modules/account-security/account-password.control-service.spec.ts +0 -96
  194. package/src/_modules/account-security/account-password.control-service.ts +0 -288
  195. package/src/_modules/account-security/account-session.control-service.spec.ts +0 -294
  196. package/src/_modules/account-security/account-session.control-service.ts +0 -376
  197. package/src/_modules/account-security/index.ts +0 -31
  198. package/src/_modules/admin-auth/_models/admin-api-key-config.interface.ts +0 -33
  199. package/src/_modules/admin-auth/admin-api-key.auth-service.spec.ts +0 -200
  200. package/src/_modules/admin-auth/admin-api-key.auth-service.ts +0 -220
  201. package/src/_modules/admin-auth/index.ts +0 -2
  202. package/src/_modules/ai/_collections/ai-model-config-validator.util.spec.ts +0 -150
  203. package/src/_modules/ai/_collections/ai-model-config-validator.util.ts +0 -131
  204. package/src/_modules/ai/_collections/ai-provider-error.util.ts +0 -144
  205. package/src/_modules/ai/_models/ai-input-interfaces.ts +0 -117
  206. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +0 -16
  207. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts +0 -14
  208. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts +0 -56
  209. package/src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts +0 -16
  210. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.spec.ts +0 -72
  211. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts +0 -71
  212. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.spec.ts +0 -57
  213. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts +0 -60
  214. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.spec.ts +0 -56
  215. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts +0 -117
  216. package/src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts +0 -28
  217. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.ts +0 -14
  218. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.ts +0 -11
  219. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.ts +0 -30
  220. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.ts +0 -19
  221. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.ts +0 -20
  222. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +0 -115
  223. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +0 -233
  224. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.spec.ts +0 -134
  225. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.ts +0 -127
  226. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-pipeline.spec.ts +0 -105
  227. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.spec.ts +0 -50
  228. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.ts +0 -65
  229. package/src/_modules/ai/_modules/ai-mock/_services/aim-integration-proof.spec.ts +0 -92
  230. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.spec.ts +0 -112
  231. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts +0 -155
  232. package/src/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.ts +0 -649
  233. package/src/_modules/ai/_modules/ai-mock/index.ts +0 -47
  234. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +0 -138
  235. package/src/_modules/ai/_modules/anthropic/index.ts +0 -5
  236. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +0 -242
  237. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +0 -639
  238. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +0 -295
  239. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +0 -552
  240. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +0 -209
  241. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +0 -85
  242. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +0 -8
  243. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +0 -146
  244. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +0 -163
  245. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +0 -100
  246. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +0 -68
  247. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +0 -18
  248. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +0 -19
  249. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +0 -25
  250. package/src/_modules/ai/_modules/document-ai/index.ts +0 -30
  251. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +0 -189
  252. package/src/_modules/ai/_modules/fdp-ai/index.ts +0 -5
  253. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +0 -9
  254. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +0 -83
  255. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +0 -76
  256. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +0 -45
  257. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +0 -8
  258. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +0 -7
  259. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +0 -57
  260. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +0 -293
  261. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.ts +0 -572
  262. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +0 -342
  263. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.ts +0 -435
  264. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +0 -550
  265. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +0 -631
  266. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +0 -332
  267. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +0 -132
  268. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +0 -462
  269. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +0 -635
  270. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +0 -489
  271. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +0 -173
  272. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +0 -1085
  273. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +0 -157
  274. package/src/_modules/ai/_modules/open-ai/index.ts +0 -74
  275. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +0 -110
  276. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +0 -114
  277. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +0 -98
  278. package/src/_modules/ai/_services/ai-embedding.service-base.ts +0 -48
  279. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +0 -229
  280. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +0 -68
  281. package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts +0 -133
  282. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +0 -250
  283. package/src/_modules/ai/_services/ai-llm.service-base.ts +0 -599
  284. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +0 -158
  285. package/src/_modules/ai/_services/ai-provider.service-base.ts +0 -67
  286. package/src/_modules/ai/_services/ai-user-key.service-base.ts +0 -59
  287. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +0 -197
  288. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +0 -399
  289. package/src/_modules/ai/index.ts +0 -33
  290. package/src/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.ts +0 -5
  291. package/src/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.ts +0 -8
  292. package/src/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.ts +0 -6
  293. package/src/_modules/artifact-compiler/_models/artifact-compile.interface.ts +0 -35
  294. package/src/_modules/artifact-compiler/artifact-compiler.control-service.spec.ts +0 -151
  295. package/src/_modules/artifact-compiler/artifact-compiler.control-service.ts +0 -356
  296. package/src/_modules/artifact-compiler/index.ts +0 -9
  297. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +0 -13
  298. package/src/_modules/assistant/_collections/ass.util.spec.ts +0 -176
  299. package/src/_modules/assistant/_collections/ass.util.ts +0 -50
  300. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +0 -15
  301. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +0 -140
  302. package/src/_modules/assistant/_services/ass-io.control-service.ts +0 -74
  303. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +0 -192
  304. package/src/_modules/assistant/_services/ass-main.control-service.ts +0 -107
  305. package/src/_modules/assistant/index.ts +0 -19
  306. package/src/_modules/bot/_collections/bot-default-commands.const.ts +0 -12
  307. package/src/_modules/bot/_collections/bot-global-settings.const.ts +0 -39
  308. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +0 -62
  309. package/src/_modules/bot/_models/bot-command.interface.ts +0 -8
  310. package/src/_modules/bot/_models/bot-global-settings.interface.ts +0 -96
  311. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +0 -6
  312. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +0 -5
  313. package/src/_modules/bot/_models/bot-message-wrapper.interface.ts +0 -90
  314. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +0 -41
  315. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +0 -10
  316. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +0 -431
  317. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.ts +0 -641
  318. package/src/_modules/bot/_modules/discord-bot/index.ts +0 -12
  319. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +0 -160
  320. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +0 -55
  321. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +0 -15
  322. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +0 -374
  323. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +0 -447
  324. package/src/_modules/bot/_modules/dynamo-bot/index.ts +0 -15
  325. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +0 -9
  326. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +0 -344
  327. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +0 -197
  328. package/src/_modules/bot/_modules/slack-bot/index.ts +0 -12
  329. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +0 -9
  330. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +0 -345
  331. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +0 -197
  332. package/src/_modules/bot/_modules/teams-bot/index.ts +0 -11
  333. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +0 -116
  334. package/src/_modules/bot/_services/bot-commands.control-service.ts +0 -158
  335. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +0 -285
  336. package/src/_modules/bot/_services/bot-io.control-service.ts +0 -329
  337. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +0 -208
  338. package/src/_modules/bot/_services/bot-main.control-service.ts +0 -489
  339. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +0 -349
  340. package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts +0 -158
  341. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +0 -111
  342. package/src/_modules/bot/_services/bot-routines.control-service.ts +0 -78
  343. package/src/_modules/bot/index.ts +0 -37
  344. package/src/_modules/custom-data/custom-data.controller.spec.ts +0 -49
  345. package/src/_modules/custom-data/custom-data.controller.ts +0 -67
  346. package/src/_modules/custom-data/custom-data.data-service.spec.ts +0 -54
  347. package/src/_modules/custom-data/custom-data.data-service.ts +0 -22
  348. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +0 -28
  349. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +0 -24
  350. package/src/_modules/custom-data/index.ts +0 -9
  351. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +0 -176
  352. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +0 -203
  353. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +0 -33
  354. package/src/_modules/data-readers/index.ts +0 -11
  355. package/src/_modules/defaults/_collections/default-endpoints.util.ts +0 -487
  356. package/src/_modules/defaults/_models/default-user.data-model.ts +0 -72
  357. package/src/_modules/defaults/_services/default-auth.service.spec.ts +0 -269
  358. package/src/_modules/defaults/_services/default-auth.service.ts +0 -177
  359. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +0 -42
  360. package/src/_modules/defaults/_services/default-socket-events.service.ts +0 -61
  361. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +0 -187
  362. package/src/_modules/defaults/_services/default-user.data-service.ts +0 -98
  363. package/src/_modules/defaults/index.ts +0 -17
  364. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +0 -19
  365. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +0 -366
  366. package/src/_modules/discord-assistant/_collections/dias.util.ts +0 -133
  367. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +0 -20
  368. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +0 -53
  369. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +0 -177
  370. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +0 -108
  371. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +0 -69
  372. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +0 -22
  373. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +0 -27
  374. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +0 -195
  375. package/src/_modules/discord-assistant/_services/dias.service-base.ts +0 -77
  376. package/src/_modules/discord-assistant/index.ts +0 -38
  377. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +0 -34
  378. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +0 -11
  379. package/src/_modules/discord-assistant-voiced/index.ts +0 -36
  380. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +0 -17
  381. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +0 -56
  382. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +0 -214
  383. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +0 -387
  384. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +0 -12
  385. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +0 -98
  386. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +0 -8
  387. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +0 -6
  388. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +0 -154
  389. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +0 -153
  390. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +0 -264
  391. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +0 -306
  392. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +0 -408
  393. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +0 -488
  394. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +0 -105
  395. package/src/_modules/discord-bot/_services/dibo-routines.control-service.ts +0 -97
  396. package/src/_modules/discord-bot/index.ts +0 -36
  397. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +0 -35
  398. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +0 -60
  399. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +0 -17
  400. package/src/_modules/local-vector-search/_services/lvs-bm25.util.spec.ts +0 -159
  401. package/src/_modules/local-vector-search/_services/lvs-bm25.util.ts +0 -206
  402. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +0 -418
  403. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +0 -276
  404. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +0 -480
  405. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +0 -416
  406. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +0 -214
  407. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +0 -186
  408. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +0 -167
  409. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +0 -130
  410. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +0 -509
  411. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +0 -323
  412. package/src/_modules/local-vector-search/index.ts +0 -17
  413. package/src/_modules/logs/_models/file-log-entry.interface.ts +0 -13
  414. package/src/_modules/logs/_models/file-log-read-result.interface.ts +0 -37
  415. package/src/_modules/logs/file-log.service.spec.ts +0 -341
  416. package/src/_modules/logs/file-log.service.ts +0 -466
  417. package/src/_modules/logs/file-logs.controller.spec.ts +0 -245
  418. package/src/_modules/logs/file-logs.controller.ts +0 -165
  419. package/src/_modules/logs/get-file-logs-routing-module.util.ts +0 -51
  420. package/src/_modules/logs/get-logs-routing-module.util.ts +0 -36
  421. package/src/_modules/logs/index.ts +0 -11
  422. package/src/_modules/logs/log-buffer.service.ts +0 -101
  423. package/src/_modules/logs/logs.controller.ts +0 -109
  424. package/src/_modules/logs/logs.service.ts +0 -100
  425. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +0 -111
  426. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +0 -151
  427. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +0 -125
  428. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +0 -168
  429. package/src/_modules/mcp/index.ts +0 -13
  430. package/src/_modules/messaging/README.md +0 -354
  431. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +0 -26
  432. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +0 -22
  433. package/src/_modules/messaging/_collections/msg.util.spec.ts +0 -226
  434. package/src/_modules/messaging/_collections/msg.util.ts +0 -83
  435. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +0 -37
  436. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +0 -146
  437. package/src/_modules/messaging/_services/msg-events.service.spec.ts +0 -219
  438. package/src/_modules/messaging/_services/msg-events.service.ts +0 -267
  439. package/src/_modules/messaging/_services/msg-integration.control-service.ts +0 -180
  440. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +0 -147
  441. package/src/_modules/messaging/_services/msg-main.control-service.ts +0 -572
  442. package/src/_modules/messaging/_services/msg-message.data-service.ts +0 -129
  443. package/src/_modules/messaging/_services/msg.controller.spec.ts +0 -201
  444. package/src/_modules/messaging/_services/msg.controller.ts +0 -370
  445. package/src/_modules/messaging/index.ts +0 -30
  446. package/src/_modules/mock/app-extended-server.mock.ts +0 -201
  447. package/src/_modules/mock/app-integration-test.mock.ts +0 -51
  448. package/src/_modules/mock/app-params.mock.spec.ts +0 -21
  449. package/src/_modules/mock/app-params.mock.ts +0 -9
  450. package/src/_modules/mock/app-server.mock.ts +0 -188
  451. package/src/_modules/mock/auth-service.mock.spec.ts +0 -47
  452. package/src/_modules/mock/auth-service.mock.ts +0 -28
  453. package/src/_modules/mock/controller.mock.spec.ts +0 -26
  454. package/src/_modules/mock/controller.mock.ts +0 -16
  455. package/src/_modules/mock/data-model.mock.spec.ts +0 -111
  456. package/src/_modules/mock/data-model.mock.ts +0 -82
  457. package/src/_modules/mock/email-service-collection.mock.spec.ts +0 -24
  458. package/src/_modules/mock/email-service-collection.mock.ts +0 -15
  459. package/src/_modules/mock/email-service.mock.spec.ts +0 -17
  460. package/src/_modules/mock/email-service.mock.ts +0 -20
  461. package/src/_modules/mock/email-template.mock.html +0 -15
  462. package/src/_modules/mock/endpoint.mock.ts +0 -91
  463. package/src/_modules/mock/socket-client.mock.spec.ts +0 -40
  464. package/src/_modules/mock/socket-client.mock.ts +0 -45
  465. package/src/_modules/mock/socket-server.mock.spec.ts +0 -44
  466. package/src/_modules/mock/socket-server.mock.ts +0 -46
  467. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +0 -107
  468. package/src/_modules/oauth2/_routes/oauth2.controller.ts +0 -99
  469. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +0 -254
  470. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +0 -232
  471. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +0 -585
  472. package/src/_modules/oauth2/_services/oauth2.control-service.ts +0 -654
  473. package/src/_modules/oauth2/index.ts +0 -17
  474. package/src/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.ts +0 -5
  475. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.ts +0 -10
  476. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.ts +0 -7
  477. package/src/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.ts +0 -15
  478. package/src/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.ts +0 -9
  479. package/src/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.ts +0 -12
  480. package/src/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.ts +0 -7
  481. package/src/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.ts +0 -15
  482. package/src/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.ts +0 -7
  483. package/src/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.ts +0 -13
  484. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.ts +0 -9
  485. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.ts +0 -14
  486. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.ts +0 -8
  487. package/src/_modules/privacy-lifecycle/_models/privacy-contributor.interface.ts +0 -17
  488. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.ts +0 -21
  489. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.ts +0 -9
  490. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.ts +0 -7
  491. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.ts +0 -10
  492. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.ts +0 -7
  493. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.ts +0 -7
  494. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.ts +0 -11
  495. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.ts +0 -13
  496. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.ts +0 -19
  497. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.ts +0 -9
  498. package/src/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.ts +0 -7
  499. package/src/_modules/privacy-lifecycle/_models/privacy-request-open.interface.ts +0 -10
  500. package/src/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.ts +0 -7
  501. package/src/_modules/privacy-lifecycle/_models/privacy-request-record.interface.ts +0 -21
  502. package/src/_modules/privacy-lifecycle/_models/privacy-request-result.interface.ts +0 -8
  503. package/src/_modules/privacy-lifecycle/_models/privacy-request-view.interface.ts +0 -20
  504. package/src/_modules/privacy-lifecycle/index.ts +0 -40
  505. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.spec.ts +0 -206
  506. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.ts +0 -253
  507. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.spec.ts +0 -353
  508. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.ts +0 -586
  509. package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +0 -5
  510. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +0 -82
  511. package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +0 -9
  512. package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +0 -6
  513. package/src/_modules/rate-limit/_models/rate-limit-policy.interface.ts +0 -16
  514. package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +0 -9
  515. package/src/_modules/rate-limit/index.ts +0 -8
  516. package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +0 -91
  517. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +0 -488
  518. package/src/_modules/rate-limit/rate-limit.middleware.ts +0 -504
  519. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +0 -35
  520. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +0 -33
  521. package/src/_modules/scheduler/index.ts +0 -8
  522. package/src/_modules/scheduler/scheduler.controller.spec.ts +0 -42
  523. package/src/_modules/scheduler/scheduler.controller.ts +0 -69
  524. package/src/_modules/scheduler/scheduler.service.spec.ts +0 -141
  525. package/src/_modules/scheduler/scheduler.service.ts +0 -176
  526. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +0 -22
  527. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +0 -82
  528. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +0 -107
  529. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +0 -312
  530. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +0 -311
  531. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +0 -123
  532. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +0 -108
  533. package/src/_modules/scoped-config/index.ts +0 -17
  534. package/src/_modules/server/errors/errors.control-service.spec.ts +0 -246
  535. package/src/_modules/server/errors/errors.control-service.ts +0 -100
  536. package/src/_modules/server/errors/errors.controller.spec.ts +0 -340
  537. package/src/_modules/server/errors/errors.controller.ts +0 -559
  538. package/src/_modules/server/errors/errors.data-service.spec.ts +0 -480
  539. package/src/_modules/server/errors/errors.data-service.ts +0 -867
  540. package/src/_modules/server/index.ts +0 -40
  541. package/src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts +0 -8
  542. package/src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts +0 -20
  543. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.spec.ts +0 -124
  544. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.ts +0 -99
  545. package/src/_modules/server/safe-diagnostic/safe-diagnostic.interface.ts +0 -20
  546. package/src/_modules/server/server-status/db-readiness-probe-code.type-enum.ts +0 -13
  547. package/src/_modules/server/server-status/db-readiness-probe-stage.type-enum.ts +0 -7
  548. package/src/_modules/server/server-status/db-readiness-probe.control-service.spec.ts +0 -235
  549. package/src/_modules/server/server-status/db-readiness-probe.control-service.ts +0 -158
  550. package/src/_modules/server/server-status/db-readiness-probe.interface.ts +0 -20
  551. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +0 -70
  552. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +0 -17
  553. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +0 -77
  554. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +0 -37
  555. package/src/_modules/server/server-status/server-status.control-service.spec.ts +0 -672
  556. package/src/_modules/server/server-status/server-status.control-service.ts +0 -491
  557. package/src/_modules/server/server-status/server-status.controller.spec.ts +0 -276
  558. package/src/_modules/server/server-status/server-status.controller.ts +0 -336
  559. package/src/_modules/socket/_enums/socket-security.enum.ts +0 -11
  560. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +0 -32
  561. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +0 -22
  562. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +0 -165
  563. package/src/_modules/socket/_models/socket-presence.control-model.ts +0 -211
  564. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +0 -69
  565. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +0 -33
  566. package/src/_modules/socket/_services/socket-client.service.spec.ts +0 -15
  567. package/src/_modules/socket/_services/socket-client.service.ts +0 -260
  568. package/src/_modules/socket/_services/socket-server.service.spec.ts +0 -272
  569. package/src/_modules/socket/_services/socket-server.service.ts +0 -1037
  570. package/src/_modules/socket/app-extended.integration.spec.ts +0 -85
  571. package/src/_modules/socket/app-extended.server.ts +0 -648
  572. package/src/_modules/socket/index.ts +0 -42
  573. package/src/_modules/test/get-test-routing-module.util.spec.ts +0 -28
  574. package/src/_modules/test/get-test-routing-module.util.ts +0 -23
  575. package/src/_modules/test/index.ts +0 -12
  576. package/src/_modules/test/test.controller.spec.ts +0 -72
  577. package/src/_modules/test/test.controller.ts +0 -115
  578. package/src/_modules/test-email-sink/_collections/test-email-pattern.const.ts +0 -10
  579. package/src/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.ts +0 -41
  580. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.spec.ts +0 -112
  581. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.ts +0 -141
  582. package/src/_modules/test-email-sink/get-sent-mail-routing-module.util.ts +0 -29
  583. package/src/_modules/test-email-sink/index.ts +0 -11
  584. package/src/_modules/test-email-sink/test-email-sink.controller.ts +0 -83
  585. package/src/_modules/usage/get-usage-routing-module.util.ts +0 -23
  586. package/src/_modules/usage/index.ts +0 -15
  587. package/src/_modules/usage/usage.controller.spec.ts +0 -106
  588. package/src/_modules/usage/usage.controller.ts +0 -140
  589. package/src/_modules/usage/usage.data-service.spec.ts +0 -332
  590. package/src/_modules/usage/usage.data-service.ts +0 -185
  591. package/src/_services/base/api.service-base.spec.ts +0 -125
  592. package/src/_services/base/api.service-base.ts +0 -75
  593. package/src/_services/base/archive-data.service.spec.ts +0 -209
  594. package/src/_services/base/archive-data.service.ts +0 -228
  595. package/src/_services/base/data.service.spec.ts +0 -784
  596. package/src/_services/base/data.service.ts +0 -2792
  597. package/src/_services/base/db.service.encryption.spec.ts +0 -76
  598. package/src/_services/base/db.service.spec.ts +0 -160
  599. package/src/_services/base/db.service.ts +0 -1698
  600. package/src/_services/base/singleton.service-base.spec.ts +0 -28
  601. package/src/_services/base/singleton.service-base.ts +0 -24
  602. package/src/_services/base/singleton.service.spec.ts +0 -114
  603. package/src/_services/base/singleton.service.ts +0 -38
  604. package/src/_services/core/api.service.spec.ts +0 -187
  605. package/src/_services/core/api.service.ts +0 -627
  606. package/src/_services/core/auth.service.spec.ts +0 -159
  607. package/src/_services/core/auth.service.ts +0 -174
  608. package/src/_services/core/collection-growth-monitor.service.spec.ts +0 -119
  609. package/src/_services/core/collection-growth-monitor.service.ts +0 -234
  610. package/src/_services/core/db-stats.service.ts +0 -104
  611. package/src/_services/core/diagnostics.service.spec.ts +0 -44
  612. package/src/_services/core/diagnostics.service.ts +0 -158
  613. package/src/_services/core/email.service.spec.ts +0 -85
  614. package/src/_services/core/email.service.ts +0 -757
  615. package/src/_services/core/event-loop-diag.service.spec.ts +0 -22
  616. package/src/_services/core/event-loop-diag.service.ts +0 -144
  617. package/src/_services/core/global.service.spec.ts +0 -292
  618. package/src/_services/core/global.service.ts +0 -488
  619. package/src/_services/core/memory-guard.service.spec.ts +0 -245
  620. package/src/_services/core/memory-guard.service.ts +0 -481
  621. package/src/_services/core/migration-runner.service.spec.ts +0 -91
  622. package/src/_services/core/migration-runner.service.ts +0 -106
  623. package/src/_services/core/mongo-transaction.control-service.spec.ts +0 -165
  624. package/src/_services/core/mongo-transaction.control-service.ts +0 -148
  625. package/src/_services/core/request-hunter.service.spec.ts +0 -124
  626. package/src/_services/core/request-hunter.service.ts +0 -157
  627. package/src/_services/core/request-telemetry.control-service.spec.ts +0 -217
  628. package/src/_services/core/request-telemetry.control-service.ts +0 -381
  629. package/src/_services/core/service-collection.service.spec.ts +0 -46
  630. package/src/_services/core/service-collection.service.ts +0 -6
  631. package/src/_services/route/controller.service.spec.ts +0 -53
  632. package/src/_services/route/controller.service.ts +0 -148
  633. package/src/_services/route/routing-module.service.spec.ts +0 -98
  634. package/src/_services/route/routing-module.service.ts +0 -339
  635. package/src/_services/server/app-safe-diagnostic.spec.ts +0 -124
  636. package/src/_services/server/app.server-retention.spec.ts +0 -106
  637. package/src/_services/server/app.server.ts +0 -1979
  638. package/src/_services/shared.static-service.spec.ts +0 -133
  639. package/src/_services/shared.static-service.ts +0 -107
  640. package/src/index.ts +0 -120
  641. package/tsconfig.app.json +0 -12
  642. 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
- }