@adaptivestone/framework 5.0.0-beta.44 → 5.0.0-beta.47

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 (122) hide show
  1. package/CHANGELOG.md +30 -2
  2. package/dist/codegen/appTypes.d.ts +19 -0
  3. package/dist/codegen/appTypes.js +49 -0
  4. package/dist/codegen/appTypes.js.map +1 -0
  5. package/dist/codegen/collectMetadata.d.ts +37 -0
  6. package/dist/codegen/collectMetadata.js +51 -0
  7. package/dist/codegen/collectMetadata.js.map +1 -0
  8. package/dist/codegen/emit.d.ts +29 -0
  9. package/dist/codegen/emit.js +214 -0
  10. package/dist/codegen/emit.js.map +1 -0
  11. package/dist/codegen/index.d.ts +16 -0
  12. package/dist/codegen/index.js +18 -0
  13. package/dist/codegen/index.js.map +1 -0
  14. package/dist/codegen/routeTypes.d.ts +13 -0
  15. package/dist/codegen/routeTypes.js +126 -0
  16. package/dist/codegen/routeTypes.js.map +1 -0
  17. package/dist/commands/GenerateTypes.d.ts +0 -4
  18. package/dist/commands/GenerateTypes.js +4 -42
  19. package/dist/commands/GenerateTypes.js.map +1 -1
  20. package/dist/controllers/Auth.d.ts +15 -124
  21. package/dist/controllers/Auth.js.map +1 -1
  22. package/dist/controllers/Auth.routes.gen.d.ts +57 -0
  23. package/dist/controllers/Auth.routes.gen.js +10 -0
  24. package/dist/controllers/Auth.routes.gen.js.map +1 -0
  25. package/dist/controllers/Home.routes.gen.d.ts +14 -0
  26. package/dist/controllers/Home.routes.gen.js +10 -0
  27. package/dist/controllers/Home.routes.gen.js.map +1 -0
  28. package/dist/controllers/index.d.ts +23 -3
  29. package/dist/controllers/index.js +355 -8
  30. package/dist/controllers/index.js.map +1 -1
  31. package/dist/helpers/files.js +2 -0
  32. package/dist/helpers/files.js.map +1 -1
  33. package/dist/helpers/logger.d.ts +1 -1
  34. package/dist/helpers/logger.js +1 -1
  35. package/dist/helpers/logger.js.map +1 -1
  36. package/dist/models/Lock.js +1 -1
  37. package/dist/models/Lock.js.map +1 -1
  38. package/dist/models/Sequence.js +1 -1
  39. package/dist/models/Sequence.js.map +1 -1
  40. package/dist/models/User.d.ts +28 -28
  41. package/dist/models/UserOld.d.ts +16 -6
  42. package/dist/modules/AbstractController.d.ts +10 -31
  43. package/dist/modules/AbstractController.js +1 -253
  44. package/dist/modules/AbstractController.js.map +1 -1
  45. package/dist/modules/BaseCli.d.ts +1 -1
  46. package/dist/modules/BaseCli.js +1 -0
  47. package/dist/modules/BaseCli.js.map +1 -1
  48. package/dist/server.d.ts +2 -3
  49. package/dist/server.js +11 -1
  50. package/dist/server.js.map +1 -1
  51. package/dist/services/cache/Cache.d.ts +1 -1
  52. package/dist/services/cache/Cache.js +9 -8
  53. package/dist/services/cache/Cache.js.map +1 -1
  54. package/dist/services/http/HttpServer.d.ts +9 -0
  55. package/dist/services/http/HttpServer.js +20 -9
  56. package/dist/services/http/HttpServer.js.map +1 -1
  57. package/dist/services/http/middleware/AbstractMiddleware.d.ts +19 -4
  58. package/dist/services/http/middleware/AbstractMiddleware.js +16 -5
  59. package/dist/services/http/middleware/AbstractMiddleware.js.map +1 -1
  60. package/dist/services/http/middleware/GetUserByToken.d.ts +9 -0
  61. package/dist/services/http/middleware/GetUserByToken.js +9 -0
  62. package/dist/services/http/middleware/GetUserByToken.js.map +1 -1
  63. package/dist/services/http/routing/ExpressAdapter.d.ts +12 -0
  64. package/dist/services/http/routing/ExpressAdapter.js +93 -0
  65. package/dist/services/http/routing/ExpressAdapter.js.map +1 -0
  66. package/dist/services/http/routing/RouteNode.d.ts +99 -0
  67. package/dist/services/http/routing/RouteNode.js +21 -0
  68. package/dist/services/http/routing/RouteNode.js.map +1 -0
  69. package/dist/services/http/routing/RouteRegistry.d.ts +37 -0
  70. package/dist/services/http/routing/RouteRegistry.js +207 -0
  71. package/dist/services/http/routing/RouteRegistry.js.map +1 -0
  72. package/dist/services/http/routing/formatTree.d.ts +23 -0
  73. package/dist/services/http/routing/formatTree.js +158 -0
  74. package/dist/services/http/routing/formatTree.js.map +1 -0
  75. package/dist/services/http/routing/match.d.ts +30 -0
  76. package/dist/services/http/routing/match.js +128 -0
  77. package/dist/services/http/routing/match.js.map +1 -0
  78. package/dist/services/http/routing/middlewareNormalization.d.ts +16 -0
  79. package/dist/services/http/routing/middlewareNormalization.js +28 -0
  80. package/dist/services/http/routing/middlewareNormalization.js.map +1 -0
  81. package/dist/services/http/types.d.ts +74 -0
  82. package/dist/services/http/types.js +8 -0
  83. package/dist/services/http/types.js.map +1 -0
  84. package/dist/services/logging/SentryTransport.js +2 -2
  85. package/dist/services/logging/SentryTransport.js.map +1 -1
  86. package/dist/services/validate/ValidateService.d.ts +46 -23
  87. package/dist/services/validate/ValidateService.js +101 -74
  88. package/dist/services/validate/ValidateService.js.map +1 -1
  89. package/dist/services/validate/ValidationError.d.ts +35 -0
  90. package/dist/services/validate/ValidationError.js +77 -0
  91. package/dist/services/validate/ValidationError.js.map +1 -0
  92. package/dist/services/validate/drivers/StandardSchemaDriver.d.ts +15 -0
  93. package/dist/services/validate/drivers/StandardSchemaDriver.js +34 -0
  94. package/dist/services/validate/drivers/StandardSchemaDriver.js.map +1 -0
  95. package/dist/services/validate/drivers/YupDriver.d.ts +21 -0
  96. package/dist/services/validate/drivers/YupDriver.js +66 -0
  97. package/dist/services/validate/drivers/YupDriver.js.map +1 -0
  98. package/dist/services/validate/types.d.ts +104 -0
  99. package/dist/services/validate/types.js +11 -0
  100. package/dist/services/validate/types.js.map +1 -0
  101. package/dist/tests/setupVitest.js +4 -1
  102. package/dist/tests/setupVitest.js.map +1 -1
  103. package/dist/tests/testHelpers.d.ts +18 -16
  104. package/package.json +19 -10
  105. package/dist/commands/Documentation.d.ts +0 -5
  106. package/dist/commands/Documentation.js +0 -15
  107. package/dist/commands/Documentation.js.map +0 -1
  108. package/dist/commands/GetOpenApiJson.d.ts +0 -17
  109. package/dist/commands/GetOpenApiJson.js +0 -272
  110. package/dist/commands/GetOpenApiJson.js.map +0 -1
  111. package/dist/services/documentation/DocumentationGenerator.d.ts +0 -11
  112. package/dist/services/documentation/DocumentationGenerator.js +0 -130
  113. package/dist/services/documentation/DocumentationGenerator.js.map +0 -1
  114. package/dist/services/validate/drivers/AbstractValidator.d.ts +0 -14
  115. package/dist/services/validate/drivers/AbstractValidator.js +0 -29
  116. package/dist/services/validate/drivers/AbstractValidator.js.map +0 -1
  117. package/dist/services/validate/drivers/CustomValidator.d.ts +0 -14
  118. package/dist/services/validate/drivers/CustomValidator.js +0 -48
  119. package/dist/services/validate/drivers/CustomValidator.js.map +0 -1
  120. package/dist/services/validate/drivers/YupValidator.d.ts +0 -13
  121. package/dist/services/validate/drivers/YupValidator.js +0 -86
  122. package/dist/services/validate/drivers/YupValidator.js.map +0 -1
@@ -0,0 +1,99 @@
1
+ /**
2
+ * Tree-based routing primitives. Types only.
3
+ *
4
+ * Internal segment syntax: `':name'` for single-segment params, `'*name'`
5
+ * for splats. Translation layer converts user-facing path syntax to this
6
+ * shape.
7
+ */
8
+ import type { StandardSchemaV1 } from '../../validate/types.ts';
9
+ import type AbstractMiddleware from '../middleware/AbstractMiddleware.ts';
10
+ /**
11
+ * HTTP methods, upper-case. Single source of truth for the framework;
12
+ * the runtime const + the `HttpMethod` type derive from this one array.
13
+ */
14
+ export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
15
+ export type HttpMethod = (typeof HTTP_METHODS)[number];
16
+ /**
17
+ * Body parsing mode per route.
18
+ * - `'parsed'` (default): Content-Type-aware parser dispatch.
19
+ * - `'raw'`: capture bytes into `req.rawBody: Buffer`, skip parsing.
20
+ * - `'none'`: pass-through, leave the request stream untouched.
21
+ */
22
+ export type BodyParsingMode = 'parsed' | 'raw' | 'none';
23
+ /**
24
+ * Canonical middleware shape stored in the registry. The `[Class, params]`
25
+ * tuple shorthand is normalized to this struct at the boundary
26
+ * (`middlewareNormalization.ts`).
27
+ *
28
+ * `source` carries import-path info so codegen can emit the right import
29
+ * without scanning controller source.
30
+ */
31
+ export interface MiddlewareEntry {
32
+ Class: typeof AbstractMiddleware;
33
+ params?: Record<string, unknown>;
34
+ source: {
35
+ kind: 'package' | 'file';
36
+ spec: string;
37
+ };
38
+ }
39
+ /**
40
+ * Per-method handler entry. `meta` carries fields codegen uses
41
+ * (`<MethodName>Request` alias) and observability uses (`code.filepath`,
42
+ * `code.function`).
43
+ */
44
+ export interface HandlerEntry {
45
+ handler: Function;
46
+ request?: StandardSchemaV1;
47
+ query?: StandardSchemaV1;
48
+ middlewares?: MiddlewareEntry[];
49
+ bodyParsing?: BodyParsingMode;
50
+ meta?: {
51
+ methodName?: string;
52
+ controllerClass?: string;
53
+ sourceFile?: string;
54
+ };
55
+ }
56
+ /**
57
+ * Tree node. Walked at request time: enter → run middlewares → descend.
58
+ *
59
+ * Specificity is structural: static `children` first, then `paramChild`,
60
+ * then `splatChild`. At most one `paramChild` and one `splatChild` per
61
+ * node — registering a second of either throws.
62
+ */
63
+ export interface RouteNode {
64
+ segment: string;
65
+ middlewares: MiddlewareEntry[];
66
+ methods?: Partial<Record<HttpMethod, HandlerEntry>>;
67
+ children: Map<string, RouteNode>;
68
+ paramChild?: RouteNode;
69
+ splatChild?: RouteNode;
70
+ bodyParsing?: BodyParsingMode;
71
+ meta?: {
72
+ sourceFile?: string;
73
+ controllerClass?: string;
74
+ };
75
+ }
76
+ /**
77
+ * Match outcome:
78
+ * - `entry !== null` → success; adapter runs middlewares then handler.
79
+ * - `entry === null` → path matched a node but the method didn't (405);
80
+ * adapter sets `Allow: <allowedMethods>`. `middlewares` still holds the
81
+ * accumulated path chain — adapter chooses whether to run them.
82
+ *
83
+ * `match()` returns `null` when nothing matches (404).
84
+ */
85
+ export interface MatchResult {
86
+ entry: HandlerEntry | null;
87
+ allowedMethods: HttpMethod[];
88
+ middlewares: MiddlewareEntry[];
89
+ params: Record<string, string>;
90
+ bodyParsing: BodyParsingMode;
91
+ }
92
+ /** One entry per (method, full-path) leaf — produced by `flatten()`. */
93
+ export interface FlatRoute {
94
+ method: HttpMethod;
95
+ path: string;
96
+ entry: HandlerEntry;
97
+ middlewares: MiddlewareEntry[];
98
+ bodyParsing: BodyParsingMode;
99
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Tree-based routing primitives. Types only.
3
+ *
4
+ * Internal segment syntax: `':name'` for single-segment params, `'*name'`
5
+ * for splats. Translation layer converts user-facing path syntax to this
6
+ * shape.
7
+ */
8
+ /**
9
+ * HTTP methods, upper-case. Single source of truth for the framework;
10
+ * the runtime const + the `HttpMethod` type derive from this one array.
11
+ */
12
+ export const HTTP_METHODS = [
13
+ 'GET',
14
+ 'POST',
15
+ 'PUT',
16
+ 'PATCH',
17
+ 'DELETE',
18
+ 'HEAD',
19
+ 'OPTIONS',
20
+ ];
21
+ //# sourceMappingURL=RouteNode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RouteNode.js","sourceRoot":"","sources":["../../../../src/services/http/routing/RouteNode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;CACD,CAAC"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Global route tree. One instance per app, lives on `app.routeRegistry`.
3
+ *
4
+ * Producers (controllers, ad-hoc routes) register subtrees here. Consumers
5
+ * (the runtime adapter, codegen, OpenAPI / MCP emitters) walk it.
6
+ */
7
+ import type { FlatRoute, HandlerEntry, HttpMethod, MatchResult, RouteNode } from './RouteNode.ts';
8
+ /** Construct an empty node with the given segment. */
9
+ export declare function createNode(segment: string): RouteNode;
10
+ export declare class RouteRegistry {
11
+ readonly root: RouteNode;
12
+ /**
13
+ * Mount a subtree at a path prefix. Intermediate nodes are created;
14
+ * existing ones are merged (middlewares appended, methods added,
15
+ * children recursively merged). Conflicting handlers throw.
16
+ *
17
+ * The subtree's root `segment` is metadata only — its CONTENTS go
18
+ * under `prefix` (mount-style convention). Wrap with `{ segment: '',
19
+ * children: ... }` for clean semantics; `translateController` does
20
+ * exactly that.
21
+ */
22
+ registerSubtree(prefix: string, subtree: RouteNode): void;
23
+ /**
24
+ * Register a single ad-hoc route. Escape hatch for routes that don't
25
+ * fit the controller convention (webhooks, healthchecks, OAuth callbacks).
26
+ */
27
+ registerRoute(method: HttpMethod, path: string, entry: HandlerEntry): void;
28
+ /** Walk depth-first; `fullPath` is the slash-joined path to the node. */
29
+ walk(visitor: (node: RouteNode, fullPath: string) => void): void;
30
+ /**
31
+ * Flatten to one entry per (method, full-path) leaf. Middlewares are
32
+ * accumulated root → leaf; `bodyParsing` inherits leaf-wins.
33
+ */
34
+ flatten(): FlatRoute[];
35
+ /** Match a request. See `MatchResult` for return cases (404 / 405 / hit). */
36
+ match(method: string, path: string): MatchResult | null;
37
+ }
@@ -0,0 +1,207 @@
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
+ for (const seg of pathSegments(path)) {
42
+ target = ensureChildBySegment(target, seg);
43
+ }
44
+ if (!target.methods) {
45
+ target.methods = {};
46
+ }
47
+ if (target.methods[method]) {
48
+ throw new Error(`RouteRegistry: route ${method} ${path} already registered`);
49
+ }
50
+ target.methods[method] = entry;
51
+ }
52
+ /** Walk depth-first; `fullPath` is the slash-joined path to the node. */
53
+ walk(visitor) {
54
+ walkRecursive(this.root, '', visitor);
55
+ }
56
+ /**
57
+ * Flatten to one entry per (method, full-path) leaf. Middlewares are
58
+ * accumulated root → leaf; `bodyParsing` inherits leaf-wins.
59
+ */
60
+ flatten() {
61
+ const out = [];
62
+ flattenRecursive(this.root, '', undefined, [], out);
63
+ return out;
64
+ }
65
+ /** Match a request. See `MatchResult` for return cases (404 / 405 / hit). */
66
+ match(method, path) {
67
+ return match(this.root, method, path);
68
+ }
69
+ }
70
+ // ─── path helpers ────────────────────────────────────────────────────
71
+ function pathSegments(path) {
72
+ return path.split('/').filter((s) => s.length > 0);
73
+ }
74
+ function joinPath(prefix, segment) {
75
+ if (segment === '') {
76
+ return prefix === '' ? '/' : prefix;
77
+ }
78
+ const joined = `${prefix}/${segment}`;
79
+ return joined.startsWith('//') ? joined.slice(1) : joined;
80
+ }
81
+ // ─── tree mutation ───────────────────────────────────────────────────
82
+ function ensureChildBySegment(node, segment) {
83
+ // Splat consumes the rest of the path; nothing under it is reachable.
84
+ if (node.segment.startsWith('*')) {
85
+ 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`);
86
+ }
87
+ if (segment.startsWith(':')) {
88
+ if (node.paramChild && node.paramChild.segment !== segment) {
89
+ throw new Error(`RouteRegistry: conflicting param children at "${node.segment}" — ${node.paramChild.segment} vs ${segment}`);
90
+ }
91
+ if (!node.paramChild) {
92
+ node.paramChild = createNode(segment);
93
+ }
94
+ return node.paramChild;
95
+ }
96
+ if (segment.startsWith('*')) {
97
+ if (node.splatChild && node.splatChild.segment !== segment) {
98
+ throw new Error(`RouteRegistry: conflicting splat children at "${node.segment}" — ${node.splatChild.segment} vs ${segment}`);
99
+ }
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
+ if (target.paramChild.segment !== source.paramChild.segment) {
141
+ throw new Error(`RouteRegistry: conflicting param children — ${target.paramChild.segment} vs ${source.paramChild.segment}`);
142
+ }
143
+ mergeNode(target.paramChild, source.paramChild);
144
+ }
145
+ else {
146
+ target.paramChild = source.paramChild;
147
+ }
148
+ }
149
+ if (source.splatChild) {
150
+ if (target.splatChild) {
151
+ if (target.splatChild.segment !== source.splatChild.segment) {
152
+ throw new Error(`RouteRegistry: conflicting splat children — ${target.splatChild.segment} vs ${source.splatChild.segment}`);
153
+ }
154
+ mergeNode(target.splatChild, source.splatChild);
155
+ }
156
+ else {
157
+ target.splatChild = source.splatChild;
158
+ }
159
+ }
160
+ if (source.bodyParsing !== undefined) {
161
+ target.bodyParsing = source.bodyParsing;
162
+ }
163
+ }
164
+ // ─── tree traversal ──────────────────────────────────────────────────
165
+ function walkRecursive(node, prefix, visitor) {
166
+ const fullPath = joinPath(prefix, node.segment);
167
+ visitor(node, fullPath);
168
+ for (const child of node.children.values()) {
169
+ walkRecursive(child, fullPath, visitor);
170
+ }
171
+ if (node.paramChild) {
172
+ walkRecursive(node.paramChild, fullPath, visitor);
173
+ }
174
+ if (node.splatChild) {
175
+ walkRecursive(node.splatChild, fullPath, visitor);
176
+ }
177
+ }
178
+ function flattenRecursive(node, prefix, inheritedBodyParsing, inheritedMw, out) {
179
+ const fullPath = joinPath(prefix, node.segment);
180
+ const middlewares = [...inheritedMw, ...node.middlewares];
181
+ const bodyParsing = node.bodyParsing ?? inheritedBodyParsing;
182
+ if (node.methods) {
183
+ for (const m of Object.keys(node.methods)) {
184
+ const entry = node.methods[m];
185
+ if (!entry) {
186
+ continue;
187
+ }
188
+ out.push({
189
+ method: m,
190
+ path: fullPath,
191
+ entry,
192
+ middlewares: [...middlewares, ...(entry.middlewares ?? [])],
193
+ bodyParsing: entry.bodyParsing ?? bodyParsing ?? 'parsed',
194
+ });
195
+ }
196
+ }
197
+ for (const child of node.children.values()) {
198
+ flattenRecursive(child, fullPath, bodyParsing, middlewares, out);
199
+ }
200
+ if (node.paramChild) {
201
+ flattenRecursive(node.paramChild, fullPath, bodyParsing, middlewares, out);
202
+ }
203
+ if (node.splatChild) {
204
+ flattenRecursive(node.splatChild, fullPath, bodyParsing, middlewares, out);
205
+ }
206
+ }
207
+ //# 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;