@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,244 @@
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 { match } from "./match.js";
8
+ /** Construct an empty node with the given segment. */
9
+ export function createNode(segment) {
10
+ return {
11
+ segment,
12
+ middlewares: [],
13
+ children: new Map(),
14
+ };
15
+ }
16
+ export class RouteRegistry {
17
+ root = createNode('');
18
+ /**
19
+ * Mount a subtree at a path prefix. Intermediate nodes are created;
20
+ * existing ones are merged (middlewares appended, methods added,
21
+ * children recursively merged). Conflicting handlers throw.
22
+ *
23
+ * The subtree's root `segment` is metadata only — its CONTENTS go
24
+ * under `prefix` (mount-style convention). Wrap with `{ segment: '',
25
+ * children: ... }` for clean semantics; `translateController` does
26
+ * exactly that.
27
+ */
28
+ registerSubtree(prefix, subtree) {
29
+ let target = this.root;
30
+ const prefixParamNames = [];
31
+ for (const seg of pathSegments(prefix)) {
32
+ if (seg.startsWith(':') || seg.startsWith('*')) {
33
+ prefixParamNames.push(seg.slice(1));
34
+ }
35
+ target = ensureChildBySegment(target, seg);
36
+ }
37
+ // A handler's `paramNames` only covers params in its OWN path, not in the
38
+ // mount prefix. `match()` zips paramNames against ALL collected values by
39
+ // index, so prefix params must be prepended or the values mis-align.
40
+ if (prefixParamNames.length > 0) {
41
+ prependParamNames(subtree, prefixParamNames);
42
+ }
43
+ mergeNode(target, subtree);
44
+ }
45
+ /**
46
+ * Register a single ad-hoc route. Escape hatch for routes that don't
47
+ * fit the controller convention (webhooks, healthchecks, OAuth callbacks).
48
+ */
49
+ registerRoute(method, path, entry) {
50
+ let target = this.root;
51
+ const paramNames = [];
52
+ for (const seg of pathSegments(path)) {
53
+ if (seg.startsWith(':') || seg.startsWith('*')) {
54
+ paramNames.push(seg.slice(1));
55
+ }
56
+ target = ensureChildBySegment(target, seg);
57
+ }
58
+ if (!target.methods) {
59
+ target.methods = {};
60
+ }
61
+ if (target.methods[method]) {
62
+ throw new Error(`RouteRegistry: route ${method} ${path} already registered`);
63
+ }
64
+ if (paramNames.length > 0) {
65
+ entry.paramNames = paramNames;
66
+ }
67
+ target.methods[method] = entry;
68
+ }
69
+ /** Walk depth-first; `fullPath` is the slash-joined path to the node. */
70
+ walk(visitor) {
71
+ walkRecursive(this.root, '', visitor);
72
+ }
73
+ /**
74
+ * Flatten to one entry per (method, full-path) leaf. Middlewares are
75
+ * accumulated root → leaf; `bodyParsing` inherits leaf-wins.
76
+ */
77
+ flatten() {
78
+ const out = [];
79
+ flattenRecursive(this.root, '', undefined, [], out);
80
+ return out;
81
+ }
82
+ /** Match a request. See `MatchResult` for return cases (404 / 405 / hit). */
83
+ match(method, path) {
84
+ return match(this.root, method, path);
85
+ }
86
+ }
87
+ // ─── path helpers ────────────────────────────────────────────────────
88
+ function pathSegments(path) {
89
+ return path.split('/').filter((s) => s.length > 0);
90
+ }
91
+ function joinPath(prefix, segment) {
92
+ if (segment === '') {
93
+ return prefix === '' ? '/' : prefix;
94
+ }
95
+ const joined = `${prefix}/${segment}`;
96
+ return joined.startsWith('//') ? joined.slice(1) : joined;
97
+ }
98
+ // ─── tree mutation ───────────────────────────────────────────────────
99
+ function ensureChildBySegment(node, segment) {
100
+ if (node.segment.startsWith('*')) {
101
+ throw new Error(`RouteRegistry: cannot register a child segment "${segment}" under a splat segment "${node.segment}" — splat consumes the rest of the path, so this child would be unreachable`);
102
+ }
103
+ if (segment.startsWith(':')) {
104
+ if (!node.paramChild) {
105
+ node.paramChild = createNode(segment);
106
+ }
107
+ return node.paramChild;
108
+ }
109
+ if (segment.startsWith('*')) {
110
+ if (!node.splatChild) {
111
+ node.splatChild = createNode(segment);
112
+ }
113
+ return node.splatChild;
114
+ }
115
+ // Static children are keyed by lowercase segment so case-insensitive matching
116
+ // is an O(1) `Map.get` (no per-request scan). The node keeps the original-cased
117
+ // `segment` for display and case-sensitive matching. Segments differing only by
118
+ // case fold onto one node (insensitive matching already treated them as one);
119
+ // a same-method collision then surfaces via the conflicting-handler error.
120
+ const key = segment.toLowerCase();
121
+ let child = node.children.get(key);
122
+ if (!child) {
123
+ child = createNode(segment);
124
+ node.children.set(key, child);
125
+ }
126
+ return child;
127
+ }
128
+ /**
129
+ * Prepend mount-prefix param names to every handler in the subtree that already
130
+ * carries a `paramNames` array. Handlers without `paramNames` rely on `match()`'s
131
+ * tree-segment-name fallback, which already accounts for the prefix nodes.
132
+ */
133
+ function prependParamNames(node, prefixNames) {
134
+ if (node.methods) {
135
+ for (const m of Object.keys(node.methods)) {
136
+ const handler = node.methods[m];
137
+ if (handler?.paramNames) {
138
+ handler.paramNames = [...prefixNames, ...handler.paramNames];
139
+ }
140
+ }
141
+ }
142
+ for (const child of node.children.values()) {
143
+ prependParamNames(child, prefixNames);
144
+ }
145
+ if (node.paramChild) {
146
+ prependParamNames(node.paramChild, prefixNames);
147
+ }
148
+ if (node.splatChild) {
149
+ prependParamNames(node.splatChild, prefixNames);
150
+ }
151
+ }
152
+ function mergeNode(target, source) {
153
+ target.middlewares.push(...source.middlewares);
154
+ if (source.methods) {
155
+ if (!target.methods) {
156
+ target.methods = {};
157
+ }
158
+ for (const m of Object.keys(source.methods)) {
159
+ const handler = source.methods[m];
160
+ if (!handler) {
161
+ continue;
162
+ }
163
+ if (target.methods[m]) {
164
+ throw new Error(`RouteRegistry: conflicting handler for ${m} on segment "${target.segment}"`);
165
+ }
166
+ target.methods[m] = handler;
167
+ }
168
+ }
169
+ for (const [seg, child] of source.children) {
170
+ // Normalize to the lowercase key scheme (see ensureChildBySegment) so a
171
+ // subtree built elsewhere still merges by case-folded segment.
172
+ const key = seg.toLowerCase();
173
+ const existing = target.children.get(key);
174
+ if (existing) {
175
+ mergeNode(existing, child);
176
+ }
177
+ else {
178
+ target.children.set(key, child);
179
+ }
180
+ }
181
+ if (source.paramChild) {
182
+ if (target.paramChild) {
183
+ mergeNode(target.paramChild, source.paramChild);
184
+ }
185
+ else {
186
+ target.paramChild = source.paramChild;
187
+ }
188
+ }
189
+ if (source.splatChild) {
190
+ if (target.splatChild) {
191
+ mergeNode(target.splatChild, source.splatChild);
192
+ }
193
+ else {
194
+ target.splatChild = source.splatChild;
195
+ }
196
+ }
197
+ if (source.bodyParsing !== undefined) {
198
+ target.bodyParsing = source.bodyParsing;
199
+ }
200
+ }
201
+ // ─── tree traversal ──────────────────────────────────────────────────
202
+ function walkRecursive(node, prefix, visitor) {
203
+ const fullPath = joinPath(prefix, node.segment);
204
+ visitor(node, fullPath);
205
+ for (const child of node.children.values()) {
206
+ walkRecursive(child, fullPath, visitor);
207
+ }
208
+ if (node.paramChild) {
209
+ walkRecursive(node.paramChild, fullPath, visitor);
210
+ }
211
+ if (node.splatChild) {
212
+ walkRecursive(node.splatChild, fullPath, visitor);
213
+ }
214
+ }
215
+ function flattenRecursive(node, prefix, inheritedBodyParsing, inheritedMw, out) {
216
+ const fullPath = joinPath(prefix, node.segment);
217
+ const middlewares = [...inheritedMw, ...node.middlewares];
218
+ const bodyParsing = node.bodyParsing ?? inheritedBodyParsing;
219
+ if (node.methods) {
220
+ for (const m of Object.keys(node.methods)) {
221
+ const entry = node.methods[m];
222
+ if (!entry) {
223
+ continue;
224
+ }
225
+ out.push({
226
+ method: m,
227
+ path: fullPath,
228
+ entry,
229
+ middlewares: [...middlewares, ...(entry.middlewares ?? [])],
230
+ bodyParsing: entry.bodyParsing ?? bodyParsing ?? 'parsed',
231
+ });
232
+ }
233
+ }
234
+ for (const child of node.children.values()) {
235
+ flattenRecursive(child, fullPath, bodyParsing, middlewares, out);
236
+ }
237
+ if (node.paramChild) {
238
+ flattenRecursive(node.paramChild, fullPath, bodyParsing, middlewares, out);
239
+ }
240
+ if (node.splatChild) {
241
+ flattenRecursive(node.splatChild, fullPath, bodyParsing, middlewares, out);
242
+ }
243
+ }
244
+ //# sourceMappingURL=RouteRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RouteRegistry.js","sourceRoot":"","sources":["../../../../src/services/http/routing/RouteRegistry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Format the route registry as a tree for boot-time logging.
3
+ *
4
+ * Walks the tree depth-first, indenting children. Per node, shows:
5
+ * - the segment name
6
+ * - any node-level middlewares (`mw: Class1, Class2`)
7
+ * - per-method handler entries (`METHOD → handlerName [request][query][mw: ...]`)
8
+ *
9
+ * Output is a single multi-line string — caller pipes through `logger.info`
10
+ * or similar. Mirrors what the old `AbstractController` constructor logged
11
+ * per-controller, but walks the unified registry tree instead, so
12
+ * cross-controller middleware accumulation is visible.
13
+ *
14
+ * ANSI codes are emitted unconditionally — looks right in dev consoles, mild
15
+ * pollution in file/Sentry transports for the one-time boot output.
16
+ */
17
+ import type { RouteRegistry } from './RouteRegistry.ts';
18
+ interface FormatOptions {
19
+ /** Treat the root segment as `/` (default true). */
20
+ showRoot?: boolean;
21
+ }
22
+ export declare function formatRouteTree(registry: RouteRegistry, options?: FormatOptions): string;
23
+ export {};
@@ -0,0 +1,159 @@
1
+ /**
2
+ * Format the route registry as a tree for boot-time logging.
3
+ *
4
+ * Walks the tree depth-first, indenting children. Per node, shows:
5
+ * - the segment name
6
+ * - any node-level middlewares (`mw: Class1, Class2`)
7
+ * - per-method handler entries (`METHOD → handlerName [request][query][mw: ...]`)
8
+ *
9
+ * Output is a single multi-line string — caller pipes through `logger.info`
10
+ * or similar. Mirrors what the old `AbstractController` constructor logged
11
+ * per-controller, but walks the unified registry tree instead, so
12
+ * cross-controller middleware accumulation is visible.
13
+ *
14
+ * ANSI codes are emitted unconditionally — looks right in dev consoles, mild
15
+ * pollution in file/Sentry transports for the one-time boot output.
16
+ */
17
+ const DIM = '\x1b[2m';
18
+ const RESET = '\x1b[0m';
19
+ const METHOD_COLORS = {
20
+ GET: '\x1b[34m', // blue
21
+ HEAD: '\x1b[34m',
22
+ POST: '\x1b[32m', // green
23
+ PUT: '\x1b[33m', // yellow
24
+ PATCH: '\x1b[33m',
25
+ DELETE: '\x1b[31m', // red
26
+ OPTIONS: '\x1b[90m', // gray
27
+ };
28
+ const PARAM = '\x1b[35m'; // magenta — covers :param and *splat
29
+ const FLAG = '\x1b[36m'; // cyan — schema flags
30
+ export function formatRouteTree(registry, options = {}) {
31
+ const showRoot = options.showRoot ?? true;
32
+ const lines = [];
33
+ const counts = { routes: 0, nodes: 0 };
34
+ formatNode(registry.root, '/', [], '', true, lines, counts, showRoot);
35
+ const summary = `${counts.routes} route(s) across ${counts.nodes} node(s) in the tree.`;
36
+ return ['Registered routes:', ...lines, '', summary].join('\n');
37
+ }
38
+ function joinPath(parent, segment) {
39
+ if (parent === '/' || parent === '') {
40
+ return `/${segment}`;
41
+ }
42
+ return `${parent}/${segment}`;
43
+ }
44
+ function formatNode(node, fullPath, ancestorMws, indent, isLast, lines, counts, showRoot) {
45
+ counts.nodes += 1;
46
+ // Filter local node middlewares against ancestor chain — only show what's
47
+ // newly attached at this node. NOTE: this dedup is display-only. At runtime
48
+ // the dispatcher runs the full accumulated chain in order with NO dedup, so a
49
+ // class re-attached at multiple levels executes once per attachment; we hide
50
+ // the repeat here purely to keep the tree readable. Inherited ones are listed
51
+ // separately as `pmw:` (parent middleware) so you can see what came from above.
52
+ const ancestorClasses = new Set(ancestorMws.map((m) => m.Class));
53
+ const nodeNewMws = node.middlewares.filter((m) => !ancestorClasses.has(m.Class));
54
+ // Render this node's line. Root is special: render as `/` instead of empty.
55
+ const isRoot = node.segment === '' && counts.nodes === 1;
56
+ if (isRoot && !showRoot) {
57
+ // skip the root line itself, but still descend
58
+ }
59
+ else {
60
+ const branch = isRoot ? '' : `${DIM}${isLast ? '└── ' : '├── '}${RESET}`;
61
+ const seg = isRoot ? '/' : colorSegment(node.segment);
62
+ const mwSuffix = nodeNewMws.length > 0
63
+ ? `${DIM} (mw: ${formatMwList(nodeNewMws)}${ancestorMws.length > 0
64
+ ? `; pmw: ${formatMwList(dedupByClass(ancestorMws))}`
65
+ : ''})${RESET}`
66
+ : '';
67
+ lines.push(`${indent}${branch}${seg}${mwSuffix}`);
68
+ }
69
+ // Render handler methods on this node.
70
+ if (node.methods) {
71
+ const methodKeys = Object.keys(node.methods);
72
+ const childIndent = isRoot
73
+ ? indent
74
+ : indent + (isLast ? ' ' : `${DIM}│${RESET} `);
75
+ for (let i = 0; i < methodKeys.length; i++) {
76
+ const m = methodKeys[i];
77
+ const entry = node.methods[m];
78
+ if (!entry) {
79
+ continue;
80
+ }
81
+ counts.routes += 1;
82
+ const flags = [];
83
+ if (entry.request) {
84
+ flags.push('request');
85
+ }
86
+ if (entry.query) {
87
+ flags.push('query');
88
+ }
89
+ // Filter route-level middlewares against everything that already runs
90
+ // at this node (ancestors + node-local). `mw:` lists what's newly
91
+ // added for this specific route entry; `pmw:` lists the full chain
92
+ // that runs before it (deduped, in chain order) — so the route line
93
+ // is self-contained for "what runs for this exact route".
94
+ const chainAtNode = [...ancestorMws, ...node.middlewares];
95
+ const chainAtNodeClasses = new Set(chainAtNode.map((mw) => mw.Class));
96
+ const routeNewMws = entry.middlewares?.filter((mw) => !chainAtNodeClasses.has(mw.Class)) ??
97
+ [];
98
+ if (routeNewMws.length > 0) {
99
+ const parentPart = chainAtNode.length > 0
100
+ ? `; pmw: ${formatMwList(dedupByClass(chainAtNode))}`
101
+ : '';
102
+ flags.push(`mw: ${formatMwList(routeNewMws)}${parentPart}`);
103
+ }
104
+ const flagSuffix = flags.length
105
+ ? ` ${FLAG}[${flags.join(', ')}]${RESET}`
106
+ : '';
107
+ const isLastMethod = i === methodKeys.length - 1 &&
108
+ node.children.size === 0 &&
109
+ !node.paramChild &&
110
+ !node.splatChild;
111
+ const methodBranch = `${DIM}${isLastMethod ? '└── ' : '├── '}${RESET}`;
112
+ const methodColor = METHOD_COLORS[m] ?? '';
113
+ const paddedMethod = m.padEnd(7);
114
+ lines.push(`${childIndent}${methodBranch}${methodColor}${paddedMethod}${RESET} ${fullPath}${flagSuffix}`);
115
+ }
116
+ }
117
+ // Recurse: static children, then paramChild, then splatChild.
118
+ const allChildren = [...node.children.values()];
119
+ if (node.paramChild) {
120
+ allChildren.push(node.paramChild);
121
+ }
122
+ if (node.splatChild) {
123
+ allChildren.push(node.splatChild);
124
+ }
125
+ const childIndent = isRoot
126
+ ? indent
127
+ : indent + (isLast ? ' ' : `${DIM}│${RESET} `);
128
+ const chainForChildren = [...ancestorMws, ...node.middlewares];
129
+ for (let i = 0; i < allChildren.length; i++) {
130
+ formatNode(
131
+ // biome-ignore lint/style/noNonNullAssertion: i is in bounds
132
+ allChildren[i],
133
+ // biome-ignore lint/style/noNonNullAssertion: i is in bounds
134
+ joinPath(fullPath, allChildren[i].segment), chainForChildren, childIndent, i === allChildren.length - 1, lines, counts, showRoot);
135
+ }
136
+ }
137
+ function formatMwList(mws) {
138
+ return mws
139
+ .map((m) => (m.params ? `${m.Class.name}{…}` : m.Class.name))
140
+ .join(', ');
141
+ }
142
+ function colorSegment(segment) {
143
+ if (segment.startsWith(':') || segment.startsWith('*')) {
144
+ return `${PARAM}${segment}${RESET}`;
145
+ }
146
+ return segment;
147
+ }
148
+ function dedupByClass(mws) {
149
+ const seen = new Set();
150
+ const out = [];
151
+ for (const m of mws) {
152
+ if (!seen.has(m.Class)) {
153
+ seen.add(m.Class);
154
+ out.push(m);
155
+ }
156
+ }
157
+ return out;
158
+ }
159
+ //# sourceMappingURL=formatTree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatTree.js","sourceRoot":"","sources":["../../../../src/services/http/routing/formatTree.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Tree-walk matcher. Pure function.
3
+ *
4
+ * Specificity: static children → paramChild → splatChild. Per-segment
5
+ * URL decoding (Spring's `PathPatternParser` model): keeps `%2F` inside
6
+ * a segment instead of letting it act as a separator.
7
+ *
8
+ * Splat captures the rest of the path AFTER per-segment decoding, so
9
+ * `/a/foo%2Fbar/baz` and `/a/foo/bar/baz` produce the same splat value.
10
+ * Documented trade-off — handle the rare encoded-slash case in `'raw'`
11
+ * body mode if needed.
12
+ *
13
+ * Two deliberate semantics:
14
+ * - A `{*splat}` matches ZERO trailing segments, so `/api/{*rest}` matches
15
+ * `/api` (with `rest: ''`).
16
+ * - A method-less structural node is NOT a match: walking to a dead end fails
17
+ * and backtracks to param/splat siblings (so `/users/me` still matches
18
+ * `/users/:id` even when `/users/me/avatar` created a method-less `me` node).
19
+ */
20
+ import type { MatchResult, RouteNode } from './RouteNode.ts';
21
+ /** Thrown when a path contains a malformed `%XX` sequence. */
22
+ export declare class MalformedPathError extends Error {
23
+ readonly statusCode = 400;
24
+ constructor(message: string);
25
+ }
26
+ /**
27
+ * - `null` → no path match (404).
28
+ * - `{ entry: null, allowedMethods }` → path matched, method didn't (405).
29
+ * - full result → success.
30
+ */
31
+ export declare function match(root: RouteNode, method: string, path: string): MatchResult | null;
@@ -0,0 +1,164 @@
1
+ /**
2
+ * Tree-walk matcher. Pure function.
3
+ *
4
+ * Specificity: static children → paramChild → splatChild. Per-segment
5
+ * URL decoding (Spring's `PathPatternParser` model): keeps `%2F` inside
6
+ * a segment instead of letting it act as a separator.
7
+ *
8
+ * Splat captures the rest of the path AFTER per-segment decoding, so
9
+ * `/a/foo%2Fbar/baz` and `/a/foo/bar/baz` produce the same splat value.
10
+ * Documented trade-off — handle the rare encoded-slash case in `'raw'`
11
+ * body mode if needed.
12
+ *
13
+ * Two deliberate semantics:
14
+ * - A `{*splat}` matches ZERO trailing segments, so `/api/{*rest}` matches
15
+ * `/api` (with `rest: ''`).
16
+ * - A method-less structural node is NOT a match: walking to a dead end fails
17
+ * and backtracks to param/splat siblings (so `/users/me` still matches
18
+ * `/users/:id` even when `/users/me/avatar` created a method-less `me` node).
19
+ */
20
+ /** Thrown when a path contains a malformed `%XX` sequence. */
21
+ export class MalformedPathError extends Error {
22
+ statusCode = 400;
23
+ constructor(message) {
24
+ super(message);
25
+ this.name = 'MalformedPathError';
26
+ }
27
+ }
28
+ /**
29
+ * - `null` → no path match (404).
30
+ * - `{ entry: null, allowedMethods }` → path matched, method didn't (405).
31
+ * - full result → success.
32
+ */
33
+ export function match(root, method, path) {
34
+ const upMethod = method.toUpperCase();
35
+ const segments = pathToSegments(path);
36
+ // An empty segment (from `//`) is unroutable — it must never match a param as
37
+ // ''. The path is well-formed (not a MalformedPathError), just a 404.
38
+ if (segments.includes('')) {
39
+ return null;
40
+ }
41
+ const result = walk(root, segments, 0, [], {}, [], undefined);
42
+ if (!result) {
43
+ return null;
44
+ }
45
+ const methods = result.node.methods;
46
+ if (!methods || Object.keys(methods).length === 0) {
47
+ return null;
48
+ }
49
+ const handler = resolveHandler(methods, upMethod);
50
+ const allowedMethods = Object.keys(methods);
51
+ if (methods.GET && !methods.HEAD) {
52
+ allowedMethods.push('HEAD');
53
+ }
54
+ let params = result.params;
55
+ if (handler?.paramNames && result.paramValues.length > 0) {
56
+ params = {};
57
+ for (let i = 0; i < handler.paramNames.length; i++) {
58
+ params[handler.paramNames[i]] = result.paramValues[i];
59
+ }
60
+ }
61
+ return {
62
+ entry: handler,
63
+ allowedMethods,
64
+ middlewares: handler
65
+ ? [...result.middlewares, ...(handler.middlewares ?? [])]
66
+ : result.middlewares,
67
+ params,
68
+ bodyParsing: handler?.bodyParsing ?? result.bodyParsing ?? 'parsed',
69
+ };
70
+ }
71
+ function nodeHasMethods(node) {
72
+ return !!node.methods && Object.keys(node.methods).length > 0;
73
+ }
74
+ function resolveHandler(methods, method) {
75
+ const direct = methods[method];
76
+ if (direct) {
77
+ return direct;
78
+ }
79
+ if (method === 'HEAD' && methods.GET) {
80
+ return methods.GET;
81
+ }
82
+ return null;
83
+ }
84
+ function walk(node, segments, index, parentMw, parentParams, parentParamValues, parentBodyParsing) {
85
+ const middlewares = [...parentMw, ...node.middlewares];
86
+ const bodyParsing = node.bodyParsing ?? parentBodyParsing;
87
+ if (index === segments.length) {
88
+ if (nodeHasMethods(node)) {
89
+ return {
90
+ node,
91
+ middlewares,
92
+ params: parentParams,
93
+ paramValues: parentParamValues,
94
+ bodyParsing,
95
+ };
96
+ }
97
+ // Zero-segment splat: a method-less node with a splat child that HAS
98
+ // methods matches the splat as ''.
99
+ if (node.splatChild && nodeHasMethods(node.splatChild)) {
100
+ const splatName = node.splatChild.segment.slice(1);
101
+ return {
102
+ node: node.splatChild,
103
+ middlewares: [...middlewares, ...node.splatChild.middlewares],
104
+ params: { ...parentParams, [splatName]: '' },
105
+ paramValues: [...parentParamValues, ''],
106
+ bodyParsing: node.splatChild.bodyParsing ?? bodyParsing,
107
+ };
108
+ }
109
+ // Dead-end structural node: fail so the caller falls through to its
110
+ // param/splat siblings instead of reporting a spurious 404.
111
+ return null;
112
+ }
113
+ const seg = segments[index];
114
+ const staticChild = lookupStaticChild(node.children, seg);
115
+ if (staticChild) {
116
+ const result = walk(staticChild, segments, index + 1, middlewares, parentParams, parentParamValues, bodyParsing);
117
+ if (result) {
118
+ return result;
119
+ }
120
+ }
121
+ if (node.paramChild) {
122
+ const paramName = node.paramChild.segment.slice(1);
123
+ const result = walk(node.paramChild, segments, index + 1, middlewares, { ...parentParams, [paramName]: seg }, [...parentParamValues, seg], bodyParsing);
124
+ if (result) {
125
+ return result;
126
+ }
127
+ }
128
+ if (node.splatChild) {
129
+ const splatName = node.splatChild.segment.slice(1);
130
+ const splatValue = segments.slice(index).join('/');
131
+ const result = walk(node.splatChild, segments, segments.length, middlewares, { ...parentParams, [splatName]: splatValue }, [...parentParamValues, splatValue], bodyParsing);
132
+ if (result) {
133
+ return result;
134
+ }
135
+ }
136
+ return null;
137
+ }
138
+ function lookupStaticChild(children, seg) {
139
+ // Children are keyed by lowercase segment (set at registration), so matching
140
+ // is a plain O(1) get — no per-request linear scan. Matching is always
141
+ // case-insensitive (Express's lenient default); a case-sensitive mode is a
142
+ // v6 concern and is not wired here.
143
+ return children.get(seg.toLowerCase());
144
+ }
145
+ function pathToSegments(path) {
146
+ let trimmed = path.startsWith('/') ? path.slice(1) : path;
147
+ // Lenient trailing slash: `/users/` matches `/users`.
148
+ if (trimmed.endsWith('/')) {
149
+ trimmed = trimmed.slice(0, -1);
150
+ }
151
+ if (trimmed === '') {
152
+ return [];
153
+ }
154
+ return trimmed.split('/').map(decodeSegment);
155
+ }
156
+ function decodeSegment(segment) {
157
+ try {
158
+ return decodeURIComponent(segment);
159
+ }
160
+ catch {
161
+ throw new MalformedPathError(`malformed URI sequence: "${segment}"`);
162
+ }
163
+ }
164
+ //# sourceMappingURL=match.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"match.js","sourceRoot":"","sources":["../../../../src/services/http/routing/match.ts"],"names":[],"mappings":"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"}