@futdevpro/fsm-dynamo 1.16.31 → 1.16.34

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 (560) hide show
  1. package/.cursor/rules/__assistant_guide.mdc +30 -30
  2. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  3. package/.cursor/rules/_ag_backend.mdc +16 -16
  4. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  5. package/.cursor/rules/_ag_frontend.mdc +39 -39
  6. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  7. package/.cursor/rules/_ag_naming.mdc +115 -115
  8. package/.cursor/rules/_ag_should-be.mdc +6 -6
  9. package/.cursor/rules/ai_development_guide.md +60 -60
  10. package/.cursor/rules/cursor-rules.md +160 -160
  11. package/.cursor/rules/default-command.mdc +464 -464
  12. package/.cursor/rules/error_code_pattern.md +39 -39
  13. package/.cursor/rules/saved rule mcp server use.md +15 -15
  14. package/.vscode/settings.json +11 -11
  15. package/LICENSE +21 -21
  16. package/__documentations/2026-06-22-dyfm-error-extends-error.md +109 -109
  17. package/build/_models/data-models/errors.data-model.d.ts +22 -0
  18. package/build/_models/data-models/errors.data-model.d.ts.map +1 -1
  19. package/build/_models/data-models/errors.data-model.js +24 -0
  20. package/build/_models/data-models/errors.data-model.js.map +1 -1
  21. package/build/_modules/game/_collections/audio-scale.util.d.ts +57 -0
  22. package/build/_modules/game/_collections/audio-scale.util.d.ts.map +1 -0
  23. package/build/_modules/game/_collections/audio-scale.util.js +105 -0
  24. package/build/_modules/game/_collections/audio-scale.util.js.map +1 -0
  25. package/build/_modules/game/_enums/audio-channel.enum.d.ts +8 -4
  26. package/build/_modules/game/_enums/audio-channel.enum.d.ts.map +1 -1
  27. package/build/_modules/game/_enums/audio-channel.enum.js +8 -4
  28. package/build/_modules/game/_enums/audio-channel.enum.js.map +1 -1
  29. package/build/_modules/game/_models/audio-mixer-config.interface.d.ts +37 -0
  30. package/build/_modules/game/_models/audio-mixer-config.interface.d.ts.map +1 -0
  31. package/build/_modules/game/_models/audio-mixer-config.interface.js +3 -0
  32. package/build/_modules/game/_models/audio-mixer-config.interface.js.map +1 -0
  33. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts +19 -0
  34. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts.map +1 -0
  35. package/build/_modules/game/_models/audio-mixer-state.interface.js +3 -0
  36. package/build/_modules/game/_models/audio-mixer-state.interface.js.map +1 -0
  37. package/build/_modules/game/_models/audio-mixer.control-model.d.ts +123 -0
  38. package/build/_modules/game/_models/audio-mixer.control-model.d.ts.map +1 -0
  39. package/build/_modules/game/_models/audio-mixer.control-model.js +312 -0
  40. package/build/_modules/game/_models/audio-mixer.control-model.js.map +1 -0
  41. package/build/_modules/game/_models/audio-scale.interface.d.ts +18 -0
  42. package/build/_modules/game/_models/audio-scale.interface.d.ts.map +1 -0
  43. package/build/_modules/game/_models/audio-scale.interface.js +3 -0
  44. package/build/_modules/game/_models/audio-scale.interface.js.map +1 -0
  45. package/build/_modules/game/index.d.ts +5 -0
  46. package/build/_modules/game/index.d.ts.map +1 -1
  47. package/build/_modules/game/index.js +5 -0
  48. package/build/_modules/game/index.js.map +1 -1
  49. package/build/_modules/socket/_models/sck-socket-event.control-model.js +1 -1
  50. package/eslint.config.js +4 -4
  51. package/nodemon.json +22 -22
  52. package/package.json +1 -1
  53. package/scripts/crypto/CRYPTO-STABILITY-SOLUTION.md +196 -196
  54. package/scripts/crypto/README.md +113 -113
  55. package/scripts/crypto/demo-crypto-stability.js +120 -120
  56. package/scripts/crypto/stress-test-crypto.js +379 -379
  57. package/scripts/run-coverage-tests.js +24 -24
  58. package/spec/support/helpers/ts-node-helper.js +9 -9
  59. package/spec/support/jasmine.coverage.json +23 -23
  60. package/spec/support/jasmine.json +24 -24
  61. package/src/_collections/constants/data-sizes.const.ts +40 -40
  62. package/src/_collections/constants/error-defaults.const.ts +20 -20
  63. package/src/_collections/constants/global-settings.const.ts +24 -24
  64. package/src/_collections/constants/numbers.const.ts +40 -40
  65. package/src/_collections/constants/times.const.ts +45 -45
  66. package/src/_collections/utils/array.util.spec.ts +306 -306
  67. package/src/_collections/utils/array.util.ts +813 -813
  68. package/src/_collections/utils/async.util.spec.ts +354 -354
  69. package/src/_collections/utils/async.util.ts +197 -197
  70. package/src/_collections/utils/data.util.spec.ts +345 -345
  71. package/src/_collections/utils/data.util.ts +226 -226
  72. package/src/_collections/utils/json-error-helper.util.spec.ts +521 -521
  73. package/src/_collections/utils/json-error-helper.util.ts +301 -301
  74. package/src/_collections/utils/log.util.spec.ts +975 -975
  75. package/src/_collections/utils/log.util.ts +667 -667
  76. package/src/_collections/utils/math/box-bounds.spec.ts +73 -73
  77. package/src/_collections/utils/math/box-bounds.util.ts +183 -183
  78. package/src/_collections/utils/math/math.util.spec.ts +94 -94
  79. package/src/_collections/utils/math/math.util.ts +141 -141
  80. package/src/_collections/utils/math/random.util.spec.ts +82 -82
  81. package/src/_collections/utils/math/random.util.ts +139 -139
  82. package/src/_collections/utils/math/trigonometry.util.spec.ts +57 -57
  83. package/src/_collections/utils/math/trigonometry.util.ts +102 -102
  84. package/src/_collections/utils/math/vector2.util.spec.ts +94 -94
  85. package/src/_collections/utils/math/vector2.util.ts +653 -653
  86. package/src/_collections/utils/object.util.spec.ts +646 -646
  87. package/src/_collections/utils/regex/password-regex.util.spec.ts +51 -51
  88. package/src/_collections/utils/regex/password-regex.util.ts +65 -65
  89. package/src/_collections/utils/regex/regex.util.spec.ts +42 -42
  90. package/src/_collections/utils/regex/regex.util.ts +6 -6
  91. package/src/_collections/utils/regex/username-regex.util.spec.ts +61 -61
  92. package/src/_collections/utils/regex/username-regex.util.ts +35 -35
  93. package/src/_collections/utils/round-list.util.spec.ts +79 -79
  94. package/src/_collections/utils/round-list.util.ts +162 -162
  95. package/src/_collections/utils/stack.util.spec.ts +372 -372
  96. package/src/_collections/utils/stack.util.ts +164 -164
  97. package/src/_collections/utils/string-case.util.spec.ts +441 -441
  98. package/src/_collections/utils/string-case.util.ts +362 -362
  99. package/src/_collections/utils/string.util.spec.ts +975 -975
  100. package/src/_collections/utils/string.util.ts +449 -449
  101. package/src/_collections/utils/time.util.spec.ts +50 -50
  102. package/src/_collections/utils/time.util.ts +481 -481
  103. package/src/_collections/utils/type-cloning-facility.util.spec.ts +51 -51
  104. package/src/_collections/utils/type-cloning-facility.util.ts +168 -168
  105. package/src/_collections/utils/utilities.util.spec.ts +201 -201
  106. package/src/_collections/utils/utilities.util.ts +68 -68
  107. package/src/_collections/utils/uuid.util.spec.ts +30 -30
  108. package/src/_collections/utils/uuid.util.ts +50 -50
  109. package/src/_enums/basic-property-type.enum.ts +20 -20
  110. package/src/_enums/data-model-type.enum.ts +29 -29
  111. package/src/_enums/environment-flag.enum.ts +28 -28
  112. package/src/_enums/error-level.enum.ts +43 -43
  113. package/src/_enums/http/http-call-type.enum.ts +43 -43
  114. package/src/_enums/http/http-event-type.enum.ts +40 -40
  115. package/src/_enums/http/http-response-type.enum.ts +18 -18
  116. package/src/_enums/log-style.enum.ts +44 -44
  117. package/src/_enums/server-connection-status.enum.ts +6 -6
  118. package/src/_enums/time/day-of-week.enum.ts +55 -55
  119. package/src/_enums/time/month.enum.ts +25 -25
  120. package/src/_enums/time/relative-date.enum.ts +24 -24
  121. package/src/_models/control-models/data-model-params.control-model.spec.ts +133 -133
  122. package/src/_models/control-models/data-model-params.control-model.ts +352 -352
  123. package/src/_models/control-models/data-property-params.control-model.spec.ts +93 -93
  124. package/src/_models/control-models/data-property-params.control-model.ts +210 -210
  125. package/src/_models/control-models/error.control-model.spec.ts +912 -912
  126. package/src/_models/control-models/error.control-model.ts +1274 -1274
  127. package/src/_models/control-models/http/http-error-response.control-model.spec.ts +116 -116
  128. package/src/_models/control-models/http/http-error-response.control-model.ts +52 -52
  129. package/src/_models/control-models/http/http-headers.control-model.spec.ts +25 -25
  130. package/src/_models/control-models/http/http-headers.control-model.ts +124 -124
  131. package/src/_models/control-models/http/http-response.model-base.spec.ts +46 -46
  132. package/src/_models/control-models/http/http-response.model-base.ts +57 -57
  133. package/src/_models/control-models/poll.control-model.spec.ts +63 -63
  134. package/src/_models/control-models/poll.control-model.ts +151 -151
  135. package/src/_models/control-models/range-value.control-model.spec.ts +187 -187
  136. package/src/_models/control-models/range-value.control-model.ts +289 -289
  137. package/src/_models/control-models/server-status.control-model.spec.ts +66 -66
  138. package/src/_models/control-models/server-status.control-model.ts +94 -94
  139. package/src/_models/control-models/service-endpoint-settings-base.control-model.spec.ts +145 -145
  140. package/src/_models/control-models/service-endpoint-settings-base.control-model.ts +186 -186
  141. package/src/_models/data-models/errors.data-model.spec.ts +71 -71
  142. package/src/_models/data-models/errors.data-model.ts +200 -175
  143. package/src/_models/data-models/metadata.data-model.spec.ts +184 -184
  144. package/src/_models/data-models/metadata.data-model.ts +153 -153
  145. package/src/_models/interfaces/box-bounds.interface.ts +7 -7
  146. package/src/_models/interfaces/environment/global-log-settings.interface.ts +86 -86
  147. package/src/_models/interfaces/environment/global-settings.interface.ts +47 -47
  148. package/src/_models/interfaces/error-defaults.interface.ts +11 -11
  149. package/src/_models/interfaces/paged.interface.ts +12 -12
  150. package/src/_models/interfaces/random-weight.interface.ts +7 -7
  151. package/src/_models/interfaces/route-settings.interface.ts +15 -15
  152. package/src/_models/interfaces/search-query.interface.ts +23 -23
  153. package/src/_models/interfaces/search-result.interface.ts +5 -5
  154. package/src/_models/interfaces/server-error-statistics.interface.ts +24 -24
  155. package/src/_models/interfaces/vector2.interface.ts +20 -20
  156. package/src/_models/types/db-filter.type.ts +110 -110
  157. package/src/_models/types/db-sort.type.ts +4 -4
  158. package/src/_models/types/ds-filter.type.ts +68 -68
  159. package/src/_models/types/ds-sort.type.ts +21 -21
  160. package/src/_modules/ai/_collections/ai-model-ref.util.ts +88 -88
  161. package/src/_modules/ai/_collections/ai-model-registry.util.spec.ts +37 -37
  162. package/src/_modules/ai/_collections/ai-model-registry.util.ts +30 -30
  163. package/src/_modules/ai/_enums/ai-message-role.enum.ts +7 -7
  164. package/src/_modules/ai/_enums/ai-model-type.enum.ts +7 -7
  165. package/src/_modules/ai/_enums/ai-provider.enum.ts +7 -7
  166. package/src/_modules/ai/_models/ai-call-settings.interface.ts +84 -84
  167. package/src/_modules/ai/_models/ai-embedding-request.interface.ts +20 -20
  168. package/src/_modules/ai/_models/ai-embedding-response.interface.ts +26 -26
  169. package/src/_modules/ai/_models/ai-llm-request.interface.ts +24 -24
  170. package/src/_modules/ai/_models/ai-llm-response.interface.ts +30 -30
  171. package/src/_modules/ai/_models/ai-message.interface.ts +12 -12
  172. package/src/_modules/ai/_models/ai-model-capabilities.interface.ts +35 -35
  173. package/src/_modules/ai/_models/ai-model-info.interface.ts +63 -63
  174. package/src/_modules/ai/_models/ai-model-settings-schema.interface.ts +52 -52
  175. package/src/_modules/ai/_models/ai-provider-capabilities.interface.ts +28 -28
  176. package/src/_modules/ai/_models/ai-settings.interface.ts +17 -17
  177. package/src/_modules/ai/_models/ai-tool-call.interface.ts +18 -18
  178. package/src/_modules/ai/_models/ai-tool-handler.type.ts +11 -11
  179. package/src/_modules/ai/_models/ai-tool-result.interface.ts +16 -16
  180. package/src/_modules/ai/_models/ai-tool.interface.ts +16 -16
  181. package/src/_modules/ai/_models/ai-user-provider-config.control-model.ts +29 -29
  182. package/src/_modules/ai/_modules/anthropic/_collections/aai-models.const.ts +135 -135
  183. package/src/_modules/ai/_modules/anthropic/_enums/aai-model.enum.ts +19 -19
  184. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.spec.ts +28 -28
  185. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.ts +23 -23
  186. package/src/_modules/ai/_modules/anthropic/_models/aai-client-options.interface.ts +10 -10
  187. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.spec.ts +22 -22
  188. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.ts +27 -27
  189. package/src/_modules/ai/_modules/anthropic/_models/aai-user-provider-config.control-model.ts +20 -20
  190. package/src/_modules/ai/_modules/anthropic/index.ts +14 -14
  191. package/src/_modules/ai/_modules/document-ai/_models/dai-embedding-info.interface.ts +12 -12
  192. package/src/_modules/ai/_modules/document-ai/_models/dai-vector-search-params.interface.ts +22 -22
  193. package/src/_modules/ai/_modules/document-ai/index.ts +4 -4
  194. package/src/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.ts +40 -40
  195. package/src/_modules/ai/_modules/fdp-ai/_enums/fdpai-model.enum.ts +6 -6
  196. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-call-settings.control-model.ts +19 -19
  197. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-client-options.interface.ts +11 -11
  198. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-settings.control-model.ts +24 -24
  199. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-user-provider-config.control-model.ts +20 -20
  200. package/src/_modules/ai/_modules/fdp-ai/index.ts +11 -11
  201. package/src/_modules/ai/_modules/google-ai/_collections/gai-models.const.ts +161 -161
  202. package/src/_modules/ai/_modules/google-ai/_enums/gai-model.enum.ts +16 -16
  203. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.spec.ts +28 -28
  204. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.ts +21 -21
  205. package/src/_modules/ai/_modules/google-ai/_models/gai-client-options.interface.ts +8 -8
  206. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.spec.ts +22 -22
  207. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.ts +25 -25
  208. package/src/_modules/ai/_modules/google-ai/_models/gai-user-provider-config.control-model.ts +20 -20
  209. package/src/_modules/ai/_modules/google-ai/index.ts +14 -14
  210. package/src/_modules/ai/_modules/local-ai/_collections/lai-models.const.ts +59 -59
  211. package/src/_modules/ai/_modules/local-ai/_enums/lai-model.enum.ts +6 -6
  212. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.spec.ts +28 -28
  213. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.ts +18 -18
  214. package/src/_modules/ai/_modules/local-ai/_models/lai-client-options.interface.ts +9 -9
  215. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.spec.ts +22 -22
  216. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.ts +23 -23
  217. package/src/_modules/ai/_modules/local-ai/index.ts +14 -14
  218. package/src/_modules/ai/_modules/open-ai/_collections/oai-embedding-model-dimensions.const.ts +7 -7
  219. package/src/_modules/ai/_modules/open-ai/_collections/oai-models.const.ts +404 -404
  220. package/src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts +179 -179
  221. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.spec.ts +28 -28
  222. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.ts +21 -21
  223. package/src/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts +81 -81
  224. package/src/_modules/ai/_modules/open-ai/_models/oai-embedding-info.interface.ts +13 -13
  225. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.spec.ts +22 -22
  226. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.ts +25 -25
  227. package/src/_modules/ai/_modules/open-ai/_models/oai-user-provider-config.control-model.ts +21 -21
  228. package/src/_modules/ai/_modules/open-ai/index.ts +28 -28
  229. package/src/_modules/ai/index.ts +27 -27
  230. package/src/_modules/ci-tools/_enums/cit-ci-result-code.enum.ts +11 -11
  231. package/src/_modules/ci-tools/_enums/cit-ci-step-result-code.enum.ts +9 -9
  232. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.spec.ts +58 -58
  233. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.ts +77 -77
  234. package/src/_modules/ci-tools/_models/cit-ci-step-result.interface.ts +12 -12
  235. package/src/_modules/ci-tools/index.ts +8 -8
  236. package/src/_modules/crypto/_collections/crypto.util.simple.spec.ts +512 -512
  237. package/src/_modules/crypto/index.ts +13 -13
  238. package/src/_modules/custom-data/_collections/cud-module-settings.const.ts +21 -21
  239. package/src/_modules/custom-data/_models/cud.data-model.spec.ts +38 -38
  240. package/src/_modules/custom-data/_models/cud.data-model.ts +39 -39
  241. package/src/_modules/custom-data/index.ts +10 -10
  242. package/src/_modules/data-handler/_models/data-handler-settings.control-model.spec.ts +110 -110
  243. package/src/_modules/data-handler/_models/data-handler-settings.control-model.ts +110 -110
  244. package/src/_modules/data-handler/_models/data-handler.control-model.spec.ts +473 -473
  245. package/src/_modules/data-handler/_models/data-handler.control-model.ts +486 -486
  246. package/src/_modules/data-handler/_models/data-list-handler.control-model.spec.ts +263 -263
  247. package/src/_modules/data-handler/_models/data-list-handler.control-model.ts +252 -252
  248. package/src/_modules/data-handler/_models/data-search-handler.control-model.spec.ts +417 -417
  249. package/src/_modules/data-handler/_models/data-search-handler.control-model.ts +390 -390
  250. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.spec.ts +374 -374
  251. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts +274 -274
  252. package/src/_modules/data-handler/index.ts +6 -6
  253. package/src/_modules/game/_collections/audio-scale.util.spec.ts +140 -0
  254. package/src/_modules/game/_collections/audio-scale.util.ts +129 -0
  255. package/src/_modules/game/_enums/audio-channel.enum.ts +8 -4
  256. package/src/_modules/game/_models/audio-mixer-config.interface.ts +45 -0
  257. package/src/_modules/game/_models/audio-mixer-state.interface.ts +23 -0
  258. package/src/_modules/game/_models/audio-mixer.control-model.spec.ts +306 -0
  259. package/src/_modules/game/_models/audio-mixer.control-model.ts +378 -0
  260. package/src/_modules/game/_models/audio-scale.interface.ts +21 -0
  261. package/src/_modules/game/index.ts +5 -0
  262. package/src/_modules/location/_collections/assets/country-codes-ISO-3166.json +3239 -3239
  263. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166-all-list.json +19035 -19035
  264. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166.json +4993 -4993
  265. package/src/_modules/location/_collections/assets/country-phone-codes.json +1203 -1203
  266. package/src/_modules/location/_collections/assets/country-subdivisions/afghanistan.json +137 -137
  267. package/src/_modules/location/_collections/assets/country-subdivisions/albania.json +49 -49
  268. package/src/_modules/location/_collections/assets/country-subdivisions/algeria.json +193 -193
  269. package/src/_modules/location/_collections/assets/country-subdivisions/andorra.json +29 -29
  270. package/src/_modules/location/_collections/assets/country-subdivisions/angola.json +73 -73
  271. package/src/_modules/location/_collections/assets/country-subdivisions/antigua-and-barbuda.json +33 -33
  272. package/src/_modules/location/_collections/assets/country-subdivisions/argentina.json +97 -97
  273. package/src/_modules/location/_collections/assets/country-subdivisions/armenia.json +45 -45
  274. package/src/_modules/location/_collections/assets/country-subdivisions/australia.json +33 -33
  275. package/src/_modules/location/_collections/assets/country-subdivisions/austria.json +37 -37
  276. package/src/_modules/location/_collections/assets/country-subdivisions/azerbaijan.json +5 -5
  277. package/src/_modules/location/_collections/assets/country-subdivisions/bahamas.json +125 -125
  278. package/src/_modules/location/_collections/assets/country-subdivisions/bahrain.json +21 -21
  279. package/src/_modules/location/_collections/assets/country-subdivisions/bangladesh.json +29 -29
  280. package/src/_modules/location/_collections/assets/country-subdivisions/barbados.json +45 -45
  281. package/src/_modules/location/_collections/assets/country-subdivisions/belarus.json +29 -29
  282. package/src/_modules/location/_collections/assets/country-subdivisions/belgium.json +13 -13
  283. package/src/_modules/location/_collections/assets/country-subdivisions/belize.json +25 -25
  284. package/src/_modules/location/_collections/assets/country-subdivisions/benin.json +49 -49
  285. package/src/_modules/location/_collections/assets/country-subdivisions/bhutan.json +81 -81
  286. package/src/_modules/location/_collections/assets/country-subdivisions/bolivia.json +37 -37
  287. package/src/_modules/location/_collections/assets/country-subdivisions/bosnia-and-herzegovina.json +13 -13
  288. package/src/_modules/location/_collections/assets/country-subdivisions/botswana.json +65 -65
  289. package/src/_modules/location/_collections/assets/country-subdivisions/brazil.json +109 -109
  290. package/src/_modules/location/_collections/assets/country-subdivisions/brunei-darussalam.json +17 -17
  291. package/src/_modules/location/_collections/assets/country-subdivisions/bulgaria.json +113 -113
  292. package/src/_modules/location/_collections/assets/country-subdivisions/burkina-faso.json +53 -53
  293. package/src/_modules/location/_collections/assets/country-subdivisions/burundi.json +69 -69
  294. package/src/_modules/location/_collections/assets/country-subdivisions/cambodia.json +97 -97
  295. package/src/_modules/location/_collections/assets/country-subdivisions/cameroon.json +41 -41
  296. package/src/_modules/location/_collections/assets/country-subdivisions/canada.json +79 -79
  297. package/src/_modules/location/_collections/assets/country-subdivisions/cape-verde.json +9 -9
  298. package/src/_modules/location/_collections/assets/country-subdivisions/central-african-republic.json +69 -69
  299. package/src/_modules/location/_collections/assets/country-subdivisions/chad.json +89 -89
  300. package/src/_modules/location/_collections/assets/country-subdivisions/chile.json +61 -61
  301. package/src/_modules/location/_collections/assets/country-subdivisions/china.json +205 -205
  302. package/src/_modules/location/_collections/assets/country-subdivisions/colombia.json +133 -133
  303. package/src/_modules/location/_collections/assets/country-subdivisions/comoros.json +13 -13
  304. package/src/_modules/location/_collections/assets/country-subdivisions/congo-the-democratic-republic-of-the.json +45 -45
  305. package/src/_modules/location/_collections/assets/country-subdivisions/congo.json +49 -49
  306. package/src/_modules/location/_collections/assets/country-subdivisions/costa-rica.json +29 -29
  307. package/src/_modules/location/_collections/assets/country-subdivisions/cote-d-ivoire-republic-of.json +77 -77
  308. package/src/_modules/location/_collections/assets/country-subdivisions/croatia.json +85 -85
  309. package/src/_modules/location/_collections/assets/country-subdivisions/cuba.json +65 -65
  310. package/src/_modules/location/_collections/assets/country-subdivisions/cyprus.json +25 -25
  311. package/src/_modules/location/_collections/assets/country-subdivisions/czech-republic.json +57 -57
  312. package/src/_modules/location/_collections/assets/country-subdivisions/denmark.json +21 -21
  313. package/src/_modules/location/_collections/assets/country-subdivisions/djibouti.json +25 -25
  314. package/src/_modules/location/_collections/assets/country-subdivisions/dominica.json +41 -41
  315. package/src/_modules/location/_collections/assets/country-subdivisions/dominican-republic.json +41 -41
  316. package/src/_modules/location/_collections/assets/country-subdivisions/ecuador.json +97 -97
  317. package/src/_modules/location/_collections/assets/country-subdivisions/egypt.json +117 -117
  318. package/src/_modules/location/_collections/assets/country-subdivisions/el-salvador.json +57 -57
  319. package/src/_modules/location/_collections/assets/country-subdivisions/equatorial-guinea.json +9 -9
  320. package/src/_modules/location/_collections/assets/country-subdivisions/eritrea.json +25 -25
  321. package/src/_modules/location/_collections/assets/country-subdivisions/estonia.json +61 -61
  322. package/src/_modules/location/_collections/assets/country-subdivisions/ethiopia.json +45 -45
  323. package/src/_modules/location/_collections/assets/country-subdivisions/fiji.json +21 -21
  324. package/src/_modules/location/_collections/assets/country-subdivisions/finland.json +77 -77
  325. package/src/_modules/location/_collections/assets/country-subdivisions/france.json +133 -133
  326. package/src/_modules/location/_collections/assets/country-subdivisions/gabon.json +37 -37
  327. package/src/_modules/location/_collections/assets/country-subdivisions/gambia.json +25 -25
  328. package/src/_modules/location/_collections/assets/country-subdivisions/georgia.json +49 -49
  329. package/src/_modules/location/_collections/assets/country-subdivisions/germany.json +65 -65
  330. package/src/_modules/location/_collections/assets/country-subdivisions/ghana.json +41 -41
  331. package/src/_modules/location/_collections/assets/country-subdivisions/greece.json +53 -53
  332. package/src/_modules/location/_collections/assets/country-subdivisions/greenland.json +17 -17
  333. package/src/_modules/location/_collections/assets/country-subdivisions/grenada.json +29 -29
  334. package/src/_modules/location/_collections/assets/country-subdivisions/guatemala.json +89 -89
  335. package/src/_modules/location/_collections/assets/country-subdivisions/guinea-bissau.json +13 -13
  336. package/src/_modules/location/_collections/assets/country-subdivisions/guinea.json +33 -33
  337. package/src/_modules/location/_collections/assets/country-subdivisions/guyana.json +41 -41
  338. package/src/_modules/location/_collections/assets/country-subdivisions/haiti.json +41 -41
  339. package/src/_modules/location/_collections/assets/country-subdivisions/honduras.json +73 -73
  340. package/src/_modules/location/_collections/assets/country-subdivisions/hong-kong.json +4 -4
  341. package/src/_modules/location/_collections/assets/country-subdivisions/hungary.json +173 -173
  342. package/src/_modules/location/_collections/assets/country-subdivisions/iceland.json +37 -37
  343. package/src/_modules/location/_collections/assets/country-subdivisions/india.json +181 -181
  344. package/src/_modules/location/_collections/assets/country-subdivisions/indonesia.json +29 -29
  345. package/src/_modules/location/_collections/assets/country-subdivisions/iran-islamic-republic-of.json +125 -125
  346. package/src/_modules/location/_collections/assets/country-subdivisions/iraq.json +73 -73
  347. package/src/_modules/location/_collections/assets/country-subdivisions/ireland.json +17 -17
  348. package/src/_modules/location/_collections/assets/country-subdivisions/israel.json +25 -25
  349. package/src/_modules/location/_collections/assets/country-subdivisions/italy.json +81 -81
  350. package/src/_modules/location/_collections/assets/country-subdivisions/jamaica.json +57 -57
  351. package/src/_modules/location/_collections/assets/country-subdivisions/japan.json +189 -189
  352. package/src/_modules/location/_collections/assets/country-subdivisions/jordan.json +49 -49
  353. package/src/_modules/location/_collections/assets/country-subdivisions/kazakhstan.json +65 -65
  354. package/src/_modules/location/_collections/assets/country-subdivisions/kenya.json +33 -33
  355. package/src/_modules/location/_collections/assets/country-subdivisions/kiribati.json +13 -13
  356. package/src/_modules/location/_collections/assets/country-subdivisions/korea-democratic-people-s-republic-of.json +45 -45
  357. package/src/_modules/location/_collections/assets/country-subdivisions/korea-republic-of.json +69 -69
  358. package/src/_modules/location/_collections/assets/country-subdivisions/kuwait.json +25 -25
  359. package/src/_modules/location/_collections/assets/country-subdivisions/kyrgyzstan.json +33 -33
  360. package/src/_modules/location/_collections/assets/country-subdivisions/lao-people-s-democratic-republic.json +73 -73
  361. package/src/_modules/location/_collections/assets/country-subdivisions/latvia.json +477 -477
  362. package/src/_modules/location/_collections/assets/country-subdivisions/lebanon.json +33 -33
  363. package/src/_modules/location/_collections/assets/country-subdivisions/lesotho.json +41 -41
  364. package/src/_modules/location/_collections/assets/country-subdivisions/liberia.json +61 -61
  365. package/src/_modules/location/_collections/assets/country-subdivisions/libyan-arab-jamahiriya.json +89 -89
  366. package/src/_modules/location/_collections/assets/country-subdivisions/liechtenstein.json +45 -45
  367. package/src/_modules/location/_collections/assets/country-subdivisions/lithuania.json +41 -41
  368. package/src/_modules/location/_collections/assets/country-subdivisions/luxembourg.json +13 -13
  369. package/src/_modules/location/_collections/assets/country-subdivisions/macedonia-the-former-yugoslav-republic-of.json +337 -337
  370. package/src/_modules/location/_collections/assets/country-subdivisions/madagascar.json +25 -25
  371. package/src/_modules/location/_collections/assets/country-subdivisions/malawi.json +13 -13
  372. package/src/_modules/location/_collections/assets/country-subdivisions/malaysia.json +81 -81
  373. package/src/_modules/location/_collections/assets/country-subdivisions/maldives.json +33 -33
  374. package/src/_modules/location/_collections/assets/country-subdivisions/mali.json +37 -37
  375. package/src/_modules/location/_collections/assets/country-subdivisions/malta.json +273 -273
  376. package/src/_modules/location/_collections/assets/country-subdivisions/marshall-islands.json +9 -9
  377. package/src/_modules/location/_collections/assets/country-subdivisions/mauritania.json +53 -53
  378. package/src/_modules/location/_collections/assets/country-subdivisions/mauritius.json +69 -69
  379. package/src/_modules/location/_collections/assets/country-subdivisions/mexico.json +161 -161
  380. package/src/_modules/location/_collections/assets/country-subdivisions/micronesia-federated-states-of.json +17 -17
  381. package/src/_modules/location/_collections/assets/country-subdivisions/moldova-republic-of.json +149 -149
  382. package/src/_modules/location/_collections/assets/country-subdivisions/monaco.json +69 -69
  383. package/src/_modules/location/_collections/assets/country-subdivisions/mongolia.json +89 -89
  384. package/src/_modules/location/_collections/assets/country-subdivisions/montenegro.json +93 -93
  385. package/src/_modules/location/_collections/assets/country-subdivisions/morocco.json +65 -65
  386. package/src/_modules/location/_collections/assets/country-subdivisions/mozambique.json +45 -45
  387. package/src/_modules/location/_collections/assets/country-subdivisions/myanmar.json +57 -57
  388. package/src/_modules/location/_collections/assets/country-subdivisions/namibia.json +57 -57
  389. package/src/_modules/location/_collections/assets/country-subdivisions/nauru.json +57 -57
  390. package/src/_modules/location/_collections/assets/country-subdivisions/nepal.json +21 -21
  391. package/src/_modules/location/_collections/assets/country-subdivisions/netherlands.json +91 -91
  392. package/src/_modules/location/_collections/assets/country-subdivisions/new-zealand.json +111 -111
  393. package/src/_modules/location/_collections/assets/country-subdivisions/nicaragua.json +69 -69
  394. package/src/_modules/location/_collections/assets/country-subdivisions/niger.json +33 -33
  395. package/src/_modules/location/_collections/assets/country-subdivisions/nigeria.json +149 -149
  396. package/src/_modules/location/_collections/assets/country-subdivisions/norway.json +85 -85
  397. package/src/_modules/location/_collections/assets/country-subdivisions/oman.json +37 -37
  398. package/src/_modules/location/_collections/assets/country-subdivisions/pakistan.json +33 -33
  399. package/src/_modules/location/_collections/assets/country-subdivisions/palau.json +65 -65
  400. package/src/_modules/location/_collections/assets/country-subdivisions/palestinian-territory-occupied.json +65 -65
  401. package/src/_modules/location/_collections/assets/country-subdivisions/panama.json +53 -53
  402. package/src/_modules/location/_collections/assets/country-subdivisions/papua-new-guinea.json +81 -81
  403. package/src/_modules/location/_collections/assets/country-subdivisions/paraguay.json +73 -73
  404. package/src/_modules/location/_collections/assets/country-subdivisions/peru.json +105 -105
  405. package/src/_modules/location/_collections/assets/country-subdivisions/philippines.json +69 -69
  406. package/src/_modules/location/_collections/assets/country-subdivisions/poland.json +65 -65
  407. package/src/_modules/location/_collections/assets/country-subdivisions/portugal.json +81 -81
  408. package/src/_modules/location/_collections/assets/country-subdivisions/qatar.json +29 -29
  409. package/src/_modules/location/_collections/assets/country-subdivisions/romania.json +169 -169
  410. package/src/_modules/location/_collections/assets/country-subdivisions/russian-federation.json +499 -499
  411. package/src/_modules/location/_collections/assets/country-subdivisions/rwanda.json +21 -21
  412. package/src/_modules/location/_collections/assets/country-subdivisions/saint-helena-ascension-and-tristan-da-cunha.json +13 -13
  413. package/src/_modules/location/_collections/assets/country-subdivisions/saint-kitts-and-nevis.json +9 -9
  414. package/src/_modules/location/_collections/assets/country-subdivisions/saint-lucia.json +45 -45
  415. package/src/_modules/location/_collections/assets/country-subdivisions/saint-vincent-and-the-grenadines.json +25 -25
  416. package/src/_modules/location/_collections/assets/country-subdivisions/samoa.json +45 -45
  417. package/src/_modules/location/_collections/assets/country-subdivisions/san-marino.json +37 -37
  418. package/src/_modules/location/_collections/assets/country-subdivisions/sao-tome-and-principe.json +9 -9
  419. package/src/_modules/location/_collections/assets/country-subdivisions/saudi-arabia.json +53 -53
  420. package/src/_modules/location/_collections/assets/country-subdivisions/senegal.json +57 -57
  421. package/src/_modules/location/_collections/assets/country-subdivisions/serbia.json +9 -9
  422. package/src/_modules/location/_collections/assets/country-subdivisions/seychelles.json +101 -101
  423. package/src/_modules/location/_collections/assets/country-subdivisions/sierra-leone.json +17 -17
  424. package/src/_modules/location/_collections/assets/country-subdivisions/singapore.json +21 -21
  425. package/src/_modules/location/_collections/assets/country-subdivisions/slovakia.json +33 -33
  426. package/src/_modules/location/_collections/assets/country-subdivisions/slovenia.json +841 -841
  427. package/src/_modules/location/_collections/assets/country-subdivisions/solomon-islands.json +41 -41
  428. package/src/_modules/location/_collections/assets/country-subdivisions/somalia.json +73 -73
  429. package/src/_modules/location/_collections/assets/country-subdivisions/south-africa.json +37 -37
  430. package/src/_modules/location/_collections/assets/country-subdivisions/south-sudan.json +41 -41
  431. package/src/_modules/location/_collections/assets/country-subdivisions/spain.json +346 -346
  432. package/src/_modules/location/_collections/assets/country-subdivisions/sri-lanka.json +37 -37
  433. package/src/_modules/location/_collections/assets/country-subdivisions/sudan.json +69 -69
  434. package/src/_modules/location/_collections/assets/country-subdivisions/suriname.json +41 -41
  435. package/src/_modules/location/_collections/assets/country-subdivisions/swaziland.json +17 -17
  436. package/src/_modules/location/_collections/assets/country-subdivisions/sweden.json +85 -85
  437. package/src/_modules/location/_collections/assets/country-subdivisions/switzerland.json +105 -105
  438. package/src/_modules/location/_collections/assets/country-subdivisions/syrian-arab-republic.json +57 -57
  439. package/src/_modules/location/_collections/assets/country-subdivisions/taiwan-province-of-china.json +93 -93
  440. package/src/_modules/location/_collections/assets/country-subdivisions/tajikistan.json +17 -17
  441. package/src/_modules/location/_collections/assets/country-subdivisions/tanzania-united-republic-of.json +105 -105
  442. package/src/_modules/location/_collections/assets/country-subdivisions/thailand.json +313 -313
  443. package/src/_modules/location/_collections/assets/country-subdivisions/timor-leste.json +53 -53
  444. package/src/_modules/location/_collections/assets/country-subdivisions/togo.json +21 -21
  445. package/src/_modules/location/_collections/assets/country-subdivisions/tonga.json +21 -21
  446. package/src/_modules/location/_collections/assets/country-subdivisions/trinidad-and-tobago.json +65 -65
  447. package/src/_modules/location/_collections/assets/country-subdivisions/tunisia.json +97 -97
  448. package/src/_modules/location/_collections/assets/country-subdivisions/turkey.json +325 -325
  449. package/src/_modules/location/_collections/assets/country-subdivisions/turkmenistan.json +25 -25
  450. package/src/_modules/location/_collections/assets/country-subdivisions/tuvalu.json +33 -33
  451. package/src/_modules/location/_collections/assets/country-subdivisions/uganda.json +17 -17
  452. package/src/_modules/location/_collections/assets/country-subdivisions/ukraine.json +109 -109
  453. package/src/_modules/location/_collections/assets/country-subdivisions/united-arab-emirates.json +29 -29
  454. package/src/_modules/location/_collections/assets/country-subdivisions/united-kingdom.json +1196 -1196
  455. package/src/_modules/location/_collections/assets/country-subdivisions/united-states-minor-outlying-islands.json +37 -37
  456. package/src/_modules/location/_collections/assets/country-subdivisions/united-states.json +286 -286
  457. package/src/_modules/location/_collections/assets/country-subdivisions/uruguay.json +77 -77
  458. package/src/_modules/location/_collections/assets/country-subdivisions/uzbekistan.json +57 -57
  459. package/src/_modules/location/_collections/assets/country-subdivisions/vanuatu.json +25 -25
  460. package/src/_modules/location/_collections/assets/country-subdivisions/venezuela.json +101 -101
  461. package/src/_modules/location/_collections/assets/country-subdivisions/viet-nam.json +257 -257
  462. package/src/_modules/location/_collections/assets/country-subdivisions/yemen.json +85 -85
  463. package/src/_modules/location/_collections/assets/country-subdivisions/zambia.json +37 -37
  464. package/src/_modules/location/_collections/assets/country-subdivisions/zimbabwe.json +41 -41
  465. package/src/_modules/location/_collections/loc-country-divisions.const.ts +10 -10
  466. package/src/_modules/location/_collections/loc-country-isos.const.ts +8 -8
  467. package/src/_modules/location/_collections/loc-regions.util.spec.ts +61 -61
  468. package/src/_modules/location/_collections/loc-regions.util.ts +137 -137
  469. package/src/_modules/location/_collections/loc.util.spec.ts +52 -52
  470. package/src/_modules/location/_collections/loc.util.ts +74 -74
  471. package/src/_modules/location/_enums/loc-region.enum.ts +14 -14
  472. package/src/_modules/location/_enums/loc-sub-region.enum.ts +31 -31
  473. package/src/_modules/location/_enums/loc-subdivision-region-type.enum.ts +47 -47
  474. package/src/_modules/location/_models/loc-coordinates.interface.ts +7 -7
  475. package/src/_modules/location/_models/loc-country-division.interface.ts +8 -8
  476. package/src/_modules/location/_models/loc-country-iso.interface.ts +23 -23
  477. package/src/_modules/location/_models/loc-country-phone-code.interface.ts +9 -9
  478. package/src/_modules/location/_models/loc-division-collection.interface.ts +12 -12
  479. package/src/_modules/location/_models/loc-division-region-data.interface.ts +9 -9
  480. package/src/_modules/location/_models/loc-geo-ip-location.interface.ts +27 -27
  481. package/src/_modules/location/index.ts +22 -22
  482. package/src/_modules/messaging/README.md +279 -279
  483. package/src/_modules/messaging/_collections/msg-module-settings.const.ts +46 -46
  484. package/src/_modules/messaging/_enums/msg-attachment-type.enum.ts +26 -26
  485. package/src/_modules/messaging/_enums/msg-delivery-status.enum.ts +17 -17
  486. package/src/_modules/messaging/_enums/msg-event-key.enum.ts +31 -31
  487. package/src/_modules/messaging/_enums/msg-participant-role.enum.ts +20 -20
  488. package/src/_modules/messaging/_enums/msg-provider-type.enum.ts +7 -7
  489. package/src/_modules/messaging/_enums/msg-type.enum.ts +23 -23
  490. package/src/_modules/messaging/_models/msg-attachment.interface.ts +46 -46
  491. package/src/_modules/messaging/_models/msg-conversation.data-model.spec.ts +69 -69
  492. package/src/_modules/messaging/_models/msg-conversation.data-model.ts +96 -96
  493. package/src/_modules/messaging/_models/msg-mention.interface.ts +29 -29
  494. package/src/_modules/messaging/_models/msg-message.data-model.spec.ts +79 -79
  495. package/src/_modules/messaging/_models/msg-message.data-model.ts +127 -127
  496. package/src/_modules/messaging/_models/msg-participant.interface.ts +46 -46
  497. package/src/_modules/messaging/_models/msg-reaction.interface.ts +20 -20
  498. package/src/_modules/messaging/_models/msg-thread-info.interface.ts +35 -35
  499. package/src/_modules/messaging/_modules/agent/_enums/agt-process-step-type.enum.ts +35 -35
  500. package/src/_modules/messaging/_modules/agent/_enums/agt-tool-status.enum.ts +23 -23
  501. package/src/_modules/messaging/_modules/agent/_models/agt-process-step.interface.ts +55 -55
  502. package/src/_modules/messaging/_modules/agent/_models/agt-reasoning-info.interface.ts +26 -26
  503. package/src/_modules/messaging/_modules/agent/_models/agt-tool-usage.interface.ts +37 -37
  504. package/src/_modules/messaging/_modules/agent/index.ts +8 -8
  505. package/src/_modules/messaging/index.ts +28 -28
  506. package/src/_modules/pipe/_collections/pip-transforms.const.ts +42 -42
  507. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.spec.ts +47 -47
  508. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.ts +41 -41
  509. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.spec.ts +39 -39
  510. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.ts +30 -30
  511. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.spec.ts +41 -41
  512. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.ts +36 -36
  513. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.spec.ts +62 -62
  514. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.ts +17 -17
  515. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.spec.ts +34 -34
  516. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.ts +25 -25
  517. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.spec.ts +67 -67
  518. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.ts +226 -226
  519. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.spec.ts +28 -28
  520. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.ts +21 -21
  521. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.spec.ts +59 -59
  522. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.ts +106 -106
  523. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.spec.ts +31 -31
  524. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.ts +35 -35
  525. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.spec.ts +44 -44
  526. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.ts +23 -23
  527. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.spec.ts +21 -21
  528. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.ts +33 -33
  529. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.spec.ts +62 -62
  530. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.ts +80 -80
  531. package/src/_modules/pipe/_enums/pip-range-pipe-setting.enum.ts +15 -15
  532. package/src/_modules/pipe/_enums/pip.enum.ts +65 -65
  533. package/src/_modules/pipe/_models/pip-multi-pipe-settings.type.ts +8 -8
  534. package/src/_modules/pipe/_models/pip-transforms.interface.ts +30 -30
  535. package/src/_modules/pipe/index.ts +30 -30
  536. package/src/_modules/socket/_enums/sck-event-key.enum.ts +21 -21
  537. package/src/_modules/socket/_models/sck-client-params.control-model.spec.ts +67 -67
  538. package/src/_modules/socket/_models/sck-client-params.control-model.ts +50 -50
  539. package/src/_modules/socket/_models/sck-socket-event.control-model.spec.ts +66 -66
  540. package/src/_modules/socket/_models/sck-socket-event.control-model.ts +172 -172
  541. package/src/_modules/socket/_services/sck-client.service-base.spec.ts +99 -99
  542. package/src/_modules/socket/_services/sck-client.service-base.ts +353 -353
  543. package/src/_modules/socket/index.ts +14 -14
  544. package/src/_modules/test/_collections/tst-module-settings.const.ts +67 -67
  545. package/src/_modules/test/index.ts +5 -5
  546. package/src/_modules/usage/_collections/usg-module-settings.const.ts +33 -33
  547. package/src/_modules/usage/_models/usg-action.control-model.spec.ts +27 -27
  548. package/src/_modules/usage/_models/usg-action.control-model.ts +28 -28
  549. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.spec.ts +36 -36
  550. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.ts +35 -35
  551. package/src/_modules/usage/_models/usg-data.control-model.spec.ts +41 -41
  552. package/src/_modules/usage/_models/usg-data.control-model.ts +35 -35
  553. package/src/_modules/usage/_models/usg-session.data-model.spec.ts +97 -97
  554. package/src/_modules/usage/_models/usg-session.data-model.ts +72 -72
  555. package/src/_modules/usage/index.ts +11 -11
  556. package/src/index.ts +104 -104
  557. package/tsconfig.app.json +12 -12
  558. package/tsconfig.json +31 -31
  559. package/tsconfig.test.json +16 -16
  560. package/tslint.json +153 -153
@@ -1,667 +1,667 @@
1
-
2
- import { DyFM_LogStyle, DyFM_allLogStyles } from '../../_enums/log-style.enum';
3
-
4
- /* export class D_Log implements DyFM_Log {}; */
5
- export type DyFM_L = DyFM_Log;
6
-
7
- /**
8
- * DyFM_Log is a class that provides a set of methods to log messages to the console.
9
- * This class have methods to log messages with different styles and colors,
10
- * such as success, error, warn, info and highlighted for each of them.
11
- */
12
- export class DyFM_Log {
13
-
14
- static readonly infoStyle: string = DyFM_LogStyle.cyan;
15
- static readonly errorStyle: string = DyFM_LogStyle.red;
16
- static readonly warnStyle: string = DyFM_LogStyle.brightOrange;
17
- static readonly successStyle: string = DyFM_LogStyle.green;
18
- static readonly highlightedStyle: string = `${DyFM_LogStyle.white}${DyFM_LogStyle.bold}`;
19
- static readonly boldStyle: string = DyFM_LogStyle.bold;
20
-
21
-
22
- static readonly h_test: string = '||||||||||';
23
-
24
- static readonly h_before: string = '\\\\\\\\\\\\\\\\\\\\';
25
-
26
- static readonly h_after: string = '//////////';
27
-
28
- static readonly h_small: string = '----------';
29
-
30
- /**
31
- * Sets the style of the console log.
32
- * @param styles - The styles to set.
33
- *
34
- * @example
35
- * ```ts
36
- * DyFM_Log.setStyle([ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
37
- * ```
38
- */
39
- static setStyle(styles: DyFM_LogStyle[]): void {
40
- let styleSets = '';
41
-
42
- styles.forEach((style: DyFM_LogStyle): void => {
43
- styleSets += style;
44
- });
45
-
46
- console.log(styleSets);
47
- }
48
-
49
- /**
50
- * Resets the style of the console log.
51
- *
52
- * @example
53
- * ```ts
54
- * DyFM_Log.resetStyle();
55
- * ```
56
- */
57
- static resetStyle(): void {
58
- console.log(DyFM_LogStyle.reset);
59
- }
60
-
61
- /**
62
- * Adds a style to the console log.
63
- * @param input - The input to add the style to.
64
- * @param styles - The styles to add.
65
- * @param dontReset - Whether to not reset the style.
66
- * @returns The input with the style added.
67
- *
68
- * @example
69
- * ```ts
70
- * const result = DyFM_Log.addStyle('Hello, world!', [ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
71
- * ```
72
- */
73
- static addStyle(input: string, styles: DyFM_LogStyle[], dontReset?: boolean): string {
74
- let result = '';
75
-
76
- styles.forEach((style: DyFM_LogStyle): void => {
77
- result += style;
78
- });
79
-
80
- result += input;
81
-
82
- if (!dontReset) {
83
- result += DyFM_LogStyle.reset;
84
- }
85
-
86
- return result;
87
- }
88
-
89
- /**
90
- * Logs a success message.
91
- * @param message - The message to log.
92
- * @param optionalParams - The optional parameters to log.
93
- *
94
- * @example
95
- * ```ts
96
- * DyFM_Log.success('Hello, world!');
97
- * ```
98
- */
99
- static success(message: string, ...optionalParams: any[]): void {
100
- if (0 < optionalParams.length) {
101
- console.log(
102
- `${this.successStyle}${message}`,
103
- ...optionalParams, DyFM_LogStyle.reset
104
- );
105
- } else {
106
- console.log(`${this.successStyle}${message}${DyFM_LogStyle.reset}`);
107
- }
108
- }
109
- /**
110
- * @deprecated use DyFM_Log.success instead
111
- */
112
- static readonly logSuccess = this.success;
113
-
114
- /**
115
- * Logs an error message.
116
- * @param message - The message to log.
117
- * @param optionalParams - The optional parameters to log.
118
- *
119
- * @example
120
- * ```ts
121
- * DyFM_Log.error('An error occurred: {errorMessage}', errorMessage);
122
- * ```
123
- */
124
- static error(message: string, ...optionalParams: any[]): void {
125
- if (0 < optionalParams.length) {
126
- console.error(
127
- `${this.errorStyle}${message}`,
128
- ...optionalParams, DyFM_LogStyle.reset
129
- );
130
- } else {
131
- console.error(`${this.errorStyle}${message}${DyFM_LogStyle.reset}`);
132
- }
133
- }
134
- /**
135
- * @deprecated use DyFM_Log.error instead
136
- */
137
- static readonly logError = this.error;
138
-
139
- /**
140
- * Logs a warning message.
141
- * @param message - The message to log.
142
- * @param optionalParams - The optional parameters to log.
143
- *
144
- * @example
145
- * ```ts
146
- * DyFM_Log.warn('A warning occurred: {warningMessage}', warningMessage);
147
- * ```
148
- */
149
- static warn(message: string, ...optionalParams: any[]): void {
150
- if (0 < optionalParams.length) {
151
- console.warn(
152
- `${this.warnStyle}${message}`,
153
- ...optionalParams, DyFM_LogStyle.reset
154
- );
155
- } else {
156
- console.warn(`${this.warnStyle}${message}${DyFM_LogStyle.reset}`);
157
- }
158
- }
159
- /**
160
- * @deprecated use DyFM_Log.warn instead
161
- */
162
- static readonly warning = this.warn;
163
- /**
164
- * @deprecated use DyFM_Log.warn instead
165
- */
166
- static readonly logWarning = this.warn;
167
-
168
- // ez azért nem egy sima "static readonly info = console.info;",
169
- // mert azon nincs rajta az első input típusa, ami csak string lehet
170
- /**
171
- * Logs an info message.
172
- * @param message - The message to log.
173
- * @param optionalParams - The optional parameters to log.
174
- *
175
- * @example
176
- * ```ts
177
- * DyFM_Log.info('An info message: {infoMessage}', infoMessage);
178
- * ```
179
- */
180
- static info(message: string, ...optionalParams: any[]): void {
181
- if (0 < optionalParams.length) {
182
- console.info(
183
- `${this.infoStyle}${message}`,
184
- ...optionalParams, DyFM_LogStyle.reset
185
- );
186
- } else {
187
- console.info(`${this.infoStyle}${message}${DyFM_LogStyle.reset}`);
188
- }
189
- }
190
-
191
- // ez azért nem egy sima "static readonly log = console.log;",
192
- // mert azon nincs rajta az első input típusa, ami csak string lehet
193
- /**
194
- * Logs a log message.
195
- * @param message - The message to log.
196
- * @param optionalParams - The optional parameters to log.
197
- *
198
- * @example
199
- * ```ts
200
- * DyFM_Log.log('A log message: {logMessage}', logMessage);
201
- * ```
202
- */
203
- static log(message: string, ...optionalParams: any[]): void {
204
- console.log(message, ...optionalParams);
205
- }
206
-
207
- /**
208
- * Gets a highlighted message.
209
- * @param message - The message to highlight.
210
- * @param optionalParams - The optional parameters to highlight.
211
- * @returns The highlighted message.
212
- *
213
- * @example
214
- * ```ts
215
- * const highlightedMessage = DyFM_Log.getHighlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
216
- * console.log(highlightedMessage); // A highlighted message: {highlightedMessage}
217
- * ```
218
- */
219
- static getHighlighted(message: string, ...optionalParams: any[]): string {
220
- return `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`;
221
- }
222
-
223
- /**
224
- * Logs a highlighted message.
225
- * @param message - The message to highlight.
226
- * @param optionalParams - The optional parameters to highlight.
227
- *
228
- * @example
229
- * ```ts
230
- * DyFM_Log.highlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
231
- * ```
232
- */
233
- static highlighted(message: string, ...optionalParams: any[]): void {
234
- if (0 < optionalParams.length) {
235
- console.log(
236
- `${this.highlightedStyle}${message}`,
237
- ...optionalParams, DyFM_LogStyle.reset
238
- );
239
- } else {
240
- console.log(
241
- `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`
242
- );
243
- }
244
- }
245
-
246
- /**
247
- * Logs a small Highlighted log message.
248
- * @param message - The message to log.
249
- * @param optionalParams - The optional parameters to log.
250
- *
251
- * @example
252
- * ```ts
253
- * DyFM_Log.smallLog('A small log message: {smallLogMessage}', smallLogMessage);
254
- * ```
255
- */
256
- static smallLog(message: string, ...optionalParams: any[]): void {
257
- console.log(
258
- this.h_small +
259
- '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
260
- '\n' + this.h_small
261
- );
262
- }
263
- static readonly S_log = DyFM_Log.smallLog;
264
-
265
- /**
266
- * Highlighted Tests a log message.
267
- * @param message - The message to test.
268
- * @param optionalParams - The optional parameters to test.
269
- *
270
- * @example
271
- * ```ts
272
- * DyFM_Log.testLog('A test log message: {testLogMessage}', testLogMessage);
273
- * ```
274
- */
275
- static testLog(message: string, ...optionalParams: any[]): void {
276
- this.log(
277
- '\n' + this.h_test +
278
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
279
- '\n\n' + this.h_test + '\n'
280
- );
281
- }
282
- static readonly test = DyFM_Log.testLog;
283
- static readonly T_log = DyFM_Log.testLog;
284
-
285
- /**
286
- * Logs a highlighted log message.
287
- * @param message - The message to highlight.
288
- * @param optionalParams - The optional parameters to highlight.
289
- *
290
- * @example
291
- * ```ts
292
- * DyFM_Log.highlightedLog('A highlighted log message: {highlightedLogMessage}', highlightedLogMessage);
293
- * ```
294
- */
295
- static highlightedLog(message: string, ...optionalParams: any[]): void {
296
- this.log(
297
- '\n\n' + this.h_before +
298
- '\n ' + this.h_before +
299
- '\n ' + this.h_before +
300
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
301
- '\n\n ' + this.h_after +
302
- '\n ' + this.h_after +
303
- '\n' + this.h_after + '\n\n'
304
- );
305
- }
306
- static readonly H_log = DyFM_Log.highlightedLog;
307
-
308
- /**
309
- * Logs a small Highlighted info message.
310
- * @param message - The message to log.
311
- * @param optionalParams - The optional parameters to log.
312
- *
313
- * @example
314
- * ```ts
315
- * DyFM_Log.smallInfo('A small info message: {smallInfoMessage}', smallInfoMessage);
316
- * ```
317
- */
318
- static smallInfo(message: string, ...optionalParams: any[]): void {
319
- this.info(
320
- this.h_small +
321
- '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
322
- '\n' + this.infoStyle + this.h_small
323
- );
324
- }
325
- static readonly S_info = DyFM_Log.smallInfo;
326
-
327
- /**
328
- * Highlighted Tests an info message.
329
- * @param message - The message to test.
330
- * @param optionalParams - The optional parameters to test.
331
- *
332
- * @example
333
- * ```ts
334
- * DyFM_Log.testInfo('A test info message: {testInfoMessage}', testInfoMessage);
335
- * ```
336
- */
337
- static testInfo(message: string, ...optionalParams: any[]): void {
338
- this.info(
339
- '\n' + this.h_test +
340
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
341
- '\n\n' + this.infoStyle + this.h_test + '\n'
342
- );
343
- }
344
- static readonly T_info = DyFM_Log.testInfo;
345
-
346
- /**
347
- * Logs a highlighted info message.
348
- * @param message - The message to highlight.
349
- * @param optionalParams - The optional parameters to highlight.
350
- *
351
- * @example
352
- * ```ts
353
- * DyFM_Log.highlightedInfo('A highlighted info message: {highlightedInfoMessage}', highlightedInfoMessage);
354
- * ```
355
- */
356
- static highlightedInfo(message: string, ...optionalParams: any[]): void {
357
- this.info(
358
- '\n\n' + this.h_before +
359
- '\n ' + this.h_before +
360
- '\n ' + this.h_before +
361
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
362
- '\n\n ' + this.infoStyle + this.h_after +
363
- '\n ' + this.h_after +
364
- '\n' + this.h_after + '\n\n'
365
- );
366
- }
367
- static readonly H_info = DyFM_Log.highlightedInfo;
368
-
369
- /**
370
- * Logs a small Highlighted error message.
371
- * @param message - The message to log.
372
- * @param optionalParams - The optional parameters to log.
373
- *
374
- * @example
375
- * ```ts
376
- * DyFM_Log.smallError('A small error message: {smallErrorMessage}', smallErrorMessage);
377
- * ```
378
- */
379
- static smallError(message: string, ...optionalParams: any[]): void {
380
- this.error(
381
- this.h_small +
382
- '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
383
- '\n' + this.errorStyle + this.h_small
384
- );
385
- }
386
- static readonly S_error = DyFM_Log.smallError;
387
-
388
- /**
389
- * Highlighted Tests an error message.
390
- * @param message - The message to test.
391
- * @param optionalParams - The optional parameters to test.
392
- *
393
- * @example
394
- * ```ts
395
- * DyFM_Log.testError('A test error message: {testErrorMessage}', testErrorMessage);
396
- * ```
397
- */
398
- static testError(message: string, ...optionalParams: any[]): void {
399
- this.error(
400
- '\n' + this.h_test +
401
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
402
- '\n\n' + this.errorStyle + this.h_test + '\n'
403
- );
404
- }
405
- static readonly T_error = DyFM_Log.testError;
406
-
407
- /**
408
- * Logs a highlighted error message.
409
- * @param message - The message to highlight.
410
- * @param optionalParams - The optional parameters to highlight.
411
- *
412
- * @example
413
- * ```ts
414
- * DyFM_Log.highlightedError('A highlighted error message: {highlightedErrorMessage}', highlightedErrorMessage);
415
- * ```
416
- */
417
- static highlightedError(message: string, ...optionalParams: any[]): void {
418
- this.error(
419
- '\n\n' + this.h_before +
420
- '\n ' + this.h_before +
421
- '\n ' + this.h_before +
422
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
423
- '\n\n ' + this.errorStyle + this.h_after +
424
- '\n ' + this.h_after +
425
- '\n' + this.h_after + '\n\n'
426
- );
427
- }
428
- static readonly H_error = DyFM_Log.highlightedError;
429
-
430
- /**
431
- * Logs a small Highlighted warning message.
432
- * @param message - The message to log.
433
- * @param optionalParams - The optional parameters to log.
434
- *
435
- * @example
436
- * ```ts
437
- * DyFM_Log.smallWarn('A small warning message: {smallWarnMessage}', smallWarnMessage);
438
- * ```
439
- */
440
- static smallWarn(message: string, ...optionalParams: any[]): void {
441
- this.warn(
442
- this.h_small +
443
- '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
444
- '\n' + this.warnStyle + this.h_small
445
- );
446
- }
447
- static readonly S_warn = DyFM_Log.smallWarn;
448
-
449
- /**
450
- * Highlighted Tests a warning message.
451
- * @param message - The message to test.
452
- * @param optionalParams - The optional parameters to test.
453
- *
454
- * @example
455
- * ```ts
456
- * DyFM_Log.testWarn('A test warning message: {testWarnMessage}', testWarnMessage);
457
- * ```
458
- */
459
- static testWarn(message: string, ...optionalParams: any[]): void {
460
- this.warn(
461
- '\n' + this.h_test +
462
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
463
- '\n\n' + this.warnStyle + this.h_test + '\n'
464
- );
465
- }
466
- static readonly T_warn = DyFM_Log.testWarn;
467
-
468
- /**
469
- * Logs a highlighted warning message.
470
- * @param message - The message to highlight.
471
- * @param optionalParams - The optional parameters to highlight.
472
- *
473
- * @example
474
- * ```ts
475
- * DyFM_Log.highlightedWarn('A highlighted warning message: {highlightedWarnMessage}', highlightedWarnMessage);
476
- * ```
477
- */
478
- static highlightedWarn(message: string, ...optionalParams: any[]): void {
479
- this.warn(
480
- '\n\n' + this.h_before +
481
- '\n ' + this.h_before +
482
- '\n ' + this.h_before +
483
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
484
- '\n\n ' + this.warnStyle + this.h_after +
485
- '\n ' + this.h_after +
486
- '\n' + this.h_after + '\n\n'
487
- );
488
- }
489
- static readonly H_warn = DyFM_Log.highlightedWarn;
490
-
491
- /**
492
- * Logs a small success message.
493
- * @param message - The message to log.
494
- * @param optionalParams - The optional parameters to log.
495
- *
496
- * @example
497
- * ```ts
498
- * DyFM_Log.smallSuccess('A small success message: {smallSuccessMessage}', smallSuccessMessage);
499
- * ```
500
- */
501
- static smallSuccess(message: string, ...optionalParams: any[]): void {
502
- this.success(
503
- this.h_small +
504
- '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
505
- '\n' + this.successStyle + this.h_small
506
- );
507
- }
508
- static readonly S_success = DyFM_Log.smallSuccess;
509
-
510
- /**
511
- * Tests a success message.
512
- * @param message - The message to test.
513
- * @param optionalParams - The optional parameters to test.
514
- *
515
- * @example
516
- * ```ts
517
- * DyFM_Log.testSuccess('A test success message: {testSuccessMessage}', testSuccessMessage);
518
- * ```
519
- */
520
- static testSuccess(message: string, ...optionalParams: any[]): void {
521
- this.success(
522
- '\n' + this.h_test +
523
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
524
- '\n\n' + this.successStyle + this.h_test + '\n'
525
- );
526
- }
527
- static readonly T_success = DyFM_Log.testSuccess;
528
-
529
- /**
530
- * Logs a highlighted success message.
531
- * @param message - The message to highlight.
532
- * @param optionalParams - The optional parameters to highlight.
533
- */
534
- static highlightedSuccess(message: string, ...optionalParams: any[]): void {
535
- this.success(
536
- '\n\n' + this.h_before +
537
- '\n ' + this.h_before +
538
- '\n ' + this.h_before +
539
- '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
540
- '\n\n ' + this.successStyle + this.h_after +
541
- '\n ' + this.h_after +
542
- '\n' + this.h_after + '\n\n'
543
- );
544
- }
545
- static readonly H_success = DyFM_Log.highlightedSuccess;
546
-
547
- /**
548
- * Removes the log styles from a message.
549
- * @param message - The message to remove the styles from.
550
- * @returns The message without the styles.
551
- */
552
- static removeLogStyles(message: string): string {
553
- for (const styleKey of DyFM_allLogStyles) {
554
- message = message.replaceAll(styleKey, '');
555
- }
556
-
557
- return message;
558
- }
559
-
560
- /**
561
- * Silences all logs.
562
- *
563
- * @example
564
- * ```ts
565
- * DyFM_Log.silenceLogs();
566
- * ```
567
- */
568
- static silenceLogs(): void {
569
- console.log = (): void => {};
570
- }
571
-
572
- /**
573
- * Silences non-error logs.
574
- *
575
- * @example
576
- * ```ts
577
- * DyFM_Log.silenceNonErrorLogs();
578
- * ```
579
- */
580
- static silenceNonErrorLogs(): void {
581
- console.log = (): void => {};
582
- console.info = (): void => {};
583
- console.warn = (): void => {};
584
- }
585
-
586
- /**
587
- * Silences all logs.
588
- *
589
- * @example
590
- * ```ts
591
- * DyFM_Log.silenceConsole();
592
- * ```
593
- */
594
- static silenceConsole(): void {
595
- console.log = (): void => {};
596
- console.info = (): void => {};
597
- console.warn = (): void => {};
598
- console.error = (): void => {};
599
- }
600
-
601
- /**
602
- * Adds breaks and tabs to the string parameters.
603
- * @param params - The parameters to add the breaks and tabs to.
604
- * @returns The parameters with the breaks and tabs added.
605
- *
606
- * @example
607
- * ```ts
608
- * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
609
- * const result = DyFM_Log.addBreaksAndTabsToStringParams(params);
610
- * console.log(result); // [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ]
611
- * ```
612
- */
613
- static addBreaksAndTabsToStringParams(params: any[]): any[] {
614
- return params.map((param: any): string => {
615
- if (typeof param === 'string') {
616
- return '\n ' + param;
617
- }
618
-
619
- return param;
620
-
621
- });
622
- }
623
-
624
- /**
625
- * Adds spaces for each line.
626
- * @param message - The message to add the spaces to.
627
- * @param spaces - The number of spaces to add.
628
- * @returns The message with the spaces added.
629
- *
630
- * @example
631
- * ```ts
632
- * const message = 'Hello, world!\nHello, world!\nHello, world!';
633
- * const result = DyFM_Log.addSpacesForEachLine(message, 2);
634
- * console.log(result); // Hello, world! Hello, world! Hello, world!
635
- * ```
636
- */
637
- static addSpacesForEachLine(message: string, spaces: number): string {
638
- return message.replaceAll('\n', '\n' + ' '.repeat(spaces));
639
- }
640
- private static asfel = this.addSpacesForEachLine;
641
-
642
- /**
643
- * Adds spaces for each string optional parameter.
644
- * @param params - The parameters to add the spaces to.
645
- * @param spaces - The number of spaces to add.
646
- * @returns The parameters with the spaces added.
647
- *
648
- * @example
649
- * ```ts
650
- * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
651
- * const result = DyFM_Log.addSpacesForEachStringOptionalParam(params, 2);
652
- * console.log(result); // [ 'Hello, world! Hello, world! Hello, world!' ]
653
- * ```
654
- */
655
- static addSpacesForEachStringOptionalParam(params: any[], spaces: number): any[] {
656
- return params.map((param: any): any => {
657
- if (typeof param === 'string') {
658
- return this.addSpacesForEachLine(param, spaces);
659
- }
660
-
661
- return param;
662
-
663
- });
664
- }
665
- private static asfesop = this.addSpacesForEachStringOptionalParam;
666
- }
667
-
1
+
2
+ import { DyFM_LogStyle, DyFM_allLogStyles } from '../../_enums/log-style.enum';
3
+
4
+ /* export class D_Log implements DyFM_Log {}; */
5
+ export type DyFM_L = DyFM_Log;
6
+
7
+ /**
8
+ * DyFM_Log is a class that provides a set of methods to log messages to the console.
9
+ * This class have methods to log messages with different styles and colors,
10
+ * such as success, error, warn, info and highlighted for each of them.
11
+ */
12
+ export class DyFM_Log {
13
+
14
+ static readonly infoStyle: string = DyFM_LogStyle.cyan;
15
+ static readonly errorStyle: string = DyFM_LogStyle.red;
16
+ static readonly warnStyle: string = DyFM_LogStyle.brightOrange;
17
+ static readonly successStyle: string = DyFM_LogStyle.green;
18
+ static readonly highlightedStyle: string = `${DyFM_LogStyle.white}${DyFM_LogStyle.bold}`;
19
+ static readonly boldStyle: string = DyFM_LogStyle.bold;
20
+
21
+
22
+ static readonly h_test: string = '||||||||||';
23
+
24
+ static readonly h_before: string = '\\\\\\\\\\\\\\\\\\\\';
25
+
26
+ static readonly h_after: string = '//////////';
27
+
28
+ static readonly h_small: string = '----------';
29
+
30
+ /**
31
+ * Sets the style of the console log.
32
+ * @param styles - The styles to set.
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * DyFM_Log.setStyle([ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
37
+ * ```
38
+ */
39
+ static setStyle(styles: DyFM_LogStyle[]): void {
40
+ let styleSets = '';
41
+
42
+ styles.forEach((style: DyFM_LogStyle): void => {
43
+ styleSets += style;
44
+ });
45
+
46
+ console.log(styleSets);
47
+ }
48
+
49
+ /**
50
+ * Resets the style of the console log.
51
+ *
52
+ * @example
53
+ * ```ts
54
+ * DyFM_Log.resetStyle();
55
+ * ```
56
+ */
57
+ static resetStyle(): void {
58
+ console.log(DyFM_LogStyle.reset);
59
+ }
60
+
61
+ /**
62
+ * Adds a style to the console log.
63
+ * @param input - The input to add the style to.
64
+ * @param styles - The styles to add.
65
+ * @param dontReset - Whether to not reset the style.
66
+ * @returns The input with the style added.
67
+ *
68
+ * @example
69
+ * ```ts
70
+ * const result = DyFM_Log.addStyle('Hello, world!', [ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
71
+ * ```
72
+ */
73
+ static addStyle(input: string, styles: DyFM_LogStyle[], dontReset?: boolean): string {
74
+ let result = '';
75
+
76
+ styles.forEach((style: DyFM_LogStyle): void => {
77
+ result += style;
78
+ });
79
+
80
+ result += input;
81
+
82
+ if (!dontReset) {
83
+ result += DyFM_LogStyle.reset;
84
+ }
85
+
86
+ return result;
87
+ }
88
+
89
+ /**
90
+ * Logs a success message.
91
+ * @param message - The message to log.
92
+ * @param optionalParams - The optional parameters to log.
93
+ *
94
+ * @example
95
+ * ```ts
96
+ * DyFM_Log.success('Hello, world!');
97
+ * ```
98
+ */
99
+ static success(message: string, ...optionalParams: any[]): void {
100
+ if (0 < optionalParams.length) {
101
+ console.log(
102
+ `${this.successStyle}${message}`,
103
+ ...optionalParams, DyFM_LogStyle.reset
104
+ );
105
+ } else {
106
+ console.log(`${this.successStyle}${message}${DyFM_LogStyle.reset}`);
107
+ }
108
+ }
109
+ /**
110
+ * @deprecated use DyFM_Log.success instead
111
+ */
112
+ static readonly logSuccess = this.success;
113
+
114
+ /**
115
+ * Logs an error message.
116
+ * @param message - The message to log.
117
+ * @param optionalParams - The optional parameters to log.
118
+ *
119
+ * @example
120
+ * ```ts
121
+ * DyFM_Log.error('An error occurred: {errorMessage}', errorMessage);
122
+ * ```
123
+ */
124
+ static error(message: string, ...optionalParams: any[]): void {
125
+ if (0 < optionalParams.length) {
126
+ console.error(
127
+ `${this.errorStyle}${message}`,
128
+ ...optionalParams, DyFM_LogStyle.reset
129
+ );
130
+ } else {
131
+ console.error(`${this.errorStyle}${message}${DyFM_LogStyle.reset}`);
132
+ }
133
+ }
134
+ /**
135
+ * @deprecated use DyFM_Log.error instead
136
+ */
137
+ static readonly logError = this.error;
138
+
139
+ /**
140
+ * Logs a warning message.
141
+ * @param message - The message to log.
142
+ * @param optionalParams - The optional parameters to log.
143
+ *
144
+ * @example
145
+ * ```ts
146
+ * DyFM_Log.warn('A warning occurred: {warningMessage}', warningMessage);
147
+ * ```
148
+ */
149
+ static warn(message: string, ...optionalParams: any[]): void {
150
+ if (0 < optionalParams.length) {
151
+ console.warn(
152
+ `${this.warnStyle}${message}`,
153
+ ...optionalParams, DyFM_LogStyle.reset
154
+ );
155
+ } else {
156
+ console.warn(`${this.warnStyle}${message}${DyFM_LogStyle.reset}`);
157
+ }
158
+ }
159
+ /**
160
+ * @deprecated use DyFM_Log.warn instead
161
+ */
162
+ static readonly warning = this.warn;
163
+ /**
164
+ * @deprecated use DyFM_Log.warn instead
165
+ */
166
+ static readonly logWarning = this.warn;
167
+
168
+ // ez azért nem egy sima "static readonly info = console.info;",
169
+ // mert azon nincs rajta az első input típusa, ami csak string lehet
170
+ /**
171
+ * Logs an info message.
172
+ * @param message - The message to log.
173
+ * @param optionalParams - The optional parameters to log.
174
+ *
175
+ * @example
176
+ * ```ts
177
+ * DyFM_Log.info('An info message: {infoMessage}', infoMessage);
178
+ * ```
179
+ */
180
+ static info(message: string, ...optionalParams: any[]): void {
181
+ if (0 < optionalParams.length) {
182
+ console.info(
183
+ `${this.infoStyle}${message}`,
184
+ ...optionalParams, DyFM_LogStyle.reset
185
+ );
186
+ } else {
187
+ console.info(`${this.infoStyle}${message}${DyFM_LogStyle.reset}`);
188
+ }
189
+ }
190
+
191
+ // ez azért nem egy sima "static readonly log = console.log;",
192
+ // mert azon nincs rajta az első input típusa, ami csak string lehet
193
+ /**
194
+ * Logs a log message.
195
+ * @param message - The message to log.
196
+ * @param optionalParams - The optional parameters to log.
197
+ *
198
+ * @example
199
+ * ```ts
200
+ * DyFM_Log.log('A log message: {logMessage}', logMessage);
201
+ * ```
202
+ */
203
+ static log(message: string, ...optionalParams: any[]): void {
204
+ console.log(message, ...optionalParams);
205
+ }
206
+
207
+ /**
208
+ * Gets a highlighted message.
209
+ * @param message - The message to highlight.
210
+ * @param optionalParams - The optional parameters to highlight.
211
+ * @returns The highlighted message.
212
+ *
213
+ * @example
214
+ * ```ts
215
+ * const highlightedMessage = DyFM_Log.getHighlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
216
+ * console.log(highlightedMessage); // A highlighted message: {highlightedMessage}
217
+ * ```
218
+ */
219
+ static getHighlighted(message: string, ...optionalParams: any[]): string {
220
+ return `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`;
221
+ }
222
+
223
+ /**
224
+ * Logs a highlighted message.
225
+ * @param message - The message to highlight.
226
+ * @param optionalParams - The optional parameters to highlight.
227
+ *
228
+ * @example
229
+ * ```ts
230
+ * DyFM_Log.highlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
231
+ * ```
232
+ */
233
+ static highlighted(message: string, ...optionalParams: any[]): void {
234
+ if (0 < optionalParams.length) {
235
+ console.log(
236
+ `${this.highlightedStyle}${message}`,
237
+ ...optionalParams, DyFM_LogStyle.reset
238
+ );
239
+ } else {
240
+ console.log(
241
+ `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`
242
+ );
243
+ }
244
+ }
245
+
246
+ /**
247
+ * Logs a small Highlighted log message.
248
+ * @param message - The message to log.
249
+ * @param optionalParams - The optional parameters to log.
250
+ *
251
+ * @example
252
+ * ```ts
253
+ * DyFM_Log.smallLog('A small log message: {smallLogMessage}', smallLogMessage);
254
+ * ```
255
+ */
256
+ static smallLog(message: string, ...optionalParams: any[]): void {
257
+ console.log(
258
+ this.h_small +
259
+ '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
260
+ '\n' + this.h_small
261
+ );
262
+ }
263
+ static readonly S_log = DyFM_Log.smallLog;
264
+
265
+ /**
266
+ * Highlighted Tests a log message.
267
+ * @param message - The message to test.
268
+ * @param optionalParams - The optional parameters to test.
269
+ *
270
+ * @example
271
+ * ```ts
272
+ * DyFM_Log.testLog('A test log message: {testLogMessage}', testLogMessage);
273
+ * ```
274
+ */
275
+ static testLog(message: string, ...optionalParams: any[]): void {
276
+ this.log(
277
+ '\n' + this.h_test +
278
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
279
+ '\n\n' + this.h_test + '\n'
280
+ );
281
+ }
282
+ static readonly test = DyFM_Log.testLog;
283
+ static readonly T_log = DyFM_Log.testLog;
284
+
285
+ /**
286
+ * Logs a highlighted log message.
287
+ * @param message - The message to highlight.
288
+ * @param optionalParams - The optional parameters to highlight.
289
+ *
290
+ * @example
291
+ * ```ts
292
+ * DyFM_Log.highlightedLog('A highlighted log message: {highlightedLogMessage}', highlightedLogMessage);
293
+ * ```
294
+ */
295
+ static highlightedLog(message: string, ...optionalParams: any[]): void {
296
+ this.log(
297
+ '\n\n' + this.h_before +
298
+ '\n ' + this.h_before +
299
+ '\n ' + this.h_before +
300
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
301
+ '\n\n ' + this.h_after +
302
+ '\n ' + this.h_after +
303
+ '\n' + this.h_after + '\n\n'
304
+ );
305
+ }
306
+ static readonly H_log = DyFM_Log.highlightedLog;
307
+
308
+ /**
309
+ * Logs a small Highlighted info message.
310
+ * @param message - The message to log.
311
+ * @param optionalParams - The optional parameters to log.
312
+ *
313
+ * @example
314
+ * ```ts
315
+ * DyFM_Log.smallInfo('A small info message: {smallInfoMessage}', smallInfoMessage);
316
+ * ```
317
+ */
318
+ static smallInfo(message: string, ...optionalParams: any[]): void {
319
+ this.info(
320
+ this.h_small +
321
+ '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
322
+ '\n' + this.infoStyle + this.h_small
323
+ );
324
+ }
325
+ static readonly S_info = DyFM_Log.smallInfo;
326
+
327
+ /**
328
+ * Highlighted Tests an info message.
329
+ * @param message - The message to test.
330
+ * @param optionalParams - The optional parameters to test.
331
+ *
332
+ * @example
333
+ * ```ts
334
+ * DyFM_Log.testInfo('A test info message: {testInfoMessage}', testInfoMessage);
335
+ * ```
336
+ */
337
+ static testInfo(message: string, ...optionalParams: any[]): void {
338
+ this.info(
339
+ '\n' + this.h_test +
340
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
341
+ '\n\n' + this.infoStyle + this.h_test + '\n'
342
+ );
343
+ }
344
+ static readonly T_info = DyFM_Log.testInfo;
345
+
346
+ /**
347
+ * Logs a highlighted info message.
348
+ * @param message - The message to highlight.
349
+ * @param optionalParams - The optional parameters to highlight.
350
+ *
351
+ * @example
352
+ * ```ts
353
+ * DyFM_Log.highlightedInfo('A highlighted info message: {highlightedInfoMessage}', highlightedInfoMessage);
354
+ * ```
355
+ */
356
+ static highlightedInfo(message: string, ...optionalParams: any[]): void {
357
+ this.info(
358
+ '\n\n' + this.h_before +
359
+ '\n ' + this.h_before +
360
+ '\n ' + this.h_before +
361
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
362
+ '\n\n ' + this.infoStyle + this.h_after +
363
+ '\n ' + this.h_after +
364
+ '\n' + this.h_after + '\n\n'
365
+ );
366
+ }
367
+ static readonly H_info = DyFM_Log.highlightedInfo;
368
+
369
+ /**
370
+ * Logs a small Highlighted error message.
371
+ * @param message - The message to log.
372
+ * @param optionalParams - The optional parameters to log.
373
+ *
374
+ * @example
375
+ * ```ts
376
+ * DyFM_Log.smallError('A small error message: {smallErrorMessage}', smallErrorMessage);
377
+ * ```
378
+ */
379
+ static smallError(message: string, ...optionalParams: any[]): void {
380
+ this.error(
381
+ this.h_small +
382
+ '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
383
+ '\n' + this.errorStyle + this.h_small
384
+ );
385
+ }
386
+ static readonly S_error = DyFM_Log.smallError;
387
+
388
+ /**
389
+ * Highlighted Tests an error message.
390
+ * @param message - The message to test.
391
+ * @param optionalParams - The optional parameters to test.
392
+ *
393
+ * @example
394
+ * ```ts
395
+ * DyFM_Log.testError('A test error message: {testErrorMessage}', testErrorMessage);
396
+ * ```
397
+ */
398
+ static testError(message: string, ...optionalParams: any[]): void {
399
+ this.error(
400
+ '\n' + this.h_test +
401
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
402
+ '\n\n' + this.errorStyle + this.h_test + '\n'
403
+ );
404
+ }
405
+ static readonly T_error = DyFM_Log.testError;
406
+
407
+ /**
408
+ * Logs a highlighted error message.
409
+ * @param message - The message to highlight.
410
+ * @param optionalParams - The optional parameters to highlight.
411
+ *
412
+ * @example
413
+ * ```ts
414
+ * DyFM_Log.highlightedError('A highlighted error message: {highlightedErrorMessage}', highlightedErrorMessage);
415
+ * ```
416
+ */
417
+ static highlightedError(message: string, ...optionalParams: any[]): void {
418
+ this.error(
419
+ '\n\n' + this.h_before +
420
+ '\n ' + this.h_before +
421
+ '\n ' + this.h_before +
422
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
423
+ '\n\n ' + this.errorStyle + this.h_after +
424
+ '\n ' + this.h_after +
425
+ '\n' + this.h_after + '\n\n'
426
+ );
427
+ }
428
+ static readonly H_error = DyFM_Log.highlightedError;
429
+
430
+ /**
431
+ * Logs a small Highlighted warning message.
432
+ * @param message - The message to log.
433
+ * @param optionalParams - The optional parameters to log.
434
+ *
435
+ * @example
436
+ * ```ts
437
+ * DyFM_Log.smallWarn('A small warning message: {smallWarnMessage}', smallWarnMessage);
438
+ * ```
439
+ */
440
+ static smallWarn(message: string, ...optionalParams: any[]): void {
441
+ this.warn(
442
+ this.h_small +
443
+ '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
444
+ '\n' + this.warnStyle + this.h_small
445
+ );
446
+ }
447
+ static readonly S_warn = DyFM_Log.smallWarn;
448
+
449
+ /**
450
+ * Highlighted Tests a warning message.
451
+ * @param message - The message to test.
452
+ * @param optionalParams - The optional parameters to test.
453
+ *
454
+ * @example
455
+ * ```ts
456
+ * DyFM_Log.testWarn('A test warning message: {testWarnMessage}', testWarnMessage);
457
+ * ```
458
+ */
459
+ static testWarn(message: string, ...optionalParams: any[]): void {
460
+ this.warn(
461
+ '\n' + this.h_test +
462
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
463
+ '\n\n' + this.warnStyle + this.h_test + '\n'
464
+ );
465
+ }
466
+ static readonly T_warn = DyFM_Log.testWarn;
467
+
468
+ /**
469
+ * Logs a highlighted warning message.
470
+ * @param message - The message to highlight.
471
+ * @param optionalParams - The optional parameters to highlight.
472
+ *
473
+ * @example
474
+ * ```ts
475
+ * DyFM_Log.highlightedWarn('A highlighted warning message: {highlightedWarnMessage}', highlightedWarnMessage);
476
+ * ```
477
+ */
478
+ static highlightedWarn(message: string, ...optionalParams: any[]): void {
479
+ this.warn(
480
+ '\n\n' + this.h_before +
481
+ '\n ' + this.h_before +
482
+ '\n ' + this.h_before +
483
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
484
+ '\n\n ' + this.warnStyle + this.h_after +
485
+ '\n ' + this.h_after +
486
+ '\n' + this.h_after + '\n\n'
487
+ );
488
+ }
489
+ static readonly H_warn = DyFM_Log.highlightedWarn;
490
+
491
+ /**
492
+ * Logs a small success message.
493
+ * @param message - The message to log.
494
+ * @param optionalParams - The optional parameters to log.
495
+ *
496
+ * @example
497
+ * ```ts
498
+ * DyFM_Log.smallSuccess('A small success message: {smallSuccessMessage}', smallSuccessMessage);
499
+ * ```
500
+ */
501
+ static smallSuccess(message: string, ...optionalParams: any[]): void {
502
+ this.success(
503
+ this.h_small +
504
+ '\n ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
505
+ '\n' + this.successStyle + this.h_small
506
+ );
507
+ }
508
+ static readonly S_success = DyFM_Log.smallSuccess;
509
+
510
+ /**
511
+ * Tests a success message.
512
+ * @param message - The message to test.
513
+ * @param optionalParams - The optional parameters to test.
514
+ *
515
+ * @example
516
+ * ```ts
517
+ * DyFM_Log.testSuccess('A test success message: {testSuccessMessage}', testSuccessMessage);
518
+ * ```
519
+ */
520
+ static testSuccess(message: string, ...optionalParams: any[]): void {
521
+ this.success(
522
+ '\n' + this.h_test +
523
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
524
+ '\n\n' + this.successStyle + this.h_test + '\n'
525
+ );
526
+ }
527
+ static readonly T_success = DyFM_Log.testSuccess;
528
+
529
+ /**
530
+ * Logs a highlighted success message.
531
+ * @param message - The message to highlight.
532
+ * @param optionalParams - The optional parameters to highlight.
533
+ */
534
+ static highlightedSuccess(message: string, ...optionalParams: any[]): void {
535
+ this.success(
536
+ '\n\n' + this.h_before +
537
+ '\n ' + this.h_before +
538
+ '\n ' + this.h_before +
539
+ '\n\n ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
540
+ '\n\n ' + this.successStyle + this.h_after +
541
+ '\n ' + this.h_after +
542
+ '\n' + this.h_after + '\n\n'
543
+ );
544
+ }
545
+ static readonly H_success = DyFM_Log.highlightedSuccess;
546
+
547
+ /**
548
+ * Removes the log styles from a message.
549
+ * @param message - The message to remove the styles from.
550
+ * @returns The message without the styles.
551
+ */
552
+ static removeLogStyles(message: string): string {
553
+ for (const styleKey of DyFM_allLogStyles) {
554
+ message = message.replaceAll(styleKey, '');
555
+ }
556
+
557
+ return message;
558
+ }
559
+
560
+ /**
561
+ * Silences all logs.
562
+ *
563
+ * @example
564
+ * ```ts
565
+ * DyFM_Log.silenceLogs();
566
+ * ```
567
+ */
568
+ static silenceLogs(): void {
569
+ console.log = (): void => {};
570
+ }
571
+
572
+ /**
573
+ * Silences non-error logs.
574
+ *
575
+ * @example
576
+ * ```ts
577
+ * DyFM_Log.silenceNonErrorLogs();
578
+ * ```
579
+ */
580
+ static silenceNonErrorLogs(): void {
581
+ console.log = (): void => {};
582
+ console.info = (): void => {};
583
+ console.warn = (): void => {};
584
+ }
585
+
586
+ /**
587
+ * Silences all logs.
588
+ *
589
+ * @example
590
+ * ```ts
591
+ * DyFM_Log.silenceConsole();
592
+ * ```
593
+ */
594
+ static silenceConsole(): void {
595
+ console.log = (): void => {};
596
+ console.info = (): void => {};
597
+ console.warn = (): void => {};
598
+ console.error = (): void => {};
599
+ }
600
+
601
+ /**
602
+ * Adds breaks and tabs to the string parameters.
603
+ * @param params - The parameters to add the breaks and tabs to.
604
+ * @returns The parameters with the breaks and tabs added.
605
+ *
606
+ * @example
607
+ * ```ts
608
+ * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
609
+ * const result = DyFM_Log.addBreaksAndTabsToStringParams(params);
610
+ * console.log(result); // [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ]
611
+ * ```
612
+ */
613
+ static addBreaksAndTabsToStringParams(params: any[]): any[] {
614
+ return params.map((param: any): string => {
615
+ if (typeof param === 'string') {
616
+ return '\n ' + param;
617
+ }
618
+
619
+ return param;
620
+
621
+ });
622
+ }
623
+
624
+ /**
625
+ * Adds spaces for each line.
626
+ * @param message - The message to add the spaces to.
627
+ * @param spaces - The number of spaces to add.
628
+ * @returns The message with the spaces added.
629
+ *
630
+ * @example
631
+ * ```ts
632
+ * const message = 'Hello, world!\nHello, world!\nHello, world!';
633
+ * const result = DyFM_Log.addSpacesForEachLine(message, 2);
634
+ * console.log(result); // Hello, world! Hello, world! Hello, world!
635
+ * ```
636
+ */
637
+ static addSpacesForEachLine(message: string, spaces: number): string {
638
+ return message.replaceAll('\n', '\n' + ' '.repeat(spaces));
639
+ }
640
+ private static asfel = this.addSpacesForEachLine;
641
+
642
+ /**
643
+ * Adds spaces for each string optional parameter.
644
+ * @param params - The parameters to add the spaces to.
645
+ * @param spaces - The number of spaces to add.
646
+ * @returns The parameters with the spaces added.
647
+ *
648
+ * @example
649
+ * ```ts
650
+ * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
651
+ * const result = DyFM_Log.addSpacesForEachStringOptionalParam(params, 2);
652
+ * console.log(result); // [ 'Hello, world! Hello, world! Hello, world!' ]
653
+ * ```
654
+ */
655
+ static addSpacesForEachStringOptionalParam(params: any[], spaces: number): any[] {
656
+ return params.map((param: any): any => {
657
+ if (typeof param === 'string') {
658
+ return this.addSpacesForEachLine(param, spaces);
659
+ }
660
+
661
+ return param;
662
+
663
+ });
664
+ }
665
+ private static asfesop = this.addSpacesForEachStringOptionalParam;
666
+ }
667
+