@futdevpro/nts-dynamo 1.15.156 → 1.15.160

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1395) hide show
  1. package/LICENSE +17 -17
  2. package/build/_collections/app-version-header.util.d.ts +41 -41
  3. package/build/_collections/app-version-header.util.js +66 -66
  4. package/build/_collections/archive-service-registry.const.d.ts +15 -15
  5. package/build/_collections/archive-service-registry.const.js +14 -14
  6. package/build/_collections/archive.util.d.ts +12 -12
  7. package/build/_collections/archive.util.js +18 -18
  8. package/build/_collections/atlas-default-db-options.const.d.ts +2 -2
  9. package/build/_collections/atlas-default-db-options.const.js +9 -9
  10. package/build/_collections/client-safe-error.util.d.ts +38 -38
  11. package/build/_collections/client-safe-error.util.js +96 -96
  12. package/build/_collections/default-fallback-cache-max-age.const.d.ts +2 -2
  13. package/build/_collections/default-fallback-cache-max-age.const.js +5 -5
  14. package/build/_collections/default-not-found-page.const.d.ts +5 -5
  15. package/build/_collections/default-not-found-page.const.js +24 -24
  16. package/build/_collections/default-socket-path.const.d.ts +2 -2
  17. package/build/_collections/default-socket-path.const.js +5 -5
  18. package/build/_collections/field-encryption.util.d.ts +85 -85
  19. package/build/_collections/field-encryption.util.js +192 -192
  20. package/build/_collections/get-environment-settings.util.d.ts +2 -2
  21. package/build/_collections/get-environment-settings.util.js +43 -43
  22. package/build/_collections/global-settings.const.d.ts +6 -6
  23. package/build/_collections/global-settings.const.js +104 -104
  24. package/build/_collections/load-shed.util.d.ts +15 -15
  25. package/build/_collections/load-shed.util.js +42 -42
  26. package/build/_collections/mongo-reconnect-guard.util.d.ts +73 -73
  27. package/build/_collections/mongo-reconnect-guard.util.js +110 -110
  28. package/build/_collections/npm-token-check.util.d.ts +138 -138
  29. package/build/_collections/npm-token-check.util.js +301 -301
  30. package/build/_collections/security-headers.util.d.ts +16 -16
  31. package/build/_collections/security-headers.util.js +77 -77
  32. package/build/_collections/signed-url.util.d.ts +84 -84
  33. package/build/_collections/signed-url.util.js +145 -145
  34. package/build/_collections/star.controller.d.ts +7 -7
  35. package/build/_collections/star.controller.js +97 -97
  36. package/build/_collections/static-cache-control.util.d.ts +17 -17
  37. package/build/_collections/static-cache-control.util.js +23 -23
  38. package/build/_enums/data-model-type.enum.d.ts +13 -13
  39. package/build/_enums/data-model-type.enum.js +17 -17
  40. package/build/_enums/data-service-function.enum.d.ts +18 -18
  41. package/build/_enums/data-service-function.enum.js +24 -24
  42. package/build/_enums/predefined-data-types.enum.d.ts +15 -15
  43. package/build/_enums/predefined-data-types.enum.js +19 -19
  44. package/build/_enums/route-security.enum.d.ts +11 -11
  45. package/build/_enums/route-security.enum.js +15 -15
  46. package/build/_models/control-models/api-call-params.control-model.d.ts +79 -79
  47. package/build/_models/control-models/api-call-params.control-model.js +101 -101
  48. package/build/_models/control-models/app-ext-system-controls.control-model.d.ts +6 -6
  49. package/build/_models/control-models/app-ext-system-controls.control-model.js +10 -10
  50. package/build/_models/control-models/app-params.control-model.d.ts +51 -51
  51. package/build/_models/control-models/app-params.control-model.js +118 -118
  52. package/build/_models/control-models/app-system-controls.control-model.d.ts +7 -7
  53. package/build/_models/control-models/app-system-controls.control-model.js +11 -11
  54. package/build/_models/control-models/endpoint-params.control-model.d.ts +125 -125
  55. package/build/_models/control-models/endpoint-params.control-model.js +409 -409
  56. package/build/_models/control-models/http-settings.control-model.d.ts +17 -17
  57. package/build/_models/control-models/http-settings.control-model.js +34 -34
  58. package/build/_models/control-models/system-control.control-model.d.ts +5 -5
  59. package/build/_models/control-models/system-control.control-model.js +11 -11
  60. package/build/_models/data-models/schema-migration.data-model.d.ts +28 -28
  61. package/build/_models/data-models/schema-migration.data-model.js +46 -46
  62. package/build/_models/interfaces/app-version-header-settings.interface.d.ts +16 -16
  63. package/build/_models/interfaces/app-version-header-settings.interface.js +2 -2
  64. package/build/_models/interfaces/certification-settings.interface.d.ts +5 -5
  65. package/build/_models/interfaces/certification-settings.interface.js +2 -2
  66. package/build/_models/interfaces/compare-data-options.interface.d.ts +26 -26
  67. package/build/_models/interfaces/compare-data-options.interface.js +2 -2
  68. package/build/_models/interfaces/compare-data-result.interface.d.ts +12 -12
  69. package/build/_models/interfaces/compare-data-result.interface.js +2 -2
  70. package/build/_models/interfaces/cors-settings.interface.d.ts +51 -51
  71. package/build/_models/interfaces/cors-settings.interface.js +2 -2
  72. package/build/_models/interfaces/db-query-options.interface.d.ts +32 -32
  73. package/build/_models/interfaces/db-query-options.interface.js +2 -2
  74. package/build/_models/interfaces/environment-settings.interface.d.ts +34 -34
  75. package/build/_models/interfaces/environment-settings.interface.js +2 -2
  76. package/build/_models/interfaces/global-log-settings.interface.d.ts +145 -145
  77. package/build/_models/interfaces/global-log-settings.interface.js +2 -2
  78. package/build/_models/interfaces/global-service-settings.interface.d.ts +30 -30
  79. package/build/_models/interfaces/global-service-settings.interface.js +2 -2
  80. package/build/_models/interfaces/global-settings.interface.d.ts +265 -265
  81. package/build/_models/interfaces/global-settings.interface.js +2 -2
  82. package/build/_models/interfaces/migration-entry.interface.d.ts +19 -19
  83. package/build/_models/interfaces/migration-entry.interface.js +2 -2
  84. package/build/_models/interfaces/mongo-transaction-settings.interface.d.ts +8 -8
  85. package/build/_models/interfaces/mongo-transaction-settings.interface.js +2 -2
  86. package/build/_models/interfaces/request-telemetry-settings.interface.d.ts +10 -0
  87. package/build/_models/interfaces/request-telemetry-settings.interface.d.ts.map +1 -0
  88. package/build/_models/interfaces/request-telemetry-settings.interface.js +3 -0
  89. package/build/_models/interfaces/request-telemetry-settings.interface.js.map +1 -0
  90. package/build/_models/interfaces/request-telemetry-snapshot.interface.d.ts +29 -0
  91. package/build/_models/interfaces/request-telemetry-snapshot.interface.d.ts.map +1 -0
  92. package/build/_models/interfaces/request-telemetry-snapshot.interface.js +3 -0
  93. package/build/_models/interfaces/request-telemetry-snapshot.interface.js.map +1 -0
  94. package/build/_models/interfaces/routing-module-settings.interface.d.ts +19 -19
  95. package/build/_models/interfaces/routing-module-settings.interface.js +2 -2
  96. package/build/_models/interfaces/security-headers-settings.interface.d.ts +41 -41
  97. package/build/_models/interfaces/security-headers-settings.interface.js +2 -2
  98. package/build/_models/interfaces/signed-url-verify-result.interface.d.ts +13 -13
  99. package/build/_models/interfaces/signed-url-verify-result.interface.js +2 -2
  100. package/build/_models/interfaces/static-client-settings.interface.d.ts +36 -36
  101. package/build/_models/interfaces/static-client-settings.interface.js +2 -2
  102. package/build/_models/types/db-update.type.d.ts +129 -129
  103. package/build/_models/types/db-update.type.js +2 -2
  104. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.d.ts +5 -5
  105. package/build/_modules/account-security/_enums/account-challenge-purpose.type-enum.js +9 -9
  106. package/build/_modules/account-security/_enums/account-refresh-token-state.type-enum.d.ts +6 -6
  107. package/build/_modules/account-security/_enums/account-refresh-token-state.type-enum.js +10 -10
  108. package/build/_modules/account-security/_enums/account-session-state.type-enum.d.ts +6 -6
  109. package/build/_modules/account-security/_enums/account-session-state.type-enum.js +10 -10
  110. package/build/_modules/account-security/_models/account-challenge-adapter.interface.d.ts +8 -8
  111. package/build/_modules/account-security/_models/account-challenge-adapter.interface.js +2 -2
  112. package/build/_modules/account-security/_models/account-challenge-issued.interface.d.ts +6 -6
  113. package/build/_modules/account-security/_models/account-challenge-issued.interface.js +2 -2
  114. package/build/_modules/account-security/_models/account-challenge-record.interface.d.ts +12 -12
  115. package/build/_modules/account-security/_models/account-challenge-record.interface.js +2 -2
  116. package/build/_modules/account-security/_models/account-challenge-result.interface.d.ts +7 -7
  117. package/build/_modules/account-security/_models/account-challenge-result.interface.js +2 -2
  118. package/build/_modules/account-security/_models/account-challenge-settings.interface.d.ts +8 -8
  119. package/build/_modules/account-security/_models/account-challenge-settings.interface.js +2 -2
  120. package/build/_modules/account-security/_models/account-password-policy.interface.d.ts +11 -11
  121. package/build/_modules/account-security/_models/account-password-policy.interface.js +2 -2
  122. package/build/_modules/account-security/_models/account-password-verification.interface.d.ts +5 -5
  123. package/build/_modules/account-security/_models/account-password-verification.interface.js +2 -2
  124. package/build/_modules/account-security/_models/account-refresh-token-record.interface.d.ts +12 -12
  125. package/build/_modules/account-security/_models/account-refresh-token-record.interface.js +2 -2
  126. package/build/_modules/account-security/_models/account-session-adapter.interface.d.ts +18 -18
  127. package/build/_modules/account-security/_models/account-session-adapter.interface.js +2 -2
  128. package/build/_modules/account-security/_models/account-session-claims.interface.d.ts +7 -7
  129. package/build/_modules/account-security/_models/account-session-claims.interface.js +2 -2
  130. package/build/_modules/account-security/_models/account-session-context.interface.d.ts +6 -6
  131. package/build/_modules/account-security/_models/account-session-context.interface.js +2 -2
  132. package/build/_modules/account-security/_models/account-session-create.interface.d.ts +7 -7
  133. package/build/_modules/account-security/_models/account-session-create.interface.js +2 -2
  134. package/build/_modules/account-security/_models/account-session-record.interface.d.ts +20 -20
  135. package/build/_modules/account-security/_models/account-session-record.interface.js +2 -2
  136. package/build/_modules/account-security/_models/account-session-rotate.interface.d.ts +10 -10
  137. package/build/_modules/account-security/_models/account-session-rotate.interface.js +2 -2
  138. package/build/_modules/account-security/_models/account-session-settings.interface.d.ts +10 -10
  139. package/build/_modules/account-security/_models/account-session-settings.interface.js +2 -2
  140. package/build/_modules/account-security/_models/account-session-token-pair.interface.d.ts +8 -8
  141. package/build/_modules/account-security/_models/account-session-token-pair.interface.js +2 -2
  142. package/build/_modules/account-security/_models/account-session-view.interface.d.ts +12 -12
  143. package/build/_modules/account-security/_models/account-session-view.interface.js +2 -2
  144. package/build/_modules/account-security/account-challenge.control-service.d.ts +23 -23
  145. package/build/_modules/account-security/account-challenge.control-service.js +116 -116
  146. package/build/_modules/account-security/account-password.control-service.d.ts +23 -23
  147. package/build/_modules/account-security/account-password.control-service.js +213 -213
  148. package/build/_modules/account-security/account-session.control-service.d.ts +38 -38
  149. package/build/_modules/account-security/account-session.control-service.js +276 -276
  150. package/build/_modules/account-security/index.d.ts +23 -23
  151. package/build/_modules/account-security/index.js +15 -15
  152. package/build/_modules/admin-auth/_models/admin-api-key-config.interface.d.ts +31 -31
  153. package/build/_modules/admin-auth/_models/admin-api-key-config.interface.js +2 -2
  154. package/build/_modules/admin-auth/admin-api-key.auth-service.d.ts +89 -89
  155. package/build/_modules/admin-auth/admin-api-key.auth-service.js +194 -194
  156. package/build/_modules/admin-auth/index.d.ts +2 -2
  157. package/build/_modules/admin-auth/index.js +5 -5
  158. package/build/_modules/ai/_collections/ai-model-config-validator.util.d.ts +31 -31
  159. package/build/_modules/ai/_collections/ai-model-config-validator.util.js +94 -94
  160. package/build/_modules/ai/_collections/ai-provider-error.util.d.ts +43 -43
  161. package/build/_modules/ai/_collections/ai-provider-error.util.js +120 -120
  162. package/build/_modules/ai/_models/ai-input-interfaces.d.ts +53 -53
  163. package/build/_modules/ai/_models/ai-input-interfaces.js +5 -5
  164. package/build/_modules/ai/_models/ai-test-generation-result.interface.d.ts +16 -16
  165. package/build/_modules/ai/_models/ai-test-generation-result.interface.js +2 -2
  166. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.d.ts +13 -13
  167. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.js +2 -2
  168. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.d.ts +49 -49
  169. package/build/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.js +2 -2
  170. package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.d.ts +16 -16
  171. package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.js +2 -2
  172. package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.d.ts +22 -22
  173. package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.js +51 -51
  174. package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.d.ts +33 -33
  175. package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.js +55 -55
  176. package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.d.ts +40 -40
  177. package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.js +89 -89
  178. package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.d.ts +27 -27
  179. package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.js +28 -28
  180. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.d.ts +14 -14
  181. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.js +2 -2
  182. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.d.ts +10 -10
  183. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.js +2 -2
  184. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.d.ts +29 -29
  185. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.js +2 -2
  186. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.d.ts +18 -18
  187. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.js +2 -2
  188. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.d.ts +18 -18
  189. package/build/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.js +2 -2
  190. package/build/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.d.ts +80 -80
  191. package/build/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.js +166 -166
  192. package/build/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.d.ts +47 -47
  193. package/build/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.js +103 -103
  194. package/build/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.d.ts +34 -34
  195. package/build/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.js +59 -59
  196. package/build/_modules/ai/_modules/ai-mock/_services/aim-mock.service.d.ts +73 -73
  197. package/build/_modules/ai/_modules/ai-mock/_services/aim-mock.service.js +133 -133
  198. package/build/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.d.ts +8 -8
  199. package/build/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.js +650 -650
  200. package/build/_modules/ai/_modules/ai-mock/index.d.ts +14 -14
  201. package/build/_modules/ai/_modules/ai-mock/index.js +42 -42
  202. package/build/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.d.ts +35 -35
  203. package/build/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.js +117 -117
  204. package/build/_modules/ai/_modules/anthropic/index.d.ts +2 -2
  205. package/build/_modules/ai/_modules/anthropic/index.js +7 -7
  206. package/build/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.d.ts +84 -84
  207. package/build/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.js +467 -467
  208. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.d.ts +109 -109
  209. package/build/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.js +418 -418
  210. package/build/_modules/ai/_modules/document-ai/_collections/dai-document.util.d.ts +28 -28
  211. package/build/_modules/ai/_modules/document-ai/_collections/dai-document.util.js +73 -73
  212. package/build/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.d.ts +6 -6
  213. package/build/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.js +10 -10
  214. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.d.ts +51 -51
  215. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.js +132 -132
  216. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.d.ts +47 -47
  217. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.js +136 -136
  218. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.d.ts +17 -17
  219. package/build/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.js +76 -76
  220. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.d.ts +49 -49
  221. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.js +2 -2
  222. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.d.ts +8 -8
  223. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.js +2 -2
  224. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.d.ts +11 -11
  225. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.js +2 -2
  226. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.d.ts +12 -12
  227. package/build/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.js +2 -2
  228. package/build/_modules/ai/_modules/document-ai/index.d.ts +12 -12
  229. package/build/_modules/ai/_modules/document-ai/index.js +27 -27
  230. package/build/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.d.ts +34 -34
  231. package/build/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.js +128 -128
  232. package/build/_modules/ai/_modules/fdp-ai/index.d.ts +2 -2
  233. package/build/_modules/ai/_modules/fdp-ai/index.js +7 -7
  234. package/build/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.d.ts +2 -2
  235. package/build/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.js +8 -8
  236. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.d.ts +2 -2
  237. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.js +74 -74
  238. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.d.ts +2 -2
  239. package/build/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.js +67 -67
  240. package/build/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.js +42 -42
  241. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.d.ts +5 -5
  242. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.js +2 -2
  243. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.js +6 -6
  244. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.d.ts +51 -51
  245. package/build/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.js +2 -2
  246. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.d.ts +21 -21
  247. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.js +187 -187
  248. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.d.ts +26 -26
  249. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.js +278 -278
  250. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.d.ts +22 -22
  251. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.js +322 -322
  252. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.d.ts +119 -119
  253. package/build/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.js +480 -480
  254. package/build/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.d.ts +25 -25
  255. package/build/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.js +103 -103
  256. package/build/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.d.ts +169 -169
  257. package/build/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.js +479 -479
  258. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.d.ts +229 -229
  259. package/build/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.js +617 -617
  260. package/build/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.d.ts +39 -39
  261. package/build/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.js +110 -110
  262. package/build/_modules/ai/_modules/open-ai/index.d.ts +14 -14
  263. package/build/_modules/ai/_modules/open-ai/index.js +55 -55
  264. package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts +51 -51
  265. package/build/_modules/ai/_services/ai-embedding-provider.registry.js +78 -78
  266. package/build/_modules/ai/_services/ai-embedding.service-base.d.ts +41 -41
  267. package/build/_modules/ai/_services/ai-embedding.service-base.js +11 -11
  268. package/build/_modules/ai/_services/ai-llm-chat.service-base.d.ts +39 -39
  269. package/build/_modules/ai/_services/ai-llm-chat.service-base.js +11 -11
  270. package/build/_modules/ai/_services/ai-llm.service-base.d.ts +148 -148
  271. package/build/_modules/ai/_services/ai-llm.service-base.js +378 -378
  272. package/build/_modules/ai/_services/ai-provider.service-base.d.ts +46 -46
  273. package/build/_modules/ai/_services/ai-provider.service-base.js +43 -43
  274. package/build/_modules/ai/_services/ai-user-key.service-base.d.ts +44 -44
  275. package/build/_modules/ai/_services/ai-user-key.service-base.js +14 -14
  276. package/build/_modules/ai/_services/lmstudio-embedding.control-service.d.ts +110 -110
  277. package/build/_modules/ai/_services/lmstudio-embedding.control-service.js +297 -297
  278. package/build/_modules/ai/index.d.ts +16 -16
  279. package/build/_modules/ai/index.js +30 -30
  280. package/build/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.d.ts +5 -5
  281. package/build/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.js +9 -9
  282. package/build/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.d.ts +8 -8
  283. package/build/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.js +12 -12
  284. package/build/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.d.ts +6 -6
  285. package/build/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.js +10 -10
  286. package/build/_modules/artifact-compiler/_models/artifact-compile.interface.d.ts +32 -32
  287. package/build/_modules/artifact-compiler/_models/artifact-compile.interface.js +2 -2
  288. package/build/_modules/artifact-compiler/artifact-compiler.control-service.d.ts +36 -36
  289. package/build/_modules/artifact-compiler/artifact-compiler.control-service.js +273 -273
  290. package/build/_modules/artifact-compiler/index.d.ts +5 -5
  291. package/build/_modules/artifact-compiler/index.js +11 -11
  292. package/build/_modules/assistant/_collections/ass-global-settings.const.d.ts +2 -2
  293. package/build/_modules/assistant/_collections/ass-global-settings.const.js +14 -14
  294. package/build/_modules/assistant/_collections/ass.util.d.ts +15 -15
  295. package/build/_modules/assistant/_collections/ass.util.js +42 -42
  296. package/build/_modules/assistant/_models/ass-global-settings.interface.d.ts +13 -13
  297. package/build/_modules/assistant/_models/ass-global-settings.interface.js +2 -2
  298. package/build/_modules/assistant/_services/ass-io.control-service.d.ts +19 -19
  299. package/build/_modules/assistant/_services/ass-io.control-service.js +57 -57
  300. package/build/_modules/assistant/_services/ass-main.control-service.d.ts +32 -32
  301. package/build/_modules/assistant/_services/ass-main.control-service.js +65 -65
  302. package/build/_modules/assistant/index.d.ts +6 -6
  303. package/build/_modules/assistant/index.js +18 -18
  304. package/build/_modules/bot/_collections/bot-default-commands.const.d.ts +2 -2
  305. package/build/_modules/bot/_collections/bot-default-commands.const.js +13 -13
  306. package/build/_modules/bot/_collections/bot-global-settings.const.d.ts +2 -2
  307. package/build/_modules/bot/_collections/bot-global-settings.const.js +31 -31
  308. package/build/_modules/bot/_models/bot-channel-wrapper.interface.d.ts +25 -25
  309. package/build/_modules/bot/_models/bot-channel-wrapper.interface.js +38 -38
  310. package/build/_modules/bot/_models/bot-command.interface.d.ts +7 -7
  311. package/build/_modules/bot/_models/bot-command.interface.js +2 -2
  312. package/build/_modules/bot/_models/bot-global-settings.interface.d.ts +85 -85
  313. package/build/_modules/bot/_models/bot-global-settings.interface.js +2 -2
  314. package/build/_modules/bot/_models/bot-last-mention-date.interface.d.ts +6 -6
  315. package/build/_modules/bot/_models/bot-last-mention-date.interface.js +2 -2
  316. package/build/_modules/bot/_models/bot-last-message-date.interface.d.ts +5 -5
  317. package/build/_modules/bot/_models/bot-last-message-date.interface.js +2 -2
  318. package/build/_modules/bot/_models/bot-message-wrapper.interface.d.ts +37 -37
  319. package/build/_modules/bot/_models/bot-message-wrapper.interface.js +54 -54
  320. package/build/_modules/bot/_models/bot-user-wrapper.interface.d.ts +23 -23
  321. package/build/_modules/bot/_models/bot-user-wrapper.interface.js +28 -28
  322. package/build/_modules/bot/_modules/discord-bot/_models/dib-platform.types.js +10 -10
  323. package/build/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.d.ts +69 -69
  324. package/build/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.js +497 -497
  325. package/build/_modules/bot/_modules/discord-bot/index.d.ts +1 -1
  326. package/build/_modules/bot/_modules/discord-bot/index.js +12 -12
  327. package/build/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.d.ts +16 -16
  328. package/build/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.js +42 -42
  329. package/build/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.d.ts +9 -9
  330. package/build/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.js +2 -2
  331. package/build/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.d.ts +59 -59
  332. package/build/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.js +349 -349
  333. package/build/_modules/bot/_modules/dynamo-bot/index.d.ts +3 -3
  334. package/build/_modules/bot/_modules/dynamo-bot/index.js +15 -15
  335. package/build/_modules/bot/_modules/slack-bot/_models/slb-platform.types.d.ts +6 -6
  336. package/build/_modules/bot/_modules/slack-bot/_models/slb-platform.types.js +2 -2
  337. package/build/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.d.ts +56 -56
  338. package/build/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.js +137 -137
  339. package/build/_modules/bot/_modules/slack-bot/index.d.ts +2 -2
  340. package/build/_modules/bot/_modules/slack-bot/index.js +12 -12
  341. package/build/_modules/bot/_modules/teams-bot/_models/teb-platform.types.d.ts +6 -6
  342. package/build/_modules/bot/_modules/teams-bot/_models/teb-platform.types.js +2 -2
  343. package/build/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.d.ts +56 -56
  344. package/build/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.js +137 -137
  345. package/build/_modules/bot/_modules/teams-bot/index.d.ts +2 -2
  346. package/build/_modules/bot/_modules/teams-bot/index.js +12 -12
  347. package/build/_modules/bot/_services/bot-commands.control-service.d.ts +12 -12
  348. package/build/_modules/bot/_services/bot-commands.control-service.js +117 -117
  349. package/build/_modules/bot/_services/bot-io.control-service.d.ts +23 -23
  350. package/build/_modules/bot/_services/bot-io.control-service.js +226 -226
  351. package/build/_modules/bot/_services/bot-main.control-service.d.ts +35 -35
  352. package/build/_modules/bot/_services/bot-main.control-service.js +195 -195
  353. package/build/_modules/bot/_services/bot-messaging-provider.service-base.d.ts +71 -71
  354. package/build/_modules/bot/_services/bot-messaging-provider.service-base.js +15 -15
  355. package/build/_modules/bot/_services/bot-routines.control-service.d.ts +13 -13
  356. package/build/_modules/bot/_services/bot-routines.control-service.js +59 -59
  357. package/build/_modules/bot/index.d.ts +17 -17
  358. package/build/_modules/bot/index.js +36 -36
  359. package/build/_modules/custom-data/custom-data.controller.d.ts +5 -5
  360. package/build/_modules/custom-data/custom-data.controller.js +56 -56
  361. package/build/_modules/custom-data/custom-data.data-service.d.ts +5 -5
  362. package/build/_modules/custom-data/custom-data.data-service.js +11 -11
  363. package/build/_modules/custom-data/get-custom-data-routing-module.util.d.ts +3 -3
  364. package/build/_modules/custom-data/get-custom-data-routing-module.util.js +16 -16
  365. package/build/_modules/custom-data/index.d.ts +4 -4
  366. package/build/_modules/custom-data/index.js +9 -9
  367. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.d.ts +58 -58
  368. package/build/_modules/data-readers/_collections/dynts-sqlite-reader.util.js +168 -168
  369. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.d.ts +31 -31
  370. package/build/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.js +7 -7
  371. package/build/_modules/data-readers/index.d.ts +2 -2
  372. package/build/_modules/data-readers/index.js +10 -10
  373. package/build/_modules/defaults/_collections/default-endpoints.util.d.ts +248 -248
  374. package/build/_modules/defaults/_collections/default-endpoints.util.js +386 -386
  375. package/build/_modules/defaults/_models/default-user.data-model.d.ts +19 -19
  376. package/build/_modules/defaults/_models/default-user.data-model.js +72 -72
  377. package/build/_modules/defaults/_services/default-auth.service.d.ts +50 -50
  378. package/build/_modules/defaults/_services/default-auth.service.js +158 -158
  379. package/build/_modules/defaults/_services/default-socket-events.service.d.ts +23 -23
  380. package/build/_modules/defaults/_services/default-socket-events.service.js +60 -60
  381. package/build/_modules/defaults/_services/default-user.data-service.d.ts +24 -24
  382. package/build/_modules/defaults/_services/default-user.data-service.js +87 -87
  383. package/build/_modules/defaults/index.d.ts +5 -5
  384. package/build/_modules/defaults/index.js +17 -17
  385. package/build/_modules/discord-assistant/_collections/dias-global-settings.const.d.ts +2 -2
  386. package/build/_modules/discord-assistant/_collections/dias-global-settings.const.js +16 -16
  387. package/build/_modules/discord-assistant/_collections/dias.util.d.ts +31 -31
  388. package/build/_modules/discord-assistant/_collections/dias.util.js +85 -85
  389. package/build/_modules/discord-assistant/_models/dias-global-settings.interface.d.ts +17 -17
  390. package/build/_modules/discord-assistant/_models/dias-global-settings.interface.js +2 -2
  391. package/build/_modules/discord-assistant/_models/dias-knowledge.data-model.d.ts +8 -8
  392. package/build/_modules/discord-assistant/_models/dias-knowledge.data-model.js +46 -46
  393. package/build/_modules/discord-assistant/_services/dias-chunk.data-service.d.ts +17 -17
  394. package/build/_modules/discord-assistant/_services/dias-chunk.data-service.js +123 -123
  395. package/build/_modules/discord-assistant/_services/dias-io.control-service.d.ts +10 -10
  396. package/build/_modules/discord-assistant/_services/dias-io.control-service.js +49 -49
  397. package/build/_modules/discord-assistant/_services/dias-main.control-service.d.ts +3 -3
  398. package/build/_modules/discord-assistant/_services/dias-main.control-service.js +7 -7
  399. package/build/_modules/discord-assistant/_services/dias.service-base.d.ts +18 -18
  400. package/build/_modules/discord-assistant/_services/dias.service-base.js +46 -46
  401. package/build/_modules/discord-assistant/index.d.ts +11 -11
  402. package/build/_modules/discord-assistant/index.js +24 -24
  403. package/build/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.d.ts +3 -3
  404. package/build/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.js +7 -7
  405. package/build/_modules/discord-assistant-voiced/index.d.ts +2 -2
  406. package/build/_modules/discord-assistant-voiced/index.js +28 -28
  407. package/build/_modules/discord-bot/_collections/dibo-default-commands.const.d.ts +2 -2
  408. package/build/_modules/discord-bot/_collections/dibo-default-commands.const.js +12 -12
  409. package/build/_modules/discord-bot/_collections/dibo-global-settings.conts.d.ts +2 -2
  410. package/build/_modules/discord-bot/_collections/dibo-global-settings.conts.js +43 -43
  411. package/build/_modules/discord-bot/_collections/dibo-operations.util.d.ts +22 -22
  412. package/build/_modules/discord-bot/_collections/dibo-operations.util.js +275 -275
  413. package/build/_modules/discord-bot/_models/dibo-command.interface.d.ts +7 -7
  414. package/build/_modules/discord-bot/_models/dibo-command.interface.js +2 -2
  415. package/build/_modules/discord-bot/_models/dibo-global-settings.interface.d.ts +87 -87
  416. package/build/_modules/discord-bot/_models/dibo-global-settings.interface.js +2 -2
  417. package/build/_modules/discord-bot/_models/dibo-last-mention-date.inteface.d.ts +6 -6
  418. package/build/_modules/discord-bot/_models/dibo-last-mention-date.inteface.js +2 -2
  419. package/build/_modules/discord-bot/_models/dibo-last-message-date.interface.d.ts +5 -5
  420. package/build/_modules/discord-bot/_models/dibo-last-message-date.interface.js +2 -2
  421. package/build/_modules/discord-bot/_services/dibo-commands.control-service.d.ts +11 -11
  422. package/build/_modules/discord-bot/_services/dibo-commands.control-service.js +109 -109
  423. package/build/_modules/discord-bot/_services/dibo-io.control-service.d.ts +21 -21
  424. package/build/_modules/discord-bot/_services/dibo-io.control-service.js +218 -218
  425. package/build/_modules/discord-bot/_services/dibo-main.control-service.d.ts +89 -89
  426. package/build/_modules/discord-bot/_services/dibo-main.control-service.js +363 -363
  427. package/build/_modules/discord-bot/_services/dibo-routines.control-service.d.ts +13 -13
  428. package/build/_modules/discord-bot/_services/dibo-routines.control-service.js +73 -73
  429. package/build/_modules/discord-bot/index.d.ts +11 -11
  430. package/build/_modules/discord-bot/index.js +30 -30
  431. package/build/_modules/local-vector-search/_enums/lvs-search-mode.enum.d.ts +34 -34
  432. package/build/_modules/local-vector-search/_enums/lvs-search-mode.enum.js +38 -38
  433. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.d.ts +35 -35
  434. package/build/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.js +53 -53
  435. package/build/_modules/local-vector-search/_models/lvs-search-result.interface.d.ts +16 -16
  436. package/build/_modules/local-vector-search/_models/lvs-search-result.interface.js +2 -2
  437. package/build/_modules/local-vector-search/_services/lvs-bm25.util.d.ts +88 -88
  438. package/build/_modules/local-vector-search/_services/lvs-bm25.util.js +189 -189
  439. package/build/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.d.ts +26 -26
  440. package/build/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.js +197 -197
  441. package/build/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.d.ts +145 -145
  442. package/build/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.js +294 -294
  443. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.d.ts +74 -74
  444. package/build/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.js +152 -152
  445. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.d.ts +51 -51
  446. package/build/_modules/local-vector-search/_services/lvs-vector-persist.data-service.js +83 -83
  447. package/build/_modules/local-vector-search/_services/lvs-vector-pool.control-service.d.ts +99 -99
  448. package/build/_modules/local-vector-search/_services/lvs-vector-pool.control-service.js +276 -276
  449. package/build/_modules/local-vector-search/index.d.ts +8 -8
  450. package/build/_modules/local-vector-search/index.js +15 -15
  451. package/build/_modules/logs/_models/file-log-entry.interface.d.ts +13 -13
  452. package/build/_modules/logs/_models/file-log-entry.interface.js +2 -2
  453. package/build/_modules/logs/_models/file-log-read-result.interface.d.ts +35 -35
  454. package/build/_modules/logs/_models/file-log-read-result.interface.js +2 -2
  455. package/build/_modules/logs/file-log.service.d.ts +132 -132
  456. package/build/_modules/logs/file-log.service.js +444 -444
  457. package/build/_modules/logs/file-logs.controller.d.ts +40 -40
  458. package/build/_modules/logs/file-logs.controller.js +138 -138
  459. package/build/_modules/logs/get-file-logs-routing-module.util.d.ts +31 -31
  460. package/build/_modules/logs/get-file-logs-routing-module.util.js +37 -37
  461. package/build/_modules/logs/get-logs-routing-module.util.d.ts +18 -18
  462. package/build/_modules/logs/get-logs-routing-module.util.js +31 -31
  463. package/build/_modules/logs/index.d.ts +8 -8
  464. package/build/_modules/logs/index.js +15 -15
  465. package/build/_modules/logs/log-buffer.service.d.ts +37 -37
  466. package/build/_modules/logs/log-buffer.service.js +96 -96
  467. package/build/_modules/logs/logs.controller.d.ts +26 -26
  468. package/build/_modules/logs/logs.controller.js +89 -89
  469. package/build/_modules/logs/logs.service.d.ts +39 -39
  470. package/build/_modules/logs/logs.service.js +96 -96
  471. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.d.ts +108 -108
  472. package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js +13 -13
  473. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts +70 -70
  474. package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js +98 -98
  475. package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts +56 -56
  476. package/build/_modules/mcp/_services/dynts-mcp.adapter.js +138 -138
  477. package/build/_modules/mcp/index.d.ts +3 -3
  478. package/build/_modules/mcp/index.js +12 -12
  479. package/build/_modules/messaging/_collections/get-messaging-routing-module.util.d.ts +7 -7
  480. package/build/_modules/messaging/_collections/get-messaging-routing-module.util.js +20 -20
  481. package/build/_modules/messaging/_collections/msg-global-settings.const.d.ts +5 -5
  482. package/build/_modules/messaging/_collections/msg-global-settings.const.js +22 -22
  483. package/build/_modules/messaging/_collections/msg.util.d.ts +24 -24
  484. package/build/_modules/messaging/_collections/msg.util.js +62 -62
  485. package/build/_modules/messaging/_models/msg-global-settings.interface.d.ts +28 -28
  486. package/build/_modules/messaging/_models/msg-global-settings.interface.js +2 -2
  487. package/build/_modules/messaging/_services/msg-conversation.data-service.d.ts +28 -28
  488. package/build/_modules/messaging/_services/msg-conversation.data-service.js +109 -109
  489. package/build/_modules/messaging/_services/msg-events.service.d.ts +61 -61
  490. package/build/_modules/messaging/_services/msg-events.service.js +203 -203
  491. package/build/_modules/messaging/_services/msg-integration.control-service.js +180 -180
  492. package/build/_modules/messaging/_services/msg-main.control-service.d.ts +62 -62
  493. package/build/_modules/messaging/_services/msg-main.control-service.js +428 -428
  494. package/build/_modules/messaging/_services/msg-message.data-service.d.ts +28 -28
  495. package/build/_modules/messaging/_services/msg-message.data-service.js +103 -103
  496. package/build/_modules/messaging/_services/msg.controller.d.ts +12 -12
  497. package/build/_modules/messaging/_services/msg.controller.js +256 -256
  498. package/build/_modules/messaging/index.d.ts +10 -10
  499. package/build/_modules/messaging/index.js +27 -27
  500. package/build/_modules/mock/app-extended-server.mock.d.ts +41 -41
  501. package/build/_modules/mock/app-extended-server.mock.js +169 -169
  502. package/build/_modules/mock/app-integration-test.mock.d.ts +19 -19
  503. package/build/_modules/mock/app-integration-test.mock.js +45 -45
  504. package/build/_modules/mock/app-params.mock.d.ts +2 -2
  505. package/build/_modules/mock/app-params.mock.js +9 -9
  506. package/build/_modules/mock/app-server.mock.d.ts +41 -41
  507. package/build/_modules/mock/app-server.mock.js +148 -148
  508. package/build/_modules/mock/auth-service.mock.d.ts +10 -10
  509. package/build/_modules/mock/auth-service.mock.js +19 -19
  510. package/build/_modules/mock/controller.mock.d.ts +5 -5
  511. package/build/_modules/mock/controller.mock.js +14 -14
  512. package/build/_modules/mock/data-model.mock.d.ts +26 -26
  513. package/build/_modules/mock/data-model.mock.js +72 -72
  514. package/build/_modules/mock/email-service-collection.mock.d.ts +7 -7
  515. package/build/_modules/mock/email-service-collection.mock.js +12 -12
  516. package/build/_modules/mock/email-service.mock.d.ts +4 -4
  517. package/build/_modules/mock/email-service.mock.js +20 -20
  518. package/build/_modules/mock/endpoint.mock.d.ts +8 -8
  519. package/build/_modules/mock/endpoint.mock.js +79 -79
  520. package/build/_modules/mock/socket-client.mock.d.ts +9 -9
  521. package/build/_modules/mock/socket-client.mock.js +38 -38
  522. package/build/_modules/mock/socket-server.mock.d.ts +15 -15
  523. package/build/_modules/mock/socket-server.mock.js +32 -32
  524. package/build/_modules/oauth2/_routes/oauth2.controller.d.ts +16 -16
  525. package/build/_modules/oauth2/_routes/oauth2.controller.js +96 -96
  526. package/build/_modules/oauth2/_services/oauth2.auth-service.d.ts +30 -30
  527. package/build/_modules/oauth2/_services/oauth2.auth-service.js +215 -215
  528. package/build/_modules/oauth2/_services/oauth2.control-service.d.ts +132 -132
  529. package/build/_modules/oauth2/_services/oauth2.control-service.js +576 -576
  530. package/build/_modules/oauth2/index.d.ts +3 -3
  531. package/build/_modules/oauth2/index.js +14 -14
  532. package/build/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.d.ts +5 -5
  533. package/build/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.js +9 -9
  534. package/build/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.d.ts +10 -10
  535. package/build/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.js +14 -14
  536. package/build/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.d.ts +7 -7
  537. package/build/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.js +11 -11
  538. package/build/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.d.ts +15 -15
  539. package/build/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.js +19 -19
  540. package/build/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.d.ts +9 -9
  541. package/build/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.js +13 -13
  542. package/build/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.d.ts +11 -11
  543. package/build/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.js +2 -2
  544. package/build/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.d.ts +6 -6
  545. package/build/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.js +2 -2
  546. package/build/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.d.ts +14 -14
  547. package/build/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.js +2 -2
  548. package/build/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.d.ts +6 -6
  549. package/build/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.js +2 -2
  550. package/build/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.d.ts +12 -12
  551. package/build/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.js +2 -2
  552. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.d.ts +8 -8
  553. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.js +2 -2
  554. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.d.ts +13 -13
  555. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.js +2 -2
  556. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.d.ts +7 -7
  557. package/build/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.js +2 -2
  558. package/build/_modules/privacy-lifecycle/_models/privacy-contributor.interface.d.ts +10 -10
  559. package/build/_modules/privacy-lifecycle/_models/privacy-contributor.interface.js +2 -2
  560. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts +71 -0
  561. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.d.ts.map +1 -0
  562. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js +3 -0
  563. package/build/_modules/privacy-lifecycle/_models/privacy-export-artifact.interface.js.map +1 -0
  564. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.d.ts +12 -12
  565. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.js +2 -2
  566. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.d.ts +8 -8
  567. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.js +2 -2
  568. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.d.ts +6 -6
  569. package/build/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.js +2 -2
  570. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.d.ts +10 -10
  571. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.js +2 -2
  572. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.d.ts +6 -6
  573. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.js +2 -2
  574. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.d.ts +6 -6
  575. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.js +2 -2
  576. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.d.ts +11 -11
  577. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.js +2 -2
  578. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.d.ts +13 -13
  579. package/build/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.js +2 -2
  580. package/build/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.d.ts +14 -14
  581. package/build/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.js +2 -2
  582. package/build/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.d.ts +8 -8
  583. package/build/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.js +2 -2
  584. package/build/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.d.ts +6 -6
  585. package/build/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.js +2 -2
  586. package/build/_modules/privacy-lifecycle/_models/privacy-request-open.interface.d.ts +9 -9
  587. package/build/_modules/privacy-lifecycle/_models/privacy-request-open.interface.js +2 -2
  588. package/build/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.d.ts +6 -6
  589. package/build/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.js +2 -2
  590. package/build/_modules/privacy-lifecycle/_models/privacy-request-record.interface.d.ts +20 -20
  591. package/build/_modules/privacy-lifecycle/_models/privacy-request-record.interface.js +2 -2
  592. package/build/_modules/privacy-lifecycle/_models/privacy-request-result.interface.d.ts +7 -7
  593. package/build/_modules/privacy-lifecycle/_models/privacy-request-result.interface.js +2 -2
  594. package/build/_modules/privacy-lifecycle/_models/privacy-request-view.interface.d.ts +19 -19
  595. package/build/_modules/privacy-lifecycle/_models/privacy-request-view.interface.js +2 -2
  596. package/build/_modules/privacy-lifecycle/index.d.ts +35 -32
  597. package/build/_modules/privacy-lifecycle/index.d.ts.map +1 -1
  598. package/build/_modules/privacy-lifecycle/index.js +21 -17
  599. package/build/_modules/privacy-lifecycle/index.js.map +1 -1
  600. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts +48 -0
  601. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.d.ts.map +1 -0
  602. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js +332 -0
  603. package/build/_modules/privacy-lifecycle/privacy-export-artifact.control-service.js.map +1 -0
  604. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts +25 -0
  605. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.d.ts.map +1 -0
  606. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js +126 -0
  607. package/build/_modules/privacy-lifecycle/privacy-export-artifact.mongo-store.js.map +1 -0
  608. package/build/_modules/privacy-lifecycle/privacy-ledger.control-service.d.ts +27 -27
  609. package/build/_modules/privacy-lifecycle/privacy-ledger.control-service.js +167 -167
  610. package/build/_modules/privacy-lifecycle/privacy-lifecycle.control-service.d.ts +41 -41
  611. package/build/_modules/privacy-lifecycle/privacy-lifecycle.control-service.js +363 -363
  612. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.d.ts +5 -5
  613. package/build/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.js +9 -9
  614. package/build/_modules/rate-limit/_models/rate-limit-config.interface.d.ts +70 -70
  615. package/build/_modules/rate-limit/_models/rate-limit-config.interface.js +2 -2
  616. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.d.ts +8 -8
  617. package/build/_modules/rate-limit/_models/rate-limit-consume-request.interface.js +2 -2
  618. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.d.ts +6 -6
  619. package/build/_modules/rate-limit/_models/rate-limit-consume-result.interface.js +2 -2
  620. package/build/_modules/rate-limit/_models/rate-limit-policy.interface.d.ts +15 -15
  621. package/build/_modules/rate-limit/_models/rate-limit-policy.interface.js +2 -2
  622. package/build/_modules/rate-limit/_models/rate-limit-store.interface.d.ts +8 -8
  623. package/build/_modules/rate-limit/_models/rate-limit-store.interface.js +2 -2
  624. package/build/_modules/rate-limit/index.d.ts +8 -8
  625. package/build/_modules/rate-limit/index.js +9 -9
  626. package/build/_modules/rate-limit/rate-limit-in-memory.store.d.ts +18 -18
  627. package/build/_modules/rate-limit/rate-limit-in-memory.store.js +70 -70
  628. package/build/_modules/rate-limit/rate-limit.middleware.d.ts +68 -68
  629. package/build/_modules/rate-limit/rate-limit.middleware.js +378 -378
  630. package/build/_modules/scheduler/_models/scheduler-job.interface.d.ts +33 -33
  631. package/build/_modules/scheduler/_models/scheduler-job.interface.js +2 -2
  632. package/build/_modules/scheduler/get-scheduler-routing-module.util.d.ts +17 -17
  633. package/build/_modules/scheduler/get-scheduler-routing-module.util.js +30 -30
  634. package/build/_modules/scheduler/index.d.ts +4 -4
  635. package/build/_modules/scheduler/index.js +9 -9
  636. package/build/_modules/scheduler/scheduler.controller.d.ts +24 -24
  637. package/build/_modules/scheduler/scheduler.controller.js +53 -53
  638. package/build/_modules/scheduler/scheduler.service.d.ts +53 -53
  639. package/build/_modules/scheduler/scheduler.service.js +163 -163
  640. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts +18 -18
  641. package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js +22 -22
  642. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts +43 -43
  643. package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js +67 -67
  644. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts +88 -88
  645. package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js +11 -11
  646. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.d.ts +83 -83
  647. package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.js +219 -219
  648. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.d.ts +53 -53
  649. package/build/_modules/scoped-config/_services/dynts-scoped-config.data-service.js +75 -75
  650. package/build/_modules/scoped-config/index.d.ts +5 -5
  651. package/build/_modules/scoped-config/index.js +14 -14
  652. package/build/_modules/server/errors/errors.control-service.d.ts +21 -21
  653. package/build/_modules/server/errors/errors.control-service.js +10 -10
  654. package/build/_modules/server/errors/errors.controller.d.ts +144 -144
  655. package/build/_modules/server/errors/errors.controller.js +404 -404
  656. package/build/_modules/server/errors/errors.data-service.d.ts +70 -70
  657. package/build/_modules/server/errors/errors.data-service.js +677 -677
  658. package/build/_modules/server/index.d.ts +15 -15
  659. package/build/_modules/server/index.js +35 -35
  660. package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.d.ts +8 -8
  661. package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.js +12 -12
  662. package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.d.ts +20 -20
  663. package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.js +24 -24
  664. package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.d.ts +18 -18
  665. package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.js +82 -82
  666. package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.d.ts +18 -18
  667. package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.js +2 -2
  668. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts +13 -13
  669. package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.js +17 -17
  670. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.d.ts +7 -7
  671. package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.js +11 -11
  672. package/build/_modules/server/server-status/db-readiness-probe.control-service.d.ts +13 -13
  673. package/build/_modules/server/server-status/db-readiness-probe.control-service.js +125 -125
  674. package/build/_modules/server/server-status/db-readiness-probe.interface.d.ts +17 -17
  675. package/build/_modules/server/server-status/db-readiness-probe.interface.js +2 -2
  676. package/build/_modules/server/server-status/server-status-snapshot.control-service.d.ts +4 -4
  677. package/build/_modules/server/server-status/server-status-snapshot.control-service.js +7 -7
  678. package/build/_modules/server/server-status/server-status-snapshot.data-service.d.ts +6 -6
  679. package/build/_modules/server/server-status/server-status-snapshot.data-service.js +22 -22
  680. package/build/_modules/server/server-status/server-status.control-service.d.ts +111 -111
  681. package/build/_modules/server/server-status/server-status.control-service.js +302 -302
  682. package/build/_modules/server/server-status/server-status.controller.d.ts +92 -92
  683. package/build/_modules/server/server-status/server-status.controller.js +253 -253
  684. package/build/_modules/socket/_enums/socket-security.enum.d.ts +10 -10
  685. package/build/_modules/socket/_enums/socket-security.enum.js +14 -14
  686. package/build/_modules/socket/_models/socket-client-service-params.control-model.d.ts +8 -8
  687. package/build/_modules/socket/_models/socket-client-service-params.control-model.js +16 -16
  688. package/build/_modules/socket/_models/socket-presence.control-model.d.ts +25 -25
  689. package/build/_modules/socket/_models/socket-presence.control-model.js +140 -140
  690. package/build/_modules/socket/_models/socket-server-service-params.control-model.d.ts +22 -22
  691. package/build/_modules/socket/_models/socket-server-service-params.control-model.js +31 -31
  692. package/build/_modules/socket/_services/socket-client.service.d.ts +37 -37
  693. package/build/_modules/socket/_services/socket-client.service.js +196 -196
  694. package/build/_modules/socket/_services/socket-server.service.d.ts +98 -98
  695. package/build/_modules/socket/_services/socket-server.service.js +673 -673
  696. package/build/_modules/socket/app-extended.server.d.ts +145 -145
  697. package/build/_modules/socket/app-extended.server.js +521 -521
  698. package/build/_modules/socket/index.d.ts +8 -8
  699. package/build/_modules/socket/index.js +35 -35
  700. package/build/_modules/test/get-test-routing-module.util.d.ts +3 -3
  701. package/build/_modules/test/get-test-routing-module.util.js +16 -16
  702. package/build/_modules/test/index.d.ts +3 -3
  703. package/build/_modules/test/index.js +11 -11
  704. package/build/_modules/test/test.controller.d.ts +5 -5
  705. package/build/_modules/test/test.controller.js +103 -103
  706. package/build/_modules/test-email-sink/_collections/test-email-pattern.const.d.ts +10 -10
  707. package/build/_modules/test-email-sink/_collections/test-email-pattern.const.js +13 -13
  708. package/build/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.d.ts +21 -21
  709. package/build/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.js +38 -38
  710. package/build/_modules/test-email-sink/_services/dynts-test-email-sink.service.d.ts +49 -49
  711. package/build/_modules/test-email-sink/_services/dynts-test-email-sink.service.js +117 -117
  712. package/build/_modules/test-email-sink/get-sent-mail-routing-module.util.d.ts +14 -14
  713. package/build/_modules/test-email-sink/get-sent-mail-routing-module.util.js +26 -26
  714. package/build/_modules/test-email-sink/index.d.ts +11 -11
  715. package/build/_modules/test-email-sink/index.js +14 -14
  716. package/build/_modules/test-email-sink/test-email-sink.controller.d.ts +23 -23
  717. package/build/_modules/test-email-sink/test-email-sink.controller.js +66 -66
  718. package/build/_modules/usage/get-usage-routing-module.util.d.ts +3 -3
  719. package/build/_modules/usage/get-usage-routing-module.util.js +16 -16
  720. package/build/_modules/usage/index.d.ts +4 -4
  721. package/build/_modules/usage/index.js +13 -13
  722. package/build/_modules/usage/usage.controller.d.ts +6 -6
  723. package/build/_modules/usage/usage.controller.js +105 -105
  724. package/build/_modules/usage/usage.data-service.d.ts +17 -17
  725. package/build/_modules/usage/usage.data-service.js +135 -135
  726. package/build/_services/base/api.service-base.d.ts +9 -9
  727. package/build/_services/base/api.service-base.js +46 -46
  728. package/build/_services/base/archive-data.service.d.ts +25 -25
  729. package/build/_services/base/archive-data.service.js +151 -151
  730. package/build/_services/base/data.service.d.ts +402 -402
  731. package/build/_services/base/data.service.js +2131 -2131
  732. package/build/_services/base/db.service.d.ts +424 -424
  733. package/build/_services/base/db.service.js +1356 -1356
  734. package/build/_services/base/singleton.service-base.d.ts +8 -8
  735. package/build/_services/base/singleton.service-base.js +21 -21
  736. package/build/_services/base/singleton.service.d.ts +11 -11
  737. package/build/_services/base/singleton.service.js +31 -31
  738. package/build/_services/core/api.service.d.ts +45 -45
  739. package/build/_services/core/api.service.js +456 -456
  740. package/build/_services/core/auth.service.d.ts +129 -129
  741. package/build/_services/core/auth.service.js +59 -59
  742. package/build/_services/core/collection-growth-monitor.service.d.ts +76 -76
  743. package/build/_services/core/collection-growth-monitor.service.js +165 -165
  744. package/build/_services/core/db-stats.service.d.ts +33 -33
  745. package/build/_services/core/db-stats.service.js +64 -64
  746. package/build/_services/core/diagnostics.service.d.ts +42 -42
  747. package/build/_services/core/diagnostics.service.js +121 -121
  748. package/build/_services/core/email.service.d.ts +77 -77
  749. package/build/_services/core/email.service.js +503 -503
  750. package/build/_services/core/event-loop-diag.service.d.ts +49 -49
  751. package/build/_services/core/event-loop-diag.service.js +106 -106
  752. package/build/_services/core/global.service.d.ts +83 -83
  753. package/build/_services/core/global.service.js +386 -386
  754. package/build/_services/core/memory-guard.service.d.ts +166 -166
  755. package/build/_services/core/memory-guard.service.js +369 -369
  756. package/build/_services/core/migration-runner.service.d.ts +39 -39
  757. package/build/_services/core/migration-runner.service.js +74 -74
  758. package/build/_services/core/mongo-transaction.control-service.d.ts +18 -18
  759. package/build/_services/core/mongo-transaction.control-service.js +94 -94
  760. package/build/_services/core/request-hunter.service.d.ts +73 -73
  761. package/build/_services/core/request-hunter.service.js +122 -122
  762. package/build/_services/core/request-telemetry.control-service.d.ts +51 -0
  763. package/build/_services/core/request-telemetry.control-service.d.ts.map +1 -0
  764. package/build/_services/core/request-telemetry.control-service.js +286 -0
  765. package/build/_services/core/request-telemetry.control-service.js.map +1 -0
  766. package/build/_services/core/service-collection.service.d.ts +4 -4
  767. package/build/_services/core/service-collection.service.js +7 -7
  768. package/build/_services/route/controller.service.d.ts +124 -124
  769. package/build/_services/route/controller.service.js +95 -95
  770. package/build/_services/route/routing-module.service.d.ts +80 -80
  771. package/build/_services/route/routing-module.service.d.ts.map +1 -1
  772. package/build/_services/route/routing-module.service.js +253 -250
  773. package/build/_services/route/routing-module.service.js.map +1 -1
  774. package/build/_services/server/app.server.d.ts +434 -429
  775. package/build/_services/server/app.server.d.ts.map +1 -1
  776. package/build/_services/server/app.server.js +1239 -1226
  777. package/build/_services/server/app.server.js.map +1 -1
  778. package/build/_services/shared.static-service.d.ts +43 -43
  779. package/build/_services/shared.static-service.js +92 -92
  780. package/build/index.d.ts +66 -63
  781. package/build/index.d.ts.map +1 -1
  782. package/build/index.js +104 -101
  783. package/build/index.js.map +1 -1
  784. package/package.json +11 -4
  785. package/.c8rc.json +0 -26
  786. package/.copilot/patterns.json +0 -8
  787. package/.cursor/rules/__assistant_guide.mdc +0 -30
  788. package/.cursor/rules/__main.mdc +0 -64
  789. package/.cursor/rules/_ag_backend-structure.mdc +0 -86
  790. package/.cursor/rules/_ag_backend.mdc +0 -16
  791. package/.cursor/rules/_ag_debug.mdc +0 -8
  792. package/.cursor/rules/_ag_documentation_writing_rules.mdc +0 -372
  793. package/.cursor/rules/_ag_file-refactoring.mdc +0 -113
  794. package/.cursor/rules/_ag_fixes_rules.mdc +0 -6
  795. package/.cursor/rules/_ag_frontend-structure.mdc +0 -87
  796. package/.cursor/rules/_ag_frontend.mdc +0 -40
  797. package/.cursor/rules/_ag_import-rules.mdc +0 -45
  798. package/.cursor/rules/_ag_naming.mdc +0 -116
  799. package/.cursor/rules/_ag_running_commands.mdc +0 -5
  800. package/.cursor/rules/_ag_server-controller.mdc +0 -6
  801. package/.cursor/rules/_ag_should-be.mdc +0 -7
  802. package/.cursor/rules/_ag_swearing.mdc +0 -47
  803. package/.cursor/rules/ai_development_guide.md +0 -61
  804. package/.cursor/rules/ai_directives.md +0 -114
  805. package/.cursor/rules/cursor-rules.md +0 -160
  806. package/.cursor/rules/default-command.mdc +0 -465
  807. package/.cursor/rules/error_code_pattern.md +0 -40
  808. package/.cursor/rules/saved rule mcp server use.md +0 -16
  809. package/.dynamo/pipeline.cicd.config.json +0 -190
  810. package/.dynamo/version-bump.config.json +0 -5
  811. package/.github/workflows/main.yml +0 -438
  812. package/.husky/pre-commit +0 -3
  813. package/.vscode/settings.json +0 -11
  814. package/BuildPackage.bat +0 -1
  815. package/HOWTO.md +0 -15
  816. package/__documentations/2026-04-28-logs-module.md +0 -49
  817. package/__documentations/2026-05-17-oai-compatible-providers.md +0 -229
  818. package/__documentations/2026-05-17-static-client-serving-howto.md +0 -144
  819. package/__documentations/2026-06-01-fr041-cors-middleware.md +0 -96
  820. package/__documentations/2026-06-01-fr047-p2p3-function-calling.md +0 -81
  821. package/__documentations/2026-06-15-fr193-memory-guard.md +0 -73
  822. package/__documentations/2026-08-08-fr292-app-version-header.md +0 -38
  823. package/__documentations/2026-08-14-field-encryption-mongoose-document-spread.md +0 -124
  824. package/__documentations/2026-08-18-artifact-compiler.md +0 -46
  825. package/__documentations/2026-08-18-mongo-transaction-control-service.md +0 -82
  826. package/__documentations/2026-08-18-standalone-account-security-and-privacy-bedrock.md +0 -132
  827. package/__documentations/2026-08-21-distributed-rate-limit-bfr-ctm-010.md +0 -59
  828. package/__documentations/2026-08-22-bfr-ctm-018-content-free-endpoint-errors.md +0 -54
  829. package/__documentations/2026-08-22-content-free-process-error-boundary.md +0 -111
  830. package/__documentations/2026-08-22-npm-token-state-classifier.md +0 -92
  831. package/__documentations/nts-integration-tests-2026-03-17.md +0 -26
  832. package/__documentations/plans/BEDROCK-HYPERPLAN.md +0 -95
  833. package/_specifications/BACKLOG.md +0 -92
  834. package/_specifications/TODO.md +0 -15
  835. package/_specifications/agent.md +0 -138
  836. package/eslint.config.js +0 -3
  837. package/nodemon.json +0 -24
  838. package/pnpm-workspace.yaml +0 -6
  839. package/scripts/_seed-out/aim-seed.fixtures.ts +0 -161
  840. package/scripts/_seed-out/image-raw.json +0 -1
  841. package/scripts/_seed-out/llm-expand-raw.json +0 -60
  842. package/scripts/_seed-out/sample-image.png +0 -0
  843. package/scripts/_seed-out/seed-raw.json +0 -153
  844. package/scripts/ai-fixture-seed.js +0 -126
  845. package/scripts/run-coverage-tests.js +0 -28
  846. package/spec/support/helpers/spec-reporter-loader.js +0 -359
  847. package/spec/support/helpers/ts-node-helper.js +0 -93
  848. package/spec/support/jasmine.coverage.json +0 -24
  849. package/spec/support/jasmine.json +0 -24
  850. package/src/_assets/dynamo-nts-logo-128.png +0 -0
  851. package/src/_assets/dynamo-nts-logo-256.png +0 -0
  852. package/src/_assets/dynamo-nts-logo-512.png +0 -0
  853. package/src/_assets/dynamo-nts-logo-64.png +0 -0
  854. package/src/_collections/app-version-header.util.spec.ts +0 -108
  855. package/src/_collections/app-version-header.util.ts +0 -74
  856. package/src/_collections/archive-service-registry.const.ts +0 -21
  857. package/src/_collections/archive.util.spec.ts +0 -57
  858. package/src/_collections/archive.util.ts +0 -18
  859. package/src/_collections/atlas-default-db-options.const.ts +0 -10
  860. package/src/_collections/client-safe-error.util.spec.ts +0 -151
  861. package/src/_collections/client-safe-error.util.ts +0 -107
  862. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +0 -11
  863. package/src/_collections/default-fallback-cache-max-age.const.ts +0 -2
  864. package/src/_collections/default-not-found-page.const.spec.ts +0 -19
  865. package/src/_collections/default-not-found-page.const.ts +0 -22
  866. package/src/_collections/default-socket-path.const.spec.ts +0 -12
  867. package/src/_collections/default-socket-path.const.ts +0 -2
  868. package/src/_collections/field-encryption.util.spec.ts +0 -195
  869. package/src/_collections/field-encryption.util.ts +0 -222
  870. package/src/_collections/get-environment-settings.util.spec.ts +0 -210
  871. package/src/_collections/get-environment-settings.util.ts +0 -49
  872. package/src/_collections/global-settings.const.ts +0 -126
  873. package/src/_collections/load-shed.util.spec.ts +0 -62
  874. package/src/_collections/load-shed.util.ts +0 -51
  875. package/src/_collections/mongo-reconnect-guard.util.spec.ts +0 -52
  876. package/src/_collections/mongo-reconnect-guard.util.ts +0 -172
  877. package/src/_collections/npm-token-check.util.spec.ts +0 -218
  878. package/src/_collections/npm-token-check.util.ts +0 -327
  879. package/src/_collections/sample.env +0 -21
  880. package/src/_collections/security-headers.util.spec.ts +0 -98
  881. package/src/_collections/security-headers.util.ts +0 -96
  882. package/src/_collections/signed-url.util.spec.ts +0 -198
  883. package/src/_collections/signed-url.util.ts +0 -170
  884. package/src/_collections/star.controller.spec.ts +0 -224
  885. package/src/_collections/star.controller.ts +0 -130
  886. package/src/_collections/static-cache-control.util.spec.ts +0 -47
  887. package/src/_collections/static-cache-control.util.ts +0 -25
  888. package/src/_enums/data-model-type.enum.ts +0 -14
  889. package/src/_enums/data-service-function.enum.ts +0 -24
  890. package/src/_enums/predefined-data-types.enum.ts +0 -17
  891. package/src/_enums/route-security.enum.ts +0 -12
  892. package/src/_models/control-models/api-call-params.control-model.spec.ts +0 -152
  893. package/src/_models/control-models/api-call-params.control-model.ts +0 -142
  894. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +0 -52
  895. package/src/_models/control-models/app-ext-system-controls.control-model.ts +0 -9
  896. package/src/_models/control-models/app-params.control-model.spec.ts +0 -229
  897. package/src/_models/control-models/app-params.control-model.ts +0 -137
  898. package/src/_models/control-models/app-system-controls.control-model.spec.ts +0 -31
  899. package/src/_models/control-models/app-system-controls.control-model.ts +0 -9
  900. package/src/_models/control-models/endpoint-params.control-model.spec.ts +0 -754
  901. package/src/_models/control-models/endpoint-params.control-model.ts +0 -575
  902. package/src/_models/control-models/http-settings.control-model.spec.ts +0 -77
  903. package/src/_models/control-models/http-settings.control-model.ts +0 -37
  904. package/src/_models/control-models/system-control.control-model.spec.ts +0 -27
  905. package/src/_models/control-models/system-control.control-model.ts +0 -12
  906. package/src/_models/data-models/schema-migration.data-model.ts +0 -50
  907. package/src/_models/interfaces/app-version-header-settings.interface.ts +0 -17
  908. package/src/_models/interfaces/certification-settings.interface.ts +0 -7
  909. package/src/_models/interfaces/compare-data-options.interface.ts +0 -27
  910. package/src/_models/interfaces/compare-data-result.interface.ts +0 -12
  911. package/src/_models/interfaces/cors-settings.interface.spec.ts +0 -52
  912. package/src/_models/interfaces/cors-settings.interface.ts +0 -56
  913. package/src/_models/interfaces/db-query-options.interface.ts +0 -33
  914. package/src/_models/interfaces/environment-settings.interface.ts +0 -59
  915. package/src/_models/interfaces/global-log-settings.interface.ts +0 -171
  916. package/src/_models/interfaces/global-service-settings.interface.ts +0 -47
  917. package/src/_models/interfaces/global-settings.interface.ts +0 -294
  918. package/src/_models/interfaces/migration-entry.interface.ts +0 -19
  919. package/src/_models/interfaces/mongo-transaction-settings.interface.ts +0 -9
  920. package/src/_models/interfaces/routing-module-settings.interface.ts +0 -21
  921. package/src/_models/interfaces/security-headers-settings.interface.ts +0 -50
  922. package/src/_models/interfaces/signed-url-verify-result.interface.ts +0 -13
  923. package/src/_models/interfaces/static-client-settings.interface.spec.ts +0 -29
  924. package/src/_models/interfaces/static-client-settings.interface.ts +0 -36
  925. package/src/_models/types/db-update.type.ts +0 -100
  926. package/src/_modules/account-security/_enums/account-challenge-purpose.type-enum.ts +0 -5
  927. package/src/_modules/account-security/_enums/account-refresh-token-state.type-enum.ts +0 -6
  928. package/src/_modules/account-security/_enums/account-session-state.type-enum.ts +0 -6
  929. package/src/_modules/account-security/_models/account-challenge-adapter.interface.ts +0 -17
  930. package/src/_modules/account-security/_models/account-challenge-issued.interface.ts +0 -6
  931. package/src/_modules/account-security/_models/account-challenge-record.interface.ts +0 -13
  932. package/src/_modules/account-security/_models/account-challenge-result.interface.ts +0 -8
  933. package/src/_modules/account-security/_models/account-challenge-settings.interface.ts +0 -9
  934. package/src/_modules/account-security/_models/account-password-policy.interface.ts +0 -11
  935. package/src/_modules/account-security/_models/account-password-verification.interface.ts +0 -5
  936. package/src/_modules/account-security/_models/account-refresh-token-record.interface.ts +0 -13
  937. package/src/_modules/account-security/_models/account-session-adapter.interface.ts +0 -19
  938. package/src/_modules/account-security/_models/account-session-claims.interface.ts +0 -7
  939. package/src/_modules/account-security/_models/account-session-context.interface.ts +0 -6
  940. package/src/_modules/account-security/_models/account-session-create.interface.ts +0 -8
  941. package/src/_modules/account-security/_models/account-session-record.interface.ts +0 -21
  942. package/src/_modules/account-security/_models/account-session-rotate.interface.ts +0 -11
  943. package/src/_modules/account-security/_models/account-session-settings.interface.ts +0 -11
  944. package/src/_modules/account-security/_models/account-session-token-pair.interface.ts +0 -8
  945. package/src/_modules/account-security/_models/account-session-view.interface.ts +0 -13
  946. package/src/_modules/account-security/account-challenge.control-service.spec.ts +0 -195
  947. package/src/_modules/account-security/account-challenge.control-service.ts +0 -164
  948. package/src/_modules/account-security/account-password.control-service.spec.ts +0 -96
  949. package/src/_modules/account-security/account-password.control-service.ts +0 -288
  950. package/src/_modules/account-security/account-session.control-service.spec.ts +0 -294
  951. package/src/_modules/account-security/account-session.control-service.ts +0 -376
  952. package/src/_modules/account-security/index.ts +0 -31
  953. package/src/_modules/admin-auth/_models/admin-api-key-config.interface.ts +0 -33
  954. package/src/_modules/admin-auth/admin-api-key.auth-service.spec.ts +0 -200
  955. package/src/_modules/admin-auth/admin-api-key.auth-service.ts +0 -220
  956. package/src/_modules/admin-auth/index.ts +0 -2
  957. package/src/_modules/ai/_collections/ai-model-config-validator.util.spec.ts +0 -150
  958. package/src/_modules/ai/_collections/ai-model-config-validator.util.ts +0 -131
  959. package/src/_modules/ai/_collections/ai-provider-error.util.ts +0 -144
  960. package/src/_modules/ai/_models/ai-input-interfaces.ts +0 -117
  961. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +0 -16
  962. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts +0 -14
  963. package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts +0 -56
  964. package/src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts +0 -16
  965. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.spec.ts +0 -72
  966. package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts +0 -71
  967. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.spec.ts +0 -57
  968. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts +0 -60
  969. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.spec.ts +0 -56
  970. package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts +0 -117
  971. package/src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts +0 -28
  972. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.ts +0 -14
  973. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.ts +0 -11
  974. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.ts +0 -30
  975. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-request.interface.ts +0 -19
  976. package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-service-collection.interface.ts +0 -20
  977. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.spec.ts +0 -115
  978. package/src/_modules/ai/_modules/ai-mock/_services/ai-embedding-mock.service.ts +0 -233
  979. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.spec.ts +0 -134
  980. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-harness.service.ts +0 -127
  981. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-pipeline.spec.ts +0 -105
  982. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.spec.ts +0 -50
  983. package/src/_modules/ai/_modules/ai-mock/_services/aim-fixture-store.service.ts +0 -65
  984. package/src/_modules/ai/_modules/ai-mock/_services/aim-integration-proof.spec.ts +0 -92
  985. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.spec.ts +0 -112
  986. package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts +0 -155
  987. package/src/_modules/ai/_modules/ai-mock/fixtures/aim-text.fixtures.ts +0 -649
  988. package/src/_modules/ai/_modules/ai-mock/index.ts +0 -47
  989. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +0 -138
  990. package/src/_modules/ai/_modules/anthropic/index.ts +0 -5
  991. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +0 -242
  992. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +0 -639
  993. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +0 -295
  994. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +0 -552
  995. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +0 -209
  996. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +0 -85
  997. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +0 -8
  998. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +0 -146
  999. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +0 -163
  1000. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +0 -100
  1001. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +0 -68
  1002. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +0 -18
  1003. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +0 -19
  1004. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +0 -25
  1005. package/src/_modules/ai/_modules/document-ai/index.ts +0 -30
  1006. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +0 -189
  1007. package/src/_modules/ai/_modules/fdp-ai/index.ts +0 -5
  1008. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +0 -9
  1009. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +0 -83
  1010. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +0 -76
  1011. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +0 -45
  1012. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +0 -8
  1013. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +0 -7
  1014. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +0 -57
  1015. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +0 -293
  1016. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-page.data-service.ts +0 -572
  1017. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +0 -342
  1018. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.ts +0 -435
  1019. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +0 -550
  1020. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +0 -631
  1021. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +0 -332
  1022. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.ts +0 -132
  1023. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +0 -462
  1024. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +0 -635
  1025. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +0 -489
  1026. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +0 -173
  1027. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +0 -1085
  1028. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +0 -157
  1029. package/src/_modules/ai/_modules/open-ai/index.ts +0 -74
  1030. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +0 -110
  1031. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +0 -114
  1032. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +0 -98
  1033. package/src/_modules/ai/_services/ai-embedding.service-base.ts +0 -48
  1034. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +0 -229
  1035. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +0 -68
  1036. package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts +0 -133
  1037. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +0 -250
  1038. package/src/_modules/ai/_services/ai-llm.service-base.ts +0 -599
  1039. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +0 -158
  1040. package/src/_modules/ai/_services/ai-provider.service-base.ts +0 -67
  1041. package/src/_modules/ai/_services/ai-user-key.service-base.ts +0 -59
  1042. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +0 -197
  1043. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +0 -399
  1044. package/src/_modules/ai/index.ts +0 -33
  1045. package/src/_modules/artifact-compiler/_enums/artifact-compile-outcome.type-enum.ts +0 -5
  1046. package/src/_modules/artifact-compiler/_enums/artifact-compile-stage.type-enum.ts +0 -8
  1047. package/src/_modules/artifact-compiler/_enums/artifact-retry-class.type-enum.ts +0 -6
  1048. package/src/_modules/artifact-compiler/_models/artifact-compile.interface.ts +0 -35
  1049. package/src/_modules/artifact-compiler/artifact-compiler.control-service.spec.ts +0 -151
  1050. package/src/_modules/artifact-compiler/artifact-compiler.control-service.ts +0 -356
  1051. package/src/_modules/artifact-compiler/index.ts +0 -9
  1052. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +0 -13
  1053. package/src/_modules/assistant/_collections/ass.util.spec.ts +0 -176
  1054. package/src/_modules/assistant/_collections/ass.util.ts +0 -50
  1055. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +0 -15
  1056. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +0 -140
  1057. package/src/_modules/assistant/_services/ass-io.control-service.ts +0 -74
  1058. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +0 -192
  1059. package/src/_modules/assistant/_services/ass-main.control-service.ts +0 -107
  1060. package/src/_modules/assistant/index.ts +0 -19
  1061. package/src/_modules/bot/_collections/bot-default-commands.const.ts +0 -12
  1062. package/src/_modules/bot/_collections/bot-global-settings.const.ts +0 -39
  1063. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +0 -62
  1064. package/src/_modules/bot/_models/bot-command.interface.ts +0 -8
  1065. package/src/_modules/bot/_models/bot-global-settings.interface.ts +0 -96
  1066. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +0 -6
  1067. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +0 -5
  1068. package/src/_modules/bot/_models/bot-message-wrapper.interface.ts +0 -90
  1069. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +0 -41
  1070. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +0 -10
  1071. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +0 -431
  1072. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.ts +0 -641
  1073. package/src/_modules/bot/_modules/discord-bot/index.ts +0 -12
  1074. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +0 -160
  1075. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +0 -55
  1076. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +0 -15
  1077. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +0 -374
  1078. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +0 -447
  1079. package/src/_modules/bot/_modules/dynamo-bot/index.ts +0 -15
  1080. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +0 -9
  1081. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +0 -344
  1082. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +0 -197
  1083. package/src/_modules/bot/_modules/slack-bot/index.ts +0 -12
  1084. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +0 -9
  1085. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +0 -345
  1086. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +0 -197
  1087. package/src/_modules/bot/_modules/teams-bot/index.ts +0 -11
  1088. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +0 -116
  1089. package/src/_modules/bot/_services/bot-commands.control-service.ts +0 -158
  1090. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +0 -285
  1091. package/src/_modules/bot/_services/bot-io.control-service.ts +0 -329
  1092. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +0 -208
  1093. package/src/_modules/bot/_services/bot-main.control-service.ts +0 -489
  1094. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +0 -349
  1095. package/src/_modules/bot/_services/bot-messaging-provider.service-base.ts +0 -158
  1096. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +0 -111
  1097. package/src/_modules/bot/_services/bot-routines.control-service.ts +0 -78
  1098. package/src/_modules/bot/index.ts +0 -37
  1099. package/src/_modules/custom-data/custom-data.controller.spec.ts +0 -49
  1100. package/src/_modules/custom-data/custom-data.controller.ts +0 -67
  1101. package/src/_modules/custom-data/custom-data.data-service.spec.ts +0 -54
  1102. package/src/_modules/custom-data/custom-data.data-service.ts +0 -22
  1103. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +0 -28
  1104. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +0 -24
  1105. package/src/_modules/custom-data/index.ts +0 -9
  1106. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +0 -176
  1107. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +0 -203
  1108. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +0 -33
  1109. package/src/_modules/data-readers/index.ts +0 -11
  1110. package/src/_modules/defaults/_collections/default-endpoints.util.ts +0 -487
  1111. package/src/_modules/defaults/_models/default-user.data-model.ts +0 -72
  1112. package/src/_modules/defaults/_services/default-auth.service.spec.ts +0 -269
  1113. package/src/_modules/defaults/_services/default-auth.service.ts +0 -177
  1114. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +0 -42
  1115. package/src/_modules/defaults/_services/default-socket-events.service.ts +0 -61
  1116. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +0 -187
  1117. package/src/_modules/defaults/_services/default-user.data-service.ts +0 -98
  1118. package/src/_modules/defaults/index.ts +0 -17
  1119. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +0 -19
  1120. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +0 -366
  1121. package/src/_modules/discord-assistant/_collections/dias.util.ts +0 -133
  1122. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +0 -20
  1123. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +0 -53
  1124. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +0 -177
  1125. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +0 -108
  1126. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +0 -69
  1127. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +0 -22
  1128. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +0 -27
  1129. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +0 -195
  1130. package/src/_modules/discord-assistant/_services/dias.service-base.ts +0 -77
  1131. package/src/_modules/discord-assistant/index.ts +0 -38
  1132. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +0 -34
  1133. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +0 -11
  1134. package/src/_modules/discord-assistant-voiced/index.ts +0 -36
  1135. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +0 -17
  1136. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +0 -56
  1137. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +0 -214
  1138. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +0 -387
  1139. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +0 -12
  1140. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +0 -98
  1141. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +0 -8
  1142. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +0 -6
  1143. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +0 -154
  1144. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +0 -153
  1145. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +0 -264
  1146. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +0 -306
  1147. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +0 -408
  1148. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +0 -488
  1149. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +0 -105
  1150. package/src/_modules/discord-bot/_services/dibo-routines.control-service.ts +0 -97
  1151. package/src/_modules/discord-bot/index.ts +0 -36
  1152. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +0 -35
  1153. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +0 -60
  1154. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +0 -17
  1155. package/src/_modules/local-vector-search/_services/lvs-bm25.util.spec.ts +0 -159
  1156. package/src/_modules/local-vector-search/_services/lvs-bm25.util.ts +0 -206
  1157. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +0 -418
  1158. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +0 -276
  1159. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +0 -480
  1160. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +0 -416
  1161. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +0 -214
  1162. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +0 -186
  1163. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +0 -167
  1164. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +0 -130
  1165. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +0 -509
  1166. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +0 -323
  1167. package/src/_modules/local-vector-search/index.ts +0 -17
  1168. package/src/_modules/logs/_models/file-log-entry.interface.ts +0 -13
  1169. package/src/_modules/logs/_models/file-log-read-result.interface.ts +0 -37
  1170. package/src/_modules/logs/file-log.service.spec.ts +0 -341
  1171. package/src/_modules/logs/file-log.service.ts +0 -466
  1172. package/src/_modules/logs/file-logs.controller.spec.ts +0 -245
  1173. package/src/_modules/logs/file-logs.controller.ts +0 -165
  1174. package/src/_modules/logs/get-file-logs-routing-module.util.ts +0 -51
  1175. package/src/_modules/logs/get-logs-routing-module.util.ts +0 -36
  1176. package/src/_modules/logs/index.ts +0 -11
  1177. package/src/_modules/logs/log-buffer.service.ts +0 -101
  1178. package/src/_modules/logs/logs.controller.ts +0 -109
  1179. package/src/_modules/logs/logs.service.ts +0 -100
  1180. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +0 -111
  1181. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +0 -151
  1182. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +0 -125
  1183. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +0 -168
  1184. package/src/_modules/mcp/index.ts +0 -13
  1185. package/src/_modules/messaging/README.md +0 -354
  1186. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +0 -26
  1187. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +0 -22
  1188. package/src/_modules/messaging/_collections/msg.util.spec.ts +0 -226
  1189. package/src/_modules/messaging/_collections/msg.util.ts +0 -83
  1190. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +0 -37
  1191. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +0 -146
  1192. package/src/_modules/messaging/_services/msg-events.service.spec.ts +0 -219
  1193. package/src/_modules/messaging/_services/msg-events.service.ts +0 -267
  1194. package/src/_modules/messaging/_services/msg-integration.control-service.ts +0 -180
  1195. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +0 -147
  1196. package/src/_modules/messaging/_services/msg-main.control-service.ts +0 -572
  1197. package/src/_modules/messaging/_services/msg-message.data-service.ts +0 -129
  1198. package/src/_modules/messaging/_services/msg.controller.spec.ts +0 -201
  1199. package/src/_modules/messaging/_services/msg.controller.ts +0 -370
  1200. package/src/_modules/messaging/index.ts +0 -30
  1201. package/src/_modules/mock/app-extended-server.mock.ts +0 -201
  1202. package/src/_modules/mock/app-integration-test.mock.ts +0 -51
  1203. package/src/_modules/mock/app-params.mock.spec.ts +0 -21
  1204. package/src/_modules/mock/app-params.mock.ts +0 -9
  1205. package/src/_modules/mock/app-server.mock.ts +0 -188
  1206. package/src/_modules/mock/auth-service.mock.spec.ts +0 -47
  1207. package/src/_modules/mock/auth-service.mock.ts +0 -28
  1208. package/src/_modules/mock/controller.mock.spec.ts +0 -26
  1209. package/src/_modules/mock/controller.mock.ts +0 -16
  1210. package/src/_modules/mock/data-model.mock.spec.ts +0 -111
  1211. package/src/_modules/mock/data-model.mock.ts +0 -82
  1212. package/src/_modules/mock/email-service-collection.mock.spec.ts +0 -24
  1213. package/src/_modules/mock/email-service-collection.mock.ts +0 -15
  1214. package/src/_modules/mock/email-service.mock.spec.ts +0 -17
  1215. package/src/_modules/mock/email-service.mock.ts +0 -20
  1216. package/src/_modules/mock/email-template.mock.html +0 -15
  1217. package/src/_modules/mock/endpoint.mock.ts +0 -91
  1218. package/src/_modules/mock/socket-client.mock.spec.ts +0 -40
  1219. package/src/_modules/mock/socket-client.mock.ts +0 -45
  1220. package/src/_modules/mock/socket-server.mock.spec.ts +0 -44
  1221. package/src/_modules/mock/socket-server.mock.ts +0 -46
  1222. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +0 -107
  1223. package/src/_modules/oauth2/_routes/oauth2.controller.ts +0 -99
  1224. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +0 -254
  1225. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +0 -232
  1226. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +0 -585
  1227. package/src/_modules/oauth2/_services/oauth2.control-service.ts +0 -654
  1228. package/src/_modules/oauth2/index.ts +0 -17
  1229. package/src/_modules/privacy-lifecycle/_enums/privacy-consent-decision.type-enum.ts +0 -5
  1230. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-action.type-enum.ts +0 -10
  1231. package/src/_modules/privacy-lifecycle/_enums/privacy-contributor-outcome.type-enum.ts +0 -7
  1232. package/src/_modules/privacy-lifecycle/_enums/privacy-request-state.type-enum.ts +0 -15
  1233. package/src/_modules/privacy-lifecycle/_enums/privacy-request.type-enum.ts +0 -9
  1234. package/src/_modules/privacy-lifecycle/_models/privacy-consent-input.interface.ts +0 -12
  1235. package/src/_modules/privacy-lifecycle/_models/privacy-consent-persistence-result.interface.ts +0 -7
  1236. package/src/_modules/privacy-lifecycle/_models/privacy-consent-record.interface.ts +0 -15
  1237. package/src/_modules/privacy-lifecycle/_models/privacy-consent-result.interface.ts +0 -7
  1238. package/src/_modules/privacy-lifecycle/_models/privacy-consent-view.interface.ts +0 -13
  1239. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-context.interface.ts +0 -9
  1240. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-outcome.interface.ts +0 -14
  1241. package/src/_modules/privacy-lifecycle/_models/privacy-contributor-plan.interface.ts +0 -8
  1242. package/src/_modules/privacy-lifecycle/_models/privacy-contributor.interface.ts +0 -17
  1243. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-adapter.interface.ts +0 -21
  1244. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-result.interface.ts +0 -9
  1245. package/src/_modules/privacy-lifecycle/_models/privacy-ledger-settings.interface.ts +0 -7
  1246. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-input.interface.ts +0 -10
  1247. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-persistence-result.interface.ts +0 -7
  1248. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-result.interface.ts +0 -7
  1249. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance-view.interface.ts +0 -11
  1250. package/src/_modules/privacy-lifecycle/_models/privacy-legal-acceptance.interface.ts +0 -13
  1251. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-adapter.interface.ts +0 -19
  1252. package/src/_modules/privacy-lifecycle/_models/privacy-lifecycle-settings.interface.ts +0 -9
  1253. package/src/_modules/privacy-lifecycle/_models/privacy-request-create-result.interface.ts +0 -7
  1254. package/src/_modules/privacy-lifecycle/_models/privacy-request-open.interface.ts +0 -10
  1255. package/src/_modules/privacy-lifecycle/_models/privacy-request-persistence-create-result.interface.ts +0 -7
  1256. package/src/_modules/privacy-lifecycle/_models/privacy-request-record.interface.ts +0 -21
  1257. package/src/_modules/privacy-lifecycle/_models/privacy-request-result.interface.ts +0 -8
  1258. package/src/_modules/privacy-lifecycle/_models/privacy-request-view.interface.ts +0 -20
  1259. package/src/_modules/privacy-lifecycle/index.ts +0 -40
  1260. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.spec.ts +0 -206
  1261. package/src/_modules/privacy-lifecycle/privacy-ledger.control-service.ts +0 -253
  1262. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.spec.ts +0 -353
  1263. package/src/_modules/privacy-lifecycle/privacy-lifecycle.control-service.ts +0 -586
  1264. package/src/_modules/rate-limit/_enums/rate-limit-store-kind.type-enum.ts +0 -5
  1265. package/src/_modules/rate-limit/_models/rate-limit-config.interface.ts +0 -82
  1266. package/src/_modules/rate-limit/_models/rate-limit-consume-request.interface.ts +0 -9
  1267. package/src/_modules/rate-limit/_models/rate-limit-consume-result.interface.ts +0 -6
  1268. package/src/_modules/rate-limit/_models/rate-limit-policy.interface.ts +0 -16
  1269. package/src/_modules/rate-limit/_models/rate-limit-store.interface.ts +0 -9
  1270. package/src/_modules/rate-limit/index.ts +0 -8
  1271. package/src/_modules/rate-limit/rate-limit-in-memory.store.ts +0 -91
  1272. package/src/_modules/rate-limit/rate-limit.middleware.spec.ts +0 -488
  1273. package/src/_modules/rate-limit/rate-limit.middleware.ts +0 -504
  1274. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +0 -35
  1275. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +0 -33
  1276. package/src/_modules/scheduler/index.ts +0 -8
  1277. package/src/_modules/scheduler/scheduler.controller.spec.ts +0 -42
  1278. package/src/_modules/scheduler/scheduler.controller.ts +0 -69
  1279. package/src/_modules/scheduler/scheduler.service.spec.ts +0 -141
  1280. package/src/_modules/scheduler/scheduler.service.ts +0 -176
  1281. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +0 -22
  1282. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +0 -82
  1283. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +0 -107
  1284. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +0 -312
  1285. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +0 -311
  1286. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +0 -123
  1287. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +0 -108
  1288. package/src/_modules/scoped-config/index.ts +0 -17
  1289. package/src/_modules/server/errors/errors.control-service.spec.ts +0 -246
  1290. package/src/_modules/server/errors/errors.control-service.ts +0 -100
  1291. package/src/_modules/server/errors/errors.controller.spec.ts +0 -340
  1292. package/src/_modules/server/errors/errors.controller.ts +0 -559
  1293. package/src/_modules/server/errors/errors.data-service.spec.ts +0 -480
  1294. package/src/_modules/server/errors/errors.data-service.ts +0 -867
  1295. package/src/_modules/server/index.ts +0 -40
  1296. package/src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts +0 -8
  1297. package/src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts +0 -20
  1298. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.spec.ts +0 -124
  1299. package/src/_modules/server/safe-diagnostic/safe-diagnostic.control-service.ts +0 -99
  1300. package/src/_modules/server/safe-diagnostic/safe-diagnostic.interface.ts +0 -20
  1301. package/src/_modules/server/server-status/db-readiness-probe-code.type-enum.ts +0 -13
  1302. package/src/_modules/server/server-status/db-readiness-probe-stage.type-enum.ts +0 -7
  1303. package/src/_modules/server/server-status/db-readiness-probe.control-service.spec.ts +0 -235
  1304. package/src/_modules/server/server-status/db-readiness-probe.control-service.ts +0 -158
  1305. package/src/_modules/server/server-status/db-readiness-probe.interface.ts +0 -20
  1306. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +0 -70
  1307. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +0 -17
  1308. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +0 -77
  1309. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +0 -37
  1310. package/src/_modules/server/server-status/server-status.control-service.spec.ts +0 -672
  1311. package/src/_modules/server/server-status/server-status.control-service.ts +0 -491
  1312. package/src/_modules/server/server-status/server-status.controller.spec.ts +0 -276
  1313. package/src/_modules/server/server-status/server-status.controller.ts +0 -336
  1314. package/src/_modules/socket/_enums/socket-security.enum.ts +0 -11
  1315. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +0 -32
  1316. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +0 -22
  1317. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +0 -165
  1318. package/src/_modules/socket/_models/socket-presence.control-model.ts +0 -211
  1319. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +0 -69
  1320. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +0 -33
  1321. package/src/_modules/socket/_services/socket-client.service.spec.ts +0 -15
  1322. package/src/_modules/socket/_services/socket-client.service.ts +0 -260
  1323. package/src/_modules/socket/_services/socket-server.service.spec.ts +0 -272
  1324. package/src/_modules/socket/_services/socket-server.service.ts +0 -1037
  1325. package/src/_modules/socket/app-extended.integration.spec.ts +0 -85
  1326. package/src/_modules/socket/app-extended.server.ts +0 -648
  1327. package/src/_modules/socket/index.ts +0 -42
  1328. package/src/_modules/test/get-test-routing-module.util.spec.ts +0 -28
  1329. package/src/_modules/test/get-test-routing-module.util.ts +0 -23
  1330. package/src/_modules/test/index.ts +0 -12
  1331. package/src/_modules/test/test.controller.spec.ts +0 -72
  1332. package/src/_modules/test/test.controller.ts +0 -115
  1333. package/src/_modules/test-email-sink/_collections/test-email-pattern.const.ts +0 -10
  1334. package/src/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.ts +0 -41
  1335. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.spec.ts +0 -112
  1336. package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.ts +0 -141
  1337. package/src/_modules/test-email-sink/get-sent-mail-routing-module.util.ts +0 -29
  1338. package/src/_modules/test-email-sink/index.ts +0 -11
  1339. package/src/_modules/test-email-sink/test-email-sink.controller.ts +0 -83
  1340. package/src/_modules/usage/get-usage-routing-module.util.ts +0 -23
  1341. package/src/_modules/usage/index.ts +0 -15
  1342. package/src/_modules/usage/usage.controller.spec.ts +0 -106
  1343. package/src/_modules/usage/usage.controller.ts +0 -140
  1344. package/src/_modules/usage/usage.data-service.spec.ts +0 -332
  1345. package/src/_modules/usage/usage.data-service.ts +0 -185
  1346. package/src/_services/base/api.service-base.spec.ts +0 -125
  1347. package/src/_services/base/api.service-base.ts +0 -75
  1348. package/src/_services/base/archive-data.service.spec.ts +0 -209
  1349. package/src/_services/base/archive-data.service.ts +0 -228
  1350. package/src/_services/base/data.service.spec.ts +0 -784
  1351. package/src/_services/base/data.service.ts +0 -2792
  1352. package/src/_services/base/db.service.encryption.spec.ts +0 -76
  1353. package/src/_services/base/db.service.spec.ts +0 -160
  1354. package/src/_services/base/db.service.ts +0 -1698
  1355. package/src/_services/base/singleton.service-base.spec.ts +0 -28
  1356. package/src/_services/base/singleton.service-base.ts +0 -24
  1357. package/src/_services/base/singleton.service.spec.ts +0 -114
  1358. package/src/_services/base/singleton.service.ts +0 -38
  1359. package/src/_services/core/api.service.spec.ts +0 -187
  1360. package/src/_services/core/api.service.ts +0 -627
  1361. package/src/_services/core/auth.service.spec.ts +0 -159
  1362. package/src/_services/core/auth.service.ts +0 -174
  1363. package/src/_services/core/collection-growth-monitor.service.spec.ts +0 -119
  1364. package/src/_services/core/collection-growth-monitor.service.ts +0 -234
  1365. package/src/_services/core/db-stats.service.ts +0 -104
  1366. package/src/_services/core/diagnostics.service.spec.ts +0 -44
  1367. package/src/_services/core/diagnostics.service.ts +0 -158
  1368. package/src/_services/core/email.service.spec.ts +0 -85
  1369. package/src/_services/core/email.service.ts +0 -757
  1370. package/src/_services/core/event-loop-diag.service.spec.ts +0 -22
  1371. package/src/_services/core/event-loop-diag.service.ts +0 -144
  1372. package/src/_services/core/global.service.spec.ts +0 -292
  1373. package/src/_services/core/global.service.ts +0 -488
  1374. package/src/_services/core/memory-guard.service.spec.ts +0 -245
  1375. package/src/_services/core/memory-guard.service.ts +0 -481
  1376. package/src/_services/core/migration-runner.service.spec.ts +0 -91
  1377. package/src/_services/core/migration-runner.service.ts +0 -106
  1378. package/src/_services/core/mongo-transaction.control-service.spec.ts +0 -165
  1379. package/src/_services/core/mongo-transaction.control-service.ts +0 -148
  1380. package/src/_services/core/request-hunter.service.spec.ts +0 -124
  1381. package/src/_services/core/request-hunter.service.ts +0 -157
  1382. package/src/_services/core/service-collection.service.spec.ts +0 -46
  1383. package/src/_services/core/service-collection.service.ts +0 -6
  1384. package/src/_services/route/controller.service.spec.ts +0 -53
  1385. package/src/_services/route/controller.service.ts +0 -148
  1386. package/src/_services/route/routing-module.service.spec.ts +0 -98
  1387. package/src/_services/route/routing-module.service.ts +0 -330
  1388. package/src/_services/server/app-safe-diagnostic.spec.ts +0 -124
  1389. package/src/_services/server/app.server-retention.spec.ts +0 -106
  1390. package/src/_services/server/app.server.ts +0 -1959
  1391. package/src/_services/shared.static-service.spec.ts +0 -133
  1392. package/src/_services/shared.static-service.ts +0 -107
  1393. package/src/index.ts +0 -117
  1394. package/tsconfig.app.json +0 -12
  1395. 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
- }