@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
package/LICENCE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2016-2023 Andrei Lahunou
3
+ Copyright (c) 2016-2025 Andrei Lahunou
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,3 +1,67 @@
1
- # Adaptive stone node js framework
1
+ # @adaptivestone/framework
2
2
 
3
- [https://framework.adaptivestone.com/](https://framework.adaptivestone.com/)
3
+ A TypeScript-first, ESM Node.js framework: convention-based controllers and
4
+ Mongoose models, a tree-based router with per-controller generated route/handler
5
+ types, and batteries-included auth, rate limiting, i18n, and caching.
6
+
7
+ 📖 **Full documentation → https://framework.adaptivestone.com/**
8
+ 🤖 **LLM-ready docs (whole site as one file) → https://framework.adaptivestone.com/llm-context.md**
9
+
10
+ ## Requirements
11
+
12
+ - **Node ≥ 24** (ESM-only, runs `.ts` sources natively)
13
+ - **MongoDB** — required; boot fails fast without `MONGO_DSN`
14
+ - **`AUTH_SALT`** — required; generate one with `node src/cli.ts generateRandomBytes`
15
+
16
+ ## Quickstart
17
+
18
+ The fastest way to start is to clone the example project and use it as a
19
+ template — it ships a working `Server`, controllers, config, tests, and a Docker
20
+ dev stack (MongoDB + Redis included):
21
+
22
+ ```sh
23
+ git clone https://github.com/adaptivestone/framework-example-project.git my-app
24
+ cd my-app
25
+ docker compose up
26
+ ```
27
+
28
+ Your app starts at `http://localhost:3300`. Provide an `AUTH_SALT` before first
29
+ boot (see Requirements and `.env.example`). Edit a controller under
30
+ `src/controllers/` and the dev server reloads automatically. Full walkthrough in
31
+ the [Getting Started guide](https://framework.adaptivestone.com/).
32
+
33
+ To add the framework to an existing project instead:
34
+
35
+ ```sh
36
+ npm install @adaptivestone/framework
37
+ ```
38
+
39
+ ## Generated types
40
+
41
+ The framework generates `genTypes.d.ts` (typed `getConfig`/`getModel`) and
42
+ per-controller `*.routes.gen.ts` files (typed handler signatures). Regenerate
43
+ them with:
44
+
45
+ ```sh
46
+ node src/cli.ts generatetypes
47
+ ```
48
+
49
+ They are gitignored — regenerate after pulling (a fresh checkout is red in the
50
+ editor until the first run). In CI, guard against stale types with
51
+ `node src/cli.ts generatetypes --check`, which writes nothing and exits non-zero
52
+ if anything is out of date. The template wires this into its `check:types` script.
53
+
54
+ ## Public API & stability
55
+
56
+ Only the subpaths listed under `exports` in `package.json` are importable as
57
+ `@adaptivestone/framework/<path>`; internal modules are intentionally not
58
+ exported. Exported paths follow semver in two tiers:
59
+
60
+ - **Tier 1 — stable:** `server.js`, `Cli.js`, `types.js`, `folderConfig.js`,
61
+ `modules/*`, `models/*`, `controllers/*`, `tests/*`, `migrations/*`.
62
+ - **Tier 2 — extension surface:** `helpers/*` and `services/*` — may change in a
63
+ minor (with a deprecation cycle); pin to a minor if you import them directly.
64
+
65
+ ## License
66
+
67
+ MIT
package/dist/Cli.d.ts ADDED
@@ -0,0 +1,7 @@
1
+ import type { TFolderConfig } from './folderConfig.ts';
2
+ import BaseCli from './modules/BaseCli.ts';
3
+ declare class Cli extends BaseCli {
4
+ constructor(serverConfig: TFolderConfig);
5
+ run(): Promise<boolean>;
6
+ }
7
+ export default Cli;
package/dist/Cli.js ADDED
@@ -0,0 +1,19 @@
1
+ import mongoose from 'mongoose';
2
+ import BaseCli from "./modules/BaseCli.js";
3
+ import Server from "./server.js";
4
+ class Cli extends BaseCli {
5
+ constructor(serverConfig) {
6
+ mongoose.set('autoIndex', false); // we do not need create indexes on CLI.
7
+ const server = new Server(serverConfig);
8
+ super(server);
9
+ }
10
+ async run() {
11
+ await this.server.init({ isSkipModelInit: true, isSkipModelLoading: true });
12
+ const command = process.argv[2]?.toLowerCase();
13
+ await super.run(command);
14
+ this.app.events.emit('shutdown');
15
+ return true;
16
+ }
17
+ }
18
+ export default Cli;
19
+ //# sourceMappingURL=Cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Cli.js","sourceRoot":"","sources":["../src/Cli.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,OAAO,MAAM,sBAAsB,CAAC;AAC3C,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,GAAI,SAAQ,OAAO;IACvB,YAAY,YAA2B;QACrC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,wCAAwC;QAC1E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QACxC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QAC/C,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,eAAe,GAAG,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,67 @@
1
+ import cluster from 'node:cluster';
2
+ import { cpus } from 'node:os';
3
+ const numCPUs = cpus().length;
4
+ if (cluster.isPrimary) {
5
+ console.log(`Master ${process.pid} is running`);
6
+ // Fork workers.
7
+ for (let i = 0; i < numCPUs; i += 1) {
8
+ cluster.fork();
9
+ }
10
+ // An orchestrator sends SIGTERM/SIGINT to PID 1 (the primary). Forward it to
11
+ // every worker so each drains gracefully via its own signal handler (workers
12
+ // run index.ts → startServer); the primary exits once the last worker is gone.
13
+ let shuttingDown = false;
14
+ for (const signal of ['SIGTERM', 'SIGINT']) {
15
+ process.on(signal, () => {
16
+ shuttingDown = true;
17
+ for (const worker of Object.values(cluster.workers ?? {})) {
18
+ worker?.kill(signal);
19
+ }
20
+ });
21
+ }
22
+ // Bound crash-loop restarts. A worker that keeps dying on boot (bad config,
23
+ // port in use, missing Mongo/AUTH_SALT, unhandled rejection) must NOT be
24
+ // re-forked in a tight loop — that pegs every core and floods logs. Track
25
+ // restarts in a rolling window; if they arrive too fast, stop forking and
26
+ // exit so the orchestrator surfaces the crash-loop instead of the primary
27
+ // masking it forever. Healthy single crashes still recover (after a short
28
+ // backoff).
29
+ const RESTART_WINDOW_MS = 60_000;
30
+ const MAX_RESTARTS_PER_WINDOW = numCPUs * 5;
31
+ const RESTART_BACKOFF_MS = 1_000;
32
+ let restartTimes = [];
33
+ cluster.on('exit', (worker, code, signal) => {
34
+ if (shuttingDown) {
35
+ // Tearing down: don't resurrect; exit when the last worker has gone.
36
+ if (Object.keys(cluster.workers ?? {}).length === 0) {
37
+ process.exit(0);
38
+ }
39
+ return;
40
+ }
41
+ // Deliberate shutdown (clean exit, no kill signal) — do not resurrect,
42
+ // otherwise the primary fights a graceful shutdown forever.
43
+ if (code === 0 && !signal) {
44
+ return;
45
+ }
46
+ const now = Date.now();
47
+ restartTimes = restartTimes.filter((t) => now - t < RESTART_WINDOW_MS);
48
+ restartTimes.push(now);
49
+ if (restartTimes.length > MAX_RESTARTS_PER_WINDOW) {
50
+ console.error(`Too many worker crashes (${restartTimes.length} in ${RESTART_WINDOW_MS / 1000}s). Refusing to keep forking — check the boot error above (config, DB, port). Exiting.`);
51
+ process.exit(1);
52
+ }
53
+ console.log(`Worker \x1B[45m ${worker.process.pid} \x1B[49m \x1B[41m †††† died †††† \x1B[49m. Code: ${signal || code}. Restarting in ${RESTART_BACKOFF_MS}ms...`);
54
+ setTimeout(() => {
55
+ if (!shuttingDown) {
56
+ cluster.fork();
57
+ }
58
+ }, RESTART_BACKOFF_MS).unref();
59
+ });
60
+ }
61
+ else {
62
+ // index.ts is the entry that actually constructs the Server and starts
63
+ // listening. server.ts only DEFINES the class, so importing it here would
64
+ // let the worker's event loop drain and exit → infinite fork storm.
65
+ import("./index.js");
66
+ }
67
+ //# sourceMappingURL=cluster.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cluster.js","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * App-level type generation. Emits a single `genTypes.d.ts` at
3
+ * `process.cwd()` that augments `IApp` so `getConfig('foo')` and
4
+ * `getModel('Bar')` are typed against the project's actual config /
5
+ * model files.
6
+ */
7
+ import type { IApp } from '../server.ts';
8
+ /** Subset of the framework logger we use here. */
9
+ export interface CodegenLogger {
10
+ info?(msg: string): void;
11
+ warn?(msg: string): void;
12
+ }
13
+ /** Generate the app-level `genTypes.d.ts` file. */
14
+ export declare function generateAppTypes(app: IApp, logger?: CodegenLogger | null): Promise<void>;
15
+ /** Render the `genTypes.d.ts` template text from config values + model paths. */
16
+ export declare function getTemplate(configs: Map<string, unknown>, modelPaths: {
17
+ file: string;
18
+ path: string;
19
+ }[]): Promise<string>;
@@ -0,0 +1,126 @@
1
+ /**
2
+ * App-level type generation. Emits a single `genTypes.d.ts` at
3
+ * `process.cwd()` that augments `IApp` so `getConfig('foo')` and
4
+ * `getModel('Bar')` are typed against the project's actual config /
5
+ * model files.
6
+ */
7
+ import fs from 'node:fs/promises';
8
+ import path from 'node:path';
9
+ import { isBaseModelSource } from "./astModel.js";
10
+ /** A `./`-rooted, forward-slash specifier from `dir` to `target` for the emitted
11
+ * `import('…')`. Throws if `target` is outside `dir` (can't be a relative import)
12
+ * — better a clear error than an accidental absolute path baked into the file. */
13
+ function toRelativeSpecifier(dir, target) {
14
+ const rel = path.relative(dir, target);
15
+ if (rel.startsWith('..') || path.isAbsolute(rel)) {
16
+ throw new Error(`Model path "${target}" is outside the project root "${dir}"; cannot emit a relative import into genTypes.d.ts`);
17
+ }
18
+ return `./${rel.split(path.sep).join('/')}`;
19
+ }
20
+ /** Generate the app-level `genTypes.d.ts` file. */
21
+ export async function generateAppTypes(app, logger) {
22
+ const template = await getTemplate(app.internalFilesCache.configs, app.internalFilesCache.modelPaths);
23
+ await fs.writeFile(`${process.cwd()}/genTypes.d.ts`, template);
24
+ logger?.info?.('TypeScript types generated successfully at genTypes.d.ts');
25
+ }
26
+ /**
27
+ * Render a TypeScript type from a runtime config value's **shape** — value
28
+ * *types* (`string`, `number`), never the literal values. This is emitted
29
+ * inline (no `import()` to resolve, so output is robust across compilers and
30
+ * module settings) and structure-preserving (arrays stay tuples, so patterns
31
+ * like `Object.values(config.list[0])` keep precise per-element types) — while
32
+ * never serializing a secret value into the generated file.
33
+ *
34
+ * `undefined`-valued object keys are dropped (a field whose value is absent at
35
+ * gen time has no knowable type; same as the historical `JSON.stringify` form).
36
+ */
37
+ function valueToTypeString(value) {
38
+ if (value === null) {
39
+ return 'null';
40
+ }
41
+ switch (typeof value) {
42
+ case 'string':
43
+ return 'string';
44
+ case 'number':
45
+ return 'number';
46
+ case 'boolean':
47
+ return 'boolean';
48
+ case 'bigint':
49
+ return 'bigint';
50
+ case 'undefined':
51
+ return 'undefined';
52
+ case 'function':
53
+ return '((...args: any[]) => any)';
54
+ case 'object': {
55
+ if (Array.isArray(value)) {
56
+ return value.length === 0
57
+ ? 'unknown[]'
58
+ : `[${value.map(valueToTypeString).join(', ')}]`;
59
+ }
60
+ // Only walk plain objects; anything exotic (Date, RegExp, Map, …) is opaque.
61
+ const proto = Object.getPrototypeOf(value);
62
+ if (proto !== Object.prototype && proto !== null) {
63
+ return 'unknown';
64
+ }
65
+ const entries = Object.entries(value).filter(([, v]) => v !== undefined);
66
+ if (entries.length === 0) {
67
+ return '{}';
68
+ }
69
+ const body = entries
70
+ .map(([k, v]) => `${JSON.stringify(k)}: ${valueToTypeString(v)}`)
71
+ .join('; ');
72
+ return `{ ${body} }`;
73
+ }
74
+ default:
75
+ return 'unknown';
76
+ }
77
+ }
78
+ /** Render the `genTypes.d.ts` template text from config values + model paths. */
79
+ export async function getTemplate(configs, modelPaths) {
80
+ const dir = process.cwd();
81
+ const configTypes = Array.from(configs)
82
+ .map(([name, value]) => ` getConfig(configName: '${name}'): ${valueToTypeString(value)};`)
83
+ .join('\n');
84
+ // Detect `BaseModel` subclasses by parsing each model's source (no runtime
85
+ // import — codegen never loads the model graph / Mongoose). Result drives both
86
+ // the `getModel` emission and the `appInfo.user` augmentation below.
87
+ // One probe cache for the whole run — a shared base model parses once.
88
+ const modelCache = new Map();
89
+ const models = await Promise.all(modelPaths.map(async (modelPath) => ({
90
+ file: modelPath.file,
91
+ relPath: toRelativeSpecifier(dir, modelPath.path),
92
+ isBaseModel: await isBaseModelSource(modelPath.path, 0, modelCache),
93
+ })));
94
+ const modelTypes = models
95
+ .map((m) => m.isBaseModel
96
+ ? ` getModel(modelName: '${m.file}'): GetModelTypeFromClass<typeof import('${m.relPath}').default>`
97
+ : ` getModel(modelName: '${m.file}'): import('${m.relPath}').default['mongooseModel']`)
98
+ .join('\n');
99
+ // Bind `req.appInfo.user` to the project's `User` model (if it's a BaseModel),
100
+ // so it follows a replaced model exactly like `getModel('User')` does. The
101
+ // augmentation feeds `AppUser`, which is the hydrated DOCUMENT — so wrap the
102
+ // model class in `InstanceType<…>` (unlike `getModel('User')` above, which
103
+ // returns the Model class itself).
104
+ const userModel = models.find((m) => m.file === 'User' && m.isBaseModel);
105
+ const userAppInfo = userModel
106
+ ? `
107
+ declare module '@adaptivestone/framework/models/User.js' {
108
+ export interface AppModels {
109
+ User: InstanceType<GetModelTypeFromClass<typeof import('${userModel.relPath}').default>>;
110
+ }
111
+ }
112
+ `
113
+ : '';
114
+ return `
115
+ import type {} from '@adaptivestone/framework/server.js';
116
+ import type { GetModelTypeFromClass } from '@adaptivestone/framework/modules/BaseModel.js';
117
+
118
+ declare module '@adaptivestone/framework/server.js' {
119
+ export interface IApp {
120
+ ${configTypes}
121
+ ${modelTypes}
122
+ }
123
+ }
124
+ ${userAppInfo}`;
125
+ }
126
+ //# sourceMappingURL=appTypes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"appTypes.js","sourceRoot":"","sources":["../../src/codegen/appTypes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * AST codegen emit (plan: `.plans/refactor/queued/codegen-ast.md`). Produces a
3
+ * controller's `.routes.gen.ts` text WITHOUT booting the app or running
4
+ * `importResolution`: parse → resolve (extends-walk) → build the shared
5
+ * `ControllerSubtreeSpec` → flatten via the real `RouteRegistry` → feed the
6
+ * shared `renderGenFile`. This is the project's sole codegen front-end (the old
7
+ * boot/`importResolution` path was removed once this was proven byte-identical).
8
+ *
9
+ * `generateRouteTypesViaAst` registers ALL controllers into ONE registry (so
10
+ * cross-controller bleed resolves exactly as runtime) and reports any controller
11
+ * whose source isn't statically analyzable (`needsBoot`) so the caller
12
+ * (`generateAll`) throws and names it — there is no boot fallback.
13
+ */
14
+ import type { IApp } from '../server.ts';
15
+ import type { CodegenLogger } from './appTypes.ts';
16
+ /** A planned gen-file write: its target path and rendered text. */
17
+ export interface PlannedOutput {
18
+ outPath: string;
19
+ text: string;
20
+ }
21
+ /** Result of analyzing (but not writing) the route types. */
22
+ export interface RoutePlan {
23
+ /** Gen files to write (user controllers only; framework-internal skipped). */
24
+ outputs: PlannedOutput[];
25
+ /** Controllers that aren't statically analyzable (caller throws). */
26
+ needsBoot: string[];
27
+ /** Existing `*.routes.gen.ts` in the user folder with no sibling source. */
28
+ orphans: string[];
29
+ }
30
+ /**
31
+ * Analyze the project's controller sources (no import, no boot) and return the
32
+ * gen files to write — WITHOUT writing anything. Registers all controllers
33
+ * (framework-internal + user) into one registry so cross-controller bleed
34
+ * resolves exactly like runtime, then renders each user controller's gen text.
35
+ *
36
+ * Pure analysis so the caller can fail before any write (atomicity) and so a
37
+ * `--check` run can compare against disk using the exact same rendering path.
38
+ */
39
+ export declare function planRouteTypes(app: IApp, logger?: CodegenLogger | null): Promise<RoutePlan>;
40
+ /**
41
+ * AST-primary route-type generation: plan, then write each user controller's
42
+ * `<File>.routes.gen.ts` and delete orphaned gen files. If ANY controller isn't
43
+ * statically analyzable nothing is written and the paths are returned so the
44
+ * caller throws and names them. There is no boot fallback.
45
+ */
46
+ export declare function generateRouteTypesViaAst(app: IApp, logger?: CodegenLogger | null): Promise<{
47
+ written: number;
48
+ needsBoot: string[];
49
+ }>;
50
+ /** Write the planned gen files to disk. */
51
+ export declare function writePlanned(outputs: PlannedOutput[], logger?: CodegenLogger | null): Promise<void>;
52
+ /** Delete orphaned gen files (those with no sibling controller source). */
53
+ export declare function deleteOrphans(orphans: string[], logger?: CodegenLogger | null): Promise<void>;
@@ -0,0 +1,242 @@
1
+ /**
2
+ * AST codegen emit (plan: `.plans/refactor/queued/codegen-ast.md`). Produces a
3
+ * controller's `.routes.gen.ts` text WITHOUT booting the app or running
4
+ * `importResolution`: parse → resolve (extends-walk) → build the shared
5
+ * `ControllerSubtreeSpec` → flatten via the real `RouteRegistry` → feed the
6
+ * shared `renderGenFile`. This is the project's sole codegen front-end (the old
7
+ * boot/`importResolution` path was removed once this was proven byte-identical).
8
+ *
9
+ * `generateRouteTypesViaAst` registers ALL controllers into ONE registry (so
10
+ * cross-controller bleed resolves exactly as runtime) and reports any controller
11
+ * whose source isn't statically analyzable (`needsBoot`) so the caller
12
+ * (`generateAll`) throws and names it — there is no boot fallback.
13
+ */
14
+ import { existsSync, promises as fs } from 'node:fs';
15
+ import path from 'node:path';
16
+ import { fileURLToPath } from 'node:url';
17
+ import { buildSubtreeFromSpec, convertPathSyntax, } from "../controllers/index.js";
18
+ import { getFilesPathWithInheritance } from "../helpers/files.js";
19
+ import { RouteRegistry } from "../services/http/routing/RouteRegistry.js";
20
+ import { specFromExtracted } from "./astSpec.js";
21
+ import { renderGenFile } from "./emit.js";
22
+ /**
23
+ * Analyze the project's controller sources (no import, no boot) and return the
24
+ * gen files to write — WITHOUT writing anything. Registers all controllers
25
+ * (framework-internal + user) into one registry so cross-controller bleed
26
+ * resolves exactly like runtime, then renders each user controller's gen text.
27
+ *
28
+ * Pure analysis so the caller can fail before any write (atomicity) and so a
29
+ * `--check` run can compare against disk using the exact same rendering path.
30
+ */
31
+ export async function planRouteTypes(app, logger) {
32
+ const discovered = await discoverControllers(app.foldersConfig.controllers, logger);
33
+ logger?.info?.(`Found ${discovered.length} controller source(s) for route types`);
34
+ // One parse cache for the whole run — shared ancestors parse once.
35
+ const cache = new Map();
36
+ const resolvedAll = await Promise.all(discovered.map(async (d) => ({
37
+ ...d,
38
+ ...(await specFromExtracted(d.srcPath, d.prefix, cache)),
39
+ })));
40
+ const orphans = await findOrphanGenFiles(app.foldersConfig.controllers);
41
+ const needsBoot = resolvedAll
42
+ .filter((r) => r.resolved.needsBoot)
43
+ .map((r) => r.srcPath);
44
+ if (needsBoot.length > 0) {
45
+ logger?.info?.(`${needsBoot.length} controller(s) aren't statically analyzable — no route types written (caller will throw)`);
46
+ return { outputs: [], needsBoot, orphans };
47
+ }
48
+ // One registry resolves cross-controller bleed exactly like runtime. Register
49
+ // BOTH framework-internal and user controllers so bleed/conflict sees the full
50
+ // picture. A per-controller collision pre-check names BOTH offending files —
51
+ // the raw registry error only carries the segment.
52
+ //
53
+ // Note: the runtime sorts `index` controllers first; codegen registers in
54
+ // discovery order. That divergence is harmless — the emitted types are
55
+ // order-insensitive (the middleware chain at each leaf is the same set, and
56
+ // type intersections commute). Do not "fix" the order into a real difference.
57
+ const registry = new RouteRegistry();
58
+ const owner = new Map();
59
+ for (const r of resolvedAll) {
60
+ const check = new RouteRegistry();
61
+ check.registerSubtree(r.resolved.urlPrefix, buildSubtreeFromSpec(r.spec));
62
+ for (const fr of check.flatten()) {
63
+ const key = `${fr.method} ${fr.path}`;
64
+ const prev = owner.get(key);
65
+ if (prev && prev !== r.srcPath) {
66
+ throw new Error(`Route-type codegen: conflicting route ${key} is declared by both ${prev} and ${r.srcPath}`);
67
+ }
68
+ owner.set(key, r.srcPath);
69
+ }
70
+ registry.registerSubtree(r.resolved.urlPrefix, buildSubtreeFromSpec(r.spec));
71
+ }
72
+ const flatByKey = indexFlat(registry.flatten());
73
+ const outputs = [];
74
+ for (const r of resolvedAll) {
75
+ // Framework-internal controllers ship pre-generated gen files — registered
76
+ // above for bleed, but never written into the installed package.
77
+ if (r.isInternal) {
78
+ continue;
79
+ }
80
+ const text = renderResolved(r.srcPath, r.resolved, flatByKey, r.resolved.urlPrefix);
81
+ const outPath = path.join(path.dirname(r.srcPath),
82
+ // Strip whichever source extension (.ts or .js); the gen file is always .ts.
83
+ `${path.basename(r.srcPath, path.extname(r.srcPath))}.routes.gen.ts`);
84
+ outputs.push({ outPath, text });
85
+ }
86
+ return { outputs, needsBoot: [], orphans };
87
+ }
88
+ /**
89
+ * AST-primary route-type generation: plan, then write each user controller's
90
+ * `<File>.routes.gen.ts` and delete orphaned gen files. If ANY controller isn't
91
+ * statically analyzable nothing is written and the paths are returned so the
92
+ * caller throws and names them. There is no boot fallback.
93
+ */
94
+ export async function generateRouteTypesViaAst(app, logger) {
95
+ const plan = await planRouteTypes(app, logger);
96
+ if (plan.needsBoot.length > 0) {
97
+ return { written: 0, needsBoot: plan.needsBoot };
98
+ }
99
+ await writePlanned(plan.outputs, logger);
100
+ await deleteOrphans(plan.orphans, logger);
101
+ logger?.info?.(`Wrote ${plan.outputs.length} route-type file(s) via AST`);
102
+ return { written: plan.outputs.length, needsBoot: [] };
103
+ }
104
+ /** Write the planned gen files to disk. */
105
+ export async function writePlanned(outputs, logger) {
106
+ for (const { outPath, text } of outputs) {
107
+ await fs.writeFile(outPath, text, 'utf8');
108
+ logger?.info?.(` → ${outPath}`);
109
+ }
110
+ }
111
+ /** Delete orphaned gen files (those with no sibling controller source). */
112
+ export async function deleteOrphans(orphans, logger) {
113
+ for (const orphan of orphans) {
114
+ await fs.rm(orphan, { force: true });
115
+ logger?.info?.(` ✗ removed orphan gen file ${orphan}`);
116
+ }
117
+ }
118
+ /**
119
+ * Find `*.routes.gen.ts` files under `userDir` that have no sibling controller
120
+ * source (`<base>.ts`/`.js`) — left behind when a controller is renamed/deleted,
121
+ * and a `tsc`-breaker for consumers. Scoped to the user folder; never touches the
122
+ * installed framework package.
123
+ */
124
+ async function findOrphanGenFiles(userDir) {
125
+ let entries;
126
+ try {
127
+ entries = await fs.readdir(userDir, {
128
+ recursive: true,
129
+ withFileTypes: true,
130
+ });
131
+ }
132
+ catch {
133
+ return [];
134
+ }
135
+ const out = [];
136
+ for (const e of entries) {
137
+ if (!e.isFile() || !e.name.endsWith('.routes.gen.ts')) {
138
+ continue;
139
+ }
140
+ const parent = e.parentPath ?? userDir;
141
+ const base = e.name.slice(0, -'.routes.gen.ts'.length);
142
+ const hasSource = existsSync(path.join(parent, `${base}.ts`)) ||
143
+ existsSync(path.join(parent, `${base}.js`));
144
+ if (!hasSource) {
145
+ out.push(path.join(parent, e.name));
146
+ }
147
+ }
148
+ return out;
149
+ }
150
+ // ─── helpers ─────────────────────────────────────────────────────────────────
151
+ /** Render a resolved controller's gen text using the chains in `flatByKey`. */
152
+ function renderResolved(srcPath, resolved, flatByKey, urlPrefix) {
153
+ const routes = resolved.routes.map((r) => ({
154
+ method: r.method,
155
+ path: r.path,
156
+ handlerName: r.handler,
157
+ hasSchema: r.hasRequest,
158
+ hasQuerySchema: r.hasQuery,
159
+ ...(r.requestContentTypes
160
+ ? { requestContentTypes: r.requestContentTypes }
161
+ : {}),
162
+ }));
163
+ const importMap = new Map(resolved.imports.map((i) => [i.binding, i.specifier]));
164
+ // Only bindings this controller actually imports are emittable. A middleware
165
+ // that bleeds in from another controller (a root-mounted splat) but isn't in
166
+ // this file's import map is dropped — it can't be referenced by name here, so
167
+ // there's no `import type` to emit for it.
168
+ const importable = new Set(importMap.keys());
169
+ const filteredChains = routes.map((route) => chainAt(flatByKey, route.method.toUpperCase(), joinPath(urlPrefix, convertPathSyntax(route.path)), importable));
170
+ const controller = {
171
+ className: resolved.className ?? 'Unknown',
172
+ prefix: '',
173
+ urlPrefix,
174
+ routes,
175
+ };
176
+ return renderGenFile({ controller, srcPath, filteredChains, importMap });
177
+ }
178
+ /** The deduped, importable middleware chain (binding names) for one flat route. */
179
+ function chainAt(flatByKey, method, absPath, importable) {
180
+ const fr = flatByKey.get(`${method} ${absPath}`);
181
+ if (!fr) {
182
+ return [];
183
+ }
184
+ const seen = new Set();
185
+ const out = [];
186
+ for (const entry of fr.middlewares) {
187
+ const name = entry.Class.name;
188
+ if (importable.has(name) && !seen.has(name)) {
189
+ seen.add(name);
190
+ out.push({ className: name });
191
+ }
192
+ }
193
+ return out;
194
+ }
195
+ function indexFlat(flat) {
196
+ const out = new Map();
197
+ for (const fr of flat) {
198
+ out.set(`${fr.method} ${fr.path}`, fr);
199
+ }
200
+ return out;
201
+ }
202
+ /** Join a controller's URL prefix with a route sub-path the way the registry
203
+ * builds flat-route paths (segment join, no trailing slash). */
204
+ function joinPath(prefix, sub) {
205
+ const segments = [...prefix.split('/'), ...sub.split('/')].filter((s) => s.length > 0);
206
+ return segments.length === 0 ? '/' : `/${segments.join('/')}`;
207
+ }
208
+ /** The framework's own controllers dir (a sibling of this codegen module). */
209
+ function frameworkControllersDir() {
210
+ return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../controllers');
211
+ }
212
+ function isUnder(parent, child) {
213
+ const rel = path.relative(parent, child);
214
+ return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
215
+ }
216
+ /**
217
+ * Discover controller sources exactly like the runtime loader
218
+ * (`getFilesPathWithInheritance`): merge the framework's internal controllers
219
+ * with the user folder (user filename wins on collision), applying the same
220
+ * capital-first / not-test / not-gen / not-`.d.ts` filter. Each file carries its
221
+ * folder `prefix` (drives the default mount path) and an `isInternal` flag.
222
+ */
223
+ async function discoverControllers(userDir, logger) {
224
+ const internalDir = frameworkControllersDir();
225
+ // When codegen runs inside the framework repo itself, the user dir IS the
226
+ // internal dir — there's nothing external to skip, so emit everything.
227
+ const sameTree = path.resolve(internalDir) === path.resolve(userDir);
228
+ const files = await getFilesPathWithInheritance({
229
+ internalFolder: internalDir,
230
+ externalFolder: userDir,
231
+ logger: (m) => logger?.info?.(m),
232
+ });
233
+ return files.map(({ path: srcPath, file }) => {
234
+ const dir = path.dirname(file);
235
+ return {
236
+ srcPath,
237
+ prefix: dir === '.' ? '' : dir,
238
+ isInternal: !sameTree && isUnder(internalDir, srcPath),
239
+ };
240
+ });
241
+ }
242
+ //# sourceMappingURL=astEmit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"astEmit.js","sourceRoot":"","sources":["../../src/codegen/astEmit.ts"],"names":[],"mappings":"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"}