@futdevpro/nts-dynamo 1.15.102 → 1.15.104

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 (371) hide show
  1. package/.c8rc.json +26 -26
  2. package/.copilot/patterns.json +7 -7
  3. package/.cursor/rules/__assistant_guide.mdc +30 -30
  4. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  5. package/.cursor/rules/_ag_backend.mdc +16 -16
  6. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  7. package/.cursor/rules/_ag_frontend.mdc +39 -39
  8. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  9. package/.cursor/rules/_ag_naming.mdc +115 -115
  10. package/.cursor/rules/_ag_should-be.mdc +6 -6
  11. package/.cursor/rules/ai_development_guide.md +60 -60
  12. package/.cursor/rules/cursor-rules.md +160 -160
  13. package/.cursor/rules/default-command.mdc +464 -464
  14. package/.cursor/rules/error_code_pattern.md +39 -39
  15. package/.cursor/rules/saved rule mcp server use.md +15 -15
  16. package/.dynamo/pipeline.cicd.config.json +3 -3
  17. package/.vscode/settings.json +10 -10
  18. package/HOWTO.md +15 -15
  19. package/LICENSE +21 -21
  20. package/__documentations/nts-integration-tests-2026-03-17.md +26 -26
  21. package/__documentations/plans/BEDROCK-HYPERPLAN.md +95 -95
  22. package/_specifications/BACKLOG.md +92 -92
  23. package/_specifications/TODO.md +15 -15
  24. package/_specifications/agent.md +138 -138
  25. package/build/_collections/client-safe-error.util.d.ts +9 -3
  26. package/build/_collections/client-safe-error.util.d.ts.map +1 -1
  27. package/build/_collections/client-safe-error.util.js +32 -3
  28. package/build/_collections/client-safe-error.util.js.map +1 -1
  29. package/eslint.config.js +3 -3
  30. package/nodemon.json +24 -24
  31. package/package.json +3 -3
  32. package/pnpm-workspace.yaml +5 -5
  33. package/scripts/run-coverage-tests.js +28 -28
  34. package/spec/support/helpers/spec-reporter-loader.js +359 -359
  35. package/spec/support/helpers/ts-node-helper.js +93 -93
  36. package/spec/support/jasmine.coverage.json +24 -24
  37. package/spec/support/jasmine.json +24 -24
  38. package/src/_collections/archive.util.spec.ts +57 -57
  39. package/src/_collections/archive.util.ts +18 -18
  40. package/src/_collections/atlas-default-db-options.const.ts +9 -9
  41. package/src/_collections/client-safe-error.util.spec.ts +58 -2
  42. package/src/_collections/client-safe-error.util.ts +38 -3
  43. package/src/_collections/default-fallback-cache-max-age.const.spec.ts +11 -11
  44. package/src/_collections/default-fallback-cache-max-age.const.ts +2 -2
  45. package/src/_collections/default-not-found-page.const.spec.ts +19 -19
  46. package/src/_collections/default-not-found-page.const.ts +22 -22
  47. package/src/_collections/default-socket-path.const.spec.ts +12 -12
  48. package/src/_collections/default-socket-path.const.ts +2 -2
  49. package/src/_collections/get-environment-settings.util.spec.ts +210 -210
  50. package/src/_collections/get-environment-settings.util.ts +48 -48
  51. package/src/_collections/global-settings.const.ts +126 -126
  52. package/src/_collections/sample.env +21 -21
  53. package/src/_collections/star.controller.spec.ts +224 -224
  54. package/src/_collections/star.controller.ts +129 -129
  55. package/src/_enums/data-model-type.enum.ts +14 -14
  56. package/src/_enums/data-service-function.enum.ts +24 -24
  57. package/src/_enums/predefined-data-types.enum.ts +16 -16
  58. package/src/_enums/route-security.enum.ts +12 -12
  59. package/src/_models/control-models/api-call-params.control-model.spec.ts +152 -152
  60. package/src/_models/control-models/api-call-params.control-model.ts +142 -142
  61. package/src/_models/control-models/app-ext-system-controls.control-model.spec.ts +52 -52
  62. package/src/_models/control-models/app-ext-system-controls.control-model.ts +9 -9
  63. package/src/_models/control-models/app-params.control-model.spec.ts +225 -225
  64. package/src/_models/control-models/app-params.control-model.ts +136 -136
  65. package/src/_models/control-models/app-system-controls.control-model.spec.ts +31 -31
  66. package/src/_models/control-models/app-system-controls.control-model.ts +9 -9
  67. package/src/_models/control-models/endpoint-params.control-model.spec.ts +669 -669
  68. package/src/_models/control-models/endpoint-params.control-model.ts +628 -628
  69. package/src/_models/control-models/http-settings.control-model.spec.ts +77 -77
  70. package/src/_models/control-models/http-settings.control-model.ts +37 -37
  71. package/src/_models/control-models/system-control.control-model.spec.ts +27 -27
  72. package/src/_models/control-models/system-control.control-model.ts +12 -12
  73. package/src/_models/interfaces/certification-settings.interface.ts +7 -7
  74. package/src/_models/interfaces/environment-settings.interface.ts +59 -59
  75. package/src/_models/interfaces/global-log-settings.interface.ts +171 -171
  76. package/src/_models/interfaces/global-service-settings.interface.ts +47 -47
  77. package/src/_models/interfaces/global-settings.interface.ts +286 -286
  78. package/src/_models/interfaces/routing-module-settings.interface.ts +21 -21
  79. package/src/_models/interfaces/static-client-settings.interface.spec.ts +29 -29
  80. package/src/_models/interfaces/static-client-settings.interface.ts +36 -36
  81. package/src/_models/types/db-update.type.ts +100 -100
  82. package/src/_modules/ai/_models/ai-input-interfaces.ts +117 -117
  83. package/src/_modules/ai/_models/ai-test-generation-result.interface.ts +16 -16
  84. package/src/_modules/ai/_modules/anthropic/_services/aai-user-key.control-service.ts +138 -138
  85. package/src/_modules/ai/_modules/anthropic/index.ts +5 -5
  86. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.spec.ts +242 -242
  87. package/src/_modules/ai/_modules/document-ai/_collections/dai-chunking.util.ts +639 -639
  88. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.spec.ts +295 -295
  89. package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts +518 -518
  90. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.spec.ts +209 -209
  91. package/src/_modules/ai/_modules/document-ai/_collections/dai-document.util.ts +85 -85
  92. package/src/_modules/ai/_modules/document-ai/_enums/dai-compare-result-type.enum.ts +7 -7
  93. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-chunk.data-model.ts +146 -146
  94. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-doc-page.data-model.ts +162 -162
  95. package/src/_modules/ai/_modules/document-ai/_models/data-models/dai-document.data-model.ts +99 -99
  96. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-code-chunk.interface.ts +68 -68
  97. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface.ts +18 -18
  98. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-doc-page-compare-result.interface.ts +19 -19
  99. package/src/_modules/ai/_modules/document-ai/_models/interfaces/dai-document-compare-result.interface.ts +25 -25
  100. package/src/_modules/ai/_modules/document-ai/index.ts +30 -30
  101. package/src/_modules/ai/_modules/fdp-ai/_services/fdpai-user-key.control-service.ts +189 -189
  102. package/src/_modules/ai/_modules/fdp-ai/index.ts +5 -5
  103. package/src/_modules/ai/_modules/open-ai/_collections/oai-global-settings.const.ts +9 -9
  104. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts +82 -82
  105. package/src/_modules/ai/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts +75 -75
  106. package/src/_modules/ai/_modules/open-ai/_enums/oai-gpt-message-role.enum.ts +45 -45
  107. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-global-settings.interface.ts +7 -7
  108. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-gpt-message.interface.ts +7 -7
  109. package/src/_modules/ai/_modules/open-ai/_models/interfaces/oai-llm-predefined-requests.interface.ts +57 -57
  110. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-doc-chunk-data.service.ts +292 -292
  111. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-document.data-service.spec.ts +342 -342
  112. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.spec.ts +550 -550
  113. package/src/_modules/ai/_modules/open-ai/_services/data-services/oai-vector-data.service.ts +630 -630
  114. package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts +332 -332
  115. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.spec.ts +462 -462
  116. package/src/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.ts +634 -634
  117. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.spec.ts +489 -489
  118. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.tools.spec.ts +173 -173
  119. package/src/_modules/ai/_modules/open-ai/_services/oai-llm.service-base.ts +1033 -1033
  120. package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts +157 -157
  121. package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts +115 -115
  122. package/src/_modules/ai/_services/ai-embedding-mock.service.ts +212 -212
  123. package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts +110 -110
  124. package/src/_modules/ai/_services/ai-embedding-provider.registry.ts +110 -110
  125. package/src/_modules/ai/_services/ai-embedding.service-base.spec.ts +98 -98
  126. package/src/_modules/ai/_services/ai-embedding.service-base.ts +48 -48
  127. package/src/_modules/ai/_services/ai-llm-chat.service-base.spec.ts +229 -229
  128. package/src/_modules/ai/_services/ai-llm-chat.service-base.ts +68 -68
  129. package/src/_modules/ai/_services/ai-llm.service-base.spec.ts +250 -250
  130. package/src/_modules/ai/_services/ai-llm.service-base.ts +519 -519
  131. package/src/_modules/ai/_services/ai-provider.service-base.spec.ts +158 -158
  132. package/src/_modules/ai/_services/ai-user-key.service-base.ts +59 -59
  133. package/src/_modules/ai/_services/lmstudio-embedding.control-service.spec.ts +197 -197
  134. package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts +371 -371
  135. package/src/_modules/ai/index.ts +23 -23
  136. package/src/_modules/assistant/_collections/ass-global-settings.const.ts +13 -13
  137. package/src/_modules/assistant/_collections/ass.util.spec.ts +176 -176
  138. package/src/_modules/assistant/_collections/ass.util.ts +50 -50
  139. package/src/_modules/assistant/_models/ass-global-settings.interface.ts +15 -15
  140. package/src/_modules/assistant/_services/ass-io.control-service.spec.ts +140 -140
  141. package/src/_modules/assistant/_services/ass-main.control-service.spec.ts +192 -192
  142. package/src/_modules/assistant/_services/ass-main.control-service.ts +107 -107
  143. package/src/_modules/bot/_collections/bot-default-commands.const.ts +12 -12
  144. package/src/_modules/bot/_collections/bot-global-settings.const.ts +39 -39
  145. package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts +62 -62
  146. package/src/_modules/bot/_models/bot-command.interface.ts +8 -8
  147. package/src/_modules/bot/_models/bot-global-settings.interface.ts +96 -96
  148. package/src/_modules/bot/_models/bot-last-mention-date.interface.ts +6 -6
  149. package/src/_modules/bot/_models/bot-last-message-date.interface.ts +5 -5
  150. package/src/_modules/bot/_models/bot-user-wrapper.interface.ts +41 -41
  151. package/src/_modules/bot/_modules/discord-bot/_models/dib-platform.types.ts +9 -9
  152. package/src/_modules/bot/_modules/discord-bot/_services/dib-messaging-provider.control-service.spec.ts +431 -431
  153. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.spec.ts +160 -160
  154. package/src/_modules/bot/_modules/dynamo-bot/_collections/dyb-operations.util.ts +55 -55
  155. package/src/_modules/bot/_modules/dynamo-bot/_models/dyb-platform.types.ts +15 -15
  156. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.spec.ts +374 -374
  157. package/src/_modules/bot/_modules/dynamo-bot/_services/dyb-messaging-provider.control-service.ts +447 -447
  158. package/src/_modules/bot/_modules/dynamo-bot/index.ts +15 -15
  159. package/src/_modules/bot/_modules/slack-bot/_models/slb-platform.types.ts +9 -9
  160. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.spec.ts +344 -344
  161. package/src/_modules/bot/_modules/slack-bot/_services/slb-messaging-provider.control-service.ts +197 -197
  162. package/src/_modules/bot/_modules/teams-bot/_models/teb-platform.types.ts +9 -9
  163. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.spec.ts +345 -345
  164. package/src/_modules/bot/_modules/teams-bot/_services/teb-messaging-provider.control-service.ts +197 -197
  165. package/src/_modules/bot/_services/bot-commands.control-service.spec.ts +116 -116
  166. package/src/_modules/bot/_services/bot-io.control-service.spec.ts +285 -285
  167. package/src/_modules/bot/_services/bot-main.control-service.spec.ts +208 -208
  168. package/src/_modules/bot/_services/bot-messaging-provider.service-base.spec.ts +349 -349
  169. package/src/_modules/bot/_services/bot-routines.control-service.spec.ts +111 -111
  170. package/src/_modules/custom-data/custom-data.controller.spec.ts +49 -49
  171. package/src/_modules/custom-data/custom-data.controller.ts +67 -67
  172. package/src/_modules/custom-data/custom-data.data-service.spec.ts +54 -54
  173. package/src/_modules/custom-data/custom-data.data-service.ts +21 -21
  174. package/src/_modules/custom-data/get-custom-data-routing-module.util.spec.ts +28 -28
  175. package/src/_modules/custom-data/get-custom-data-routing-module.util.ts +24 -24
  176. package/src/_modules/custom-data/index.ts +9 -9
  177. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts +161 -161
  178. package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.ts +203 -203
  179. package/src/_modules/data-readers/_models/interfaces/dynts-sqlite-reader.interface.ts +33 -33
  180. package/src/_modules/data-readers/index.ts +11 -11
  181. package/src/_modules/defaults/_collections/default-endpoints.util.ts +487 -487
  182. package/src/_modules/defaults/_models/default-user.data-model.ts +72 -72
  183. package/src/_modules/defaults/_services/default-auth.service.spec.ts +269 -269
  184. package/src/_modules/defaults/_services/default-auth.service.ts +177 -177
  185. package/src/_modules/defaults/_services/default-socket-events.service.spec.ts +42 -42
  186. package/src/_modules/defaults/_services/default-socket-events.service.ts +61 -61
  187. package/src/_modules/defaults/_services/default-user.data-service.spec.ts +187 -187
  188. package/src/_modules/defaults/_services/default-user.data-service.ts +98 -98
  189. package/src/_modules/defaults/index.ts +17 -17
  190. package/src/_modules/discord-assistant/_collections/dias-global-settings.const.ts +19 -19
  191. package/src/_modules/discord-assistant/_collections/dias.util.spec.ts +366 -366
  192. package/src/_modules/discord-assistant/_collections/dias.util.ts +132 -132
  193. package/src/_modules/discord-assistant/_models/dias-global-settings.interface.ts +19 -19
  194. package/src/_modules/discord-assistant/_models/dias-knowledge.data-model.ts +52 -52
  195. package/src/_modules/discord-assistant/_services/dias-chunk.data-service.ts +177 -177
  196. package/src/_modules/discord-assistant/_services/dias-io.control-service.spec.ts +108 -108
  197. package/src/_modules/discord-assistant/_services/dias-io.control-service.ts +69 -69
  198. package/src/_modules/discord-assistant/_services/dias-main.control-service.spec.ts +22 -22
  199. package/src/_modules/discord-assistant/_services/dias-main.control-service.ts +27 -27
  200. package/src/_modules/discord-assistant/_services/dias.service-base.spec.ts +195 -195
  201. package/src/_modules/discord-assistant/_services/dias.service-base.ts +76 -76
  202. package/src/_modules/discord-assistant/index.ts +38 -38
  203. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.spec.ts +34 -34
  204. package/src/_modules/discord-assistant-voiced/_services/dias-discord-bot.control-service.ts +11 -11
  205. package/src/_modules/discord-assistant-voiced/index.ts +36 -36
  206. package/src/_modules/discord-bot/_collections/dibo-default-commands.const.ts +16 -16
  207. package/src/_modules/discord-bot/_collections/dibo-global-settings.conts.ts +55 -55
  208. package/src/_modules/discord-bot/_collections/dibo-operations.util.spec.ts +214 -214
  209. package/src/_modules/discord-bot/_collections/dibo-operations.util.ts +387 -387
  210. package/src/_modules/discord-bot/_models/dibo-command.interface.ts +12 -12
  211. package/src/_modules/discord-bot/_models/dibo-global-settings.interface.ts +98 -98
  212. package/src/_modules/discord-bot/_models/dibo-last-mention-date.inteface.ts +7 -7
  213. package/src/_modules/discord-bot/_models/dibo-last-message-date.interface.ts +6 -6
  214. package/src/_modules/discord-bot/_services/dibo-commands.control-service.spec.ts +154 -154
  215. package/src/_modules/discord-bot/_services/dibo-commands.control-service.ts +153 -153
  216. package/src/_modules/discord-bot/_services/dibo-io.control-service.spec.ts +264 -264
  217. package/src/_modules/discord-bot/_services/dibo-io.control-service.ts +306 -306
  218. package/src/_modules/discord-bot/_services/dibo-main.control-service.spec.ts +408 -408
  219. package/src/_modules/discord-bot/_services/dibo-main.control-service.ts +487 -487
  220. package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts +105 -105
  221. package/src/_modules/discord-bot/index.ts +36 -36
  222. package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts +35 -35
  223. package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts +59 -59
  224. package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts +17 -17
  225. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.spec.ts +418 -418
  226. package/src/_modules/local-vector-search/_services/lvs-doc-chunk-data.service.ts +276 -276
  227. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.spec.ts +480 -480
  228. package/src/_modules/local-vector-search/_services/lvs-local-vector-search.data-service.ts +416 -416
  229. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.spec.ts +198 -198
  230. package/src/_modules/local-vector-search/_services/lvs-persistent-vector-pool.control-service.ts +146 -146
  231. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.spec.ts +167 -167
  232. package/src/_modules/local-vector-search/_services/lvs-vector-persist.data-service.ts +106 -106
  233. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.spec.ts +507 -507
  234. package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts +272 -272
  235. package/src/_modules/local-vector-search/index.ts +16 -16
  236. package/src/_modules/logs/index.ts +11 -11
  237. package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts +111 -111
  238. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts +142 -142
  239. package/src/_modules/mcp/_services/dynts-mcp-server.service-base.ts +120 -120
  240. package/src/_modules/mcp/_services/dynts-mcp.adapter.ts +168 -168
  241. package/src/_modules/mcp/index.ts +13 -13
  242. package/src/_modules/messaging/README.md +354 -354
  243. package/src/_modules/messaging/_collections/get-messaging-routing-module.util.ts +26 -26
  244. package/src/_modules/messaging/_collections/msg-global-settings.const.ts +22 -22
  245. package/src/_modules/messaging/_collections/msg.util.spec.ts +226 -226
  246. package/src/_modules/messaging/_models/msg-global-settings.interface.ts +37 -37
  247. package/src/_modules/messaging/_services/msg-conversation.data-service.ts +146 -146
  248. package/src/_modules/messaging/_services/msg-events.service.spec.ts +219 -219
  249. package/src/_modules/messaging/_services/msg-events.service.ts +267 -267
  250. package/src/_modules/messaging/_services/msg-integration.control-service.ts +179 -179
  251. package/src/_modules/messaging/_services/msg-main.control-service.spec.ts +147 -147
  252. package/src/_modules/messaging/_services/msg-main.control-service.ts +571 -571
  253. package/src/_modules/messaging/_services/msg-message.data-service.ts +129 -129
  254. package/src/_modules/messaging/_services/msg.controller.spec.ts +201 -201
  255. package/src/_modules/messaging/index.ts +30 -30
  256. package/src/_modules/mock/app-extended-server.mock.ts +201 -201
  257. package/src/_modules/mock/app-integration-test.mock.ts +51 -51
  258. package/src/_modules/mock/app-params.mock.spec.ts +21 -21
  259. package/src/_modules/mock/app-params.mock.ts +9 -9
  260. package/src/_modules/mock/app-server.mock.ts +188 -188
  261. package/src/_modules/mock/auth-service.mock.spec.ts +47 -47
  262. package/src/_modules/mock/auth-service.mock.ts +28 -28
  263. package/src/_modules/mock/controller.mock.spec.ts +26 -26
  264. package/src/_modules/mock/controller.mock.ts +16 -16
  265. package/src/_modules/mock/data-model.mock.spec.ts +111 -111
  266. package/src/_modules/mock/data-model.mock.ts +82 -82
  267. package/src/_modules/mock/email-service-collection.mock.spec.ts +24 -24
  268. package/src/_modules/mock/email-service-collection.mock.ts +15 -15
  269. package/src/_modules/mock/email-service.mock.spec.ts +17 -17
  270. package/src/_modules/mock/email-service.mock.ts +20 -20
  271. package/src/_modules/mock/email-template.mock.html +14 -14
  272. package/src/_modules/mock/endpoint.mock.ts +91 -91
  273. package/src/_modules/mock/socket-client.mock.spec.ts +40 -40
  274. package/src/_modules/mock/socket-client.mock.ts +45 -45
  275. package/src/_modules/mock/socket-server.mock.spec.ts +44 -44
  276. package/src/_modules/mock/socket-server.mock.ts +46 -46
  277. package/src/_modules/oauth2/_routes/oauth2.controller.spec.ts +107 -107
  278. package/src/_modules/oauth2/_routes/oauth2.controller.ts +98 -98
  279. package/src/_modules/oauth2/_services/oauth2.auth-service.spec.ts +254 -254
  280. package/src/_modules/oauth2/_services/oauth2.auth-service.ts +232 -232
  281. package/src/_modules/oauth2/_services/oauth2.control-service.spec.ts +585 -585
  282. package/src/_modules/oauth2/_services/oauth2.control-service.ts +653 -653
  283. package/src/_modules/oauth2/index.ts +17 -17
  284. package/src/_modules/scheduler/_models/scheduler-job.interface.ts +35 -35
  285. package/src/_modules/scheduler/get-scheduler-routing-module.util.ts +33 -33
  286. package/src/_modules/scheduler/index.ts +8 -8
  287. package/src/_modules/scheduler/scheduler.controller.spec.ts +42 -42
  288. package/src/_modules/scheduler/scheduler.controller.ts +69 -69
  289. package/src/_modules/scheduler/scheduler.service.spec.ts +141 -141
  290. package/src/_modules/scheduler/scheduler.service.ts +176 -176
  291. package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts +22 -22
  292. package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts +81 -81
  293. package/src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts +107 -107
  294. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.spec.ts +306 -306
  295. package/src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts +295 -295
  296. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.spec.ts +118 -118
  297. package/src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts +105 -105
  298. package/src/_modules/scoped-config/index.ts +17 -17
  299. package/src/_modules/server/errors/errors.control-service.spec.ts +238 -238
  300. package/src/_modules/server/errors/errors.control-service.ts +100 -100
  301. package/src/_modules/server/errors/errors.controller.spec.ts +268 -268
  302. package/src/_modules/server/errors/errors.controller.ts +515 -515
  303. package/src/_modules/server/errors/errors.data-service.spec.ts +480 -480
  304. package/src/_modules/server/index.ts +30 -30
  305. package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts +70 -70
  306. package/src/_modules/server/server-status/server-status-snapshot.control-service.ts +17 -17
  307. package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts +77 -77
  308. package/src/_modules/server/server-status/server-status-snapshot.data-service.ts +37 -37
  309. package/src/_modules/server/server-status/server-status.control-service.spec.ts +576 -576
  310. package/src/_modules/server/server-status/server-status.control-service.ts +396 -396
  311. package/src/_modules/server/server-status/server-status.controller.spec.ts +255 -255
  312. package/src/_modules/server/server-status/server-status.controller.ts +292 -292
  313. package/src/_modules/socket/_enums/socket-security.enum.ts +11 -11
  314. package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts +32 -32
  315. package/src/_modules/socket/_models/socket-client-service-params.control-model.ts +22 -22
  316. package/src/_modules/socket/_models/socket-presence.control-model.spec.ts +164 -164
  317. package/src/_modules/socket/_models/socket-presence.control-model.ts +210 -210
  318. package/src/_modules/socket/_models/socket-server-service-params.control-model.spec.ts +46 -46
  319. package/src/_modules/socket/_models/socket-server-service-params.control-model.ts +22 -22
  320. package/src/_modules/socket/_services/socket-client.service.spec.ts +15 -15
  321. package/src/_modules/socket/_services/socket-client.service.ts +260 -260
  322. package/src/_modules/socket/_services/socket-server.service.spec.ts +11 -11
  323. package/src/_modules/socket/app-extended.integration.spec.ts +85 -85
  324. package/src/_modules/socket/app-extended.server.ts +642 -642
  325. package/src/_modules/socket/index.ts +42 -42
  326. package/src/_modules/test/get-test-routing-module.util.spec.ts +28 -28
  327. package/src/_modules/test/get-test-routing-module.util.ts +23 -23
  328. package/src/_modules/test/index.ts +11 -11
  329. package/src/_modules/test/test.controller.spec.ts +72 -72
  330. package/src/_modules/test/test.controller.ts +115 -115
  331. package/src/_modules/usage/get-usage-routing-module.util.ts +22 -22
  332. package/src/_modules/usage/index.ts +15 -15
  333. package/src/_modules/usage/usage.controller.spec.ts +81 -81
  334. package/src/_modules/usage/usage.controller.ts +126 -126
  335. package/src/_modules/usage/usage.data-service.spec.ts +332 -332
  336. package/src/_modules/usage/usage.data-service.ts +185 -185
  337. package/src/_services/base/api.service-base.spec.ts +125 -125
  338. package/src/_services/base/api.service-base.ts +74 -74
  339. package/src/_services/base/archive-data.service.spec.ts +209 -209
  340. package/src/_services/base/archive-data.service.ts +223 -223
  341. package/src/_services/base/data.service.spec.ts +729 -729
  342. package/src/_services/base/data.service.ts +2758 -2758
  343. package/src/_services/base/db.service.spec.ts +160 -160
  344. package/src/_services/base/db.service.ts +1644 -1644
  345. package/src/_services/base/singleton.service-base.spec.ts +28 -28
  346. package/src/_services/base/singleton.service-base.ts +24 -24
  347. package/src/_services/base/singleton.service.spec.ts +114 -114
  348. package/src/_services/base/singleton.service.ts +38 -38
  349. package/src/_services/core/api.service.spec.ts +140 -140
  350. package/src/_services/core/auth.service.spec.ts +159 -159
  351. package/src/_services/core/auth.service.ts +174 -174
  352. package/src/_services/core/email.service.spec.ts +85 -85
  353. package/src/_services/core/email.service.ts +757 -757
  354. package/src/_services/core/global.service.spec.ts +292 -292
  355. package/src/_services/core/global.service.ts +487 -487
  356. package/src/_services/core/memory-guard.service.spec.ts +245 -245
  357. package/src/_services/core/memory-guard.service.ts +481 -481
  358. package/src/_services/core/service-collection.service.spec.ts +46 -46
  359. package/src/_services/core/service-collection.service.ts +6 -6
  360. package/src/_services/route/controller.service.spec.ts +53 -53
  361. package/src/_services/route/controller.service.ts +148 -148
  362. package/src/_services/route/routing-module.service.spec.ts +98 -98
  363. package/src/_services/route/routing-module.service.ts +330 -330
  364. package/src/_services/server/app.server.ts +1985 -1985
  365. package/src/_services/shared.static-service.spec.ts +99 -99
  366. package/src/_services/shared.static-service.ts +78 -78
  367. package/src/index.ts +100 -100
  368. package/tsconfig.app.json +12 -12
  369. package/tsconfig.json +42 -42
  370. package/.dynamo/logs/cicd-pipeline/output.log +0 -2855
  371. package/.dynamo/logs/cicd-pipeline/status.json +0 -74
@@ -1,45 +1,45 @@
1
- ---
2
- description: import formatting rules
3
- alwaysApply: false
4
- ---
5
- # Import Rules and Format [FDP-Dev-import]
6
-
7
- ## Overview
8
- This document outlines the standard import rules and formatting for FDP projects.
9
-
10
- ## Import Order
11
- 1. Angular Core imports (@angular/*)
12
- 2. External imports (packages)
13
- 3. FDP imports (@futdevpro/*)
14
- 4. Shared imports (from shared modules)
15
- 5. Internal imports (local)
16
-
17
- ## Format Example
18
- ```typescript
19
- import { Component, OnInit } from '@angular/core';
20
- import { Observable } from 'rxjs';
21
- import { MatDialog } from '@angular/material/dialog';
22
-
23
- import { DyFM_Log } from '@futdevpro/fsm-dynamo';
24
- import { FDP_User } from '@futdevpro/fdp-templates';
25
-
26
- import { SharedModule } from '../../_modules/shared/shared.module';
27
-
28
- import { FirstModule } from '../first/first.module';
29
- import { SecondModule } from './second.module';
30
- ```
31
-
32
- ## Rules
33
- 1. Use spaces between import groups
34
- 2. Use relative imports within the application
35
- 3. Group imports by their source/type
36
- 4. Order internal imports by relative path distance (bottom-up)
37
- 5. Keep imports clean and organized
38
- 6. Remove unused imports
39
-
40
- ## Best Practices
41
- - Use explicit imports rather than wildcards
42
- - Keep imports alphabetically sorted within their groups
43
- - Use relative paths for internal imports
44
- - Use absolute paths for package imports
1
+ ---
2
+ description: import formatting rules
3
+ alwaysApply: false
4
+ ---
5
+ # Import Rules and Format [FDP-Dev-import]
6
+
7
+ ## Overview
8
+ This document outlines the standard import rules and formatting for FDP projects.
9
+
10
+ ## Import Order
11
+ 1. Angular Core imports (@angular/*)
12
+ 2. External imports (packages)
13
+ 3. FDP imports (@futdevpro/*)
14
+ 4. Shared imports (from shared modules)
15
+ 5. Internal imports (local)
16
+
17
+ ## Format Example
18
+ ```typescript
19
+ import { Component, OnInit } from '@angular/core';
20
+ import { Observable } from 'rxjs';
21
+ import { MatDialog } from '@angular/material/dialog';
22
+
23
+ import { DyFM_Log } from '@futdevpro/fsm-dynamo';
24
+ import { FDP_User } from '@futdevpro/fdp-templates';
25
+
26
+ import { SharedModule } from '../../_modules/shared/shared.module';
27
+
28
+ import { FirstModule } from '../first/first.module';
29
+ import { SecondModule } from './second.module';
30
+ ```
31
+
32
+ ## Rules
33
+ 1. Use spaces between import groups
34
+ 2. Use relative imports within the application
35
+ 3. Group imports by their source/type
36
+ 4. Order internal imports by relative path distance (bottom-up)
37
+ 5. Keep imports clean and organized
38
+ 6. Remove unused imports
39
+
40
+ ## Best Practices
41
+ - Use explicit imports rather than wildcards
42
+ - Keep imports alphabetically sorted within their groups
43
+ - Use relative paths for internal imports
44
+ - Use absolute paths for package imports
45
45
  - Remove any duplicate imports
@@ -1,116 +1,116 @@
1
- ---
2
- description: when naming new- elements, classes and else.
3
- alwaysApply: false
4
- ---
5
- # FDP Naming Conventions [FDP-Dev-Naming]
6
-
7
- ## Overview
8
- This document outlines the standard naming conventions for FDP projects.
9
-
10
- ## General Rules
11
- - Use PascalCase for:
12
- - Classes
13
- - Interfaces
14
- - Types
15
- - Enums
16
- - Use camelCase for:
17
- - Variables
18
- - Constants
19
- - Methods
20
- - Use descriptive, meaningful names
21
-
22
- ## Module Prefixes
23
- - Each element must be prefixed with its module's 2-3 letter identifier
24
- - Helps with:
25
- - Navigation
26
- - Module identification
27
- - Preventing naming conflicts
28
- - Example: `FE_Page_Component` for FlowEditor module
29
-
30
- ## Element Types
31
- Format: Element Name (File Pattern) -> Class Postfix
32
-
33
- ### Model Elements
34
- #### Basic Models
35
- - Data Model (*.data-model.ts) -> _DataModel
36
- - Control Model (*.control-model.ts) -> _ControlModel
37
- - Interface (*.interface.ts) -> _Interface
38
-
39
- #### Special Models
40
- - Params (*-params.control-model.ts) -> _Params_ControlModel
41
- - Settings (*-settings.control-model.ts) -> _Settings_ControlModel
42
- - Settings Constants (*-settings.const.ts) -> _settings_const
43
- - Data Params (DyFM_DataModel_Params in *.data-model.ts) -> _DataModel_Params
44
-
45
- ### FullStack Elements
46
- - Type (*.type-enum.ts) -> _Type
47
- - ServiceBase (*.service-base.ts) -> _ServiceBase
48
- - ControlService (*.control-service.ts) -> _ControlService
49
- - ApiService (*.api-service.ts) -> _ApiService
50
-
51
- ### Frontend Elements
52
- - Module (*.module.ts) -> _Module
53
- - RoutingModule (*.routing-module.ts) -> _RoutingModule
54
- - DataService (*.data-service.ts) -> _DataService
55
- - Component (*.component.ts) -> _Component
56
- - Directive (*.directive.ts) -> _Directive
57
- - Pipe (*.pipe.ts) -> _Pipe
58
- - Route (*.route-enum.ts) -> _Route
59
- - FullRoute (in route-enum file) -> _FullRoute
60
- - CSS classes: kebab-case
61
- - CSS variables: --kebab-case
62
- - Event handlers: handleEventName
63
- - Boolean variables: is prefix only (e.g., isActive, isEnabled)
64
-
65
- ### Backend Elements
66
- - Controller (*.controller.ts) -> _Controller
67
- - DataService (*.data-service.ts) -> _DataService
68
- - SocketServerService (*.socket-server-service.ts) -> _SocketServerService
69
- - SocketClientService (*.socket-client-service.ts) -> _SocketClientService
70
- - EmailService (*.email-service.ts) -> _EmailService
71
-
72
- ## File Naming
73
- - One class per file
74
- - File name matches class name
75
- - Test files: class-name.spec.ts
76
- - Interface files: interface-name.interface.ts
77
- - Type files: type-name.type.ts
78
-
79
- ## Naming Examples
80
- ```typescript
81
- // Module
82
- jóska-pista.module.ts -> JóskaPista_Module
83
-
84
- // Routing Module
85
- jóska-pista.routing-module.ts -> JóskaPista_RoutingModule
86
-
87
- // Services
88
- jp-vlmi.api-service.ts -> JP_Vlmi_ApiService
89
- jp-vlmi.data-service.ts -> JP_Vlmi_DataService
90
- jp-vlmi.control-service.ts -> JP_Vlmi_ControlService
91
- jp-vlmi.service-base.ts -> JP_Vlmi_ServiceBase
92
-
93
- // Models
94
- jp-vlmi.data-model.ts -> JP_Vlmi_DataModel
95
- jp-vlmi.control-model.ts -> JP_Vlmi_ControlModel
96
- jp-vlmi.interface.ts -> JP_Vlmi_Interface
97
- jp-vlmi-params.control-model.ts -> JP_Vlmi_Params_ControlModel
98
- jp-vlmi-settings.control-model.ts -> JP_Vlmi_Settings_ControlModel
99
- jp-vlmi-settings.const.ts -> JP_vlmi_settings_const
100
-
101
- // Enums
102
- jp-vlmi.type-enum.ts -> JP_Vlmi_Type
103
- jp-vlmi.route-enum.ts -> JP_Vlmi_Route
104
-
105
- // Frontend Specific
106
- handleUserClick() // Event handler
107
- isUserActive // Boolean variable
108
- .user-profile // CSS class
109
- --primary-color // CSS variable
110
- ```
111
-
112
- ## File Structure
113
- - Module elements should be in the module's directory
114
- - Shared elements should be in the shared module
115
- - Use appropriate type folders (_services, _components, etc.)
1
+ ---
2
+ description: when naming new- elements, classes and else.
3
+ alwaysApply: false
4
+ ---
5
+ # FDP Naming Conventions [FDP-Dev-Naming]
6
+
7
+ ## Overview
8
+ This document outlines the standard naming conventions for FDP projects.
9
+
10
+ ## General Rules
11
+ - Use PascalCase for:
12
+ - Classes
13
+ - Interfaces
14
+ - Types
15
+ - Enums
16
+ - Use camelCase for:
17
+ - Variables
18
+ - Constants
19
+ - Methods
20
+ - Use descriptive, meaningful names
21
+
22
+ ## Module Prefixes
23
+ - Each element must be prefixed with its module's 2-3 letter identifier
24
+ - Helps with:
25
+ - Navigation
26
+ - Module identification
27
+ - Preventing naming conflicts
28
+ - Example: `FE_Page_Component` for FlowEditor module
29
+
30
+ ## Element Types
31
+ Format: Element Name (File Pattern) -> Class Postfix
32
+
33
+ ### Model Elements
34
+ #### Basic Models
35
+ - Data Model (*.data-model.ts) -> _DataModel
36
+ - Control Model (*.control-model.ts) -> _ControlModel
37
+ - Interface (*.interface.ts) -> _Interface
38
+
39
+ #### Special Models
40
+ - Params (*-params.control-model.ts) -> _Params_ControlModel
41
+ - Settings (*-settings.control-model.ts) -> _Settings_ControlModel
42
+ - Settings Constants (*-settings.const.ts) -> _settings_const
43
+ - Data Params (DyFM_DataModel_Params in *.data-model.ts) -> _DataModel_Params
44
+
45
+ ### FullStack Elements
46
+ - Type (*.type-enum.ts) -> _Type
47
+ - ServiceBase (*.service-base.ts) -> _ServiceBase
48
+ - ControlService (*.control-service.ts) -> _ControlService
49
+ - ApiService (*.api-service.ts) -> _ApiService
50
+
51
+ ### Frontend Elements
52
+ - Module (*.module.ts) -> _Module
53
+ - RoutingModule (*.routing-module.ts) -> _RoutingModule
54
+ - DataService (*.data-service.ts) -> _DataService
55
+ - Component (*.component.ts) -> _Component
56
+ - Directive (*.directive.ts) -> _Directive
57
+ - Pipe (*.pipe.ts) -> _Pipe
58
+ - Route (*.route-enum.ts) -> _Route
59
+ - FullRoute (in route-enum file) -> _FullRoute
60
+ - CSS classes: kebab-case
61
+ - CSS variables: --kebab-case
62
+ - Event handlers: handleEventName
63
+ - Boolean variables: is prefix only (e.g., isActive, isEnabled)
64
+
65
+ ### Backend Elements
66
+ - Controller (*.controller.ts) -> _Controller
67
+ - DataService (*.data-service.ts) -> _DataService
68
+ - SocketServerService (*.socket-server-service.ts) -> _SocketServerService
69
+ - SocketClientService (*.socket-client-service.ts) -> _SocketClientService
70
+ - EmailService (*.email-service.ts) -> _EmailService
71
+
72
+ ## File Naming
73
+ - One class per file
74
+ - File name matches class name
75
+ - Test files: class-name.spec.ts
76
+ - Interface files: interface-name.interface.ts
77
+ - Type files: type-name.type.ts
78
+
79
+ ## Naming Examples
80
+ ```typescript
81
+ // Module
82
+ jóska-pista.module.ts -> JóskaPista_Module
83
+
84
+ // Routing Module
85
+ jóska-pista.routing-module.ts -> JóskaPista_RoutingModule
86
+
87
+ // Services
88
+ jp-vlmi.api-service.ts -> JP_Vlmi_ApiService
89
+ jp-vlmi.data-service.ts -> JP_Vlmi_DataService
90
+ jp-vlmi.control-service.ts -> JP_Vlmi_ControlService
91
+ jp-vlmi.service-base.ts -> JP_Vlmi_ServiceBase
92
+
93
+ // Models
94
+ jp-vlmi.data-model.ts -> JP_Vlmi_DataModel
95
+ jp-vlmi.control-model.ts -> JP_Vlmi_ControlModel
96
+ jp-vlmi.interface.ts -> JP_Vlmi_Interface
97
+ jp-vlmi-params.control-model.ts -> JP_Vlmi_Params_ControlModel
98
+ jp-vlmi-settings.control-model.ts -> JP_Vlmi_Settings_ControlModel
99
+ jp-vlmi-settings.const.ts -> JP_vlmi_settings_const
100
+
101
+ // Enums
102
+ jp-vlmi.type-enum.ts -> JP_Vlmi_Type
103
+ jp-vlmi.route-enum.ts -> JP_Vlmi_Route
104
+
105
+ // Frontend Specific
106
+ handleUserClick() // Event handler
107
+ isUserActive // Boolean variable
108
+ .user-profile // CSS class
109
+ --primary-color // CSS variable
110
+ ```
111
+
112
+ ## File Structure
113
+ - Module elements should be in the module's directory
114
+ - Shared elements should be in the shared module
115
+ - Use appropriate type folders (_services, _components, etc.)
116
116
  - Follow the project structure guidelines for placement
@@ -1,7 +1,7 @@
1
- ---
2
- description: Apply if the user states a "it should do/work like this/that"
3
- alwaysApply: false
4
- ---
5
-
6
- # Global planning and execution policy
1
+ ---
2
+ description: Apply if the user states a "it should do/work like this/that"
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Global planning and execution policy
7
7
  - mindig amikor a user olyat vagy olyasmit, mond, hogy "ennek úgy kéne működnie, hogy ..." annak bele kell kerülni a specifikációba
@@ -1,61 +1,61 @@
1
- # AI Development Guide
2
-
3
- ## Language Requirements
4
- - Write all code in English
5
- - Write all logs in English
6
- - Write all code documentation in Hungarian
7
- - Write all comments in Hungarian
8
- - Write all error messages in English
9
-
10
- ## Core Rules
11
- - Read and follow naming conventions (see [Naming Conventions](naming.md))
12
- - Use explicit type definitions (avoid automatic type inference)
13
- - Implement proper error handling
14
- - Never write logics into getters, getters should be only mappers
15
- - If the task is complex, or need includes many subject members, do it one by one
16
-
17
- ## Code Structure
18
- - One class/function per file
19
- - Clear file organization
20
- - Consistent import order
21
- - No circular dependencies
22
- - Proper separation of concerns
23
-
24
- ## Error Handling
25
- - Use try-catch blocks
26
- - Log all errors in English
27
- - Provide meaningful error messages in English
28
- - Handle edge cases
29
- - Validate inputs
30
-
31
- ## Testing Requirements
32
- - Unit tests for all functions
33
- - Integration tests for features
34
- - Test edge cases
35
- - Maintain test coverage
36
- - Mock external dependencies
37
-
38
- ## Documentation
39
- - Hungarian comments and documentation
40
- - JSDoc for functions in Hungarian
41
- - Clear parameter descriptions in Hungarian
42
- - Usage examples in Hungarian
43
- - Update docs with changes
44
-
45
- ## Best Practices
46
- - DRY (Don't Repeat Yourself)
47
- - SOLID principles
48
- - Clean code practices
49
- - Performance optimization
50
- - Security considerations
51
-
52
- ## Project-Specific Guidelines
53
- - Only for Frontend Development: Read [Frontend Guidelines](frontend.md)
54
- - Only for Backend Development: Read [Backend Guidelines](backend.md)
55
-
56
- ## Refactor
57
- - All files length should be under 300 lines
58
- - For files over 300 lines, mark it with "// [TOO LONG FILE]"
59
-
60
- ## Format
1
+ # AI Development Guide
2
+
3
+ ## Language Requirements
4
+ - Write all code in English
5
+ - Write all logs in English
6
+ - Write all code documentation in Hungarian
7
+ - Write all comments in Hungarian
8
+ - Write all error messages in English
9
+
10
+ ## Core Rules
11
+ - Read and follow naming conventions (see [Naming Conventions](naming.md))
12
+ - Use explicit type definitions (avoid automatic type inference)
13
+ - Implement proper error handling
14
+ - Never write logics into getters, getters should be only mappers
15
+ - If the task is complex, or need includes many subject members, do it one by one
16
+
17
+ ## Code Structure
18
+ - One class/function per file
19
+ - Clear file organization
20
+ - Consistent import order
21
+ - No circular dependencies
22
+ - Proper separation of concerns
23
+
24
+ ## Error Handling
25
+ - Use try-catch blocks
26
+ - Log all errors in English
27
+ - Provide meaningful error messages in English
28
+ - Handle edge cases
29
+ - Validate inputs
30
+
31
+ ## Testing Requirements
32
+ - Unit tests for all functions
33
+ - Integration tests for features
34
+ - Test edge cases
35
+ - Maintain test coverage
36
+ - Mock external dependencies
37
+
38
+ ## Documentation
39
+ - Hungarian comments and documentation
40
+ - JSDoc for functions in Hungarian
41
+ - Clear parameter descriptions in Hungarian
42
+ - Usage examples in Hungarian
43
+ - Update docs with changes
44
+
45
+ ## Best Practices
46
+ - DRY (Don't Repeat Yourself)
47
+ - SOLID principles
48
+ - Clean code practices
49
+ - Performance optimization
50
+ - Security considerations
51
+
52
+ ## Project-Specific Guidelines
53
+ - Only for Frontend Development: Read [Frontend Guidelines](frontend.md)
54
+ - Only for Backend Development: Read [Backend Guidelines](backend.md)
55
+
56
+ ## Refactor
57
+ - All files length should be under 300 lines
58
+ - For files over 300 lines, mark it with "// [TOO LONG FILE]"
59
+
60
+ ## Format
61
61
  - Break long lines, use lint project's rules