@adaptivestone/framework 5.0.0-beta.5 → 5.0.0-beta.50

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 (337) hide show
  1. package/CHANGELOG.md +1210 -530
  2. package/LICENCE +1 -1
  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 +18 -0
  8. package/dist/cluster.js.map +1 -0
  9. package/dist/codegen/appTypes.d.ts +19 -0
  10. package/dist/codegen/appTypes.js +49 -0
  11. package/dist/codegen/appTypes.js.map +1 -0
  12. package/dist/codegen/collectMetadata.d.ts +39 -0
  13. package/dist/codegen/collectMetadata.js +59 -0
  14. package/dist/codegen/collectMetadata.js.map +1 -0
  15. package/dist/codegen/emit.d.ts +29 -0
  16. package/dist/codegen/emit.js +325 -0
  17. package/dist/codegen/emit.js.map +1 -0
  18. package/dist/codegen/index.d.ts +16 -0
  19. package/dist/codegen/index.js +18 -0
  20. package/dist/codegen/index.js.map +1 -0
  21. package/dist/codegen/routeTypes.d.ts +13 -0
  22. package/dist/codegen/routeTypes.js +126 -0
  23. package/dist/codegen/routeTypes.js.map +1 -0
  24. package/dist/commands/CreateUser.d.ts +32 -0
  25. package/dist/commands/CreateUser.js +83 -0
  26. package/dist/commands/CreateUser.js.map +1 -0
  27. package/dist/commands/DropIndex.d.ts +16 -0
  28. package/dist/commands/DropIndex.js +30 -0
  29. package/dist/commands/DropIndex.js.map +1 -0
  30. package/dist/commands/GenerateRandomBytes.d.ts +7 -0
  31. package/dist/commands/GenerateRandomBytes.js +18 -0
  32. package/dist/commands/GenerateRandomBytes.js.map +1 -0
  33. package/dist/commands/GenerateTypes.d.ts +7 -0
  34. package/dist/commands/GenerateTypes.js +14 -0
  35. package/dist/commands/GenerateTypes.js.map +1 -0
  36. package/dist/commands/SyncIndexes.d.ts +6 -0
  37. package/dist/commands/SyncIndexes.js +31 -0
  38. package/dist/commands/SyncIndexes.js.map +1 -0
  39. package/dist/commands/migration/Create.d.ts +18 -0
  40. package/dist/commands/migration/Create.js +57 -0
  41. package/dist/commands/migration/Create.js.map +1 -0
  42. package/dist/commands/migration/Migrate.d.ts +6 -0
  43. package/dist/commands/migration/Migrate.js +43 -0
  44. package/dist/commands/migration/Migrate.js.map +1 -0
  45. package/dist/config/auth.d.ts +6 -0
  46. package/dist/config/auth.js +7 -0
  47. package/dist/config/auth.js.map +1 -0
  48. package/dist/config/http.d.ts +8 -0
  49. package/dist/config/http.js +10 -0
  50. package/dist/config/http.js.map +1 -0
  51. package/dist/config/i18n.d.ts +13 -0
  52. package/dist/config/i18n.js +13 -0
  53. package/dist/config/i18n.js.map +1 -0
  54. package/dist/config/ipDetector.d.ts +5 -0
  55. package/dist/config/ipDetector.js +15 -0
  56. package/dist/config/ipDetector.js.map +1 -0
  57. package/dist/config/log.d.ts +11 -0
  58. package/dist/config/log.js +20 -0
  59. package/dist/config/log.js.map +1 -0
  60. package/dist/config/mongo.d.ts +4 -0
  61. package/dist/config/mongo.js +4 -0
  62. package/dist/config/mongo.js.map +1 -0
  63. package/dist/config/rateLimiter.d.ts +13 -0
  64. package/dist/config/rateLimiter.js +17 -0
  65. package/dist/config/rateLimiter.js.map +1 -0
  66. package/dist/config/redis.d.ts +5 -0
  67. package/dist/config/redis.js +5 -0
  68. package/dist/config/redis.js.map +1 -0
  69. package/dist/config/validate.d.ts +4 -0
  70. package/dist/config/validate.js +4 -0
  71. package/dist/config/validate.js.map +1 -0
  72. package/dist/controllers/Auth.d.ts +74 -0
  73. package/dist/controllers/Auth.js +191 -0
  74. package/dist/controllers/Auth.js.map +1 -0
  75. package/dist/controllers/Auth.routes.gen.d.ts +57 -0
  76. package/dist/controllers/Auth.routes.gen.js +10 -0
  77. package/dist/controllers/Auth.routes.gen.js.map +1 -0
  78. package/dist/controllers/Home.d.ts +15 -0
  79. package/dist/controllers/Home.js +22 -0
  80. package/dist/controllers/Home.js.map +1 -0
  81. package/dist/controllers/Home.routes.gen.d.ts +14 -0
  82. package/dist/controllers/Home.routes.gen.js +10 -0
  83. package/dist/controllers/Home.routes.gen.js.map +1 -0
  84. package/dist/controllers/index.d.ts +36 -0
  85. package/dist/controllers/index.js +416 -0
  86. package/dist/controllers/index.js.map +1 -0
  87. package/dist/folderConfig.d.ts +34 -0
  88. package/dist/folderConfig.js +14 -0
  89. package/dist/folderConfig.js.map +1 -0
  90. package/dist/helpers/appInstance.d.ts +3 -0
  91. package/dist/helpers/appInstance.js +8 -0
  92. package/dist/helpers/appInstance.js.map +1 -0
  93. package/dist/helpers/crypto.d.ts +3 -0
  94. package/dist/helpers/crypto.js +17 -0
  95. package/dist/helpers/crypto.js.map +1 -0
  96. package/dist/helpers/files.d.ts +16 -0
  97. package/dist/helpers/files.js +78 -0
  98. package/dist/helpers/files.js.map +1 -0
  99. package/dist/helpers/logger.d.ts +4 -0
  100. package/dist/helpers/logger.js +20 -0
  101. package/dist/helpers/logger.js.map +1 -0
  102. package/dist/helpers/redis/clearNamespace.d.ts +2 -0
  103. package/dist/helpers/redis/clearNamespace.js +14 -0
  104. package/dist/helpers/redis/clearNamespace.js.map +1 -0
  105. package/dist/helpers/redis/redisConnection.d.ts +6 -0
  106. package/dist/helpers/redis/redisConnection.js +48 -0
  107. package/dist/helpers/redis/redisConnection.js.map +1 -0
  108. package/dist/helpers/yup.d.ts +13 -0
  109. package/{helpers → dist/helpers}/yup.js +9 -9
  110. package/dist/helpers/yup.js.map +1 -0
  111. package/dist/index.d.ts +1 -0
  112. package/dist/index.js +7 -0
  113. package/dist/index.js.map +1 -0
  114. package/dist/models/Lock.d.ts +90 -0
  115. package/dist/models/Lock.js +97 -0
  116. package/dist/models/Lock.js.map +1 -0
  117. package/dist/models/Migration.d.ts +13 -0
  118. package/dist/models/Migration.js +14 -0
  119. package/dist/models/Migration.js.map +1 -0
  120. package/dist/models/Sequence.d.ts +28 -0
  121. package/dist/models/Sequence.js +19 -0
  122. package/dist/models/Sequence.js.map +1 -0
  123. package/dist/models/User.d.ts +729 -0
  124. package/dist/models/User.js +294 -0
  125. package/dist/models/User.js.map +1 -0
  126. package/dist/models/UserOld.d.ts +190 -0
  127. package/dist/models/UserOld.js +230 -0
  128. package/dist/models/UserOld.js.map +1 -0
  129. package/dist/modules/AbstractCommand.d.ts +51 -0
  130. package/dist/modules/AbstractCommand.js +60 -0
  131. package/dist/modules/AbstractCommand.js.map +1 -0
  132. package/dist/modules/AbstractConnector.d.ts +5 -0
  133. package/dist/modules/AbstractConnector.js +8 -0
  134. package/dist/modules/AbstractConnector.js.map +1 -0
  135. package/dist/modules/AbstractController.d.ts +74 -0
  136. package/dist/modules/AbstractController.js +71 -0
  137. package/dist/modules/AbstractController.js.map +1 -0
  138. package/dist/modules/AbstractModel.d.ts +29 -0
  139. package/dist/modules/AbstractModel.js +42 -0
  140. package/dist/modules/AbstractModel.js.map +1 -0
  141. package/dist/modules/Base.d.ts +29 -0
  142. package/dist/modules/Base.js +58 -0
  143. package/dist/modules/Base.js.map +1 -0
  144. package/dist/modules/BaseCli.d.ts +25 -0
  145. package/dist/modules/BaseCli.js +148 -0
  146. package/dist/modules/BaseCli.js.map +1 -0
  147. package/dist/modules/BaseModel.d.ts +57 -0
  148. package/dist/modules/BaseModel.js +37 -0
  149. package/dist/modules/BaseModel.js.map +1 -0
  150. package/dist/server.d.ts +122 -0
  151. package/dist/server.js +478 -0
  152. package/dist/server.js.map +1 -0
  153. package/dist/services/cache/Cache.d.ts +31 -0
  154. package/dist/services/cache/Cache.js +103 -0
  155. package/dist/services/cache/Cache.js.map +1 -0
  156. package/dist/services/http/HttpServer.d.ts +44 -0
  157. package/dist/services/http/HttpServer.js +81 -0
  158. package/dist/services/http/HttpServer.js.map +1 -0
  159. package/dist/services/http/middleware/AbstractMiddleware.d.ts +41 -0
  160. package/dist/services/http/middleware/AbstractMiddleware.js +52 -0
  161. package/dist/services/http/middleware/AbstractMiddleware.js.map +1 -0
  162. package/dist/services/http/middleware/Auth.d.ts +9 -0
  163. package/dist/services/http/middleware/Auth.js +18 -0
  164. package/dist/services/http/middleware/Auth.js.map +1 -0
  165. package/dist/services/http/middleware/Cors.d.ts +12 -0
  166. package/dist/services/http/middleware/Cors.js +36 -0
  167. package/dist/services/http/middleware/Cors.js.map +1 -0
  168. package/dist/services/http/middleware/GetUserByToken.d.ts +36 -0
  169. package/dist/services/http/middleware/GetUserByToken.js +56 -0
  170. package/dist/services/http/middleware/GetUserByToken.js.map +1 -0
  171. package/dist/services/http/middleware/I18n.d.ts +23 -0
  172. package/dist/services/http/middleware/I18n.js +61 -0
  173. package/dist/services/http/middleware/I18n.js.map +1 -0
  174. package/dist/services/http/middleware/IpDetector.d.ts +14 -0
  175. package/dist/services/http/middleware/IpDetector.js +55 -0
  176. package/dist/services/http/middleware/IpDetector.js.map +1 -0
  177. package/dist/services/http/middleware/Pagination.d.ts +28 -0
  178. package/dist/services/http/middleware/Pagination.js +49 -0
  179. package/dist/services/http/middleware/Pagination.js.map +1 -0
  180. package/dist/services/http/middleware/PrepareAppInfo.d.ts +8 -0
  181. package/dist/services/http/middleware/PrepareAppInfo.js +17 -0
  182. package/dist/services/http/middleware/PrepareAppInfo.js.map +1 -0
  183. package/dist/services/http/middleware/RateLimiter.d.ts +26 -0
  184. package/dist/services/http/middleware/RateLimiter.js +102 -0
  185. package/dist/services/http/middleware/RateLimiter.js.map +1 -0
  186. package/dist/services/http/middleware/RequestLogger.d.ts +8 -0
  187. package/dist/services/http/middleware/RequestLogger.js +18 -0
  188. package/dist/services/http/middleware/RequestLogger.js.map +1 -0
  189. package/dist/services/http/middleware/RequestParser.d.ts +8 -0
  190. package/dist/services/http/middleware/RequestParser.js +35 -0
  191. package/dist/services/http/middleware/RequestParser.js.map +1 -0
  192. package/dist/services/http/middleware/Role.d.ts +12 -0
  193. package/dist/services/http/middleware/Role.js +24 -0
  194. package/dist/services/http/middleware/Role.js.map +1 -0
  195. package/dist/services/http/routing/ExpressAdapter.d.ts +12 -0
  196. package/dist/services/http/routing/ExpressAdapter.js +93 -0
  197. package/dist/services/http/routing/ExpressAdapter.js.map +1 -0
  198. package/dist/services/http/routing/RouteNode.d.ts +101 -0
  199. package/dist/services/http/routing/RouteNode.js +21 -0
  200. package/dist/services/http/routing/RouteNode.js.map +1 -0
  201. package/dist/services/http/routing/RouteRegistry.d.ts +37 -0
  202. package/dist/services/http/routing/RouteRegistry.js +201 -0
  203. package/dist/services/http/routing/RouteRegistry.js.map +1 -0
  204. package/dist/services/http/routing/formatTree.d.ts +23 -0
  205. package/dist/services/http/routing/formatTree.js +158 -0
  206. package/dist/services/http/routing/formatTree.js.map +1 -0
  207. package/dist/services/http/routing/match.d.ts +30 -0
  208. package/dist/services/http/routing/match.js +136 -0
  209. package/dist/services/http/routing/match.js.map +1 -0
  210. package/dist/services/http/routing/middlewareNormalization.d.ts +16 -0
  211. package/dist/services/http/routing/middlewareNormalization.js +28 -0
  212. package/dist/services/http/routing/middlewareNormalization.js.map +1 -0
  213. package/dist/services/http/types.d.ts +74 -0
  214. package/dist/services/http/types.js +8 -0
  215. package/dist/services/http/types.js.map +1 -0
  216. package/dist/services/i18n/I18n.d.ts +15 -0
  217. package/dist/services/i18n/I18n.js +58 -0
  218. package/dist/services/i18n/I18n.js.map +1 -0
  219. package/dist/services/logging/SentryTransport.d.ts +13 -0
  220. package/dist/services/logging/SentryTransport.js +121 -0
  221. package/dist/services/logging/SentryTransport.js.map +1 -0
  222. package/dist/services/validate/ValidateService.d.ts +54 -0
  223. package/dist/services/validate/ValidateService.js +122 -0
  224. package/dist/services/validate/ValidateService.js.map +1 -0
  225. package/dist/services/validate/ValidationError.d.ts +35 -0
  226. package/dist/services/validate/ValidationError.js +77 -0
  227. package/dist/services/validate/ValidationError.js.map +1 -0
  228. package/dist/services/validate/drivers/StandardSchemaDriver.d.ts +15 -0
  229. package/dist/services/validate/drivers/StandardSchemaDriver.js +34 -0
  230. package/dist/services/validate/drivers/StandardSchemaDriver.js.map +1 -0
  231. package/dist/services/validate/drivers/YupDriver.d.ts +21 -0
  232. package/dist/services/validate/drivers/YupDriver.js +66 -0
  233. package/dist/services/validate/drivers/YupDriver.js.map +1 -0
  234. package/dist/services/validate/types.d.ts +104 -0
  235. package/dist/services/validate/types.js +11 -0
  236. package/dist/services/validate/types.js.map +1 -0
  237. package/dist/tests/frameworkVitestSetup.d.ts +1 -0
  238. package/dist/tests/frameworkVitestSetup.js +9 -0
  239. package/dist/tests/frameworkVitestSetup.js.map +1 -0
  240. package/dist/tests/globalSetupVitest.d.ts +3 -0
  241. package/dist/tests/globalSetupVitest.js +29 -0
  242. package/dist/tests/globalSetupVitest.js.map +1 -0
  243. package/dist/tests/setupVitest.d.ts +1 -0
  244. package/dist/tests/setupVitest.js +91 -0
  245. package/dist/tests/setupVitest.js.map +1 -0
  246. package/dist/tests/testHelpers.d.ts +361 -0
  247. package/dist/tests/testHelpers.js +48 -0
  248. package/dist/tests/testHelpers.js.map +1 -0
  249. package/package.json +63 -43
  250. package/Cli.js +0 -22
  251. package/cluster.js +0 -25
  252. package/commands/CreateUser.js +0 -75
  253. package/commands/Documentation.js +0 -17
  254. package/commands/DropIndex.js +0 -29
  255. package/commands/GenerateRandomBytes.js +0 -21
  256. package/commands/GetOpenApiJson.js +0 -324
  257. package/commands/SyncIndexes.js +0 -39
  258. package/commands/migration/Create.js +0 -61
  259. package/commands/migration/Migrate.js +0 -55
  260. package/config/auth.js +0 -9
  261. package/config/http.js +0 -9
  262. package/config/i18n.js +0 -12
  263. package/config/ipDetector.js +0 -14
  264. package/config/log.js +0 -22
  265. package/config/mail.js +0 -29
  266. package/config/mongo.js +0 -3
  267. package/config/rateLimiter.js +0 -16
  268. package/config/redis.js +0 -4
  269. package/config/validate.js +0 -3
  270. package/controllers/Auth.js +0 -204
  271. package/controllers/Home.js +0 -28
  272. package/controllers/index.js +0 -60
  273. package/eslint.config.js +0 -44
  274. package/folderConfig.js +0 -14
  275. package/helpers/files.js +0 -76
  276. package/helpers/logger.js +0 -16
  277. package/helpers/redis/clearNamespace.js +0 -14
  278. package/index.js +0 -8
  279. package/jsconfig.json +0 -9
  280. package/locales/en/translation.json +0 -27
  281. package/locales/ru/translation.json +0 -27
  282. package/migrations/.gitkeep +0 -0
  283. package/models/Migration.js +0 -15
  284. package/models/Sequence.js +0 -22
  285. package/models/User.js +0 -261
  286. package/modules/AbstractCommand.js +0 -43
  287. package/modules/AbstractConnector.js +0 -9
  288. package/modules/AbstractController.js +0 -406
  289. package/modules/AbstractModel.d.ts +0 -48
  290. package/modules/AbstractModel.js +0 -92
  291. package/modules/Base.d.ts +0 -37
  292. package/modules/Base.js +0 -63
  293. package/modules/BaseCli.js +0 -94
  294. package/server.d.ts +0 -98
  295. package/server.js +0 -437
  296. package/services/cache/Cache.d.ts +0 -35
  297. package/services/cache/Cache.js +0 -124
  298. package/services/documentation/DocumentationGenerator.js +0 -169
  299. package/services/http/HttpServer.js +0 -95
  300. package/services/http/middleware/AbstractMiddleware.js +0 -51
  301. package/services/http/middleware/Auth.js +0 -20
  302. package/services/http/middleware/Cors.js +0 -46
  303. package/services/http/middleware/GetUserByToken.js +0 -47
  304. package/services/http/middleware/I18n.js +0 -117
  305. package/services/http/middleware/IpDetector.js +0 -59
  306. package/services/http/middleware/Pagination.js +0 -57
  307. package/services/http/middleware/PrepareAppInfo.js +0 -18
  308. package/services/http/middleware/RateLimiter.js +0 -134
  309. package/services/http/middleware/RequestLogger.js +0 -22
  310. package/services/http/middleware/RequestParser.js +0 -40
  311. package/services/http/middleware/Role.js +0 -29
  312. package/services/messaging/email/index.js +0 -217
  313. package/services/messaging/email/resources/.gitkeep +0 -1
  314. package/services/messaging/email/templates/emptyTemplate/html.pug +0 -9
  315. package/services/messaging/email/templates/emptyTemplate/subject.pug +0 -1
  316. package/services/messaging/email/templates/emptyTemplate/text.pug +0 -1
  317. package/services/messaging/email/templates/recovery/html.pug +0 -8
  318. package/services/messaging/email/templates/recovery/subject.pug +0 -2
  319. package/services/messaging/email/templates/recovery/text.pug +0 -3
  320. package/services/messaging/email/templates/verification/html.pug +0 -10
  321. package/services/messaging/email/templates/verification/subject.pug +0 -1
  322. package/services/messaging/email/templates/verification/text.pug +0 -1
  323. package/services/messaging/index.js +0 -3
  324. package/services/validate/ValidateService.js +0 -157
  325. package/services/validate/drivers/AbstractValidator.js +0 -37
  326. package/services/validate/drivers/CustomValidator.js +0 -51
  327. package/services/validate/drivers/YupValidator.js +0 -103
  328. package/tests/globalSetupVitest.js +0 -35
  329. package/tests/setup.js +0 -116
  330. package/tests/setupVitest.js +0 -107
  331. package/types/Expand.d.ts +0 -11
  332. package/types/TFoldersConfig.d.ts +0 -17
  333. package/views/404.pug +0 -3
  334. package/views/home.pug +0 -3
  335. package/views/layouts/base.pug +0 -39
  336. package/vitest.config.js +0 -16
  337. /package/{commands → dist/migrations}/.gitkeep +0 -0
@@ -0,0 +1,201 @@
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
+ for (const seg of pathSegments(prefix)) {
31
+ target = ensureChildBySegment(target, seg);
32
+ }
33
+ mergeNode(target, subtree);
34
+ }
35
+ /**
36
+ * Register a single ad-hoc route. Escape hatch for routes that don't
37
+ * fit the controller convention (webhooks, healthchecks, OAuth callbacks).
38
+ */
39
+ registerRoute(method, path, entry) {
40
+ let target = this.root;
41
+ const paramNames = [];
42
+ for (const seg of pathSegments(path)) {
43
+ if (seg.startsWith(':') || seg.startsWith('*')) {
44
+ paramNames.push(seg.slice(1));
45
+ }
46
+ target = ensureChildBySegment(target, seg);
47
+ }
48
+ if (!target.methods) {
49
+ target.methods = {};
50
+ }
51
+ if (target.methods[method]) {
52
+ throw new Error(`RouteRegistry: route ${method} ${path} already registered`);
53
+ }
54
+ if (paramNames.length > 0) {
55
+ entry.paramNames = paramNames;
56
+ }
57
+ target.methods[method] = entry;
58
+ }
59
+ /** Walk depth-first; `fullPath` is the slash-joined path to the node. */
60
+ walk(visitor) {
61
+ walkRecursive(this.root, '', visitor);
62
+ }
63
+ /**
64
+ * Flatten to one entry per (method, full-path) leaf. Middlewares are
65
+ * accumulated root → leaf; `bodyParsing` inherits leaf-wins.
66
+ */
67
+ flatten() {
68
+ const out = [];
69
+ flattenRecursive(this.root, '', undefined, [], out);
70
+ return out;
71
+ }
72
+ /** Match a request. See `MatchResult` for return cases (404 / 405 / hit). */
73
+ match(method, path) {
74
+ return match(this.root, method, path);
75
+ }
76
+ }
77
+ // ─── path helpers ────────────────────────────────────────────────────
78
+ function pathSegments(path) {
79
+ return path.split('/').filter((s) => s.length > 0);
80
+ }
81
+ function joinPath(prefix, segment) {
82
+ if (segment === '') {
83
+ return prefix === '' ? '/' : prefix;
84
+ }
85
+ const joined = `${prefix}/${segment}`;
86
+ return joined.startsWith('//') ? joined.slice(1) : joined;
87
+ }
88
+ // ─── tree mutation ───────────────────────────────────────────────────
89
+ function ensureChildBySegment(node, segment) {
90
+ if (node.segment.startsWith('*')) {
91
+ 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`);
92
+ }
93
+ if (segment.startsWith(':')) {
94
+ if (!node.paramChild) {
95
+ node.paramChild = createNode(segment);
96
+ }
97
+ return node.paramChild;
98
+ }
99
+ if (segment.startsWith('*')) {
100
+ if (!node.splatChild) {
101
+ node.splatChild = createNode(segment);
102
+ }
103
+ return node.splatChild;
104
+ }
105
+ let child = node.children.get(segment);
106
+ if (!child) {
107
+ child = createNode(segment);
108
+ node.children.set(segment, child);
109
+ }
110
+ return child;
111
+ }
112
+ function mergeNode(target, source) {
113
+ target.middlewares.push(...source.middlewares);
114
+ if (source.methods) {
115
+ if (!target.methods) {
116
+ target.methods = {};
117
+ }
118
+ for (const m of Object.keys(source.methods)) {
119
+ const handler = source.methods[m];
120
+ if (!handler) {
121
+ continue;
122
+ }
123
+ if (target.methods[m]) {
124
+ throw new Error(`RouteRegistry: conflicting handler for ${m} on segment "${target.segment}"`);
125
+ }
126
+ target.methods[m] = handler;
127
+ }
128
+ }
129
+ for (const [seg, child] of source.children) {
130
+ const existing = target.children.get(seg);
131
+ if (existing) {
132
+ mergeNode(existing, child);
133
+ }
134
+ else {
135
+ target.children.set(seg, child);
136
+ }
137
+ }
138
+ if (source.paramChild) {
139
+ if (target.paramChild) {
140
+ mergeNode(target.paramChild, source.paramChild);
141
+ }
142
+ else {
143
+ target.paramChild = source.paramChild;
144
+ }
145
+ }
146
+ if (source.splatChild) {
147
+ if (target.splatChild) {
148
+ mergeNode(target.splatChild, source.splatChild);
149
+ }
150
+ else {
151
+ target.splatChild = source.splatChild;
152
+ }
153
+ }
154
+ if (source.bodyParsing !== undefined) {
155
+ target.bodyParsing = source.bodyParsing;
156
+ }
157
+ }
158
+ // ─── tree traversal ──────────────────────────────────────────────────
159
+ function walkRecursive(node, prefix, visitor) {
160
+ const fullPath = joinPath(prefix, node.segment);
161
+ visitor(node, fullPath);
162
+ for (const child of node.children.values()) {
163
+ walkRecursive(child, fullPath, visitor);
164
+ }
165
+ if (node.paramChild) {
166
+ walkRecursive(node.paramChild, fullPath, visitor);
167
+ }
168
+ if (node.splatChild) {
169
+ walkRecursive(node.splatChild, fullPath, visitor);
170
+ }
171
+ }
172
+ function flattenRecursive(node, prefix, inheritedBodyParsing, inheritedMw, out) {
173
+ const fullPath = joinPath(prefix, node.segment);
174
+ const middlewares = [...inheritedMw, ...node.middlewares];
175
+ const bodyParsing = node.bodyParsing ?? inheritedBodyParsing;
176
+ if (node.methods) {
177
+ for (const m of Object.keys(node.methods)) {
178
+ const entry = node.methods[m];
179
+ if (!entry) {
180
+ continue;
181
+ }
182
+ out.push({
183
+ method: m,
184
+ path: fullPath,
185
+ entry,
186
+ middlewares: [...middlewares, ...(entry.middlewares ?? [])],
187
+ bodyParsing: entry.bodyParsing ?? bodyParsing ?? 'parsed',
188
+ });
189
+ }
190
+ }
191
+ for (const child of node.children.values()) {
192
+ flattenRecursive(child, fullPath, bodyParsing, middlewares, out);
193
+ }
194
+ if (node.paramChild) {
195
+ flattenRecursive(node.paramChild, fullPath, bodyParsing, middlewares, out);
196
+ }
197
+ if (node.splatChild) {
198
+ flattenRecursive(node.splatChild, fullPath, bodyParsing, middlewares, out);
199
+ }
200
+ }
201
+ //# 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,158 @@
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. Re-attachments of an inherited class are
48
+ // deduped at runtime, so showing them here as `mw:` would be noise.
49
+ // Inherited ones are listed separately as `pmw:` (parent middleware) so
50
+ // you can see what came from above.
51
+ const ancestorClasses = new Set(ancestorMws.map((m) => m.Class));
52
+ const nodeNewMws = node.middlewares.filter((m) => !ancestorClasses.has(m.Class));
53
+ // Render this node's line. Root is special: render as `/` instead of empty.
54
+ const isRoot = node.segment === '' && counts.nodes === 1;
55
+ if (isRoot && !showRoot) {
56
+ // skip the root line itself, but still descend
57
+ }
58
+ else {
59
+ const branch = isRoot ? '' : `${DIM}${isLast ? '└── ' : '├── '}${RESET}`;
60
+ const seg = isRoot ? '/' : colorSegment(node.segment);
61
+ const mwSuffix = nodeNewMws.length > 0
62
+ ? `${DIM} (mw: ${formatMwList(nodeNewMws)}${ancestorMws.length > 0
63
+ ? `; pmw: ${formatMwList(dedupByClass(ancestorMws))}`
64
+ : ''})${RESET}`
65
+ : '';
66
+ lines.push(`${indent}${branch}${seg}${mwSuffix}`);
67
+ }
68
+ // Render handler methods on this node.
69
+ if (node.methods) {
70
+ const methodKeys = Object.keys(node.methods);
71
+ const childIndent = isRoot
72
+ ? indent
73
+ : indent + (isLast ? ' ' : `${DIM}│${RESET} `);
74
+ for (let i = 0; i < methodKeys.length; i++) {
75
+ const m = methodKeys[i];
76
+ const entry = node.methods[m];
77
+ if (!entry) {
78
+ continue;
79
+ }
80
+ counts.routes += 1;
81
+ const flags = [];
82
+ if (entry.request) {
83
+ flags.push('request');
84
+ }
85
+ if (entry.query) {
86
+ flags.push('query');
87
+ }
88
+ // Filter route-level middlewares against everything that already runs
89
+ // at this node (ancestors + node-local). `mw:` lists what's newly
90
+ // added for this specific route entry; `pmw:` lists the full chain
91
+ // that runs before it (deduped, in chain order) — so the route line
92
+ // is self-contained for "what runs for this exact route".
93
+ const chainAtNode = [...ancestorMws, ...node.middlewares];
94
+ const chainAtNodeClasses = new Set(chainAtNode.map((mw) => mw.Class));
95
+ const routeNewMws = entry.middlewares?.filter((mw) => !chainAtNodeClasses.has(mw.Class)) ??
96
+ [];
97
+ if (routeNewMws.length > 0) {
98
+ const parentPart = chainAtNode.length > 0
99
+ ? `; pmw: ${formatMwList(dedupByClass(chainAtNode))}`
100
+ : '';
101
+ flags.push(`mw: ${formatMwList(routeNewMws)}${parentPart}`);
102
+ }
103
+ const flagSuffix = flags.length
104
+ ? ` ${FLAG}[${flags.join(', ')}]${RESET}`
105
+ : '';
106
+ const isLastMethod = i === methodKeys.length - 1 &&
107
+ node.children.size === 0 &&
108
+ !node.paramChild &&
109
+ !node.splatChild;
110
+ const methodBranch = `${DIM}${isLastMethod ? '└── ' : '├── '}${RESET}`;
111
+ const methodColor = METHOD_COLORS[m] ?? '';
112
+ const paddedMethod = m.padEnd(7);
113
+ lines.push(`${childIndent}${methodBranch}${methodColor}${paddedMethod}${RESET} ${fullPath}${flagSuffix}`);
114
+ }
115
+ }
116
+ // Recurse: static children, then paramChild, then splatChild.
117
+ const allChildren = [...node.children.values()];
118
+ if (node.paramChild) {
119
+ allChildren.push(node.paramChild);
120
+ }
121
+ if (node.splatChild) {
122
+ allChildren.push(node.splatChild);
123
+ }
124
+ const childIndent = isRoot
125
+ ? indent
126
+ : indent + (isLast ? ' ' : `${DIM}│${RESET} `);
127
+ const chainForChildren = [...ancestorMws, ...node.middlewares];
128
+ for (let i = 0; i < allChildren.length; i++) {
129
+ formatNode(
130
+ // biome-ignore lint/style/noNonNullAssertion: i is in bounds
131
+ allChildren[i],
132
+ // biome-ignore lint/style/noNonNullAssertion: i is in bounds
133
+ joinPath(fullPath, allChildren[i].segment), chainForChildren, childIndent, i === allChildren.length - 1, lines, counts, showRoot);
134
+ }
135
+ }
136
+ function formatMwList(mws) {
137
+ return mws
138
+ .map((m) => (m.params ? `${m.Class.name}{…}` : m.Class.name))
139
+ .join(', ');
140
+ }
141
+ function colorSegment(segment) {
142
+ if (segment.startsWith(':') || segment.startsWith('*')) {
143
+ return `${PARAM}${segment}${RESET}`;
144
+ }
145
+ return segment;
146
+ }
147
+ function dedupByClass(mws) {
148
+ const seen = new Set();
149
+ const out = [];
150
+ for (const m of mws) {
151
+ if (!seen.has(m.Class)) {
152
+ seen.add(m.Class);
153
+ out.push(m);
154
+ }
155
+ }
156
+ return out;
157
+ }
158
+ //# 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,30 @@
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
+ import type { MatchResult, RouteNode } from './RouteNode.ts';
14
+ /** Thrown when a path contains a malformed `%XX` sequence. */
15
+ export declare class MalformedPathError extends Error {
16
+ readonly statusCode = 400;
17
+ constructor(message: string);
18
+ }
19
+ export interface MatchOptions {
20
+ /** Default `false` — `'/Users'` matches `'/users'`. */
21
+ caseSensitive?: boolean;
22
+ /** Default `false` — `'/users/'` matches `'/users'`. */
23
+ strictTrailingSlash?: boolean;
24
+ }
25
+ /**
26
+ * - `null` → no path match (404).
27
+ * - `{ entry: null, allowedMethods }` → path matched, method didn't (405).
28
+ * - full result → success.
29
+ */
30
+ export declare function match(root: RouteNode, method: string, path: string, options?: MatchOptions): MatchResult | null;
@@ -0,0 +1,136 @@
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
+ /** Thrown when a path contains a malformed `%XX` sequence. */
14
+ export class MalformedPathError extends Error {
15
+ statusCode = 400;
16
+ constructor(message) {
17
+ super(message);
18
+ this.name = 'MalformedPathError';
19
+ }
20
+ }
21
+ /**
22
+ * - `null` → no path match (404).
23
+ * - `{ entry: null, allowedMethods }` → path matched, method didn't (405).
24
+ * - full result → success.
25
+ */
26
+ export function match(root, method, path, options = {}) {
27
+ const upMethod = method.toUpperCase();
28
+ const segments = pathToSegments(path, options.strictTrailingSlash ?? false);
29
+ const result = walk(root, segments, 0, [], {}, [], undefined, options.caseSensitive ?? false);
30
+ if (!result) {
31
+ return null;
32
+ }
33
+ const methods = result.node.methods;
34
+ if (!methods || Object.keys(methods).length === 0) {
35
+ return null;
36
+ }
37
+ const handler = resolveHandler(methods, upMethod);
38
+ const allowedMethods = Object.keys(methods);
39
+ if (methods.GET && !methods.HEAD) {
40
+ allowedMethods.push('HEAD');
41
+ }
42
+ let params = result.params;
43
+ if (handler?.paramNames && result.paramValues.length > 0) {
44
+ params = {};
45
+ for (let i = 0; i < handler.paramNames.length; i++) {
46
+ params[handler.paramNames[i]] = result.paramValues[i];
47
+ }
48
+ }
49
+ return {
50
+ entry: handler,
51
+ allowedMethods,
52
+ middlewares: handler
53
+ ? [...result.middlewares, ...(handler.middlewares ?? [])]
54
+ : result.middlewares,
55
+ params,
56
+ bodyParsing: handler?.bodyParsing ?? result.bodyParsing ?? 'parsed',
57
+ };
58
+ }
59
+ function resolveHandler(methods, method) {
60
+ const direct = methods[method];
61
+ if (direct) {
62
+ return direct;
63
+ }
64
+ if (method === 'HEAD' && methods.GET) {
65
+ return methods.GET;
66
+ }
67
+ return null;
68
+ }
69
+ function walk(node, segments, index, parentMw, parentParams, parentParamValues, parentBodyParsing, caseSensitive) {
70
+ const middlewares = [...parentMw, ...node.middlewares];
71
+ const bodyParsing = node.bodyParsing ?? parentBodyParsing;
72
+ if (index === segments.length) {
73
+ return {
74
+ node,
75
+ middlewares,
76
+ params: parentParams,
77
+ paramValues: parentParamValues,
78
+ bodyParsing,
79
+ };
80
+ }
81
+ const seg = segments[index];
82
+ const staticChild = lookupStaticChild(node.children, seg, caseSensitive);
83
+ if (staticChild) {
84
+ const result = walk(staticChild, segments, index + 1, middlewares, parentParams, parentParamValues, bodyParsing, caseSensitive);
85
+ if (result) {
86
+ return result;
87
+ }
88
+ }
89
+ if (node.paramChild) {
90
+ const paramName = node.paramChild.segment.slice(1);
91
+ const result = walk(node.paramChild, segments, index + 1, middlewares, { ...parentParams, [paramName]: seg }, [...parentParamValues, seg], bodyParsing, caseSensitive);
92
+ if (result) {
93
+ return result;
94
+ }
95
+ }
96
+ if (node.splatChild) {
97
+ const splatName = node.splatChild.segment.slice(1);
98
+ const splatValue = segments.slice(index).join('/');
99
+ const result = walk(node.splatChild, segments, segments.length, middlewares, { ...parentParams, [splatName]: splatValue }, [...parentParamValues, splatValue], bodyParsing, caseSensitive);
100
+ if (result) {
101
+ return result;
102
+ }
103
+ }
104
+ return null;
105
+ }
106
+ function lookupStaticChild(children, seg, caseSensitive) {
107
+ if (caseSensitive) {
108
+ return children.get(seg);
109
+ }
110
+ const lower = seg.toLowerCase();
111
+ for (const [key, child] of children) {
112
+ if (key.toLowerCase() === lower) {
113
+ return child;
114
+ }
115
+ }
116
+ return undefined;
117
+ }
118
+ function pathToSegments(path, strict) {
119
+ let trimmed = path.startsWith('/') ? path.slice(1) : path;
120
+ if (!strict && trimmed.endsWith('/')) {
121
+ trimmed = trimmed.slice(0, -1);
122
+ }
123
+ if (trimmed === '') {
124
+ return [];
125
+ }
126
+ return trimmed.split('/').map(decodeSegment);
127
+ }
128
+ function decodeSegment(segment) {
129
+ try {
130
+ return decodeURIComponent(segment);
131
+ }
132
+ catch {
133
+ throw new MalformedPathError(`malformed URI sequence: "${segment}"`);
134
+ }
135
+ }
136
+ //# 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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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Convert authoring shorthand (`Class` or `[Class, params]`) into
3
+ * canonical `MiddlewareEntry`. The registry stores only canonical form;
4
+ * shorthand exists at the user-authoring boundary.
5
+ *
6
+ * `source` is caller-supplied — class references carry no import-path
7
+ * info at runtime. Convention:
8
+ * - `{ kind: 'package', spec: 'pkg/sub/path' }` for npm imports
9
+ * - `{ kind: 'file', spec: 'src/middleware/My.ts' }` for project files
10
+ */
11
+ import type AbstractMiddleware from '../middleware/AbstractMiddleware.ts';
12
+ import type { MiddlewareEntry } from './RouteNode.ts';
13
+ export type MiddlewareSpec = typeof AbstractMiddleware | readonly [typeof AbstractMiddleware, Record<string, unknown>];
14
+ /** Throws `TypeError` on malformed input. */
15
+ export declare function normalizeMiddleware(spec: MiddlewareSpec, source: MiddlewareEntry['source']): MiddlewareEntry;
16
+ export declare function normalizeMiddlewares(specs: ReadonlyArray<MiddlewareSpec>, source: MiddlewareEntry['source']): MiddlewareEntry[];
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Convert authoring shorthand (`Class` or `[Class, params]`) into
3
+ * canonical `MiddlewareEntry`. The registry stores only canonical form;
4
+ * shorthand exists at the user-authoring boundary.
5
+ *
6
+ * `source` is caller-supplied — class references carry no import-path
7
+ * info at runtime. Convention:
8
+ * - `{ kind: 'package', spec: 'pkg/sub/path' }` for npm imports
9
+ * - `{ kind: 'file', spec: 'src/middleware/My.ts' }` for project files
10
+ */
11
+ /** Throws `TypeError` on malformed input. */
12
+ export function normalizeMiddleware(spec, source) {
13
+ if (Array.isArray(spec)) {
14
+ const [Class, params] = spec;
15
+ if (typeof Class !== 'function') {
16
+ throw new TypeError(`normalizeMiddleware: tuple form expected [Class, params] but got [${typeof Class}, …]`);
17
+ }
18
+ return { Class, params, source };
19
+ }
20
+ if (typeof spec !== 'function') {
21
+ throw new TypeError(`normalizeMiddleware: expected middleware class or [Class, params] tuple, got ${typeof spec}`);
22
+ }
23
+ return { Class: spec, source };
24
+ }
25
+ export function normalizeMiddlewares(specs, source) {
26
+ return specs.map((spec) => normalizeMiddleware(spec, source));
27
+ }
28
+ //# sourceMappingURL=middlewareNormalization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middlewareNormalization.js","sourceRoot":"","sources":["../../../../src/services/http/routing/middlewareNormalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CACjC,IAAoB,EACpB,MAAiC;IAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAGvB,CAAC;QACF,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CACjB,qEAAqE,OAAO,KAAK,MAAM,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CACjB,gFAAgF,OAAO,IAAI,EAAE,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAoC,EACpC,MAAiC;IAEjC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAChE,CAAC"}