@adaptivestone/framework 5.0.0-beta.9 → 5.0.0-rc.1

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 (370) hide show
  1. package/LICENCE +1 -1
  2. package/README.md +66 -2
  3. package/dist/Cli.d.ts +7 -0
  4. package/dist/Cli.js +19 -0
  5. package/dist/Cli.js.map +1 -0
  6. package/dist/cluster.d.ts +1 -0
  7. package/dist/cluster.js +67 -0
  8. package/dist/cluster.js.map +1 -0
  9. package/dist/codegen/appTypes.d.ts +19 -0
  10. package/dist/codegen/appTypes.js +126 -0
  11. package/dist/codegen/appTypes.js.map +1 -0
  12. package/dist/codegen/astEmit.d.ts +53 -0
  13. package/dist/codegen/astEmit.js +242 -0
  14. package/dist/codegen/astEmit.js.map +1 -0
  15. package/dist/codegen/astExtract.d.ts +78 -0
  16. package/dist/codegen/astExtract.js +539 -0
  17. package/dist/codegen/astExtract.js.map +1 -0
  18. package/dist/codegen/astModel.d.ts +14 -0
  19. package/dist/codegen/astModel.js +73 -0
  20. package/dist/codegen/astModel.js.map +1 -0
  21. package/dist/codegen/astResolve.d.ts +53 -0
  22. package/dist/codegen/astResolve.js +276 -0
  23. package/dist/codegen/astResolve.js.map +1 -0
  24. package/dist/codegen/astSpec.d.ts +25 -0
  25. package/dist/codegen/astSpec.js +63 -0
  26. package/dist/codegen/astSpec.js.map +1 -0
  27. package/dist/codegen/collectMetadata.d.ts +39 -0
  28. package/dist/codegen/collectMetadata.js +7 -0
  29. package/dist/codegen/collectMetadata.js.map +1 -0
  30. package/dist/codegen/emit.d.ts +30 -0
  31. package/dist/codegen/emit.js +213 -0
  32. package/dist/codegen/emit.js.map +1 -0
  33. package/dist/codegen/index.d.ts +30 -0
  34. package/dist/codegen/index.js +76 -0
  35. package/dist/codegen/index.js.map +1 -0
  36. package/dist/codegen/paths.d.ts +9 -0
  37. package/dist/codegen/paths.js +25 -0
  38. package/dist/codegen/paths.js.map +1 -0
  39. package/dist/commands/CreateUser.d.ts +32 -0
  40. package/dist/commands/CreateUser.js +85 -0
  41. package/dist/commands/CreateUser.js.map +1 -0
  42. package/dist/commands/DropIndex.d.ts +16 -0
  43. package/dist/commands/DropIndex.js +30 -0
  44. package/dist/commands/DropIndex.js.map +1 -0
  45. package/dist/commands/GenerateRandomBytes.d.ts +7 -0
  46. package/dist/commands/GenerateRandomBytes.js +18 -0
  47. package/dist/commands/GenerateRandomBytes.js.map +1 -0
  48. package/dist/commands/GenerateTypes.d.ts +13 -0
  49. package/dist/commands/GenerateTypes.js +34 -0
  50. package/dist/commands/GenerateTypes.js.map +1 -0
  51. package/dist/commands/SyncIndexes.d.ts +6 -0
  52. package/dist/commands/SyncIndexes.js +31 -0
  53. package/dist/commands/SyncIndexes.js.map +1 -0
  54. package/dist/commands/migration/Create.d.ts +18 -0
  55. package/dist/commands/migration/Create.js +57 -0
  56. package/dist/commands/migration/Create.js.map +1 -0
  57. package/dist/commands/migration/Migrate.d.ts +6 -0
  58. package/dist/commands/migration/Migrate.js +73 -0
  59. package/dist/commands/migration/Migrate.js.map +1 -0
  60. package/dist/config/auth.d.ts +11 -0
  61. package/dist/config/auth.js +18 -0
  62. package/dist/config/auth.js.map +1 -0
  63. package/dist/config/http.d.ts +22 -0
  64. package/dist/config/http.js +40 -0
  65. package/dist/config/http.js.map +1 -0
  66. package/dist/config/i18n.d.ts +13 -0
  67. package/dist/config/i18n.js +13 -0
  68. package/dist/config/i18n.js.map +1 -0
  69. package/dist/config/ipDetector.d.ts +5 -0
  70. package/dist/config/ipDetector.js +15 -0
  71. package/dist/config/ipDetector.js.map +1 -0
  72. package/dist/config/log.d.ts +11 -0
  73. package/dist/config/log.js +21 -0
  74. package/dist/config/log.js.map +1 -0
  75. package/dist/config/mongo.d.ts +4 -0
  76. package/dist/config/mongo.js +4 -0
  77. package/dist/config/mongo.js.map +1 -0
  78. package/dist/config/rateLimiter.d.ts +13 -0
  79. package/dist/config/rateLimiter.js +17 -0
  80. package/dist/config/rateLimiter.js.map +1 -0
  81. package/dist/config/redis.d.ts +5 -0
  82. package/dist/config/redis.js +5 -0
  83. package/dist/config/redis.js.map +1 -0
  84. package/dist/controllers/Auth.d.ts +59 -0
  85. package/dist/controllers/Auth.js +356 -0
  86. package/dist/controllers/Auth.js.map +1 -0
  87. package/dist/controllers/Auth.routes.gen.d.ts +57 -0
  88. package/dist/controllers/Auth.routes.gen.js +10 -0
  89. package/dist/controllers/Auth.routes.gen.js.map +1 -0
  90. package/dist/controllers/Home.d.ts +14 -0
  91. package/dist/controllers/Home.js +26 -0
  92. package/dist/controllers/Home.js.map +1 -0
  93. package/dist/controllers/Home.routes.gen.d.ts +13 -0
  94. package/dist/controllers/Home.routes.gen.js +10 -0
  95. package/dist/controllers/Home.routes.gen.js.map +1 -0
  96. package/dist/controllers/index.d.ts +107 -0
  97. package/dist/controllers/index.js +548 -0
  98. package/dist/controllers/index.js.map +1 -0
  99. package/dist/folderConfig.d.ts +34 -0
  100. package/dist/folderConfig.js +14 -0
  101. package/dist/folderConfig.js.map +1 -0
  102. package/dist/helpers/appInstance.d.ts +10 -0
  103. package/dist/helpers/appInstance.js +19 -0
  104. package/dist/helpers/appInstance.js.map +1 -0
  105. package/dist/helpers/crypto.d.ts +26 -0
  106. package/dist/helpers/crypto.js +160 -0
  107. package/dist/helpers/crypto.js.map +1 -0
  108. package/dist/helpers/deprecation.d.ts +8 -0
  109. package/dist/helpers/deprecation.js +19 -0
  110. package/dist/helpers/deprecation.js.map +1 -0
  111. package/dist/helpers/env.d.ts +8 -0
  112. package/dist/helpers/env.js +15 -0
  113. package/dist/helpers/env.js.map +1 -0
  114. package/dist/helpers/files.d.ts +16 -0
  115. package/dist/helpers/files.js +83 -0
  116. package/dist/helpers/files.js.map +1 -0
  117. package/dist/helpers/logger.d.ts +6 -0
  118. package/dist/helpers/logger.js +34 -0
  119. package/dist/helpers/logger.js.map +1 -0
  120. package/dist/helpers/redis/clearNamespace.d.ts +10 -0
  121. package/dist/helpers/redis/clearNamespace.js +31 -0
  122. package/dist/helpers/redis/clearNamespace.js.map +1 -0
  123. package/dist/helpers/redis/redisConnection.d.ts +8 -0
  124. package/dist/helpers/redis/redisConnection.js +63 -0
  125. package/dist/helpers/redis/redisConnection.js.map +1 -0
  126. package/dist/helpers/yup.d.ts +22 -0
  127. package/dist/helpers/yup.js +39 -0
  128. package/dist/helpers/yup.js.map +1 -0
  129. package/dist/index.d.ts +1 -0
  130. package/dist/index.js +8 -0
  131. package/dist/index.js.map +1 -0
  132. package/{locales → dist/locales}/en/translation.json +5 -0
  133. package/{locales → dist/locales}/ru/translation.json +5 -0
  134. package/dist/models/KeyValue.d.ts +22 -0
  135. package/dist/models/KeyValue.js +17 -0
  136. package/dist/models/KeyValue.js.map +1 -0
  137. package/dist/models/Lock.d.ts +99 -0
  138. package/dist/models/Lock.js +123 -0
  139. package/dist/models/Lock.js.map +1 -0
  140. package/dist/models/Migration.d.ts +13 -0
  141. package/dist/models/Migration.js +14 -0
  142. package/dist/models/Migration.js.map +1 -0
  143. package/dist/models/Sequence.d.ts +28 -0
  144. package/dist/models/Sequence.js +31 -0
  145. package/dist/models/Sequence.js.map +1 -0
  146. package/dist/models/User.d.ts +769 -0
  147. package/dist/models/User.js +336 -0
  148. package/dist/models/User.js.map +1 -0
  149. package/dist/models/UserOld.d.ts +191 -0
  150. package/dist/models/UserOld.js +231 -0
  151. package/dist/models/UserOld.js.map +1 -0
  152. package/dist/modules/AbstractCommand.d.ts +51 -0
  153. package/dist/modules/AbstractCommand.js +60 -0
  154. package/dist/modules/AbstractCommand.js.map +1 -0
  155. package/dist/modules/AbstractConnector.d.ts +5 -0
  156. package/dist/modules/AbstractConnector.js +8 -0
  157. package/dist/modules/AbstractConnector.js.map +1 -0
  158. package/dist/modules/AbstractController.d.ts +99 -0
  159. package/dist/modules/AbstractController.js +83 -0
  160. package/dist/modules/AbstractController.js.map +1 -0
  161. package/dist/modules/AbstractModel.d.ts +29 -0
  162. package/dist/modules/AbstractModel.js +42 -0
  163. package/dist/modules/AbstractModel.js.map +1 -0
  164. package/dist/modules/Base.d.ts +29 -0
  165. package/dist/modules/Base.js +62 -0
  166. package/dist/modules/Base.js.map +1 -0
  167. package/dist/modules/BaseCli.d.ts +25 -0
  168. package/dist/modules/BaseCli.js +159 -0
  169. package/dist/modules/BaseCli.js.map +1 -0
  170. package/dist/modules/BaseModel.d.ts +57 -0
  171. package/dist/modules/BaseModel.js +37 -0
  172. package/dist/modules/BaseModel.js.map +1 -0
  173. package/dist/server.d.ts +130 -0
  174. package/dist/server.js +603 -0
  175. package/dist/server.js.map +1 -0
  176. package/dist/services/cache/Cache.d.ts +31 -0
  177. package/dist/services/cache/Cache.js +146 -0
  178. package/dist/services/cache/Cache.js.map +1 -0
  179. package/dist/services/http/HttpServer.d.ts +46 -0
  180. package/dist/services/http/HttpServer.js +114 -0
  181. package/dist/services/http/HttpServer.js.map +1 -0
  182. package/dist/services/http/files.d.ts +18 -0
  183. package/dist/services/http/files.js +19 -0
  184. package/dist/services/http/files.js.map +1 -0
  185. package/dist/services/http/middleware/AbstractMiddleware.d.ts +58 -0
  186. package/dist/services/http/middleware/AbstractMiddleware.js +73 -0
  187. package/dist/services/http/middleware/AbstractMiddleware.js.map +1 -0
  188. package/dist/services/http/middleware/Auth.d.ts +22 -0
  189. package/dist/services/http/middleware/Auth.js +30 -0
  190. package/dist/services/http/middleware/Auth.js.map +1 -0
  191. package/dist/services/http/middleware/Cors.d.ts +12 -0
  192. package/dist/services/http/middleware/Cors.js +45 -0
  193. package/dist/services/http/middleware/Cors.js.map +1 -0
  194. package/dist/services/http/middleware/GetUserByToken.d.ts +36 -0
  195. package/dist/services/http/middleware/GetUserByToken.js +59 -0
  196. package/dist/services/http/middleware/GetUserByToken.js.map +1 -0
  197. package/dist/services/http/middleware/I18n.d.ts +23 -0
  198. package/dist/services/http/middleware/I18n.js +61 -0
  199. package/dist/services/http/middleware/I18n.js.map +1 -0
  200. package/dist/services/http/middleware/IpDetector.d.ts +14 -0
  201. package/dist/services/http/middleware/IpDetector.js +80 -0
  202. package/dist/services/http/middleware/IpDetector.js.map +1 -0
  203. package/dist/services/http/middleware/Pagination.d.ts +26 -0
  204. package/dist/services/http/middleware/Pagination.js +70 -0
  205. package/dist/services/http/middleware/Pagination.js.map +1 -0
  206. package/dist/services/http/middleware/PrepareAppInfo.d.ts +8 -0
  207. package/dist/services/http/middleware/PrepareAppInfo.js +17 -0
  208. package/dist/services/http/middleware/PrepareAppInfo.js.map +1 -0
  209. package/dist/services/http/middleware/RateLimiter.d.ts +31 -0
  210. package/dist/services/http/middleware/RateLimiter.js +118 -0
  211. package/dist/services/http/middleware/RateLimiter.js.map +1 -0
  212. package/dist/services/http/middleware/RequestLogger.d.ts +8 -0
  213. package/dist/services/http/middleware/RequestLogger.js +20 -0
  214. package/dist/services/http/middleware/RequestLogger.js.map +1 -0
  215. package/dist/services/http/middleware/RequestParser.d.ts +15 -0
  216. package/dist/services/http/middleware/RequestParser.js +112 -0
  217. package/dist/services/http/middleware/RequestParser.js.map +1 -0
  218. package/dist/services/http/middleware/Role.d.ts +12 -0
  219. package/dist/services/http/middleware/Role.js +27 -0
  220. package/dist/services/http/middleware/Role.js.map +1 -0
  221. package/dist/services/http/routing/ExpressAdapter.d.ts +12 -0
  222. package/dist/services/http/routing/ExpressAdapter.js +95 -0
  223. package/dist/services/http/routing/ExpressAdapter.js.map +1 -0
  224. package/dist/services/http/routing/RouteNode.d.ts +105 -0
  225. package/dist/services/http/routing/RouteNode.js +21 -0
  226. package/dist/services/http/routing/RouteNode.js.map +1 -0
  227. package/dist/services/http/routing/RouteRegistry.d.ts +37 -0
  228. package/dist/services/http/routing/RouteRegistry.js +244 -0
  229. package/dist/services/http/routing/RouteRegistry.js.map +1 -0
  230. package/dist/services/http/routing/formatTree.d.ts +23 -0
  231. package/dist/services/http/routing/formatTree.js +159 -0
  232. package/dist/services/http/routing/formatTree.js.map +1 -0
  233. package/dist/services/http/routing/match.d.ts +31 -0
  234. package/dist/services/http/routing/match.js +164 -0
  235. package/dist/services/http/routing/match.js.map +1 -0
  236. package/dist/services/http/routing/middlewareNormalization.d.ts +11 -0
  237. package/dist/services/http/routing/middlewareNormalization.js +23 -0
  238. package/dist/services/http/routing/middlewareNormalization.js.map +1 -0
  239. package/dist/services/http/types.d.ts +74 -0
  240. package/dist/services/http/types.js +8 -0
  241. package/dist/services/http/types.js.map +1 -0
  242. package/dist/services/i18n/I18n.d.ts +15 -0
  243. package/dist/services/i18n/I18n.js +58 -0
  244. package/dist/services/i18n/I18n.js.map +1 -0
  245. package/dist/services/logging/SentryTransport.d.ts +13 -0
  246. package/dist/services/logging/SentryTransport.js +134 -0
  247. package/dist/services/logging/SentryTransport.js.map +1 -0
  248. package/dist/services/validate/ValidateService.d.ts +54 -0
  249. package/dist/services/validate/ValidateService.js +144 -0
  250. package/dist/services/validate/ValidateService.js.map +1 -0
  251. package/dist/services/validate/ValidationError.d.ts +35 -0
  252. package/dist/services/validate/ValidationError.js +90 -0
  253. package/dist/services/validate/ValidationError.js.map +1 -0
  254. package/dist/services/validate/contentType.d.ts +18 -0
  255. package/dist/services/validate/contentType.js +30 -0
  256. package/dist/services/validate/contentType.js.map +1 -0
  257. package/dist/services/validate/defineSchema.d.ts +23 -0
  258. package/dist/services/validate/defineSchema.js +25 -0
  259. package/dist/services/validate/defineSchema.js.map +1 -0
  260. package/dist/services/validate/drivers/StandardSchemaDriver.d.ts +15 -0
  261. package/dist/services/validate/drivers/StandardSchemaDriver.js +38 -0
  262. package/dist/services/validate/drivers/StandardSchemaDriver.js.map +1 -0
  263. package/dist/services/validate/drivers/YupDriver.d.ts +21 -0
  264. package/dist/services/validate/drivers/YupDriver.js +81 -0
  265. package/dist/services/validate/drivers/YupDriver.js.map +1 -0
  266. package/dist/services/validate/types.d.ts +104 -0
  267. package/dist/services/validate/types.js +11 -0
  268. package/dist/services/validate/types.js.map +1 -0
  269. package/dist/tests/frameworkVitestSetup.d.ts +1 -0
  270. package/dist/tests/frameworkVitestSetup.js +9 -0
  271. package/dist/tests/frameworkVitestSetup.js.map +1 -0
  272. package/dist/tests/globalSetupVitest.d.ts +3 -0
  273. package/dist/tests/globalSetupVitest.js +29 -0
  274. package/dist/tests/globalSetupVitest.js.map +1 -0
  275. package/dist/tests/setupVitest.d.ts +1 -0
  276. package/dist/tests/setupVitest.js +101 -0
  277. package/dist/tests/setupVitest.js.map +1 -0
  278. package/dist/tests/testHelpers.d.ts +361 -0
  279. package/dist/tests/testHelpers.js +48 -0
  280. package/dist/tests/testHelpers.js.map +1 -0
  281. package/dist/types.d.ts +4 -0
  282. package/dist/types.js +5 -0
  283. package/dist/types.js.map +1 -0
  284. package/package.json +83 -39
  285. package/.env.example +0 -18
  286. package/CHANGELOG.md +0 -956
  287. package/Cli.js +0 -21
  288. package/cluster.js +0 -25
  289. package/commands/CreateUser.js +0 -106
  290. package/commands/Documentation.js +0 -17
  291. package/commands/DropIndex.js +0 -38
  292. package/commands/GenerateRandomBytes.js +0 -21
  293. package/commands/GetOpenApiJson.js +0 -336
  294. package/commands/SyncIndexes.js +0 -40
  295. package/commands/migration/Create.js +0 -72
  296. package/commands/migration/Migrate.js +0 -56
  297. package/config/auth.js +0 -9
  298. package/config/http.js +0 -9
  299. package/config/i18n.js +0 -12
  300. package/config/ipDetector.js +0 -14
  301. package/config/log.js +0 -22
  302. package/config/mongo.js +0 -3
  303. package/config/rateLimiter.js +0 -16
  304. package/config/redis.js +0 -4
  305. package/config/validate.js +0 -3
  306. package/controllers/Auth.js +0 -201
  307. package/controllers/Home.js +0 -28
  308. package/controllers/index.js +0 -60
  309. package/eslint.config.js +0 -68
  310. package/folderConfig.js +0 -13
  311. package/helpers/files.js +0 -76
  312. package/helpers/logger.js +0 -16
  313. package/helpers/redis/clearNamespace.js +0 -14
  314. package/helpers/yup.js +0 -22
  315. package/index.js +0 -8
  316. package/jsconfig.json +0 -9
  317. package/models/Lock.js +0 -107
  318. package/models/Migration.js +0 -15
  319. package/models/Sequence.js +0 -22
  320. package/models/User.js +0 -280
  321. package/modules/AbstractCommand.js +0 -52
  322. package/modules/AbstractConnector.js +0 -9
  323. package/modules/AbstractController.js +0 -406
  324. package/modules/AbstractModel.d.ts +0 -48
  325. package/modules/AbstractModel.js +0 -92
  326. package/modules/Base.d.ts +0 -37
  327. package/modules/Base.js +0 -64
  328. package/modules/BaseCli.js +0 -157
  329. package/server.d.ts +0 -100
  330. package/server.js +0 -439
  331. package/services/cache/Cache.d.ts +0 -35
  332. package/services/cache/Cache.js +0 -124
  333. package/services/documentation/DocumentationGenerator.js +0 -169
  334. package/services/http/HttpServer.js +0 -89
  335. package/services/http/middleware/AbstractMiddleware.js +0 -51
  336. package/services/http/middleware/Auth.js +0 -20
  337. package/services/http/middleware/Cors.js +0 -46
  338. package/services/http/middleware/GetUserByToken.js +0 -47
  339. package/services/http/middleware/I18n.js +0 -117
  340. package/services/http/middleware/IpDetector.js +0 -59
  341. package/services/http/middleware/Pagination.js +0 -57
  342. package/services/http/middleware/PrepareAppInfo.js +0 -18
  343. package/services/http/middleware/RateLimiter.js +0 -134
  344. package/services/http/middleware/RequestLogger.js +0 -22
  345. package/services/http/middleware/RequestParser.js +0 -40
  346. package/services/http/middleware/Role.js +0 -29
  347. package/services/messaging/email/templates/.gitkeep +0 -0
  348. package/services/validate/ValidateService.js +0 -157
  349. package/services/validate/drivers/AbstractValidator.js +0 -37
  350. package/services/validate/drivers/CustomValidator.js +0 -51
  351. package/services/validate/drivers/YupValidator.js +0 -103
  352. package/tests/globalSetupVitest.js +0 -35
  353. package/tests/setup.js +0 -120
  354. package/tests/setupVitest.js +0 -111
  355. package/types/Expand.d.ts +0 -11
  356. package/types/ICommandArguments.d.ts +0 -41
  357. package/types/TFoldersConfig.d.ts +0 -20
  358. package/views/404.pug +0 -3
  359. package/views/home.pug +0 -3
  360. package/views/layouts/base.pug +0 -39
  361. package/vitest.config.js +0 -17
  362. /package/{commands → dist/migrations}/.gitkeep +0 -0
  363. /package/{services → dist/services}/messaging/email/resources/.gitkeep +0 -0
  364. /package/{migrations → dist/services/messaging/email/templates}/.gitkeep +0 -0
  365. /package/{services → dist/services}/messaging/email/templates/recovery/html.pug +0 -0
  366. /package/{services → dist/services}/messaging/email/templates/recovery/subject.pug +0 -0
  367. /package/{services → dist/services}/messaging/email/templates/recovery/text.pug +0 -0
  368. /package/{services → dist/services}/messaging/email/templates/verification/html.pug +0 -0
  369. /package/{services → dist/services}/messaging/email/templates/verification/subject.pug +0 -0
  370. /package/{services → dist/services}/messaging/email/templates/verification/text.pug +0 -0
@@ -0,0 +1,112 @@
1
+ import { unlink } from 'node:fs/promises';
2
+ import formidable from 'formidable';
3
+ import AbstractMiddleware from "./AbstractMiddleware.js";
4
+ /**
5
+ * Parses multipart / urlencoded / json request bodies (via formidable) into
6
+ * `req.body`. Size and count limits come from `config.http.requestParser`
7
+ * (explicit per-mount params override them). Spooled upload temp files are
8
+ * unlinked once the response finishes — a handler that needs to keep an upload
9
+ * MUST move or copy it (e.g. `fs.rename`) before responding.
10
+ */
11
+ class RequestParser extends AbstractMiddleware {
12
+ static get description() {
13
+ return 'Parses incoming request. Based on Formidable library';
14
+ }
15
+ async middleware(req, res, next) {
16
+ const time = Date.now();
17
+ this.logger?.verbose(`Parsing request`);
18
+ const { requestParser } = this.app.getConfig('http');
19
+ // Config defaults bound unauthenticated uploads; explicit per-mount params win.
20
+ const parserOptions = { ...requestParser, ...this.params };
21
+ const form = formidable(parserOptions); // not in construstor as reuse formidable affects performance
22
+ // formidable enforces `maxFieldsSize` only for MULTIPART field data — its
23
+ // JSON and urlencoded parsers buffer the whole body with no cap. Apply the
24
+ // same field-data ceiling to those bodies so a large unauthenticated request
25
+ // can't exhaust process memory. Multipart keeps formidable's own per-file /
26
+ // per-field caps.
27
+ const isMultipart = String(req.headers?.['content-type'] ?? '').includes('multipart/form-data');
28
+ const maxBodySize = typeof parserOptions.maxFieldsSize === 'number'
29
+ ? parserOptions.maxFieldsSize
30
+ : 2 * 1024 * 1024;
31
+ let bodyTooLarge = false;
32
+ if (!isMultipart) {
33
+ const declaredLength = Number(req.headers?.['content-length']);
34
+ if (Number.isFinite(declaredLength) && declaredLength > maxBodySize) {
35
+ this.logger?.error(`Request body ${declaredLength}B exceeds maxFieldsSize ${maxBodySize}B`);
36
+ return res.status(413).json({
37
+ message: 'Request entity too large. Your upload exceeds the allowed size or count limits.',
38
+ });
39
+ }
40
+ // Guard the streaming path too (chunked / absent Content-Length): abort as
41
+ // soon as the running byte count crosses the ceiling.
42
+ form.on('progress', (bytesReceived) => {
43
+ if (bytesReceived > maxBodySize) {
44
+ bodyTooLarge = true;
45
+ req.destroy();
46
+ }
47
+ });
48
+ }
49
+ // Track every temp file formidable opens (via fileBegin, so a file that
50
+ // later errors mid-write is tracked too) and unlink them once the response
51
+ // is done — on 'finish' (success) and 'close' (aborted). Without this,
52
+ // spooled files accumulate in the temp dir forever → disk exhaustion.
53
+ const openedFiles = [];
54
+ form.on('fileBegin', (_name, file) => {
55
+ openedFiles.push(file);
56
+ });
57
+ let cleaned = false;
58
+ const cleanup = () => {
59
+ if (cleaned) {
60
+ return;
61
+ }
62
+ cleaned = true;
63
+ for (const file of openedFiles) {
64
+ unlink(file.filepath).catch(() => { });
65
+ }
66
+ };
67
+ res.once('finish', cleanup);
68
+ res.once('close', cleanup);
69
+ let fields;
70
+ let files;
71
+ try {
72
+ [fields, files] = await form.parse(req);
73
+ }
74
+ catch (err) {
75
+ this.logger?.error(`Parsing failed ${err}`);
76
+ // formidable tags limit-exceeded errors (file/field size, file/field
77
+ // count) with httpCode 413; our own JSON/urlencoded body-size guard sets
78
+ // `bodyTooLarge`. Everything else (bad content type / length) stays a 400.
79
+ if (bodyTooLarge || err?.httpCode === 413) {
80
+ return res.status(413).json({
81
+ message: 'Request entity too large. Your upload exceeds the allowed size or count limits.',
82
+ });
83
+ }
84
+ return res.status(400).json({
85
+ message: `Error to parse your request. You provided invalid content type or content-length. Please check your request headers and content type.`,
86
+ });
87
+ }
88
+ this.logger?.verbose(`Parsing multipart/formdata request DONE ${Date.now() - time}ms`);
89
+ // formidable wraps multipart/urlencoded fields in arrays (one entry per
90
+ // occurrence) while json keeps the parsed shape. Collapse single-element
91
+ // arrays for the array-wrapping types so a single value lands as a scalar
92
+ // (matching json) — fixes consumers like GetUserByToken that do
93
+ // `token.replace(...)`. Repeated keys stay arrays; json is left untouched;
94
+ // files are not normalized.
95
+ const arrayWrapped = form.type === 'multipart' ||
96
+ form.type === 'urlencoded';
97
+ const normalizedFields = arrayWrapped
98
+ ? Object.fromEntries(Object.entries(fields).map(([key, value]) => Array.isArray(value) && value.length === 1
99
+ ? [key, value[0]]
100
+ : [key, value]))
101
+ : fields;
102
+ req.body = {
103
+ // todo avoid body in next versions
104
+ ...(req.body || {}),
105
+ ...normalizedFields,
106
+ ...files,
107
+ };
108
+ return next();
109
+ }
110
+ }
111
+ export default RequestParser;
112
+ //# sourceMappingURL=RequestParser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RequestParser.js","sourceRoot":"","sources":["../../../../src/services/http/middleware/RequestParser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { NextFunction, Response } from 'express';
2
+ import type { TUser } from '../../../models/User.ts';
3
+ import type { FrameworkRequest } from '../HttpServer.ts';
4
+ import AbstractMiddleware from './AbstractMiddleware.ts';
5
+ import type { GetUserByTokenAppInfo } from './GetUserByToken.ts';
6
+ declare class RoleMiddleware extends AbstractMiddleware {
7
+ static get description(): string;
8
+ middleware(req: FrameworkRequest & GetUserByTokenAppInfo & {
9
+ user: InstanceType<TUser>;
10
+ }, res: Response, next: NextFunction): Promise<void | Response<any, Record<string, any>>>;
11
+ }
12
+ export default RoleMiddleware;
@@ -0,0 +1,27 @@
1
+ import AbstractMiddleware from "./AbstractMiddleware.js";
2
+ class RoleMiddleware extends AbstractMiddleware {
3
+ static get description() {
4
+ return 'Check user role (user.roles property). If the user has no role then stop request and return error. OR logic (any role will pass user)';
5
+ }
6
+ async middleware(req, res, next) {
7
+ const { user } = req.appInfo;
8
+ if (!user) {
9
+ return res.status(401).json({ message: 'User should be provided' });
10
+ }
11
+ // Guard against `Role` being mounted without a `roles` param: treat a
12
+ // missing list as "no role grants access" (fail closed) instead of throwing.
13
+ const allowedRoles = this.params?.roles ?? [];
14
+ let hasRole = false;
15
+ user.roles?.forEach((role) => {
16
+ if (allowedRoles.includes(role)) {
17
+ hasRole = true;
18
+ }
19
+ });
20
+ if (!hasRole) {
21
+ return res.status(403).json({ message: 'You do not have access' });
22
+ }
23
+ return next();
24
+ }
25
+ }
26
+ export default RoleMiddleware;
27
+ //# sourceMappingURL=Role.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../../src/services/http/middleware/Role.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AAGzD,MAAM,cAAe,SAAQ,kBAAkB;IAC7C,MAAM,KAAK,WAAW;QACpB,OAAO,uIAAuI,CAAC;IACjJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GACuD,EACvD,GAAa,EACb,IAAkB;QAElB,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QAE7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,sEAAsE;QACtE,6EAA6E;QAC7E,MAAM,YAAY,GAAI,IAAI,CAAC,MAAM,EAAE,KAAuB,IAAI,EAAE,CAAC;QACjE,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAY,EAAE,EAAE;YACnC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;CACF;AAED,eAAe,cAAc,CAAC"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Single-mount adapter. Mount once via `app.express.use(createExpressAdapter(registry, app))`.
3
+ * Dispatches each request through the registry: match → walk middlewares → call handler.
4
+ *
5
+ * Middleware instances are cached by `MiddlewareEntry` identity (WeakMap)
6
+ * — each entry is constructed once on first request and reused thereafter.
7
+ */
8
+ import type { NextFunction, Request, Response } from 'express';
9
+ import type { IApp } from '../../../server.ts';
10
+ import type { RouteRegistry } from './RouteRegistry.ts';
11
+ export type ExpressAdapter = (req: Request, res: Response, next: NextFunction) => Promise<void>;
12
+ export declare function createExpressAdapter(registry: RouteRegistry, app: IApp): ExpressAdapter;
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Single-mount adapter. Mount once via `app.express.use(createExpressAdapter(registry, app))`.
3
+ * Dispatches each request through the registry: match → walk middlewares → call handler.
4
+ *
5
+ * Middleware instances are cached by `MiddlewareEntry` identity (WeakMap)
6
+ * — each entry is constructed once on first request and reused thereafter.
7
+ */
8
+ import { MalformedPathError } from "./match.js";
9
+ const instanceCache = new WeakMap();
10
+ export function createExpressAdapter(registry, app) {
11
+ return async function dispatch(req, res, next) {
12
+ let result;
13
+ try {
14
+ result = registry.match(req.method, req.path);
15
+ }
16
+ catch (err) {
17
+ if (err instanceof MalformedPathError) {
18
+ res.status(400).json({ message: 'Malformed URL' });
19
+ return;
20
+ }
21
+ return next(err);
22
+ }
23
+ if (!result) {
24
+ // 404 — let downstream Express middleware (notFoundHandler) decide.
25
+ return next();
26
+ }
27
+ if (result.entry === null) {
28
+ // 405 — path matched, method didn't.
29
+ res.setHeader('Allow', result.allowedMethods.join(', '));
30
+ res.status(405).json({ message: 'Method not allowed' });
31
+ return;
32
+ }
33
+ // Populate request with match metadata before middleware runs.
34
+ req.params = result.params;
35
+ // biome-ignore lint/suspicious/noExplicitAny: routeMeta is a runtime extension on req
36
+ req.routeMeta = {
37
+ bodyParsing: result.bodyParsing,
38
+ ...(result.entry.meta ?? {}),
39
+ };
40
+ try {
41
+ for (const mwEntry of result.middlewares) {
42
+ await runMiddleware(app, mwEntry, req, res);
43
+ // Stop if the response finished (writableEnded) OR the client aborted
44
+ // (destroyed) — no point running the rest of the chain on a dead socket.
45
+ if (res.writableEnded || res.destroyed) {
46
+ return;
47
+ }
48
+ }
49
+ await Promise.resolve(result.entry.handler(req, res, next));
50
+ }
51
+ catch (err) {
52
+ next(err);
53
+ }
54
+ };
55
+ }
56
+ /**
57
+ * Run one middleware entry and resolve when it either calls `next()`,
58
+ * ends the response, or throws.
59
+ */
60
+ function runMiddleware(app, entry, req, res) {
61
+ let instance = instanceCache.get(entry);
62
+ if (!instance) {
63
+ // Default params to `{}` — matches legacy `parseMiddlewares` behavior
64
+ // and prevents middlewares that destructure `this.params` from crashing.
65
+ instance = new entry.Class(app, entry.params ?? {});
66
+ instanceCache.set(entry, instance);
67
+ }
68
+ return new Promise((resolve, reject) => {
69
+ let resolved = false;
70
+ const settle = (err) => {
71
+ if (resolved) {
72
+ return;
73
+ }
74
+ resolved = true;
75
+ res.off('finish', onFinish);
76
+ res.off('close', onClose);
77
+ if (err) {
78
+ reject(err instanceof Error ? err : new Error(String(err)));
79
+ }
80
+ else {
81
+ resolve();
82
+ }
83
+ };
84
+ const onFinish = () => settle();
85
+ const onClose = () => settle();
86
+ res.once('finish', onFinish);
87
+ res.once('close', onClose);
88
+ // Cast: AbstractMiddleware.middleware expects FrameworkRequest, we
89
+ // pass Express's Request. They're shape-compatible at runtime.
90
+ Promise.resolve(
91
+ // biome-ignore lint/suspicious/noExplicitAny: bridging Express → framework request shape
92
+ instance.middleware(req, res, settle)).catch(settle);
93
+ });
94
+ }
95
+ //# sourceMappingURL=ExpressAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExpressAdapter.js","sourceRoot":"","sources":["../../../../src/services/http/routing/ExpressAdapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Tree-based routing primitives. Types only.
3
+ *
4
+ * Internal segment syntax: `':name'` for single-segment params, `'*name'`
5
+ * for splats. Translation layer converts user-facing path syntax to this
6
+ * shape.
7
+ */
8
+ import type { RequestContentTypeMap } from '../../validate/contentType.ts';
9
+ import type { StandardSchemaV1 } from '../../validate/types.ts';
10
+ import type AbstractMiddleware from '../middleware/AbstractMiddleware.ts';
11
+ /**
12
+ * HTTP methods, upper-case. Single source of truth for the framework;
13
+ * the runtime const + the `HttpMethod` type derive from this one array.
14
+ */
15
+ export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
16
+ export type HttpMethod = (typeof HTTP_METHODS)[number];
17
+ /**
18
+ * Body parsing mode per route.
19
+ *
20
+ * - `'parsed'` (default): Content-Type-aware parser dispatch. **The only mode
21
+ * that takes effect today.**
22
+ *
23
+ * `'raw'` and `'none'` are **reserved and not yet implemented** (planned for
24
+ * v5.1). The matcher resolves and propagates the mode, but the request pipeline
25
+ * does not act on it: `RequestParser` is mounted globally, so every body is
26
+ * parsed regardless — `req.rawBody` is never set and the stream is always
27
+ * consumed. Do not rely on them until v5.1 (the parser-registry design lives in
28
+ * the refactor plans).
29
+ *
30
+ * - `'raw'` *(v5.1)*: capture bytes into `req.rawBody: Buffer`, skip parsing.
31
+ * - `'none'` *(v5.1)*: pass-through, leave the request stream untouched.
32
+ */
33
+ export type BodyParsingMode = 'parsed' | 'raw' | 'none';
34
+ /**
35
+ * Canonical middleware shape stored in the registry. The `[Class, params]`
36
+ * tuple shorthand is normalized to this struct at the boundary
37
+ * (`middlewareNormalization.ts`).
38
+ */
39
+ export interface MiddlewareEntry {
40
+ Class: typeof AbstractMiddleware;
41
+ params?: Record<string, unknown>;
42
+ }
43
+ /**
44
+ * Per-method handler entry. `meta` carries fields codegen uses
45
+ * (`<MethodName>Request` alias) and observability uses (`code.filepath`,
46
+ * `code.function`).
47
+ */
48
+ export interface HandlerEntry {
49
+ handler: Function;
50
+ request?: StandardSchemaV1 | RequestContentTypeMap;
51
+ query?: StandardSchemaV1;
52
+ middlewares?: MiddlewareEntry[];
53
+ bodyParsing?: BodyParsingMode;
54
+ paramNames?: string[];
55
+ meta?: {
56
+ methodName?: string;
57
+ controllerClass?: string;
58
+ sourceFile?: string;
59
+ };
60
+ }
61
+ /**
62
+ * Tree node. Walked at request time: enter → run middlewares → descend.
63
+ *
64
+ * Specificity is structural: static `children` first, then `paramChild`,
65
+ * then `splatChild`. At most one `paramChild` and one `splatChild` per
66
+ * node. Different HTTP methods may use different param names at the same
67
+ * position — each handler carries its own `paramNames` array.
68
+ */
69
+ export interface RouteNode {
70
+ segment: string;
71
+ middlewares: MiddlewareEntry[];
72
+ methods?: Partial<Record<HttpMethod, HandlerEntry>>;
73
+ children: Map<string, RouteNode>;
74
+ paramChild?: RouteNode;
75
+ splatChild?: RouteNode;
76
+ bodyParsing?: BodyParsingMode;
77
+ meta?: {
78
+ sourceFile?: string;
79
+ controllerClass?: string;
80
+ };
81
+ }
82
+ /**
83
+ * Match outcome:
84
+ * - `entry !== null` → success; adapter runs middlewares then handler.
85
+ * - `entry === null` → path matched a node but the method didn't (405);
86
+ * adapter sets `Allow: <allowedMethods>`. `middlewares` still holds the
87
+ * accumulated path chain — adapter chooses whether to run them.
88
+ *
89
+ * `match()` returns `null` when nothing matches (404).
90
+ */
91
+ export interface MatchResult {
92
+ entry: HandlerEntry | null;
93
+ allowedMethods: HttpMethod[];
94
+ middlewares: MiddlewareEntry[];
95
+ params: Record<string, string>;
96
+ bodyParsing: BodyParsingMode;
97
+ }
98
+ /** One entry per (method, full-path) leaf — produced by `flatten()`. */
99
+ export interface FlatRoute {
100
+ method: HttpMethod;
101
+ path: string;
102
+ entry: HandlerEntry;
103
+ middlewares: MiddlewareEntry[];
104
+ bodyParsing: BodyParsingMode;
105
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Tree-based routing primitives. Types only.
3
+ *
4
+ * Internal segment syntax: `':name'` for single-segment params, `'*name'`
5
+ * for splats. Translation layer converts user-facing path syntax to this
6
+ * shape.
7
+ */
8
+ /**
9
+ * HTTP methods, upper-case. Single source of truth for the framework;
10
+ * the runtime const + the `HttpMethod` type derive from this one array.
11
+ */
12
+ export const HTTP_METHODS = [
13
+ 'GET',
14
+ 'POST',
15
+ 'PUT',
16
+ 'PATCH',
17
+ 'DELETE',
18
+ 'HEAD',
19
+ 'OPTIONS',
20
+ ];
21
+ //# sourceMappingURL=RouteNode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RouteNode.js","sourceRoot":"","sources":["../../../../src/services/http/routing/RouteNode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;CACD,CAAC"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Global route tree. One instance per app, lives on `app.routeRegistry`.
3
+ *
4
+ * Producers (controllers, ad-hoc routes) register subtrees here. Consumers
5
+ * (the runtime adapter, codegen, OpenAPI / MCP emitters) walk it.
6
+ */
7
+ import type { FlatRoute, HandlerEntry, HttpMethod, MatchResult, RouteNode } from './RouteNode.ts';
8
+ /** Construct an empty node with the given segment. */
9
+ export declare function createNode(segment: string): RouteNode;
10
+ export declare class RouteRegistry {
11
+ readonly root: RouteNode;
12
+ /**
13
+ * Mount a subtree at a path prefix. Intermediate nodes are created;
14
+ * existing ones are merged (middlewares appended, methods added,
15
+ * children recursively merged). Conflicting handlers throw.
16
+ *
17
+ * The subtree's root `segment` is metadata only — its CONTENTS go
18
+ * under `prefix` (mount-style convention). Wrap with `{ segment: '',
19
+ * children: ... }` for clean semantics; `translateController` does
20
+ * exactly that.
21
+ */
22
+ registerSubtree(prefix: string, subtree: RouteNode): void;
23
+ /**
24
+ * Register a single ad-hoc route. Escape hatch for routes that don't
25
+ * fit the controller convention (webhooks, healthchecks, OAuth callbacks).
26
+ */
27
+ registerRoute(method: HttpMethod, path: string, entry: HandlerEntry): void;
28
+ /** Walk depth-first; `fullPath` is the slash-joined path to the node. */
29
+ walk(visitor: (node: RouteNode, fullPath: string) => void): void;
30
+ /**
31
+ * Flatten to one entry per (method, full-path) leaf. Middlewares are
32
+ * accumulated root → leaf; `bodyParsing` inherits leaf-wins.
33
+ */
34
+ flatten(): FlatRoute[];
35
+ /** Match a request. See `MatchResult` for return cases (404 / 405 / hit). */
36
+ match(method: string, path: string): MatchResult | null;
37
+ }